diff --git a/Makefile b/Makefile index 30b6014c6..e87c6d8aa 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 := 90f75e1069f2d692480bcd305fc35b4fe7847e18 +CPYTHON_CURRENT_COMMIT := b912d2b24a3fbd552595e3584bf851f9a2c75127 LANGUAGE := tr BRANCH := 3.12 diff --git a/c-api/contextvars.po b/c-api/contextvars.po index e6752ea5a..2e822b59b 100644 --- a/c-api/contextvars.po +++ b/c-api/contextvars.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-12-17 01:28+0300\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -20,14 +20,14 @@ msgstr "" msgid "Context Variables Objects" msgstr "" -#: c-api/contextvars.rst:13 +#: c-api/contextvars.rst:15 msgid "" "In Python 3.7.1 the signatures of all context variables C APIs were " "**changed** to use :c:type:`PyObject` pointers instead of :c:type:" "`PyContext`, :c:type:`PyContextVar`, and :c:type:`PyContextToken`, e.g.::" msgstr "" -#: c-api/contextvars.rst:24 +#: c-api/contextvars.rst:26 msgid "See :issue:`34762` for more details." msgstr "" diff --git a/c-api/import.po b/c-api/import.po index 195dbc115..b212820d0 100644 --- a/c-api/import.po +++ b/c-api/import.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -317,6 +317,10 @@ msgstr "" msgid "The module name, as an ASCII encoded string." msgstr "" +#: c-api/import.rst:297 +msgid "Initialization function for a module built into the interpreter." +msgstr "" + #: c-api/import.rst:302 msgid "" "Add a collection of modules to the table of built-in modules. The *newtab* " diff --git a/c-api/init.po b/c-api/init.po index 45b2195ce..268765184 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-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2051,7 +2051,7 @@ msgid "" "`PyGILState API`." msgstr "" -#: c-api/init.rst:1825 +#: c-api/init.rst:1827 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 " diff --git a/c-api/refcounting.po b/c-api/refcounting.po index f934d18a2..ef71edf57 100644 --- a/c-api/refcounting.po +++ b/c-api/refcounting.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -45,11 +45,11 @@ msgid "" msgstr "" #: c-api/refcounting.rst:26 -msgid "The parameter type is no longer :c:expr:`const PyObject*`." +msgid ":c:func:`Py_REFCNT()` is changed to the inline static function." msgstr "" #: c-api/refcounting.rst:29 -msgid ":c:func:`Py_REFCNT()` is changed to the inline static function." +msgid "The parameter type is no longer :c:expr:`const PyObject*`." msgstr "" #: c-api/refcounting.rst:35 diff --git a/c-api/structures.po b/c-api/structures.po index 0a55d2eb5..e71afa542 100644 --- a/c-api/structures.po +++ b/c-api/structures.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -806,13 +806,13 @@ msgstr "" #: c-api/structures.rst:705 msgid "" -"Optional function pointer, providing additional data for getter and setter." +"Optional user data pointer, providing additional data for getter and setter." msgstr "" #: c-api/structures.rst:709 msgid "" "The ``get`` function takes one :c:expr:`PyObject*` parameter (the instance) " -"and a function pointer (the associated ``closure``):" +"and a user data pointer (the associated ``closure``):" msgstr "" #: c-api/structures.rst:712 @@ -824,7 +824,7 @@ msgstr "" #: c-api/structures.rst:717 msgid "" "``set`` functions take two :c:expr:`PyObject*` parameters (the instance and " -"the value to be set) and a function pointer (the associated ``closure``):" +"the value to be set) and a user data pointer (the associated ``closure``):" msgstr "" #: c-api/structures.rst:720 diff --git a/faq/design.po b/faq/design.po index 05690b57c..c7f0efabe 100644 --- a/faq/design.po +++ b/faq/design.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -345,25 +345,27 @@ msgstr "" #: faq/design.rst:262 msgid "" -"You can do this easily enough with a sequence of ``if... elif... elif... " -"else``. For literal values, or constants within a namespace, you can also " -"use a ``match ... case`` statement." +"In general, structured switch statements execute one block of code when an " +"expression has a particular value or set of values. Since Python 3.10 one " +"can easily match literal values, or constants within a namespace, with a " +"``match ... case`` statement. An older alternative is a sequence of ``if... " +"elif... elif... else``." msgstr "" -#: faq/design.rst:266 +#: faq/design.rst:268 msgid "" "For cases where you need to choose from a very large number of " "possibilities, you can create a dictionary mapping case values to functions " "to call. For example::" msgstr "" -#: faq/design.rst:277 +#: faq/design.rst:279 msgid "" "For calling methods on objects, you can simplify yet further by using the :" "func:`getattr` built-in to retrieve methods with a particular name::" msgstr "" -#: faq/design.rst:289 +#: faq/design.rst:291 msgid "" "It's suggested that you use a prefix for the method names, such as " "``visit_`` in this example. Without such a prefix, if values are coming " @@ -373,11 +375,17 @@ msgstr "" #: faq/design.rst:295 msgid "" +"Imitating switch with fallthrough, as with C's switch-case-default, is " +"possible, much harder, and less needed." +msgstr "" + +#: faq/design.rst:300 +msgid "" "Can't you emulate threads in the interpreter instead of relying on an OS-" "specific thread implementation?" msgstr "" -#: faq/design.rst:297 +#: faq/design.rst:302 msgid "" "Answer 1: Unfortunately, the interpreter pushes at least one C stack frame " "for each Python stack frame. Also, extensions can call back into Python at " @@ -385,18 +393,18 @@ msgid "" "requires thread support for C." msgstr "" -#: faq/design.rst:302 +#: faq/design.rst:307 msgid "" "Answer 2: Fortunately, there is `Stackless Python `_, which has a completely redesigned " "interpreter loop that avoids the C stack." msgstr "" -#: faq/design.rst:307 +#: faq/design.rst:312 msgid "Why can't lambda expressions contain statements?" msgstr "" -#: faq/design.rst:309 +#: faq/design.rst:314 msgid "" "Python lambda expressions cannot contain statements because Python's " "syntactic framework can't handle statements nested inside expressions. " @@ -405,7 +413,7 @@ msgid "" "shorthand notation if you're too lazy to define a function." msgstr "" -#: faq/design.rst:315 +#: faq/design.rst:320 msgid "" "Functions are already first class objects in Python, and can be declared in " "a local scope. Therefore the only advantage of using a lambda instead of a " @@ -415,11 +423,11 @@ msgid "" "is assigned!" msgstr "" -#: faq/design.rst:323 +#: faq/design.rst:328 msgid "Can Python be compiled to machine code, C or some other language?" msgstr "" -#: faq/design.rst:325 +#: faq/design.rst:330 msgid "" "`Cython `_ compiles a modified version of Python with " "optional annotations into C extensions. `Nuitka `_ " @@ -427,11 +435,11 @@ msgid "" "full Python language." msgstr "" -#: faq/design.rst:332 +#: faq/design.rst:337 msgid "How does Python manage memory?" msgstr "" -#: faq/design.rst:334 +#: faq/design.rst:339 msgid "" "The details of Python memory management depend on the implementation. The " "standard implementation of Python, :term:`CPython`, uses reference counting " @@ -442,7 +450,7 @@ msgid "" "statistics, and tune the collector's parameters." msgstr "" -#: faq/design.rst:342 +#: faq/design.rst:347 msgid "" "Other implementations (such as `Jython `_ or `PyPy " "`_), however, can rely on a different mechanism such " @@ -451,13 +459,13 @@ msgid "" "reference counting implementation." msgstr "" -#: faq/design.rst:348 +#: faq/design.rst:353 msgid "" "In some Python implementations, the following code (which is fine in " "CPython) will probably run out of file descriptors::" msgstr "" -#: faq/design.rst:355 +#: faq/design.rst:360 msgid "" "Indeed, using CPython's reference counting and destructor scheme, each new " "assignment to ``f`` closes the previous file. With a traditional GC, " @@ -465,18 +473,18 @@ msgid "" "and possibly long intervals." msgstr "" -#: faq/design.rst:360 +#: faq/design.rst:365 msgid "" "If you want to write code that will work with any Python implementation, you " "should explicitly close the file or use the :keyword:`with` statement; this " "will work regardless of memory management scheme::" msgstr "" -#: faq/design.rst:370 +#: faq/design.rst:375 msgid "Why doesn't CPython use a more traditional garbage collection scheme?" msgstr "" -#: faq/design.rst:372 +#: faq/design.rst:377 msgid "" "For one thing, this is not a C standard feature and hence it's not portable. " "(Yes, we know about the Boehm GC library. It has bits of assembler code for " @@ -485,7 +493,7 @@ msgid "" "Python to work with it.)" msgstr "" -#: faq/design.rst:378 +#: faq/design.rst:383 msgid "" "Traditional GC also becomes a problem when Python is embedded into other " "applications. While in a standalone Python it's fine to replace the " @@ -496,11 +504,11 @@ msgid "" "``free()`` properly." msgstr "" -#: faq/design.rst:387 +#: faq/design.rst:392 msgid "Why isn't all memory freed when CPython exits?" msgstr "" -#: faq/design.rst:389 +#: faq/design.rst:394 msgid "" "Objects referenced from the global namespaces of Python modules are not " "always deallocated when Python exits. This may happen if there are circular " @@ -510,17 +518,17 @@ msgid "" "exit and does try to destroy every single object." msgstr "" -#: faq/design.rst:396 +#: faq/design.rst:401 msgid "" "If you want to force Python to delete certain things on deallocation use " "the :mod:`atexit` module to run a function that will force those deletions." msgstr "" -#: faq/design.rst:401 +#: faq/design.rst:406 msgid "Why are there separate tuple and list data types?" msgstr "" -#: faq/design.rst:403 +#: faq/design.rst:408 msgid "" "Lists and tuples, while similar in many respects, are generally used in " "fundamentally different ways. Tuples can be thought of as being similar to " @@ -530,7 +538,7 @@ msgid "" "two or three numbers." msgstr "" -#: faq/design.rst:410 +#: faq/design.rst:415 msgid "" "Lists, on the other hand, are more like arrays in other languages. They " "tend to hold a varying number of objects all of which have the same type and " @@ -540,7 +548,7 @@ msgid "" "if you added another file or two to the directory." msgstr "" -#: faq/design.rst:418 +#: faq/design.rst:423 msgid "" "Tuples are immutable, meaning that once a tuple has been created, you can't " "replace any of its elements with a new value. Lists are mutable, meaning " @@ -549,11 +557,11 @@ msgid "" "as keys." msgstr "" -#: faq/design.rst:425 +#: faq/design.rst:430 msgid "How are lists implemented in CPython?" msgstr "" -#: faq/design.rst:427 +#: faq/design.rst:432 msgid "" "CPython's lists are really variable-length arrays, not Lisp-style linked " "lists. The implementation uses a contiguous array of references to other " @@ -561,13 +569,13 @@ msgid "" "head structure." msgstr "" -#: faq/design.rst:431 +#: faq/design.rst:436 msgid "" "This makes indexing a list ``a[i]`` an operation whose cost is independent " "of the size of the list or the value of the index." msgstr "" -#: faq/design.rst:434 +#: faq/design.rst:439 msgid "" "When items are appended or inserted, the array of references is resized. " "Some cleverness is applied to improve the performance of appending items " @@ -575,11 +583,11 @@ msgid "" "the next few times don't require an actual resize." msgstr "" -#: faq/design.rst:441 +#: faq/design.rst:446 msgid "How are dictionaries implemented in CPython?" msgstr "" -#: faq/design.rst:443 +#: faq/design.rst:448 msgid "" "CPython's dictionaries are implemented as resizable hash tables. Compared " "to B-trees, this gives better performance for lookup (the most common " @@ -587,7 +595,7 @@ msgid "" "simpler." msgstr "" -#: faq/design.rst:447 +#: faq/design.rst:452 msgid "" "Dictionaries work by computing a hash code for each key stored in the " "dictionary using the :func:`hash` built-in function. The hash code varies " @@ -600,11 +608,11 @@ msgid "" "O notation -- to retrieve a key." msgstr "" -#: faq/design.rst:458 +#: faq/design.rst:463 msgid "Why must dictionary keys be immutable?" msgstr "" -#: faq/design.rst:460 +#: faq/design.rst:465 msgid "" "The hash table implementation of dictionaries uses a hash value calculated " "from the key value to find the key. If the key were a mutable object, its " @@ -617,7 +625,7 @@ msgid "" "would be different." msgstr "" -#: faq/design.rst:469 +#: faq/design.rst:474 msgid "" "If you want a dictionary indexed with a list, simply convert the list to a " "tuple first; the function ``tuple(L)`` creates a tuple with the same entries " @@ -625,17 +633,17 @@ msgid "" "dictionary keys." msgstr "" -#: faq/design.rst:473 +#: faq/design.rst:478 msgid "Some unacceptable solutions that have been proposed:" msgstr "" -#: faq/design.rst:475 +#: faq/design.rst:480 msgid "" "Hash lists by their address (object ID). This doesn't work because if you " "construct a new list with the same value it won't be found; e.g.::" msgstr "" -#: faq/design.rst:481 +#: faq/design.rst:486 msgid "" "would raise a :exc:`KeyError` exception because the id of the ``[1, 2]`` " "used in the second line differs from that in the first line. In other " @@ -643,14 +651,14 @@ msgid "" "`is`." msgstr "" -#: faq/design.rst:485 +#: faq/design.rst:490 msgid "" "Make a copy when using a list as a key. This doesn't work because the list, " "being a mutable object, could contain a reference to itself, and then the " "copying code would run into an infinite loop." msgstr "" -#: faq/design.rst:489 +#: faq/design.rst:494 msgid "" "Allow lists as keys but tell the user not to modify them. This would allow " "a class of hard-to-track bugs in programs when you forgot or modified a list " @@ -658,7 +666,7 @@ msgid "" "every value in ``d.keys()`` is usable as a key of the dictionary." msgstr "" -#: faq/design.rst:494 +#: faq/design.rst:499 msgid "" "Mark lists as read-only once they are used as a dictionary key. The problem " "is that it's not just the top-level object that could change its value; you " @@ -668,7 +676,7 @@ msgid "" "loop." msgstr "" -#: faq/design.rst:500 +#: faq/design.rst:505 msgid "" "There is a trick to get around this if you need to, but use it at your own " "risk: You can wrap a mutable structure inside a class instance which has " @@ -678,14 +686,14 @@ msgid "" "the object is in the dictionary (or other structure). ::" msgstr "" -#: faq/design.rst:525 +#: faq/design.rst:530 msgid "" "Note that the hash computation is complicated by the possibility that some " "members of the list may be unhashable and also by the possibility of " "arithmetic overflow." msgstr "" -#: faq/design.rst:529 +#: faq/design.rst:534 msgid "" "Furthermore it must always be the case that if ``o1 == o2`` (ie ``o1." "__eq__(o2) is True``) then ``hash(o1) == hash(o2)`` (ie, ``o1.__hash__() == " @@ -694,7 +702,7 @@ msgid "" "based structures will misbehave." msgstr "" -#: faq/design.rst:534 +#: faq/design.rst:539 msgid "" "In the case of :class:`!ListWrapper`, whenever the wrapper object is in a " "dictionary the wrapped list must not change to avoid anomalies. Don't do " @@ -702,11 +710,11 @@ msgid "" "consequences of not meeting them correctly. Consider yourself warned." msgstr "" -#: faq/design.rst:541 +#: faq/design.rst:546 msgid "Why doesn't list.sort() return the sorted list?" msgstr "" -#: faq/design.rst:543 +#: faq/design.rst:548 msgid "" "In situations where performance matters, making a copy of the list just to " "sort it would be wasteful. Therefore, :meth:`list.sort` sorts the list in " @@ -716,7 +724,7 @@ msgid "" "around." msgstr "" -#: faq/design.rst:549 +#: faq/design.rst:554 msgid "" "If you want to return a new list, use the built-in :func:`sorted` function " "instead. This function creates a new list from a provided iterable, sorts " @@ -724,11 +732,11 @@ msgid "" "dictionary in sorted order::" msgstr "" -#: faq/design.rst:559 +#: faq/design.rst:564 msgid "How do you specify and enforce an interface spec in Python?" msgstr "" -#: faq/design.rst:561 +#: faq/design.rst:566 msgid "" "An interface specification for a module as provided by languages such as C++ " "and Java describes the prototypes for the methods and functions of the " @@ -736,7 +744,7 @@ msgid "" "helps in the construction of large programs." msgstr "" -#: faq/design.rst:566 +#: faq/design.rst:571 msgid "" "Python 2.6 adds an :mod:`abc` module that lets you define Abstract Base " "Classes (ABCs). You can then use :func:`isinstance` and :func:`issubclass` " @@ -746,13 +754,13 @@ msgid "" "`~collections.abc.MutableMapping`." msgstr "" -#: faq/design.rst:573 +#: faq/design.rst:578 msgid "" "For Python, many of the advantages of interface specifications can be " "obtained by an appropriate test discipline for components." msgstr "" -#: faq/design.rst:576 +#: faq/design.rst:581 msgid "" "A good test suite for a module can both provide a regression test and serve " "as a module interface specification and a set of examples. Many Python " @@ -764,7 +772,7 @@ msgid "" "in a module." msgstr "" -#: faq/design.rst:584 +#: faq/design.rst:589 msgid "" "An appropriate testing discipline can help build large complex applications " "in Python as well as having interface specifications would. In fact, it can " @@ -776,7 +784,7 @@ msgid "" "test suite." msgstr "" -#: faq/design.rst:592 +#: faq/design.rst:597 msgid "" "Writing test suites is very helpful, and you might want to design your code " "to make it easily tested. One increasingly popular technique, test-driven " @@ -785,11 +793,11 @@ msgid "" "not write test cases at all." msgstr "" -#: faq/design.rst:600 +#: faq/design.rst:605 msgid "Why is there no goto?" msgstr "" -#: faq/design.rst:602 +#: faq/design.rst:607 msgid "" "In the 1970s people realized that unrestricted goto could lead to messy " "\"spaghetti\" code that was hard to understand and revise. In a high-level " @@ -800,7 +808,7 @@ msgid "" "`continue` and :keyword:`break`)." msgstr "" -#: faq/design.rst:609 +#: faq/design.rst:614 msgid "" "One can also use exceptions to provide a \"structured goto\" that works even " "across function calls. Many feel that exceptions can conveniently emulate " @@ -808,24 +816,24 @@ msgid "" "other languages. For example::" msgstr "" -#: faq/design.rst:625 +#: faq/design.rst:630 msgid "" "This doesn't allow you to jump into the middle of a loop, but that's usually " "considered an abuse of ``goto`` anyway. Use sparingly." msgstr "" -#: faq/design.rst:630 +#: faq/design.rst:635 msgid "Why can't raw strings (r-strings) end with a backslash?" msgstr "" -#: faq/design.rst:632 +#: faq/design.rst:637 msgid "" "More precisely, they can't end with an odd number of backslashes: the " "unpaired backslash at the end escapes the closing quote character, leaving " "an unterminated string." msgstr "" -#: faq/design.rst:636 +#: faq/design.rst:641 msgid "" "Raw strings were designed to ease creating input for processors (chiefly " "regular expression engines) that want to do their own backslash escape " @@ -835,33 +843,33 @@ msgid "" "rules work well when r-strings are used for their intended purpose." msgstr "" -#: faq/design.rst:643 +#: faq/design.rst:648 msgid "" "If you're trying to build Windows pathnames, note that all Windows system " "calls accept forward slashes too::" msgstr "" -#: faq/design.rst:648 +#: faq/design.rst:653 msgid "" "If you're trying to build a pathname for a DOS command, try e.g. one of ::" msgstr "" -#: faq/design.rst:656 +#: faq/design.rst:661 msgid "Why doesn't Python have a \"with\" statement for attribute assignments?" msgstr "" -#: faq/design.rst:658 +#: faq/design.rst:663 msgid "" "Python has a :keyword:`with` statement that wraps the execution of a block, " "calling code on the entrance and exit from the block. Some languages have a " "construct that looks like this::" msgstr "" -#: faq/design.rst:666 +#: faq/design.rst:671 msgid "In Python, such a construct would be ambiguous." msgstr "" -#: faq/design.rst:668 +#: faq/design.rst:673 msgid "" "Other languages, such as Object Pascal, Delphi, and C++, use static types, " "so it's possible to know, in an unambiguous way, what member is being " @@ -869,7 +877,7 @@ msgid "" "*always* knows the scope of every variable at compile time." msgstr "" -#: faq/design.rst:673 +#: faq/design.rst:678 msgid "" "Python uses dynamic types. It is impossible to know in advance which " "attribute will be referenced at runtime. Member attributes may be added or " @@ -878,11 +886,11 @@ msgid "" "one, or a member attribute?" msgstr "" -#: faq/design.rst:679 +#: faq/design.rst:684 msgid "For instance, take the following incomplete snippet::" msgstr "" -#: faq/design.rst:685 +#: faq/design.rst:690 msgid "" "The snippet assumes that ``a`` must have a member attribute called ``x``. " "However, there is nothing in Python that tells the interpreter this. What " @@ -891,36 +899,36 @@ msgid "" "you see, the dynamic nature of Python makes such choices much harder." msgstr "" -#: faq/design.rst:691 +#: faq/design.rst:696 msgid "" "The primary benefit of :keyword:`with` and similar language features " "(reduction of code volume) can, however, easily be achieved in Python by " "assignment. Instead of::" msgstr "" -#: faq/design.rst:698 +#: faq/design.rst:703 msgid "write this::" msgstr "" -#: faq/design.rst:705 +#: faq/design.rst:710 msgid "" "This also has the side-effect of increasing execution speed because name " "bindings are resolved at run-time in Python, and the second version only " "needs to perform the resolution once." msgstr "" -#: faq/design.rst:709 +#: faq/design.rst:714 msgid "" "Similar proposals that would introduce syntax to further reduce code volume, " "such as using a 'leading dot', have been rejected in favour of explicitness " "(see https://mail.python.org/pipermail/python-ideas/2016-May/040070.html)." msgstr "" -#: faq/design.rst:715 +#: faq/design.rst:720 msgid "Why don't generators support the with statement?" msgstr "" -#: faq/design.rst:717 +#: faq/design.rst:722 msgid "" "For technical reasons, a generator used directly as a context manager would " "not work correctly. When, as is most common, a generator is used as an " @@ -929,28 +937,28 @@ msgid "" "`with` statement." msgstr "" -#: faq/design.rst:725 +#: faq/design.rst:730 msgid "Why are colons required for the if/while/def/class statements?" msgstr "" -#: faq/design.rst:727 +#: faq/design.rst:732 msgid "" "The colon is required primarily to enhance readability (one of the results " "of the experimental ABC language). Consider this::" msgstr "" -#: faq/design.rst:733 +#: faq/design.rst:738 msgid "versus ::" msgstr "" -#: faq/design.rst:738 +#: faq/design.rst:743 msgid "" "Notice how the second one is slightly easier to read. Notice further how a " "colon sets off the example in this FAQ answer; it's a standard usage in " "English." msgstr "" -#: faq/design.rst:741 +#: faq/design.rst:746 msgid "" "Another minor reason is that the colon makes it easier for editors with " "syntax highlighting; they can look for colons to decide when indentation " @@ -958,21 +966,21 @@ msgid "" "the program text." msgstr "" -#: faq/design.rst:747 +#: faq/design.rst:752 msgid "Why does Python allow commas at the end of lists and tuples?" msgstr "" -#: faq/design.rst:749 +#: faq/design.rst:754 msgid "" "Python lets you add a trailing comma at the end of lists, tuples, and " "dictionaries::" msgstr "" -#: faq/design.rst:760 +#: faq/design.rst:765 msgid "There are several reasons to allow this." msgstr "" -#: faq/design.rst:762 +#: faq/design.rst:767 msgid "" "When you have a literal value for a list, tuple, or dictionary spread across " "multiple lines, it's easier to add more elements because you don't have to " @@ -980,20 +988,20 @@ msgid "" "reordered without creating a syntax error." msgstr "" -#: faq/design.rst:767 +#: faq/design.rst:772 msgid "" "Accidentally omitting the comma can lead to errors that are hard to " "diagnose. For example::" msgstr "" -#: faq/design.rst:777 +#: faq/design.rst:782 msgid "" "This list looks like it has four elements, but it actually contains three: " "\"fee\", \"fiefoo\" and \"fum\". Always adding the comma avoids this source " "of error." msgstr "" -#: faq/design.rst:780 +#: faq/design.rst:785 msgid "" "Allowing the trailing comma may also make programmatic code generation " "easier." diff --git a/faq/extending.po b/faq/extending.po index dd1fff4b8..523375a26 100644 --- a/faq/extending.po +++ b/faq/extending.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: 2022-12-29 00:43-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -88,14 +88,15 @@ msgstr "" "yazmayı mümkün kılar." #: faq/extending.rst:50 +#, fuzzy msgid "" "If you need to interface to some C or C++ library for which no Python " "extension currently exists, you can try wrapping the library's data types " "and functions with a tool such as `SWIG `_. `SIP " -"`__, `CXX `_ `Boost `_, or `Weave `_ are also alternatives " -"for wrapping C++ libraries." +"`__, `CXX `_ `Boost `_, or `Weave " +"`_ are also alternatives for wrapping C++ " +"libraries." msgstr "" "Şu anda Python uzantısı bulunmayan bir C veya C++ kütüphanesine arayüz " "oluşturmanız gerekiyorsa, kütüphanenin veri türlerini ve işlevlerini `SWIG " diff --git a/faq/general.po b/faq/general.po index 739271d6d..9d6c3c1cf 100644 --- a/faq/general.po +++ b/faq/general.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -213,10 +213,6 @@ msgid "" msgstr "" #: faq/general.rst:136 -msgid "See :pep:`6` for more information about bugfix releases." -msgstr "" - -#: faq/general.rst:138 msgid "" "Not all releases are bugfix releases. In the run-up to a new feature " "release, a series of development releases are made, denoted as alpha, beta, " @@ -227,31 +223,31 @@ msgid "" "changes except as needed to fix critical bugs." msgstr "" -#: faq/general.rst:146 +#: faq/general.rst:144 msgid "Alpha, beta and release candidate versions have an additional suffix:" msgstr "" -#: faq/general.rst:148 +#: faq/general.rst:146 msgid "The suffix for an alpha version is \"aN\" for some small number *N*." msgstr "" -#: faq/general.rst:149 +#: faq/general.rst:147 msgid "The suffix for a beta version is \"bN\" for some small number *N*." msgstr "" -#: faq/general.rst:150 +#: faq/general.rst:148 msgid "" "The suffix for a release candidate version is \"rcN\" for some small number " "*N*." msgstr "" -#: faq/general.rst:152 +#: faq/general.rst:150 msgid "" "In other words, all versions labeled *2.0aN* precede the versions labeled " "*2.0bN*, which precede versions labeled *2.0rcN*, and *those* precede 2.0." msgstr "" -#: faq/general.rst:155 +#: faq/general.rst:153 msgid "" "You may also find version numbers with a \"+\" suffix, e.g. \"2.2+\". These " "are unreleased versions, built directly from the CPython development " @@ -260,24 +256,27 @@ msgid "" "e.g. \"2.4a0\"." msgstr "" -#: faq/general.rst:160 +#: faq/general.rst:158 msgid "" +"See the `Developer's Guide `__ for more information about the development cycle, " +"and :pep:`387` to learn more about Python's backward compatibility policy. " "See also the documentation for :data:`sys.version`, :data:`sys.hexversion`, " "and :data:`sys.version_info`." msgstr "" -#: faq/general.rst:165 +#: faq/general.rst:167 msgid "How do I obtain a copy of the Python source?" msgstr "" -#: faq/general.rst:167 +#: faq/general.rst:169 msgid "" "The latest Python source distribution is always available from python.org, " "at https://www.python.org/downloads/. The latest development sources can be " "obtained at https://github.com/python/cpython/." msgstr "" -#: faq/general.rst:171 +#: faq/general.rst:173 msgid "" "The source distribution is a gzipped tar file containing the complete C " "source, Sphinx-formatted documentation, Python library modules, example " @@ -285,25 +284,25 @@ msgid "" "source will compile and run out of the box on most UNIX platforms." msgstr "" -#: faq/general.rst:176 +#: faq/general.rst:178 msgid "" "Consult the `Getting Started section of the Python Developer's Guide " "`__ for more information on getting the " "source code and compiling it." msgstr "" -#: faq/general.rst:182 +#: faq/general.rst:184 msgid "How do I get documentation on Python?" msgstr "" -#: faq/general.rst:186 +#: faq/general.rst:188 msgid "" "The standard documentation for the current stable version of Python is " "available at https://docs.python.org/3/. PDF, plain text, and downloadable " "HTML versions are also available at https://docs.python.org/3/download.html." msgstr "" -#: faq/general.rst:190 +#: faq/general.rst:192 msgid "" "The documentation is written in reStructuredText and processed by `the " "Sphinx documentation tool `__. The " @@ -311,28 +310,28 @@ msgid "" "distribution." msgstr "" -#: faq/general.rst:196 +#: faq/general.rst:198 msgid "I've never programmed before. Is there a Python tutorial?" msgstr "" -#: faq/general.rst:198 +#: faq/general.rst:200 msgid "" "There are numerous tutorials and books available. The standard " "documentation includes :ref:`tutorial-index`." msgstr "" -#: faq/general.rst:201 +#: faq/general.rst:203 msgid "" "Consult `the Beginner's Guide `_ to find information for beginning Python programmers, " "including lists of tutorials." msgstr "" -#: faq/general.rst:206 +#: faq/general.rst:208 msgid "Is there a newsgroup or mailing list devoted to Python?" msgstr "" -#: faq/general.rst:208 +#: faq/general.rst:210 msgid "" "There is a newsgroup, :newsgroup:`comp.lang.python`, and a mailing list, " "`python-list `_. The " @@ -342,7 +341,7 @@ msgid "" "Usenet readers are often more able to cope with this volume." msgstr "" -#: faq/general.rst:215 +#: faq/general.rst:217 msgid "" "Announcements of new software releases and events can be found in comp.lang." "python.announce, a low-traffic moderated list that receives about five " @@ -350,17 +349,17 @@ msgid "" "`_." msgstr "" -#: faq/general.rst:220 +#: faq/general.rst:222 msgid "" "More info about other mailing lists and newsgroups can be found at https://" "www.python.org/community/lists/." msgstr "" -#: faq/general.rst:225 +#: faq/general.rst:227 msgid "How do I get a beta test version of Python?" msgstr "" -#: faq/general.rst:227 +#: faq/general.rst:229 msgid "" "Alpha and beta releases are available from https://www.python.org/" "downloads/. All releases are announced on the comp.lang.python and comp." @@ -368,81 +367,81 @@ msgid "" "python.org/; an RSS feed of news is available." msgstr "" -#: faq/general.rst:232 +#: faq/general.rst:234 msgid "" "You can also access the development version of Python through Git. See `The " "Python Developer's Guide `_ for details." msgstr "" -#: faq/general.rst:237 +#: faq/general.rst:239 msgid "How do I submit bug reports and patches for Python?" msgstr "" -#: faq/general.rst:239 +#: faq/general.rst:241 msgid "" "To report a bug or submit a patch, use the issue tracker at https://github." "com/python/cpython/issues." msgstr "" -#: faq/general.rst:242 +#: faq/general.rst:244 msgid "" "For more information on how Python is developed, consult `the Python " "Developer's Guide `_." msgstr "" -#: faq/general.rst:247 +#: faq/general.rst:249 msgid "Are there any published articles about Python that I can reference?" msgstr "" -#: faq/general.rst:249 +#: faq/general.rst:251 msgid "It's probably best to cite your favorite book about Python." msgstr "" -#: faq/general.rst:251 +#: faq/general.rst:253 msgid "" "The `very first article `_ about Python was " "written in 1991 and is now quite outdated." msgstr "" -#: faq/general.rst:254 +#: faq/general.rst:256 msgid "" "Guido van Rossum and Jelke de Boer, \"Interactively Testing Remote Servers " "Using the Python Programming Language\", CWI Quarterly, Volume 4, Issue 4 " "(December 1991), Amsterdam, pp 283--303." msgstr "" -#: faq/general.rst:260 +#: faq/general.rst:262 msgid "Are there any books on Python?" msgstr "" -#: faq/general.rst:262 +#: faq/general.rst:264 msgid "" "Yes, there are many, and more are being published. See the python.org wiki " "at https://wiki.python.org/moin/PythonBooks for a list." msgstr "" -#: faq/general.rst:265 +#: faq/general.rst:267 msgid "" "You can also search online bookstores for \"Python\" and filter out the " "Monty Python references; or perhaps search for \"Python\" and \"language\"." msgstr "" -#: faq/general.rst:270 +#: faq/general.rst:272 msgid "Where in the world is www.python.org located?" msgstr "" -#: faq/general.rst:272 +#: faq/general.rst:274 msgid "" "The Python project's infrastructure is located all over the world and is " "managed by the Python Infrastructure Team. Details `here `__." msgstr "" -#: faq/general.rst:277 +#: faq/general.rst:279 msgid "Why is it called Python?" msgstr "" -#: faq/general.rst:279 +#: faq/general.rst:281 msgid "" "When he began implementing Python, Guido van Rossum was also reading the " "published scripts from `\"Monty Python's Flying Circus\" `_. There are two production-ready " @@ -493,34 +492,34 @@ msgid "" "`it is not maintained anymore `_." msgstr "" -#: faq/general.rst:316 +#: faq/general.rst:318 msgid "How many people are using Python?" msgstr "" -#: faq/general.rst:318 +#: faq/general.rst:320 msgid "" "There are probably millions of users, though it's difficult to obtain an " "exact count." msgstr "" -#: faq/general.rst:321 +#: faq/general.rst:323 msgid "" "Python is available for free download, so there are no sales figures, and " "it's available from many different sites and packaged with many Linux " "distributions, so download statistics don't tell the whole story either." msgstr "" -#: faq/general.rst:325 +#: faq/general.rst:327 msgid "" "The comp.lang.python newsgroup is very active, but not all Python users post " "to the group or even read it." msgstr "" -#: faq/general.rst:330 +#: faq/general.rst:332 msgid "Have any significant projects been done in Python?" msgstr "" -#: faq/general.rst:332 +#: faq/general.rst:334 msgid "" "See https://www.python.org/about/success for a list of projects that use " "Python. Consulting the proceedings for `past Python conferences `_ and `the Zope application server `_." msgstr "" -#: faq/general.rst:359 +#: faq/general.rst:361 msgid "Is it reasonable to propose incompatible changes to Python?" msgstr "" -#: faq/general.rst:361 +#: faq/general.rst:363 msgid "" "In general, no. There are already millions of lines of Python code around " "the world, so any change in the language that invalidates more than a very " @@ -571,22 +570,22 @@ msgid "" "to invalidate them all at a single stroke." msgstr "" -#: faq/general.rst:368 +#: faq/general.rst:370 msgid "" "Providing a gradual upgrade path is necessary if a feature has to be " "changed. :pep:`5` describes the procedure followed for introducing backward-" "incompatible changes while minimizing disruption for users." msgstr "" -#: faq/general.rst:374 +#: faq/general.rst:376 msgid "Is Python a good language for beginning programmers?" msgstr "" -#: faq/general.rst:376 +#: faq/general.rst:378 msgid "Yes." msgstr "" -#: faq/general.rst:378 +#: faq/general.rst:380 msgid "" "It is still common to start students with a procedural and statically typed " "language such as Pascal, C, or a subset of C++ or Java. Students may be " @@ -599,7 +598,7 @@ msgid "" "with user-defined objects in their very first course." msgstr "" -#: faq/general.rst:388 +#: faq/general.rst:390 msgid "" "For a student who has never programmed before, using a statically typed " "language seems unnatural. It presents additional complexity that the " @@ -611,7 +610,7 @@ msgid "" "course." msgstr "" -#: faq/general.rst:396 +#: faq/general.rst:398 msgid "" "Many other aspects of Python make it a good first language. Like Java, " "Python has a large standard library so that students can be assigned " @@ -624,7 +623,7 @@ msgid "" "helpful in extending the students' reach." msgstr "" -#: faq/general.rst:405 +#: faq/general.rst:407 msgid "" "Python's interactive interpreter enables students to test language features " "while they're programming. They can keep a window with the interpreter " @@ -632,13 +631,13 @@ msgid "" "can't remember the methods for a list, they can do something like this::" msgstr "" -#: faq/general.rst:434 +#: faq/general.rst:436 msgid "" "With the interpreter, documentation is never far from the student as they " "are programming." msgstr "" -#: faq/general.rst:437 +#: faq/general.rst:439 msgid "" "There are also good IDEs for Python. IDLE is a cross-platform IDE for " "Python that is written in Python using Tkinter. Emacs users will be happy to " @@ -649,7 +648,7 @@ msgid "" "Python editing environments." msgstr "" -#: faq/general.rst:445 +#: faq/general.rst:447 msgid "" "If you want to discuss Python's use in education, you may be interested in " "joining `the edu-sig mailing list \n" @@ -1654,7 +1654,7 @@ msgstr "" msgid "keyword argument" msgstr "anahtar kelime argümanı" -#: glossary.rst:1000 +#: glossary.rst:1001 msgid "See :term:`argument`." msgstr "Bakınız :term:`argument`." @@ -1702,40 +1702,10 @@ msgstr "" "sorun, kilitlerle veya EAFP yaklaşımı kullanılarak çözülebilir." #: glossary.rst:728 -msgid "locale encoding" -msgstr "yerel kodlama" - -#: glossary.rst:730 -msgid "" -"On Unix, it is the encoding of the LC_CTYPE locale. It can be set with :func:" -"`locale.setlocale(locale.LC_CTYPE, new_locale) `." -msgstr "" -"Unix'te, LC_CTYPE yerel ayarının kodlamasıdır. :func:`locale." -"setlocale(locale.LC_CTYPE, new_locale) ` ile ayarlanabilir." - -#: glossary.rst:733 -msgid "On Windows, it is the ANSI code page (ex: ``\"cp1252\"``)." -msgstr "Windows'ta bu, ANSI kod sayfasıdır (ör. ``\"cp1252\"``)." - -#: glossary.rst:735 -msgid "" -"On Android and VxWorks, Python uses ``\"utf-8\"`` as the locale encoding." -msgstr "" -"Android ve VxWorks'te Python, yerel kodlama olarak ``\"utf-8\"`` kullanır." - -#: glossary.rst:737 -msgid "``locale.getencoding()`` can be used to get the locale encoding." -msgstr "Yerel kodlamayı almak için ``locale.getencoding()`` kullanılabilir." - -#: glossary.rst:739 -msgid "See also the :term:`filesystem encoding and error handler`." -msgstr "Ayrıca :term:`filesystem encoding and error handler` 'ne bakın." - -#: glossary.rst:740 msgid "list" msgstr "liste" -#: glossary.rst:742 +#: glossary.rst:730 #, fuzzy msgid "" "A built-in Python :term:`sequence`. Despite its name it is more akin to an " @@ -1746,11 +1716,11 @@ msgstr "" "olduğundan, diğer dillerdeki bir diziye, bağlantılı bir listeden daha " "yakındır." -#: glossary.rst:745 +#: glossary.rst:733 msgid "list comprehension" msgstr "liste anlama" -#: glossary.rst:747 +#: glossary.rst:735 msgid "" "A compact way to process all or part of the elements in a sequence and " "return a list with the results. ``result = ['{:#04x}'.format(x) for x in " @@ -1765,11 +1735,11 @@ msgstr "" "tümcesi isteğe bağlıdır. Atlanırsa, \"aralık(256)\" içindeki tüm öğeler " "işlenir." -#: glossary.rst:753 +#: glossary.rst:741 msgid "loader" msgstr "yükleyici" -#: glossary.rst:755 +#: glossary.rst:743 msgid "" "An object that loads a module. It must define a method named :meth:" "`load_module`. A loader is typically returned by a :term:`finder`. See :pep:" @@ -1781,6 +1751,37 @@ msgstr "" "Ayrıntılar için :pep:`302` ve bir :term:`soyut temel sınıf` için :class:" "`importlib.abc.Loader` bölümüne bakın." +#: glossary.rst:747 +msgid "locale encoding" +msgstr "yerel kodlama" + +#: glossary.rst:749 +msgid "" +"On Unix, it is the encoding of the LC_CTYPE locale. It can be set with :func:" +"`locale.setlocale(locale.LC_CTYPE, new_locale) `." +msgstr "" +"Unix'te, LC_CTYPE yerel ayarının kodlamasıdır. :func:`locale." +"setlocale(locale.LC_CTYPE, new_locale) ` ile ayarlanabilir." + +#: glossary.rst:752 +msgid "On Windows, it is the ANSI code page (ex: ``\"cp1252\"``)." +msgstr "Windows'ta bu, ANSI kod sayfasıdır (ör. ``\"cp1252\"``)." + +#: glossary.rst:754 +msgid "" +"On Android and VxWorks, Python uses ``\"utf-8\"`` as the locale encoding." +msgstr "" +"Android ve VxWorks'te Python, yerel kodlama olarak ``\"utf-8\"`` kullanır." + +#: glossary.rst:756 +#, fuzzy +msgid ":func:`locale.getencoding` can be used to get the locale encoding." +msgstr "Yerel kodlamayı almak için ``locale.getencoding()`` kullanılabilir." + +#: glossary.rst:758 +msgid "See also the :term:`filesystem encoding and error handler`." +msgstr "Ayrıca :term:`filesystem encoding and error handler` 'ne bakın." + #: glossary.rst:759 msgid "magic method" msgstr "sihirli yöntem" @@ -1860,7 +1861,7 @@ msgstr "" msgid "More information can be found in :ref:`metaclasses`." msgstr "Daha fazla bilgi :ref:`metaclasses` içinde bulunabilir." -#: glossary.rst:1130 +#: glossary.rst:1131 msgid "method" msgstr "metot" @@ -1967,13 +1968,15 @@ msgstr "" "olarak adlandırılır. Başka bir örnek :data:`sys.float_info`::" #: glossary.rst:840 +#, fuzzy msgid "" "Some named tuples are built-in types (such as the above examples). " "Alternatively, a named tuple can be created from a regular class definition " "that inherits from :class:`tuple` and that defines named fields. Such a " -"class can be written by hand or it can be created with the factory function :" -"func:`collections.namedtuple`. The latter technique also adds some extra " -"methods that may not be found in hand-written or built-in named tuples." +"class can be written by hand, or it can be created by inheriting :class:" +"`typing.NamedTuple`, or with the factory function :func:`collections." +"namedtuple`. The latter techniques also add some extra methods that may not " +"be found in hand-written or built-in named tuples." msgstr "" "Bazı adlandırılmış demetler yerleşik türlerdir (yukarıdaki örnekler gibi). " "Alternatif olarak, :class:`tuple` öğesinden miras alan ve adlandırılmış " @@ -1983,11 +1986,11 @@ msgstr "" "yazılmış veya yerleşik adlandırılmış demetlerde bulunmayan bazı ekstra " "yöntemler ekler." -#: glossary.rst:847 +#: glossary.rst:848 msgid "namespace" msgstr "ad alanı" -#: glossary.rst:849 +#: glossary.rst:850 msgid "" "The place where a variable is stored. Namespaces are implemented as " "dictionaries. There are the local, global and built-in namespaces as well " @@ -2009,11 +2012,11 @@ msgstr "" "yazmak, bu işlevlerin sırasıyla :mod:`random` ve :mod:`itertools` modülleri " "tarafından uygulandığını açıkça gösterir." -#: glossary.rst:859 +#: glossary.rst:860 msgid "namespace package" msgstr "ad alanı paketi" -#: glossary.rst:861 +#: glossary.rst:862 msgid "" "A :pep:`420` :term:`package` which serves only as a container for " "subpackages. Namespace packages may have no physical representation, and " @@ -2025,15 +2028,15 @@ msgstr "" "``__init__.py`` dosyası olmadığından özellikle :term:`regular package` gibi " "değildirler." -#: glossary.rst:866 +#: glossary.rst:867 msgid "See also :term:`module`." msgstr "Ayrıca bkz. :term:`module`." -#: glossary.rst:867 +#: glossary.rst:868 msgid "nested scope" msgstr "iç içe kapsam" -#: glossary.rst:869 +#: glossary.rst:870 msgid "" "The ability to refer to a variable in an enclosing definition. For " "instance, a function defined inside another function can refer to variables " @@ -2050,11 +2053,11 @@ msgstr "" "global değişkenler global ad alanını okur ve yazar. :keyword:`nonlocal`, dış " "kapsamlara yazmaya izin verir." -#: glossary.rst:876 +#: glossary.rst:877 msgid "new-style class" msgstr "yeni stil sınıf" -#: glossary.rst:878 +#: glossary.rst:879 #, fuzzy msgid "" "Old name for the flavor of classes now used for all class objects. In " @@ -2068,11 +2071,11 @@ msgstr "" "sınıf yöntemleri ve statik yöntemler gibi daha yeni, çok yönlü özelliklerini " "kullanabilirdi." -#: glossary.rst:883 +#: glossary.rst:884 msgid "object" msgstr "obje" -#: glossary.rst:885 +#: glossary.rst:886 msgid "" "Any data with state (attributes or value) and defined behavior (methods). " "Also the ultimate base class of any :term:`new-style class`." @@ -2081,11 +2084,11 @@ msgstr "" "herhangi bir veri. Ayrıca herhangi bir :term:`yeni tarz sınıfın ` nihai temel sınıfı." -#: glossary.rst:888 +#: glossary.rst:889 msgid "package" msgstr "paket" -#: glossary.rst:890 +#: glossary.rst:891 msgid "" "A Python :term:`module` which can contain submodules or recursively, " "subpackages. Technically, a package is a Python module with a ``__path__`` " @@ -2095,15 +2098,15 @@ msgstr "" "`module`. Teknik olarak bir paket, ``__path__`` özniteliğine sahip bir " "Python modülüdür." -#: glossary.rst:894 +#: glossary.rst:895 msgid "See also :term:`regular package` and :term:`namespace package`." msgstr "Ayrıca bkz. :term:`regular package` ve :term:`namespace package`." -#: glossary.rst:895 +#: glossary.rst:896 msgid "parameter" msgstr "parametre" -#: glossary.rst:897 +#: glossary.rst:898 msgid "" "A named entity in a :term:`function` (or method) definition that specifies " "an :term:`argument` (or in some cases, arguments) that the function can " @@ -2113,7 +2116,7 @@ msgstr "" "term:`argument` (veya bazı durumlarda, argümanlar) belirten adlandırılmış " "bir varlık. Beş çeşit parametre vardır:" -#: glossary.rst:901 +#: glossary.rst:902 msgid "" ":dfn:`positional-or-keyword`: specifies an argument that can be passed " "either :term:`positionally ` or as a :term:`keyword argument " @@ -2124,7 +2127,7 @@ msgstr "" "`keyword argümanı ` olarak iletilebilen bir argüman belirtir. Bu, " "varsayılan parametre türüdür, örneğin aşağıdakilerde *foo* ve *bar*::" -#: glossary.rst:910 +#: glossary.rst:911 msgid "" ":dfn:`positional-only`: specifies an argument that can be supplied only by " "position. Positional-only parameters can be defined by including a ``/`` " @@ -2136,7 +2139,7 @@ msgstr "" "parametre listesine bir ``/`` karakteri eklenerek tanımlanabilir, örneğin " "aşağıdakilerde *posonly1* ve *posonly2*::" -#: glossary.rst:919 +#: glossary.rst:920 msgid "" ":dfn:`keyword-only`: specifies an argument that can be supplied only by " "keyword. Keyword-only parameters can be defined by including a single var-" @@ -2150,7 +2153,7 @@ msgstr "" "parametre veya çıplak ``*`` dahil edilerek tanımlanabilir, örneğin " "aşağıdakilerde *kw_only1* ve *kw_only2*::" -#: glossary.rst:927 +#: glossary.rst:928 msgid "" ":dfn:`var-positional`: specifies that an arbitrary sequence of positional " "arguments can be provided (in addition to any positional arguments already " @@ -2164,7 +2167,7 @@ msgstr "" "parametre adının başına ``*`` eklenerek tanımlanabilir, örneğin " "aşağıdakilerde *args*::" -#: glossary.rst:935 +#: glossary.rst:936 msgid "" ":dfn:`var-keyword`: specifies that arbitrarily many keyword arguments can be " "provided (in addition to any keyword arguments already accepted by other " @@ -2177,7 +2180,7 @@ msgstr "" "parametre adının başına ``**``, örneğin yukarıdaki örnekte *kwargs* " "eklenerek tanımlanabilir." -#: glossary.rst:941 +#: glossary.rst:942 msgid "" "Parameters can specify both optional and required arguments, as well as " "default values for some optional arguments." @@ -2185,7 +2188,7 @@ msgstr "" "Parametreler, hem isteğe bağlı hem de gerekli argümanleri ve ayrıca bazı " "isteğe bağlı bağımsız değişkenler için varsayılan değerleri belirtebilir." -#: glossary.rst:944 +#: glossary.rst:945 msgid "" "See also the :term:`argument` glossary entry, the FAQ question on :ref:`the " "difference between arguments and parameters `, " @@ -2196,11 +2199,11 @@ msgstr "" "arasındaki fark `, :class:`inspect.Parameter`, :" "ref:`function` ve :pep:`362`." -#: glossary.rst:948 +#: glossary.rst:949 msgid "path entry" msgstr "yol girişi" -#: glossary.rst:950 +#: glossary.rst:951 msgid "" "A single location on the :term:`import path` which the :term:`path based " "finder` consults to find modules for importing." @@ -2208,11 +2211,11 @@ msgstr "" ":term:`path based finder` içe aktarma modüllerini bulmak için başvurduğu :" "term:`import path` üzerindeki tek bir konum." -#: glossary.rst:952 +#: glossary.rst:953 msgid "path entry finder" msgstr "yol girişi bulucu" -#: glossary.rst:954 +#: glossary.rst:955 msgid "" "A :term:`finder` returned by a callable on :data:`sys.path_hooks` (i.e. a :" "term:`path entry hook`) which knows how to locate modules given a :term:" @@ -2222,7 +2225,7 @@ msgstr "" "kancası`) üzerinde bir çağrılabilir tarafından döndürülür ve :term:`path " "entry` verilen modüllerin nasıl bulunacağını bilir." -#: glossary.rst:958 +#: glossary.rst:959 msgid "" "See :class:`importlib.abc.PathEntryFinder` for the methods that path entry " "finders implement." @@ -2230,11 +2233,11 @@ msgstr "" "Yol girişi bulucularının uyguladığı yöntemler için :class:`importlib.abc." "PathEntryFinder` bölümüne bakın." -#: glossary.rst:960 +#: glossary.rst:961 msgid "path entry hook" msgstr "yol giriş kancası" -#: glossary.rst:962 +#: glossary.rst:963 #, fuzzy msgid "" "A callable on the :data:`sys.path_hooks` list which returns a :term:`path " @@ -2245,11 +2248,11 @@ msgstr "" "entry>` modülleri nasıl bulacağını biliyorsa, bir :term:`yol girişi bulucu " "` döndüren bir çağrılabilir." -#: glossary.rst:965 +#: glossary.rst:966 msgid "path based finder" msgstr "yol tabanlı bulucu" -#: glossary.rst:967 +#: glossary.rst:968 msgid "" "One of the default :term:`meta path finders ` which " "searches an :term:`import path` for modules." @@ -2257,11 +2260,11 @@ msgstr "" "Modüller için bir :term:`import path` arayan varsayılan :term:`meta yol " "buluculardan ` biri." -#: glossary.rst:969 +#: glossary.rst:970 msgid "path-like object" msgstr "yol benzeri nesne" -#: glossary.rst:971 +#: glossary.rst:972 msgid "" "An object representing a file system path. A path-like object is either a :" "class:`str` or :class:`bytes` object representing a path, or an object " @@ -2281,11 +2284,11 @@ msgstr "" "veya :class:`bytes` sonucunu garanti etmek için kullanılabilir. :pep:`519` " "tarafından tanıtıldı." -#: glossary.rst:979 +#: glossary.rst:980 msgid "PEP" msgstr "PEP" -#: glossary.rst:981 +#: glossary.rst:982 msgid "" "Python Enhancement Proposal. A PEP is a design document providing " "information to the Python community, or describing a new feature for Python " @@ -2297,7 +2300,7 @@ msgstr "" "tasarım belgesidir. PEP'ler, önerilen özellikler için özlü bir teknik " "şartname ve bir gerekçe sağlamalıdır." -#: glossary.rst:987 +#: glossary.rst:988 msgid "" "PEPs are intended to be the primary mechanisms for proposing major new " "features, for collecting community input on an issue, and for documenting " @@ -2310,15 +2313,15 @@ msgstr "" "birincil mekanizmalar olması amaçlanmıştır. PEP yazarı, topluluk içinde " "fikir birliği oluşturmaktan ve muhalif görüşleri belgelemekten sorumludur." -#: glossary.rst:993 +#: glossary.rst:994 msgid "See :pep:`1`." msgstr "Bakınız :pep:`1`." -#: glossary.rst:994 +#: glossary.rst:995 msgid "portion" msgstr "kısım" -#: glossary.rst:996 +#: glossary.rst:997 msgid "" "A set of files in a single directory (possibly stored in a zip file) that " "contribute to a namespace package, as defined in :pep:`420`." @@ -2326,15 +2329,15 @@ msgstr "" ":pep:`420` içinde tanımlandığı gibi, bir ad alanı paketine katkıda bulunan " "tek bir dizindeki (muhtemelen bir zip dosyasında depolanan) bir dizi dosya." -#: glossary.rst:998 +#: glossary.rst:999 msgid "positional argument" msgstr "konumsal argüman" -#: glossary.rst:1001 +#: glossary.rst:1002 msgid "provisional API" msgstr "geçici API" -#: glossary.rst:1003 +#: glossary.rst:1004 msgid "" "A provisional API is one which has been deliberately excluded from the " "standard library's backwards compatibility guarantees. While major changes " @@ -2353,7 +2356,7 @@ msgstr "" "yalnızca API'nin eklenmesinden önce gözden kaçan ciddi temel kusurlar ortaya " "çıkarsa gerçekleşecektir." -#: glossary.rst:1012 +#: glossary.rst:1013 msgid "" "Even for provisional APIs, backwards incompatible changes are seen as a " "\"solution of last resort\" - every attempt will still be made to find a " @@ -2363,7 +2366,7 @@ msgstr "" "çözümü\" olarak görülür - tanımlanan herhangi bir soruna geriye dönük uyumlu " "bir çözüm bulmak için her türlü girişimde bulunulacaktır." -#: glossary.rst:1016 +#: glossary.rst:1017 msgid "" "This process allows the standard library to continue to evolve over time, " "without locking in problematic design errors for extended periods of time. " @@ -2373,19 +2376,19 @@ msgstr "" "hatalarına kilitlenmeden zaman içinde gelişmeye devam etmesini sağlar. Daha " "fazla ayrıntı için bkz. :pep:`411`." -#: glossary.rst:1019 +#: glossary.rst:1020 msgid "provisional package" msgstr "geçici paket" -#: glossary.rst:1021 +#: glossary.rst:1022 msgid "See :term:`provisional API`." msgstr "Bakınız :term:`provisional API`." -#: glossary.rst:1022 +#: glossary.rst:1023 msgid "Python 3000" msgstr "Python 3000" -#: glossary.rst:1024 +#: glossary.rst:1025 msgid "" "Nickname for the Python 3.x release line (coined long ago when the release " "of version 3 was something in the distant future.) This is also abbreviated " @@ -2395,11 +2398,11 @@ msgstr "" "sürülmesi uzak bir gelecekte olduğu zaman ortaya çıktı.) Bu aynı zamanda " "\"Py3k\" olarak da kısaltılır." -#: glossary.rst:1027 +#: glossary.rst:1028 msgid "Pythonic" msgstr "Pythonic" -#: glossary.rst:1029 +#: glossary.rst:1030 msgid "" "An idea or piece of code which closely follows the most common idioms of the " "Python language, rather than implementing code using concepts common to " @@ -2415,15 +2418,15 @@ msgstr "" "oluşturmaktır. Diğer birçok dilde bu tür bir yapı yoktur, bu nedenle " "Python'a aşina olmayan kişiler bazen bunun yerine sayısal bir sayaç kullanır:" -#: glossary.rst:1039 +#: glossary.rst:1040 msgid "As opposed to the cleaner, Pythonic method::" msgstr "Temizleyicinin aksine, Pythonic yöntemi::" -#: glossary.rst:1043 +#: glossary.rst:1044 msgid "qualified name" msgstr "nitelikli isim" -#: glossary.rst:1045 +#: glossary.rst:1046 msgid "" "A dotted name showing the \"path\" from a module's global scope to a class, " "function or method defined in that module, as defined in :pep:`3155`. For " @@ -2435,7 +2438,7 @@ msgstr "" "noktalı ad. Üst düzey işlevler ve sınıflar için nitelikli ad, nesnenin " "adıyla aynıdır::" -#: glossary.rst:1062 +#: glossary.rst:1063 msgid "" "When used to refer to modules, the *fully qualified name* means the entire " "dotted path to the module, including any parent packages, e.g. ``email.mime." @@ -2445,11 +2448,11 @@ msgstr "" "herhangi bir üst paket de dahil olmak üzere, modüle giden tüm noktalı yol " "anlamına gelir, örn. ``email.mime.text``::" -#: glossary.rst:1069 +#: glossary.rst:1070 msgid "reference count" msgstr "referans sayısı" -#: glossary.rst:1071 +#: glossary.rst:1072 #, fuzzy msgid "" "The number of references to an object. When the reference count of an " @@ -2466,26 +2469,26 @@ msgstr "" "öğesidir. Programcılar, belirli bir nesne için başvuru sayısını döndürmek " "için :func:`sys.getrefcount` işlevini çağırabilir." -#: glossary.rst:1079 +#: glossary.rst:1080 msgid "regular package" msgstr "sürekli paketleme" -#: glossary.rst:1081 +#: glossary.rst:1082 msgid "" "A traditional :term:`package`, such as a directory containing an ``__init__." "py`` file." msgstr "" "``__init__.py`` dosyası içeren bir dizin gibi geleneksel bir :term:`package`." -#: glossary.rst:1084 +#: glossary.rst:1085 msgid "See also :term:`namespace package`." msgstr "Ayrıca bkz. :term:`ad alanı paketi`." -#: glossary.rst:1085 +#: glossary.rst:1086 msgid "__slots__" msgstr "__slots__" -#: glossary.rst:1087 +#: glossary.rst:1088 msgid "" "A declaration inside a class that saves memory by pre-declaring space for " "instance attributes and eliminating instance dictionaries. Though popular, " @@ -2499,11 +2502,11 @@ msgstr "" "açısından kritik bir uygulamada çok sayıda örneğin bulunduğu nadir durumlar " "için ayrılmıştır." -#: glossary.rst:1092 +#: glossary.rst:1093 msgid "sequence" msgstr "dizi" -#: glossary.rst:1094 +#: glossary.rst:1095 #, fuzzy msgid "" "An :term:`iterable` which supports efficient element access using integer " @@ -2524,7 +2527,7 @@ msgstr "" "`immutable` anahtarları kullandığından bir diziden ziyade bir eşleme olarak " "kabul edilir." -#: glossary.rst:1103 +#: glossary.rst:1104 #, fuzzy msgid "" "The :class:`collections.abc.Sequence` abstract base class defines a much " @@ -2541,11 +2544,11 @@ msgstr "" "arayüzü tanımlar. Bu genişletilmiş arabirimi uygulayan türler, :func:`~abc." "ABCMeta.register` kullanılarak açıkça kaydedilebilir." -#: glossary.rst:1112 +#: glossary.rst:1113 msgid "set comprehension" msgstr "anlamak" -#: glossary.rst:1114 +#: glossary.rst:1115 msgid "" "A compact way to process all or part of the elements in an iterable and " "return a set with the results. ``results = {c for c in 'abracadabra' if c " @@ -2557,11 +2560,11 @@ msgstr "" "for c in 'abracadabra' if c not in 'abc'}``, ``{'r', 'd'}`` dizelerini " "oluşturur. Bakınız :ref:`comprehensions`." -#: glossary.rst:1118 +#: glossary.rst:1119 msgid "single dispatch" msgstr "tek sevk" -#: glossary.rst:1120 +#: glossary.rst:1121 msgid "" "A form of :term:`generic function` dispatch where the implementation is " "chosen based on the type of a single argument." @@ -2569,11 +2572,11 @@ msgstr "" "Uygulamanın tek bir argüman türüne göre seçildiği bir :term:`generic " "function` gönderimi biçimi." -#: glossary.rst:1122 +#: glossary.rst:1123 msgid "slice" msgstr "parçalamak" -#: glossary.rst:1124 +#: glossary.rst:1125 msgid "" "An object usually containing a portion of a :term:`sequence`. A slice is " "created using the subscript notation, ``[]`` with colons between numbers " @@ -2586,11 +2589,11 @@ msgstr "" "gösterimi kullanılarak oluşturulur. Köşeli ayraç (alt simge) gösterimi, " "dahili olarak :class:`slice` nesnelerini kullanır." -#: glossary.rst:1128 +#: glossary.rst:1129 msgid "special method" msgstr "özel metod" -#: glossary.rst:1132 +#: glossary.rst:1133 msgid "" "A method that is called implicitly by Python to execute a certain operation " "on a type, such as addition. Such methods have names starting and ending " @@ -2602,11 +2605,11 @@ msgstr "" "çizgi ile başlayan ve biten adları vardır. Özel yöntemler :ref:" "`specialnames` içinde belgelenmiştir." -#: glossary.rst:1136 +#: glossary.rst:1137 msgid "statement" msgstr "ifade (değer döndürmez)" -#: glossary.rst:1138 +#: glossary.rst:1139 msgid "" "A statement is part of a suite (a \"block\" of code). A statement is either " "an :term:`expression` or one of several constructs with a keyword, such as :" @@ -2616,22 +2619,22 @@ msgstr "" "`expression` veya :keyword:`if`, :keyword:`while` veya :keyword:`for` gibi " "bir anahtar kelimeye sahip birkaç yapıdan biridir." -#: glossary.rst:1141 +#: glossary.rst:1142 msgid "static type checker" msgstr "" -#: glossary.rst:1143 +#: glossary.rst:1144 msgid "" "An external tool that reads Python code and analyzes it, looking for issues " "such as incorrect types. See also :term:`type hints ` and the :" "mod:`typing` module." msgstr "" -#: glossary.rst:1146 +#: glossary.rst:1147 msgid "strong reference" msgstr "güçlü referans" -#: glossary.rst:1148 +#: glossary.rst:1149 #, fuzzy msgid "" "In Python's C API, a strong reference is a reference to an object which is " @@ -2643,7 +2646,7 @@ msgstr "" "referans sayısını artıran ve silindiğinde nesnenin referans sayısını azaltan " "bir nesneye yapılan referanstır." -#: glossary.rst:1154 +#: glossary.rst:1155 msgid "" "The :c:func:`Py_NewRef` function can be used to create a strong reference to " "an object. Usually, the :c:func:`Py_DECREF` function must be called on the " @@ -2655,15 +2658,15 @@ msgstr "" "referansın sızmasını önlemek için güçlü referans kapsamından çıkmadan önce " "güçlü referansta çağrılmalıdır." -#: glossary.rst:1159 +#: glossary.rst:1160 msgid "See also :term:`borrowed reference`." msgstr "Ayrıca bkz. :term:`ödünç alınan referans `." -#: glossary.rst:1160 +#: glossary.rst:1161 msgid "text encoding" msgstr "yazı çözümleme" -#: glossary.rst:1162 +#: glossary.rst:1163 msgid "" "A string in Python is a sequence of Unicode code points (in range " "``U+0000``--``U+10FFFF``). To store or transfer a string, it needs to be " @@ -2673,7 +2676,7 @@ msgstr "" "``U+10FFFF`` aralığında). Bir dizeyi depolamak veya aktarmak için, bir bayt " "dizisi olarak seri hale getirilmesi gerekir." -#: glossary.rst:1166 +#: glossary.rst:1167 msgid "" "Serializing a string into a sequence of bytes is known as \"encoding\", and " "recreating the string from the sequence of bytes is known as \"decoding\"." @@ -2682,7 +2685,7 @@ msgstr "" "olarak bilinir ve dizeyi bayt dizisinden yeniden oluşturmak \"kod çözme " "(decoding)\" olarak bilinir." -#: glossary.rst:1169 +#: glossary.rst:1170 msgid "" "There are a variety of different text serialization :ref:`codecs `, which are collectively referred to as \"text encodings\"." @@ -2690,11 +2693,11 @@ msgstr "" "Toplu olarak \"metin kodlamaları\" olarak adlandırılan çeşitli farklı metin " "serileştirme :ref:`kodekleri ` vardır." -#: glossary.rst:1172 +#: glossary.rst:1173 msgid "text file" msgstr "yazı dosyası" -#: glossary.rst:1174 +#: glossary.rst:1175 msgid "" "A :term:`file object` able to read and write :class:`str` objects. Often, a " "text file actually accesses a byte-oriented datastream and handles the :term:" @@ -2708,7 +2711,7 @@ msgstr "" "metin modunda açılan dosyalar (``'r'`` veya ``'w'``), :data:`sys.stdin`, :" "data:`sys.stdout` ve :class:`io.StringIO` örnekleri verilebilir." -#: glossary.rst:1181 +#: glossary.rst:1182 msgid "" "See also :term:`binary file` for a file object able to read and write :term:" "`bytes-like objects `." @@ -2716,11 +2719,11 @@ msgstr "" "Ayrıca :term:`ikili dosyaları ` okuyabilen ve yazabilen bir " "dosya nesnesi için :term:`bayt benzeri nesnelere ` bakın." -#: glossary.rst:1183 +#: glossary.rst:1184 msgid "triple-quoted string" msgstr "üç tırnaklı dize" -#: glossary.rst:1185 +#: glossary.rst:1186 msgid "" "A string which is bound by three instances of either a quotation mark (\") " "or an apostrophe ('). While they don't provide any functionality not " @@ -2737,11 +2740,11 @@ msgstr "" "yayılabilir, bu da onları özellikle belge dizileri yazarken kullanışlı hale " "getirir." -#: glossary.rst:1192 +#: glossary.rst:1193 msgid "type" msgstr "tip" -#: glossary.rst:1194 +#: glossary.rst:1195 msgid "" "The type of a Python object determines what kind of object it is; every " "object has a type. An object's type is accessible as its :attr:`~instance." @@ -2751,15 +2754,15 @@ msgstr "" "nesnenin bir türü vardır. Bir nesnenin tipine :attr:`~instance.__class__` " "niteliği ile erişilebilir veya ``type(obj)`` ile alınabilir." -#: glossary.rst:1198 +#: glossary.rst:1199 msgid "type alias" msgstr "tip takma adı" -#: glossary.rst:1200 +#: glossary.rst:1201 msgid "A synonym for a type, created by assigning the type to an identifier." msgstr "Bir tanımlayıcıya tür atanarak oluşturulan, bir tür için eş anlamlı." -#: glossary.rst:1202 +#: glossary.rst:1203 msgid "" "Type aliases are useful for simplifying :term:`type hints `. For " "example::" @@ -2767,19 +2770,19 @@ msgstr "" "Tür takma adları, :term:`tür ipuçlarını ` basitleştirmek için " "kullanışlıdır. Örneğin::" -#: glossary.rst:1209 +#: glossary.rst:1210 msgid "could be made more readable like this::" msgstr "bu şekilde daha okunaklı hale getirilebilir::" -#: glossary.rst:1230 +#: glossary.rst:1231 msgid "See :mod:`typing` and :pep:`484`, which describe this functionality." msgstr "Bu işlevi açıklayan :mod:`typing` ve :pep:`484` bölümlerine bakın." -#: glossary.rst:1217 +#: glossary.rst:1218 msgid "type hint" msgstr "tür ipucu" -#: glossary.rst:1219 +#: glossary.rst:1220 msgid "" "An :term:`annotation` that specifies the expected type for a variable, a " "class attribute, or a function parameter or return value." @@ -2787,7 +2790,7 @@ msgstr "" "Bir değişken, bir sınıf niteliği veya bir işlev parametresi veya dönüş " "değeri için beklenen türü belirten bir :term:`ek açıklama `." -#: glossary.rst:1222 +#: glossary.rst:1223 #, fuzzy msgid "" "Type hints are optional and are not enforced by Python but they are useful " @@ -2798,7 +2801,7 @@ msgstr "" "statik tip analiz araçları için faydalıdır ve kod tamamlama ve yeniden " "düzenleme ile IDE'lere yardımcı olur." -#: glossary.rst:1226 +#: glossary.rst:1227 msgid "" "Type hints of global variables, class attributes, and functions, but not " "local variables, can be accessed using :func:`typing.get_type_hints`." @@ -2807,11 +2810,11 @@ msgstr "" "yerel değişkenlere değil, :func:`typing.get_type_hints` kullanılarak " "erişilebilir." -#: glossary.rst:1231 +#: glossary.rst:1232 msgid "universal newlines" msgstr "evrensel yeni satırlar" -#: glossary.rst:1233 +#: glossary.rst:1234 msgid "" "A manner of interpreting text streams in which all of the following are " "recognized as ending a line: the Unix end-of-line convention ``'\\n'``, the " @@ -2824,23 +2827,23 @@ msgstr "" "kuralı ``'\\r\\n'``, ve eski Macintosh kuralı ``'\\r'``. Ek bir kullanım " "için :pep:`278` ve :pep:`3116` ve ayrıca :func:`bytes.splitlines` bakın." -#: glossary.rst:1238 +#: glossary.rst:1239 msgid "variable annotation" msgstr "değişken açıklama" -#: glossary.rst:1240 +#: glossary.rst:1241 msgid "An :term:`annotation` of a variable or a class attribute." msgstr "" "Bir değişkenin veya bir sınıf özniteliğinin :term:`ek açıklaması " "`." -#: glossary.rst:1242 +#: glossary.rst:1243 msgid "" "When annotating a variable or a class attribute, assignment is optional::" msgstr "" "Bir değişkene veya sınıf niteliğine açıklama eklerken atama isteğe bağlıdır::" -#: glossary.rst:1247 +#: glossary.rst:1248 msgid "" "Variable annotations are usually used for :term:`type hints `: " "for example this variable is expected to take :class:`int` values::" @@ -2848,11 +2851,11 @@ msgstr "" "Değişken açıklamaları genellikle :term:`tür ipuçları ` için " "kullanılır: örneğin, bu değişkenin :class:`int` değerlerini alması beklenir::" -#: glossary.rst:1253 +#: glossary.rst:1254 msgid "Variable annotation syntax is explained in section :ref:`annassign`." msgstr "Değişken açıklama sözdizimi :ref:`annassign` bölümünde açıklanmıştır." -#: glossary.rst:1255 +#: glossary.rst:1256 msgid "" "See :term:`function annotation`, :pep:`484` and :pep:`526`, which describe " "this functionality. Also see :ref:`annotations-howto` for best practices on " @@ -2862,11 +2865,11 @@ msgstr "" "bölümlerine bakın. Ek açıklamalarla çalışmaya ilişkin en iyi uygulamalar " "için ayrıca bkz. :ref:`annotations-howto`." -#: glossary.rst:1259 +#: glossary.rst:1260 msgid "virtual environment" msgstr "sanal ortam" -#: glossary.rst:1261 +#: glossary.rst:1262 msgid "" "A cooperatively isolated runtime environment that allows Python users and " "applications to install and upgrade Python distribution packages without " @@ -2878,15 +2881,15 @@ msgstr "" "paketlerini kurmasına ve yükseltmesine olanak tanıyan, işbirliği içinde " "yalıtılmış bir çalışma zamanı ortamı." -#: glossary.rst:1266 +#: glossary.rst:1267 msgid "See also :mod:`venv`." msgstr "Ayrıca bakınız :mod:`venv`." -#: glossary.rst:1267 +#: glossary.rst:1268 msgid "virtual machine" msgstr "sanal makine" -#: glossary.rst:1269 +#: glossary.rst:1270 msgid "" "A computer defined entirely in software. Python's virtual machine executes " "the :term:`bytecode` emitted by the bytecode compiler." @@ -2894,11 +2897,11 @@ msgstr "" "Tamamen yazılımla tanımlanmış bir bilgisayar. Python'un sanal makinesi, bayt " "kodu derleyicisi tarafından yayınlanan :term:`bytecode` 'u çalıştırır." -#: glossary.rst:1271 +#: glossary.rst:1272 msgid "Zen of Python" msgstr "Python'un Zen'i" -#: glossary.rst:1273 +#: glossary.rst:1274 msgid "" "Listing of Python design principles and philosophies that are helpful in " "understanding and using the language. The listing can be found by typing " @@ -2922,7 +2925,7 @@ msgstr "bitişik" msgid "magic" msgstr "" -#: glossary.rst:1130 +#: glossary.rst:1131 #, fuzzy msgid "special" msgstr "özel metod" diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po index 6db77fcf0..dfe6dcf1c 100644 --- a/howto/logging-cookbook.po +++ b/howto/logging-cookbook.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1034,69 +1034,59 @@ msgid "" msgstr "" #: howto/logging-cookbook.rst:1850 -msgid "Subclassing QueueHandler - a ZeroMQ example" +msgid "Subclassing QueueHandler and QueueListener- a ZeroMQ example" msgstr "" -#: howto/logging-cookbook.rst:1852 +#: howto/logging-cookbook.rst:1853 howto/logging-cookbook.rst:1985 +msgid "Subclass ``QueueHandler``" +msgstr "" + +#: howto/logging-cookbook.rst:1855 msgid "" "You can use a :class:`QueueHandler` subclass to send messages to other kinds " "of queues, for example a ZeroMQ 'publish' socket. In the example below,the " "socket is created separately and passed to the handler (as its 'queue')::" msgstr "" -#: howto/logging-cookbook.rst:1871 +#: howto/logging-cookbook.rst:1874 msgid "" "Of course there are other ways of organizing this, for example passing in " "the data needed by the handler to create the socket::" msgstr "" -#: howto/logging-cookbook.rst:1889 -msgid "Subclassing QueueListener - a ZeroMQ example" +#: howto/logging-cookbook.rst:1892 howto/logging-cookbook.rst:1922 +msgid "Subclass ``QueueListener``" msgstr "" -#: howto/logging-cookbook.rst:1891 +#: howto/logging-cookbook.rst:1894 msgid "" "You can also subclass :class:`QueueListener` to get messages from other " "kinds of queues, for example a ZeroMQ 'subscribe' socket. Here's an example::" msgstr "" -#: howto/logging-cookbook.rst:1910 howto/logging-cookbook.rst:3950 -msgid "Module :mod:`logging`" -msgstr "" - -#: howto/logging-cookbook.rst:1910 howto/logging-cookbook.rst:3950 -msgid "API reference for the logging module." -msgstr "" - -#: howto/logging-cookbook.rst:1913 howto/logging-cookbook.rst:3953 -msgid "Module :mod:`logging.config`" +#: howto/logging-cookbook.rst:1912 +msgid "Subclassing QueueHandler and QueueListener- a ``pynng`` example" msgstr "" -#: howto/logging-cookbook.rst:1913 howto/logging-cookbook.rst:3953 -msgid "Configuration API for the logging module." -msgstr "" - -#: howto/logging-cookbook.rst:1916 howto/logging-cookbook.rst:3956 -msgid "Module :mod:`logging.handlers`" -msgstr "" - -#: howto/logging-cookbook.rst:1916 howto/logging-cookbook.rst:3956 -msgid "Useful handlers included with the logging module." -msgstr "" - -#: howto/logging-cookbook.rst:1918 -msgid ":ref:`A basic logging tutorial `" +#: howto/logging-cookbook.rst:1914 +msgid "" +"In a similar way to the above section, we can implement a listener and " +"handler using `pynng `_, which is a Python " +"binding to `NNG `_, billed as a spiritual " +"successor to ZeroMQ. The following snippets illustrate -- you can test them " +"in an environment which has ``pynng`` installed. Juat for variety, we " +"present the listener first." msgstr "" -#: howto/logging-cookbook.rst:1920 -msgid ":ref:`A more advanced logging tutorial `" +#: howto/logging-cookbook.rst:2034 +msgid "You can run the above two snippets in separate command shells." msgstr "" -#: howto/logging-cookbook.rst:1926 +#: howto/logging-cookbook.rst:2038 msgid "An example dictionary-based configuration" msgstr "" -#: howto/logging-cookbook.rst:1928 +#: howto/logging-cookbook.rst:2040 msgid "" "Below is an example of a logging configuration dictionary - it's taken from " "the `documentation on the Django project `_ of the Django documentation." msgstr "" -#: howto/logging-cookbook.rst:1988 +#: howto/logging-cookbook.rst:2100 msgid "Using a rotator and namer to customize log rotation processing" msgstr "" -#: howto/logging-cookbook.rst:1990 +#: howto/logging-cookbook.rst:2102 msgid "" "An example of how you can define a namer and rotator is given in the " "following runnable script, which shows gzip compression of the log file::" msgstr "" -#: howto/logging-cookbook.rst:2021 +#: howto/logging-cookbook.rst:2133 msgid "" "After running this, you will see six new files, five of which are compressed:" msgstr "" -#: howto/logging-cookbook.rst:2034 +#: howto/logging-cookbook.rst:2146 msgid "A more elaborate multiprocessing example" msgstr "" -#: howto/logging-cookbook.rst:2036 +#: howto/logging-cookbook.rst:2148 msgid "" "The following working example shows how logging can be used with " "multiprocessing using configuration files. The configurations are fairly " @@ -1138,7 +1128,7 @@ msgid "" "in a real multiprocessing scenario." msgstr "" -#: howto/logging-cookbook.rst:2041 +#: howto/logging-cookbook.rst:2153 msgid "" "In the example, the main process spawns a listener process and some worker " "processes. Each of the main process, the listener and the workers have three " @@ -1151,17 +1141,17 @@ msgid "" "own scenario." msgstr "" -#: howto/logging-cookbook.rst:2051 +#: howto/logging-cookbook.rst:2163 msgid "" "Here's the script - the docstrings and the comments hopefully explain how it " "works::" msgstr "" -#: howto/logging-cookbook.rst:2263 +#: howto/logging-cookbook.rst:2375 msgid "Inserting a BOM into messages sent to a SysLogHandler" msgstr "" -#: howto/logging-cookbook.rst:2265 +#: howto/logging-cookbook.rst:2377 msgid "" ":rfc:`5424` requires that a Unicode message be sent to a syslog daemon as a " "set of bytes which have the following structure: an optional pure-ASCII " @@ -1170,7 +1160,7 @@ msgid "" "<5424#section-6>`.)" msgstr "" -#: howto/logging-cookbook.rst:2271 +#: howto/logging-cookbook.rst:2383 msgid "" "In Python 3.1, code was added to :class:`~logging.handlers.SysLogHandler` to " "insert a BOM into the message, but unfortunately, it was implemented " @@ -1178,7 +1168,7 @@ msgid "" "hence not allowing any pure-ASCII component to appear before it." msgstr "" -#: howto/logging-cookbook.rst:2277 +#: howto/logging-cookbook.rst:2389 msgid "" "As this behaviour is broken, the incorrect BOM insertion code is being " "removed from Python 3.2.4 and later. However, it is not being replaced, and " @@ -1187,33 +1177,33 @@ msgid "" "encoded using UTF-8, then you need to do the following:" msgstr "" -#: howto/logging-cookbook.rst:2283 +#: howto/logging-cookbook.rst:2395 msgid "" "Attach a :class:`~logging.Formatter` instance to your :class:`~logging." "handlers.SysLogHandler` instance, with a format string such as::" msgstr "" -#: howto/logging-cookbook.rst:2289 +#: howto/logging-cookbook.rst:2401 msgid "" "The Unicode code point U+FEFF, when encoded using UTF-8, will be encoded as " "a UTF-8 BOM -- the byte-string ``b'\\xef\\xbb\\xbf'``." msgstr "" -#: howto/logging-cookbook.rst:2292 +#: howto/logging-cookbook.rst:2404 msgid "" "Replace the ASCII section with whatever placeholders you like, but make sure " "that the data that appears in there after substitution is always ASCII (that " "way, it will remain unchanged after UTF-8 encoding)." msgstr "" -#: howto/logging-cookbook.rst:2296 +#: howto/logging-cookbook.rst:2408 msgid "" "Replace the Unicode section with whatever placeholders you like; if the data " "which appears there after substitution contains characters outside the ASCII " "range, that's fine -- it will be encoded using UTF-8." msgstr "" -#: howto/logging-cookbook.rst:2300 +#: howto/logging-cookbook.rst:2412 msgid "" "The formatted message *will* be encoded using UTF-8 encoding by " "``SysLogHandler``. If you follow the above rules, you should be able to " @@ -1222,11 +1212,11 @@ msgid "" "daemon may complain." msgstr "" -#: howto/logging-cookbook.rst:2307 +#: howto/logging-cookbook.rst:2419 msgid "Implementing structured logging" msgstr "" -#: howto/logging-cookbook.rst:2309 +#: howto/logging-cookbook.rst:2421 msgid "" "Although most logging messages are intended for reading by humans, and thus " "not readily machine-parseable, there might be circumstances where you want " @@ -1238,31 +1228,31 @@ msgid "" "machine-parseable manner::" msgstr "" -#: howto/logging-cookbook.rst:2333 +#: howto/logging-cookbook.rst:2445 msgid "If the above script is run, it prints:" msgstr "" -#: howto/logging-cookbook.rst:2339 howto/logging-cookbook.rst:2381 +#: howto/logging-cookbook.rst:2451 howto/logging-cookbook.rst:2493 msgid "" "Note that the order of items might be different according to the version of " "Python used." msgstr "" -#: howto/logging-cookbook.rst:2342 +#: howto/logging-cookbook.rst:2454 msgid "" "If you need more specialised processing, you can use a custom JSON encoder, " "as in the following complete example::" msgstr "" -#: howto/logging-cookbook.rst:2375 +#: howto/logging-cookbook.rst:2487 msgid "When the above script is run, it prints:" msgstr "" -#: howto/logging-cookbook.rst:2390 +#: howto/logging-cookbook.rst:2502 msgid "Customizing handlers with :func:`dictConfig`" msgstr "" -#: howto/logging-cookbook.rst:2392 +#: howto/logging-cookbook.rst:2504 msgid "" "There are times when you want to customize logging handlers in particular " "ways, and if you use :func:`dictConfig` you may be able to do this without " @@ -1272,24 +1262,24 @@ msgid "" "customize handler creation using a plain function such as::" msgstr "" -#: howto/logging-cookbook.rst:2406 +#: howto/logging-cookbook.rst:2518 msgid "" "You can then specify, in a logging configuration passed to :func:" "`dictConfig`, that a logging handler be created by calling this function::" msgstr "" -#: howto/logging-cookbook.rst:2439 +#: howto/logging-cookbook.rst:2551 msgid "" "In this example I am setting the ownership using the ``pulse`` user and " "group, just for the purposes of illustration. Putting it together into a " "working script, ``chowntest.py``::" msgstr "" -#: howto/logging-cookbook.rst:2486 +#: howto/logging-cookbook.rst:2598 msgid "To run this, you will probably need to run as ``root``:" msgstr "" -#: howto/logging-cookbook.rst:2496 +#: howto/logging-cookbook.rst:2608 msgid "" "Note that this example uses Python 3.3 because that's where :func:`shutil." "chown` makes an appearance. This approach should work with any Python " @@ -1298,17 +1288,17 @@ msgid "" "change using e.g. :func:`os.chown`." msgstr "" -#: howto/logging-cookbook.rst:2502 +#: howto/logging-cookbook.rst:2614 msgid "" "In practice, the handler-creating function may be in a utility module " "somewhere in your project. Instead of the line in the configuration::" msgstr "" -#: howto/logging-cookbook.rst:2507 +#: howto/logging-cookbook.rst:2619 msgid "you could use e.g.::" msgstr "" -#: howto/logging-cookbook.rst:2511 +#: howto/logging-cookbook.rst:2623 msgid "" "where ``project.util`` can be replaced with the actual name of the package " "where the function resides. In the above working script, using ``'ext://" @@ -1316,25 +1306,25 @@ msgid "" "resolved by :func:`dictConfig` from the ``ext://`` specification." msgstr "" -#: howto/logging-cookbook.rst:2516 +#: howto/logging-cookbook.rst:2628 msgid "" "This example hopefully also points the way to how you could implement other " "types of file change - e.g. setting specific POSIX permission bits - in the " "same way, using :func:`os.chmod`." msgstr "" -#: howto/logging-cookbook.rst:2520 +#: howto/logging-cookbook.rst:2632 msgid "" "Of course, the approach could also be extended to types of handler other " "than a :class:`~logging.FileHandler` - for example, one of the rotating file " "handlers, or a different type of handler altogether." msgstr "" -#: howto/logging-cookbook.rst:2530 +#: howto/logging-cookbook.rst:2642 msgid "Using particular formatting styles throughout your application" msgstr "" -#: howto/logging-cookbook.rst:2532 +#: howto/logging-cookbook.rst:2644 msgid "" "In Python 3.2, the :class:`~logging.Formatter` gained a ``style`` keyword " "parameter which, while defaulting to ``%`` for backward compatibility, " @@ -1345,7 +1335,7 @@ msgid "" "is constructed." msgstr "" -#: howto/logging-cookbook.rst:2539 +#: howto/logging-cookbook.rst:2651 msgid "" "Logging calls (:meth:`~Logger.debug`, :meth:`~Logger.info` etc.) only take " "positional parameters for the actual logging message itself, with keyword " @@ -1360,7 +1350,7 @@ msgid "" "calls which are out there in existing code will be using %-format strings." msgstr "" -#: howto/logging-cookbook.rst:2551 +#: howto/logging-cookbook.rst:2663 msgid "" "There have been suggestions to associate format styles with specific " "loggers, but that approach also runs into backward compatibility problems " @@ -1368,7 +1358,7 @@ msgid "" "formatting." msgstr "" -#: howto/logging-cookbook.rst:2555 +#: howto/logging-cookbook.rst:2667 msgid "" "For logging to work interoperably between any third-party libraries and your " "code, decisions about formatting need to be made at the level of the " @@ -1376,11 +1366,11 @@ msgid "" "formatting styles can be accommodated." msgstr "" -#: howto/logging-cookbook.rst:2562 +#: howto/logging-cookbook.rst:2674 msgid "Using LogRecord factories" msgstr "" -#: howto/logging-cookbook.rst:2564 +#: howto/logging-cookbook.rst:2676 msgid "" "In Python 3.2, along with the :class:`~logging.Formatter` changes mentioned " "above, the logging package gained the ability to allow users to set their " @@ -1395,17 +1385,17 @@ msgid "" "implementation does." msgstr "" -#: howto/logging-cookbook.rst:2575 +#: howto/logging-cookbook.rst:2687 msgid "" "Refer to the reference documentation on :func:`setLogRecordFactory` and :" "class:`LogRecord` for more information." msgstr "" -#: howto/logging-cookbook.rst:2580 +#: howto/logging-cookbook.rst:2692 msgid "Using custom message objects" msgstr "" -#: howto/logging-cookbook.rst:2582 +#: howto/logging-cookbook.rst:2694 msgid "" "There is another, perhaps simpler way that you can use {}- and $- formatting " "to construct your individual log messages. You may recall (from :ref:" @@ -1415,7 +1405,7 @@ msgid "" "following two classes::" msgstr "" -#: howto/logging-cookbook.rst:2607 +#: howto/logging-cookbook.rst:2719 msgid "" "Either of these can be used in place of a format string, to allow {}- or $-" "formatting to be used to build the actual \"message\" part which appears in " @@ -1426,17 +1416,17 @@ msgid "" "using ``_`` for localization)." msgstr "" -#: howto/logging-cookbook.rst:2615 +#: howto/logging-cookbook.rst:2727 msgid "" "Examples of this approach are given below. Firstly, formatting with :meth:" "`str.format`::" msgstr "" -#: howto/logging-cookbook.rst:2629 +#: howto/logging-cookbook.rst:2741 msgid "Secondly, formatting with :class:`string.Template`::" msgstr "" -#: howto/logging-cookbook.rst:2636 +#: howto/logging-cookbook.rst:2748 msgid "" "One thing to note is that you pay no significant performance penalty with " "this approach: the actual formatting happens not when you make the logging " @@ -1448,11 +1438,11 @@ msgid "" "shown above." msgstr "" -#: howto/logging-cookbook.rst:2650 +#: howto/logging-cookbook.rst:2762 msgid "Configuring filters with :func:`dictConfig`" msgstr "" -#: howto/logging-cookbook.rst:2652 +#: howto/logging-cookbook.rst:2764 msgid "" "You *can* configure filters using :func:`~logging.config.dictConfig`, though " "it might not be obvious at first glance how to do it (hence this recipe). " @@ -1467,22 +1457,22 @@ msgid "" "complete example::" msgstr "" -#: howto/logging-cookbook.rst:2705 +#: howto/logging-cookbook.rst:2817 msgid "" "This example shows how you can pass configuration data to the callable which " "constructs the instance, in the form of keyword parameters. When run, the " "above script will print:" msgstr "" -#: howto/logging-cookbook.rst:2713 +#: howto/logging-cookbook.rst:2825 msgid "which shows that the filter is working as configured." msgstr "" -#: howto/logging-cookbook.rst:2715 +#: howto/logging-cookbook.rst:2827 msgid "A couple of extra points to note:" msgstr "" -#: howto/logging-cookbook.rst:2717 +#: howto/logging-cookbook.rst:2829 msgid "" "If you can't refer to the callable directly in the configuration (e.g. if it " "lives in a different module, and you can't import it directly where the " @@ -1492,7 +1482,7 @@ msgid "" "the above example." msgstr "" -#: howto/logging-cookbook.rst:2724 +#: howto/logging-cookbook.rst:2836 msgid "" "As well as for filters, this technique can also be used to configure custom " "handlers and formatters. See :ref:`logging-config-dict-userdef` for more " @@ -1501,11 +1491,11 @@ msgid "" "above." msgstr "" -#: howto/logging-cookbook.rst:2733 +#: howto/logging-cookbook.rst:2845 msgid "Customized exception formatting" msgstr "" -#: howto/logging-cookbook.rst:2735 +#: howto/logging-cookbook.rst:2847 msgid "" "There might be times when you want to do customized exception formatting - " "for argument's sake, let's say you want exactly one line per logged event, " @@ -1513,22 +1503,22 @@ msgid "" "formatter class, as shown in the following example::" msgstr "" -#: howto/logging-cookbook.rst:2776 +#: howto/logging-cookbook.rst:2888 msgid "When run, this produces a file with exactly two lines:" msgstr "" -#: howto/logging-cookbook.rst:2783 +#: howto/logging-cookbook.rst:2895 msgid "" "While the above treatment is simplistic, it points the way to how exception " "information can be formatted to your liking. The :mod:`traceback` module may " "be helpful for more specialized needs." msgstr "" -#: howto/logging-cookbook.rst:2790 +#: howto/logging-cookbook.rst:2902 msgid "Speaking logging messages" msgstr "" -#: howto/logging-cookbook.rst:2792 +#: howto/logging-cookbook.rst:2904 msgid "" "There might be situations when it is desirable to have logging messages " "rendered in an audible rather than a visible format. This is easy to do if " @@ -1545,24 +1535,24 @@ msgid "" "approach, which assumes that the ``espeak`` TTS package is available::" msgstr "" -#: howto/logging-cookbook.rst:2834 +#: howto/logging-cookbook.rst:2946 msgid "" "When run, this script should say \"Hello\" and then \"Goodbye\" in a female " "voice." msgstr "" -#: howto/logging-cookbook.rst:2836 +#: howto/logging-cookbook.rst:2948 msgid "" "The above approach can, of course, be adapted to other TTS systems and even " "other systems altogether which can process messages via external programs " "run from a command line." msgstr "" -#: howto/logging-cookbook.rst:2844 +#: howto/logging-cookbook.rst:2956 msgid "Buffering logging messages and outputting them conditionally" msgstr "" -#: howto/logging-cookbook.rst:2846 +#: howto/logging-cookbook.rst:2958 msgid "" "There might be situations where you want to log messages in a temporary area " "and only output them if a certain condition occurs. For example, you may " @@ -1572,7 +1562,7 @@ msgid "" "debug information to be output as well as the error." msgstr "" -#: howto/logging-cookbook.rst:2853 +#: howto/logging-cookbook.rst:2965 msgid "" "Here is an example which shows how you could do this using a decorator for " "your functions where you want logging to behave this way. It makes use of " @@ -1585,7 +1575,7 @@ msgid "" "subclass of ``MemoryHandler`` if you want custom flushing behavior." msgstr "" -#: howto/logging-cookbook.rst:2863 +#: howto/logging-cookbook.rst:2975 msgid "" "The example script has a simple function, ``foo``, which just cycles through " "all the logging levels, writing to ``sys.stderr`` to say what level it's " @@ -1594,7 +1584,7 @@ msgid "" "levels - otherwise, it only logs at DEBUG, INFO and WARNING levels." msgstr "" -#: howto/logging-cookbook.rst:2869 +#: howto/logging-cookbook.rst:2981 msgid "" "The script just arranges to decorate ``foo`` with a decorator which will do " "the conditional logging that's required. The decorator takes a logger as a " @@ -1606,30 +1596,30 @@ msgid "" "respectively." msgstr "" -#: howto/logging-cookbook.rst:2877 +#: howto/logging-cookbook.rst:2989 msgid "Here's the script::" msgstr "" -#: howto/logging-cookbook.rst:2940 +#: howto/logging-cookbook.rst:3052 msgid "When this script is run, the following output should be observed:" msgstr "" -#: howto/logging-cookbook.rst:2970 +#: howto/logging-cookbook.rst:3082 msgid "" "As you can see, actual logging output only occurs when an event is logged " "whose severity is ERROR or greater, but in that case, any previous events at " "lower severities are also logged." msgstr "" -#: howto/logging-cookbook.rst:2974 +#: howto/logging-cookbook.rst:3086 msgid "You can of course use the conventional means of decoration::" msgstr "" -#: howto/logging-cookbook.rst:2984 +#: howto/logging-cookbook.rst:3096 msgid "Sending logging messages to email, with buffering" msgstr "" -#: howto/logging-cookbook.rst:2986 +#: howto/logging-cookbook.rst:3098 msgid "" "To illustrate how you can send log messages via email, so that a set number " "of messages are sent per email, you can subclass :class:`~logging.handlers." @@ -1640,7 +1630,7 @@ msgid "" "argument to see the required and optional arguments.)" msgstr "" -#: howto/logging-cookbook.rst:3058 +#: howto/logging-cookbook.rst:3170 msgid "" "If you run this script and your SMTP server is correctly set up, you should " "find that it sends eleven emails to the addressee you specify. The first ten " @@ -1648,17 +1638,17 @@ msgid "" "messages. That makes up 102 messages as specified in the script." msgstr "" -#: howto/logging-cookbook.rst:3066 +#: howto/logging-cookbook.rst:3178 msgid "Formatting times using UTC (GMT) via configuration" msgstr "" -#: howto/logging-cookbook.rst:3068 +#: howto/logging-cookbook.rst:3180 msgid "" "Sometimes you want to format times using UTC, which can be done using a " "class such as ``UTCFormatter``, shown below::" msgstr "" -#: howto/logging-cookbook.rst:3077 +#: howto/logging-cookbook.rst:3189 msgid "" "and you can then use the ``UTCFormatter`` in your code instead of :class:" "`~logging.Formatter`. If you want to do that via configuration, you can use " @@ -1666,21 +1656,21 @@ msgid "" "the following complete example::" msgstr "" -#: howto/logging-cookbook.rst:3120 +#: howto/logging-cookbook.rst:3232 msgid "When this script is run, it should print something like:" msgstr "" -#: howto/logging-cookbook.rst:3127 +#: howto/logging-cookbook.rst:3239 msgid "" "showing how the time is formatted both as local time and UTC, one for each " "handler." msgstr "" -#: howto/logging-cookbook.rst:3134 +#: howto/logging-cookbook.rst:3246 msgid "Using a context manager for selective logging" msgstr "" -#: howto/logging-cookbook.rst:3136 +#: howto/logging-cookbook.rst:3248 msgid "" "There are times when it would be useful to temporarily change the logging " "configuration and revert it back after doing something. For this, a context " @@ -1690,7 +1680,7 @@ msgid "" "scope of the context manager::" msgstr "" -#: howto/logging-cookbook.rst:3169 +#: howto/logging-cookbook.rst:3281 msgid "" "If you specify a level value, the logger's level is set to that value in the " "scope of the with block covered by the context manager. If you specify a " @@ -1699,13 +1689,13 @@ msgid "" "block exit - you could do this if you don't need the handler any more." msgstr "" -#: howto/logging-cookbook.rst:3175 +#: howto/logging-cookbook.rst:3287 msgid "" "To illustrate how it works, we can add the following block of code to the " "above::" msgstr "" -#: howto/logging-cookbook.rst:3193 +#: howto/logging-cookbook.rst:3305 msgid "" "We initially set the logger's level to ``INFO``, so message #1 appears and " "message #2 doesn't. We then change the level to ``DEBUG`` temporarily in the " @@ -1718,56 +1708,56 @@ msgid "" "(like message #1) whereas message #7 doesn't (just like message #2)." msgstr "" -#: howto/logging-cookbook.rst:3203 +#: howto/logging-cookbook.rst:3315 msgid "If we run the resulting script, the result is as follows:" msgstr "" -#: howto/logging-cookbook.rst:3214 +#: howto/logging-cookbook.rst:3326 msgid "" "If we run it again, but pipe ``stderr`` to ``/dev/null``, we see the " "following, which is the only message written to ``stdout``:" msgstr "" -#: howto/logging-cookbook.rst:3222 +#: howto/logging-cookbook.rst:3334 msgid "Once again, but piping ``stdout`` to ``/dev/null``, we get:" msgstr "" -#: howto/logging-cookbook.rst:3232 +#: howto/logging-cookbook.rst:3344 msgid "" "In this case, the message #5 printed to ``stdout`` doesn't appear, as " "expected." msgstr "" -#: howto/logging-cookbook.rst:3234 +#: howto/logging-cookbook.rst:3346 msgid "" "Of course, the approach described here can be generalised, for example to " "attach logging filters temporarily. Note that the above code works in Python " "2 as well as Python 3." msgstr "" -#: howto/logging-cookbook.rst:3242 +#: howto/logging-cookbook.rst:3354 msgid "A CLI application starter template" msgstr "" -#: howto/logging-cookbook.rst:3244 +#: howto/logging-cookbook.rst:3356 msgid "Here's an example which shows how you can:" msgstr "" -#: howto/logging-cookbook.rst:3246 +#: howto/logging-cookbook.rst:3358 msgid "Use a logging level based on command-line arguments" msgstr "" -#: howto/logging-cookbook.rst:3247 +#: howto/logging-cookbook.rst:3359 msgid "" "Dispatch to multiple subcommands in separate files, all logging at the same " "level in a consistent way" msgstr "" -#: howto/logging-cookbook.rst:3249 +#: howto/logging-cookbook.rst:3361 msgid "Make use of simple, minimal configuration" msgstr "" -#: howto/logging-cookbook.rst:3251 +#: howto/logging-cookbook.rst:3363 msgid "" "Suppose we have a command-line application whose job is to stop, start or " "restart some services. This could be organised for the purposes of " @@ -1778,53 +1768,53 @@ msgid "" "``logging.INFO``. Here's one way that ``app.py`` could be written::" msgstr "" -#: howto/logging-cookbook.rst:3300 +#: howto/logging-cookbook.rst:3412 msgid "" "And the ``start``, ``stop`` and ``restart`` commands can be implemented in " "separate modules, like so for starting::" msgstr "" -#: howto/logging-cookbook.rst:3313 +#: howto/logging-cookbook.rst:3425 msgid "and thus for stopping::" msgstr "" -#: howto/logging-cookbook.rst:3334 +#: howto/logging-cookbook.rst:3446 msgid "and similarly for restarting::" msgstr "" -#: howto/logging-cookbook.rst:3355 +#: howto/logging-cookbook.rst:3467 msgid "" "If we run this application with the default log level, we get output like " "this:" msgstr "" -#: howto/logging-cookbook.rst:3368 +#: howto/logging-cookbook.rst:3480 msgid "" "The first word is the logging level, and the second word is the module or " "package name of the place where the event was logged." msgstr "" -#: howto/logging-cookbook.rst:3371 +#: howto/logging-cookbook.rst:3483 msgid "" "If we change the logging level, then we can change the information sent to " "the log. For example, if we want more information:" msgstr "" -#: howto/logging-cookbook.rst:3388 +#: howto/logging-cookbook.rst:3500 msgid "And if we want less:" msgstr "" -#: howto/logging-cookbook.rst:3396 +#: howto/logging-cookbook.rst:3508 msgid "" "In this case, the commands don't print anything to the console, since " "nothing at ``WARNING`` level or above is logged by them." msgstr "" -#: howto/logging-cookbook.rst:3402 +#: howto/logging-cookbook.rst:3514 msgid "A Qt GUI for logging" msgstr "" -#: howto/logging-cookbook.rst:3404 +#: howto/logging-cookbook.rst:3516 msgid "" "A question that comes up from time to time is about how to log to a GUI " "application. The `Qt `_ framework is a popular cross-" @@ -1832,7 +1822,7 @@ msgid "" "project/PySide2/>`_ or `PyQt5 `_ libraries." msgstr "" -#: howto/logging-cookbook.rst:3410 +#: howto/logging-cookbook.rst:3522 msgid "" "The following example shows how to log to a Qt GUI. This introduces a simple " "``QtHandler`` class which takes a callable, which should be a slot in the " @@ -1842,26 +1832,26 @@ msgid "" "logging messages at random levels with random short delays in between)." msgstr "" -#: howto/logging-cookbook.rst:3417 +#: howto/logging-cookbook.rst:3529 msgid "" "The worker thread is implemented using Qt's ``QThread`` class rather than " "the :mod:`threading` module, as there are circumstances where one has to use " "``QThread``, which offers better integration with other ``Qt`` components." msgstr "" -#: howto/logging-cookbook.rst:3421 +#: howto/logging-cookbook.rst:3533 msgid "" -"The code should work with recent releases of either ``PySide2`` or " -"``PyQt5``. You should be able to adapt the approach to earlier versions of " -"Qt. Please refer to the comments in the code snippet for more detailed " -"information." +"The code should work with recent releases of any of ``PySide6``, ``PyQt6``, " +"``PySide2`` or ``PyQt5``. You should be able to adapt the approach to " +"earlier versions of Qt. Please refer to the comments in the code snippet for " +"more detailed information." msgstr "" -#: howto/logging-cookbook.rst:3635 +#: howto/logging-cookbook.rst:3770 msgid "Logging to syslog with RFC5424 support" msgstr "" -#: howto/logging-cookbook.rst:3637 +#: howto/logging-cookbook.rst:3772 msgid "" "Although :rfc:`5424` dates from 2009, most syslog servers are configured by " "default to use the older :rfc:`3164`, which hails from 2001. When " @@ -1871,14 +1861,14 @@ msgid "" "handlers.SysLogHandler` functionality has not been updated." msgstr "" -#: howto/logging-cookbook.rst:3644 +#: howto/logging-cookbook.rst:3779 msgid "" "RFC 5424 contains some useful features such as support for structured data, " "and if you need to be able to log to a syslog server with support for it, " "you can do so with a subclassed handler which looks something like this::" msgstr "" -#: howto/logging-cookbook.rst:3710 +#: howto/logging-cookbook.rst:3845 msgid "" "You'll need to be familiar with RFC 5424 to fully understand the above code, " "and it may be that you have slightly different needs (e.g. for how you pass " @@ -1887,11 +1877,11 @@ msgid "" "using something like this::" msgstr "" -#: howto/logging-cookbook.rst:3724 +#: howto/logging-cookbook.rst:3859 msgid "How to treat a logger like an output stream" msgstr "" -#: howto/logging-cookbook.rst:3726 +#: howto/logging-cookbook.rst:3861 msgid "" "Sometimes, you need to interface to a third-party API which expects a file-" "like object to write to, but you want to direct the API's output to a " @@ -1899,17 +1889,17 @@ msgid "" "API. Here's a short script illustrating such a class:" msgstr "" -#: howto/logging-cookbook.rst:3766 +#: howto/logging-cookbook.rst:3901 msgid "When this script is run, it prints" msgstr "" -#: howto/logging-cookbook.rst:3773 +#: howto/logging-cookbook.rst:3908 msgid "" "You could also use ``LoggerWriter`` to redirect ``sys.stdout`` and ``sys." "stderr`` by doing something like this:" msgstr "" -#: howto/logging-cookbook.rst:3783 +#: howto/logging-cookbook.rst:3918 msgid "" "You should do this *after* configuring logging for your needs. In the above " "example, the :func:`~logging.basicConfig` call does this (using the ``sys." @@ -1917,25 +1907,25 @@ msgid "" "Then, you'd get this kind of result:" msgstr "" -#: howto/logging-cookbook.rst:3796 +#: howto/logging-cookbook.rst:3931 msgid "" "Of course, the examples above show output according to the format used by :" "func:`~logging.basicConfig`, but you can use a different formatter when you " "configure logging." msgstr "" -#: howto/logging-cookbook.rst:3800 +#: howto/logging-cookbook.rst:3935 msgid "" "Note that with the above scheme, you are somewhat at the mercy of buffering " "and the sequence of write calls which you are intercepting. For example, " "with the definition of ``LoggerWriter`` above, if you have the snippet" msgstr "" -#: howto/logging-cookbook.rst:3809 +#: howto/logging-cookbook.rst:3944 msgid "then running the script results in" msgstr "" -#: howto/logging-cookbook.rst:3827 +#: howto/logging-cookbook.rst:3962 msgid "" "As you can see, this output isn't ideal. That's because the underlying code " "which writes to ``sys.stderr`` makes multiple writes, each of which results " @@ -1945,17 +1935,17 @@ msgid "" "``LoggerWriter``:" msgstr "" -#: howto/logging-cookbook.rst:3852 +#: howto/logging-cookbook.rst:3987 msgid "" "This just buffers up stuff until a newline is seen, and then logs complete " "lines. With this approach, you get better output:" msgstr "" -#: howto/logging-cookbook.rst:3868 +#: howto/logging-cookbook.rst:4003 msgid "Patterns to avoid" msgstr "" -#: howto/logging-cookbook.rst:3870 +#: howto/logging-cookbook.rst:4005 msgid "" "Although the preceding sections have described ways of doing things you " "might need to do or deal with, it is worth mentioning some usage patterns " @@ -1963,11 +1953,11 @@ msgid "" "The following sections are in no particular order." msgstr "" -#: howto/logging-cookbook.rst:3876 +#: howto/logging-cookbook.rst:4011 msgid "Opening the same log file multiple times" msgstr "" -#: howto/logging-cookbook.rst:3878 +#: howto/logging-cookbook.rst:4013 msgid "" "On Windows, you will generally not be able to open the same file multiple " "times as this will lead to a \"file is in use by another process\" error. " @@ -1975,32 +1965,32 @@ msgid "" "file multiple times. This could be done accidentally, for example by:" msgstr "" -#: howto/logging-cookbook.rst:3883 +#: howto/logging-cookbook.rst:4018 msgid "" "Adding a file handler more than once which references the same file (e.g. by " "a copy/paste/forget-to-change error)." msgstr "" -#: howto/logging-cookbook.rst:3886 +#: howto/logging-cookbook.rst:4021 msgid "" "Opening two files that look different, as they have different names, but are " "the same because one is a symbolic link to the other." msgstr "" -#: howto/logging-cookbook.rst:3889 +#: howto/logging-cookbook.rst:4024 msgid "" "Forking a process, following which both parent and child have a reference to " "the same file. This might be through use of the :mod:`multiprocessing` " "module, for example." msgstr "" -#: howto/logging-cookbook.rst:3893 +#: howto/logging-cookbook.rst:4028 msgid "" "Opening a file multiple times might *appear* to work most of the time, but " "can lead to a number of problems in practice:" msgstr "" -#: howto/logging-cookbook.rst:3896 +#: howto/logging-cookbook.rst:4031 msgid "" "Logging output can be garbled because multiple threads or processes try to " "write to the same file. Although logging guards against concurrent use of " @@ -2009,7 +1999,7 @@ msgid "" "different handler instances which happen to point to the same file." msgstr "" -#: howto/logging-cookbook.rst:3902 +#: howto/logging-cookbook.rst:4037 msgid "" "An attempt to delete a file (e.g. during file rotation) silently fails, " "because there is another reference pointing to it. This can lead to " @@ -2019,17 +2009,17 @@ msgid "" "being supposedly in place." msgstr "" -#: howto/logging-cookbook.rst:3909 +#: howto/logging-cookbook.rst:4044 msgid "" "Use the techniques outlined in :ref:`multiple-processes` to circumvent such " "issues." msgstr "" -#: howto/logging-cookbook.rst:3913 +#: howto/logging-cookbook.rst:4048 msgid "Using loggers as attributes in a class or passing them as parameters" msgstr "" -#: howto/logging-cookbook.rst:3915 +#: howto/logging-cookbook.rst:4050 msgid "" "While there might be unusual cases where you'll need to do this, in general " "there is no point because loggers are singletons. Code can always access a " @@ -2040,13 +2030,13 @@ msgid "" "module (and not the class) is the unit of software decomposition." msgstr "" -#: howto/logging-cookbook.rst:3924 +#: howto/logging-cookbook.rst:4059 msgid "" "Adding handlers other than :class:`~logging.NullHandler` to a logger in a " "library" msgstr "" -#: howto/logging-cookbook.rst:3926 +#: howto/logging-cookbook.rst:4061 msgid "" "Configuring logging by adding handlers, formatters and filters is the " "responsibility of the application developer, not the library developer. If " @@ -2054,11 +2044,11 @@ msgid "" "your loggers other than a :class:`~logging.NullHandler` instance." msgstr "" -#: howto/logging-cookbook.rst:3932 +#: howto/logging-cookbook.rst:4067 msgid "Creating a lot of loggers" msgstr "" -#: howto/logging-cookbook.rst:3934 +#: howto/logging-cookbook.rst:4069 msgid "" "Loggers are singletons that are never freed during a script execution, and " "so creating lots of loggers will use up memory which can't then be freed. " @@ -2069,14 +2059,38 @@ msgid "" "occasionally slightly more fine-grained than that)." msgstr "" -#: howto/logging-cookbook.rst:3945 +#: howto/logging-cookbook.rst:4080 msgid "Other resources" msgstr "" -#: howto/logging-cookbook.rst:3958 +#: howto/logging-cookbook.rst:4085 +msgid "Module :mod:`logging`" +msgstr "" + +#: howto/logging-cookbook.rst:4085 +msgid "API reference for the logging module." +msgstr "" + +#: howto/logging-cookbook.rst:4088 +msgid "Module :mod:`logging.config`" +msgstr "" + +#: howto/logging-cookbook.rst:4088 +msgid "Configuration API for the logging module." +msgstr "" + +#: howto/logging-cookbook.rst:4091 +msgid "Module :mod:`logging.handlers`" +msgstr "" + +#: howto/logging-cookbook.rst:4091 +msgid "Useful handlers included with the logging module." +msgstr "" + +#: howto/logging-cookbook.rst:4093 msgid ":ref:`Basic Tutorial `" msgstr "" -#: howto/logging-cookbook.rst:3960 +#: howto/logging-cookbook.rst:4095 msgid ":ref:`Advanced Tutorial `" msgstr "" diff --git a/howto/logging.po b/howto/logging.po index e5a53ed2d..f35d806ce 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-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -55,181 +55,195 @@ msgstr "" #: howto/logging.rst:28 msgid "" -"Logging provides a set of convenience functions for simple logging usage. " -"These are :func:`debug`, :func:`info`, :func:`warning`, :func:`error` and :" -"func:`critical`. To determine when to use logging, see the table below, " -"which states, for each of a set of common tasks, the best tool to use for it." +"You can access logging functionality by creating a logger via ``logger = " +"getLogger(__name__)``, and then calling the logger's :meth:`~Logger.debug`, :" +"meth:`~Logger.info`, :meth:`~Logger.warning`, :meth:`~Logger.error` and :" +"meth:`~Logger.critical` methods. To determine when to use logging, and to " +"see which logger methods to use when, see the table below. It states, for " +"each of a set of common tasks, the best tool to use for that task." msgstr "" -#: howto/logging.rst:34 +#: howto/logging.rst:36 msgid "Task you want to perform" msgstr "" -#: howto/logging.rst:34 +#: howto/logging.rst:36 msgid "The best tool for the task" msgstr "" -#: howto/logging.rst:36 +#: howto/logging.rst:38 msgid "" "Display console output for ordinary usage of a command line script or program" msgstr "" -#: howto/logging.rst:36 +#: howto/logging.rst:38 msgid ":func:`print`" msgstr "" -#: howto/logging.rst:40 +#: howto/logging.rst:42 msgid "" "Report events that occur during normal operation of a program (e.g. for " "status monitoring or fault investigation)" msgstr "" -#: howto/logging.rst:40 +#: howto/logging.rst:42 msgid "" -":func:`logging.info` (or :func:`logging.debug` for very detailed output for " -"diagnostic purposes)" +"A logger's :meth:`~Logger.info` (or :meth:`~Logger.debug` method for very " +"detailed output for diagnostic purposes)" msgstr "" -#: howto/logging.rst:45 +#: howto/logging.rst:47 msgid "Issue a warning regarding a particular runtime event" msgstr "" -#: howto/logging.rst:45 +#: howto/logging.rst:47 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:50 +#: howto/logging.rst:52 msgid "" -":func:`logging.warning` if there is nothing the client application can do " -"about the situation, but the event should still be noted" +"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:55 +#: howto/logging.rst:58 msgid "Report an error regarding a particular runtime event" msgstr "" -#: howto/logging.rst:55 +#: howto/logging.rst:58 msgid "Raise an exception" msgstr "" -#: howto/logging.rst:58 +#: howto/logging.rst:61 msgid "" "Report suppression of an error without raising an exception (e.g. error " "handler in a long-running server process)" msgstr "" -#: howto/logging.rst:58 +#: howto/logging.rst:61 msgid "" -":func:`logging.error`, :func:`logging.exception` or :func:`logging.critical` " -"as appropriate for the specific error and application domain" +"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:65 +#: howto/logging.rst:68 msgid "" -"The logging functions 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):" +"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:866 +#: howto/logging.rst:830 msgid "Level" msgstr "" -#: howto/logging.rst:72 +#: howto/logging.rst:75 msgid "When it's used" msgstr "" -#: howto/logging.rst:876 +#: howto/logging.rst:840 msgid "``DEBUG``" msgstr "" -#: howto/logging.rst:74 +#: howto/logging.rst:77 msgid "" "Detailed information, typically of interest only when diagnosing problems." msgstr "" -#: howto/logging.rst:874 +#: howto/logging.rst:838 msgid "``INFO``" msgstr "" -#: howto/logging.rst:77 +#: howto/logging.rst:80 msgid "Confirmation that things are working as expected." msgstr "" -#: howto/logging.rst:872 +#: howto/logging.rst:836 msgid "``WARNING``" msgstr "" -#: howto/logging.rst:80 +#: howto/logging.rst:83 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:870 +#: howto/logging.rst:834 msgid "``ERROR``" msgstr "" -#: howto/logging.rst:85 +#: howto/logging.rst:88 msgid "" "Due to a more serious problem, the software has not been able to perform " "some function." msgstr "" -#: howto/logging.rst:868 +#: howto/logging.rst:832 msgid "``CRITICAL``" msgstr "" -#: howto/logging.rst:88 +#: howto/logging.rst:91 msgid "" "A serious error, indicating that the program itself may be unable to " "continue running." msgstr "" -#: howto/logging.rst:92 +#: howto/logging.rst:95 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:96 +#: howto/logging.rst:99 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:104 +#: howto/logging.rst:107 msgid "A simple example" msgstr "" -#: howto/logging.rst:106 +#: howto/logging.rst:109 msgid "A very simple example is::" msgstr "" -#: howto/logging.rst:112 +#: howto/logging.rst:115 msgid "If you type these lines into a script and run it, you'll see:" msgstr "" -#: howto/logging.rst:118 +#: howto/logging.rst:121 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 " "the level and the description of the event provided in the logging call, i." -"e. 'Watch out!'. Don't worry about the 'root' part for now: it will be " -"explained later. The actual output can be formatted quite flexibly if you " +"e. 'Watch out!'. The actual output can be formatted quite flexibly if you " "need that; formatting options will also be explained later." msgstr "" #: howto/logging.rst:127 +msgid "" +"Notice that in this example, we use functions directly on the ``logging`` " +"module, like ``logging.debug``, rather than creating a logger and calling " +"functions on it. These functions operation on the root logger, but can be " +"useful as they will call :func:`~logging.basicConfig` for you if it has not " +"been called yet, like in this example. In larger programs you'll usually " +"want to control the logging configuration explicitly however - so for that " +"reason as well as others, it's better to create loggers and call their " +"methods." +msgstr "" + +#: howto/logging.rst:136 msgid "Logging to a file" msgstr "" -#: howto/logging.rst:129 +#: howto/logging.rst:138 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 " @@ -237,7 +251,7 @@ msgid "" "above::" msgstr "" -#: howto/logging.rst:140 +#: howto/logging.rst:150 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`. " @@ -246,47 +260,45 @@ msgid "" "values and the default, see the documentation for :func:`open`." msgstr "" -#: howto/logging.rst:147 +#: howto/logging.rst:157 msgid "" "And now if we open the file and look at what we have, we should find the log " "messages:" msgstr "" -#: howto/logging.rst:157 +#: howto/logging.rst:167 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:161 +#: howto/logging.rst:171 msgid "" "If you want to set the logging level from a command-line option such as:" msgstr "" -#: howto/logging.rst:167 +#: howto/logging.rst:177 msgid "" "and you have the value of the parameter passed for ``--log`` in some " "variable *loglevel*, you can use::" msgstr "" -#: howto/logging.rst:172 +#: howto/logging.rst:182 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:184 +#: howto/logging.rst:194 msgid "" -"The call to :func:`basicConfig` should come *before* any calls to :func:" -"`debug`, :func:`info`, etc. Otherwise, those functions will call :func:" -"`basicConfig` for you with the default options. As it's intended as a one-" -"off simple configuration facility, only the first call will actually do " -"anything: subsequent calls are effectively no-ops." +"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:190 +#: howto/logging.rst:198 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 " @@ -294,52 +306,27 @@ msgid "" "*filemode* argument, by changing the call in the above example to::" msgstr "" -#: howto/logging.rst:197 +#: howto/logging.rst:205 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:202 -msgid "Logging from multiple modules" -msgstr "" - -#: howto/logging.rst:204 -msgid "" -"If your program consists of multiple modules, here's an example of how you " -"could organize logging in it::" -msgstr "" - -#: howto/logging.rst:228 -msgid "If you run *myapp.py*, you should see this in *myapp.log*:" -msgstr "" - -#: howto/logging.rst:236 -msgid "" -"which is hopefully what you were expecting to see. You can generalize this " -"to multiple modules, using the pattern in *mylib.py*. Note that for this " -"simple usage pattern, you won't know, by looking in the log file, *where* in " -"your application your messages came from, apart from looking at the event " -"description. If you want to track the location of your messages, you'll need " -"to refer to the documentation beyond the tutorial level -- see :ref:`logging-" -"advanced-tutorial`." -msgstr "" - -#: howto/logging.rst:246 +#: howto/logging.rst:210 msgid "Logging variable data" msgstr "" -#: howto/logging.rst:248 +#: howto/logging.rst:212 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:254 +#: howto/logging.rst:218 msgid "will display:" msgstr "" -#: howto/logging.rst:260 +#: howto/logging.rst:224 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 " @@ -349,21 +336,21 @@ msgid "" "tutorial: see :ref:`formatting-styles` for more information." msgstr "" -#: howto/logging.rst:269 +#: howto/logging.rst:233 msgid "Changing the format of displayed messages" msgstr "" -#: howto/logging.rst:271 +#: howto/logging.rst:235 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:280 +#: howto/logging.rst:244 msgid "which would print:" msgstr "" -#: howto/logging.rst:288 +#: howto/logging.rst:252 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 " @@ -373,42 +360,42 @@ msgid "" "This is described in the next section." msgstr "" -#: howto/logging.rst:297 +#: howto/logging.rst:261 msgid "Displaying the date/time in messages" msgstr "" -#: howto/logging.rst:299 +#: howto/logging.rst:263 msgid "" "To display the date and time of an event, you would place '%(asctime)s' in " "your format string::" msgstr "" -#: howto/logging.rst:306 +#: howto/logging.rst:270 msgid "which should print something like this:" msgstr "" -#: howto/logging.rst:312 +#: howto/logging.rst:276 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:320 +#: howto/logging.rst:284 msgid "which would display something like this:" msgstr "" -#: howto/logging.rst:326 +#: howto/logging.rst:290 msgid "" "The format of the *datefmt* argument is the same as supported by :func:`time." "strftime`." msgstr "" -#: howto/logging.rst:331 +#: howto/logging.rst:295 msgid "Next Steps" msgstr "" -#: howto/logging.rst:333 +#: howto/logging.rst:297 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, " @@ -417,7 +404,7 @@ msgid "" "of your favourite beverage and carry on." msgstr "" -#: howto/logging.rst:339 +#: howto/logging.rst:303 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 " @@ -426,50 +413,50 @@ msgid "" "should receive help before too long." msgstr "" -#: howto/logging.rst:345 +#: howto/logging.rst:309 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:353 +#: howto/logging.rst:317 msgid "Advanced Logging Tutorial" msgstr "" -#: howto/logging.rst:355 +#: howto/logging.rst:319 msgid "" "The logging library takes a modular approach and offers several categories " "of components: loggers, handlers, filters, and formatters." msgstr "" -#: howto/logging.rst:358 +#: howto/logging.rst:322 msgid "Loggers expose the interface that application code directly uses." msgstr "" -#: howto/logging.rst:359 +#: howto/logging.rst:323 msgid "" "Handlers send the log records (created by loggers) to the appropriate " "destination." msgstr "" -#: howto/logging.rst:361 +#: howto/logging.rst:325 msgid "" "Filters provide a finer grained facility for determining which log records " "to output." msgstr "" -#: howto/logging.rst:363 +#: howto/logging.rst:327 msgid "Formatters specify the layout of log records in the final output." msgstr "" -#: howto/logging.rst:365 +#: howto/logging.rst:329 msgid "" "Log event information is passed between loggers, handlers, filters and " "formatters in a :class:`LogRecord` instance." msgstr "" -#: howto/logging.rst:368 +#: howto/logging.rst:332 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 " @@ -480,19 +467,19 @@ msgid "" "originates." msgstr "" -#: howto/logging.rst:375 +#: howto/logging.rst:339 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:380 +#: howto/logging.rst:344 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:383 +#: howto/logging.rst:347 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`, :" @@ -501,7 +488,7 @@ msgid "" "root logger's name is printed as 'root' in the logged output." msgstr "" -#: howto/logging.rst:389 +#: howto/logging.rst:353 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 " @@ -512,7 +499,7 @@ msgid "" "built-in handler classes." msgstr "" -#: howto/logging.rst:396 +#: howto/logging.rst:360 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 " @@ -524,32 +511,32 @@ msgid "" "message output." msgstr "" -#: howto/logging.rst:404 +#: howto/logging.rst:368 msgid "The default format set by :func:`basicConfig` for messages is:" msgstr "" -#: howto/logging.rst:410 +#: howto/logging.rst:374 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:415 +#: howto/logging.rst:379 msgid "Logging Flow" msgstr "" -#: howto/logging.rst:417 +#: howto/logging.rst:381 msgid "" "The flow of log event information in loggers and handlers is illustrated in " "the following diagram." msgstr "" -#: howto/logging.rst:424 +#: howto/logging.rst:388 msgid "Loggers" msgstr "" -#: howto/logging.rst:426 +#: howto/logging.rst:390 msgid "" ":class:`Logger` objects have a threefold job. First, they expose several " "methods to application code so that applications can log messages at " @@ -559,17 +546,17 @@ msgid "" "handlers." msgstr "" -#: howto/logging.rst:432 +#: howto/logging.rst:396 msgid "" "The most widely used methods on logger objects fall into two categories: " "configuration and message sending." msgstr "" -#: howto/logging.rst:435 +#: howto/logging.rst:399 msgid "These are the most common configuration methods:" msgstr "" -#: howto/logging.rst:437 +#: howto/logging.rst:401 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 " @@ -578,32 +565,32 @@ msgid "" "messages and will ignore DEBUG messages." msgstr "" -#: howto/logging.rst:443 +#: howto/logging.rst:407 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:447 +#: howto/logging.rst:411 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:451 +#: howto/logging.rst:415 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:454 +#: howto/logging.rst:418 msgid "" "With the logger object configured, the following methods create log messages:" msgstr "" -#: howto/logging.rst:456 +#: howto/logging.rst:420 msgid "" ":meth:`Logger.debug`, :meth:`Logger.info`, :meth:`Logger.warning`, :meth:" "`Logger.error`, and :meth:`Logger.critical` all create log records with a " @@ -616,14 +603,14 @@ msgid "" "exception information." msgstr "" -#: howto/logging.rst:466 +#: howto/logging.rst:430 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:470 +#: howto/logging.rst:434 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 " @@ -631,7 +618,7 @@ msgid "" "levels." msgstr "" -#: howto/logging.rst:474 +#: howto/logging.rst:438 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-" @@ -643,7 +630,7 @@ msgid "" "descendants of ``foo``." msgstr "" -#: howto/logging.rst:482 +#: howto/logging.rst:446 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 " @@ -655,7 +642,7 @@ msgid "" "handlers." msgstr "" -#: howto/logging.rst:490 +#: howto/logging.rst:454 msgid "" "Child loggers propagate messages up to the handlers associated with their " "ancestor loggers. Because of this, it is unnecessary to define and configure " @@ -665,11 +652,11 @@ msgid "" "attribute of a logger to ``False``.)" msgstr "" -#: howto/logging.rst:501 +#: howto/logging.rst:465 msgid "Handlers" msgstr "" -#: howto/logging.rst:503 +#: howto/logging.rst:467 msgid "" ":class:`~logging.Handler` objects are responsible for dispatching the " "appropriate log messages (based on the log messages' severity) to the " @@ -682,14 +669,14 @@ msgid "" "of a specific severity to a specific location." msgstr "" -#: howto/logging.rst:513 +#: howto/logging.rst:477 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:517 +#: howto/logging.rst:481 msgid "" "There are very few methods in a handler for application developers to " "concern themselves with. The only handler methods that seem relevant for " @@ -697,7 +684,7 @@ msgid "" "not creating custom handlers) are the following configuration methods:" msgstr "" -#: howto/logging.rst:522 +#: howto/logging.rst:486 msgid "" "The :meth:`~Handler.setLevel` method, just as in logger objects, specifies " "the lowest severity that will be dispatched to the appropriate destination. " @@ -707,19 +694,19 @@ msgid "" "send on." msgstr "" -#: howto/logging.rst:528 +#: howto/logging.rst:492 msgid "" ":meth:`~Handler.setFormatter` selects a Formatter object for this handler to " "use." msgstr "" -#: howto/logging.rst:531 +#: howto/logging.rst:495 msgid "" ":meth:`~Handler.addFilter` and :meth:`~Handler.removeFilter` respectively " "configure and deconfigure filter objects on handlers." msgstr "" -#: howto/logging.rst:534 +#: howto/logging.rst:498 msgid "" "Application code should not directly instantiate and use instances of :class:" "`Handler`. Instead, the :class:`Handler` class is a base class that defines " @@ -727,11 +714,11 @@ msgid "" "behavior that child classes can use (or override)." msgstr "" -#: howto/logging.rst:541 +#: howto/logging.rst:505 msgid "Formatters" msgstr "" -#: howto/logging.rst:543 +#: howto/logging.rst:507 msgid "" "Formatter objects configure the final order, structure, and contents of the " "log message. Unlike the base :class:`logging.Handler` class, application " @@ -741,20 +728,20 @@ msgid "" "string and a style indicator." msgstr "" -#: howto/logging.rst:552 +#: howto/logging.rst:516 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:559 +#: howto/logging.rst:523 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:562 +#: howto/logging.rst:526 msgid "" "If the ``style`` is ``'%'``, the message format string uses ``%()s`` styled string substitution; the possible keys are documented in :" @@ -764,18 +751,18 @@ msgid "" "should conform to what is expected by :meth:`string.Template.substitute`." msgstr "" -#: howto/logging.rst:569 +#: howto/logging.rst:533 msgid "Added the ``style`` parameter." msgstr "" -#: howto/logging.rst:572 +#: howto/logging.rst:536 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:578 +#: howto/logging.rst:542 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 " @@ -786,68 +773,68 @@ msgid "" "in the Formatter class (to ``time.gmtime`` for GMT display)." msgstr "" -#: howto/logging.rst:588 +#: howto/logging.rst:552 msgid "Configuring Logging" msgstr "" -#: howto/logging.rst:592 +#: howto/logging.rst:556 msgid "Programmers can configure logging in three ways:" msgstr "" -#: howto/logging.rst:594 +#: howto/logging.rst:558 msgid "" "Creating loggers, handlers, and formatters explicitly using Python code that " "calls the configuration methods listed above." msgstr "" -#: howto/logging.rst:596 +#: howto/logging.rst:560 msgid "" "Creating a logging config file and reading it using the :func:`fileConfig` " "function." msgstr "" -#: howto/logging.rst:598 +#: howto/logging.rst:562 msgid "" "Creating a dictionary of configuration information and passing it to the :" "func:`dictConfig` function." msgstr "" -#: howto/logging.rst:601 +#: howto/logging.rst:565 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:631 +#: howto/logging.rst:595 msgid "" "Running this module from the command line produces the following output:" msgstr "" -#: howto/logging.rst:642 +#: howto/logging.rst:606 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:661 +#: howto/logging.rst:625 msgid "Here is the logging.conf file:" msgstr "" -#: howto/logging.rst:693 +#: howto/logging.rst:657 msgid "" "The output is nearly identical to that of the non-config-file-based example:" msgstr "" -#: howto/logging.rst:704 +#: howto/logging.rst:668 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:708 +#: howto/logging.rst:672 msgid "" "The :func:`fileConfig` function takes a default parameter, " "``disable_existing_loggers``, which defaults to ``True`` for reasons of " @@ -858,7 +845,7 @@ msgid "" "information, and specify ``False`` for this parameter if you wish." msgstr "" -#: howto/logging.rst:716 +#: howto/logging.rst:680 msgid "" "The dictionary passed to :func:`dictConfig` can also specify a Boolean value " "with key ``disable_existing_loggers``, which if not specified explicitly in " @@ -867,7 +854,7 @@ msgid "" "want - in which case, provide the key explicitly with a value of ``False``." msgstr "" -#: howto/logging.rst:726 +#: howto/logging.rst:690 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 " @@ -878,7 +865,7 @@ msgid "" "path)." msgstr "" -#: howto/logging.rst:734 +#: howto/logging.rst:698 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 " @@ -893,30 +880,30 @@ msgid "" "a socket, or use whatever approach makes sense for your application." msgstr "" -#: howto/logging.rst:746 +#: howto/logging.rst:710 msgid "" "Here's an example of the same configuration as above, in YAML format for the " "new dictionary-based approach:" msgstr "" -#: howto/logging.rst:770 +#: howto/logging.rst:734 msgid "" "For more information about logging using a dictionary, see :ref:`logging-" "config-api`." msgstr "" -#: howto/logging.rst:774 +#: howto/logging.rst:738 msgid "What happens if no configuration is provided" msgstr "" -#: howto/logging.rst:776 +#: howto/logging.rst:740 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:780 +#: howto/logging.rst:744 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 " @@ -928,32 +915,32 @@ msgid "" "severities will be output." msgstr "" -#: howto/logging.rst:791 +#: howto/logging.rst:755 msgid "For versions of Python prior to 3.2, the behaviour is as follows:" msgstr "" -#: howto/logging.rst:793 +#: howto/logging.rst:757 msgid "" "If :data:`raiseExceptions` is ``False`` (production mode), the event is " "silently dropped." msgstr "" -#: howto/logging.rst:796 +#: howto/logging.rst:760 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:799 +#: howto/logging.rst:763 msgid "" "To obtain the pre-3.2 behaviour, :data:`lastResort` can be set to ``None``." msgstr "" -#: howto/logging.rst:805 +#: howto/logging.rst:769 msgid "Configuring Logging for a Library" msgstr "" -#: howto/logging.rst:807 +#: howto/logging.rst:771 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 " @@ -964,7 +951,7 @@ msgid "" "is regarded as the best default behaviour." msgstr "" -#: howto/logging.rst:815 +#: howto/logging.rst:779 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-" @@ -976,7 +963,7 @@ msgid "" "to those handlers, as normal." msgstr "" -#: howto/logging.rst:824 +#: howto/logging.rst:788 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 " @@ -987,14 +974,14 @@ msgid "" "etc. then the code::" msgstr "" -#: howto/logging.rst:835 +#: howto/logging.rst:799 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:839 +#: howto/logging.rst:803 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, " @@ -1004,7 +991,7 @@ msgid "" "library as they wish." msgstr "" -#: howto/logging.rst:846 +#: howto/logging.rst:810 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 " @@ -1015,11 +1002,11 @@ msgid "" "carry out unit tests and deliver logs which suit their requirements." msgstr "" -#: howto/logging.rst:857 +#: howto/logging.rst:821 msgid "Logging Levels" msgstr "" -#: howto/logging.rst:859 +#: howto/logging.rst:823 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 " @@ -1028,39 +1015,39 @@ msgid "" "value; the predefined name is lost." msgstr "" -#: howto/logging.rst:866 +#: howto/logging.rst:830 msgid "Numeric value" msgstr "" -#: howto/logging.rst:868 +#: howto/logging.rst:832 msgid "50" msgstr "" -#: howto/logging.rst:870 +#: howto/logging.rst:834 msgid "40" msgstr "" -#: howto/logging.rst:872 +#: howto/logging.rst:836 msgid "30" msgstr "" -#: howto/logging.rst:874 +#: howto/logging.rst:838 msgid "20" msgstr "" -#: howto/logging.rst:876 +#: howto/logging.rst:840 msgid "10" msgstr "" -#: howto/logging.rst:878 +#: howto/logging.rst:842 msgid "``NOTSET``" msgstr "" -#: howto/logging.rst:878 +#: howto/logging.rst:842 msgid "0" msgstr "" -#: howto/logging.rst:881 +#: howto/logging.rst:845 msgid "" "Levels can also be associated with loggers, being set either by the " "developer or through loading a saved logging configuration. When a logging " @@ -1070,14 +1057,14 @@ msgid "" "basic mechanism controlling the verbosity of logging output." msgstr "" -#: howto/logging.rst:888 +#: howto/logging.rst:852 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:892 +#: howto/logging.rst:856 msgid "" "Logging messages are subjected to a dispatch mechanism through the use of :" "dfn:`handlers`, which are instances of subclasses of the :class:`Handler` " @@ -1094,7 +1081,7 @@ msgid "" "at which point the passing to ancestor handlers stops)." msgstr "" -#: howto/logging.rst:906 +#: howto/logging.rst:870 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. " @@ -1104,11 +1091,11 @@ msgid "" "`~Handler.emit`." msgstr "" -#: howto/logging.rst:915 +#: howto/logging.rst:879 msgid "Custom Levels" msgstr "" -#: howto/logging.rst:917 +#: howto/logging.rst:881 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. " @@ -1121,27 +1108,27 @@ msgid "" "given numeric value might mean different things for different libraries." msgstr "" -#: howto/logging.rst:930 +#: howto/logging.rst:894 msgid "Useful Handlers" msgstr "" -#: howto/logging.rst:932 +#: howto/logging.rst:896 msgid "" "In addition to the base :class:`Handler` class, many useful subclasses are " "provided:" msgstr "" -#: howto/logging.rst:935 +#: howto/logging.rst:899 msgid "" ":class:`StreamHandler` instances send messages to streams (file-like " "objects)." msgstr "" -#: howto/logging.rst:938 +#: howto/logging.rst:902 msgid ":class:`FileHandler` instances send messages to disk files." msgstr "" -#: howto/logging.rst:940 +#: howto/logging.rst:904 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 " @@ -1149,61 +1136,61 @@ msgid "" "`~handlers.TimedRotatingFileHandler`." msgstr "" -#: howto/logging.rst:945 +#: howto/logging.rst:909 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:948 +#: howto/logging.rst:912 msgid "" ":class:`~handlers.TimedRotatingFileHandler` instances send messages to disk " "files, rotating the log file at certain timed intervals." msgstr "" -#: howto/logging.rst:951 +#: howto/logging.rst:915 msgid "" ":class:`~handlers.SocketHandler` instances send messages to TCP/IP sockets. " "Since 3.4, Unix domain sockets are also supported." msgstr "" -#: howto/logging.rst:954 +#: howto/logging.rst:918 msgid "" ":class:`~handlers.DatagramHandler` instances send messages to UDP sockets. " "Since 3.4, Unix domain sockets are also supported." msgstr "" -#: howto/logging.rst:957 +#: howto/logging.rst:921 msgid "" ":class:`~handlers.SMTPHandler` instances send messages to a designated email " "address." msgstr "" -#: howto/logging.rst:960 +#: howto/logging.rst:924 msgid "" ":class:`~handlers.SysLogHandler` instances send messages to a Unix syslog " "daemon, possibly on a remote machine." msgstr "" -#: howto/logging.rst:963 +#: howto/logging.rst:927 msgid "" ":class:`~handlers.NTEventLogHandler` instances send messages to a Windows " "NT/2000/XP event log." msgstr "" -#: howto/logging.rst:966 +#: howto/logging.rst:930 msgid "" ":class:`~handlers.MemoryHandler` instances send messages to a buffer in " "memory, which is flushed whenever specific criteria are met." msgstr "" -#: howto/logging.rst:969 +#: howto/logging.rst:933 msgid "" ":class:`~handlers.HTTPHandler` instances send messages to an HTTP server " "using either ``GET`` or ``POST`` semantics." msgstr "" -#: howto/logging.rst:972 +#: howto/logging.rst:936 msgid "" ":class:`~handlers.WatchedFileHandler` instances watch the file they are " "logging to. If the file changes, it is closed and reopened using the file " @@ -1211,13 +1198,13 @@ msgid "" "support the underlying mechanism used." msgstr "" -#: howto/logging.rst:977 +#: howto/logging.rst:941 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:980 +#: howto/logging.rst:944 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 " @@ -1226,15 +1213,15 @@ msgid "" "more information." msgstr "" -#: howto/logging.rst:986 +#: howto/logging.rst:950 msgid "The :class:`NullHandler` class." msgstr "" -#: howto/logging.rst:989 +#: howto/logging.rst:953 msgid "The :class:`~handlers.QueueHandler` class." msgstr "" -#: howto/logging.rst:992 +#: howto/logging.rst:956 msgid "" "The :class:`NullHandler`, :class:`StreamHandler` and :class:`FileHandler` " "classes are defined in the core logging package. The other handlers are " @@ -1242,14 +1229,14 @@ msgid "" "module, :mod:`logging.config`, for configuration functionality.)" msgstr "" -#: howto/logging.rst:997 +#: howto/logging.rst:961 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:1001 +#: howto/logging.rst:965 msgid "" "For formatting multiple messages in a batch, instances of :class:" "`BufferingFormatter` can be used. In addition to the format string (which is " @@ -1257,7 +1244,7 @@ msgid "" "trailer format strings." msgstr "" -#: howto/logging.rst:1006 +#: howto/logging.rst:970 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:" @@ -1267,18 +1254,18 @@ msgid "" "value, the message is not processed further." msgstr "" -#: howto/logging.rst:1013 +#: howto/logging.rst:977 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:1021 +#: howto/logging.rst:985 msgid "Exceptions raised during logging" msgstr "" -#: howto/logging.rst:1023 +#: howto/logging.rst:987 msgid "" "The logging package is designed to swallow exceptions which occur while " "logging in production. This is so that errors which occur while handling " @@ -1286,7 +1273,7 @@ msgid "" "errors - do not cause the application using logging to terminate prematurely." msgstr "" -#: howto/logging.rst:1028 +#: howto/logging.rst:992 msgid "" ":class:`SystemExit` and :class:`KeyboardInterrupt` exceptions are never " "swallowed. Other exceptions which occur during the :meth:`~Handler.emit` " @@ -1294,7 +1281,7 @@ msgid "" "handleError` method." msgstr "" -#: howto/logging.rst:1033 +#: howto/logging.rst:997 msgid "" "The default implementation of :meth:`~Handler.handleError` in :class:" "`Handler` checks to see if a module-level variable, :data:`raiseExceptions`, " @@ -1302,7 +1289,7 @@ msgid "" "the exception is swallowed." msgstr "" -#: howto/logging.rst:1039 +#: howto/logging.rst:1003 msgid "" "The default value of :data:`raiseExceptions` is ``True``. This is because " "during development, you typically want to be notified of any exceptions that " @@ -1310,11 +1297,11 @@ msgid "" "production usage." msgstr "" -#: howto/logging.rst:1049 +#: howto/logging.rst:1013 msgid "Using arbitrary objects as messages" msgstr "" -#: howto/logging.rst:1051 +#: howto/logging.rst:1015 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 " @@ -1326,11 +1313,11 @@ msgid "" "the wire." msgstr "" -#: howto/logging.rst:1062 +#: howto/logging.rst:1026 msgid "Optimization" msgstr "" -#: howto/logging.rst:1064 +#: howto/logging.rst:1028 msgid "" "Formatting of message arguments is deferred until it cannot be avoided. " "However, computing the arguments passed to the logging method can also be " @@ -1341,13 +1328,13 @@ msgid "" "code like this::" msgstr "" -#: howto/logging.rst:1076 +#: howto/logging.rst:1040 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:1079 +#: howto/logging.rst:1043 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 " @@ -1359,7 +1346,7 @@ msgid "" "while the application is running (which is not all that common)." msgstr "" -#: howto/logging.rst:1088 +#: howto/logging.rst:1052 msgid "" "There are other optimizations which can be made for specific applications " "which need more precise control over what logging information is collected. " @@ -1367,94 +1354,94 @@ msgid "" "you don't need:" msgstr "" -#: howto/logging.rst:1094 +#: howto/logging.rst:1058 msgid "What you don't want to collect" msgstr "" -#: howto/logging.rst:1094 +#: howto/logging.rst:1058 msgid "How to avoid collecting it" msgstr "" -#: howto/logging.rst:1096 +#: howto/logging.rst:1060 msgid "Information about where calls were made from." msgstr "" -#: howto/logging.rst:1096 +#: howto/logging.rst:1060 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:1102 +#: howto/logging.rst:1066 msgid "Threading information." msgstr "" -#: howto/logging.rst:1102 +#: howto/logging.rst:1066 msgid "Set ``logging.logThreads`` to ``False``." msgstr "" -#: howto/logging.rst:1104 +#: howto/logging.rst:1068 msgid "Current process ID (:func:`os.getpid`)" msgstr "" -#: howto/logging.rst:1104 +#: howto/logging.rst:1068 msgid "Set ``logging.logProcesses`` to ``False``." msgstr "" -#: howto/logging.rst:1106 +#: howto/logging.rst:1070 msgid "" "Current process name when using ``multiprocessing`` to manage multiple " "processes." msgstr "" -#: howto/logging.rst:1106 +#: howto/logging.rst:1070 msgid "Set ``logging.logMultiprocessing`` to ``False``." msgstr "" -#: howto/logging.rst:1109 +#: howto/logging.rst:1073 msgid "Current :class:`asyncio.Task` name when using ``asyncio``." msgstr "" -#: howto/logging.rst:1109 +#: howto/logging.rst:1073 msgid "Set ``logging.logAsyncioTasks`` to ``False``." msgstr "" -#: howto/logging.rst:1113 +#: howto/logging.rst:1077 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:1120 +#: howto/logging.rst:1084 msgid "Other resources" msgstr "" -#: howto/logging.rst:1125 +#: howto/logging.rst:1089 msgid "Module :mod:`logging`" msgstr "" -#: howto/logging.rst:1125 +#: howto/logging.rst:1089 msgid "API reference for the logging module." msgstr "" -#: howto/logging.rst:1128 +#: howto/logging.rst:1092 msgid "Module :mod:`logging.config`" msgstr "" -#: howto/logging.rst:1128 +#: howto/logging.rst:1092 msgid "Configuration API for the logging module." msgstr "" -#: howto/logging.rst:1131 +#: howto/logging.rst:1095 msgid "Module :mod:`logging.handlers`" msgstr "" -#: howto/logging.rst:1131 +#: howto/logging.rst:1095 msgid "Useful handlers included with the logging module." msgstr "" -#: howto/logging.rst:1133 +#: howto/logging.rst:1097 msgid ":ref:`A logging cookbook `" msgstr "" diff --git a/library/asyncio-eventloop.po b/library/asyncio-eventloop.po index f8468b964..304ecfa4e 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: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -811,20 +811,24 @@ msgid "" msgstr "" #: library/asyncio-eventloop.rst:608 +msgid "Added support for Windows." +msgstr "" + +#: library/asyncio-eventloop.rst:611 msgid "" "The *reuse_address* parameter is no longer supported, as using :ref:`socket." "SO_REUSEADDR ` poses a significant security concern " "for UDP. Explicitly passing ``reuse_address=True`` will raise an exception." msgstr "" -#: library/asyncio-eventloop.rst:614 +#: library/asyncio-eventloop.rst:617 msgid "" "When multiple processes with differing UIDs assign sockets to an identical " "UDP socket address with ``SO_REUSEADDR``, incoming packets can become " "randomly distributed among the sockets." msgstr "" -#: library/asyncio-eventloop.rst:618 +#: library/asyncio-eventloop.rst:621 msgid "" "For supported platforms, *reuse_port* can be used as a replacement for " "similar functionality. With *reuse_port*, :ref:`socket.SO_REUSEPORT \n" @@ -24,7 +24,7 @@ msgstr "" msgid "" "This table contains all events raised by :func:`sys.audit` or :c:func:" "`PySys_Audit` calls throughout the CPython runtime and the standard " -"library. These calls were added in 3.8.0 or later (see :pep:`578`)." +"library. These calls were added in 3.8 or later (see :pep:`578`)." msgstr "" #: library/audit_events.rst:12 diff --git a/library/bz2.po b/library/bz2.po index b249e12dd..c23a95318 100644 --- a/library/bz2.po +++ b/library/bz2.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -97,11 +97,11 @@ msgid "" "handling behavior, and line ending(s)." msgstr "" -#: library/bz2.rst:163 +#: library/bz2.rst:162 msgid "The ``'x'`` (exclusive creation) mode was added." msgstr "" -#: library/bz2.rst:170 +#: library/bz2.rst:169 msgid "Accepts a :term:`path-like object`." msgstr "" @@ -220,77 +220,77 @@ msgid "" "stream files." msgstr "" -#: library/bz2.rst:166 +#: library/bz2.rst:165 msgid "" "The :meth:`~io.BufferedIOBase.read` method now accepts an argument of " "``None``." msgstr "" -#: library/bz2.rst:173 +#: library/bz2.rst:172 msgid "" "The *buffering* parameter has been removed. It was ignored and deprecated " "since Python 3.0. Pass an open file object to control how the file is opened." msgstr "" -#: library/bz2.rst:178 +#: library/bz2.rst:177 msgid "The *compresslevel* parameter became keyword-only." msgstr "" -#: library/bz2.rst:180 +#: library/bz2.rst:179 msgid "" "This class is thread unsafe in the face of multiple simultaneous readers or " "writers, just like its equivalent classes in :mod:`gzip` and :mod:`lzma` " "have always been." msgstr "" -#: library/bz2.rst:187 +#: library/bz2.rst:186 msgid "Incremental (de)compression" msgstr "" -#: library/bz2.rst:191 +#: library/bz2.rst:190 msgid "" "Create a new compressor object. This object may be used to compress data " "incrementally. For one-shot compression, use the :func:`compress` function " "instead." msgstr "" -#: library/bz2.rst:283 +#: library/bz2.rst:282 msgid "" "*compresslevel*, if given, must be an integer between ``1`` and ``9``. The " "default is ``9``." msgstr "" -#: library/bz2.rst:200 +#: library/bz2.rst:199 msgid "" "Provide data to the compressor object. Returns a chunk of compressed data if " "possible, or an empty byte string otherwise." msgstr "" -#: library/bz2.rst:203 +#: library/bz2.rst:202 msgid "" "When you have finished providing data to the compressor, call the :meth:" "`flush` method to finish the compression process." msgstr "" -#: library/bz2.rst:209 +#: library/bz2.rst:208 msgid "" "Finish the compression process. Returns the compressed data left in internal " "buffers." msgstr "" -#: library/bz2.rst:212 +#: library/bz2.rst:211 msgid "" "The compressor object may not be used after this method has been called." msgstr "" -#: library/bz2.rst:217 +#: library/bz2.rst:216 msgid "" "Create a new decompressor object. This object may be used to decompress data " "incrementally. For one-shot compression, use the :func:`decompress` function " "instead." msgstr "" -#: library/bz2.rst:222 +#: library/bz2.rst:221 msgid "" "This class does not transparently handle inputs containing multiple " "compressed streams, unlike :func:`decompress` and :class:`BZ2File`. If you " @@ -298,7 +298,7 @@ msgid "" "must use a new decompressor for each stream." msgstr "" -#: library/bz2.rst:229 +#: library/bz2.rst:228 msgid "" "Decompress *data* (a :term:`bytes-like object`), returning uncompressed data " "as bytes. Some of *data* may be buffered internally, for use in later calls " @@ -306,7 +306,7 @@ msgid "" "output of any previous calls to :meth:`decompress`." msgstr "" -#: library/bz2.rst:235 +#: library/bz2.rst:234 msgid "" "If *max_length* is nonnegative, returns at most *max_length* bytes of " "decompressed data. If this limit is reached and further output can be " @@ -315,99 +315,99 @@ msgid "" "``b''`` to obtain more of the output." msgstr "" -#: library/bz2.rst:242 +#: library/bz2.rst:241 msgid "" "If all of the input data was decompressed and returned (either because this " "was less than *max_length* bytes, or because *max_length* was negative), " "the :attr:`~.needs_input` attribute will be set to ``True``." msgstr "" -#: library/bz2.rst:247 +#: library/bz2.rst:246 msgid "" "Attempting to decompress data after the end of stream is reached raises an :" "exc:`EOFError`. Any data found after the end of the stream is ignored and " "saved in the :attr:`~.unused_data` attribute." msgstr "" -#: library/bz2.rst:251 +#: library/bz2.rst:250 msgid "Added the *max_length* parameter." msgstr "" -#: library/bz2.rst:256 +#: library/bz2.rst:255 msgid "``True`` if the end-of-stream marker has been reached." msgstr "" -#: library/bz2.rst:263 +#: library/bz2.rst:262 msgid "Data found after the end of the compressed stream." msgstr "" -#: library/bz2.rst:265 +#: library/bz2.rst:264 msgid "" "If this attribute is accessed before the end of the stream has been reached, " "its value will be ``b''``." msgstr "" -#: library/bz2.rst:270 +#: library/bz2.rst:269 msgid "" "``False`` if the :meth:`.decompress` method can provide more decompressed " "data before requiring new uncompressed input." msgstr "" -#: library/bz2.rst:277 +#: library/bz2.rst:276 msgid "One-shot (de)compression" msgstr "" -#: library/bz2.rst:281 +#: library/bz2.rst:280 msgid "Compress *data*, a :term:`bytes-like object `." msgstr "" -#: library/bz2.rst:286 +#: library/bz2.rst:285 msgid "For incremental compression, use a :class:`BZ2Compressor` instead." msgstr "" -#: library/bz2.rst:291 +#: library/bz2.rst:290 msgid "Decompress *data*, a :term:`bytes-like object `." msgstr "" -#: library/bz2.rst:293 +#: library/bz2.rst:292 msgid "" "If *data* is the concatenation of multiple compressed streams, decompress " "all of the streams." msgstr "" -#: library/bz2.rst:296 +#: library/bz2.rst:295 msgid "For incremental decompression, use a :class:`BZ2Decompressor` instead." msgstr "" -#: library/bz2.rst:298 +#: library/bz2.rst:297 msgid "Support for multi-stream inputs was added." msgstr "" -#: library/bz2.rst:304 +#: library/bz2.rst:303 msgid "Examples of usage" msgstr "" -#: library/bz2.rst:306 +#: library/bz2.rst:305 msgid "Below are some examples of typical usage of the :mod:`bz2` module." msgstr "" -#: library/bz2.rst:308 +#: library/bz2.rst:307 msgid "" "Using :func:`compress` and :func:`decompress` to demonstrate round-trip " "compression:" msgstr "" -#: library/bz2.rst:326 +#: library/bz2.rst:325 msgid "Using :class:`BZ2Compressor` for incremental compression:" msgstr "" -#: library/bz2.rst:344 +#: library/bz2.rst:343 msgid "" "The example above uses a very \"nonrandom\" stream of data (a stream of " "``b\"z\"`` chunks). Random data tends to compress poorly, while ordered, " "repetitive data usually yields a high compression ratio." msgstr "" -#: library/bz2.rst:348 +#: library/bz2.rst:347 msgid "Writing and reading a bzip2-compressed file in binary mode:" msgstr "" diff --git a/library/ctypes.po b/library/ctypes.po index d1e794994..348d85c13 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-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -113,7 +113,7 @@ msgstr "" msgid "Functions are accessed as attributes of dll objects::" msgstr "" -#: library/ctypes.rst:109 +#: library/ctypes.rst:108 msgid "" "Note that win32 system dlls like ``kernel32`` and ``user32`` often export " "ANSI as well as UNICODE versions of a function. The UNICODE version is " @@ -124,65 +124,65 @@ msgid "" "``GetModuleHandle`` depending on whether UNICODE is defined or not::" msgstr "" -#: library/ctypes.rst:122 +#: library/ctypes.rst:121 msgid "" "*windll* does not try to select one of them by magic, you must access the " "version you need by specifying ``GetModuleHandleA`` or ``GetModuleHandleW`` " "explicitly, and then call it with bytes or string objects respectively." msgstr "" -#: library/ctypes.rst:126 +#: library/ctypes.rst:125 msgid "" "Sometimes, dlls export functions with names which aren't valid Python " "identifiers, like ``\"??2@YAPAXI@Z\"``. In this case you have to use :func:" "`getattr` to retrieve the function::" msgstr "" -#: library/ctypes.rst:134 +#: library/ctypes.rst:133 msgid "" "On Windows, some dlls export functions not by name but by ordinal. These " "functions can be accessed by indexing the dll object with the ordinal " "number::" msgstr "" -#: library/ctypes.rst:151 +#: library/ctypes.rst:150 msgid "Calling functions" msgstr "" -#: library/ctypes.rst:153 +#: library/ctypes.rst:152 msgid "" "You can call these functions like any other Python callable. This example " "uses the ``rand()`` function, which takes no arguments and returns a pseudo-" "random integer::" msgstr "" -#: library/ctypes.rst:159 +#: library/ctypes.rst:158 msgid "" "On Windows, you can call the ``GetModuleHandleA()`` function, which returns " "a win32 module handle (passing ``None`` as single argument to call it with a " "``NULL`` pointer)::" msgstr "" -#: library/ctypes.rst:166 +#: library/ctypes.rst:165 msgid "" ":exc:`ValueError` is raised when you call an ``stdcall`` function with the " "``cdecl`` calling convention, or vice versa::" msgstr "" -#: library/ctypes.rst:181 +#: library/ctypes.rst:180 msgid "" "To find out the correct calling convention you have to look into the C " "header file or the documentation for the function you want to call." msgstr "" -#: library/ctypes.rst:184 +#: library/ctypes.rst:183 msgid "" "On Windows, :mod:`ctypes` uses win32 structured exception handling to " "prevent crashes from general protection faults when functions are called " "with invalid argument values::" msgstr "" -#: library/ctypes.rst:194 +#: library/ctypes.rst:193 msgid "" "There are, however, enough ways to crash Python with :mod:`ctypes`, so you " "should be careful anyway. The :mod:`faulthandler` module can be helpful in " @@ -190,7 +190,7 @@ msgid "" "library calls)." msgstr "" -#: library/ctypes.rst:199 +#: library/ctypes.rst:198 msgid "" "``None``, integers, bytes objects and (unicode) strings are the only native " "Python objects that can directly be used as parameters in these function " @@ -201,254 +201,254 @@ msgid "" "the C type." msgstr "" -#: library/ctypes.rst:206 +#: library/ctypes.rst:205 msgid "" "Before we move on calling functions with other parameter types, we have to " "learn more about :mod:`ctypes` data types." msgstr "" -#: library/ctypes.rst:2199 +#: library/ctypes.rst:2198 msgid "Fundamental data types" msgstr "" -#: library/ctypes.rst:215 +#: library/ctypes.rst:214 msgid ":mod:`ctypes` defines a number of primitive C compatible data types:" msgstr "" -#: library/ctypes.rst:218 +#: library/ctypes.rst:217 msgid "ctypes type" msgstr "" -#: library/ctypes.rst:218 +#: library/ctypes.rst:217 msgid "C type" msgstr "" -#: library/ctypes.rst:218 +#: library/ctypes.rst:217 msgid "Python type" msgstr "" -#: library/ctypes.rst:220 +#: library/ctypes.rst:219 msgid ":class:`c_bool`" msgstr "" -#: library/ctypes.rst:220 +#: library/ctypes.rst:219 msgid ":c:expr:`_Bool`" msgstr "" -#: library/ctypes.rst:220 +#: library/ctypes.rst:219 msgid "bool (1)" msgstr "" -#: library/ctypes.rst:222 +#: library/ctypes.rst:221 msgid ":class:`c_char`" msgstr "" -#: library/ctypes.rst:226 +#: library/ctypes.rst:225 msgid ":c:expr:`char`" msgstr "" -#: library/ctypes.rst:222 +#: library/ctypes.rst:221 msgid "1-character bytes object" msgstr "" -#: library/ctypes.rst:224 +#: library/ctypes.rst:223 msgid ":class:`c_wchar`" msgstr "" -#: library/ctypes.rst:224 +#: library/ctypes.rst:223 msgid ":c:type:`wchar_t`" msgstr "" -#: library/ctypes.rst:224 +#: library/ctypes.rst:223 msgid "1-character string" msgstr "" -#: library/ctypes.rst:226 +#: library/ctypes.rst:225 msgid ":class:`c_byte`" msgstr "" -#: library/ctypes.rst:228 library/ctypes.rst:232 library/ctypes.rst:236 -#: library/ctypes.rst:240 library/ctypes.rst:244 library/ctypes.rst:249 -#: library/ctypes.rst:252 +#: library/ctypes.rst:227 library/ctypes.rst:231 library/ctypes.rst:235 +#: library/ctypes.rst:239 library/ctypes.rst:243 library/ctypes.rst:248 +#: library/ctypes.rst:251 msgid "int" msgstr "" -#: library/ctypes.rst:228 +#: library/ctypes.rst:227 msgid ":class:`c_ubyte`" msgstr "" -#: library/ctypes.rst:228 +#: library/ctypes.rst:227 msgid ":c:expr:`unsigned char`" msgstr "" -#: library/ctypes.rst:230 +#: library/ctypes.rst:229 msgid ":class:`c_short`" msgstr "" -#: library/ctypes.rst:230 +#: library/ctypes.rst:229 msgid ":c:expr:`short`" msgstr "" -#: library/ctypes.rst:232 +#: library/ctypes.rst:231 msgid ":class:`c_ushort`" msgstr "" -#: library/ctypes.rst:232 +#: library/ctypes.rst:231 msgid ":c:expr:`unsigned short`" msgstr "" -#: library/ctypes.rst:234 +#: library/ctypes.rst:233 msgid ":class:`c_int`" msgstr "" -#: library/ctypes.rst:234 +#: library/ctypes.rst:233 msgid ":c:expr:`int`" msgstr "" -#: library/ctypes.rst:236 +#: library/ctypes.rst:235 msgid ":class:`c_uint`" msgstr "" -#: library/ctypes.rst:236 +#: library/ctypes.rst:235 msgid ":c:expr:`unsigned int`" msgstr "" -#: library/ctypes.rst:238 +#: library/ctypes.rst:237 msgid ":class:`c_long`" msgstr "" -#: library/ctypes.rst:238 +#: library/ctypes.rst:237 msgid ":c:expr:`long`" msgstr "" -#: library/ctypes.rst:240 +#: library/ctypes.rst:239 msgid ":class:`c_ulong`" msgstr "" -#: library/ctypes.rst:240 +#: library/ctypes.rst:239 msgid ":c:expr:`unsigned long`" msgstr "" -#: library/ctypes.rst:242 +#: library/ctypes.rst:241 msgid ":class:`c_longlong`" msgstr "" -#: library/ctypes.rst:242 +#: library/ctypes.rst:241 msgid ":c:expr:`__int64` or :c:expr:`long long`" msgstr "" -#: library/ctypes.rst:244 +#: library/ctypes.rst:243 msgid ":class:`c_ulonglong`" msgstr "" -#: library/ctypes.rst:244 +#: library/ctypes.rst:243 msgid ":c:expr:`unsigned __int64` or :c:expr:`unsigned long long`" msgstr "" -#: library/ctypes.rst:247 +#: library/ctypes.rst:246 msgid ":class:`c_size_t`" msgstr "" -#: library/ctypes.rst:247 +#: library/ctypes.rst:246 msgid ":c:type:`size_t`" msgstr "" -#: library/ctypes.rst:249 +#: library/ctypes.rst:248 msgid ":class:`c_ssize_t`" msgstr "" -#: library/ctypes.rst:249 +#: library/ctypes.rst:248 msgid ":c:type:`ssize_t` or :c:expr:`Py_ssize_t`" msgstr "" -#: library/ctypes.rst:252 +#: library/ctypes.rst:251 msgid ":class:`c_time_t`" msgstr "" -#: library/ctypes.rst:252 +#: library/ctypes.rst:251 msgid ":c:type:`time_t`" msgstr "" -#: library/ctypes.rst:254 +#: library/ctypes.rst:253 msgid ":class:`c_float`" msgstr "" -#: library/ctypes.rst:254 +#: library/ctypes.rst:253 msgid ":c:expr:`float`" msgstr "" -#: library/ctypes.rst:256 library/ctypes.rst:258 +#: library/ctypes.rst:255 library/ctypes.rst:257 msgid "float" msgstr "" -#: library/ctypes.rst:256 +#: library/ctypes.rst:255 msgid ":class:`c_double`" msgstr "" -#: library/ctypes.rst:256 +#: library/ctypes.rst:255 msgid ":c:expr:`double`" msgstr "" -#: library/ctypes.rst:258 +#: library/ctypes.rst:257 msgid ":class:`c_longdouble`" msgstr "" -#: library/ctypes.rst:258 +#: library/ctypes.rst:257 msgid ":c:expr:`long double`" msgstr "" -#: library/ctypes.rst:260 +#: library/ctypes.rst:259 msgid ":class:`c_char_p`" msgstr "" -#: library/ctypes.rst:260 +#: library/ctypes.rst:259 msgid ":c:expr:`char *` (NUL terminated)" msgstr "" -#: library/ctypes.rst:260 +#: library/ctypes.rst:259 msgid "bytes object or ``None``" msgstr "" -#: library/ctypes.rst:262 +#: library/ctypes.rst:261 msgid ":class:`c_wchar_p`" msgstr "" -#: library/ctypes.rst:262 +#: library/ctypes.rst:261 msgid ":c:expr:`wchar_t *` (NUL terminated)" msgstr "" -#: library/ctypes.rst:262 +#: library/ctypes.rst:261 msgid "string or ``None``" msgstr "" -#: library/ctypes.rst:264 +#: library/ctypes.rst:263 msgid ":class:`c_void_p`" msgstr "" -#: library/ctypes.rst:264 +#: library/ctypes.rst:263 msgid ":c:expr:`void *`" msgstr "" -#: library/ctypes.rst:264 +#: library/ctypes.rst:263 msgid "int or ``None``" msgstr "" -#: library/ctypes.rst:268 +#: library/ctypes.rst:267 msgid "The constructor accepts any object with a truth value." msgstr "" -#: library/ctypes.rst:270 +#: library/ctypes.rst:269 msgid "" "All these types can be created by calling them with an optional initializer " "of the correct type and value::" msgstr "" -#: library/ctypes.rst:281 +#: library/ctypes.rst:280 msgid "" "Since these types are mutable, their value can also be changed afterwards::" msgstr "" -#: library/ctypes.rst:293 +#: library/ctypes.rst:292 msgid "" "Assigning a new value to instances of the pointer types :class:`c_char_p`, :" "class:`c_wchar_p`, and :class:`c_void_p` changes the *memory location* they " @@ -456,7 +456,7 @@ msgid "" "Python bytes objects are immutable)::" msgstr "" -#: library/ctypes.rst:313 +#: library/ctypes.rst:312 msgid "" "You should be careful, however, not to pass them to functions expecting " "pointers to mutable memory. If you need mutable memory blocks, ctypes has a :" @@ -466,7 +466,7 @@ msgid "" "``value`` property::" msgstr "" -#: library/ctypes.rst:337 +#: library/ctypes.rst:336 msgid "" "The :func:`create_string_buffer` function replaces the old :func:`!c_buffer` " "function (which is still available as an alias). To create a mutable memory " @@ -474,29 +474,29 @@ msgid "" "the :func:`create_unicode_buffer` function." msgstr "" -#: library/ctypes.rst:346 +#: library/ctypes.rst:345 msgid "Calling functions, continued" msgstr "" -#: library/ctypes.rst:348 +#: library/ctypes.rst:347 msgid "" "Note that printf prints to the real standard output channel, *not* to :data:" "`sys.stdout`, so these examples will only work at the console prompt, not " "from within *IDLE* or *PythonWin*::" msgstr "" -#: library/ctypes.rst:368 +#: library/ctypes.rst:367 msgid "" "As has been mentioned before, all Python types except integers, strings, and " "bytes objects have to be wrapped in their corresponding :mod:`ctypes` type, " "so that they can be converted to the required C data type::" msgstr "" -#: library/ctypes.rst:380 +#: library/ctypes.rst:379 msgid "Calling variadic functions" msgstr "" -#: library/ctypes.rst:382 +#: library/ctypes.rst:381 msgid "" "On a lot of platforms calling variadic functions through ctypes is exactly " "the same as calling functions with a fixed number of parameters. On some " @@ -505,23 +505,23 @@ msgid "" "functions." msgstr "" -#: library/ctypes.rst:387 +#: library/ctypes.rst:386 msgid "" "On those platforms it is required to specify the :attr:`~_FuncPtr.argtypes` " "attribute for the regular, non-variadic, function arguments:" msgstr "" -#: library/ctypes.rst:394 +#: library/ctypes.rst:393 msgid "" "Because specifying the attribute does not inhibit portability it is advised " "to always specify :attr:`~_FuncPtr.argtypes` for all variadic functions." msgstr "" -#: library/ctypes.rst:401 +#: library/ctypes.rst:400 msgid "Calling functions with your own custom data types" msgstr "" -#: library/ctypes.rst:403 +#: library/ctypes.rst:402 msgid "" "You can also customize :mod:`ctypes` argument conversion to allow instances " "of your own classes be used as function arguments. :mod:`ctypes` looks for " @@ -530,24 +530,24 @@ msgid "" "or an object with an :attr:`!_as_parameter_` attribute::" msgstr "" -#: library/ctypes.rst:419 +#: library/ctypes.rst:418 msgid "" "If you don't want to store the instance's data in the :attr:`!" "_as_parameter_` instance variable, you could define a :class:`property` " "which makes the attribute available on request." msgstr "" -#: library/ctypes.rst:427 +#: library/ctypes.rst:426 msgid "Specifying the required argument types (function prototypes)" msgstr "" -#: library/ctypes.rst:429 +#: library/ctypes.rst:428 msgid "" "It is possible to specify the required argument types of functions exported " "from DLLs by setting the :attr:`~_FuncPtr.argtypes` attribute." msgstr "" -#: library/ctypes.rst:432 +#: library/ctypes.rst:431 msgid "" ":attr:`~_FuncPtr.argtypes` must be a sequence of C data types (the :func:`!" "printf` function is probably not a good example here, because it takes a " @@ -556,14 +556,14 @@ msgid "" "feature)::" msgstr "" -#: library/ctypes.rst:443 +#: library/ctypes.rst:442 msgid "" "Specifying a format protects against incompatible argument types (just as a " "prototype for a C function), and tries to convert the arguments to valid " "types::" msgstr "" -#: library/ctypes.rst:455 +#: library/ctypes.rst:454 msgid "" "If you have defined your own classes which you pass to function calls, you " "have to implement a :meth:`~_CData.from_param` class method for them to be " @@ -577,48 +577,48 @@ msgid "" "_as_parameter_` attribute." msgstr "" -#: library/ctypes.rst:469 +#: library/ctypes.rst:468 msgid "Return types" msgstr "" -#: library/ctypes.rst:479 +#: library/ctypes.rst:478 msgid "" "By default functions are assumed to return the C :c:expr:`int` type. Other " "return types can be specified by setting the :attr:`~_FuncPtr.restype` " "attribute of the function object." msgstr "" -#: library/ctypes.rst:483 +#: library/ctypes.rst:482 msgid "" "The C prototype of :c:func:`time` is ``time_t time(time_t *)``. Because :c:" "type:`time_t` might be of a different type than the default return type :c:" "expr:`int`, you should specify the :attr:`!restype` attribute::" msgstr "" -#: library/ctypes.rst:489 +#: library/ctypes.rst:488 msgid "The argument types can be specified using :attr:`~_FuncPtr.argtypes`::" msgstr "" -#: library/ctypes.rst:493 +#: library/ctypes.rst:492 msgid "" "To call the function with a ``NULL`` pointer as first argument, use " "``None``::" msgstr "" -#: library/ctypes.rst:498 +#: library/ctypes.rst:497 msgid "" "Here is a more advanced example, it uses the :func:`!strchr` function, which " "expects a string pointer and a char, and returns a pointer to a string::" msgstr "" -#: library/ctypes.rst:511 +#: library/ctypes.rst:510 msgid "" "If you want to avoid the :func:`ord(\"x\") ` calls above, you can set " "the :attr:`~_FuncPtr.argtypes` attribute, and the second argument will be " "converted from a single character Python bytes object into a C char:" msgstr "" -#: library/ctypes.rst:530 +#: library/ctypes.rst:529 msgid "" "You can also use a callable Python object (a function or a class for " "example) as the :attr:`~_FuncPtr.restype` attribute, if the foreign function " @@ -628,7 +628,7 @@ msgid "" "automatically raise an exception::" msgstr "" -#: library/ctypes.rst:553 +#: library/ctypes.rst:552 msgid "" "``WinError`` is a function which will call Windows ``FormatMessage()`` api " "to get the string representation of an error code, and *returns* an " @@ -636,18 +636,18 @@ msgid "" "used, it calls :func:`GetLastError` to retrieve it." msgstr "" -#: library/ctypes.rst:558 +#: library/ctypes.rst:557 msgid "" "Please note that a much more powerful error checking mechanism is available " "through the :attr:`~_FuncPtr.errcheck` attribute; see the reference manual " "for details." msgstr "" -#: library/ctypes.rst:566 +#: library/ctypes.rst:565 msgid "Passing pointers (or: passing parameters by reference)" msgstr "" -#: library/ctypes.rst:568 +#: library/ctypes.rst:567 msgid "" "Sometimes a C api function expects a *pointer* to a data type as parameter, " "probably to write into the corresponding location, or if the data is too " @@ -655,7 +655,7 @@ msgid "" "reference*." msgstr "" -#: library/ctypes.rst:572 +#: library/ctypes.rst:571 msgid "" ":mod:`ctypes` exports the :func:`byref` function which is used to pass " "parameters by reference. The same effect can be achieved with the :func:" @@ -664,11 +664,11 @@ msgid "" "you don't need the pointer object in Python itself::" msgstr "" -#: library/ctypes.rst:594 +#: library/ctypes.rst:593 msgid "Structures and unions" msgstr "" -#: library/ctypes.rst:596 +#: library/ctypes.rst:595 msgid "" "Structures and unions must derive from the :class:`Structure` and :class:" "`Union` base classes which are defined in the :mod:`ctypes` module. Each " @@ -677,44 +677,44 @@ msgid "" "*field type*." msgstr "" -#: library/ctypes.rst:601 +#: library/ctypes.rst:600 msgid "" "The field type must be a :mod:`ctypes` type like :class:`c_int`, or any " "other derived :mod:`ctypes` type: structure, union, array, pointer." msgstr "" -#: library/ctypes.rst:604 +#: library/ctypes.rst:603 msgid "" "Here is a simple example of a POINT structure, which contains two integers " "named *x* and *y*, and also shows how to initialize a structure in the " "constructor::" msgstr "" -#: library/ctypes.rst:624 +#: library/ctypes.rst:623 msgid "" "You can, however, build much more complicated structures. A structure can " "itself contain other structures by using a structure as a field type." msgstr "" -#: library/ctypes.rst:627 +#: library/ctypes.rst:626 msgid "" "Here is a RECT structure which contains two POINTs named *upperleft* and " "*lowerright*::" msgstr "" -#: library/ctypes.rst:641 +#: library/ctypes.rst:640 msgid "" "Nested structures can also be initialized in the constructor in several " "ways::" msgstr "" -#: library/ctypes.rst:646 +#: library/ctypes.rst:645 msgid "" "Field :term:`descriptor`\\s can be retrieved from the *class*, they are " "useful for debugging because they can provide useful information::" msgstr "" -#: library/ctypes.rst:660 +#: library/ctypes.rst:659 msgid "" ":mod:`ctypes` does not support passing unions or structures with bit-fields " "to functions by value. While this may work on 32-bit x86, it's not " @@ -722,11 +722,11 @@ msgid "" "structures with bit-fields should always be passed to functions by pointer." msgstr "" -#: library/ctypes.rst:666 +#: library/ctypes.rst:665 msgid "Structure/union alignment and byte order" msgstr "" -#: library/ctypes.rst:668 +#: library/ctypes.rst:667 msgid "" "By default, Structure and Union fields are aligned in the same way the C " "compiler does it. It is possible to override this behavior by specifying a :" @@ -735,7 +735,7 @@ msgid "" "the fields. This is what ``#pragma pack(n)`` also does in MSVC." msgstr "" -#: library/ctypes.rst:674 +#: library/ctypes.rst:673 msgid "" ":mod:`ctypes` uses the native byte order for Structures and Unions. To " "build structures with non-native byte order, you can use one of the :class:" @@ -744,91 +744,91 @@ msgid "" "classes cannot contain pointer fields." msgstr "" -#: library/ctypes.rst:684 +#: library/ctypes.rst:683 msgid "Bit fields in structures and unions" msgstr "" -#: library/ctypes.rst:686 +#: library/ctypes.rst:685 msgid "" "It is possible to create structures and unions containing bit fields. Bit " "fields are only possible for integer fields, the bit width is specified as " "the third item in the :attr:`~Structure._fields_` tuples::" msgstr "" -#: library/ctypes.rst:704 +#: library/ctypes.rst:703 msgid "Arrays" msgstr "" -#: library/ctypes.rst:706 +#: library/ctypes.rst:705 msgid "" "Arrays are sequences, containing a fixed number of instances of the same " "type." msgstr "" -#: library/ctypes.rst:708 +#: library/ctypes.rst:707 msgid "" "The recommended way to create array types is by multiplying a data type with " "a positive integer::" msgstr "" -#: library/ctypes.rst:713 +#: library/ctypes.rst:712 msgid "" "Here is an example of a somewhat artificial data type, a structure " "containing 4 POINTs among other stuff::" msgstr "" -#: library/ctypes.rst:729 +#: library/ctypes.rst:728 msgid "Instances are created in the usual way, by calling the class::" msgstr "" -#: library/ctypes.rst:735 +#: library/ctypes.rst:734 msgid "" "The above code print a series of ``0 0`` lines, because the array contents " "is initialized to zeros." msgstr "" -#: library/ctypes.rst:738 +#: library/ctypes.rst:737 msgid "Initializers of the correct type can also be specified::" msgstr "" -#: library/ctypes.rst:754 +#: library/ctypes.rst:753 msgid "Pointers" msgstr "" -#: library/ctypes.rst:756 +#: library/ctypes.rst:755 msgid "" "Pointer instances are created by calling the :func:`pointer` function on a :" "mod:`ctypes` type::" msgstr "" -#: library/ctypes.rst:764 +#: library/ctypes.rst:763 msgid "" "Pointer instances have a :attr:`~_Pointer.contents` attribute which returns " "the object to which the pointer points, the ``i`` object above::" msgstr "" -#: library/ctypes.rst:771 +#: library/ctypes.rst:770 msgid "" "Note that :mod:`ctypes` does not have OOR (original object return), it " "constructs a new, equivalent object each time you retrieve an attribute::" msgstr "" -#: library/ctypes.rst:780 +#: library/ctypes.rst:779 msgid "" "Assigning another :class:`c_int` instance to the pointer's contents " "attribute would cause the pointer to point to the memory location where this " "is stored::" msgstr "" -#: library/ctypes.rst:792 +#: library/ctypes.rst:791 msgid "Pointer instances can also be indexed with integers::" msgstr "" -#: library/ctypes.rst:798 +#: library/ctypes.rst:797 msgid "Assigning to an integer index changes the pointed to value::" msgstr "" -#: library/ctypes.rst:807 +#: library/ctypes.rst:806 msgid "" "It is also possible to use indexes different from 0, but you must know what " "you're doing, just as in C: You can access or change arbitrary memory " @@ -837,7 +837,7 @@ msgid "" "instead of a single item." msgstr "" -#: library/ctypes.rst:813 +#: library/ctypes.rst:812 msgid "" "Behind the scenes, the :func:`pointer` function does more than simply create " "pointer instances, it has to create pointer *types* first. This is done with " @@ -845,23 +845,23 @@ msgid "" "returns a new type::" msgstr "" -#: library/ctypes.rst:829 +#: library/ctypes.rst:828 msgid "" "Calling the pointer type without an argument creates a ``NULL`` pointer. " "``NULL`` pointers have a ``False`` boolean value::" msgstr "" -#: library/ctypes.rst:837 +#: library/ctypes.rst:836 msgid "" ":mod:`ctypes` checks for ``NULL`` when dereferencing pointers (but " "dereferencing invalid non-\\ ``NULL`` pointers would crash Python)::" msgstr "" -#: library/ctypes.rst:856 +#: library/ctypes.rst:855 msgid "Type conversions" msgstr "" -#: library/ctypes.rst:858 +#: library/ctypes.rst:857 msgid "" "Usually, ctypes does strict type checking. This means, if you have " "``POINTER(c_int)`` in the :attr:`~_FuncPtr.argtypes` list of a function or " @@ -872,7 +872,7 @@ msgid "" "ctypes accepts an array of c_int::" msgstr "" -#: library/ctypes.rst:879 +#: library/ctypes.rst:878 msgid "" "In addition, if a function argument is explicitly declared to be a pointer " "type (such as ``POINTER(c_int)``) in :attr:`~_FuncPtr.argtypes`, an object " @@ -881,11 +881,11 @@ msgid "" "automatically." msgstr "" -#: library/ctypes.rst:884 +#: library/ctypes.rst:883 msgid "To set a POINTER type field to ``NULL``, you can assign ``None``::" msgstr "" -#: library/ctypes.rst:891 +#: library/ctypes.rst:890 msgid "" "Sometimes you have instances of incompatible types. In C, you can cast one " "type into another type. :mod:`ctypes` provides a :func:`cast` function " @@ -894,11 +894,11 @@ msgid "" "``values`` field, but not instances of other types::" msgstr "" -#: library/ctypes.rst:903 +#: library/ctypes.rst:902 msgid "For these cases, the :func:`cast` function is handy." msgstr "" -#: library/ctypes.rst:905 +#: library/ctypes.rst:904 msgid "" "The :func:`cast` function can be used to cast a ctypes instance into a " "pointer to a different ctypes data type. :func:`cast` takes two parameters, " @@ -907,60 +907,60 @@ msgid "" "references the same memory block as the first argument::" msgstr "" -#: library/ctypes.rst:916 +#: library/ctypes.rst:915 msgid "" "So, :func:`cast` can be used to assign to the ``values`` field of ``Bar`` " "the structure::" msgstr "" -#: library/ctypes.rst:929 +#: library/ctypes.rst:928 msgid "Incomplete Types" msgstr "" -#: library/ctypes.rst:931 +#: library/ctypes.rst:930 msgid "" "*Incomplete Types* are structures, unions or arrays whose members are not " "yet specified. In C, they are specified by forward declarations, which are " "defined later::" msgstr "" -#: library/ctypes.rst:942 +#: library/ctypes.rst:941 msgid "" "The straightforward translation into ctypes code would be this, but it does " "not work::" msgstr "" -#: library/ctypes.rst:955 +#: library/ctypes.rst:954 msgid "" "because the new ``class cell`` is not available in the class statement " "itself. In :mod:`ctypes`, we can define the ``cell`` class and set the :attr:" "`~Structure._fields_` attribute later, after the class statement::" msgstr "" -#: library/ctypes.rst:967 +#: library/ctypes.rst:966 msgid "" "Let's try it. We create two instances of ``cell``, and let them point to " "each other, and finally follow the pointer chain a few times::" msgstr "" -#: library/ctypes.rst:988 +#: library/ctypes.rst:987 msgid "Callback functions" msgstr "" -#: library/ctypes.rst:990 +#: library/ctypes.rst:989 msgid "" ":mod:`ctypes` allows creating C callable function pointers from Python " "callables. These are sometimes called *callback functions*." msgstr "" -#: library/ctypes.rst:993 +#: library/ctypes.rst:992 msgid "" "First, you must create a class for the callback function. The class knows " "the calling convention, the return type, and the number and types of " "arguments this function will receive." msgstr "" -#: library/ctypes.rst:997 +#: library/ctypes.rst:996 msgid "" "The :func:`CFUNCTYPE` factory function creates types for callback functions " "using the ``cdecl`` calling convention. On Windows, the :func:`WINFUNCTYPE` " @@ -968,21 +968,21 @@ msgid "" "calling convention." msgstr "" -#: library/ctypes.rst:1002 +#: library/ctypes.rst:1001 msgid "" "Both of these factory functions are called with the result type as first " "argument, and the callback functions expected argument types as the " "remaining arguments." msgstr "" -#: library/ctypes.rst:1006 +#: library/ctypes.rst:1005 msgid "" "I will present an example here which uses the standard C library's :c:func:`!" "qsort` function, that is used to sort items with the help of a callback " "function. :c:func:`!qsort` will be used to sort an array of integers::" msgstr "" -#: library/ctypes.rst:1016 +#: library/ctypes.rst:1015 msgid "" ":func:`!qsort` must be called with a pointer to the data to sort, the number " "of items in the data array, the size of one item, and a pointer to the " @@ -992,44 +992,44 @@ msgid "" "otherwise." msgstr "" -#: library/ctypes.rst:1022 +#: library/ctypes.rst:1021 msgid "" "So our callback function receives pointers to integers, and must return an " "integer. First we create the ``type`` for the callback function::" msgstr "" -#: library/ctypes.rst:1028 +#: library/ctypes.rst:1027 msgid "" "To get started, here is a simple callback that shows the values it gets " "passed::" msgstr "" -#: library/ctypes.rst:1038 +#: library/ctypes.rst:1037 msgid "The result::" msgstr "" -#: library/ctypes.rst:1048 +#: library/ctypes.rst:1047 msgid "Now we can actually compare the two items and return a useful result::" msgstr "" -#: library/ctypes.rst:1063 +#: library/ctypes.rst:1062 msgid "As we can easily check, our array is sorted now::" msgstr "" -#: library/ctypes.rst:1070 +#: library/ctypes.rst:1069 msgid "" "The function factories can be used as decorator factories, so we may as well " "write::" msgstr "" -#: library/ctypes.rst:1088 +#: library/ctypes.rst:1087 msgid "" "Make sure you keep references to :func:`CFUNCTYPE` objects as long as they " "are used from C code. :mod:`ctypes` doesn't, and if you don't, they may be " "garbage collected, crashing your program when a callback is made." msgstr "" -#: library/ctypes.rst:1092 +#: library/ctypes.rst:1091 msgid "" "Also, note that if the callback function is called in a thread created " "outside of Python's control (e.g. by the foreign code that calls the " @@ -1039,35 +1039,35 @@ msgid "" "even when those calls are made from the same C thread." msgstr "" -#: library/ctypes.rst:1102 +#: library/ctypes.rst:1101 msgid "Accessing values exported from dlls" msgstr "" -#: library/ctypes.rst:1104 +#: library/ctypes.rst:1103 msgid "" "Some shared libraries not only export functions, they also export variables. " "An example in the Python library itself is the :c:data:`Py_Version`, Python " "runtime version number encoded in a single constant integer." msgstr "" -#: library/ctypes.rst:1108 +#: library/ctypes.rst:1107 msgid "" ":mod:`ctypes` can access values like this with the :meth:`~_CData.in_dll` " "class methods of the type. *pythonapi* is a predefined symbol giving access " "to the Python C api::" msgstr "" -#: library/ctypes.rst:1116 +#: library/ctypes.rst:1115 msgid "" "An extended example which also demonstrates the use of pointers accesses " "the :c:data:`PyImport_FrozenModules` pointer exported by Python." msgstr "" -#: library/ctypes.rst:1119 +#: library/ctypes.rst:1118 msgid "Quoting the docs for that value:" msgstr "" -#: library/ctypes.rst:1121 +#: library/ctypes.rst:1120 msgid "" "This pointer is initialized to point to an array of :c:struct:`_frozen` " "records, terminated by one whose members are all ``NULL`` or zero. When a " @@ -1076,19 +1076,19 @@ msgid "" "frozen modules." msgstr "" -#: library/ctypes.rst:1126 +#: library/ctypes.rst:1125 msgid "" "So manipulating this pointer could even prove useful. To restrict the " "example size, we show only how this table can be read with :mod:`ctypes`::" msgstr "" -#: library/ctypes.rst:1140 +#: library/ctypes.rst:1139 msgid "" "We have defined the :c:struct:`_frozen` data type, so we can get the pointer " "to the table::" msgstr "" -#: library/ctypes.rst:1147 +#: library/ctypes.rst:1146 msgid "" "Since ``table`` is a ``pointer`` to the array of ``struct_frozen`` records, " "we can iterate over it, but we just have to make sure that our loop " @@ -1097,34 +1097,34 @@ msgid "" "the loop when we hit the ``NULL`` entry::" msgstr "" -#: library/ctypes.rst:1163 +#: library/ctypes.rst:1162 msgid "" "The fact that standard Python has a frozen module and a frozen package " "(indicated by the negative ``size`` member) is not well known, it is only " "used for testing. Try it out with ``import __hello__`` for example." msgstr "" -#: library/ctypes.rst:1171 +#: library/ctypes.rst:1170 msgid "Surprises" msgstr "" -#: library/ctypes.rst:1173 +#: library/ctypes.rst:1172 msgid "" "There are some edges in :mod:`ctypes` where you might expect something other " "than what actually happens." msgstr "" -#: library/ctypes.rst:1176 +#: library/ctypes.rst:1175 msgid "Consider the following example::" msgstr "" -#: library/ctypes.rst:1196 +#: library/ctypes.rst:1195 msgid "" "Hm. We certainly expected the last statement to print ``3 4 1 2``. What " "happened? Here are the steps of the ``rc.a, rc.b = rc.b, rc.a`` line above::" msgstr "" -#: library/ctypes.rst:1204 +#: library/ctypes.rst:1203 msgid "" "Note that ``temp0`` and ``temp1`` are objects still using the internal " "buffer of the ``rc`` object above. So executing ``rc.a = temp0`` copies the " @@ -1133,26 +1133,26 @@ msgid "" "have the expected effect." msgstr "" -#: library/ctypes.rst:1210 +#: library/ctypes.rst:1209 msgid "" "Keep in mind that retrieving sub-objects from Structure, Unions, and Arrays " "doesn't *copy* the sub-object, instead it retrieves a wrapper object " "accessing the root-object's underlying buffer." msgstr "" -#: library/ctypes.rst:1214 +#: library/ctypes.rst:1213 msgid "" "Another example that may behave differently from what one would expect is " "this::" msgstr "" -#: library/ctypes.rst:1226 +#: library/ctypes.rst:1225 msgid "" "Objects instantiated from :class:`c_char_p` can only have their value set to " "bytes or integers." msgstr "" -#: library/ctypes.rst:1229 +#: library/ctypes.rst:1228 msgid "" "Why is it printing ``False``? ctypes instances are objects containing a " "memory block plus some :term:`descriptor`\\s accessing the contents of the " @@ -1161,16 +1161,16 @@ msgid "" "the contents again constructs a new Python object each time!" msgstr "" -#: library/ctypes.rst:1239 +#: library/ctypes.rst:1238 msgid "Variable-sized data types" msgstr "" -#: library/ctypes.rst:1241 +#: library/ctypes.rst:1240 msgid "" ":mod:`ctypes` provides some support for variable-sized arrays and structures." msgstr "" -#: library/ctypes.rst:1243 +#: library/ctypes.rst:1242 msgid "" "The :func:`resize` function can be used to resize the memory buffer of an " "existing ctypes object. The function takes the object as first argument, " @@ -1179,35 +1179,35 @@ msgid "" "objects type, a :exc:`ValueError` is raised if this is tried::" msgstr "" -#: library/ctypes.rst:1263 +#: library/ctypes.rst:1262 msgid "" "This is nice and fine, but how would one access the additional elements " "contained in this array? Since the type still only knows about 4 elements, " "we get errors accessing other elements::" msgstr "" -#: library/ctypes.rst:1275 +#: library/ctypes.rst:1274 msgid "" "Another way to use variable-sized data types with :mod:`ctypes` is to use " "the dynamic nature of Python, and (re-)define the data type after the " "required size is already known, on a case by case basis." msgstr "" -#: library/ctypes.rst:1283 +#: library/ctypes.rst:1282 msgid "ctypes reference" msgstr "" -#: library/ctypes.rst:1289 +#: library/ctypes.rst:1288 msgid "Finding shared libraries" msgstr "" -#: library/ctypes.rst:1291 +#: library/ctypes.rst:1290 msgid "" "When programming in a compiled language, shared libraries are accessed when " "compiling/linking a program, and when the program is run." msgstr "" -#: library/ctypes.rst:1294 +#: library/ctypes.rst:1293 msgid "" "The purpose of the :func:`~ctypes.util.find_library` function is to locate a " "library in a way similar to what the compiler or runtime loader does (on " @@ -1216,13 +1216,13 @@ msgid "" "and call the runtime loader directly." msgstr "" -#: library/ctypes.rst:1300 +#: library/ctypes.rst:1299 msgid "" "The :mod:`!ctypes.util` module provides a function which can help to " "determine the library to load." msgstr "" -#: library/ctypes.rst:1308 +#: library/ctypes.rst:1307 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 " @@ -1230,36 +1230,36 @@ msgid "" "If no library can be found, returns ``None``." msgstr "" -#: library/ctypes.rst:1973 +#: library/ctypes.rst:1972 msgid "The exact functionality is system dependent." msgstr "" -#: library/ctypes.rst:1315 +#: library/ctypes.rst:1314 msgid "" "On Linux, :func:`~ctypes.util.find_library` tries to run external programs " "(``/sbin/ldconfig``, ``gcc``, ``objdump`` and ``ld``) to find the library " "file. It returns the filename of the library file." msgstr "" -#: library/ctypes.rst:1319 +#: library/ctypes.rst:1318 msgid "" "On Linux, the value of the environment variable ``LD_LIBRARY_PATH`` is used " "when searching for libraries, if a library cannot be found by any other " "means." msgstr "" -#: library/ctypes.rst:1323 +#: library/ctypes.rst:1322 msgid "Here are some examples::" msgstr "" -#: library/ctypes.rst:1334 +#: library/ctypes.rst:1333 msgid "" "On macOS, :func:`~ctypes.util.find_library` tries several predefined naming " "schemes and paths to locate the library, and returns a full pathname if " "successful::" msgstr "" -#: library/ctypes.rst:1348 +#: library/ctypes.rst:1347 msgid "" "On Windows, :func:`~ctypes.util.find_library` searches along the system " "search path, and returns the full pathname, but since there is no predefined " @@ -1267,7 +1267,7 @@ msgid "" "``None``." msgstr "" -#: library/ctypes.rst:1352 +#: library/ctypes.rst:1351 msgid "" "If wrapping a shared library with :mod:`ctypes`, it *may* be better to " "determine the shared library name at development time, and hardcode that " @@ -1275,24 +1275,24 @@ msgid "" "to locate the library at runtime." msgstr "" -#: library/ctypes.rst:1360 +#: library/ctypes.rst:1359 msgid "Loading shared libraries" msgstr "" -#: library/ctypes.rst:1362 +#: library/ctypes.rst:1361 msgid "" "There are several ways to load shared libraries into the Python process. " "One way is to instantiate one of the following classes:" msgstr "" -#: library/ctypes.rst:1368 +#: library/ctypes.rst:1367 msgid "" "Instances of this class represent loaded shared libraries. Functions in " "these libraries use the standard C calling convention, and are assumed to " "return :c:expr:`int`." msgstr "" -#: library/ctypes.rst:1372 +#: library/ctypes.rst:1371 msgid "" "On Windows creating a :class:`CDLL` instance may fail even if the DLL name " "exists. When a dependent DLL of the loaded DLL is not found, a :exc:" @@ -1304,17 +1304,17 @@ msgid "" "determine which one is not found using Windows debugging and tracing tools." msgstr "" -#: library/ctypes.rst:1407 library/ctypes.rst:1435 +#: library/ctypes.rst:1406 library/ctypes.rst:1434 msgid "The *name* parameter can now be a :term:`path-like object`." msgstr "" -#: library/ctypes.rst:1388 +#: library/ctypes.rst:1387 msgid "" "`Microsoft DUMPBIN tool `_ -- A tool to find DLL dependents." msgstr "" -#: library/ctypes.rst:1394 +#: 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 " @@ -1324,26 +1324,26 @@ msgid "" "value signals a failure, an :class:`OSError` is automatically raised." msgstr "" -#: library/ctypes.rst:1401 +#: library/ctypes.rst:1400 msgid "" ":exc:`WindowsError` used to be raised, which is now an alias of :exc:" "`OSError`." msgstr "" -#: library/ctypes.rst:1412 +#: library/ctypes.rst:1411 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." msgstr "" -#: library/ctypes.rst:1420 +#: library/ctypes.rst:1419 msgid "" "The Python :term:`global interpreter lock` is released before calling any " "function exported by these libraries, and reacquired afterwards." msgstr "" -#: library/ctypes.rst:1426 +#: library/ctypes.rst:1425 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 " @@ -1351,11 +1351,11 @@ msgid "" "set, a Python exception is raised." msgstr "" -#: library/ctypes.rst:1431 +#: library/ctypes.rst:1430 msgid "Thus, this is only useful to call Python C api functions directly." msgstr "" -#: library/ctypes.rst:1437 +#: library/ctypes.rst:1436 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 " @@ -1365,7 +1365,7 @@ msgid "" "the process, and to get a handle to it." msgstr "" -#: library/ctypes.rst:1444 +#: library/ctypes.rst:1443 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 " @@ -1373,7 +1373,7 @@ msgid "" "configurable." msgstr "" -#: library/ctypes.rst:1449 +#: library/ctypes.rst:1448 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:" @@ -1383,14 +1383,14 @@ msgid "" "private copy, the same happens immediately after the function call." msgstr "" -#: library/ctypes.rst:1456 +#: library/ctypes.rst:1455 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:1460 +#: library/ctypes.rst:1459 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 :" @@ -1399,7 +1399,7 @@ msgid "" "private copy of the windows error code." msgstr "" -#: library/ctypes.rst:1466 +#: library/ctypes.rst:1465 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 " @@ -1409,29 +1409,29 @@ msgid "" "ensure the correct library and dependencies are loaded." msgstr "" -#: library/ctypes.rst:1473 +#: library/ctypes.rst:1472 msgid "Added *winmode* parameter." msgstr "" -#: library/ctypes.rst:1480 +#: library/ctypes.rst:1479 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:1487 +#: library/ctypes.rst:1486 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:1494 +#: library/ctypes.rst:1493 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:1497 +#: library/ctypes.rst:1496 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 " @@ -1440,21 +1440,21 @@ msgid "" "other hand, accessing it through an index returns a new object each time::" msgstr "" -#: library/ctypes.rst:1510 +#: library/ctypes.rst:1509 msgid "" "The following public attributes are available, their name starts with an " "underscore to not clash with exported function names:" msgstr "" -#: library/ctypes.rst:1516 +#: library/ctypes.rst:1515 msgid "The system handle used to access the library." msgstr "" -#: library/ctypes.rst:1521 +#: library/ctypes.rst:1520 msgid "The name of the library passed in the constructor." msgstr "" -#: library/ctypes.rst:1523 +#: library/ctypes.rst:1522 msgid "" "Shared libraries can also be loaded by using one of the prefabricated " "objects, which are instances of the :class:`LibraryLoader` class, either by " @@ -1462,13 +1462,13 @@ msgid "" "library as attribute of the loader instance." msgstr "" -#: library/ctypes.rst:1531 +#: library/ctypes.rst:1530 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:1534 +#: library/ctypes.rst:1533 msgid "" ":meth:`!__getattr__` has special behavior: It allows loading a shared " "library by accessing it as attribute of a library loader instance. The " @@ -1476,39 +1476,39 @@ msgid "" "each time." msgstr "" -#: library/ctypes.rst:1540 +#: library/ctypes.rst:1539 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:1544 +#: library/ctypes.rst:1543 msgid "These prefabricated library loaders are available:" msgstr "" -#: library/ctypes.rst:1549 +#: library/ctypes.rst:1548 msgid "Creates :class:`CDLL` instances." msgstr "" -#: library/ctypes.rst:1555 +#: library/ctypes.rst:1554 msgid "Windows only: Creates :class:`WinDLL` instances." msgstr "" -#: library/ctypes.rst:1561 +#: library/ctypes.rst:1560 msgid "Windows only: Creates :class:`OleDLL` instances." msgstr "" -#: library/ctypes.rst:1567 +#: library/ctypes.rst:1566 msgid "Creates :class:`PyDLL` instances." msgstr "" -#: library/ctypes.rst:1570 +#: library/ctypes.rst:1569 msgid "" "For accessing the C Python api directly, a ready-to-use Python shared " "library object is available:" msgstr "" -#: library/ctypes.rst:1576 +#: library/ctypes.rst:1575 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:" @@ -1516,50 +1516,50 @@ msgid "" "correct :attr:`!restype` attribute to use these functions." msgstr "" -#: library/ctypes.rst:1581 +#: library/ctypes.rst:1580 msgid "" "Raises an :ref:`auditing event ` ``ctypes.dlopen`` with argument " "``name``." msgstr "" -#: library/ctypes.rst:1583 +#: library/ctypes.rst:1582 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:1587 +#: library/ctypes.rst:1586 msgid "" "Raises an :ref:`auditing event ` ``ctypes.dlsym`` with arguments " "``library``, ``name``." msgstr "" -#: library/ctypes.rst:1589 +#: library/ctypes.rst:1588 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:1593 +#: library/ctypes.rst:1592 msgid "" "Raises an :ref:`auditing event ` ``ctypes.dlsym/handle`` with " "arguments ``handle``, ``name``." msgstr "" -#: library/ctypes.rst:1595 +#: library/ctypes.rst:1594 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:1602 +#: library/ctypes.rst:1601 msgid "Foreign functions" msgstr "" -#: library/ctypes.rst:1604 +#: library/ctypes.rst:1603 msgid "" "As explained in the previous section, foreign functions can be accessed as " "attributes of loaded shared libraries. The function objects created in this " @@ -1568,29 +1568,29 @@ msgid "" "library loader. They are instances of a private class:" msgstr "" -#: library/ctypes.rst:1613 +#: library/ctypes.rst:1612 msgid "Base class for C callable foreign functions." msgstr "" -#: library/ctypes.rst:1615 +#: library/ctypes.rst:1614 msgid "" "Instances of foreign functions are also C compatible data types; they " "represent C function pointers." msgstr "" -#: library/ctypes.rst:1618 +#: library/ctypes.rst:1617 msgid "" "This behavior can be customized by assigning to special attributes of the " "foreign function object." msgstr "" -#: library/ctypes.rst:1623 +#: library/ctypes.rst:1622 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:1626 +#: library/ctypes.rst:1625 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 " @@ -1600,7 +1600,7 @@ msgid "" "callable to the :attr:`errcheck` attribute." msgstr "" -#: library/ctypes.rst:1635 +#: library/ctypes.rst:1634 msgid "" "Assign a tuple of ctypes types to specify the argument types that the " "function accepts. Functions using the ``stdcall`` calling convention can " @@ -1609,7 +1609,7 @@ msgid "" "unspecified arguments as well." msgstr "" -#: library/ctypes.rst:1641 +#: library/ctypes.rst:1640 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` " @@ -1619,7 +1619,7 @@ msgid "" "object using ctypes conversion rules." msgstr "" -#: library/ctypes.rst:1648 +#: library/ctypes.rst:1647 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 " @@ -1627,50 +1627,50 @@ msgid "" "defining adapters that can adapt custom objects as function parameters." msgstr "" -#: library/ctypes.rst:1655 +#: library/ctypes.rst:1654 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:1662 +#: library/ctypes.rst:1661 msgid "" "*result* is what the foreign function returns, as specified by the :attr:`!" "restype` attribute." msgstr "" -#: library/ctypes.rst:1665 +#: library/ctypes.rst:1664 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:1669 +#: library/ctypes.rst:1668 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:1673 +#: library/ctypes.rst:1672 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:1680 +#: library/ctypes.rst:1679 msgid "" "This exception is raised when a foreign function call cannot convert one of " "the passed arguments." msgstr "" -#: library/ctypes.rst:1684 +#: library/ctypes.rst:1683 msgid "" "Raises an :ref:`auditing event ` ``ctypes.set_exception`` with " "argument ``code``." msgstr "" -#: library/ctypes.rst:1686 +#: library/ctypes.rst:1685 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 " @@ -1679,24 +1679,24 @@ msgid "" "hook to replace the exception with its own." msgstr "" -#: library/ctypes.rst:1692 +#: library/ctypes.rst:1691 msgid "" "Raises an :ref:`auditing event ` ``ctypes.call_function`` with " "arguments ``func_pointer``, ``arguments``." msgstr "" -#: library/ctypes.rst:1694 +#: library/ctypes.rst:1693 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:1700 +#: library/ctypes.rst:1699 msgid "Function prototypes" msgstr "" -#: library/ctypes.rst:1702 +#: library/ctypes.rst:1701 msgid "" "Foreign functions can also be created by instantiating function prototypes. " "Function prototypes are similar to function prototypes in C; they describe a " @@ -1707,7 +1707,7 @@ msgid "" "``@wrapper`` syntax. See :ref:`ctypes-callback-functions` for examples." msgstr "" -#: library/ctypes.rst:1713 +#: library/ctypes.rst:1712 msgid "" "The returned function prototype creates functions that use the standard C " "calling convention. The function will release the GIL during the call. If " @@ -1716,37 +1716,37 @@ msgid "" "after the call; *use_last_error* does the same for the Windows error code." msgstr "" -#: library/ctypes.rst:1723 +#: library/ctypes.rst:1722 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." msgstr "" -#: library/ctypes.rst:1731 +#: library/ctypes.rst:1730 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:1734 +#: library/ctypes.rst:1733 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:1741 +#: library/ctypes.rst:1740 msgid "" "Returns a foreign function at the specified address which must be an integer." msgstr "" -#: library/ctypes.rst:1748 +#: library/ctypes.rst:1747 msgid "" "Create a C callable function (a callback function) from a Python *callable*." msgstr "" -#: library/ctypes.rst:1755 +#: library/ctypes.rst:1754 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 " @@ -1754,7 +1754,7 @@ msgid "" "small integer. The second item is the shared library instance." msgstr "" -#: library/ctypes.rst:1765 +#: library/ctypes.rst:1764 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* " @@ -1762,87 +1762,87 @@ msgid "" "identifier which is used in extended error reporting." msgstr "" -#: library/ctypes.rst:1770 +#: library/ctypes.rst:1769 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:1774 +#: library/ctypes.rst:1773 msgid "" "The optional *paramflags* parameter creates foreign function wrappers with " "much more functionality than the features described above." msgstr "" -#: library/ctypes.rst:1777 +#: library/ctypes.rst:1776 msgid "" "*paramflags* must be a tuple of the same length as :attr:`~_FuncPtr." "argtypes`." msgstr "" -#: library/ctypes.rst:1779 +#: library/ctypes.rst:1778 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:1782 +#: library/ctypes.rst:1781 msgid "" "The first item is an integer containing a combination of direction flags for " "the parameter:" msgstr "" -#: library/ctypes.rst:1786 +#: library/ctypes.rst:1785 msgid "1" msgstr "" -#: library/ctypes.rst:1786 +#: library/ctypes.rst:1785 msgid "Specifies an input parameter to the function." msgstr "" -#: library/ctypes.rst:1789 +#: library/ctypes.rst:1788 msgid "2" msgstr "" -#: library/ctypes.rst:1789 +#: library/ctypes.rst:1788 msgid "Output parameter. The foreign function fills in a value." msgstr "" -#: library/ctypes.rst:1792 +#: library/ctypes.rst:1791 msgid "4" msgstr "" -#: library/ctypes.rst:1792 +#: library/ctypes.rst:1791 msgid "Input parameter which defaults to the integer zero." msgstr "" -#: library/ctypes.rst:1794 +#: library/ctypes.rst:1793 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:1797 +#: library/ctypes.rst:1796 msgid "The optional third item is the default value for this parameter." msgstr "" -#: library/ctypes.rst:1800 +#: library/ctypes.rst:1799 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:1834 +#: library/ctypes.rst:1833 msgid "Here is the wrapping with :mod:`ctypes`::" msgstr "" -#: library/ctypes.rst:1819 +#: library/ctypes.rst:1818 msgid "The ``MessageBox`` foreign function can now be called in these ways::" msgstr "" -#: library/ctypes.rst:1825 +#: library/ctypes.rst:1824 msgid "" "A second example demonstrates output parameters. The win32 " "``GetWindowRect`` function retrieves the dimensions of a specified window by " @@ -1850,7 +1850,7 @@ msgid "" "the C declaration::" msgstr "" -#: library/ctypes.rst:1843 +#: library/ctypes.rst:1842 msgid "" "Functions with output parameters will automatically return the output " "parameter value if there is a single one, or a tuple containing the output " @@ -1858,7 +1858,7 @@ msgid "" "now returns a RECT instance, when called." msgstr "" -#: library/ctypes.rst:1848 +#: library/ctypes.rst:1847 msgid "" "Output parameters can be combined with the :attr:`~_FuncPtr.errcheck` " "protocol to do further output processing and error checking. The win32 " @@ -1867,7 +1867,7 @@ msgid "" "exception when the api call failed::" msgstr "" -#: library/ctypes.rst:1861 +#: library/ctypes.rst:1860 msgid "" "If the :attr:`~_FuncPtr.errcheck` function returns the argument tuple it " "receives unchanged, :mod:`ctypes` continues the normal processing it does on " @@ -1876,46 +1876,46 @@ msgid "" "and return them instead, the normal processing will no longer take place::" msgstr "" -#: library/ctypes.rst:1880 +#: library/ctypes.rst:1879 msgid "Utility functions" msgstr "" -#: library/ctypes.rst:1884 +#: library/ctypes.rst:1883 msgid "" "Returns the address of the memory buffer as integer. *obj* must be an " "instance of a ctypes type." msgstr "" -#: library/ctypes.rst:1887 +#: library/ctypes.rst:1886 msgid "" "Raises an :ref:`auditing event ` ``ctypes.addressof`` with " "argument ``obj``." msgstr "" -#: library/ctypes.rst:1892 +#: library/ctypes.rst:1891 msgid "" "Returns the alignment requirements of a ctypes type. *obj_or_type* must be a " "ctypes type or instance." msgstr "" -#: library/ctypes.rst:1898 +#: library/ctypes.rst:1897 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:1902 +#: library/ctypes.rst:1901 msgid "``byref(obj, offset)`` corresponds to this C code::" msgstr "" -#: library/ctypes.rst:1906 +#: library/ctypes.rst:1905 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:1912 +#: library/ctypes.rst:1911 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* " @@ -1923,19 +1923,19 @@ msgid "" "as a pointer." msgstr "" -#: library/ctypes.rst:1920 +#: library/ctypes.rst:1919 msgid "" "This function creates a mutable character buffer. The returned object is a " "ctypes array of :class:`c_char`." msgstr "" -#: library/ctypes.rst:1923 +#: library/ctypes.rst:1922 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:1926 +#: library/ctypes.rst:1925 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 " @@ -1944,25 +1944,25 @@ msgid "" "not be used." msgstr "" -#: library/ctypes.rst:1931 +#: library/ctypes.rst:1930 msgid "" "Raises an :ref:`auditing event ` ``ctypes.create_string_buffer`` " "with arguments ``init``, ``size``." msgstr "" -#: library/ctypes.rst:1936 +#: library/ctypes.rst:1935 msgid "" "This function creates a mutable unicode character buffer. The returned " "object is a ctypes array of :class:`c_wchar`." msgstr "" -#: library/ctypes.rst:1939 +#: library/ctypes.rst:1938 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:1942 +#: library/ctypes.rst:1941 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 " @@ -1971,27 +1971,27 @@ msgid "" "should not be used." msgstr "" -#: library/ctypes.rst:1948 +#: library/ctypes.rst:1947 msgid "" "Raises an :ref:`auditing event ` ``ctypes.create_unicode_buffer`` " "with arguments ``init``, ``size``." msgstr "" -#: library/ctypes.rst:1953 +#: library/ctypes.rst:1952 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." msgstr "" -#: library/ctypes.rst:1960 +#: library/ctypes.rst:1959 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." msgstr "" -#: library/ctypes.rst:1968 +#: library/ctypes.rst:1967 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 " @@ -1999,92 +1999,92 @@ msgid "" "If no library can be found, returns ``None``." msgstr "" -#: library/ctypes.rst:1979 +#: library/ctypes.rst:1978 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." msgstr "" -#: library/ctypes.rst:1983 +#: library/ctypes.rst:1982 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:1990 +#: library/ctypes.rst:1989 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." msgstr "" -#: library/ctypes.rst:1997 +#: library/ctypes.rst:1996 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." msgstr "" -#: library/ctypes.rst:2003 +#: library/ctypes.rst:2002 msgid "" "Returns the current value of the ctypes-private copy of the system :data:" "`errno` variable in the calling thread." msgstr "" -#: library/ctypes.rst:2006 +#: library/ctypes.rst:2005 msgid "" "Raises an :ref:`auditing event ` ``ctypes.get_errno`` with no " "arguments." msgstr "" -#: library/ctypes.rst:2010 +#: library/ctypes.rst:2009 msgid "" "Windows only: returns the current value of the ctypes-private copy of the " "system :data:`!LastError` variable in the calling thread." msgstr "" -#: library/ctypes.rst:2013 +#: library/ctypes.rst:2012 msgid "" "Raises an :ref:`auditing event ` ``ctypes.get_last_error`` with no " "arguments." msgstr "" -#: library/ctypes.rst:2017 +#: library/ctypes.rst:2016 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:2024 +#: library/ctypes.rst:2023 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:2031 +#: library/ctypes.rst:2030 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:2038 +#: library/ctypes.rst:2037 msgid "" "Create a new pointer instance, pointing to *obj*. The returned object is of " "the type ``POINTER(type(obj))``." msgstr "" -#: library/ctypes.rst:2041 +#: library/ctypes.rst:2040 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:2047 +#: library/ctypes.rst:2046 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 " @@ -2092,51 +2092,51 @@ msgid "" "but it is possible to enlarge the buffer." msgstr "" -#: library/ctypes.rst:2055 +#: library/ctypes.rst:2054 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:2058 +#: library/ctypes.rst:2057 msgid "" "Raises an :ref:`auditing event ` ``ctypes.set_errno`` with " "argument ``errno``." msgstr "" -#: library/ctypes.rst:2063 +#: library/ctypes.rst:2062 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." msgstr "" -#: library/ctypes.rst:2067 +#: library/ctypes.rst:2066 msgid "" "Raises an :ref:`auditing event ` ``ctypes.set_last_error`` with " "argument ``error``." msgstr "" -#: library/ctypes.rst:2072 +#: library/ctypes.rst:2071 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:2078 +#: library/ctypes.rst:2077 msgid "" "This function returns the C string starting at memory address *address* as a " "bytes object. If size is specified, it is used as size, otherwise the string " "is assumed to be zero-terminated." msgstr "" -#: library/ctypes.rst:2082 +#: library/ctypes.rst:2081 msgid "" "Raises an :ref:`auditing event ` ``ctypes.string_at`` with " "arguments ``address``, ``size``." msgstr "" -#: library/ctypes.rst:2087 +#: library/ctypes.rst:2086 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, " @@ -2145,13 +2145,13 @@ msgid "" "error." msgstr "" -#: library/ctypes.rst:2093 +#: library/ctypes.rst:2092 msgid "" "An instance of :exc:`WindowsError` used to be created, which is now an alias " "of :exc:`OSError`." msgstr "" -#: library/ctypes.rst:2100 +#: library/ctypes.rst:2099 msgid "" "This function returns the wide character string starting at memory address " "*address* as a string. If *size* is specified, it is used as the number of " @@ -2159,17 +2159,17 @@ msgid "" "terminated." msgstr "" -#: library/ctypes.rst:2105 +#: library/ctypes.rst:2104 msgid "" "Raises an :ref:`auditing event ` ``ctypes.wstring_at`` with " "arguments ``address``, ``size``." msgstr "" -#: library/ctypes.rst:2111 +#: library/ctypes.rst:2110 msgid "Data types" msgstr "" -#: library/ctypes.rst:2116 +#: library/ctypes.rst:2115 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 " @@ -2179,13 +2179,13 @@ msgid "" "alive in case the memory block contains pointers." msgstr "" -#: library/ctypes.rst:2123 +#: library/ctypes.rst:2122 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:2128 +#: library/ctypes.rst:2127 msgid "" "This method returns a ctypes instance that shares the buffer of the *source* " "object. The *source* object must support the writeable buffer interface. " @@ -2194,13 +2194,13 @@ msgid "" "exc:`ValueError` is raised." msgstr "" -#: library/ctypes.rst:2144 +#: library/ctypes.rst:2143 msgid "" "Raises an :ref:`auditing event ` ``ctypes.cdata/buffer`` with " "arguments ``pointer``, ``size``, ``offset``." msgstr "" -#: library/ctypes.rst:2138 +#: library/ctypes.rst:2137 msgid "" "This method creates a ctypes instance, copying the buffer from the *source* " "object buffer which must be readable. The optional *offset* parameter " @@ -2208,25 +2208,25 @@ msgid "" "If the source buffer is not large enough a :exc:`ValueError` is raised." msgstr "" -#: library/ctypes.rst:2148 +#: library/ctypes.rst:2147 msgid "" "This method returns a ctypes type instance using the memory specified by " "*address* which must be an integer." msgstr "" -#: library/ctypes.rst:2151 +#: library/ctypes.rst:2150 msgid "" "Raises an :ref:`auditing event ` ``ctypes.cdata`` with argument " "``address``." msgstr "" -#: library/ctypes.rst:2153 +#: library/ctypes.rst:2152 msgid "" "This method, and others that indirectly call this method, raises an :ref:" "`auditing event ` ``ctypes.cdata`` with argument ``address``." msgstr "" -#: library/ctypes.rst:2159 +#: library/ctypes.rst:2158 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 " @@ -2234,25 +2234,25 @@ msgid "" "object that can be used as a function call parameter." msgstr "" -#: library/ctypes.rst:2164 +#: library/ctypes.rst:2163 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:2170 +#: library/ctypes.rst:2169 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:2174 +#: library/ctypes.rst:2173 msgid "Common instance variables of ctypes data types:" msgstr "" -#: library/ctypes.rst:2178 +#: library/ctypes.rst:2177 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:" @@ -2260,13 +2260,13 @@ msgid "" "block." msgstr "" -#: library/ctypes.rst:2185 +#: library/ctypes.rst:2184 msgid "" "This read-only variable is true when the ctypes data instance has allocated " "the memory block itself, false otherwise." msgstr "" -#: library/ctypes.rst:2190 +#: library/ctypes.rst:2189 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. " @@ -2274,7 +2274,7 @@ msgid "" "dictionary." msgstr "" -#: library/ctypes.rst:2203 +#: library/ctypes.rst:2202 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 " @@ -2283,11 +2283,11 @@ msgid "" "types that are not and do not contain pointers can now be pickled." msgstr "" -#: library/ctypes.rst:2209 +#: library/ctypes.rst:2208 msgid "Instances have a single attribute:" msgstr "" -#: library/ctypes.rst:2213 +#: library/ctypes.rst:2212 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 " @@ -2295,7 +2295,7 @@ msgid "" "bytes object or string." msgstr "" -#: library/ctypes.rst:2218 +#: library/ctypes.rst:2217 msgid "" "When the ``value`` attribute is retrieved from a ctypes instance, usually a " "new object is returned each time. :mod:`ctypes` does *not* implement " @@ -2303,7 +2303,7 @@ msgid "" "true for all other ctypes object instances." msgstr "" -#: library/ctypes.rst:2224 +#: library/ctypes.rst:2223 msgid "" "Fundamental data types, when returned as foreign function call results, or, " "for example, by retrieving structure field members or array items, are " @@ -2313,7 +2313,7 @@ msgid "" "instance." msgstr "" -#: library/ctypes.rst:2232 +#: library/ctypes.rst:2231 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 " @@ -2321,25 +2321,25 @@ msgid "" "you can get the value of the pointer by accessing the ``value`` attribute." msgstr "" -#: library/ctypes.rst:2237 +#: library/ctypes.rst:2236 msgid "These are the fundamental ctypes data types:" msgstr "" -#: library/ctypes.rst:2241 +#: library/ctypes.rst:2240 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:2248 +#: library/ctypes.rst:2247 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:2255 +#: library/ctypes.rst:2254 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 " @@ -2347,182 +2347,182 @@ msgid "" "integer address, or a bytes object." msgstr "" -#: library/ctypes.rst:2263 +#: library/ctypes.rst:2262 msgid "" "Represents the C :c:expr:`double` datatype. The constructor accepts an " "optional float initializer." msgstr "" -#: library/ctypes.rst:2269 +#: library/ctypes.rst:2268 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:2275 +#: library/ctypes.rst:2274 msgid "" "Represents the C :c:expr:`float` datatype. The constructor accepts an " "optional float initializer." msgstr "" -#: library/ctypes.rst:2281 +#: library/ctypes.rst:2280 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:2288 +#: library/ctypes.rst:2287 msgid "" "Represents the C 8-bit :c:expr:`signed int` datatype. Usually an alias for :" "class:`c_byte`." msgstr "" -#: library/ctypes.rst:2294 +#: library/ctypes.rst:2293 msgid "" "Represents the C 16-bit :c:expr:`signed int` datatype. Usually an alias " "for :class:`c_short`." msgstr "" -#: library/ctypes.rst:2300 +#: library/ctypes.rst:2299 msgid "" "Represents the C 32-bit :c:expr:`signed int` datatype. Usually an alias " "for :class:`c_int`." msgstr "" -#: library/ctypes.rst:2306 +#: library/ctypes.rst:2305 msgid "" "Represents the C 64-bit :c:expr:`signed int` datatype. Usually an alias " "for :class:`c_longlong`." msgstr "" -#: library/ctypes.rst:2312 +#: library/ctypes.rst:2311 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:2318 +#: library/ctypes.rst:2317 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:2324 +#: library/ctypes.rst:2323 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:2330 +#: library/ctypes.rst:2329 msgid "Represents the C :c:type:`size_t` datatype." msgstr "" -#: library/ctypes.rst:2335 +#: library/ctypes.rst:2334 msgid "Represents the C :c:type:`ssize_t` datatype." msgstr "" -#: library/ctypes.rst:2342 +#: library/ctypes.rst:2341 msgid "Represents the C :c:type:`time_t` datatype." msgstr "" -#: library/ctypes.rst:2349 +#: library/ctypes.rst:2348 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:2356 +#: library/ctypes.rst:2355 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:2363 +#: library/ctypes.rst:2362 msgid "" "Represents the C 8-bit :c:expr:`unsigned int` datatype. Usually an alias " "for :class:`c_ubyte`." msgstr "" -#: library/ctypes.rst:2369 +#: library/ctypes.rst:2368 msgid "" "Represents the C 16-bit :c:expr:`unsigned int` datatype. Usually an alias " "for :class:`c_ushort`." msgstr "" -#: library/ctypes.rst:2375 +#: library/ctypes.rst:2374 msgid "" "Represents the C 32-bit :c:expr:`unsigned int` datatype. Usually an alias " "for :class:`c_uint`." msgstr "" -#: library/ctypes.rst:2381 +#: library/ctypes.rst:2380 msgid "" "Represents the C 64-bit :c:expr:`unsigned int` datatype. Usually an alias " "for :class:`c_ulonglong`." msgstr "" -#: library/ctypes.rst:2387 +#: library/ctypes.rst:2386 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:2393 +#: library/ctypes.rst:2392 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:2399 +#: library/ctypes.rst:2398 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:2405 +#: library/ctypes.rst:2404 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:2411 +#: library/ctypes.rst:2410 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:2418 +#: library/ctypes.rst:2417 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:2425 +#: library/ctypes.rst:2424 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:2432 +#: library/ctypes.rst:2431 msgid "" "Windows only: Represents a :c:type:`!HRESULT` value, which contains success " "or error information for a function or method call." msgstr "" -#: library/ctypes.rst:2438 +#: library/ctypes.rst:2437 msgid "" "Represents the C :c:expr:`PyObject *` datatype. Calling this without an " "argument creates a ``NULL`` :c:expr:`PyObject *` pointer." msgstr "" -#: library/ctypes.rst:2441 +#: library/ctypes.rst:2440 msgid "" "The :mod:`!ctypes.wintypes` module provides quite some other Windows " "specific data types, for example :c:type:`!HWND`, :c:type:`!WPARAM`, or :c:" @@ -2530,41 +2530,41 @@ msgid "" "are also defined." msgstr "" -#: library/ctypes.rst:2449 +#: library/ctypes.rst:2448 msgid "Structured data types" msgstr "" -#: library/ctypes.rst:2454 +#: library/ctypes.rst:2453 msgid "Abstract base class for unions in native byte order." msgstr "" -#: library/ctypes.rst:2459 +#: library/ctypes.rst:2458 msgid "Abstract base class for unions in *big endian* byte order." msgstr "" -#: library/ctypes.rst:2465 +#: library/ctypes.rst:2464 msgid "Abstract base class for unions in *little endian* byte order." msgstr "" -#: library/ctypes.rst:2471 +#: library/ctypes.rst:2470 msgid "Abstract base class for structures in *big endian* byte order." msgstr "" -#: library/ctypes.rst:2476 +#: library/ctypes.rst:2475 msgid "Abstract base class for structures in *little endian* byte order." msgstr "" -#: library/ctypes.rst:2478 +#: library/ctypes.rst:2477 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:2484 +#: library/ctypes.rst:2483 msgid "Abstract base class for structures in *native* byte order." msgstr "" -#: library/ctypes.rst:2486 +#: library/ctypes.rst:2485 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:" @@ -2572,34 +2572,34 @@ msgid "" "the fields by direct attribute accesses. These are the" msgstr "" -#: library/ctypes.rst:2494 +#: library/ctypes.rst:2493 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:2498 +#: library/ctypes.rst:2497 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:2502 +#: library/ctypes.rst:2501 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:2505 +#: library/ctypes.rst:2504 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:2515 +#: library/ctypes.rst:2514 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, " @@ -2607,14 +2607,14 @@ msgid "" "raise an AttributeError." msgstr "" -#: library/ctypes.rst:2520 +#: library/ctypes.rst:2519 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:2527 +#: library/ctypes.rst:2526 msgid "" "An optional small integer that allows overriding the alignment of structure " "fields in the instance. :attr:`_pack_` must already be defined when :attr:" @@ -2622,14 +2622,14 @@ msgid "" "attribute to 0 is the same as not setting it at all." msgstr "" -#: library/ctypes.rst:2535 +#: library/ctypes.rst:2534 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:2539 +#: library/ctypes.rst:2538 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 " @@ -2637,11 +2637,11 @@ msgid "" "structure or union field." msgstr "" -#: library/ctypes.rst:2544 +#: library/ctypes.rst:2543 msgid "Here is an example type (Windows)::" msgstr "" -#: library/ctypes.rst:2557 +#: library/ctypes.rst:2556 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 " @@ -2651,7 +2651,7 @@ msgid "" "temporary union instance::" msgstr "" -#: library/ctypes.rst:2569 +#: library/ctypes.rst:2568 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:" @@ -2659,7 +2659,7 @@ msgid "" "of the base class." msgstr "" -#: library/ctypes.rst:2574 +#: library/ctypes.rst:2573 msgid "" "Structure and union constructors accept both positional and keyword " "arguments. Positional arguments are used to initialize member fields in the " @@ -2669,15 +2669,15 @@ msgid "" "names not present in :attr:`_fields_`." msgstr "" -#: library/ctypes.rst:2585 +#: library/ctypes.rst:2584 msgid "Arrays and pointers" msgstr "" -#: library/ctypes.rst:2589 +#: library/ctypes.rst:2588 msgid "Abstract base class for arrays." msgstr "" -#: library/ctypes.rst:2591 +#: library/ctypes.rst:2590 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 " @@ -2687,34 +2687,34 @@ msgid "" "an :class:`Array`." msgstr "" -#: library/ctypes.rst:2601 +#: library/ctypes.rst:2600 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:2608 +#: library/ctypes.rst:2607 msgid "Specifies the type of each element in the array." msgstr "" -#: library/ctypes.rst:2611 +#: library/ctypes.rst:2610 msgid "" "Array subclass constructors accept positional arguments, used to initialize " "the elements in order." msgstr "" -#: library/ctypes.rst:2617 +#: library/ctypes.rst:2616 msgid "Private, abstract base class for pointers." msgstr "" -#: library/ctypes.rst:2619 +#: library/ctypes.rst:2618 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:2623 +#: library/ctypes.rst:2622 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 :" @@ -2723,11 +2723,11 @@ msgid "" "probably crash with an access violation (if you're lucky)." msgstr "" -#: library/ctypes.rst:2633 +#: library/ctypes.rst:2632 msgid "Specifies the type pointed to." msgstr "" -#: library/ctypes.rst:2637 +#: library/ctypes.rst:2636 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/dataclasses.po b/library/dataclasses.po index 3138d3f9e..021c59a99 100644 --- a/library/dataclasses.po +++ b/library/dataclasses.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -17,7 +17,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #: library/dataclasses.rst:2 -msgid ":mod:`dataclasses` --- Data Classes" +msgid ":mod:`!dataclasses` --- Data Classes" msgstr "" #: library/dataclasses.rst:10 @@ -39,8 +39,7 @@ msgid "" msgstr "" #: library/dataclasses.rst:34 -msgid "" -"will add, among other things, a :meth:`~object.__init__` that looks like::" +msgid "will add, among other things, a :meth:`!__init__` that looks like::" msgstr "" #: library/dataclasses.rst:41 @@ -56,15 +55,15 @@ msgstr "" #: library/dataclasses.rst:51 msgid "" "This function is a :term:`decorator` that is used to add generated :term:" -"`special method`\\s to classes, as described below." +"`special methods ` to classes, as described below." msgstr "" #: library/dataclasses.rst:54 msgid "" -"The :func:`dataclass` decorator examines the class to find ``field``\\s. A " +"The ``@dataclass`` decorator examines the class to find ``field``\\s. A " "``field`` is defined as a class variable that has a :term:`type annotation " -"`. With two exceptions described below, nothing in :" -"func:`dataclass` examines the type specified in the variable annotation." +"`. With two exceptions described below, nothing in " +"``@dataclass`` examines the type specified in the variable annotation." msgstr "" #: library/dataclasses.rst:60 @@ -75,7 +74,7 @@ msgstr "" #: library/dataclasses.rst:63 msgid "" -"The :func:`dataclass` decorator will add various \"dunder\" methods to the " +"The ``@dataclass`` decorator will add various \"dunder\" methods to the " "class, described below. If any of the added methods already exist in the " "class, the behavior depends on the parameter, as documented below. The " "decorator returns the same class that it is called on; no new class is " @@ -84,13 +83,13 @@ msgstr "" #: library/dataclasses.rst:69 msgid "" -"If :func:`dataclass` is used just as a simple decorator with no parameters, " -"it acts as if it has the default values documented in this signature. That " -"is, these three uses of :func:`dataclass` are equivalent::" +"If ``@dataclass`` is used just as a simple decorator with no parameters, it " +"acts as if it has the default values documented in this signature. That is, " +"these three uses of ``@dataclass`` are equivalent::" msgstr "" #: library/dataclasses.rst:87 -msgid "The parameters to :func:`dataclass` are:" +msgid "The parameters to ``@dataclass`` are:" msgstr "" #: library/dataclasses.rst:89 @@ -101,8 +100,7 @@ msgstr "" #: library/dataclasses.rst:92 msgid "" -"If the class already defines :meth:`~object.__init__`, this parameter is " -"ignored." +"If the class already defines :meth:`!__init__`, this parameter is ignored." msgstr "" #: library/dataclasses.rst:95 @@ -117,8 +115,7 @@ msgstr "" #: library/dataclasses.rst:102 msgid "" -"If the class already defines :meth:`~object.__repr__`, this parameter is " -"ignored." +"If the class already defines :meth:`!__repr__`, this parameter is ignored." msgstr "" #: library/dataclasses.rst:105 @@ -131,8 +128,7 @@ msgstr "" #: library/dataclasses.rst:110 msgid "" -"If the class already defines :meth:`~object.__eq__`, this parameter is " -"ignored." +"If the class already defines :meth:`!__eq__`, this parameter is ignored." msgstr "" #: library/dataclasses.rst:113 @@ -147,9 +143,8 @@ msgstr "" #: library/dataclasses.rst:120 msgid "" -"If the class already defines any of :meth:`~object.__lt__`, :meth:`~object." -"__le__`, :meth:`~object.__gt__`, or :meth:`~object.__ge__`, then :exc:" -"`TypeError` is raised." +"If the class already defines any of :meth:`!__lt__`, :meth:`!__le__`, :meth:" +"`!__gt__`, or :meth:`!__ge__`, then :exc:`TypeError` is raised." msgstr "" #: library/dataclasses.rst:124 @@ -160,52 +155,50 @@ msgstr "" #: library/dataclasses.rst:127 msgid "" -":meth:`~object.__hash__` is used by built-in :meth:`hash()`, and when " -"objects are added to hashed collections such as dictionaries and sets. " -"Having a :meth:`~object.__hash__` implies that instances of the class are " -"immutable. Mutability is a complicated property that depends on the " -"programmer's intent, the existence and behavior of :meth:`~object.__eq__`, " -"and the values of the ``eq`` and ``frozen`` flags in the :func:`dataclass` " -"decorator." +":meth:`!__hash__` is used by built-in :meth:`hash()`, and when objects are " +"added to hashed collections such as dictionaries and sets. Having a :meth:`!" +"__hash__` implies that instances of the class are immutable. Mutability is a " +"complicated property that depends on the programmer's intent, the existence " +"and behavior of :meth:`!__eq__`, and the values of the ``eq`` and ``frozen`` " +"flags in the ``@dataclass`` decorator." msgstr "" #: library/dataclasses.rst:134 msgid "" -"By default, :func:`dataclass` will not implicitly add a :meth:`~object." +"By default, ``@dataclass`` will not implicitly add a :meth:`~object." "__hash__` method unless it is safe to do so. Neither will it add or change " -"an existing explicitly defined :meth:`~object.__hash__` method. Setting the " -"class attribute ``__hash__ = None`` has a specific meaning to Python, as " -"described in the :meth:`~object.__hash__` documentation." +"an existing explicitly defined :meth:`!__hash__` method. Setting the class " +"attribute ``__hash__ = None`` has a specific meaning to Python, as described " +"in the :meth:`!__hash__` documentation." msgstr "" #: library/dataclasses.rst:140 msgid "" -"If :meth:`~object.__hash__` is not explicitly defined, or if it is set to " -"``None``, then :func:`dataclass` *may* add an implicit :meth:`~object." -"__hash__` method. Although not recommended, you can force :func:`dataclass` " -"to create a :meth:`~object.__hash__` method with ``unsafe_hash=True``. This " -"might be the case if your class is logically immutable but can nonetheless " -"be mutated. This is a specialized use case and should be considered " -"carefully." +"If :meth:`!__hash__` is not explicitly defined, or if it is set to ``None``, " +"then ``@dataclass`` *may* add an implicit :meth:`!__hash__` method. Although " +"not recommended, you can force ``@dataclass`` to create a :meth:`!__hash__` " +"method with ``unsafe_hash=True``. This might be the case if your class is " +"logically immutable but can still be mutated. This is a specialized use case " +"and should be considered carefully." msgstr "" #: library/dataclasses.rst:147 msgid "" -"Here are the rules governing implicit creation of a :meth:`~object.__hash__` " -"method. Note that you cannot both have an explicit :meth:`~object.__hash__` " -"method in your dataclass and set ``unsafe_hash=True``; this will result in " -"a :exc:`TypeError`." +"Here are the rules governing implicit creation of a :meth:`!__hash__` " +"method. Note that you cannot both have an explicit :meth:`!__hash__` method " +"in your dataclass and set ``unsafe_hash=True``; this will result in a :exc:" +"`TypeError`." msgstr "" #: library/dataclasses.rst:152 msgid "" -"If ``eq`` and ``frozen`` are both true, by default :func:`dataclass` will " -"generate a :meth:`~object.__hash__` method for you. If ``eq`` is true and " -"``frozen`` is false, :meth:`~object.__hash__` will be set to ``None``, " -"marking it unhashable (which it is, since it is mutable). If ``eq`` is " -"false, :meth:`~object.__hash__` will be left untouched meaning the :meth:" -"`~object.__hash__` method of the superclass will be used (if the superclass " -"is :class:`object`, this means it will fall back to id-based hashing)." +"If ``eq`` and ``frozen`` are both true, by default ``@dataclass`` will " +"generate a :meth:`!__hash__` method for you. If ``eq`` is true and " +"``frozen`` is false, :meth:`!__hash__` will be set to ``None``, marking it " +"unhashable (which it is, since it is mutable). If ``eq`` is false, :meth:`!" +"__hash__` will be left untouched meaning the :meth:`!__hash__` method of the " +"superclass will be used (if the superclass is :class:`object`, this means it " +"will fall back to id-based hashing)." msgstr "" #: library/dataclasses.rst:160 @@ -220,9 +213,9 @@ msgstr "" msgid "" "``match_args``: If true (the default is ``True``), the ``__match_args__`` " "tuple will be created from the list of parameters to the generated :meth:" -"`~object.__init__` method (even if :meth:`~object.__init__` is not " -"generated, see above). If false, or if ``__match_args__`` is already " -"defined in the class, then ``__match_args__`` will not be generated." +"`~object.__init__` method (even if :meth:`!__init__` is not generated, see " +"above). If false, or if ``__match_args__`` is already defined in the class, " +"then ``__match_args__`` will not be generated." msgstr "" #: library/dataclasses.rst:174 @@ -230,18 +223,18 @@ msgid "" "``kw_only``: If true (the default value is ``False``), then all fields will " "be marked as keyword-only. If a field is marked as keyword-only, then the " "only effect is that the :meth:`~object.__init__` parameter generated from a " -"keyword-only field must be specified with a keyword when :meth:`~object." -"__init__` is called. There is no effect on any other aspect of " -"dataclasses. See the :term:`parameter` glossary entry for details. Also " -"see the :const:`KW_ONLY` section." +"keyword-only field must be specified with a keyword when :meth:`!__init__` " +"is called. There is no effect on any other aspect of dataclasses. See the :" +"term:`parameter` glossary entry for details. Also see the :const:`KW_ONLY` " +"section." msgstr "" #: library/dataclasses.rst:185 msgid "" "``slots``: If true (the default is ``False``), :attr:`~object.__slots__` " "attribute will be generated and new class will be returned instead of the " -"original one. If :attr:`~object.__slots__` is already defined in the class, " -"then :exc:`TypeError` is raised." +"original one. If :attr:`!__slots__` is already defined in the class, then :" +"exc:`TypeError` is raised." msgstr "" #: library/dataclasses.rst:192 @@ -286,7 +279,7 @@ msgid "" "For common and simple use cases, no other functionality is required. There " "are, however, some dataclass features that require additional per-field " "information. To satisfy this need for additional information, you can " -"replace the default field value with a call to the provided :func:`field` " +"replace the default field value with a call to the provided :func:`!field` " "function. For example::" msgstr "" @@ -299,13 +292,13 @@ msgid "" msgstr "" #: library/dataclasses.rst:246 -msgid "The parameters to :func:`field` are:" +msgid "The parameters to :func:`!field` are:" msgstr "" #: library/dataclasses.rst:248 msgid "" "``default``: If provided, this will be the default value for this field. " -"This is needed because the :meth:`field` call itself replaces the normal " +"This is needed because the :func:`!field` call itself replaces the normal " "position of the default value." msgstr "" @@ -375,13 +368,13 @@ msgstr "" #: library/dataclasses.rst:295 msgid "" -"If the default value of a field is specified by a call to :func:`field()`, " +"If the default value of a field is specified by a call to :func:`!field`, " "then the class attribute for this field will be replaced by the specified " "``default`` value. If no ``default`` is provided, then the class attribute " -"will be deleted. The intent is that after the :func:`dataclass` decorator " -"runs, the class attributes will all contain the default values for the " -"fields, just as if the default value itself were specified. For example, " -"after::" +"will be deleted. The intent is that after the :func:`@dataclass " +"` decorator runs, the class attributes will all contain the " +"default values for the fields, just as if the default value itself were " +"specified. For example, after::" msgstr "" #: library/dataclasses.rst:311 @@ -392,9 +385,9 @@ msgstr "" #: library/dataclasses.rst:317 msgid "" -":class:`Field` objects describe each defined field. These objects are " +":class:`!Field` objects describe each defined field. These objects are " "created internally, and are returned by the :func:`fields` module-level " -"method (see below). Users should never instantiate a :class:`Field` object " +"method (see below). Users should never instantiate a :class:`!Field` object " "directly. Its documented attributes are:" msgstr "" @@ -436,7 +429,7 @@ msgid "" msgstr "" #: library/dataclasses.rst:346 -msgid "Example of using :func:`asdict` on nested dataclasses::" +msgid "Example of using :func:`!asdict` on nested dataclasses::" msgstr "" #: library/dataclasses.rst:383 @@ -445,7 +438,7 @@ msgstr "" #: library/dataclasses.rst:367 msgid "" -":func:`asdict` raises :exc:`TypeError` if ``obj`` is not a dataclass " +":func:`!asdict` raises :exc:`TypeError` if ``obj`` is not a dataclass " "instance." msgstr "" @@ -463,7 +456,7 @@ msgstr "" #: library/dataclasses.rst:387 msgid "" -":func:`astuple` raises :exc:`TypeError` if ``obj`` is not a dataclass " +":func:`!astuple` raises :exc:`TypeError` if ``obj`` is not a dataclass " "instance." msgstr "" @@ -476,7 +469,8 @@ msgid "" "Field)``. If just ``name`` is supplied, ``typing.Any`` is used for " "``type``. The values of ``init``, ``repr``, ``eq``, ``order``, " "``unsafe_hash``, ``frozen``, ``match_args``, ``kw_only``, ``slots``, and " -"``weakref_slot`` have the same meaning as they do in :func:`dataclass`." +"``weakref_slot`` have the same meaning as they do in :func:`@dataclass " +"`." msgstr "" #: library/dataclasses.rst:402 @@ -488,9 +482,9 @@ msgstr "" #: library/dataclasses.rst:406 msgid "" "This function is not strictly required, because any Python mechanism for " -"creating a new class with ``__annotations__`` can then apply the :func:" -"`dataclass` function to convert that class to a dataclass. This function is " -"provided as a convenience. For example::" +"creating a new class with ``__annotations__`` can then apply the " +"``@dataclass`` function to convert that class to a dataclass. This function " +"is provided as a convenience. For example::" msgstr "" #: library/dataclasses.rst:418 @@ -515,7 +509,7 @@ msgstr "" #: library/dataclasses.rst:440 msgid "" "Init-only variables without default values, if any exist, must be specified " -"on the call to :func:`replace` so that they can be passed to :meth:`~object." +"on the call to :func:`!replace` so that they can be passed to :meth:`!" "__init__` and :meth:`__post_init__`." msgstr "" @@ -527,8 +521,8 @@ msgstr "" #: library/dataclasses.rst:448 msgid "" -"Be forewarned about how ``init=False`` fields work during a call to :func:" -"`replace`. They are not copied from the source object, but rather are " +"Be forewarned about how ``init=False`` fields work during a call to :func:`!" +"replace`. They are not copied from the source object, but rather are " "initialized in :meth:`__post_init__`, if they're initialized at all. It is " "expected that ``init=False`` fields will be rarely and judiciously used. If " "they are used, it might be wise to have alternate class constructors, or " @@ -556,10 +550,10 @@ msgstr "" #: library/dataclasses.rst:475 msgid "" "A sentinel value used as a type annotation. Any fields after a pseudo-field " -"with the type of :const:`KW_ONLY` are marked as keyword-only fields. Note " -"that a pseudo-field of type :const:`KW_ONLY` is otherwise completely " +"with the type of :const:`!KW_ONLY` are marked as keyword-only fields. Note " +"that a pseudo-field of type :const:`!KW_ONLY` is otherwise completely " "ignored. This includes the name of such a field. By convention, a name of " -"``_`` is used for a :const:`KW_ONLY` field. Keyword-only fields signify :" +"``_`` is used for a :const:`!KW_ONLY` field. Keyword-only fields signify :" "meth:`~object.__init__` parameters that must be specified as keywords when " "the class is instantiated." msgstr "" @@ -573,7 +567,7 @@ msgstr "" #: library/dataclasses.rst:495 msgid "" "In a single dataclass, it is an error to specify more than one field whose " -"type is :const:`KW_ONLY`." +"type is :const:`!KW_ONLY`." msgstr "" #: library/dataclasses.rst:502 @@ -591,9 +585,9 @@ msgstr "" msgid "" "When defined on the class, it will be called by the generated :meth:`~object." "__init__`, normally as ``self.__post_init__()``. However, if any ``InitVar`` " -"fields are defined, they will also be passed to :meth:`__post_init__` in the " -"order they were defined in the class. If no :meth:`~object.__init__` method " -"is generated, then :meth:`__post_init__` will not automatically be called." +"fields are defined, they will also be passed to :meth:`!__post_init__` in " +"the order they were defined in the class. If no :meth:`!__init__` method is " +"generated, then :meth:`!__post_init__` will not automatically be called." msgstr "" #: library/dataclasses.rst:520 @@ -604,24 +598,23 @@ msgstr "" #: library/dataclasses.rst:532 msgid "" -"The :meth:`~object.__init__` method generated by :func:`dataclass` does not " -"call base class :meth:`~object.__init__` methods. If the base class has an :" -"meth:`~object.__init__` method that has to be called, it is common to call " -"this method in a :meth:`__post_init__` method::" +"The :meth:`~object.__init__` method generated by :func:`@dataclass " +"` does not call base class :meth:`!__init__` methods. If the base " +"class has an :meth:`!__init__` method that has to be called, it is common to " +"call this method in a :meth:`__post_init__` method::" msgstr "" #: library/dataclasses.rst:549 msgid "" -"Note, however, that in general the dataclass-generated :meth:`~object." -"__init__` methods don't need to be called, since the derived dataclass will " -"take care of initializing all fields of any base class that is a dataclass " -"itself." +"Note, however, that in general the dataclass-generated :meth:`!__init__` " +"methods don't need to be called, since the derived dataclass will take care " +"of initializing all fields of any base class that is a dataclass itself." msgstr "" #: library/dataclasses.rst:553 msgid "" "See the section below on init-only variables for ways to pass parameters to :" -"meth:`__post_init__`. Also see the warning about how :func:`replace` " +"meth:`!__post_init__`. Also see the warning about how :func:`replace` " "handles ``init=False`` fields." msgstr "" @@ -631,12 +624,13 @@ msgstr "" #: library/dataclasses.rst:560 msgid "" -"One of the few places where :func:`dataclass` actually inspects the type of " -"a field is to determine if a field is a class variable as defined in :pep:" -"`526`. It does this by checking if the type of the field is ``typing." -"ClassVar``. If a field is a ``ClassVar``, it is excluded from consideration " -"as a field and is ignored by the dataclass mechanisms. Such ``ClassVar`` " -"pseudo-fields are not returned by the module-level :func:`fields` function." +"One of the few places where :func:`@dataclass ` actually inspects " +"the type of a field is to determine if a field is a class variable as " +"defined in :pep:`526`. It does this by checking if the type of the field is " +"``typing.ClassVar``. If a field is a ``ClassVar``, it is excluded from " +"consideration as a field and is ignored by the dataclass mechanisms. Such " +"``ClassVar`` pseudo-fields are not returned by the module-level :func:" +"`fields` function." msgstr "" #: library/dataclasses.rst:569 @@ -645,14 +639,15 @@ msgstr "" #: library/dataclasses.rst:571 msgid "" -"Another place where :func:`dataclass` inspects a type annotation is to " -"determine if a field is an init-only variable. It does this by seeing if " -"the type of a field is of type ``dataclasses.InitVar``. If a field is an " -"``InitVar``, it is considered a pseudo-field called an init-only field. As " -"it is not a true field, it is not returned by the module-level :func:" -"`fields` function. Init-only fields are added as parameters to the " -"generated :meth:`~object.__init__` method, and are passed to the optional :" -"meth:`__post_init__` method. They are not otherwise used by dataclasses." +"Another place where :func:`@dataclass ` inspects a type " +"annotation is to determine if a field is an init-only variable. It does " +"this by seeing if the type of a field is of type ``dataclasses.InitVar``. " +"If a field is an ``InitVar``, it is considered a pseudo-field called an init-" +"only field. As it is not a true field, it is not returned by the module-" +"level :func:`fields` function. Init-only fields are added as parameters to " +"the generated :meth:`~object.__init__` method, and are passed to the " +"optional :meth:`__post_init__` method. They are not otherwise used by " +"dataclasses." msgstr "" #: library/dataclasses.rst:581 @@ -674,8 +669,8 @@ msgstr "" #: library/dataclasses.rst:602 msgid "" "It is not possible to create truly immutable Python objects. However, by " -"passing ``frozen=True`` to the :meth:`dataclass` decorator you can emulate " -"immutability. In that case, dataclasses will add :meth:`~object." +"passing ``frozen=True`` to the :func:`@dataclass ` decorator you " +"can emulate immutability. In that case, dataclasses will add :meth:`~object." "__setattr__` and :meth:`~object.__delattr__` methods to the class. These " "methods will raise a :exc:`FrozenInstanceError` when invoked." msgstr "" @@ -684,7 +679,7 @@ msgstr "" msgid "" "There is a tiny performance penalty when using ``frozen=True``: :meth:" "`~object.__init__` cannot use simple assignment to initialize fields, and " -"must use :meth:`!object.__setattr__`." +"must use :meth:`!__setattr__`." msgstr "" #: library/dataclasses.rst:613 @@ -693,14 +688,14 @@ msgstr "" #: library/dataclasses.rst:615 msgid "" -"When the dataclass is being created by the :meth:`dataclass` decorator, it " -"looks through all of the class's base classes in reverse MRO (that is, " -"starting at :class:`object`) and, for each dataclass that it finds, adds the " -"fields from that base class to an ordered mapping of fields. After all of " -"the base class fields are added, it adds its own fields to the ordered " -"mapping. All of the generated methods will use this combined, calculated " -"ordered mapping of fields. Because the fields are in insertion order, " -"derived classes override base classes. An example::" +"When the dataclass is being created by the :func:`@dataclass ` " +"decorator, it looks through all of the class's base classes in reverse MRO " +"(that is, starting at :class:`object`) and, for each dataclass that it " +"finds, adds the fields from that base class to an ordered mapping of fields. " +"After all of the base class fields are added, it adds its own fields to the " +"ordered mapping. All of the generated methods will use this combined, " +"calculated ordered mapping of fields. Because the fields are in insertion " +"order, derived classes override base classes. An example::" msgstr "" #: library/dataclasses.rst:635 @@ -715,7 +710,7 @@ msgid "" msgstr "" #: library/dataclasses.rst:643 -msgid "Re-ordering of keyword-only parameters in :meth:`~object.__init__`" +msgid "Re-ordering of keyword-only parameters in :meth:`!__init__`" msgstr "" #: library/dataclasses.rst:645 @@ -733,8 +728,7 @@ msgid "" msgstr "" #: library/dataclasses.rst:666 -msgid "" -"The generated :meth:`~object.__init__` method for ``D`` will look like::" +msgid "The generated :meth:`!__init__` method for ``D`` will look like::" msgstr "" #: library/dataclasses.rst:670 @@ -747,7 +741,7 @@ msgstr "" #: library/dataclasses.rst:674 msgid "" "The relative ordering of keyword-only parameters is maintained in the re-" -"ordered :meth:`~object.__init__` parameter list." +"ordered :meth:`!__init__` parameter list." msgstr "" #: library/dataclasses.rst:679 @@ -765,7 +759,7 @@ msgstr "" msgid "" "If a field is excluded from :meth:`~object.__init__` (using ``init=False``) " "and the field also specifies ``default_factory``, then the default factory " -"function will always be called from the generated :meth:`~object.__init__` " +"function will always be called from the generated :meth:`!__init__` " "function. This happens because there is no other way to give the field an " "initial value." msgstr "" @@ -801,10 +795,10 @@ msgid "" "creating a class instance will share the same copy of ``x``. Because " "dataclasses just use normal Python class creation they also share this " "behavior. There is no general way for Data Classes to detect this " -"condition. Instead, the :func:`dataclass` decorator will raise a :exc:" -"`ValueError` if it detects an unhashable default parameter. The assumption " -"is that if a value is unhashable, it is mutable. This is a partial " -"solution, but it does protect against many common errors." +"condition. Instead, the :func:`@dataclass ` decorator will raise " +"a :exc:`ValueError` if it detects an unhashable default parameter. The " +"assumption is that if a value is unhashable, it is mutable. This is a " +"partial solution, but it does protect against many common errors." msgstr "" #: library/dataclasses.rst:744 @@ -832,29 +826,29 @@ msgstr "" #: library/dataclasses.rst:765 msgid "" -"The value for the field passed to the dataclass's ``__init__`` method is " -"passed to the descriptor's ``__set__`` method rather than overwriting the " -"descriptor object." +"The value for the field passed to the dataclass's :meth:`~object.__init__` " +"method is passed to the descriptor's :meth:`~object.__set__` method rather " +"than overwriting the descriptor object." msgstr "" -#: library/dataclasses.rst:768 +#: library/dataclasses.rst:769 msgid "" -"Similarly, when getting or setting the field, the descriptor's ``__get__`` " -"or ``__set__`` method is called rather than returning or overwriting the " -"descriptor object." +"Similarly, when getting or setting the field, the descriptor's :meth:" +"`~object.__get__` or :meth:`!__set__` method is called rather than returning " +"or overwriting the descriptor object." msgstr "" -#: library/dataclasses.rst:771 +#: library/dataclasses.rst:773 msgid "" -"To determine whether a field contains a default value, ``dataclasses`` will " -"call the descriptor's ``__get__`` method using its class access form (i.e. " -"``descriptor.__get__(obj=None, type=cls)``. If the descriptor returns a " -"value in this case, it will be used as the field's default. On the other " -"hand, if the descriptor raises :exc:`AttributeError` in this situation, no " -"default value will be provided for the field." +"To determine whether a field contains a default value, :func:`@dataclass " +"` will call the descriptor's :meth:`!__get__` method using its " +"class access form: ``descriptor.__get__(obj=None, type=cls)``. If the " +"descriptor returns a value in this case, it will be used as the field's " +"default. On the other hand, if the descriptor raises :exc:`AttributeError` " +"in this situation, no default value will be provided for the field." msgstr "" -#: library/dataclasses.rst:806 +#: library/dataclasses.rst:808 msgid "" "Note that if a field is annotated with a descriptor type, but is not " "assigned a descriptor object as its default value, the field will act like a " diff --git a/library/decimal.po b/library/decimal.po index 2f80daef4..3f57a4045 100644 --- a/library/decimal.po +++ b/library/decimal.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1530,10 +1530,6 @@ msgid "" "scenarios." msgstr "" -#: library/decimal.rst:1520 -msgid "backported to 3.7 and 3.8." -msgstr "" - #: library/decimal.rst:1524 msgid "Rounding modes" msgstr "" diff --git a/library/dis.po b/library/dis.po index 3b120a3bf..957f25149 100644 --- a/library/dis.po +++ b/library/dis.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1025,7 +1025,7 @@ msgstr "" #: library/dis.rst:1118 msgid "" "The low bit of ``namei`` signals to attempt a method load, as with :opcode:" -"`LOAD_ATTR`, which results in pushing ``None`` and the loaded method. When " +"`LOAD_ATTR`, which results in pushing ``NULL`` and the loaded method. When " "it is unset a single value is pushed to the stack." msgstr "" diff --git a/library/enum.po b/library/enum.po index 054269d3f..c235d3d4a 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-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -432,11 +432,15 @@ msgstr "" msgid "The value given to the ``Enum`` member::" msgstr "" -#: library/enum.rst:272 -msgid "Enum member values" +#: library/enum.rst:292 +msgid "Value of the member, can be set in :meth:`~object.__new__`." msgstr "" #: library/enum.rst:274 +msgid "Enum member values" +msgstr "" + +#: library/enum.rst:276 msgid "" "Member values can be anything: :class:`int`, :class:`str`, etc. If the " "exact value is unimportant you may use :class:`auto` instances and an " @@ -444,33 +448,37 @@ msgid "" msgstr "" #: library/enum.rst:281 -msgid "Name of the member." +msgid "" +"While mutable/unhashable values, such as :class:`dict`, :class:`list` or a " +"mutable :class:`~dataclasses.dataclass`, can be used, they will have a " +"quadratic performance impact during creation relative to the total number of " +"mutable/unhashable values in the enum." msgstr "" -#: library/enum.rst:285 -msgid "Value of the member, can be set in :meth:`~object.__new__`." +#: library/enum.rst:288 +msgid "Name of the member." msgstr "" -#: library/enum.rst:289 +#: library/enum.rst:296 msgid "" "No longer used, kept for backward compatibility. (class attribute, removed " "during class creation)." msgstr "" -#: library/enum.rst:294 +#: library/enum.rst:301 msgid "" "``_ignore_`` is only used during creation and is removed from the " "enumeration once creation is complete." msgstr "" -#: library/enum.rst:297 +#: library/enum.rst:304 msgid "" "``_ignore_`` is a list of names that will not become members, and whose " "names will also be removed from the completed enumeration. See :ref:" "`TimePeriod ` for an example." msgstr "" -#: library/enum.rst:303 +#: library/enum.rst:310 msgid "" "Returns ``['__class__', '__doc__', '__module__', 'name', 'value']`` and any " "public methods defined on *self.__class__*::" @@ -480,11 +488,11 @@ msgstr "" msgid "name" msgstr "" -#: library/enum.rst:324 +#: library/enum.rst:331 msgid "The name of the member being defined (e.g. 'RED')." msgstr "" -#: library/enum.rst:325 +#: library/enum.rst:332 msgid "The start value for the Enum; the default is 1." msgstr "" @@ -492,7 +500,7 @@ msgstr "" msgid "count" msgstr "" -#: library/enum.rst:326 +#: library/enum.rst:333 msgid "The number of members currently defined, not including this one." msgstr "" @@ -500,90 +508,90 @@ msgstr "" msgid "last_values" msgstr "" -#: library/enum.rst:327 +#: library/enum.rst:334 msgid "A list of the previous values." msgstr "" -#: library/enum.rst:329 +#: library/enum.rst:336 msgid "" "A *staticmethod* that is used to determine the next value returned by :class:" "`auto`::" msgstr "" -#: library/enum.rst:345 +#: library/enum.rst:352 msgid "" "By default, does nothing. If multiple values are given in the member " "assignment, those values become separate arguments to ``__init__``; e.g." msgstr "" -#: library/enum.rst:352 +#: library/enum.rst:359 msgid "" "``Weekday.__init__()`` would be called as ``Weekday.__init__(self, 1, " "'Mon')``" msgstr "" -#: library/enum.rst:356 +#: library/enum.rst:363 msgid "" "A *classmethod* that is used to further configure subsequent subclasses. By " "default, does nothing." msgstr "" -#: library/enum.rst:361 +#: library/enum.rst:368 msgid "" "A *classmethod* for looking up values not found in *cls*. By default it " "does nothing, but can be overridden to implement custom search behavior::" msgstr "" -#: library/enum.rst:383 +#: library/enum.rst:390 msgid "" "By default, doesn't exist. If specified, either in the enum class " "definition or in a mixin class (such as ``int``), all values given in the " "member assignment will be passed; e.g." msgstr "" -#: library/enum.rst:391 +#: library/enum.rst:398 msgid "" "results in the call ``int('1a', 16)`` and a value of ``17`` for the member." msgstr "" -#: library/enum.rst:393 +#: library/enum.rst:400 msgid "" "..note:: When writing a custom ``__new__``, do not use ``super().__new__`` --" msgstr "" -#: library/enum.rst:394 +#: library/enum.rst:401 msgid "call the appropriate ``__new__`` instead." msgstr "" -#: library/enum.rst:398 +#: library/enum.rst:405 msgid "" "Returns the string used for *repr()* calls. By default, returns the *Enum* " "name, member name, and value, but can be overridden::" msgstr "" -#: library/enum.rst:414 +#: library/enum.rst:421 msgid "" "Returns the string used for *str()* calls. By default, returns the *Enum* " "name and member name, but can be overridden::" msgstr "" -#: library/enum.rst:429 +#: library/enum.rst:436 msgid "" "Returns the string used for *format()* and *f-string* calls. By default, " "returns :meth:`__str__` return value, but can be overridden::" msgstr "" -#: library/enum.rst:444 +#: library/enum.rst:451 msgid "" "Using :class:`auto` with :class:`Enum` results in integers of increasing " "value, starting with ``1``." msgstr "" -#: library/enum.rst:447 +#: library/enum.rst:454 msgid "Added :ref:`enum-dataclass-support`" msgstr "" -#: library/enum.rst:452 +#: library/enum.rst:459 msgid "" "*IntEnum* is the same as *Enum*, but its members are also integers and can " "be used anywhere that an integer can be used. If any integer operation is " @@ -591,20 +599,20 @@ msgid "" "enumeration status." msgstr "" -#: library/enum.rst:473 +#: library/enum.rst:480 msgid "" "Using :class:`auto` with :class:`IntEnum` results in integers of increasing " "value, starting with ``1``." msgstr "" -#: library/enum.rst:476 +#: library/enum.rst:483 msgid "" ":meth:`~object.__str__` is now :meth:`!int.__str__` to better support the " "*replacement of existing constants* use-case. :meth:`~object.__format__` was " "already :meth:`!int.__format__` for that same reason." msgstr "" -#: library/enum.rst:483 +#: library/enum.rst:490 msgid "" "*StrEnum* is the same as *Enum*, but its members are also strings and can be " "used in most of the same places that a string can be used. The result of " @@ -612,7 +620,7 @@ msgid "" "the enumeration." msgstr "" -#: library/enum.rst:489 +#: library/enum.rst:496 msgid "" "There are places in the stdlib that check for an exact :class:`str` instead " "of a :class:`str` subclass (i.e. ``type(unknown) == str`` instead of " @@ -620,280 +628,280 @@ msgid "" "``str(StrEnum.member)``." msgstr "" -#: library/enum.rst:496 +#: library/enum.rst:503 msgid "" "Using :class:`auto` with :class:`StrEnum` results in the lower-cased member " "name as the value." msgstr "" -#: library/enum.rst:501 +#: library/enum.rst:508 msgid "" ":meth:`~object.__str__` is :meth:`!str.__str__` to better support the " "*replacement of existing constants* use-case. :meth:`~object.__format__` is " "likewise :meth:`!str.__format__` for that same reason." msgstr "" -#: library/enum.rst:509 +#: library/enum.rst:516 msgid "" "``Flag`` is the same as :class:`Enum`, but its members support the bitwise " "operators ``&`` (*AND*), ``|`` (*OR*), ``^`` (*XOR*), and ``~`` (*INVERT*); " "the results of those operators are members of the enumeration." msgstr "" -#: library/enum.rst:515 +#: library/enum.rst:522 msgid "Returns *True* if value is in self::" msgstr "" -#: library/enum.rst:536 +#: library/enum.rst:543 msgid "Returns all contained non-alias members::" msgstr "" -#: library/enum.rst:547 +#: library/enum.rst:554 msgid "Returns number of members in flag::" msgstr "" -#: library/enum.rst:556 +#: library/enum.rst:563 msgid "Returns *True* if any members in flag, *False* otherwise::" msgstr "" -#: library/enum.rst:568 +#: library/enum.rst:575 msgid "Returns current flag binary or'ed with other::" msgstr "" -#: library/enum.rst:575 +#: library/enum.rst:582 msgid "Returns current flag binary and'ed with other::" msgstr "" -#: library/enum.rst:584 +#: library/enum.rst:591 msgid "Returns current flag binary xor'ed with other::" msgstr "" -#: library/enum.rst:593 +#: library/enum.rst:600 msgid "Returns all the flags in *type(self)* that are not in self::" msgstr "" -#: library/enum.rst:604 +#: library/enum.rst:611 msgid "" "Function used to format any remaining unnamed numeric values. Default is " "the value's repr; common choices are :func:`hex` and :func:`oct`." msgstr "" -#: library/enum.rst:609 +#: library/enum.rst:616 msgid "" "Using :class:`auto` with :class:`Flag` results in integers that are powers " "of two, starting with ``1``." msgstr "" -#: library/enum.rst:612 +#: library/enum.rst:619 msgid "The *repr()* of zero-valued flags has changed. It is now::" msgstr "" -#: library/enum.rst:620 +#: library/enum.rst:627 msgid "" "*IntFlag* is the same as *Flag*, but its members are also integers and can " "be used anywhere that an integer can be used." msgstr "" -#: library/enum.rst:634 +#: library/enum.rst:641 msgid "" "If any integer operation is performed with an *IntFlag* member, the result " "is not an *IntFlag*::" msgstr "" -#: library/enum.rst:640 +#: library/enum.rst:647 msgid "If a *Flag* operation is performed with an *IntFlag* member and:" msgstr "" -#: library/enum.rst:642 +#: library/enum.rst:649 msgid "the result is a valid *IntFlag*: an *IntFlag* is returned" msgstr "" -#: library/enum.rst:643 +#: library/enum.rst:650 msgid "" "the result is not a valid *IntFlag*: the result depends on the " "*FlagBoundary* setting" msgstr "" -#: library/enum.rst:645 +#: library/enum.rst:652 msgid "The *repr()* of unnamed zero-valued flags has changed. It is now:" msgstr "" -#: library/enum.rst:652 +#: library/enum.rst:659 msgid "" "Using :class:`auto` with :class:`IntFlag` results in integers that are " "powers of two, starting with ``1``." msgstr "" -#: library/enum.rst:657 +#: library/enum.rst:664 msgid "" ":meth:`~object.__str__` is now :meth:`!int.__str__` to better support the " "*replacement of existing constants* use-case. :meth:`~object.__format__` " "was already :meth:`!int.__format__` for that same reason." msgstr "" -#: library/enum.rst:661 +#: library/enum.rst:668 msgid "" "Inversion of an :class:`!IntFlag` now returns a positive value that is the " "union of all flags not in the given flag, rather than a negative value. This " "matches the existing :class:`Flag` behavior." msgstr "" -#: library/enum.rst:667 +#: library/enum.rst:674 msgid "" ":class:`!ReprEnum` uses the :meth:`repr() ` of :class:`Enum`, " "but the :class:`str() ` of the mixed-in data type:" msgstr "" -#: library/enum.rst:670 +#: library/enum.rst:677 msgid ":meth:`!int.__str__` for :class:`IntEnum` and :class:`IntFlag`" msgstr "" -#: library/enum.rst:671 +#: library/enum.rst:678 msgid ":meth:`!str.__str__` for :class:`StrEnum`" msgstr "" -#: library/enum.rst:673 +#: library/enum.rst:680 msgid "" "Inherit from :class:`!ReprEnum` to keep the :class:`str() ` / :func:" "`format` of the mixed-in data type instead of using the :class:`Enum`-" "default :meth:`str() `." msgstr "" -#: library/enum.rst:682 +#: library/enum.rst:689 msgid "" "*EnumCheck* contains the options used by the :func:`verify` decorator to " "ensure various constraints; failed constraints result in a :exc:`ValueError`." msgstr "" -#: library/enum.rst:687 +#: library/enum.rst:694 msgid "Ensure that each value has only one name::" msgstr "" -#: library/enum.rst:703 +#: library/enum.rst:710 msgid "" "Ensure that there are no missing values between the lowest-valued member and " "the highest-valued member::" msgstr "" -#: library/enum.rst:718 +#: library/enum.rst:725 msgid "" "Ensure that any flag groups/masks contain only named flags -- useful when " "values are specified instead of being generated by :func:`auto`::" msgstr "" -#: library/enum.rst:735 +#: library/enum.rst:742 msgid "" "CONTINUOUS and NAMED_FLAGS are designed to work with integer-valued members." msgstr "" -#: library/enum.rst:741 +#: library/enum.rst:748 msgid "" "*FlagBoundary* controls how out-of-range values are handled in *Flag* and " "its subclasses." msgstr "" -#: library/enum.rst:746 +#: library/enum.rst:753 msgid "" "Out-of-range values cause a :exc:`ValueError` to be raised. This is the " "default for :class:`Flag`::" msgstr "" -#: library/enum.rst:764 +#: library/enum.rst:771 msgid "" "Out-of-range values have invalid values removed, leaving a valid *Flag* " "value::" msgstr "" -#: library/enum.rst:778 +#: library/enum.rst:785 msgid "" "Out-of-range values lose their *Flag* membership and revert to :class:`int`." msgstr "" -#: library/enum.rst:791 +#: library/enum.rst:798 msgid "" "Out-of-range values are kept, and the *Flag* membership is kept. This is the " "default for :class:`IntFlag`::" msgstr "" -#: library/enum.rst:808 +#: library/enum.rst:815 msgid "Supported ``__dunder__`` names" msgstr "" -#: library/enum.rst:810 +#: library/enum.rst:817 msgid "" ":attr:`~EnumType.__members__` is a read-only ordered mapping of " "``member_name``:``member`` items. It is only available on the class." msgstr "" -#: library/enum.rst:813 +#: library/enum.rst:820 msgid "" ":meth:`~object.__new__`, if specified, must create and return the enum " "members; it is also a very good idea to set the member's :attr:`!_value_` " "appropriately. Once all the members are created it is no longer used." msgstr "" -#: library/enum.rst:819 +#: library/enum.rst:826 msgid "Supported ``_sunder_`` names" msgstr "" -#: library/enum.rst:821 +#: library/enum.rst:828 msgid ":attr:`~Enum._name_` -- name of the member" msgstr "" -#: library/enum.rst:822 +#: library/enum.rst:829 msgid ":attr:`~Enum._value_` -- value of the member; can be set in ``__new__``" msgstr "" -#: library/enum.rst:823 +#: library/enum.rst:830 msgid "" ":meth:`~Enum._missing_` -- a lookup function used when a value is not found; " "may be overridden" msgstr "" -#: library/enum.rst:825 +#: library/enum.rst:832 msgid "" ":attr:`~Enum._ignore_` -- a list of names, either as a :class:`list` or a :" "class:`str`, that will not be transformed into members, and will be removed " "from the final class" msgstr "" -#: library/enum.rst:828 +#: library/enum.rst:835 msgid "" ":attr:`~Enum._order_` -- no longer used, kept for backward compatibility " "(class attribute, removed during class creation)" msgstr "" -#: library/enum.rst:830 +#: library/enum.rst:837 msgid "" ":meth:`~Enum._generate_next_value_` -- used to get an appropriate value for " "an enum member; may be overridden" msgstr "" -#: library/enum.rst:835 +#: library/enum.rst:842 msgid "" "For standard :class:`Enum` classes the next value chosen is the last value " "seen incremented by one." msgstr "" -#: library/enum.rst:838 +#: library/enum.rst:845 msgid "" "For :class:`Flag` classes the next value chosen will be the next highest " "power-of-two, regardless of the last value seen." msgstr "" -#: library/enum.rst:841 +#: library/enum.rst:848 msgid "``_missing_``, ``_order_``, ``_generate_next_value_``" msgstr "" -#: library/enum.rst:842 +#: library/enum.rst:849 msgid "``_ignore_``" msgstr "" -#: library/enum.rst:847 +#: library/enum.rst:854 msgid "Utilities and Decorators" msgstr "" -#: library/enum.rst:851 +#: library/enum.rst:858 msgid "" "*auto* can be used in place of a value. If used, the *Enum* machinery will " "call an *Enum*'s :meth:`~Enum._generate_next_value_` to get an appropriate " @@ -904,54 +912,54 @@ msgid "" "manually specified values." msgstr "" -#: library/enum.rst:859 +#: library/enum.rst:866 msgid "" "*auto* instances are only resolved when at the top level of an assignment:" msgstr "" -#: library/enum.rst:861 +#: library/enum.rst:868 msgid "``FIRST = auto()`` will work (auto() is replaced with ``1``);" msgstr "" -#: library/enum.rst:862 +#: library/enum.rst:869 msgid "" "``SECOND = auto(), -2`` will work (auto is replaced with ``2``, so ``2, -2`` " "is used to create the ``SECOND`` enum member;" msgstr "" -#: library/enum.rst:864 +#: library/enum.rst:871 msgid "" "``THREE = [auto(), -3]`` will *not* work (``, -3`` is used to " "create the ``THREE`` enum member)" msgstr "" -#: library/enum.rst:869 +#: library/enum.rst:876 msgid "" "In prior versions, ``auto()`` had to be the only thing on the assignment " "line to work properly." msgstr "" -#: library/enum.rst:872 +#: library/enum.rst:879 msgid "" "``_generate_next_value_`` can be overridden to customize the values used by " "*auto*." msgstr "" -#: library/enum.rst:875 +#: library/enum.rst:882 msgid "" "in 3.13 the default ``_generate_next_value_`` will always return the highest " "member value incremented by 1, and will fail if any member is an " "incompatible type." msgstr "" -#: library/enum.rst:881 +#: library/enum.rst:888 msgid "" "A decorator similar to the built-in *property*, but specifically for " "enumerations. It allows member attributes to have the same names as members " "themselves." msgstr "" -#: library/enum.rst:885 +#: library/enum.rst:892 msgid "" "the *property* and the member must be defined in separate classes; for " "example, the *value* and *name* attributes are defined in the *Enum* class, " @@ -959,29 +967,29 @@ msgid "" "``name``." msgstr "" -#: library/enum.rst:894 +#: library/enum.rst:901 msgid "" "A :keyword:`class` decorator specifically for enumerations. It searches an " "enumeration's :attr:`~EnumType.__members__`, gathering any aliases it finds; " "if any are found :exc:`ValueError` is raised with the details::" msgstr "" -#: library/enum.rst:912 +#: library/enum.rst:919 msgid "" "A :keyword:`class` decorator specifically for enumerations. Members from :" "class:`EnumCheck` are used to specify which constraints should be checked on " "the decorated enumeration." msgstr "" -#: library/enum.rst:920 +#: library/enum.rst:927 msgid "A decorator for use in enums: its target will become a member." msgstr "" -#: library/enum.rst:926 +#: library/enum.rst:933 msgid "A decorator for use in enums: its target will not become a member." msgstr "" -#: library/enum.rst:932 +#: library/enum.rst:939 msgid "" "A decorator to change the :class:`str() ` and :func:`repr` of an enum " "to show its members as belonging to the module instead of its class. Should " @@ -989,40 +997,40 @@ msgid "" "namespace (see :class:`re.RegexFlag` for an example)." msgstr "" -#: library/enum.rst:942 +#: library/enum.rst:949 msgid "Return a list of all power-of-two integers contained in a flag *value*." msgstr "" -#: library/enum.rst:949 +#: library/enum.rst:956 msgid "Notes" msgstr "" -#: library/enum.rst:951 +#: library/enum.rst:958 msgid ":class:`IntEnum`, :class:`StrEnum`, and :class:`IntFlag`" msgstr "" -#: library/enum.rst:953 +#: library/enum.rst:960 msgid "" "These three enum types are designed to be drop-in replacements for existing " "integer- and string-based values; as such, they have extra limitations:" msgstr "" -#: library/enum.rst:956 +#: library/enum.rst:963 msgid "``__str__`` uses the value and not the name of the enum member" msgstr "" -#: library/enum.rst:958 +#: library/enum.rst:965 msgid "" "``__format__``, because it uses ``__str__``, will also use the value of the " "enum member instead of its name" msgstr "" -#: library/enum.rst:961 +#: library/enum.rst:968 msgid "" "If you do not need/want those limitations, you can either create your own " "base class by mixing in the ``int`` or ``str`` type yourself::" msgstr "" -#: library/enum.rst:968 +#: library/enum.rst:975 msgid "or you can reassign the appropriate :meth:`str`, etc., in your enum::" msgstr "" diff --git a/library/faulthandler.po b/library/faulthandler.po index ff81b2e39..a511932e8 100644 --- a/library/faulthandler.po +++ b/library/faulthandler.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-02-04 22:37+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -191,7 +191,7 @@ msgstr "" msgid "This function is implemented using a watchdog thread." msgstr "" -#: library/faulthandler.rst:121 +#: library/faulthandler.rst:124 msgid "This function is now always available." msgstr "" diff --git a/library/functools.po b/library/functools.po index dfeaf6f91..c19f4c2fd 100644 --- a/library/functools.po +++ b/library/functools.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -574,25 +574,20 @@ msgid "" msgstr "" #: library/functools.rst:668 -msgid "Automatic addition of the ``__wrapped__`` attribute." -msgstr "" - -#: library/functools.rst:671 -msgid "Copying of the ``__annotations__`` attribute by default." -msgstr "" - -#: library/functools.rst:674 -msgid "Missing attributes no longer trigger an :exc:`AttributeError`." +msgid "" +"The ``__wrapped__`` attribute is now automatically added. The " +"``__annotations__`` attribute is now copied by default. Missing attributes " +"no longer trigger an :exc:`AttributeError`." msgstr "" -#: library/functools.rst:677 +#: library/functools.rst:673 msgid "" "The ``__wrapped__`` attribute now always refers to the wrapped function, " "even if that function defined a ``__wrapped__`` attribute. (see :issue:" "`17482`)" msgstr "" -#: library/functools.rst:685 +#: library/functools.rst:681 msgid "" "This is a convenience function for invoking :func:`update_wrapper` as a " "function decorator when defining a wrapper function. It is equivalent to " @@ -600,42 +595,42 @@ msgid "" "updated=updated)``. For example::" msgstr "" -#: library/functools.rst:711 +#: library/functools.rst:707 msgid "" "Without the use of this decorator factory, the name of the example function " "would have been ``'wrapper'``, and the docstring of the original :func:" "`example` would have been lost." msgstr "" -#: library/functools.rst:719 +#: library/functools.rst:715 msgid ":class:`partial` Objects" msgstr "" -#: library/functools.rst:721 +#: library/functools.rst:717 msgid "" ":class:`partial` objects are callable objects created by :func:`partial`. " "They have three read-only attributes:" msgstr "" -#: library/functools.rst:727 +#: library/functools.rst:723 msgid "" "A callable object or function. Calls to the :class:`partial` object will be " "forwarded to :attr:`func` with new arguments and keywords." msgstr "" -#: library/functools.rst:733 +#: library/functools.rst:729 msgid "" "The leftmost positional arguments that will be prepended to the positional " "arguments provided to a :class:`partial` object call." msgstr "" -#: library/functools.rst:739 +#: library/functools.rst:735 msgid "" "The keyword arguments that will be supplied when the :class:`partial` object " "is called." msgstr "" -#: library/functools.rst:742 +#: library/functools.rst:738 msgid "" ":class:`partial` objects are like :class:`function` objects in that they are " "callable, weak referenceable, and can have attributes. There are some " diff --git a/library/hashlib.po b/library/hashlib.po index 07b46c3cd..f5b61391d 100644 --- a/library/hashlib.po +++ b/library/hashlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -94,14 +94,10 @@ msgstr "" msgid "" "SHA3 (Keccak) and SHAKE constructors :func:`sha3_224`, :func:`sha3_256`, :" "func:`sha3_384`, :func:`sha3_512`, :func:`shake_128`, :func:`shake_256` were " -"added." +"added. :func:`blake2b` and :func:`blake2s` were added." msgstr "" -#: library/hashlib.rst:81 -msgid ":func:`blake2b` and :func:`blake2s` were added." -msgstr "" - -#: library/hashlib.rst:86 +#: library/hashlib.rst:84 msgid "" "All hashlib constructors take a keyword-only argument *usedforsecurity* with " "default value ``True``. A false value allows the use of insecure and blocked " @@ -110,36 +106,36 @@ msgid "" "cryptographic one-way compression function." msgstr "" -#: library/hashlib.rst:93 +#: library/hashlib.rst:91 msgid "Hashlib now uses SHA3 and SHAKE from OpenSSL if it provides it." msgstr "" -#: library/hashlib.rst:96 +#: library/hashlib.rst:94 msgid "" "For any of the MD5, SHA1, SHA2, or SHA3 algorithms that the linked OpenSSL " "does not provide we fall back to a verified implementation from the `HACL\\* " "project`_." msgstr "" -#: library/hashlib.rst:102 +#: library/hashlib.rst:100 msgid "Usage" msgstr "" -#: library/hashlib.rst:104 +#: library/hashlib.rst:102 msgid "" "To obtain the digest of the byte string ``b\"Nobody inspects the spammish " "repetition\"``::" msgstr "" -#: library/hashlib.rst:116 +#: library/hashlib.rst:114 msgid "More condensed:" msgstr "" -#: library/hashlib.rst:122 +#: library/hashlib.rst:120 msgid "Constructors" msgstr "" -#: library/hashlib.rst:126 +#: library/hashlib.rst:124 msgid "" "Is a generic constructor that takes the string *name* of the desired " "algorithm as its first parameter. It also exists to allow access to the " @@ -147,25 +143,25 @@ msgid "" "library may offer." msgstr "" -#: library/hashlib.rst:131 +#: library/hashlib.rst:129 msgid "Using :func:`new` with an algorithm name:" msgstr "" -#: library/hashlib.rst:150 +#: library/hashlib.rst:148 msgid "" "Named constructors such as these are faster than passing an algorithm name " "to :func:`new`." msgstr "" -#: library/hashlib.rst:154 +#: library/hashlib.rst:152 msgid "Attributes" msgstr "" -#: library/hashlib.rst:156 +#: library/hashlib.rst:154 msgid "Hashlib provides the following constant module attributes:" msgstr "" -#: library/hashlib.rst:160 +#: library/hashlib.rst:158 msgid "" "A set containing the names of the hash algorithms guaranteed to be supported " "by this module on all platforms. Note that 'md5' is in this list despite " @@ -173,7 +169,7 @@ msgid "" "excludes it." msgstr "" -#: library/hashlib.rst:169 +#: library/hashlib.rst:167 msgid "" "A set containing the names of the hash algorithms that are available in the " "running Python interpreter. These names will be recognized when passed to :" @@ -182,77 +178,77 @@ msgid "" "(thanks to OpenSSL)." msgstr "" -#: library/hashlib.rst:178 +#: library/hashlib.rst:176 msgid "Hash Objects" msgstr "" -#: library/hashlib.rst:180 +#: library/hashlib.rst:178 msgid "" "The following values are provided as constant attributes of the hash objects " "returned by the constructors:" msgstr "" -#: library/hashlib.rst:185 +#: library/hashlib.rst:183 msgid "The size of the resulting hash in bytes." msgstr "" -#: library/hashlib.rst:189 +#: library/hashlib.rst:187 msgid "The internal block size of the hash algorithm in bytes." msgstr "" -#: library/hashlib.rst:191 +#: library/hashlib.rst:189 msgid "A hash object has the following attributes:" msgstr "" -#: library/hashlib.rst:195 +#: library/hashlib.rst:193 msgid "" "The canonical name of this hash, always lowercase and always suitable as a " "parameter to :func:`new` to create another hash of this type." msgstr "" -#: library/hashlib.rst:198 +#: library/hashlib.rst:196 msgid "" "The name attribute has been present in CPython since its inception, but " "until Python 3.4 was not formally specified, so may not exist on some " "platforms." msgstr "" -#: library/hashlib.rst:203 +#: library/hashlib.rst:201 msgid "A hash object has the following methods:" msgstr "" -#: library/hashlib.rst:208 +#: library/hashlib.rst:206 msgid "" "Update the hash object with the :term:`bytes-like object`. Repeated calls " "are equivalent to a single call with the concatenation of all the arguments: " "``m.update(a); m.update(b)`` is equivalent to ``m.update(a+b)``." msgstr "" -#: library/hashlib.rst:216 +#: library/hashlib.rst:214 msgid "" "Return the digest of the data passed to the :meth:`update` method so far. " "This is a bytes object of size :attr:`digest_size` which may contain bytes " "in the whole range from 0 to 255." msgstr "" -#: library/hashlib.rst:223 +#: library/hashlib.rst:221 msgid "" "Like :meth:`digest` except the digest is returned as a string object of " "double length, containing only hexadecimal digits. This may be used to " "exchange the value safely in email or other non-binary environments." msgstr "" -#: library/hashlib.rst:230 +#: library/hashlib.rst:228 msgid "" "Return a copy (\"clone\") of the hash object. This can be used to " "efficiently compute the digests of data sharing a common initial substring." msgstr "" -#: library/hashlib.rst:235 +#: library/hashlib.rst:233 msgid "SHAKE variable length digests" msgstr "" -#: library/hashlib.rst:240 +#: library/hashlib.rst:238 msgid "" "The :func:`shake_128` and :func:`shake_256` algorithms provide variable " "length digests with length_in_bits//2 up to 128 or 256 bits of security. As " @@ -260,40 +256,40 @@ msgid "" "by the SHAKE algorithm." msgstr "" -#: library/hashlib.rst:247 +#: library/hashlib.rst:245 msgid "" "Return the digest of the data passed to the :meth:`~hash.update` method so " "far. This is a bytes object of size *length* which may contain bytes in the " "whole range from 0 to 255." msgstr "" -#: library/hashlib.rst:254 +#: library/hashlib.rst:252 msgid "" "Like :meth:`digest` except the digest is returned as a string object of " "double length, containing only hexadecimal digits. This may be used to " "exchange the value in email or other non-binary environments." msgstr "" -#: library/hashlib.rst:258 +#: library/hashlib.rst:256 msgid "Example use:" msgstr "" -#: library/hashlib.rst:265 +#: library/hashlib.rst:263 msgid "File hashing" msgstr "" -#: library/hashlib.rst:267 +#: library/hashlib.rst:265 msgid "" "The hashlib module provides a helper function for efficient hashing of a " "file or file-like object." msgstr "" -#: library/hashlib.rst:272 +#: library/hashlib.rst:270 msgid "" "Return a digest object that has been updated with contents of file object." msgstr "" -#: library/hashlib.rst:274 +#: library/hashlib.rst:272 msgid "" "*fileobj* must be a file-like object opened for reading in binary mode. It " "accepts file objects from builtin :func:`open`, :class:`~io.BytesIO` " @@ -304,21 +300,21 @@ msgid "" "caller to close *fileobj*." msgstr "" -#: library/hashlib.rst:282 +#: library/hashlib.rst:280 msgid "" "*digest* must either be a hash algorithm name as a *str*, a hash " "constructor, or a callable that returns a hash object." msgstr "" -#: library/hashlib.rst:285 +#: library/hashlib.rst:283 msgid "Example:" msgstr "" -#: library/hashlib.rst:308 +#: library/hashlib.rst:306 msgid "Key derivation" msgstr "" -#: library/hashlib.rst:310 +#: library/hashlib.rst:308 msgid "" "Key derivation and key stretching algorithms are designed for secure " "password hashing. Naive algorithms such as ``sha1(password)`` are not " @@ -327,13 +323,13 @@ msgid "" "Salt_%28cryptography%29>`_." msgstr "" -#: library/hashlib.rst:318 +#: library/hashlib.rst:316 msgid "" "The function provides PKCS#5 password-based key derivation function 2. It " "uses HMAC as pseudorandom function." msgstr "" -#: library/hashlib.rst:321 +#: library/hashlib.rst:319 msgid "" "The string *hash_name* is the desired name of the hash digest algorithm for " "HMAC, e.g. 'sha1' or 'sha256'. *password* and *salt* are interpreted as " @@ -342,7 +338,7 @@ msgid "" "proper source, e.g. :func:`os.urandom`." msgstr "" -#: library/hashlib.rst:327 +#: library/hashlib.rst:325 msgid "" "The number of *iterations* should be chosen based on the hash algorithm and " "computing power. As of 2022, hundreds of thousands of iterations of SHA-256 " @@ -351,29 +347,29 @@ msgid "" "the `stackexchange pbkdf2 iterations question`_ explain in detail." msgstr "" -#: library/hashlib.rst:333 +#: library/hashlib.rst:331 msgid "" "*dklen* is the length of the derived key. If *dklen* is ``None`` then the " "digest size of the hash algorithm *hash_name* is used, e.g. 64 for SHA-512." msgstr "" -#: library/hashlib.rst:342 +#: library/hashlib.rst:340 msgid "Function only available when Python is compiled with OpenSSL." msgstr "" -#: library/hashlib.rst:346 +#: library/hashlib.rst:344 msgid "" "Function now only available when Python is built with OpenSSL. The slow pure " "Python implementation has been removed." msgstr "" -#: library/hashlib.rst:352 +#: library/hashlib.rst:350 msgid "" "The function provides scrypt password-based key derivation function as " "defined in :rfc:`7914`." msgstr "" -#: library/hashlib.rst:355 +#: library/hashlib.rst:353 msgid "" "*password* and *salt* must be :term:`bytes-like objects `. Applications and libraries should limit *password* to a sensible " @@ -381,138 +377,138 @@ msgid "" "source, e.g. :func:`os.urandom`." msgstr "" -#: library/hashlib.rst:360 +#: library/hashlib.rst:358 msgid "" "*n* is the CPU/Memory cost factor, *r* the block size, *p* parallelization " "factor and *maxmem* limits memory (OpenSSL 1.1.0 defaults to 32 MiB). " "*dklen* is the length of the derived key." msgstr "" -#: library/hashlib.rst:368 +#: library/hashlib.rst:366 msgid "BLAKE2" msgstr "" -#: library/hashlib.rst:375 +#: library/hashlib.rst:373 msgid "" "BLAKE2_ is a cryptographic hash function defined in :rfc:`7693` that comes " "in two flavors:" msgstr "" -#: library/hashlib.rst:378 +#: library/hashlib.rst:376 msgid "" "**BLAKE2b**, optimized for 64-bit platforms and produces digests of any size " "between 1 and 64 bytes," msgstr "" -#: library/hashlib.rst:381 +#: library/hashlib.rst:379 msgid "" "**BLAKE2s**, optimized for 8- to 32-bit platforms and produces digests of " "any size between 1 and 32 bytes." msgstr "" -#: library/hashlib.rst:384 +#: library/hashlib.rst:382 msgid "" "BLAKE2 supports **keyed mode** (a faster and simpler replacement for HMAC_), " "**salted hashing**, **personalization**, and **tree hashing**." msgstr "" -#: library/hashlib.rst:387 +#: library/hashlib.rst:385 msgid "" "Hash objects from this module follow the API of standard library's :mod:" "`hashlib` objects." msgstr "" -#: library/hashlib.rst:392 +#: library/hashlib.rst:390 msgid "Creating hash objects" msgstr "" -#: library/hashlib.rst:394 +#: library/hashlib.rst:392 msgid "New hash objects are created by calling constructor functions:" msgstr "" -#: library/hashlib.rst:408 +#: library/hashlib.rst:406 msgid "" "These functions return the corresponding hash objects for calculating " "BLAKE2b or BLAKE2s. They optionally take these general parameters:" msgstr "" -#: library/hashlib.rst:411 +#: library/hashlib.rst:409 msgid "" "*data*: initial chunk of data to hash, which must be :term:`bytes-like " "object`. It can be passed only as positional argument." msgstr "" -#: library/hashlib.rst:414 +#: library/hashlib.rst:412 msgid "*digest_size*: size of output digest in bytes." msgstr "" -#: library/hashlib.rst:416 +#: library/hashlib.rst:414 msgid "" "*key*: key for keyed hashing (up to 64 bytes for BLAKE2b, up to 32 bytes for " "BLAKE2s)." msgstr "" -#: library/hashlib.rst:419 +#: library/hashlib.rst:417 msgid "" "*salt*: salt for randomized hashing (up to 16 bytes for BLAKE2b, up to 8 " "bytes for BLAKE2s)." msgstr "" -#: library/hashlib.rst:422 +#: library/hashlib.rst:420 msgid "" "*person*: personalization string (up to 16 bytes for BLAKE2b, up to 8 bytes " "for BLAKE2s)." msgstr "" -#: library/hashlib.rst:425 +#: library/hashlib.rst:423 msgid "The following table shows limits for general parameters (in bytes):" msgstr "" -#: library/hashlib.rst:428 +#: library/hashlib.rst:426 msgid "Hash" msgstr "" -#: library/hashlib.rst:428 +#: library/hashlib.rst:426 msgid "digest_size" msgstr "" -#: library/hashlib.rst:428 +#: library/hashlib.rst:426 msgid "len(key)" msgstr "" -#: library/hashlib.rst:428 +#: library/hashlib.rst:426 msgid "len(salt)" msgstr "" -#: library/hashlib.rst:428 +#: library/hashlib.rst:426 msgid "len(person)" msgstr "" -#: library/hashlib.rst:430 +#: library/hashlib.rst:428 msgid "BLAKE2b" msgstr "" -#: library/hashlib.rst:430 +#: library/hashlib.rst:428 msgid "64" msgstr "" -#: library/hashlib.rst:430 +#: library/hashlib.rst:428 msgid "16" msgstr "" -#: library/hashlib.rst:431 +#: library/hashlib.rst:429 msgid "BLAKE2s" msgstr "" -#: library/hashlib.rst:431 +#: library/hashlib.rst:429 msgid "32" msgstr "" -#: library/hashlib.rst:431 +#: library/hashlib.rst:429 msgid "8" msgstr "" -#: library/hashlib.rst:436 +#: library/hashlib.rst:434 msgid "" "BLAKE2 specification defines constant lengths for salt and personalization " "parameters, however, for convenience, this implementation accepts byte " @@ -522,49 +518,49 @@ msgid "" "the case for *key*.)" msgstr "" -#: library/hashlib.rst:443 +#: library/hashlib.rst:441 msgid "These sizes are available as module `constants`_ described below." msgstr "" -#: library/hashlib.rst:445 +#: library/hashlib.rst:443 msgid "" "Constructor functions also accept the following tree hashing parameters:" msgstr "" -#: library/hashlib.rst:447 +#: library/hashlib.rst:445 msgid "*fanout*: fanout (0 to 255, 0 if unlimited, 1 in sequential mode)." msgstr "" -#: library/hashlib.rst:449 +#: library/hashlib.rst:447 msgid "" "*depth*: maximal depth of tree (1 to 255, 255 if unlimited, 1 in sequential " "mode)." msgstr "" -#: library/hashlib.rst:452 +#: library/hashlib.rst:450 msgid "" "*leaf_size*: maximal byte length of leaf (0 to ``2**32-1``, 0 if unlimited " "or in sequential mode)." msgstr "" -#: library/hashlib.rst:455 +#: library/hashlib.rst:453 msgid "" "*node_offset*: node offset (0 to ``2**64-1`` for BLAKE2b, 0 to ``2**48-1`` " "for BLAKE2s, 0 for the first, leftmost, leaf, or in sequential mode)." msgstr "" -#: library/hashlib.rst:458 +#: library/hashlib.rst:456 msgid "" "*node_depth*: node depth (0 to 255, 0 for leaves, or in sequential mode)." msgstr "" -#: library/hashlib.rst:460 +#: library/hashlib.rst:458 msgid "" "*inner_size*: inner digest size (0 to 64 for BLAKE2b, 0 to 32 for BLAKE2s, 0 " "in sequential mode)." msgstr "" -#: library/hashlib.rst:463 +#: library/hashlib.rst:461 msgid "" "*last_node*: boolean indicating whether the processed node is the last one " "(``False`` for sequential mode)." @@ -574,42 +570,42 @@ msgstr "" msgid "Explanation of tree mode parameters." msgstr "" -#: library/hashlib.rst:470 +#: library/hashlib.rst:468 msgid "" "See section 2.10 in `BLAKE2 specification `_ for comprehensive review of tree hashing." msgstr "" -#: library/hashlib.rst:476 +#: library/hashlib.rst:474 msgid "Constants" msgstr "" -#: library/hashlib.rst:481 +#: library/hashlib.rst:479 msgid "Salt length (maximum length accepted by constructors)." msgstr "" -#: library/hashlib.rst:487 +#: library/hashlib.rst:485 msgid "" "Personalization string length (maximum length accepted by constructors)." msgstr "" -#: library/hashlib.rst:493 +#: library/hashlib.rst:491 msgid "Maximum key size." msgstr "" -#: library/hashlib.rst:499 +#: library/hashlib.rst:497 msgid "Maximum digest size that the hash function can output." msgstr "" -#: library/hashlib.rst:503 +#: library/hashlib.rst:501 msgid "Examples" msgstr "" -#: library/hashlib.rst:506 +#: library/hashlib.rst:504 msgid "Simple hashing" msgstr "" -#: library/hashlib.rst:508 +#: library/hashlib.rst:506 msgid "" "To calculate hash of some data, you should first construct a hash object by " "calling the appropriate constructor function (:func:`blake2b` or :func:" @@ -618,41 +614,41 @@ msgid "" "`~hash.digest` (or :meth:`~hash.hexdigest` for hex-encoded string)." msgstr "" -#: library/hashlib.rst:521 +#: library/hashlib.rst:519 msgid "" "As a shortcut, you can pass the first chunk of data to update directly to " "the constructor as the positional argument:" msgstr "" -#: library/hashlib.rst:528 +#: library/hashlib.rst:526 msgid "" "You can call :meth:`hash.update` as many times as you need to iteratively " "update the hash:" msgstr "" -#: library/hashlib.rst:542 +#: library/hashlib.rst:540 msgid "Using different digest sizes" msgstr "" -#: library/hashlib.rst:544 +#: library/hashlib.rst:542 msgid "" "BLAKE2 has configurable size of digests up to 64 bytes for BLAKE2b and up to " "32 bytes for BLAKE2s. For example, to replace SHA-1 with BLAKE2b without " "changing the size of output, we can tell BLAKE2b to produce 20-byte digests:" msgstr "" -#: library/hashlib.rst:558 +#: library/hashlib.rst:556 msgid "" "Hash objects with different digest sizes have completely different outputs " "(shorter hashes are *not* prefixes of longer hashes); BLAKE2b and BLAKE2s " "produce different outputs even if the output length is the same:" msgstr "" -#: library/hashlib.rst:574 +#: library/hashlib.rst:572 msgid "Keyed hashing" msgstr "" -#: library/hashlib.rst:576 +#: library/hashlib.rst:574 msgid "" "Keyed hashing can be used for authentication as a faster and simpler " "replacement for `Hash-based message authentication code `_)" msgstr "" -#: library/hashlib.rst:660 +#: library/hashlib.rst:658 msgid "" "In BLAKE2 the salt is processed as a one-time input to the hash function " "during initialization, rather than as an input to each compression function." msgstr "" -#: library/hashlib.rst:665 +#: library/hashlib.rst:663 msgid "" "*Salted hashing* (or just hashing) with BLAKE2 or any other general-purpose " "cryptographic hash function, such as SHA-256, is not suitable for hashing " @@ -730,18 +726,18 @@ msgid "" "information." msgstr "" -#: library/hashlib.rst:688 +#: library/hashlib.rst:686 msgid "Personalization" msgstr "" -#: library/hashlib.rst:690 +#: library/hashlib.rst:688 msgid "" "Sometimes it is useful to force hash function to produce different digests " "for the same input for different purposes. Quoting the authors of the Skein " "hash function:" msgstr "" -#: library/hashlib.rst:694 +#: library/hashlib.rst:692 msgid "" "We recommend that all application designers seriously consider doing this; " "we have seen many protocols where a hash that is computed in one part of the " @@ -751,41 +747,41 @@ msgid "" "hash function used in the protocol summarily stops this type of attack." msgstr "" -#: library/hashlib.rst:701 +#: library/hashlib.rst:699 msgid "" "(`The Skein Hash Function Family `_, p. 21)" msgstr "" -#: library/hashlib.rst:705 +#: library/hashlib.rst:703 msgid "BLAKE2 can be personalized by passing bytes to the *person* argument::" msgstr "" -#: library/hashlib.rst:719 +#: library/hashlib.rst:717 msgid "" "Personalization together with the keyed mode can also be used to derive " "different keys from a single one." msgstr "" -#: library/hashlib.rst:733 +#: library/hashlib.rst:731 msgid "Tree mode" msgstr "" -#: library/hashlib.rst:735 +#: library/hashlib.rst:733 msgid "Here's an example of hashing a minimal tree with two leaf nodes::" msgstr "" -#: library/hashlib.rst:741 +#: library/hashlib.rst:739 msgid "" "This example uses 64-byte internal digests, and returns the 32-byte final " "digest::" msgstr "" -#: library/hashlib.rst:771 +#: library/hashlib.rst:769 msgid "Credits" msgstr "" -#: library/hashlib.rst:773 +#: library/hashlib.rst:771 msgid "" "BLAKE2_ was designed by *Jean-Philippe Aumasson*, *Samuel Neves*, *Zooko " "Wilcox-O'Hearn*, and *Christian Winnerlein* based on SHA-3_ finalist BLAKE_ " @@ -793,118 +789,118 @@ msgid "" "*Raphael C.-W. Phan*." msgstr "" -#: library/hashlib.rst:778 +#: library/hashlib.rst:776 msgid "" "It uses core algorithm from ChaCha_ cipher designed by *Daniel J. " "Bernstein*." msgstr "" -#: library/hashlib.rst:780 +#: library/hashlib.rst:778 msgid "" "The stdlib implementation is based on pyblake2_ module. It was written by " "*Dmitry Chestnykh* based on C implementation written by *Samuel Neves*. The " "documentation was copied from pyblake2_ and written by *Dmitry Chestnykh*." msgstr "" -#: library/hashlib.rst:784 +#: library/hashlib.rst:782 msgid "The C code was partly rewritten for Python by *Christian Heimes*." msgstr "" -#: library/hashlib.rst:786 +#: library/hashlib.rst:784 msgid "" "The following public domain dedication applies for both C hash function " "implementation, extension code, and this documentation:" msgstr "" -#: library/hashlib.rst:789 +#: library/hashlib.rst:787 msgid "" "To the extent possible under law, the author(s) have dedicated all copyright " "and related and neighboring rights to this software to the public domain " "worldwide. This software is distributed without any warranty." msgstr "" -#: library/hashlib.rst:793 +#: library/hashlib.rst:791 msgid "" "You should have received a copy of the CC0 Public Domain Dedication along " "with this software. If not, see https://creativecommons.org/publicdomain/" "zero/1.0/." msgstr "" -#: library/hashlib.rst:797 +#: library/hashlib.rst:795 msgid "" "The following people have helped with development or contributed their " "changes to the project and the public domain according to the Creative " "Commons Public Domain Dedication 1.0 Universal:" msgstr "" -#: library/hashlib.rst:801 +#: library/hashlib.rst:799 msgid "*Alexandr Sokolovskiy*" msgstr "" -#: library/hashlib.rst:822 +#: library/hashlib.rst:820 msgid "Module :mod:`hmac`" msgstr "" -#: library/hashlib.rst:822 +#: library/hashlib.rst:820 msgid "A module to generate message authentication codes using hashes." msgstr "" -#: library/hashlib.rst:825 +#: library/hashlib.rst:823 msgid "Module :mod:`base64`" msgstr "" -#: library/hashlib.rst:825 +#: library/hashlib.rst:823 msgid "Another way to encode binary hashes for non-binary environments." msgstr "" -#: library/hashlib.rst:828 +#: library/hashlib.rst:826 msgid "https://nvlpubs.nist.gov/nistpubs/fips/nist.fips.180-4.pdf" msgstr "" -#: library/hashlib.rst:828 +#: library/hashlib.rst:826 msgid "The FIPS 180-4 publication on Secure Hash Algorithms." msgstr "" -#: library/hashlib.rst:831 +#: library/hashlib.rst:829 msgid "https://csrc.nist.gov/publications/detail/fips/202/final" msgstr "" -#: library/hashlib.rst:831 +#: library/hashlib.rst:829 msgid "The FIPS 202 publication on the SHA-3 Standard." msgstr "" -#: library/hashlib.rst:834 +#: library/hashlib.rst:832 msgid "https://www.blake2.net/" msgstr "" -#: library/hashlib.rst:834 +#: library/hashlib.rst:832 msgid "Official BLAKE2 website." msgstr "" -#: library/hashlib.rst:838 +#: library/hashlib.rst:836 msgid "https://en.wikipedia.org/wiki/Cryptographic_hash_function" msgstr "" -#: library/hashlib.rst:837 +#: library/hashlib.rst:835 msgid "" "Wikipedia article with information on which algorithms have known issues and " "what that means regarding their use." msgstr "" -#: library/hashlib.rst:841 +#: library/hashlib.rst:839 msgid "https://www.ietf.org/rfc/rfc8018.txt" msgstr "" -#: library/hashlib.rst:841 +#: library/hashlib.rst:839 msgid "PKCS #5: Password-Based Cryptography Specification Version 2.1" msgstr "" -#: library/hashlib.rst:843 +#: library/hashlib.rst:841 msgid "" "https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-132.pdf" msgstr "" -#: library/hashlib.rst:844 +#: library/hashlib.rst:842 msgid "NIST Recommendation for Password-Based Key Derivation." msgstr "" @@ -926,6 +922,6 @@ msgstr "" msgid "(use in module hashlib)" msgstr "" -#: library/hashlib.rst:372 +#: library/hashlib.rst:370 msgid "blake2b, blake2s" msgstr "" diff --git a/library/http.server.po b/library/http.server.po index 801c85fc1..f3326ea96 100644 --- a/library/http.server.po +++ b/library/http.server.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -616,18 +616,25 @@ msgid "" "the ``--cgi`` option::" msgstr "" -#: library/http.server.rst:513 +#: library/http.server.rst:512 +msgid "" +":class:`CGIHTTPRequestHandler` and the ``--cgi`` command line option are not " +"intended for use by untrusted clients and may be vulnerable to exploitation. " +"Always use within a secure environment." +msgstr "" + +#: library/http.server.rst:519 msgid "Security Considerations" msgstr "" -#: library/http.server.rst:517 +#: library/http.server.rst:523 msgid "" ":class:`SimpleHTTPRequestHandler` will follow symbolic links when handling " "requests, this makes it possible for files outside of the specified " "directory to be served." msgstr "" -#: library/http.server.rst:521 +#: library/http.server.rst:527 msgid "" "Earlier versions of Python did not scrub control characters from the log " "messages emitted to stderr from ``python -m http.server`` or the default :" @@ -636,7 +643,7 @@ msgid "" "codes to your terminal." msgstr "" -#: library/http.server.rst:527 +#: library/http.server.rst:533 msgid "Control characters are scrubbed in stderr logs." msgstr "" @@ -664,10 +671,10 @@ msgstr "" msgid "httpd" msgstr "" -#: library/http.server.rst:515 +#: library/http.server.rst:521 msgid "http.server" msgstr "" -#: library/http.server.rst:515 +#: library/http.server.rst:521 msgid "security" msgstr "" diff --git a/library/idle.po b/library/idle.po index a1e1bce8b..025ad6640 100644 --- a/library/idle.po +++ b/library/idle.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1080,7 +1080,7 @@ msgid "" msgstr "" #: library/idle.rst:607 -msgid ":kbd:`C-c` attemps to interrupt statement execution (but may fail)." +msgid ":kbd:`C-c` attempts to interrupt statement execution (but may fail)." msgstr "" #: library/idle.rst:609 diff --git a/library/importlib.metadata.po b/library/importlib.metadata.po index cbe18689a..0b24fa02e 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: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -242,22 +242,22 @@ msgstr "" msgid "The ``json`` attribute was added." msgstr "" -#: library/importlib.metadata.rst:227 +#: library/importlib.metadata.rst:226 msgid "Distribution versions" msgstr "" -#: library/importlib.metadata.rst:229 +#: library/importlib.metadata.rst:228 msgid "" "The ``version()`` function is the quickest way to get a `Distribution " "Package `_'s version number, as a string::" msgstr "" -#: library/importlib.metadata.rst:240 +#: library/importlib.metadata.rst:239 msgid "Distribution files" msgstr "" -#: library/importlib.metadata.rst:242 +#: library/importlib.metadata.rst:241 msgid "" "You can also get the full set of files contained within a distribution. The " "``files()`` function takes a `Distribution Package `_, use " "the ``requires()`` function::" msgstr "" -#: library/importlib.metadata.rst:301 +#: library/importlib.metadata.rst:300 msgid "Mapping import to distribution packages" msgstr "" -#: library/importlib.metadata.rst:303 +#: library/importlib.metadata.rst:302 msgid "" "A convenience method to resolve the `Distribution Package `_ name (or names, " @@ -312,18 +312,18 @@ msgid "" "glossary/#term-Import-Package>`_::" msgstr "" -#: library/importlib.metadata.rst:311 +#: library/importlib.metadata.rst:310 msgid "" "Some editable installs, `do not supply top-level names `_, and thus this function is not " "reliable with such installs." msgstr "" -#: library/importlib.metadata.rst:320 +#: library/importlib.metadata.rst:319 msgid "Distributions" msgstr "" -#: library/importlib.metadata.rst:322 +#: library/importlib.metadata.rst:321 msgid "" "While the above API is the most common and convenient usage, you can get all " "of that information from the ``Distribution`` class. A ``Distribution`` is " @@ -332,30 +332,30 @@ msgid "" "Package>`_. You can get the ``Distribution`` instance::" msgstr "" -#: library/importlib.metadata.rst:331 +#: library/importlib.metadata.rst:330 msgid "" "Thus, an alternative way to get the version number is through the " "``Distribution`` instance::" msgstr "" -#: library/importlib.metadata.rst:337 +#: library/importlib.metadata.rst:336 msgid "" "There are all kinds of additional metadata available on the ``Distribution`` " "instance::" msgstr "" -#: library/importlib.metadata.rst:345 +#: library/importlib.metadata.rst:344 msgid "" "The full set of available metadata is not described here. See the `Core " "metadata specifications `_ for additional details." msgstr "" -#: library/importlib.metadata.rst:350 +#: library/importlib.metadata.rst:349 msgid "Distribution Discovery" msgstr "" -#: library/importlib.metadata.rst:352 +#: library/importlib.metadata.rst:351 msgid "" "By default, this package provides built-in support for discovery of metadata " "for file system and zip file `Distribution Package `_ metadata is not available through :" @@ -390,14 +390,14 @@ msgid "" "on :data:`sys.meta_path`." msgstr "" -#: library/importlib.metadata.rst:371 +#: library/importlib.metadata.rst:370 msgid "" "By default ``importlib.metadata`` installs a finder for distribution " "packages found on the file system. This finder doesn't actually find any " "*distributions*, but it can find their metadata." msgstr "" -#: library/importlib.metadata.rst:376 +#: library/importlib.metadata.rst:375 msgid "" "The abstract class :py:class:`importlib.abc.MetaPathFinder` defines the " "interface expected of finders by Python's import system. ``importlib." @@ -407,14 +407,14 @@ msgid "" "base class, which defines this abstract method::" msgstr "" -#: library/importlib.metadata.rst:390 +#: library/importlib.metadata.rst:389 msgid "" "The ``DistributionFinder.Context`` object provides ``.path`` and ``.name`` " "properties indicating the path to search and name to match and may supply " "other relevant context." msgstr "" -#: library/importlib.metadata.rst:394 +#: library/importlib.metadata.rst:393 msgid "" "What this means in practice is that to support finding distribution package " "metadata in locations other than the file system, subclass ``Distribution`` " diff --git a/library/inspect.po b/library/inspect.po index 5947fef4e..0adfc3adf 100644 --- a/library/inspect.po +++ b/library/inspect.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -71,15 +71,15 @@ msgstr "" msgid "class" msgstr "" -#: library/inspect.rst:58 library/inspect.rst:238 +#: library/inspect.rst:63 library/inspect.rst:248 msgid "__doc__" msgstr "" -#: library/inspect.rst:58 library/inspect.rst:238 +#: library/inspect.rst:63 library/inspect.rst:248 msgid "documentation string" msgstr "" -#: library/inspect.rst:60 library/inspect.rst:207 library/inspect.rst:240 +#: library/inspect.rst:65 library/inspect.rst:217 library/inspect.rst:250 msgid "__name__" msgstr "" @@ -87,15 +87,15 @@ msgstr "" msgid "name with which this class was defined" msgstr "" -#: library/inspect.rst:63 library/inspect.rst:209 library/inspect.rst:243 +#: library/inspect.rst:68 library/inspect.rst:219 library/inspect.rst:253 msgid "__qualname__" msgstr "" -#: library/inspect.rst:63 library/inspect.rst:209 library/inspect.rst:243 +#: library/inspect.rst:68 library/inspect.rst:219 library/inspect.rst:253 msgid "qualified name" msgstr "" -#: library/inspect.rst:73 library/inspect.rst:106 +#: library/inspect.rst:78 library/inspect.rst:116 msgid "__module__" msgstr "" @@ -103,434 +103,450 @@ msgstr "" msgid "name of module in which this class was defined" msgstr "" +#: library/inspect.rst:111 +msgid "__type_params__" +msgstr "" + #: library/inspect.rst:58 +msgid "" +"A tuple containing the :ref:`type parameters ` of a generic " +"class" +msgstr "" + +#: library/inspect.rst:63 msgid "method" msgstr "" -#: library/inspect.rst:60 +#: library/inspect.rst:65 msgid "name with which this method was defined" msgstr "" -#: library/inspect.rst:65 +#: library/inspect.rst:70 msgid "__func__" msgstr "" -#: library/inspect.rst:65 +#: library/inspect.rst:70 msgid "function object containing implementation of method" msgstr "" -#: library/inspect.rst:245 +#: library/inspect.rst:255 msgid "__self__" msgstr "" -#: library/inspect.rst:69 +#: library/inspect.rst:74 msgid "instance to which this method is bound, or ``None``" msgstr "" -#: library/inspect.rst:73 +#: library/inspect.rst:78 msgid "name of module in which this method was defined" msgstr "" -#: library/inspect.rst:76 +#: library/inspect.rst:81 msgid "function" msgstr "" -#: library/inspect.rst:78 +#: library/inspect.rst:83 msgid "name with which this function was defined" msgstr "" -#: library/inspect.rst:83 +#: library/inspect.rst:88 msgid "__code__" msgstr "" -#: library/inspect.rst:83 +#: library/inspect.rst:88 msgid "code object containing compiled function :term:`bytecode`" msgstr "" -#: library/inspect.rst:87 +#: library/inspect.rst:92 msgid "__defaults__" msgstr "" -#: library/inspect.rst:87 +#: library/inspect.rst:92 msgid "tuple of any default values for positional or keyword parameters" msgstr "" -#: library/inspect.rst:91 +#: library/inspect.rst:96 msgid "__kwdefaults__" msgstr "" -#: library/inspect.rst:91 +#: library/inspect.rst:96 msgid "mapping of any default values for keyword-only parameters" msgstr "" -#: library/inspect.rst:95 +#: library/inspect.rst:100 msgid "__globals__" msgstr "" -#: library/inspect.rst:95 +#: library/inspect.rst:100 msgid "global namespace in which this function was defined" msgstr "" -#: library/inspect.rst:98 +#: library/inspect.rst:103 msgid "__builtins__" msgstr "" -#: library/inspect.rst:98 +#: library/inspect.rst:103 msgid "builtins namespace" msgstr "" -#: library/inspect.rst:100 +#: library/inspect.rst:105 msgid "__annotations__" msgstr "" -#: library/inspect.rst:100 +#: library/inspect.rst:105 msgid "" "mapping of parameters names to annotations; ``\"return\"`` key is reserved " "for return annotations." msgstr "" -#: library/inspect.rst:106 +#: library/inspect.rst:111 +msgid "" +"A tuple containing the :ref:`type parameters ` of a generic " +"function" +msgstr "" + +#: library/inspect.rst:116 msgid "name of module in which this function was defined" msgstr "" -#: library/inspect.rst:109 +#: library/inspect.rst:119 msgid "traceback" msgstr "" -#: library/inspect.rst:109 +#: library/inspect.rst:119 msgid "tb_frame" msgstr "" -#: library/inspect.rst:109 +#: library/inspect.rst:119 msgid "frame object at this level" msgstr "" -#: library/inspect.rst:112 +#: library/inspect.rst:122 msgid "tb_lasti" msgstr "" -#: library/inspect.rst:134 +#: library/inspect.rst:144 msgid "index of last attempted instruction in bytecode" msgstr "" -#: library/inspect.rst:115 +#: library/inspect.rst:125 msgid "tb_lineno" msgstr "" -#: library/inspect.rst:137 +#: library/inspect.rst:147 msgid "current line number in Python source code" msgstr "" -#: library/inspect.rst:118 +#: library/inspect.rst:128 msgid "tb_next" msgstr "" -#: library/inspect.rst:118 +#: library/inspect.rst:128 msgid "next inner traceback object (called by this level)" msgstr "" -#: library/inspect.rst:211 library/inspect.rst:228 +#: library/inspect.rst:221 library/inspect.rst:238 msgid "frame" msgstr "" -#: library/inspect.rst:122 +#: library/inspect.rst:132 msgid "f_back" msgstr "" -#: library/inspect.rst:122 +#: library/inspect.rst:132 msgid "next outer frame object (this frame's caller)" msgstr "" -#: library/inspect.rst:125 +#: library/inspect.rst:135 msgid "f_builtins" msgstr "" -#: library/inspect.rst:125 +#: library/inspect.rst:135 msgid "builtins namespace seen by this frame" msgstr "" -#: library/inspect.rst:128 +#: library/inspect.rst:138 msgid "f_code" msgstr "" -#: library/inspect.rst:128 +#: library/inspect.rst:138 msgid "code object being executed in this frame" msgstr "" -#: library/inspect.rst:131 +#: library/inspect.rst:141 msgid "f_globals" msgstr "" -#: library/inspect.rst:131 +#: library/inspect.rst:141 msgid "global namespace seen by this frame" msgstr "" -#: library/inspect.rst:134 +#: library/inspect.rst:144 msgid "f_lasti" msgstr "" -#: library/inspect.rst:137 +#: library/inspect.rst:147 msgid "f_lineno" msgstr "" -#: library/inspect.rst:140 +#: library/inspect.rst:150 msgid "f_locals" msgstr "" -#: library/inspect.rst:140 +#: library/inspect.rst:150 msgid "local namespace seen by this frame" msgstr "" -#: library/inspect.rst:143 +#: library/inspect.rst:153 msgid "f_trace" msgstr "" -#: library/inspect.rst:143 +#: library/inspect.rst:153 msgid "tracing function for this frame, or ``None``" msgstr "" -#: library/inspect.rst:215 library/inspect.rst:232 +#: library/inspect.rst:225 library/inspect.rst:242 msgid "code" msgstr "" -#: library/inspect.rst:146 +#: library/inspect.rst:156 msgid "co_argcount" msgstr "" -#: library/inspect.rst:146 +#: library/inspect.rst:156 msgid "" "number of arguments (not including keyword only arguments, \\* or \\*\\* " "args)" msgstr "" -#: library/inspect.rst:151 +#: library/inspect.rst:161 msgid "co_code" msgstr "" -#: library/inspect.rst:151 +#: library/inspect.rst:161 msgid "string of raw compiled bytecode" msgstr "" -#: library/inspect.rst:154 +#: library/inspect.rst:164 msgid "co_cellvars" msgstr "" -#: library/inspect.rst:154 +#: library/inspect.rst:164 msgid "tuple of names of cell variables (referenced by containing scopes)" msgstr "" -#: library/inspect.rst:158 +#: library/inspect.rst:168 msgid "co_consts" msgstr "" -#: library/inspect.rst:158 +#: library/inspect.rst:168 msgid "tuple of constants used in the bytecode" msgstr "" -#: library/inspect.rst:161 +#: library/inspect.rst:171 msgid "co_filename" msgstr "" -#: library/inspect.rst:161 +#: library/inspect.rst:171 msgid "name of file in which this code object was created" msgstr "" -#: library/inspect.rst:165 +#: library/inspect.rst:175 msgid "co_firstlineno" msgstr "" -#: library/inspect.rst:165 +#: library/inspect.rst:175 msgid "number of first line in Python source code" msgstr "" -#: library/inspect.rst:168 +#: library/inspect.rst:178 msgid "co_flags" msgstr "" -#: library/inspect.rst:168 +#: library/inspect.rst:178 msgid "" "bitmap of ``CO_*`` flags, read more :ref:`here `" msgstr "" -#: library/inspect.rst:172 +#: library/inspect.rst:182 msgid "co_lnotab" msgstr "" -#: library/inspect.rst:172 +#: library/inspect.rst:182 msgid "encoded mapping of line numbers to bytecode indices" msgstr "" -#: library/inspect.rst:176 +#: library/inspect.rst:186 msgid "co_freevars" msgstr "" -#: library/inspect.rst:176 +#: library/inspect.rst:186 msgid "tuple of names of free variables (referenced via a function's closure)" msgstr "" -#: library/inspect.rst:180 +#: library/inspect.rst:190 msgid "co_posonlyargcount" msgstr "" -#: library/inspect.rst:180 +#: library/inspect.rst:190 msgid "number of positional only arguments" msgstr "" -#: library/inspect.rst:183 +#: library/inspect.rst:193 msgid "co_kwonlyargcount" msgstr "" -#: library/inspect.rst:183 +#: library/inspect.rst:193 msgid "number of keyword only arguments (not including \\*\\* arg)" msgstr "" -#: library/inspect.rst:187 +#: library/inspect.rst:197 msgid "co_name" msgstr "" -#: library/inspect.rst:187 +#: library/inspect.rst:197 msgid "name with which this code object was defined" msgstr "" -#: library/inspect.rst:190 +#: library/inspect.rst:200 msgid "co_qualname" msgstr "" -#: library/inspect.rst:190 +#: library/inspect.rst:200 msgid "fully qualified name with which this code object was defined" msgstr "" -#: library/inspect.rst:194 +#: library/inspect.rst:204 msgid "co_names" msgstr "" -#: library/inspect.rst:194 +#: library/inspect.rst:204 msgid "tuple of names other than arguments and function locals" msgstr "" -#: library/inspect.rst:198 +#: library/inspect.rst:208 msgid "co_nlocals" msgstr "" -#: library/inspect.rst:198 +#: library/inspect.rst:208 msgid "number of local variables" msgstr "" -#: library/inspect.rst:200 +#: library/inspect.rst:210 msgid "co_stacksize" msgstr "" -#: library/inspect.rst:200 +#: library/inspect.rst:210 msgid "virtual machine stack space required" msgstr "" -#: library/inspect.rst:203 +#: library/inspect.rst:213 msgid "co_varnames" msgstr "" -#: library/inspect.rst:203 +#: library/inspect.rst:213 msgid "tuple of names of arguments and local variables" msgstr "" -#: library/inspect.rst:207 +#: library/inspect.rst:217 msgid "generator" msgstr "" -#: library/inspect.rst:221 +#: library/inspect.rst:231 msgid "name" msgstr "" -#: library/inspect.rst:211 +#: library/inspect.rst:221 msgid "gi_frame" msgstr "" -#: library/inspect.rst:213 +#: library/inspect.rst:223 msgid "gi_running" msgstr "" -#: library/inspect.rst:213 +#: library/inspect.rst:223 msgid "is the generator running?" msgstr "" -#: library/inspect.rst:215 +#: library/inspect.rst:225 msgid "gi_code" msgstr "" -#: library/inspect.rst:217 +#: library/inspect.rst:227 msgid "gi_yieldfrom" msgstr "" -#: library/inspect.rst:217 +#: library/inspect.rst:227 msgid "object being iterated by ``yield from``, or ``None``" msgstr "" -#: library/inspect.rst:221 +#: library/inspect.rst:231 msgid "coroutine" msgstr "" -#: library/inspect.rst:225 +#: library/inspect.rst:235 msgid "cr_await" msgstr "" -#: library/inspect.rst:225 +#: library/inspect.rst:235 msgid "object being awaited on, or ``None``" msgstr "" -#: library/inspect.rst:228 +#: library/inspect.rst:238 msgid "cr_frame" msgstr "" -#: library/inspect.rst:230 +#: library/inspect.rst:240 msgid "cr_running" msgstr "" -#: library/inspect.rst:230 +#: library/inspect.rst:240 msgid "is the coroutine running?" msgstr "" -#: library/inspect.rst:232 +#: library/inspect.rst:242 msgid "cr_code" msgstr "" -#: library/inspect.rst:234 +#: library/inspect.rst:244 msgid "cr_origin" msgstr "" -#: library/inspect.rst:234 +#: library/inspect.rst:244 msgid "where coroutine was created, or ``None``. See |coroutine-origin-link|" msgstr "" -#: library/inspect.rst:238 +#: library/inspect.rst:248 msgid "builtin" msgstr "" -#: library/inspect.rst:240 +#: library/inspect.rst:250 msgid "original name of this function or method" msgstr "" -#: library/inspect.rst:245 +#: library/inspect.rst:255 msgid "instance to which a method is bound, or ``None``" msgstr "" -#: library/inspect.rst:252 +#: library/inspect.rst:262 msgid "Add ``__qualname__`` and ``gi_yieldfrom`` attributes to generators." msgstr "" -#: library/inspect.rst:254 +#: library/inspect.rst:264 msgid "" "The ``__name__`` attribute of generators is now set from the function name, " "instead of the code name, and it can now be modified." msgstr "" -#: library/inspect.rst:259 +#: library/inspect.rst:269 msgid "Add ``cr_origin`` attribute to coroutines." msgstr "" -#: library/inspect.rst:263 +#: library/inspect.rst:273 msgid "Add ``__builtins__`` attribute to functions." msgstr "" -#: library/inspect.rst:267 +#: library/inspect.rst:277 msgid "" "Return all the members of an object in a list of ``(name, value)`` pairs " "sorted by name. If the optional *predicate* argument—which will be called " @@ -538,14 +554,14 @@ msgid "" "the predicate returns a true value are included." msgstr "" -#: library/inspect.rst:274 +#: library/inspect.rst:284 msgid "" ":func:`getmembers` will only return class attributes defined in the " "metaclass when the argument is a class and those attributes have been listed " "in the metaclass' custom :meth:`~object.__dir__`." msgstr "" -#: library/inspect.rst:281 +#: library/inspect.rst:291 msgid "" "Return all the members of an object in a list of ``(name, value)`` pairs " "sorted by name without triggering dynamic lookup via the descriptor " @@ -553,7 +569,7 @@ msgid "" "that satisfy a given predicate." msgstr "" -#: library/inspect.rst:288 +#: library/inspect.rst:298 msgid "" ":func:`getmembers_static` may not be able to retrieve all members that " "getmembers can fetch (like dynamically created attributes) and may find " @@ -562,7 +578,7 @@ msgid "" "cases." msgstr "" -#: library/inspect.rst:299 +#: library/inspect.rst:309 msgid "" "Return the name of the module named by the file *path*, without including " "the names of enclosing packages. The file extension is checked against all " @@ -571,52 +587,52 @@ msgid "" "``None`` is returned." msgstr "" -#: library/inspect.rst:305 +#: library/inspect.rst:315 msgid "" "Note that this function *only* returns a meaningful name for actual Python " "modules - paths that potentially refer to Python packages will still return " "``None``." msgstr "" -#: library/inspect.rst:309 +#: library/inspect.rst:319 msgid "The function is based directly on :mod:`importlib`." msgstr "" -#: library/inspect.rst:315 +#: library/inspect.rst:325 msgid "Return ``True`` if the object is a module." msgstr "" -#: library/inspect.rst:320 +#: library/inspect.rst:330 msgid "" "Return ``True`` if the object is a class, whether built-in or created in " "Python code." msgstr "" -#: library/inspect.rst:326 +#: library/inspect.rst:336 msgid "Return ``True`` if the object is a bound method written in Python." msgstr "" -#: library/inspect.rst:331 +#: library/inspect.rst:341 msgid "" "Return ``True`` if the object is a Python function, which includes functions " "created by a :term:`lambda` expression." msgstr "" -#: library/inspect.rst:337 +#: library/inspect.rst:347 msgid "Return ``True`` if the object is a Python generator function." msgstr "" -#: library/inspect.rst:339 +#: library/inspect.rst:349 msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " "wrapped function is a Python generator function." msgstr "" -#: library/inspect.rst:346 +#: library/inspect.rst:356 msgid "Return ``True`` if the object is a generator." msgstr "" -#: library/inspect.rst:351 +#: library/inspect.rst:361 msgid "" "Return ``True`` if the object is a :term:`coroutine function` (a function " "defined with an :keyword:`async def` syntax), a :func:`functools.partial` " @@ -624,118 +640,118 @@ msgid "" "`markcoroutinefunction`." msgstr "" -#: library/inspect.rst:358 +#: library/inspect.rst:368 msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " "wrapped function is a :term:`coroutine function`." msgstr "" -#: library/inspect.rst:362 +#: library/inspect.rst:372 msgid "" "Sync functions marked with :func:`markcoroutinefunction` now return ``True``." msgstr "" -#: library/inspect.rst:369 +#: library/inspect.rst:379 msgid "" "Decorator to mark a callable as a :term:`coroutine function` if it would not " "otherwise be detected by :func:`iscoroutinefunction`." msgstr "" -#: library/inspect.rst:372 +#: library/inspect.rst:382 msgid "" "This may be of use for sync functions that return a :term:`coroutine`, if " "the function is passed to an API that requires :func:`iscoroutinefunction`." msgstr "" -#: library/inspect.rst:375 +#: library/inspect.rst:385 msgid "" "When possible, using an :keyword:`async def` function is preferred. Also " "acceptable is calling the function and testing the return with :func:" "`iscoroutine`." msgstr "" -#: library/inspect.rst:384 +#: library/inspect.rst:394 msgid "" "Return ``True`` if the object is a :term:`coroutine` created by an :keyword:" "`async def` function." msgstr "" -#: library/inspect.rst:392 +#: library/inspect.rst:402 msgid "" "Return ``True`` if the object can be used in :keyword:`await` expression." msgstr "" -#: library/inspect.rst:394 +#: library/inspect.rst:404 msgid "" "Can also be used to distinguish generator-based coroutines from regular " "generators:" msgstr "" -#: library/inspect.rst:415 +#: library/inspect.rst:425 msgid "" "Return ``True`` if the object is an :term:`asynchronous generator` function, " "for example:" msgstr "" -#: library/inspect.rst:428 +#: library/inspect.rst:438 msgid "" "Functions wrapped in :func:`functools.partial` now return ``True`` if the " "wrapped function is a :term:`asynchronous generator` function." msgstr "" -#: library/inspect.rst:435 +#: library/inspect.rst:445 msgid "" "Return ``True`` if the object is an :term:`asynchronous generator iterator` " "created by an :term:`asynchronous generator` function." msgstr "" -#: library/inspect.rst:442 +#: library/inspect.rst:452 msgid "Return ``True`` if the object is a traceback." msgstr "" -#: library/inspect.rst:447 +#: library/inspect.rst:457 msgid "Return ``True`` if the object is a frame." msgstr "" -#: library/inspect.rst:452 +#: library/inspect.rst:462 msgid "Return ``True`` if the object is a code." msgstr "" -#: library/inspect.rst:457 +#: library/inspect.rst:467 msgid "" "Return ``True`` if the object is a built-in function or a bound built-in " "method." msgstr "" -#: library/inspect.rst:462 +#: library/inspect.rst:472 msgid "" "Return ``True`` if the type of object is a :class:`~types.MethodWrapperType`." msgstr "" -#: library/inspect.rst:464 +#: library/inspect.rst:474 msgid "" "These are instances of :class:`~types.MethodWrapperType`, such as :meth:" "`~object.__str__`, :meth:`~object.__eq__` and :meth:`~object.__repr__`." msgstr "" -#: library/inspect.rst:472 +#: library/inspect.rst:482 msgid "" "Return ``True`` if the object is a user-defined or built-in function or " "method." msgstr "" -#: library/inspect.rst:477 +#: library/inspect.rst:487 msgid "Return ``True`` if the object is an abstract base class." msgstr "" -#: library/inspect.rst:482 +#: library/inspect.rst:492 msgid "" "Return ``True`` if the object is a method descriptor, but not if :func:" "`ismethod`, :func:`isclass`, :func:`isfunction` or :func:`isbuiltin` are " "true." msgstr "" -#: library/inspect.rst:486 +#: library/inspect.rst:496 msgid "" "This, for example, is true of ``int.__add__``. An object passing this test " "has a :meth:`~object.__get__` method but not a :meth:`~object.__set__` " @@ -743,7 +759,7 @@ msgid "" "__name__` attribute is usually sensible, and :attr:`!__doc__` often is." msgstr "" -#: library/inspect.rst:492 +#: library/inspect.rst:502 msgid "" "Methods implemented via descriptors that also pass one of the other tests " "return ``False`` from the :func:`ismethoddescriptor` test, simply because " @@ -751,11 +767,11 @@ msgid "" "`~method.__func__` attribute (etc) when an object passes :func:`ismethod`." msgstr "" -#: library/inspect.rst:501 +#: library/inspect.rst:511 msgid "Return ``True`` if the object is a data descriptor." msgstr "" -#: library/inspect.rst:503 +#: library/inspect.rst:513 msgid "" "Data descriptors have a :attr:`~object.__set__` or a :attr:`~object." "__delete__` method. Examples are properties (defined in Python), getsets, " @@ -766,33 +782,33 @@ msgid "" "and members have both of these attributes), but this is not guaranteed." msgstr "" -#: library/inspect.rst:514 +#: library/inspect.rst:524 msgid "Return ``True`` if the object is a getset descriptor." msgstr "" -#: library/inspect.rst:518 +#: library/inspect.rst:528 msgid "" "getsets are attributes defined in extension modules via :c:type:" "`PyGetSetDef` structures. For Python implementations without such types, " "this method will always return ``False``." msgstr "" -#: library/inspect.rst:525 +#: library/inspect.rst:535 msgid "Return ``True`` if the object is a member descriptor." msgstr "" -#: library/inspect.rst:529 +#: library/inspect.rst:539 msgid "" "Member descriptors are attributes defined in extension modules via :c:type:" "`PyMemberDef` structures. For Python implementations without such types, " "this method will always return ``False``." msgstr "" -#: library/inspect.rst:537 +#: library/inspect.rst:547 msgid "Retrieving source code" msgstr "" -#: library/inspect.rst:541 +#: library/inspect.rst:551 msgid "" "Get the documentation string for an object, cleaned up with :func:" "`cleandoc`. If the documentation string for an object is not provided and " @@ -801,11 +817,11 @@ msgid "" "documentation string is invalid or missing." msgstr "" -#: library/inspect.rst:547 +#: library/inspect.rst:557 msgid "Documentation strings are now inherited if not overridden." msgstr "" -#: library/inspect.rst:553 +#: library/inspect.rst:563 msgid "" "Return in a single string any lines of comments immediately preceding the " "object's source code (for a class, function, or method), or at the top of " @@ -814,27 +830,27 @@ msgid "" "been defined in C or the interactive shell." msgstr "" -#: library/inspect.rst:562 +#: library/inspect.rst:572 msgid "" "Return the name of the (text or binary) file in which an object was defined. " "This will fail with a :exc:`TypeError` if the object is a built-in module, " "class, or function." msgstr "" -#: library/inspect.rst:569 +#: library/inspect.rst:579 msgid "" "Try to guess which module an object was defined in. Return ``None`` if the " "module cannot be determined." msgstr "" -#: library/inspect.rst:575 +#: library/inspect.rst:585 msgid "" "Return the name of the Python source file in which an object was defined or " "``None`` if no way can be identified to get the source. This will fail with " "a :exc:`TypeError` if the object is a built-in module, class, or function." msgstr "" -#: library/inspect.rst:583 +#: library/inspect.rst:593 msgid "" "Return a list of source lines and starting line number for an object. The " "argument may be a module, class, method, function, traceback, frame, or code " @@ -845,13 +861,13 @@ msgid "" "built-in module, class, or function." msgstr "" -#: library/inspect.rst:606 +#: library/inspect.rst:616 msgid "" ":exc:`OSError` is raised instead of :exc:`IOError`, now an alias of the " "former." msgstr "" -#: library/inspect.rst:599 +#: library/inspect.rst:609 msgid "" "Return the text of the source code for an object. The argument may be a " "module, class, method, function, traceback, frame, or code object. The " @@ -860,13 +876,13 @@ msgid "" "object is a built-in module, class, or function." msgstr "" -#: library/inspect.rst:613 +#: library/inspect.rst:623 msgid "" "Clean up indentation from docstrings that are indented to line up with " "blocks of code." msgstr "" -#: library/inspect.rst:616 +#: library/inspect.rst:626 msgid "" "All leading whitespace is removed from the first line. Any leading " "whitespace that can be uniformly removed from the second line onwards is " @@ -874,28 +890,28 @@ msgid "" "Also, all tabs are expanded to spaces." msgstr "" -#: library/inspect.rst:625 +#: library/inspect.rst:635 msgid "Introspecting callables with the Signature object" msgstr "" -#: library/inspect.rst:629 +#: library/inspect.rst:639 msgid "" "The :class:`Signature` object represents the call signature of a callable " "object and its return annotation. To retrieve a :class:`!Signature` object, " "use the :func:`!signature` function." msgstr "" -#: library/inspect.rst:636 +#: library/inspect.rst:646 msgid "Return a :class:`Signature` object for the given *callable*:" msgstr "" -#: library/inspect.rst:655 +#: library/inspect.rst:665 msgid "" "Accepts a wide range of Python callables, from plain functions and classes " "to :func:`functools.partial` objects." msgstr "" -#: library/inspect.rst:658 +#: library/inspect.rst:668 msgid "" "For objects defined in modules using stringized annotations (``from " "__future__ import annotations``), :func:`signature` will attempt to " @@ -905,7 +921,7 @@ msgid "" "func:`get_annotations` for instructions on how to use these parameters." msgstr "" -#: library/inspect.rst:667 +#: library/inspect.rst:677 msgid "" "Raises :exc:`ValueError` if no signature can be provided, and :exc:" "`TypeError` if that type of object is not supported. Also, if the " @@ -914,32 +930,32 @@ msgid "" "potentially raise any kind of exception." msgstr "" -#: library/inspect.rst:673 +#: library/inspect.rst:683 msgid "" "A slash(/) in the signature of a function denotes that the parameters prior " "to it are positional-only. For more info, see :ref:`the FAQ entry on " "positional-only parameters `." msgstr "" -#: library/inspect.rst:677 +#: library/inspect.rst:687 msgid "" "The *follow_wrapped* parameter was added. Pass ``False`` to get a signature " "of *callable* specifically (``callable.__wrapped__`` will not be used to " "unwrap decorated callables.)" msgstr "" -#: library/inspect.rst:793 +#: library/inspect.rst:803 msgid "The *globals*, *locals*, and *eval_str* parameters were added." msgstr "" -#: library/inspect.rst:688 +#: library/inspect.rst:698 msgid "" "Some callables may not be introspectable in certain implementations of " "Python. For example, in CPython, some built-in functions defined in C " "provide no metadata about their arguments." msgstr "" -#: library/inspect.rst:694 +#: library/inspect.rst:704 msgid "" "If the passed object has a :attr:`!__signature__` attribute, we may use it " "to create the signature. The exact semantics are an implementation detail " @@ -947,14 +963,14 @@ msgid "" "semantics." msgstr "" -#: library/inspect.rst:702 +#: library/inspect.rst:712 msgid "" "A :class:`!Signature` object represents the call signature of a function and " "its return annotation. For each parameter accepted by the function it " "stores a :class:`Parameter` object in its :attr:`parameters` collection." msgstr "" -#: library/inspect.rst:707 +#: library/inspect.rst:717 msgid "" "The optional *parameters* argument is a sequence of :class:`Parameter` " "objects, which is validated to check that there are no parameters with " @@ -963,54 +979,54 @@ msgid "" "defaults follow parameters without defaults." msgstr "" -#: library/inspect.rst:713 +#: library/inspect.rst:723 msgid "" "The optional *return_annotation* argument can be an arbitrary Python object. " "It represents the \"return\" annotation of the callable." msgstr "" -#: library/inspect.rst:716 +#: library/inspect.rst:726 msgid "" ":class:`!Signature` objects are *immutable*. Use :meth:`Signature.replace` " "to make a modified copy." msgstr "" -#: library/inspect.rst:719 +#: library/inspect.rst:729 msgid ":class:`!Signature` objects are now picklable and :term:`hashable`." msgstr "" -#: library/inspect.rst:724 +#: library/inspect.rst:734 msgid "A special class-level marker to specify absence of a return annotation." msgstr "" -#: library/inspect.rst:728 +#: library/inspect.rst:738 msgid "" "An ordered mapping of parameters' names to the corresponding :class:" "`Parameter` objects. Parameters appear in strict definition order, " "including keyword-only parameters." msgstr "" -#: library/inspect.rst:1069 +#: library/inspect.rst:1079 msgid "" "Python only explicitly guaranteed that it preserved the declaration order of " "keyword-only parameters as of version 3.7, although in practice this order " "had always been preserved in Python 3." msgstr "" -#: library/inspect.rst:739 +#: library/inspect.rst:749 msgid "" "The \"return\" annotation for the callable. If the callable has no " "\"return\" annotation, this attribute is set to :attr:`Signature.empty`." msgstr "" -#: library/inspect.rst:744 +#: library/inspect.rst:754 msgid "" "Create a mapping from positional and keyword arguments to parameters. " "Returns :class:`BoundArguments` if ``*args`` and ``**kwargs`` match the " "signature, or raises a :exc:`TypeError`." msgstr "" -#: library/inspect.rst:750 +#: library/inspect.rst:760 msgid "" "Works the same way as :meth:`Signature.bind`, but allows the omission of " "some required arguments (mimics :func:`functools.partial` behavior.) " @@ -1018,7 +1034,7 @@ msgid "" "arguments do not match the signature." msgstr "" -#: library/inspect.rst:757 +#: library/inspect.rst:767 msgid "" "Create a new :class:`Signature` instance based on the instance :meth:" "`replace` was invoked on. It is possible to pass different *parameters* and/" @@ -1027,147 +1043,147 @@ msgid "" "Signature`, pass in :attr:`Signature.empty`." msgstr "" -#: library/inspect.rst:777 +#: library/inspect.rst:787 msgid "" "Return a :class:`Signature` (or its subclass) object for a given callable " "*obj*." msgstr "" -#: library/inspect.rst:780 +#: library/inspect.rst:790 msgid "This method simplifies subclassing of :class:`Signature`:" msgstr "" -#: library/inspect.rst:789 +#: library/inspect.rst:799 msgid "Its behavior is otherwise identical to that of :func:`signature`." msgstr "" -#: library/inspect.rst:799 +#: library/inspect.rst:809 msgid "" ":class:`!Parameter` objects are *immutable*. Instead of modifying a :class:`!" "Parameter` object, you can use :meth:`Parameter.replace` to create a " "modified copy." msgstr "" -#: library/inspect.rst:803 +#: library/inspect.rst:813 msgid "Parameter objects are now picklable and :term:`hashable`." msgstr "" -#: library/inspect.rst:808 +#: library/inspect.rst:818 msgid "" "A special class-level marker to specify absence of default values and " "annotations." msgstr "" -#: library/inspect.rst:813 +#: library/inspect.rst:823 msgid "" "The name of the parameter as a string. The name must be a valid Python " "identifier." msgstr "" -#: library/inspect.rst:818 +#: library/inspect.rst:828 msgid "" "CPython generates implicit parameter names of the form ``.0`` on the code " "objects used to implement comprehensions and generator expressions." msgstr "" -#: library/inspect.rst:822 +#: library/inspect.rst:832 msgid "" "These parameter names are now exposed by this module as names like " "``implicit0``." msgstr "" -#: library/inspect.rst:828 +#: library/inspect.rst:838 msgid "" "The default value for the parameter. If the parameter has no default value, " "this attribute is set to :attr:`Parameter.empty`." msgstr "" -#: library/inspect.rst:833 +#: library/inspect.rst:843 msgid "" "The annotation for the parameter. If the parameter has no annotation, this " "attribute is set to :attr:`Parameter.empty`." msgstr "" -#: library/inspect.rst:838 +#: library/inspect.rst:848 msgid "" "Describes how argument values are bound to the parameter. The possible " "values are accessible via :class:`Parameter` (like ``Parameter." "KEYWORD_ONLY``), and support comparison and ordering, in the following order:" msgstr "" -#: library/inspect.rst:845 +#: library/inspect.rst:855 msgid "Name" msgstr "" -#: library/inspect.rst:845 +#: library/inspect.rst:855 msgid "Meaning" msgstr "" -#: library/inspect.rst:847 +#: library/inspect.rst:857 msgid "*POSITIONAL_ONLY*" msgstr "" -#: library/inspect.rst:847 +#: library/inspect.rst:857 msgid "" "Value must be supplied as a positional argument. Positional only parameters " "are those which appear before a ``/`` entry (if present) in a Python " "function definition." msgstr "" -#: library/inspect.rst:852 +#: library/inspect.rst:862 msgid "*POSITIONAL_OR_KEYWORD*" msgstr "" -#: library/inspect.rst:852 +#: library/inspect.rst:862 msgid "" "Value may be supplied as either a keyword or positional argument (this is " "the standard binding behaviour for functions implemented in Python.)" msgstr "" -#: library/inspect.rst:857 +#: library/inspect.rst:867 msgid "*VAR_POSITIONAL*" msgstr "" -#: library/inspect.rst:857 +#: library/inspect.rst:867 msgid "" "A tuple of positional arguments that aren't bound to any other parameter. " "This corresponds to a ``*args`` parameter in a Python function definition." msgstr "" -#: library/inspect.rst:862 +#: library/inspect.rst:872 msgid "*KEYWORD_ONLY*" msgstr "" -#: library/inspect.rst:862 +#: library/inspect.rst:872 msgid "" "Value must be supplied as a keyword argument. Keyword only parameters are " "those which appear after a ``*`` or ``*args`` entry in a Python function " "definition." msgstr "" -#: library/inspect.rst:867 +#: library/inspect.rst:877 msgid "*VAR_KEYWORD*" msgstr "" -#: library/inspect.rst:867 +#: library/inspect.rst:877 msgid "" "A dict of keyword arguments that aren't bound to any other parameter. This " "corresponds to a ``**kwargs`` parameter in a Python function definition." msgstr "" -#: library/inspect.rst:873 +#: library/inspect.rst:883 msgid "Example: print all keyword-only arguments without default values:" msgstr "" -#: library/inspect.rst:889 +#: library/inspect.rst:899 msgid "Describes a enum value of :attr:`Parameter.kind`." msgstr "" -#: library/inspect.rst:893 +#: library/inspect.rst:903 msgid "Example: print all descriptions of arguments:" msgstr "" -#: library/inspect.rst:910 +#: library/inspect.rst:920 msgid "" "Create a new :class:`Parameter` instance based on the instance replaced was " "invoked on. To override a :class:`!Parameter` attribute, pass the " @@ -1175,94 +1191,94 @@ msgid "" "a :class:`!Parameter`, pass :attr:`Parameter.empty`." msgstr "" -#: library/inspect.rst:928 +#: library/inspect.rst:938 msgid "" "In Python 3.3 :class:`Parameter` objects were allowed to have ``name`` set " "to ``None`` if their ``kind`` was set to ``POSITIONAL_ONLY``. This is no " "longer permitted." msgstr "" -#: library/inspect.rst:935 +#: library/inspect.rst:945 msgid "" "Result of a :meth:`Signature.bind` or :meth:`Signature.bind_partial` call. " "Holds the mapping of arguments to the function's parameters." msgstr "" -#: library/inspect.rst:940 +#: library/inspect.rst:950 msgid "" "A mutable mapping of parameters' names to arguments' values. Contains only " "explicitly bound arguments. Changes in :attr:`arguments` will reflect in :" "attr:`args` and :attr:`kwargs`." msgstr "" -#: library/inspect.rst:944 +#: library/inspect.rst:954 msgid "" "Should be used in conjunction with :attr:`Signature.parameters` for any " "argument processing purposes." msgstr "" -#: library/inspect.rst:949 +#: library/inspect.rst:959 msgid "" "Arguments for which :meth:`Signature.bind` or :meth:`Signature.bind_partial` " "relied on a default value are skipped. However, if needed, use :meth:" "`BoundArguments.apply_defaults` to add them." msgstr "" -#: library/inspect.rst:954 +#: library/inspect.rst:964 msgid "" ":attr:`arguments` is now of type :class:`dict`. Formerly, it was of type :" "class:`collections.OrderedDict`." msgstr "" -#: library/inspect.rst:960 +#: library/inspect.rst:970 msgid "" "A tuple of positional arguments values. Dynamically computed from the :attr:" "`arguments` attribute." msgstr "" -#: library/inspect.rst:965 +#: library/inspect.rst:975 msgid "" "A dict of keyword arguments values. Dynamically computed from the :attr:" "`arguments` attribute." msgstr "" -#: library/inspect.rst:970 +#: library/inspect.rst:980 msgid "A reference to the parent :class:`Signature` object." msgstr "" -#: library/inspect.rst:974 +#: library/inspect.rst:984 msgid "Set default values for missing arguments." msgstr "" -#: library/inspect.rst:976 +#: library/inspect.rst:986 msgid "" "For variable-positional arguments (``*args``) the default is an empty tuple." msgstr "" -#: library/inspect.rst:979 +#: library/inspect.rst:989 msgid "" "For variable-keyword arguments (``**kwargs``) the default is an empty dict." msgstr "" -#: library/inspect.rst:992 +#: library/inspect.rst:1002 msgid "" "The :attr:`args` and :attr:`kwargs` properties can be used to invoke " "functions:" msgstr "" -#: library/inspect.rst:1007 +#: library/inspect.rst:1017 msgid ":pep:`362` - Function Signature Object." msgstr "" -#: library/inspect.rst:1008 +#: library/inspect.rst:1018 msgid "The detailed specification, implementation details and examples." msgstr "" -#: library/inspect.rst:1014 +#: library/inspect.rst:1024 msgid "Classes and functions" msgstr "" -#: library/inspect.rst:1018 +#: library/inspect.rst:1028 msgid "" "Arrange the given list of classes into a hierarchy of nested lists. Where a " "nested list appears, it contains classes derived from the class whose entry " @@ -1273,19 +1289,19 @@ msgid "" "will appear multiple times." msgstr "" -#: library/inspect.rst:1029 +#: library/inspect.rst:1039 msgid "" "Get the names and default values of a Python function's parameters. A :term:" "`named tuple` is returned:" msgstr "" -#: library/inspect.rst:1032 +#: library/inspect.rst:1042 msgid "" "``FullArgSpec(args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, " "annotations)``" msgstr "" -#: library/inspect.rst:1035 +#: library/inspect.rst:1045 msgid "" "*args* is a list of the positional parameter names. *varargs* is the name of " "the ``*`` parameter or ``None`` if arbitrary positional arguments are not " @@ -1300,7 +1316,7 @@ msgid "" "report the function return value annotation (if any)." msgstr "" -#: library/inspect.rst:1050 +#: library/inspect.rst:1060 msgid "" "Note that :func:`signature` and :ref:`Signature Object ` provide the recommended API for callable introspection, and support " @@ -1310,14 +1326,14 @@ msgid "" "``inspect`` module API." msgstr "" -#: library/inspect.rst:1057 +#: library/inspect.rst:1067 msgid "" "This function is now based on :func:`signature`, but still ignores " "``__wrapped__`` attributes and includes the already bound first parameter in " "the signature output for bound methods." msgstr "" -#: library/inspect.rst:1062 +#: library/inspect.rst:1072 msgid "" "This method was previously documented as deprecated in favour of :func:" "`signature` in Python 3.5, but that decision has been reversed in order to " @@ -1325,7 +1341,7 @@ msgid "" "code migrating away from the legacy :func:`getargspec` API." msgstr "" -#: library/inspect.rst:1077 +#: library/inspect.rst:1087 msgid "" "Get information about arguments passed into a particular frame. A :term:" "`named tuple` ``ArgInfo(args, varargs, keywords, locals)`` is returned. " @@ -1334,18 +1350,18 @@ msgid "" "dictionary of the given frame." msgstr "" -#: library/inspect.rst:1094 +#: library/inspect.rst:1104 msgid "This function was inadvertently marked as deprecated in Python 3.5." msgstr "" -#: library/inspect.rst:1089 +#: library/inspect.rst:1099 msgid "" "Format a pretty argument spec from the four values returned by :func:" "`getargvalues`. The format\\* arguments are the corresponding optional " "formatting functions that are called to turn names and values into strings." msgstr "" -#: library/inspect.rst:1099 +#: library/inspect.rst:1109 msgid "" "Return a tuple of class cls's base classes, including cls, in method " "resolution order. No class appears more than once in this tuple. Note that " @@ -1353,7 +1369,7 @@ msgid "" "user-defined metatype is in use, cls will be the first element of the tuple." msgstr "" -#: library/inspect.rst:1107 +#: library/inspect.rst:1117 msgid "" "Bind the *args* and *kwds* to the argument names of the Python function or " "method *func*, as if it was called with them. For bound methods, bind also " @@ -1366,11 +1382,11 @@ msgid "" "example:" msgstr "" -#: library/inspect.rst:1133 +#: library/inspect.rst:1143 msgid "Use :meth:`Signature.bind` and :meth:`Signature.bind_partial` instead." msgstr "" -#: library/inspect.rst:1139 +#: library/inspect.rst:1149 msgid "" "Get the mapping of external name references in a Python function or method " "*func* to their current values. A :term:`named tuple` " @@ -1382,18 +1398,18 @@ msgid "" "builtins." msgstr "" -#: library/inspect.rst:1148 +#: library/inspect.rst:1158 msgid "" ":exc:`TypeError` is raised if *func* is not a Python function or method." msgstr "" -#: library/inspect.rst:1155 +#: library/inspect.rst:1165 msgid "" "Get the object wrapped by *func*. It follows the chain of :attr:" "`__wrapped__` attributes returning the last object in the chain." msgstr "" -#: library/inspect.rst:1158 +#: library/inspect.rst:1168 msgid "" "*stop* is an optional callback accepting an object in the wrapper chain as " "its sole argument that allows the unwrapping to be terminated early if the " @@ -1403,68 +1419,68 @@ msgid "" "``__signature__`` attribute defined." msgstr "" -#: library/inspect.rst:1165 +#: library/inspect.rst:1175 msgid ":exc:`ValueError` is raised if a cycle is encountered." msgstr "" -#: library/inspect.rst:1172 +#: library/inspect.rst:1182 msgid "Compute the annotations dict for an object." msgstr "" -#: library/inspect.rst:1174 +#: library/inspect.rst:1184 msgid "" "``obj`` may be a callable, class, or module. Passing in an object of any " "other type raises :exc:`TypeError`." msgstr "" -#: library/inspect.rst:1177 +#: library/inspect.rst:1187 msgid "" "Returns a dict. ``get_annotations()`` returns a new dict every time it's " "called; calling it twice on the same object will return two different but " "equivalent dicts." msgstr "" -#: library/inspect.rst:1181 +#: library/inspect.rst:1191 msgid "This function handles several details for you:" msgstr "" -#: library/inspect.rst:1183 +#: library/inspect.rst:1193 msgid "" "If ``eval_str`` is true, values of type ``str`` will be un-stringized using :" "func:`eval()`. This is intended for use with stringized annotations (``from " "__future__ import annotations``)." msgstr "" -#: library/inspect.rst:1187 +#: library/inspect.rst:1197 msgid "" "If ``obj`` doesn't have an annotations dict, returns an empty dict. " "(Functions and methods always have an annotations dict; classes, modules, " "and other types of callables may not.)" msgstr "" -#: library/inspect.rst:1191 +#: library/inspect.rst:1201 msgid "" "Ignores inherited annotations on classes. If a class doesn't have its own " "annotations dict, returns an empty dict." msgstr "" -#: library/inspect.rst:1193 +#: library/inspect.rst:1203 msgid "" "All accesses to object members and dict values are done using ``getattr()`` " "and ``dict.get()`` for safety." msgstr "" -#: library/inspect.rst:1195 +#: library/inspect.rst:1205 msgid "Always, always, always returns a freshly created dict." msgstr "" -#: library/inspect.rst:1197 +#: library/inspect.rst:1207 msgid "" "``eval_str`` controls whether or not values of type ``str`` are replaced " "with the result of calling :func:`eval()` on those values:" msgstr "" -#: library/inspect.rst:1200 +#: library/inspect.rst:1210 msgid "" "If eval_str is true, :func:`eval()` is called on values of type ``str``. " "(Note that ``get_annotations`` doesn't catch exceptions; if :func:`eval()` " @@ -1472,12 +1488,12 @@ msgid "" "call.)" msgstr "" -#: library/inspect.rst:1204 +#: library/inspect.rst:1214 msgid "" "If eval_str is false (the default), values of type ``str`` are unchanged." msgstr "" -#: library/inspect.rst:1206 +#: library/inspect.rst:1216 msgid "" "``globals`` and ``locals`` are passed in to :func:`eval()`; see the " "documentation for :func:`eval()` for more information. If ``globals`` or " @@ -1485,35 +1501,35 @@ msgid "" "specific default, contingent on ``type(obj)``:" msgstr "" -#: library/inspect.rst:1211 +#: library/inspect.rst:1221 msgid "If ``obj`` is a module, ``globals`` defaults to ``obj.__dict__``." msgstr "" -#: library/inspect.rst:1212 +#: library/inspect.rst:1222 msgid "" "If ``obj`` is a class, ``globals`` defaults to ``sys.modules[obj.__module__]." "__dict__`` and ``locals`` defaults to the ``obj`` class namespace." msgstr "" -#: library/inspect.rst:1215 +#: library/inspect.rst:1225 msgid "" "If ``obj`` is a callable, ``globals`` defaults to :attr:`obj.__globals__ " "`, although if ``obj`` is a wrapped function (using :" "func:`functools.update_wrapper`) it is first unwrapped." msgstr "" -#: library/inspect.rst:1220 +#: library/inspect.rst:1230 msgid "" "Calling ``get_annotations`` is best practice for accessing the annotations " "dict of any object. See :ref:`annotations-howto` for more information on " "annotations best practices." msgstr "" -#: library/inspect.rst:1230 +#: library/inspect.rst:1240 msgid "The interpreter stack" msgstr "" -#: library/inspect.rst:1232 +#: library/inspect.rst:1242 msgid "" "Some of the following functions return :class:`FrameInfo` objects. For " "backwards compatibility these objects allow tuple-like operations on all " @@ -1521,95 +1537,95 @@ msgid "" "may be removed in the future." msgstr "" -#: library/inspect.rst:1241 +#: library/inspect.rst:1251 msgid "The :ref:`frame object ` that the record corresponds to." msgstr "" -#: library/inspect.rst:1245 +#: library/inspect.rst:1255 msgid "" "The file name associated with the code being executed by the frame this " "record corresponds to." msgstr "" -#: library/inspect.rst:1250 +#: library/inspect.rst:1260 msgid "" "The line number of the current line associated with the code being executed " "by the frame this record corresponds to." msgstr "" -#: library/inspect.rst:1255 +#: library/inspect.rst:1265 msgid "" "The function name that is being executed by the frame this record " "corresponds to." msgstr "" -#: library/inspect.rst:1259 +#: library/inspect.rst:1269 msgid "" "A list of lines of context from the source code that's being executed by the " "frame this record corresponds to." msgstr "" -#: library/inspect.rst:1303 +#: library/inspect.rst:1313 msgid "" "The index of the current line being executed in the :attr:`code_context` " "list." msgstr "" -#: library/inspect.rst:1268 +#: library/inspect.rst:1278 msgid "" "A :class:`dis.Positions` object containing the start line number, end line " "number, start column offset, and end column offset associated with the " "instruction being executed by the frame this record corresponds to." msgstr "" -#: library/inspect.rst:1272 +#: library/inspect.rst:1282 msgid "Return a :term:`named tuple` instead of a :class:`tuple`." msgstr "" -#: library/inspect.rst:1275 +#: library/inspect.rst:1285 msgid "" ":class:`!FrameInfo` is now a class instance (that is backwards compatible " "with the previous :term:`named tuple`)." msgstr "" -#: library/inspect.rst:1284 +#: library/inspect.rst:1294 msgid "" "The file name associated with the code being executed by the frame this " "traceback corresponds to." msgstr "" -#: library/inspect.rst:1289 +#: library/inspect.rst:1299 msgid "" "The line number of the current line associated with the code being executed " "by the frame this traceback corresponds to." msgstr "" -#: library/inspect.rst:1294 +#: library/inspect.rst:1304 msgid "" "The function name that is being executed by the frame this traceback " "corresponds to." msgstr "" -#: library/inspect.rst:1298 +#: library/inspect.rst:1308 msgid "" "A list of lines of context from the source code that's being executed by the " "frame this traceback corresponds to." msgstr "" -#: library/inspect.rst:1307 +#: library/inspect.rst:1317 msgid "" "A :class:`dis.Positions` object containing the start line number, end line " "number, start column offset, and end column offset associated with the " "instruction being executed by the frame this traceback corresponds to." msgstr "" -#: library/inspect.rst:1312 +#: library/inspect.rst:1322 msgid "" ":class:`!Traceback` is now a class instance (that is backwards compatible " "with the previous :term:`named tuple`)." msgstr "" -#: library/inspect.rst:1319 +#: library/inspect.rst:1329 msgid "" "Keeping references to frame objects, as found in the first element of the " "frame records these functions return, can cause your program to create " @@ -1621,7 +1637,7 @@ msgid "" "consumption which occurs." msgstr "" -#: library/inspect.rst:1327 +#: library/inspect.rst:1337 msgid "" "Though the cycle detector will catch these, destruction of the frames (and " "local variables) can be made deterministic by removing the cycle in a :" @@ -1629,31 +1645,31 @@ msgid "" "disabled when Python was compiled or using :func:`gc.disable`. For example::" msgstr "" -#: library/inspect.rst:1339 +#: library/inspect.rst:1349 msgid "" "If you want to keep the frame around (for example to print a traceback " "later), you can also break reference cycles by using the :meth:`frame.clear` " "method." msgstr "" -#: library/inspect.rst:1343 +#: library/inspect.rst:1353 msgid "" "The optional *context* argument supported by most of these functions " "specifies the number of lines of context to return, which are centered " "around the current line." msgstr "" -#: library/inspect.rst:1350 +#: library/inspect.rst:1360 msgid "" "Get information about a frame or traceback object. A :class:`Traceback` " "object is returned." msgstr "" -#: library/inspect.rst:1353 +#: library/inspect.rst:1363 msgid "A :class:`Traceback` object is returned instead of a named tuple." msgstr "" -#: library/inspect.rst:1358 +#: library/inspect.rst:1368 msgid "" "Get a list of :class:`FrameInfo` objects for a frame and all outer frames. " "These frames represent the calls that lead to the creation of *frame*. The " @@ -1661,17 +1677,17 @@ msgid "" "represents the outermost call on *frame*'s stack." msgstr "" -#: library/inspect.rst:1378 library/inspect.rst:1419 +#: library/inspect.rst:1388 library/inspect.rst:1429 msgid "" "A list of :term:`named tuples ` ``FrameInfo(frame, filename, " "lineno, function, code_context, index)`` is returned." msgstr "" -#: library/inspect.rst:1383 library/inspect.rst:1424 +#: library/inspect.rst:1393 library/inspect.rst:1434 msgid "A list of :class:`FrameInfo` objects is returned." msgstr "" -#: library/inspect.rst:1373 +#: library/inspect.rst:1383 msgid "" "Get a list of :class:`FrameInfo` objects for a traceback's frame and all " "inner frames. These frames represent calls made as a consequence of " @@ -1679,11 +1695,11 @@ msgid "" "represents where the exception was raised." msgstr "" -#: library/inspect.rst:1388 +#: library/inspect.rst:1398 msgid "Return the frame object for the caller's stack frame." msgstr "" -#: library/inspect.rst:1392 +#: library/inspect.rst:1402 msgid "" "This function relies on Python stack frame support in the interpreter, which " "isn't guaranteed to exist in all implementations of Python. If running in " @@ -1691,14 +1707,14 @@ msgid "" "``None``." msgstr "" -#: library/inspect.rst:1400 +#: library/inspect.rst:1410 msgid "" "Return a list of :class:`FrameInfo` objects for the caller's stack. The " "first entry in the returned list represents the caller; the last entry " "represents the outermost call on the stack." msgstr "" -#: library/inspect.rst:1414 +#: library/inspect.rst:1424 msgid "" "Return a list of :class:`FrameInfo` objects for the stack between the " "current frame and the frame in which an exception currently being handled " @@ -1706,11 +1722,11 @@ msgid "" "entry represents where the exception was raised." msgstr "" -#: library/inspect.rst:1428 +#: library/inspect.rst:1438 msgid "Fetching attributes statically" msgstr "" -#: library/inspect.rst:1430 +#: library/inspect.rst:1440 msgid "" "Both :func:`getattr` and :func:`hasattr` can trigger code execution when " "fetching or checking for the existence of attributes. Descriptors, like " @@ -1718,20 +1734,20 @@ msgid "" "`~object.__getattribute__` may be called." msgstr "" -#: library/inspect.rst:1436 +#: library/inspect.rst:1446 msgid "" "For cases where you want passive introspection, like documentation tools, " "this can be inconvenient. :func:`getattr_static` has the same signature as :" "func:`getattr` but avoids executing code when it fetches attributes." msgstr "" -#: library/inspect.rst:1442 +#: library/inspect.rst:1452 msgid "" "Retrieve attributes without triggering dynamic lookup via the descriptor " "protocol, :meth:`~object.__getattr__` or :meth:`~object.__getattribute__`." msgstr "" -#: library/inspect.rst:1446 +#: library/inspect.rst:1456 msgid "" "Note: this function may not be able to retrieve all attributes that getattr " "can fetch (like dynamically created attributes) and may find attributes that " @@ -1739,31 +1755,31 @@ msgid "" "return descriptors objects instead of instance members." msgstr "" -#: library/inspect.rst:1452 +#: library/inspect.rst:1462 msgid "" "If the instance :attr:`~object.__dict__` is shadowed by another member (for " "example a property) then this function will be unable to find instance " "members." msgstr "" -#: library/inspect.rst:1458 +#: library/inspect.rst:1468 msgid "" ":func:`getattr_static` does not resolve descriptors, for example slot " "descriptors or getset descriptors on objects implemented in C. The " "descriptor object is returned instead of the underlying attribute." msgstr "" -#: library/inspect.rst:1462 +#: library/inspect.rst:1472 msgid "" "You can handle these with code like the following. Note that for arbitrary " "getset descriptors invoking these may trigger code execution::" msgstr "" -#: library/inspect.rst:1488 +#: library/inspect.rst:1498 msgid "Current State of Generators, Coroutines, and Asynchronous Generators" msgstr "" -#: library/inspect.rst:1490 +#: library/inspect.rst:1500 msgid "" "When implementing coroutine schedulers and for other advanced uses of " "generators, it is useful to determine whether a generator is currently " @@ -1772,31 +1788,31 @@ msgid "" "generator to be determined easily." msgstr "" -#: library/inspect.rst:1498 +#: library/inspect.rst:1508 msgid "Get current state of a generator-iterator." msgstr "" -#: library/inspect.rst:1516 library/inspect.rst:1533 +#: library/inspect.rst:1526 library/inspect.rst:1543 msgid "Possible states are:" msgstr "" -#: library/inspect.rst:1502 +#: library/inspect.rst:1512 msgid "GEN_CREATED: Waiting to start execution." msgstr "" -#: library/inspect.rst:1503 +#: library/inspect.rst:1513 msgid "GEN_RUNNING: Currently being executed by the interpreter." msgstr "" -#: library/inspect.rst:1504 +#: library/inspect.rst:1514 msgid "GEN_SUSPENDED: Currently suspended at a yield expression." msgstr "" -#: library/inspect.rst:1505 +#: library/inspect.rst:1515 msgid "GEN_CLOSED: Execution has completed." msgstr "" -#: library/inspect.rst:1511 +#: library/inspect.rst:1521 msgid "" "Get current state of a coroutine object. The function is intended to be " "used with coroutine objects created by :keyword:`async def` functions, but " @@ -1804,23 +1820,23 @@ msgid "" "``cr_frame`` attributes." msgstr "" -#: library/inspect.rst:1518 +#: library/inspect.rst:1528 msgid "CORO_CREATED: Waiting to start execution." msgstr "" -#: library/inspect.rst:1519 +#: library/inspect.rst:1529 msgid "CORO_RUNNING: Currently being executed by the interpreter." msgstr "" -#: library/inspect.rst:1520 +#: library/inspect.rst:1530 msgid "CORO_SUSPENDED: Currently suspended at an await expression." msgstr "" -#: library/inspect.rst:1521 +#: library/inspect.rst:1531 msgid "CORO_CLOSED: Execution has completed." msgstr "" -#: library/inspect.rst:1527 +#: library/inspect.rst:1537 msgid "" "Get current state of an asynchronous generator object. The function is " "intended to be used with asynchronous iterator objects created by :keyword:" @@ -1829,30 +1845,30 @@ msgid "" "``ag_frame`` attributes." msgstr "" -#: library/inspect.rst:1535 +#: library/inspect.rst:1545 msgid "AGEN_CREATED: Waiting to start execution." msgstr "" -#: library/inspect.rst:1536 +#: library/inspect.rst:1546 msgid "AGEN_RUNNING: Currently being executed by the interpreter." msgstr "" -#: library/inspect.rst:1537 +#: library/inspect.rst:1547 msgid "AGEN_SUSPENDED: Currently suspended at a yield expression." msgstr "" -#: library/inspect.rst:1538 +#: library/inspect.rst:1548 msgid "AGEN_CLOSED: Execution has completed." msgstr "" -#: library/inspect.rst:1542 +#: library/inspect.rst:1552 msgid "" "The current internal state of the generator can also be queried. This is " "mostly useful for testing purposes, to ensure that internal state is being " "updated as expected:" msgstr "" -#: library/inspect.rst:1548 +#: library/inspect.rst:1558 msgid "" "Get the mapping of live local variables in *generator* to their current " "values. A dictionary is returned that maps from variable names to values. " @@ -1860,14 +1876,14 @@ msgid "" "generator, and all the same caveats apply." msgstr "" -#: library/inspect.rst:1553 +#: library/inspect.rst:1563 msgid "" "If *generator* is a :term:`generator` with no currently associated frame, " "then an empty dictionary is returned. :exc:`TypeError` is raised if " "*generator* is not a Python generator object." msgstr "" -#: library/inspect.rst:1559 +#: library/inspect.rst:1569 msgid "" "This function relies on the generator exposing a Python stack frame for " "introspection, which isn't guaranteed to be the case in all implementations " @@ -1875,79 +1891,79 @@ msgid "" "dictionary." msgstr "" -#: library/inspect.rst:1568 +#: library/inspect.rst:1578 msgid "" "This function is analogous to :func:`~inspect.getgeneratorlocals`, but works " "for coroutine objects created by :keyword:`async def` functions." msgstr "" -#: library/inspect.rst:1575 +#: library/inspect.rst:1585 msgid "" "This function is analogous to :func:`~inspect.getgeneratorlocals`, but works " "for asynchronous generator objects created by :keyword:`async def` functions " "which use the :keyword:`yield` statement." msgstr "" -#: library/inspect.rst:1585 +#: library/inspect.rst:1595 msgid "Code Objects Bit Flags" msgstr "" -#: library/inspect.rst:1587 +#: library/inspect.rst:1597 msgid "" "Python code objects have a :attr:`~codeobject.co_flags` attribute, which is " "a bitmap of the following flags:" msgstr "" -#: library/inspect.rst:1592 +#: library/inspect.rst:1602 msgid "The code object is optimized, using fast locals." msgstr "" -#: library/inspect.rst:1596 +#: library/inspect.rst:1606 msgid "" "If set, a new dict will be created for the frame's :attr:`~frame.f_locals` " "when the code object is executed." msgstr "" -#: library/inspect.rst:1601 +#: library/inspect.rst:1611 msgid "The code object has a variable positional parameter (``*args``-like)." msgstr "" -#: library/inspect.rst:1605 +#: library/inspect.rst:1615 msgid "The code object has a variable keyword parameter (``**kwargs``-like)." msgstr "" -#: library/inspect.rst:1609 +#: library/inspect.rst:1619 msgid "The flag is set when the code object is a nested function." msgstr "" -#: library/inspect.rst:1613 +#: library/inspect.rst:1623 msgid "" "The flag is set when the code object is a generator function, i.e. a " "generator object is returned when the code object is executed." msgstr "" -#: library/inspect.rst:1618 +#: library/inspect.rst:1628 msgid "" "The flag is set when the code object is a coroutine function. When the code " "object is executed it returns a coroutine object. See :pep:`492` for more " "details." msgstr "" -#: library/inspect.rst:1626 +#: library/inspect.rst:1636 msgid "" "The flag is used to transform generators into generator-based coroutines. " "Generator objects with this flag can be used in ``await`` expression, and " "can ``yield from`` coroutine objects. See :pep:`492` for more details." msgstr "" -#: library/inspect.rst:1635 +#: library/inspect.rst:1645 msgid "" "The flag is set when the code object is an asynchronous generator function. " "When the code object is executed it returns an asynchronous generator " "object. See :pep:`525` for more details." msgstr "" -#: library/inspect.rst:1642 +#: library/inspect.rst:1652 msgid "" "The flags are specific to CPython, and may not be defined in other Python " "implementations. Furthermore, the flags are an implementation detail, and " @@ -1955,39 +1971,39 @@ msgid "" "use public APIs from the :mod:`inspect` module for any introspection needs." msgstr "" -#: library/inspect.rst:1650 +#: library/inspect.rst:1660 msgid "Buffer flags" msgstr "" -#: library/inspect.rst:1654 +#: library/inspect.rst:1664 msgid "" "This is an :class:`enum.IntFlag` that represents the flags that can be " "passed to the :meth:`~object.__buffer__` method of objects implementing the :" "ref:`buffer protocol `." msgstr "" -#: library/inspect.rst:1658 +#: library/inspect.rst:1668 msgid "The meaning of the flags is explained at :ref:`buffer-request-types`." msgstr "" -#: library/inspect.rst:1685 +#: library/inspect.rst:1695 msgid "Command Line Interface" msgstr "" -#: library/inspect.rst:1687 +#: library/inspect.rst:1697 msgid "" "The :mod:`inspect` module also provides a basic introspection capability " "from the command line." msgstr "" -#: library/inspect.rst:1692 +#: library/inspect.rst:1702 msgid "" "By default, accepts the name of a module and prints the source of that " "module. A class or function within the module can be printed instead by " "appended a colon and the qualified name of the target object." msgstr "" -#: library/inspect.rst:1698 +#: library/inspect.rst:1708 msgid "" "Print information about the specified object rather than the source code" msgstr "" diff --git a/library/ipaddress.po b/library/ipaddress.po index b23ab14ee..e416d36bb 100644 --- a/library/ipaddress.po +++ b/library/ipaddress.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-12-17 01:28+0300\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -153,39 +153,28 @@ msgid "" msgstr "" #: library/ipaddress.rst:132 -msgid "" -"The above change was also included in Python 3.9 starting with version 3.9.5." -msgstr "" - -#: library/ipaddress.rst:137 -msgid "" -"The above change was also included in Python 3.8 starting with version " -"3.8.12." -msgstr "" - -#: library/ipaddress.rst:142 msgid "The appropriate version number: ``4`` for IPv4, ``6`` for IPv6." msgstr "" -#: library/ipaddress.rst:146 +#: library/ipaddress.rst:136 msgid "" "The total number of bits in the address representation for this version: " "``32`` for IPv4, ``128`` for IPv6." msgstr "" -#: library/ipaddress.rst:149 +#: library/ipaddress.rst:139 msgid "" "The prefix defines the number of leading bits in an address that are " "compared to determine whether or not an address is part of a network." msgstr "" -#: library/ipaddress.rst:156 +#: library/ipaddress.rst:146 msgid "" "The string representation in dotted decimal notation. Leading zeroes are " "never included in the representation." msgstr "" -#: library/ipaddress.rst:159 +#: library/ipaddress.rst:149 msgid "" "As IPv4 does not define a shorthand notation for addresses with octets set " "to zero, these two attributes are always the same as ``str(addr)`` for IPv4 " @@ -193,63 +182,63 @@ msgid "" "that can handle both IPv4 and IPv6 addresses." msgstr "" -#: library/ipaddress.rst:166 +#: library/ipaddress.rst:156 msgid "" "The binary representation of this address - a :class:`bytes` object of the " "appropriate length (most significant octet first). This is 4 bytes for IPv4 " "and 16 bytes for IPv6." msgstr "" -#: library/ipaddress.rst:172 +#: library/ipaddress.rst:162 msgid "The name of the reverse DNS PTR record for the IP address, e.g.::" msgstr "" -#: library/ipaddress.rst:179 +#: library/ipaddress.rst:169 msgid "" "This is the name that could be used for performing a PTR lookup, not the " "resolved hostname itself." msgstr "" -#: library/ipaddress.rst:186 +#: library/ipaddress.rst:176 msgid "" "``True`` if the address is reserved for multicast use. See :RFC:`3171` (for " "IPv4) or :RFC:`2373` (for IPv6)." msgstr "" -#: library/ipaddress.rst:191 +#: library/ipaddress.rst:181 msgid "" "``True`` if the address is allocated for private networks. See iana-ipv4-" "special-registry_ (for IPv4) or iana-ipv6-special-registry_ (for IPv6)." msgstr "" -#: library/ipaddress.rst:197 +#: library/ipaddress.rst:187 msgid "" "``True`` if the address is allocated for public networks. See iana-ipv4-" "special-registry_ (for IPv4) or iana-ipv6-special-registry_ (for IPv6)." msgstr "" -#: library/ipaddress.rst:205 +#: library/ipaddress.rst:195 msgid "" "``True`` if the address is unspecified. See :RFC:`5735` (for IPv4) or :RFC:" "`2373` (for IPv6)." msgstr "" -#: library/ipaddress.rst:210 +#: library/ipaddress.rst:200 msgid "``True`` if the address is otherwise IETF reserved." msgstr "" -#: library/ipaddress.rst:214 +#: library/ipaddress.rst:204 msgid "" "``True`` if this is a loopback address. See :RFC:`3330` (for IPv4) or :RFC:" "`2373` (for IPv6)." msgstr "" -#: library/ipaddress.rst:219 +#: library/ipaddress.rst:209 msgid "" "``True`` if the address is reserved for link-local usage. See :RFC:`3927`." msgstr "" -#: library/ipaddress.rst:227 +#: library/ipaddress.rst:217 msgid "" "Returns a string representation of the IP address, controlled by an explicit " "format string. *fmt* can be one of the following: ``'s'``, the default " @@ -261,17 +250,17 @@ msgid "" "used by ``format``, ``str.format`` and f-strings." msgstr "" -#: library/ipaddress.rst:254 +#: library/ipaddress.rst:244 msgid "" "Construct an IPv6 address. An :exc:`AddressValueError` is raised if " "*address* is not a valid IPv6 address." msgstr "" -#: library/ipaddress.rst:257 +#: library/ipaddress.rst:247 msgid "The following constitutes a valid IPv6 address:" msgstr "" -#: library/ipaddress.rst:259 +#: library/ipaddress.rst:249 msgid "" "A string consisting of eight groups of four hexadecimal digits, each group " "representing 16 bits. The groups are separated by colons. This describes an " @@ -281,7 +270,7 @@ msgid "" "to ``\"::abc:7:def\"``." msgstr "" -#: library/ipaddress.rst:267 +#: library/ipaddress.rst:257 msgid "" "Optionally, the string may also have a scope zone ID, expressed with a " "suffix ``%scope_id``. If present, the scope ID must be non-empty, and may " @@ -290,43 +279,43 @@ msgid "" "the node." msgstr "" -#: library/ipaddress.rst:272 +#: library/ipaddress.rst:262 msgid "An integer that fits into 128 bits." msgstr "" -#: library/ipaddress.rst:273 +#: library/ipaddress.rst:263 msgid "" "An integer packed into a :class:`bytes` object of length 16, big-endian." msgstr "" -#: library/ipaddress.rst:283 +#: library/ipaddress.rst:273 msgid "" "The short form of the address representation, with leading zeroes in groups " "omitted and the longest sequence of groups consisting entirely of zeroes " "collapsed to a single empty group." msgstr "" -#: library/ipaddress.rst:287 +#: library/ipaddress.rst:277 msgid "This is also the value returned by ``str(addr)`` for IPv6 addresses." msgstr "" -#: library/ipaddress.rst:291 +#: library/ipaddress.rst:281 msgid "" "The long form of the address representation, with all leading zeroes and " "groups consisting entirely of zeroes included." msgstr "" -#: library/ipaddress.rst:295 +#: library/ipaddress.rst:285 msgid "" "For the following attributes and methods, see the corresponding " "documentation of the :class:`IPv4Address` class:" msgstr "" -#: library/ipaddress.rst:310 +#: library/ipaddress.rst:300 msgid "is_global" msgstr "" -#: library/ipaddress.rst:315 +#: library/ipaddress.rst:305 msgid "" "``True`` if the address is reserved for site-local usage. Note that the " "site-local address space has been deprecated by :RFC:`3879`. Use :attr:" @@ -334,21 +323,21 @@ msgid "" "local addresses as defined by :RFC:`4193`." msgstr "" -#: library/ipaddress.rst:322 +#: library/ipaddress.rst:312 msgid "" "For addresses that appear to be IPv4 mapped addresses (starting with ``::" "FFFF/96``), this property will report the embedded IPv4 address. For any " "other address, this property will be ``None``." msgstr "" -#: library/ipaddress.rst:328 +#: library/ipaddress.rst:318 msgid "" "For scoped addresses as defined by :RFC:`4007`, this property identifies the " "particular zone of the address's scope that the address belongs to, as a " "string. When no scope zone is specified, this property will be ``None``." msgstr "" -#: library/ipaddress.rst:334 +#: library/ipaddress.rst:324 msgid "" "For addresses that appear to be 6to4 addresses (starting with " "``2002::/16``) as defined by :RFC:`3056`, this property will report the " @@ -356,7 +345,7 @@ msgid "" "``None``." msgstr "" -#: library/ipaddress.rst:341 +#: library/ipaddress.rst:331 msgid "" "For addresses that appear to be Teredo addresses (starting with " "``2001::/32``) as defined by :RFC:`4380`, this property will report the " @@ -364,64 +353,64 @@ msgid "" "property will be ``None``." msgstr "" -#: library/ipaddress.rst:348 +#: library/ipaddress.rst:338 msgid "" "Refer to the corresponding method documentation in :class:`IPv4Address`." msgstr "" -#: library/ipaddress.rst:354 +#: library/ipaddress.rst:344 msgid "Conversion to Strings and Integers" msgstr "" -#: library/ipaddress.rst:356 +#: library/ipaddress.rst:346 msgid "" "To interoperate with networking interfaces such as the socket module, " "addresses must be converted to strings or integers. This is handled using " "the :func:`str` and :func:`int` builtin functions::" msgstr "" -#: library/ipaddress.rst:369 +#: library/ipaddress.rst:359 msgid "" "Note that IPv6 scoped addresses are converted to integers without scope zone " "ID." msgstr "" -#: library/ipaddress.rst:757 library/ipaddress.rst:893 +#: library/ipaddress.rst:747 library/ipaddress.rst:883 msgid "Operators" msgstr "" -#: library/ipaddress.rst:375 +#: library/ipaddress.rst:365 msgid "" "Address objects support some operators. Unless stated otherwise, operators " "can only be applied between compatible objects (i.e. IPv4 with IPv4, IPv6 " "with IPv6)." msgstr "" -#: library/ipaddress.rst:381 +#: library/ipaddress.rst:371 msgid "Comparison operators" msgstr "" -#: library/ipaddress.rst:383 +#: library/ipaddress.rst:373 msgid "" "Address objects can be compared with the usual set of comparison operators. " "Same IPv6 addresses with different scope zone IDs are not equal. Some " "examples::" msgstr "" -#: library/ipaddress.rst:400 +#: library/ipaddress.rst:390 msgid "Arithmetic operators" msgstr "" -#: library/ipaddress.rst:402 +#: library/ipaddress.rst:392 msgid "" "Integers can be added to or subtracted from address objects. Some examples::" msgstr "" -#: library/ipaddress.rst:415 +#: library/ipaddress.rst:405 msgid "IP Network definitions" msgstr "" -#: library/ipaddress.rst:417 +#: library/ipaddress.rst:407 msgid "" "The :class:`IPv4Network` and :class:`IPv6Network` objects provide a " "mechanism for defining and inspecting IP network definitions. A network " @@ -432,11 +421,11 @@ msgid "" "addresses in the inclusive range ``192.168.1.0`` to ``192.168.1.255``." msgstr "" -#: library/ipaddress.rst:427 +#: library/ipaddress.rst:417 msgid "Prefix, net mask and host mask" msgstr "" -#: library/ipaddress.rst:429 +#: library/ipaddress.rst:419 msgid "" "There are several equivalent ways to specify IP network masks. A *prefix* " "``/`` is a notation that denotes how many high-order bits are set in " @@ -448,11 +437,11 @@ msgid "" "mask equivalent to ``/24`` in IPv4 is ``0.0.0.255``." msgstr "" -#: library/ipaddress.rst:440 +#: library/ipaddress.rst:430 msgid "Network objects" msgstr "" -#: library/ipaddress.rst:442 +#: library/ipaddress.rst:432 msgid "" "All attributes implemented by address objects are implemented by network " "objects as well. In addition, network objects implement additional " @@ -462,12 +451,12 @@ msgid "" "keys in dictionaries." msgstr "" -#: library/ipaddress.rst:451 +#: library/ipaddress.rst:441 msgid "" "Construct an IPv4 network definition. *address* can be one of the following:" msgstr "" -#: library/ipaddress.rst:453 +#: library/ipaddress.rst:443 msgid "" "A string consisting of an IP address and an optional mask, separated by a " "slash (``/``). The IP address is the network address, and the mask can be " @@ -479,26 +468,26 @@ msgid "" "it's considered to be ``/32``." msgstr "" -#: library/ipaddress.rst:462 +#: library/ipaddress.rst:452 msgid "" "For example, the following *address* specifications are equivalent: " "``192.168.1.0/24``, ``192.168.1.0/255.255.255.0`` and " "``192.168.1.0/0.0.0.255``." msgstr "" -#: library/ipaddress.rst:466 +#: library/ipaddress.rst:456 msgid "" "An integer that fits into 32 bits. This is equivalent to a single-address " "network, with the network address being *address* and the mask being ``/32``." msgstr "" -#: library/ipaddress.rst:470 +#: library/ipaddress.rst:460 msgid "" "An integer packed into a :class:`bytes` object of length 4, big-endian. The " "interpretation is similar to an integer *address*." msgstr "" -#: library/ipaddress.rst:473 +#: library/ipaddress.rst:463 msgid "" "A two-tuple of an address description and a netmask, where the address " "description is either a string, a 32-bits integer, a 4-bytes packed integer, " @@ -507,92 +496,92 @@ msgid "" "prefix mask (e.g. ``255.255.255.0``)." msgstr "" -#: library/ipaddress.rst:479 +#: library/ipaddress.rst:469 msgid "" "An :exc:`AddressValueError` is raised if *address* is not a valid IPv4 " "address. A :exc:`NetmaskValueError` is raised if the mask is not valid for " "an IPv4 address." msgstr "" -#: library/ipaddress.rst:703 +#: library/ipaddress.rst:693 msgid "" "If *strict* is ``True`` and host bits are set in the supplied address, then :" "exc:`ValueError` is raised. Otherwise, the host bits are masked out to " "determine the appropriate network address." msgstr "" -#: library/ipaddress.rst:487 +#: library/ipaddress.rst:477 msgid "" "Unless stated otherwise, all network methods accepting other network/address " "objects will raise :exc:`TypeError` if the argument's IP version is " "incompatible to ``self``." msgstr "" -#: library/ipaddress.rst:709 +#: library/ipaddress.rst:699 msgid "Added the two-tuple form for the *address* constructor parameter." msgstr "" -#: library/ipaddress.rst:498 +#: library/ipaddress.rst:488 msgid "" "Refer to the corresponding attribute documentation in :class:`IPv4Address`." msgstr "" -#: library/ipaddress.rst:508 +#: library/ipaddress.rst:498 msgid "" "These attributes are true for the network as a whole if they are true for " "both the network address and the broadcast address." msgstr "" -#: library/ipaddress.rst:513 +#: library/ipaddress.rst:503 msgid "" "The network address for the network. The network address and the prefix " "length together uniquely define a network." msgstr "" -#: library/ipaddress.rst:518 +#: library/ipaddress.rst:508 msgid "" "The broadcast address for the network. Packets sent to the broadcast address " "should be received by every host on the network." msgstr "" -#: library/ipaddress.rst:523 +#: library/ipaddress.rst:513 msgid "The host mask, as an :class:`IPv4Address` object." msgstr "" -#: library/ipaddress.rst:527 +#: library/ipaddress.rst:517 msgid "The net mask, as an :class:`IPv4Address` object." msgstr "" -#: library/ipaddress.rst:533 +#: library/ipaddress.rst:523 msgid "" "A string representation of the network, with the mask in prefix notation." msgstr "" -#: library/ipaddress.rst:536 +#: library/ipaddress.rst:526 msgid "" "``with_prefixlen`` and ``compressed`` are always the same as " "``str(network)``. ``exploded`` uses the exploded form the network address." msgstr "" -#: library/ipaddress.rst:542 +#: library/ipaddress.rst:532 msgid "" "A string representation of the network, with the mask in net mask notation." msgstr "" -#: library/ipaddress.rst:547 +#: library/ipaddress.rst:537 msgid "" "A string representation of the network, with the mask in host mask notation." msgstr "" -#: library/ipaddress.rst:552 +#: library/ipaddress.rst:542 msgid "The total number of addresses in the network." msgstr "" -#: library/ipaddress.rst:556 +#: library/ipaddress.rst:546 msgid "Length of the network prefix, in bits." msgstr "" -#: library/ipaddress.rst:560 +#: library/ipaddress.rst:550 msgid "" "Returns an iterator over the usable hosts in the network. The usable hosts " "are all the IP addresses that belong to the network, except the network " @@ -602,20 +591,20 @@ msgid "" "containing the single host address." msgstr "" -#: library/ipaddress.rst:578 +#: library/ipaddress.rst:568 msgid "" "``True`` if this network is partly or wholly contained in *other* or *other* " "is wholly contained in this network." msgstr "" -#: library/ipaddress.rst:583 +#: library/ipaddress.rst:573 msgid "" "Computes the network definitions resulting from removing the given *network* " "from this one. Returns an iterator of network objects. Raises :exc:" "`ValueError` if *network* is not completely contained in this network." msgstr "" -#: library/ipaddress.rst:596 +#: library/ipaddress.rst:586 msgid "" "The subnets that join to make the current network definition, depending on " "the argument values. *prefixlen_diff* is the amount our prefix length " @@ -625,7 +614,7 @@ msgid "" "network objects." msgstr "" -#: library/ipaddress.rst:621 +#: library/ipaddress.rst:611 msgid "" "The supernet containing this network definition, depending on the argument " "values. *prefixlen_diff* is the amount our prefix length should be " @@ -634,33 +623,33 @@ msgid "" "*new_prefix* must be set. Returns a single network object." msgstr "" -#: library/ipaddress.rst:637 +#: library/ipaddress.rst:627 msgid "Return ``True`` if this network is a subnet of *other*." msgstr "" -#: library/ipaddress.rst:648 +#: library/ipaddress.rst:638 msgid "Return ``True`` if this network is a supernet of *other*." msgstr "" -#: library/ipaddress.rst:659 +#: library/ipaddress.rst:649 msgid "" "Compare this network to *other*. In this comparison only the network " "addresses are considered; host bits aren't. Returns either ``-1``, ``0`` or " "``1``." msgstr "" -#: library/ipaddress.rst:670 +#: library/ipaddress.rst:660 msgid "" "It uses the same ordering and comparison algorithm as \"<\", \"==\", and " "\">\"" msgstr "" -#: library/ipaddress.rst:676 +#: library/ipaddress.rst:666 msgid "" "Construct an IPv6 network definition. *address* can be one of the following:" msgstr "" -#: library/ipaddress.rst:678 +#: library/ipaddress.rst:668 msgid "" "A string consisting of an IP address and an optional prefix length, " "separated by a slash (``/``). The IP address is the network address, and " @@ -668,26 +657,26 @@ msgid "" "length is provided, it's considered to be ``/128``." msgstr "" -#: library/ipaddress.rst:683 +#: library/ipaddress.rst:673 msgid "" "Note that currently expanded netmasks are not supported. That means ``2001:" "db00::0/24`` is a valid argument while ``2001:db00::0/ffff:ff00::`` is not." msgstr "" -#: library/ipaddress.rst:687 +#: library/ipaddress.rst:677 msgid "" "An integer that fits into 128 bits. This is equivalent to a single-address " "network, with the network address being *address* and the mask being " "``/128``." msgstr "" -#: library/ipaddress.rst:691 +#: library/ipaddress.rst:681 msgid "" "An integer packed into a :class:`bytes` object of length 16, big-endian. The " "interpretation is similar to an integer *address*." msgstr "" -#: library/ipaddress.rst:694 +#: library/ipaddress.rst:684 msgid "" "A two-tuple of an address description and a netmask, where the address " "description is either a string, a 128-bits integer, a 16-bytes packed " @@ -695,14 +684,14 @@ msgid "" "representing the prefix length." msgstr "" -#: library/ipaddress.rst:699 +#: library/ipaddress.rst:689 msgid "" "An :exc:`AddressValueError` is raised if *address* is not a valid IPv6 " "address. A :exc:`NetmaskValueError` is raised if the mask is not valid for " "an IPv6 address." msgstr "" -#: library/ipaddress.rst:732 +#: library/ipaddress.rst:722 msgid "" "Returns an iterator over the usable hosts in the network. The usable hosts " "are all the IP addresses that belong to the network, except the Subnet-" @@ -711,139 +700,139 @@ msgid "" "of 128 will return a list containing the single host address." msgstr "" -#: library/ipaddress.rst:747 +#: library/ipaddress.rst:737 msgid "" "Refer to the corresponding attribute documentation in :class:`IPv4Network`." msgstr "" -#: library/ipaddress.rst:752 +#: library/ipaddress.rst:742 msgid "" "These attribute is true for the network as a whole if it is true for both " "the network address and the broadcast address." msgstr "" -#: library/ipaddress.rst:759 +#: library/ipaddress.rst:749 msgid "" "Network objects support some operators. Unless stated otherwise, operators " "can only be applied between compatible objects (i.e. IPv4 with IPv4, IPv6 " "with IPv6)." msgstr "" -#: library/ipaddress.rst:901 +#: library/ipaddress.rst:891 msgid "Logical operators" msgstr "" -#: library/ipaddress.rst:767 +#: library/ipaddress.rst:757 msgid "" "Network objects can be compared with the usual set of logical operators. " "Network objects are ordered first by network address, then by net mask." msgstr "" -#: library/ipaddress.rst:772 +#: library/ipaddress.rst:762 msgid "Iteration" msgstr "" -#: library/ipaddress.rst:774 +#: library/ipaddress.rst:764 msgid "" "Network objects can be iterated to list all the addresses belonging to the " "network. For iteration, *all* hosts are returned, including unusable hosts " "(for usable hosts, use the :meth:`~IPv4Network.hosts` method). An example::" msgstr "" -#: library/ipaddress.rst:801 +#: library/ipaddress.rst:791 msgid "Networks as containers of addresses" msgstr "" -#: library/ipaddress.rst:803 +#: library/ipaddress.rst:793 msgid "Network objects can act as containers of addresses. Some examples::" msgstr "" -#: library/ipaddress.rst:816 +#: library/ipaddress.rst:806 msgid "Interface objects" msgstr "" -#: library/ipaddress.rst:818 +#: library/ipaddress.rst:808 msgid "" "Interface objects are :term:`hashable`, so they can be used as keys in " "dictionaries." msgstr "" -#: library/ipaddress.rst:823 +#: library/ipaddress.rst:813 msgid "" "Construct an IPv4 interface. The meaning of *address* is as in the " "constructor of :class:`IPv4Network`, except that arbitrary host addresses " "are always accepted." msgstr "" -#: library/ipaddress.rst:827 +#: library/ipaddress.rst:817 msgid "" ":class:`IPv4Interface` is a subclass of :class:`IPv4Address`, so it inherits " "all the attributes from that class. In addition, the following attributes " "are available:" msgstr "" -#: library/ipaddress.rst:833 +#: library/ipaddress.rst:823 msgid "The address (:class:`IPv4Address`) without network information." msgstr "" -#: library/ipaddress.rst:841 +#: library/ipaddress.rst:831 msgid "The network (:class:`IPv4Network`) this interface belongs to." msgstr "" -#: library/ipaddress.rst:849 +#: library/ipaddress.rst:839 msgid "" "A string representation of the interface with the mask in prefix notation." msgstr "" -#: library/ipaddress.rst:857 +#: library/ipaddress.rst:847 msgid "" "A string representation of the interface with the network as a net mask." msgstr "" -#: library/ipaddress.rst:865 +#: library/ipaddress.rst:855 msgid "" "A string representation of the interface with the network as a host mask." msgstr "" -#: library/ipaddress.rst:874 +#: library/ipaddress.rst:864 msgid "" "Construct an IPv6 interface. The meaning of *address* is as in the " "constructor of :class:`IPv6Network`, except that arbitrary host addresses " "are always accepted." msgstr "" -#: library/ipaddress.rst:878 +#: library/ipaddress.rst:868 msgid "" ":class:`IPv6Interface` is a subclass of :class:`IPv6Address`, so it inherits " "all the attributes from that class. In addition, the following attributes " "are available:" msgstr "" -#: library/ipaddress.rst:888 +#: library/ipaddress.rst:878 msgid "" "Refer to the corresponding attribute documentation in :class:`IPv4Interface`." msgstr "" -#: library/ipaddress.rst:895 +#: library/ipaddress.rst:885 msgid "" "Interface objects support some operators. Unless stated otherwise, " "operators can only be applied between compatible objects (i.e. IPv4 with " "IPv4, IPv6 with IPv6)." msgstr "" -#: library/ipaddress.rst:903 +#: library/ipaddress.rst:893 msgid "" "Interface objects can be compared with the usual set of logical operators." msgstr "" -#: library/ipaddress.rst:905 +#: library/ipaddress.rst:895 msgid "" "For equality comparison (``==`` and ``!=``), both the IP address and network " "must be the same for the objects to be equal. An interface will not compare " "equal to any address or network object." msgstr "" -#: library/ipaddress.rst:909 +#: library/ipaddress.rst:899 msgid "" "For ordering (``<``, ``>``, etc) the rules are different. Interface and " "address objects with the same IP version can be compared, and the address " @@ -852,15 +841,15 @@ msgid "" "then by their IP addresses." msgstr "" -#: library/ipaddress.rst:917 +#: library/ipaddress.rst:907 msgid "Other Module Level Functions" msgstr "" -#: library/ipaddress.rst:919 +#: library/ipaddress.rst:909 msgid "The module also provides the following module level functions:" msgstr "" -#: library/ipaddress.rst:923 +#: library/ipaddress.rst:913 msgid "" "Represent an address as 4 packed bytes in network (big-endian) order. " "*address* is an integer representation of an IPv4 IP address. A :exc:" @@ -868,7 +857,7 @@ msgid "" "IP address." msgstr "" -#: library/ipaddress.rst:936 +#: library/ipaddress.rst:926 msgid "" "Represent an address as 16 packed bytes in network (big-endian) order. " "*address* is an integer representation of an IPv6 IP address. A :exc:" @@ -876,7 +865,7 @@ msgid "" "IP address." msgstr "" -#: library/ipaddress.rst:944 +#: library/ipaddress.rst:934 msgid "" "Return an iterator of the summarized network range given the first and last " "IP addresses. *first* is the first :class:`IPv4Address` or :class:" @@ -887,7 +876,7 @@ msgid "" "address version is not 4 or 6." msgstr "" -#: library/ipaddress.rst:960 +#: library/ipaddress.rst:950 msgid "" "Return an iterator of the collapsed :class:`IPv4Network` or :class:" "`IPv6Network` objects. *addresses* is an iterator of :class:`IPv4Network` " @@ -895,38 +884,38 @@ msgid "" "*addresses* contains mixed version objects." msgstr "" -#: library/ipaddress.rst:973 +#: library/ipaddress.rst:963 msgid "" "Return a key suitable for sorting between networks and addresses. Address " "and Network objects are not sortable by default; they're fundamentally " "different, so the expression::" msgstr "" -#: library/ipaddress.rst:979 +#: library/ipaddress.rst:969 msgid "" "doesn't make sense. There are some times however, where you may wish to " "have :mod:`ipaddress` sort these anyway. If you need to do this, you can " "use this function as the *key* argument to :func:`sorted()`." msgstr "" -#: library/ipaddress.rst:983 +#: library/ipaddress.rst:973 msgid "*obj* is either a network or address object." msgstr "" -#: library/ipaddress.rst:987 +#: library/ipaddress.rst:977 msgid "Custom Exceptions" msgstr "" -#: library/ipaddress.rst:989 +#: library/ipaddress.rst:979 msgid "" "To support more specific error reporting from class constructors, the module " "defines the following exceptions:" msgstr "" -#: library/ipaddress.rst:994 +#: library/ipaddress.rst:984 msgid "Any value error related to the address." msgstr "" -#: library/ipaddress.rst:999 +#: library/ipaddress.rst:989 msgid "Any value error related to the net mask." msgstr "" diff --git a/library/itertools.po b/library/itertools.po index e9c09a674..cffa3ef37 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-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -84,7 +84,7 @@ msgid "start, start+step, start+2*step, ..." msgstr "" #: library/itertools.rst:44 -msgid "``count(10) --> 10 11 12 13 14 ...``" +msgid "``count(10) → 10 11 12 13 14 ...``" msgstr "" #: library/itertools.rst:45 @@ -100,7 +100,7 @@ msgid "p0, p1, ... plast, p0, p1, ..." msgstr "" #: library/itertools.rst:45 -msgid "``cycle('ABCD') --> A B C D A B C D ...``" +msgid "``cycle('ABCD') → A B C D A B C D ...``" msgstr "" #: library/itertools.rst:46 @@ -116,7 +116,7 @@ msgid "elem, elem, elem, ... endlessly or up to n times" msgstr "" #: library/itertools.rst:46 -msgid "``repeat(10, 3) --> 10 10 10``" +msgid "``repeat(10, 3) → 10 10 10``" msgstr "" #: library/itertools.rst:49 @@ -136,7 +136,7 @@ msgid "p0, p0+p1, p0+p1+p2, ..." msgstr "" #: library/itertools.rst:54 -msgid "``accumulate([1,2,3,4,5]) --> 1 3 6 10 15``" +msgid "``accumulate([1,2,3,4,5]) → 1 3 6 10 15``" msgstr "" #: library/itertools.rst:55 @@ -152,7 +152,7 @@ msgid "(p0, p1, ..., p_n-1), ..." msgstr "" #: library/itertools.rst:55 -msgid "``batched('ABCDEFG', n=3) --> ABC DEF G``" +msgid "``batched('ABCDEFG', n=3) → ABC DEF G``" msgstr "" #: library/itertools.rst:56 @@ -168,7 +168,7 @@ msgid "p0, p1, ... plast, q0, q1, ..." msgstr "" #: library/itertools.rst:56 -msgid "``chain('ABC', 'DEF') --> A B C D E F``" +msgid "``chain('ABC', 'DEF') → A B C D E F``" msgstr "" #: library/itertools.rst:57 @@ -180,7 +180,7 @@ msgid "iterable" msgstr "" #: library/itertools.rst:57 -msgid "``chain.from_iterable(['ABC', 'DEF']) --> A B C D E F``" +msgid "``chain.from_iterable(['ABC', 'DEF']) → A B C D E F``" msgstr "" #: library/itertools.rst:58 @@ -196,7 +196,7 @@ msgid "(d[0] if s[0]), (d[1] if s[1]), ..." msgstr "" #: library/itertools.rst:58 -msgid "``compress('ABCDEF', [1,0,1,0,1,1]) --> A C E F``" +msgid "``compress('ABCDEF', [1,0,1,0,1,1]) → A C E F``" msgstr "" #: library/itertools.rst:59 @@ -204,15 +204,15 @@ msgid ":func:`dropwhile`" msgstr "" #: library/itertools.rst:60 library/itertools.rst:65 -msgid "pred, seq" +msgid "predicate, seq" msgstr "" #: library/itertools.rst:59 -msgid "seq[n], seq[n+1], starting when pred fails" +msgid "seq[n], seq[n+1], starting when predicate fails" msgstr "" #: library/itertools.rst:59 -msgid "``dropwhile(lambda x: x<5, [1,4,6,4,1]) --> 6 4 1``" +msgid "``dropwhile(lambda x: x<5, [1,4,6,4,1]) → 6 4 1``" msgstr "" #: library/itertools.rst:60 @@ -220,11 +220,11 @@ msgid ":func:`filterfalse`" msgstr "" #: library/itertools.rst:60 -msgid "elements of seq where pred(elem) is false" +msgid "elements of seq where predicate(elem) fails" msgstr "" #: library/itertools.rst:60 -msgid "``filterfalse(lambda x: x%2, range(10)) --> 0 2 4 6 8``" +msgid "``filterfalse(lambda x: x%2, range(10)) → 0 2 4 6 8``" msgstr "" #: library/itertools.rst:61 @@ -252,7 +252,7 @@ msgid "elements from seq[start:stop:step]" msgstr "" #: library/itertools.rst:62 -msgid "``islice('ABCDEFG', 2, None) --> C D E F G``" +msgid "``islice('ABCDEFG', 2, None) → C D E F G``" msgstr "" #: library/itertools.rst:63 @@ -264,7 +264,7 @@ msgid "(p[0], p[1]), (p[1], p[2])" msgstr "" #: library/itertools.rst:63 -msgid "``pairwise('ABCDEFG') --> AB BC CD DE EF FG``" +msgid "``pairwise('ABCDEFG') → AB BC CD DE EF FG``" msgstr "" #: library/itertools.rst:64 @@ -280,7 +280,7 @@ msgid "func(\\*seq[0]), func(\\*seq[1]), ..." msgstr "" #: library/itertools.rst:64 -msgid "``starmap(pow, [(2,5), (3,2), (10,3)]) --> 32 9 1000``" +msgid "``starmap(pow, [(2,5), (3,2), (10,3)]) → 32 9 1000``" msgstr "" #: library/itertools.rst:65 @@ -288,11 +288,11 @@ msgid ":func:`takewhile`" msgstr "" #: library/itertools.rst:65 -msgid "seq[0], seq[1], until pred fails" +msgid "seq[0], seq[1], until predicate fails" msgstr "" #: library/itertools.rst:65 -msgid "``takewhile(lambda x: x<5, [1,4,6,4,1]) --> 1 4``" +msgid "``takewhile(lambda x: x<5, [1,4,6,4,1]) → 1 4``" msgstr "" #: library/itertools.rst:66 @@ -316,7 +316,7 @@ msgid "(p[0], q[0]), (p[1], q[1]), ..." msgstr "" #: library/itertools.rst:67 -msgid "``zip_longest('ABCD', 'xy', fillvalue='-') --> Ax By C- D-``" +msgid "``zip_longest('ABCD', 'xy', fillvalue='-') → Ax By C- D-``" msgstr "" #: library/itertools.rst:70 @@ -404,7 +404,7 @@ msgid "``AA AB AC AD BB BC BD CC CD DD``" msgstr "" #: library/itertools.rst:94 -msgid "Itertool functions" +msgid "Itertool Functions" msgstr "" #: library/itertools.rst:96 @@ -438,7 +438,7 @@ msgid "" msgstr "" #: library/itertools.rst:191 library/itertools.rst:291 -#: library/itertools.rst:527 library/itertools.rst:634 +#: library/itertools.rst:527 library/itertools.rst:636 msgid "Roughly equivalent to::" msgstr "" @@ -668,56 +668,56 @@ msgid "" "values." msgstr "" -#: library/itertools.rst:540 +#: library/itertools.rst:542 msgid "" "Return successive *r* length permutations of elements in the *iterable*." msgstr "" -#: library/itertools.rst:542 +#: library/itertools.rst:544 msgid "" "If *r* is not specified or is ``None``, then *r* defaults to the length of " "the *iterable* and all possible full-length permutations are generated." msgstr "" -#: library/itertools.rst:546 +#: library/itertools.rst:548 msgid "" "The permutation tuples are emitted in lexicographic order according to the " "order of the input *iterable*. So, if the input *iterable* is sorted, the " "output tuples will be produced in sorted order." msgstr "" -#: library/itertools.rst:550 +#: library/itertools.rst:552 msgid "" "Elements are treated as unique based on their position, not on their value. " "So if the input elements are unique, there will be no repeated values within " "a permutation." msgstr "" -#: library/itertools.rst:581 +#: library/itertools.rst:583 msgid "" "The code for :func:`permutations` can be also expressed as a subsequence of :" "func:`product`, filtered to exclude entries with repeated elements (those " "from the same position in the input pool)::" msgstr "" -#: library/itertools.rst:593 +#: library/itertools.rst:595 msgid "" "The number of items returned is ``n! / (n-r)!`` when ``0 <= r <= n`` or zero " "when ``r > n``." msgstr "" -#: library/itertools.rst:598 +#: library/itertools.rst:600 msgid "Cartesian product of input iterables." msgstr "" -#: library/itertools.rst:600 +#: library/itertools.rst:602 msgid "" "Roughly equivalent to nested for-loops in a generator expression. For " "example, ``product(A, B)`` returns the same as ``((x,y) for x in A for y in " "B)``." msgstr "" -#: library/itertools.rst:603 +#: library/itertools.rst:605 msgid "" "The nested loops cycle like an odometer with the rightmost element advancing " "on every iteration. This pattern creates a lexicographic ordering so that " @@ -725,39 +725,39 @@ msgid "" "sorted order." msgstr "" -#: library/itertools.rst:608 +#: library/itertools.rst:610 msgid "" "To compute the product of an iterable with itself, specify the number of " "repetitions with the optional *repeat* keyword argument. For example, " "``product(A, repeat=4)`` means the same as ``product(A, A, A, A)``." msgstr "" -#: library/itertools.rst:612 +#: library/itertools.rst:614 msgid "" "This function is roughly equivalent to the following code, except that the " "actual implementation does not build up intermediate results in memory::" msgstr "" -#: library/itertools.rst:625 +#: library/itertools.rst:627 msgid "" "Before :func:`product` runs, it completely consumes the input iterables, " "keeping pools of values in memory to generate the products. Accordingly, it " "is only useful with finite inputs." msgstr "" -#: library/itertools.rst:631 +#: library/itertools.rst:633 msgid "" "Make an iterator that returns *object* over and over again. Runs " "indefinitely unless the *times* argument is specified." msgstr "" -#: library/itertools.rst:645 +#: library/itertools.rst:647 msgid "" "A common use for *repeat* is to supply a stream of constant values to *map* " "or *zip*:" msgstr "" -#: library/itertools.rst:655 +#: library/itertools.rst:657 msgid "" "Make an iterator that computes the function using arguments obtained from " "the iterable. Used instead of :func:`map` when argument parameters are " @@ -765,20 +765,20 @@ msgid "" "\"pre-zipped\")." msgstr "" -#: library/itertools.rst:660 +#: library/itertools.rst:662 msgid "" "The difference between :func:`map` and :func:`starmap` parallels the " "distinction between ``function(a,b)`` and ``function(*c)``. Roughly " "equivalent to::" msgstr "" -#: library/itertools.rst:672 +#: library/itertools.rst:674 msgid "" "Make an iterator that returns elements from the iterable as long as the " "predicate is true. Roughly equivalent to::" msgstr "" -#: library/itertools.rst:683 +#: library/itertools.rst:685 msgid "" "Note, the element that first fails the predicate condition is consumed from " "the input iterator and there is no way to access it. This could be an issue " @@ -788,32 +788,32 @@ msgid "" "io/en/stable/api.html#more_itertools.before_and_after>`_ instead." msgstr "" -#: library/itertools.rst:694 +#: library/itertools.rst:696 msgid "Return *n* independent iterators from a single iterable." msgstr "" -#: library/itertools.rst:696 +#: library/itertools.rst:698 msgid "" "The following Python code helps explain what *tee* does (although the actual " "implementation is more complex and uses only a single underlying :abbr:`FIFO " "(first-in, first-out)` queue)::" msgstr "" -#: library/itertools.rst:715 +#: library/itertools.rst:717 msgid "" "Once a :func:`tee` has been created, the original *iterable* should not be " "used anywhere else; otherwise, the *iterable* could get advanced without the " "tee objects being informed." msgstr "" -#: library/itertools.rst:719 +#: library/itertools.rst:721 msgid "" "``tee`` iterators are not threadsafe. A :exc:`RuntimeError` may be raised " "when simultaneously using iterators returned by the same :func:`tee` call, " "even if the original *iterable* is threadsafe." msgstr "" -#: library/itertools.rst:723 +#: library/itertools.rst:725 msgid "" "This itertool may require significant auxiliary storage (depending on how " "much temporary data needs to be stored). In general, if one iterator uses " @@ -821,7 +821,7 @@ msgid "" "func:`list` instead of :func:`tee`." msgstr "" -#: library/itertools.rst:731 +#: library/itertools.rst:733 msgid "" "Make an iterator that aggregates elements from each of the iterables. If the " "iterables are of uneven length, missing values are filled-in with " @@ -829,7 +829,7 @@ msgid "" "Roughly equivalent to::" msgstr "" -#: library/itertools.rst:755 +#: library/itertools.rst:757 msgid "" "If one of the iterables is potentially infinite, then the :func:" "`zip_longest` function should be wrapped with something that limits the " @@ -837,17 +837,17 @@ msgid "" "specified, *fillvalue* defaults to ``None``." msgstr "" -#: library/itertools.rst:764 +#: library/itertools.rst:766 msgid "Itertools Recipes" msgstr "" -#: library/itertools.rst:766 +#: library/itertools.rst:768 msgid "" "This section shows recipes for creating an extended toolset using the " "existing itertools as building blocks." msgstr "" -#: library/itertools.rst:769 +#: library/itertools.rst:771 msgid "" "The primary purpose of the itertools recipes is educational. The recipes " "show various ways of thinking about individual tools — for example, that " @@ -859,32 +859,33 @@ msgid "" "``map()``, ``filter()``, ``reversed()``, and ``enumerate()``." msgstr "" -#: library/itertools.rst:778 +#: library/itertools.rst:780 msgid "" "A secondary purpose of the recipes is to serve as an incubator. The " "``accumulate()``, ``compress()``, and ``pairwise()`` itertools started out " -"as recipes. Currently, the ``sliding_window()`` and ``iter_index()`` " -"recipes are being tested to see whether they prove their worth." +"as recipes. Currently, the ``sliding_window()``, ``iter_index()``, and " +"``sieve()`` recipes are being tested to see whether they prove their worth." msgstr "" -#: library/itertools.rst:783 +#: library/itertools.rst:785 msgid "" "Substantially all of these recipes and many, many others can be installed " "from the `more-itertools project `_ found on the Python Package Index::" msgstr "" -#: library/itertools.rst:789 +#: library/itertools.rst:791 msgid "" "Many of the recipes offer the same high performance as the underlying " "toolset. Superior memory performance is kept by processing elements one at a " "time rather than bringing the whole iterable into memory all at once. Code " -"volume is kept small by linking the tools together in a functional style " -"which helps eliminate temporary variables. High speed is retained by " -"preferring \"vectorized\" building blocks over the use of for-loops and :" -"term:`generator`\\s which incur interpreter overhead." +"volume is kept small by linking the tools together in a `functional style " +"`_. High " +"speed is retained by preferring \"vectorized\" building blocks over the use " +"of for-loops and :term:`generators ` which incur interpreter " +"overhead." msgstr "" -#: library/itertools.rst:989 +#: library/itertools.rst:980 msgid "The following recipes have a more mathematical flavor:" msgstr "" diff --git a/library/logging.po b/library/logging.po index b6a8e7b3b..99a868ca9 100644 --- a/library/logging.po +++ b/library/logging.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -57,47 +57,73 @@ msgid "" msgstr "" #: library/logging.rst:33 -msgid "The simplest example:" +msgid "Here's a simple example of idiomatic usage: ::" msgstr "" -#: library/logging.rst:41 +#: library/logging.rst:58 +msgid "If you run *myapp.py*, you should see this in *myapp.log*:" +msgstr "" + +#: library/logging.rst:66 +msgid "" +"The key features of this idiomatic usage is that the majority of code is " +"simply creating a module level logger with ``getLogger(__name__)``, and " +"using that logger to do any needed logging. This is concise while allowing " +"downstream code fine grained control if needed. Logged messages to the " +"module-level logger get forwarded up to handlers of loggers in higher-level " +"modules, all the way up to the root logger; for this reason this approach is " +"known as hierarchical logging." +msgstr "" + +#: library/logging.rst:73 +msgid "" +"For logging to be useful, it needs to be configured: setting the levels and " +"destinations for each logger, potentially changing how specific modules log, " +"often based on command-line arguments or application configuration. In most " +"cases, like the one above, only the root logger needs to be so configured, " +"since all the lower level loggers at module level eventually forward their " +"messages to its handlers. :func:`~logging.basicConfig` provides a quick way " +"to configure the root logger that handles many use cases." +msgstr "" + +#: library/logging.rst:81 msgid "" "The module provides a lot of functionality and flexibility. If you are " "unfamiliar with logging, the best way to get to grips with it is to view the " "tutorials (**see the links above and on the right**)." msgstr "" -#: library/logging.rst:45 +#: library/logging.rst:85 msgid "" "The basic classes defined by the module, together with their functions, are " "listed below." msgstr "" -#: library/logging.rst:48 +#: library/logging.rst:88 msgid "Loggers expose the interface that application code directly uses." msgstr "" -#: library/logging.rst:49 +#: library/logging.rst:89 msgid "" "Handlers send the log records (created by loggers) to the appropriate " "destination." msgstr "" -#: library/logging.rst:51 +#: library/logging.rst:91 msgid "" "Filters provide a finer grained facility for determining which log records " "to output." msgstr "" -#: library/logging.rst:53 +#: library/logging.rst:93 msgid "Formatters specify the layout of log records in the final output." msgstr "" -#: library/logging.rst:59 +#: library/logging.rst:99 msgid "Logger Objects" msgstr "" -#: library/logging.rst:61 +#: library/logging.rst:101 msgid "" "Loggers have the following attributes and methods. Note that Loggers should " "*NEVER* be instantiated directly, but always through the module-level " @@ -105,7 +131,7 @@ msgid "" "with the same name will always return a reference to the same Logger object." msgstr "" -#: library/logging.rst:66 +#: library/logging.rst:106 msgid "" "The ``name`` is potentially a period-separated hierarchical value, like " "``foo.bar.baz`` (though it could also be just plain ``foo``, for example). " @@ -119,37 +145,37 @@ msgid "" "module's name in the Python package namespace." msgstr "" -#: library/logging.rst:82 +#: library/logging.rst:122 msgid "" "This is the logger's name, and is the value that was passed to :func:" "`getLogger` to obtain the logger." msgstr "" -#: library/logging.rst:145 +#: library/logging.rst:185 msgid "This attribute should be treated as read-only." msgstr "" -#: library/logging.rst:89 +#: library/logging.rst:129 msgid "The threshold of this logger, as set by the :meth:`setLevel` method." msgstr "" -#: library/logging.rst:91 +#: library/logging.rst:131 msgid "" "Do not set this attribute directly - always use :meth:`setLevel`, which has " "checks for the level passed to it." msgstr "" -#: library/logging.rst:96 +#: library/logging.rst:136 msgid "" "The parent logger of this logger. It may change based on later instantiation " "of loggers which are higher up in the namespace hierarchy." msgstr "" -#: library/logging.rst:99 +#: library/logging.rst:139 msgid "This value should be treated as read-only." msgstr "" -#: library/logging.rst:103 +#: library/logging.rst:143 msgid "" "If this attribute evaluates to true, events logged to this logger will be " "passed to the handlers of higher level (ancestor) loggers, in addition to " @@ -158,13 +184,13 @@ msgid "" "loggers in question are considered." msgstr "" -#: library/logging.rst:109 +#: library/logging.rst:149 msgid "" "If this evaluates to false, logging messages are not passed to the handlers " "of ancestor loggers." msgstr "" -#: library/logging.rst:112 +#: library/logging.rst:152 msgid "" "Spelling it out with an example: If the propagate attribute of the logger " "named ``A.B.C`` evaluates to true, any event logged to ``A.B.C`` via a " @@ -177,11 +203,11 @@ msgid "" "handle, and propagation stops at that point." msgstr "" -#: library/logging.rst:121 +#: library/logging.rst:161 msgid "The constructor sets this attribute to ``True``." msgstr "" -#: library/logging.rst:123 +#: library/logging.rst:163 msgid "" "If you attach a handler to a logger *and* one or more of its ancestors, it " "may emit the same record multiple times. In general, you should not need to " @@ -193,24 +219,24 @@ msgid "" "rest." msgstr "" -#: library/logging.rst:134 +#: library/logging.rst:174 msgid "The list of handlers directly attached to this logger instance." msgstr "" -#: library/logging.rst:136 +#: library/logging.rst:176 msgid "" "This attribute should be treated as read-only; it is normally changed via " "the :meth:`addHandler` and :meth:`removeHandler` methods, which use locks to " "ensure thread-safe operation." msgstr "" -#: library/logging.rst:142 +#: library/logging.rst:182 msgid "" "This attribute disables handling of any events. It is set to ``False`` in " "the initializer, and only changed by logging configuration code." msgstr "" -#: library/logging.rst:149 +#: library/logging.rst:189 msgid "" "Sets the threshold for this logger to *level*. Logging messages which are " "less severe than *level* will be ignored; logging messages which have " @@ -219,7 +245,7 @@ msgid "" "severity level than *level*." msgstr "" -#: library/logging.rst:154 +#: library/logging.rst:194 msgid "" "When a logger is created, the level is set to :const:`NOTSET` (which causes " "all messages to be processed when the logger is the root logger, or " @@ -227,32 +253,32 @@ msgid "" "the root logger is created with level :const:`WARNING`." msgstr "" -#: library/logging.rst:159 +#: library/logging.rst:199 msgid "" "The term 'delegation to the parent' means that if a logger has a level of " "NOTSET, its chain of ancestor loggers is traversed until either an ancestor " "with a level other than NOTSET is found, or the root is reached." msgstr "" -#: library/logging.rst:163 +#: library/logging.rst:203 msgid "" "If an ancestor is found with a level other than NOTSET, then that ancestor's " "level is treated as the effective level of the logger where the ancestor " "search began, and is used to determine how a logging event is handled." msgstr "" -#: library/logging.rst:167 +#: library/logging.rst:207 msgid "" "If the root is reached, and it has a level of NOTSET, then all messages will " "be processed. Otherwise, the root's level will be used as the effective " "level." msgstr "" -#: library/logging.rst:513 +#: library/logging.rst:553 msgid "See :ref:`levels` for a list of levels." msgstr "" -#: library/logging.rst:172 +#: library/logging.rst:212 msgid "" "The *level* parameter now accepts a string representation of the level such " "as 'INFO' as an alternative to the integer constants such as :const:`INFO`. " @@ -261,7 +287,7 @@ msgid "" "expect to be passed integers." msgstr "" -#: library/logging.rst:182 +#: library/logging.rst:222 msgid "" "Indicates if a message of severity *level* would be processed by this " "logger. This method checks first the module-level level set by ``logging." @@ -269,7 +295,7 @@ msgid "" "meth:`getEffectiveLevel`." msgstr "" -#: library/logging.rst:190 +#: library/logging.rst:230 msgid "" "Indicates the effective level for this logger. If a value other than :const:" "`NOTSET` has been set using :meth:`setLevel`, it is returned. Otherwise, the " @@ -278,7 +304,7 @@ msgid "" "integer, typically one of :const:`logging.DEBUG`, :const:`logging.INFO` etc." msgstr "" -#: library/logging.rst:200 +#: library/logging.rst:240 msgid "" "Returns a logger which is a descendant to this logger, as determined by the " "suffix. Thus, ``logging.getLogger('abc').getChild('def.ghi')`` would return " @@ -287,7 +313,7 @@ msgid "" "named using e.g. ``__name__`` rather than a literal string." msgstr "" -#: library/logging.rst:211 +#: library/logging.rst:251 msgid "" "Returns a set of loggers which are immediate children of this logger. So for " "example ``logging.getLogger().getChildren()`` might return a set containing " @@ -297,7 +323,7 @@ msgid "" "include one named ``foo.bar.baz``." msgstr "" -#: library/logging.rst:223 +#: library/logging.rst:263 msgid "" "Logs a message with level :const:`DEBUG` on this logger. The *msg* is the " "message format string, and the *args* are the arguments which are merged " @@ -307,13 +333,13 @@ msgid "" "are supplied." msgstr "" -#: library/logging.rst:229 +#: library/logging.rst:269 msgid "" "There are four keyword arguments in *kwargs* which are inspected: " "*exc_info*, *stack_info*, *stacklevel* and *extra*." msgstr "" -#: library/logging.rst:232 +#: library/logging.rst:272 msgid "" "If *exc_info* does not evaluate as false, it causes exception information to " "be added to the logging message. If an exception tuple (in the format " @@ -322,7 +348,7 @@ msgid "" "information." msgstr "" -#: library/logging.rst:1152 +#: library/logging.rst:277 msgid "" "The second optional keyword argument is *stack_info*, which defaults to " "``False``. If true, stack information is added to the logging message, " @@ -334,20 +360,20 @@ msgid "" "handlers." msgstr "" -#: library/logging.rst:1161 +#: library/logging.rst:286 msgid "" "You can specify *stack_info* independently of *exc_info*, e.g. to just show " "how you got to a certain point in your code, even when no exceptions were " "raised. The stack frames are printed following a header line which says:" msgstr "" -#: library/logging.rst:1169 +#: library/logging.rst:294 msgid "" "This mimics the ``Traceback (most recent call last):`` which is used when " "displaying exception frames." msgstr "" -#: library/logging.rst:257 +#: library/logging.rst:297 msgid "" "The third optional keyword argument is *stacklevel*, which defaults to " "``1``. If greater than 1, the corresponding number of stack frames are " @@ -359,7 +385,7 @@ msgid "" "module." msgstr "" -#: library/logging.rst:265 +#: library/logging.rst:305 msgid "" "The fourth keyword argument is *extra* which can be used to pass a " "dictionary which is used to populate the __dict__ of the :class:`LogRecord` " @@ -368,18 +394,18 @@ msgid "" "incorporated into logged messages. For example::" msgstr "" -#: library/logging.rst:277 +#: library/logging.rst:317 msgid "would print something like" msgstr "" -#: library/logging.rst:283 +#: library/logging.rst:323 msgid "" "The keys in the dictionary passed in *extra* should not clash with the keys " "used by the logging system. (See the section on :ref:`logrecord-attributes` " "for more information on which keys are used by the logging system.)" msgstr "" -#: library/logging.rst:287 +#: library/logging.rst:327 msgid "" "If you choose to use these attributes in logged messages, you need to " "exercise some care. In the above example, for instance, the :class:" @@ -390,7 +416,7 @@ msgid "" "dictionary with these keys." msgstr "" -#: library/logging.rst:1200 +#: library/logging.rst:334 msgid "" "While this might be annoying, this feature is intended for use in " "specialized circumstances, such as multi-threaded servers where the same " @@ -401,78 +427,78 @@ msgid "" "particular :class:`Handler`\\ s." msgstr "" -#: library/logging.rst:301 +#: library/logging.rst:341 msgid "" "If no handler is attached to this logger (or any of its ancestors, taking " "into account the relevant :attr:`Logger.propagate` attributes), the message " "will be sent to the handler set on :attr:`lastResort`." msgstr "" -#: library/logging.rst:1211 +#: library/logging.rst:345 msgid "The *stack_info* parameter was added." msgstr "" -#: library/logging.rst:308 +#: library/logging.rst:348 msgid "The *exc_info* parameter can now accept exception instances." msgstr "" -#: library/logging.rst:311 +#: library/logging.rst:351 msgid "The *stacklevel* parameter was added." msgstr "" -#: library/logging.rst:317 +#: library/logging.rst:357 msgid "" "Logs a message with level :const:`INFO` on this logger. The arguments are " "interpreted as for :meth:`debug`." msgstr "" -#: library/logging.rst:323 +#: library/logging.rst:363 msgid "" "Logs a message with level :const:`WARNING` on this logger. The arguments are " "interpreted as for :meth:`debug`." msgstr "" -#: library/logging.rst:326 +#: library/logging.rst:366 msgid "" "There is an obsolete method ``warn`` which is functionally identical to " "``warning``. As ``warn`` is deprecated, please do not use it - use " "``warning`` instead." msgstr "" -#: library/logging.rst:332 +#: library/logging.rst:372 msgid "" "Logs a message with level :const:`ERROR` on this logger. The arguments are " "interpreted as for :meth:`debug`." msgstr "" -#: library/logging.rst:338 +#: library/logging.rst:378 msgid "" "Logs a message with level :const:`CRITICAL` on this logger. The arguments " "are interpreted as for :meth:`debug`." msgstr "" -#: library/logging.rst:344 +#: library/logging.rst:384 msgid "" "Logs a message with integer level *level* on this logger. The other " "arguments are interpreted as for :meth:`debug`." msgstr "" -#: library/logging.rst:350 +#: library/logging.rst:390 msgid "" "Logs a message with level :const:`ERROR` on this logger. The arguments are " "interpreted as for :meth:`debug`. Exception info is added to the logging " "message. This method should only be called from an exception handler." msgstr "" -#: library/logging.rst:357 +#: library/logging.rst:397 msgid "Adds the specified filter *filter* to this logger." msgstr "" -#: library/logging.rst:362 +#: library/logging.rst:402 msgid "Removes the specified filter *filter* from this logger." msgstr "" -#: library/logging.rst:367 +#: library/logging.rst:407 msgid "" "Apply this logger's filters to the record and return ``True`` if the record " "is to be processed. The filters are consulted in turn, until one of them " @@ -481,22 +507,22 @@ msgid "" "processing of the record occurs." msgstr "" -#: library/logging.rst:376 +#: library/logging.rst:416 msgid "Adds the specified handler *hdlr* to this logger." msgstr "" -#: library/logging.rst:381 +#: library/logging.rst:421 msgid "Removes the specified handler *hdlr* from this logger." msgstr "" -#: library/logging.rst:386 +#: library/logging.rst:426 msgid "" "Finds the caller's source filename and line number. Returns the filename, " "line number, function name and stack information as a 4-element tuple. The " "stack information is returned as ``None`` unless *stack_info* is ``True``." msgstr "" -#: library/logging.rst:390 +#: library/logging.rst:430 msgid "" "The *stacklevel* parameter is passed from code calling the :meth:`debug` and " "other APIs. If greater than 1, the excess is used to skip stack frames " @@ -506,7 +532,7 @@ msgid "" "calls it." msgstr "" -#: library/logging.rst:400 +#: library/logging.rst:440 msgid "" "Handles a record by passing it to all handlers associated with this logger " "and its ancestors (until a false value of *propagate* is found). This method " @@ -515,13 +541,13 @@ msgid "" "filter`." msgstr "" -#: library/logging.rst:408 +#: library/logging.rst:448 msgid "" "This is a factory method which can be overridden in subclasses to create " "specialized :class:`LogRecord` instances." msgstr "" -#: library/logging.rst:413 +#: library/logging.rst:453 msgid "" "Checks to see if this logger has any handlers configured. This is done by " "looking for handlers in this logger and its parents in the logger hierarchy. " @@ -531,15 +557,15 @@ msgid "" "the existence of handlers." msgstr "" -#: library/logging.rst:422 +#: library/logging.rst:462 msgid "Loggers can now be pickled and unpickled." msgstr "" -#: library/logging.rst:428 +#: library/logging.rst:468 msgid "Logging Levels" msgstr "" -#: library/logging.rst:430 +#: library/logging.rst:470 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 " @@ -548,83 +574,83 @@ msgid "" "value; the predefined name is lost." msgstr "" -#: library/logging.rst:437 +#: library/logging.rst:477 msgid "Level" msgstr "" -#: library/logging.rst:437 +#: library/logging.rst:477 msgid "Numeric value" msgstr "" -#: library/logging.rst:437 +#: library/logging.rst:477 msgid "What it means / When to use it" msgstr "" -#: library/logging.rst:439 +#: library/logging.rst:479 msgid "0" msgstr "" -#: library/logging.rst:439 +#: library/logging.rst:479 msgid "" "When set on a logger, indicates that ancestor loggers are to be consulted to " "determine the effective level. If that still resolves to :const:`!NOTSET`, " "then all events are logged. When set on a handler, all events are handled." msgstr "" -#: library/logging.rst:447 +#: library/logging.rst:487 msgid "10" msgstr "" -#: library/logging.rst:447 +#: library/logging.rst:487 msgid "" "Detailed information, typically only of interest to a developer trying to " "diagnose a problem." msgstr "" -#: library/logging.rst:451 +#: library/logging.rst:491 msgid "20" msgstr "" -#: library/logging.rst:451 +#: library/logging.rst:491 msgid "Confirmation that things are working as expected." msgstr "" -#: library/logging.rst:454 +#: library/logging.rst:494 msgid "30" msgstr "" -#: library/logging.rst:454 +#: library/logging.rst:494 msgid "" "An indication that something unexpected happened, or that a problem might " "occur in the near future (e.g. 'disk space low'). The software is still " "working as expected." msgstr "" -#: library/logging.rst:461 +#: library/logging.rst:501 msgid "40" msgstr "" -#: library/logging.rst:461 +#: library/logging.rst:501 msgid "" "Due to a more serious problem, the software has not been able to perform " "some function." msgstr "" -#: library/logging.rst:465 +#: library/logging.rst:505 msgid "50" msgstr "" -#: library/logging.rst:465 +#: library/logging.rst:505 msgid "" "A serious error, indicating that the program itself may be unable to " "continue running." msgstr "" -#: library/logging.rst:474 +#: library/logging.rst:514 msgid "Handler Objects" msgstr "" -#: library/logging.rst:476 +#: library/logging.rst:516 msgid "" "Handlers have the following attributes and methods. Note that :class:" "`Handler` is never instantiated directly; this class acts as a base for more " @@ -632,53 +658,53 @@ msgid "" "to call :meth:`Handler.__init__`." msgstr "" -#: library/logging.rst:485 +#: library/logging.rst:525 msgid "" "Initializes the :class:`Handler` instance by setting its level, setting the " "list of filters to the empty list and creating a lock (using :meth:" "`createLock`) for serializing access to an I/O mechanism." msgstr "" -#: library/logging.rst:492 +#: library/logging.rst:532 msgid "" "Initializes a thread lock which can be used to serialize access to " "underlying I/O functionality which may not be threadsafe." msgstr "" -#: library/logging.rst:498 +#: library/logging.rst:538 msgid "Acquires the thread lock created with :meth:`createLock`." msgstr "" -#: library/logging.rst:503 +#: library/logging.rst:543 msgid "Releases the thread lock acquired with :meth:`acquire`." msgstr "" -#: library/logging.rst:508 +#: library/logging.rst:548 msgid "" "Sets the threshold for this handler to *level*. Logging messages which are " "less severe than *level* will be ignored. When a handler is created, the " "level is set to :const:`NOTSET` (which causes all messages to be processed)." msgstr "" -#: library/logging.rst:515 +#: library/logging.rst:555 msgid "" "The *level* parameter now accepts a string representation of the level such " "as 'INFO' as an alternative to the integer constants such as :const:`INFO`." msgstr "" -#: library/logging.rst:523 +#: library/logging.rst:563 msgid "Sets the :class:`Formatter` for this handler to *fmt*." msgstr "" -#: library/logging.rst:528 +#: library/logging.rst:568 msgid "Adds the specified filter *filter* to this handler." msgstr "" -#: library/logging.rst:533 +#: library/logging.rst:573 msgid "Removes the specified filter *filter* from this handler." msgstr "" -#: library/logging.rst:538 +#: library/logging.rst:578 msgid "" "Apply this handler's filters to the record and return ``True`` if the record " "is to be processed. The filters are consulted in turn, until one of them " @@ -687,13 +713,13 @@ msgid "" "record." msgstr "" -#: library/logging.rst:547 +#: library/logging.rst:587 msgid "" "Ensure all logging output has been flushed. This version does nothing and is " "intended to be implemented by subclasses." msgstr "" -#: library/logging.rst:553 +#: library/logging.rst:593 msgid "" "Tidy up any resources used by the handler. This version does no output but " "removes the handler from an internal list of handlers which is closed when :" @@ -701,14 +727,14 @@ msgid "" "from overridden :meth:`close` methods." msgstr "" -#: library/logging.rst:561 +#: library/logging.rst:601 msgid "" "Conditionally emits the specified logging record, depending on filters which " "may have been added to the handler. Wraps the actual emission of the record " "with acquisition/release of the I/O thread lock." msgstr "" -#: library/logging.rst:568 +#: library/logging.rst:608 msgid "" "This method should be called from handlers when an exception is encountered " "during an :meth:`emit` call. If the module-level attribute :data:" @@ -721,20 +747,20 @@ msgid "" "is more useful during development)." msgstr "" -#: library/logging.rst:581 +#: library/logging.rst:621 msgid "" "Do formatting for a record - if a formatter is set, use it. Otherwise, use " "the default formatter for the module." msgstr "" -#: library/logging.rst:587 +#: library/logging.rst:627 msgid "" "Do whatever it takes to actually log the specified logging record. This " "version is intended to be implemented by subclasses and so raises a :exc:" "`NotImplementedError`." msgstr "" -#: library/logging.rst:591 +#: library/logging.rst:631 msgid "" "This method is called after a handler-level lock is acquired, which is " "released after this method returns. When you override this method, note that " @@ -743,13 +769,13 @@ msgid "" "Specifically:" msgstr "" -#: library/logging.rst:597 +#: library/logging.rst:637 msgid "" "Logging configuration APIs acquire the module-level lock, and then " "individual handler-level locks as those handlers are configured." msgstr "" -#: library/logging.rst:600 +#: library/logging.rst:640 msgid "" "Many logging APIs lock the module-level lock. If such an API is called from " "this method, it could cause a deadlock if a configuration call is made on " @@ -759,16 +785,16 @@ msgid "" "method, the handler-level lock has already been acquired)." msgstr "" -#: library/logging.rst:607 +#: library/logging.rst:647 msgid "" "For a list of handlers included as standard, see :mod:`logging.handlers`." msgstr "" -#: library/logging.rst:612 +#: library/logging.rst:652 msgid "Formatter Objects" msgstr "" -#: library/logging.rst:618 +#: library/logging.rst:658 msgid "" "Responsible for converting a :class:`LogRecord` to an output string to be " "interpreted by a human or external system." @@ -778,7 +804,7 @@ msgstr "" msgid "Parameters" msgstr "" -#: library/logging.rst:621 +#: library/logging.rst:661 msgid "" "A format string in the given *style* for the logged output as a whole. The " "possible mapping keys are drawn from the :class:`LogRecord` object's :ref:" @@ -786,14 +812,14 @@ msgid "" "is just the logged message." msgstr "" -#: library/logging.rst:629 +#: library/logging.rst:669 msgid "" "A format string in the given *style* for the date/time portion of the logged " "output. If not specified, the default described in :meth:`formatTime` is " "used." msgstr "" -#: library/logging.rst:634 +#: library/logging.rst:674 msgid "" "Can be one of ``'%'``, ``'{'`` or ``'$'`` and determines how the format " "string will be merged with its data: using one of :ref:`old-string-" @@ -804,32 +830,32 @@ msgid "" "use ``{``- and ``$``-formatting for log messages." msgstr "" -#: library/logging.rst:644 +#: library/logging.rst:684 msgid "" "If ``True`` (the default), incorrect or mismatched *fmt* and *style* will " "raise a :exc:`ValueError`; for example, ``logging.Formatter('%(asctime)s - " "%(message)s', style='{')``." msgstr "" -#: library/logging.rst:649 +#: library/logging.rst:689 msgid "" "A dictionary with default values to use in custom fields. For example, " "``logging.Formatter('%(ip)s %(message)s', defaults={\"ip\": None})``" msgstr "" -#: library/logging.rst:654 +#: library/logging.rst:694 msgid "Added the *style* parameter." msgstr "" -#: library/logging.rst:657 +#: library/logging.rst:697 msgid "Added the *validate* parameter." msgstr "" -#: library/logging.rst:660 +#: library/logging.rst:700 msgid "Added the *defaults* parameter." msgstr "" -#: library/logging.rst:666 +#: library/logging.rst:706 msgid "" "The record's attribute dictionary is used as the operand to a string " "formatting operation. Returns the resulting string. Before formatting the " @@ -848,13 +874,13 @@ msgid "" "recalculates it afresh." msgstr "" -#: library/logging.rst:682 +#: library/logging.rst:722 msgid "" "If stack information is available, it's appended after the exception " "information, using :meth:`formatStack` to transform it if necessary." msgstr "" -#: library/logging.rst:688 +#: library/logging.rst:728 msgid "" "This method should be called from :meth:`format` by a formatter which wants " "to make use of a formatted time. This method can be overridden in formatters " @@ -867,7 +893,7 @@ msgid "" "resulting string is returned." msgstr "" -#: library/logging.rst:698 +#: library/logging.rst:738 msgid "" "This function uses a user-configurable function to convert the creation time " "to a tuple. By default, :func:`time.localtime` is used; to change this for a " @@ -877,7 +903,7 @@ msgid "" "be shown in GMT, set the ``converter`` attribute in the ``Formatter`` class." msgstr "" -#: library/logging.rst:706 +#: library/logging.rst:746 msgid "" "Previously, the default format was hard-coded as in this example: " "``2010-09-06 22:38:15,292`` where the part before the comma is handled by a " @@ -892,11 +918,11 @@ msgid "" "the millisecond value)." msgstr "" -#: library/logging.rst:719 +#: library/logging.rst:759 msgid "The ``default_msec_format`` can be ``None``." msgstr "" -#: library/logging.rst:724 +#: library/logging.rst:764 msgid "" "Formats the specified exception information (a standard exception tuple as " "returned by :func:`sys.exc_info`) as a string. This default implementation " @@ -904,14 +930,14 @@ msgid "" "returned." msgstr "" -#: library/logging.rst:731 +#: library/logging.rst:771 msgid "" "Formats the specified stack information (a string as returned by :func:" "`traceback.print_stack`, but with the last newline removed) as a string. " "This default implementation just returns the input value." msgstr "" -#: library/logging.rst:737 +#: library/logging.rst:777 msgid "" "A base formatter class suitable for subclassing when you want to format a " "number of records. You can pass a :class:`Formatter` instance which you want " @@ -920,7 +946,7 @@ msgid "" "used as the line formatter." msgstr "" -#: library/logging.rst:745 +#: library/logging.rst:785 msgid "" "Return a header for a list of *records*. The base implementation just " "returns the empty string. You will need to override this method if you want " @@ -928,14 +954,14 @@ msgid "" "separator line." msgstr "" -#: library/logging.rst:752 +#: library/logging.rst:792 msgid "" "Return a footer for a list of *records*. The base implementation just " "returns the empty string. You will need to override this method if you want " "specific behaviour, e.g. to show the count of records or a separator line." msgstr "" -#: library/logging.rst:759 +#: library/logging.rst:799 msgid "" "Return formatted text for a list of *records*. The base implementation just " "returns the empty string if there are no records; otherwise, it returns the " @@ -943,11 +969,11 @@ msgid "" "and the footer." msgstr "" -#: library/logging.rst:767 +#: library/logging.rst:807 msgid "Filter Objects" msgstr "" -#: library/logging.rst:769 +#: library/logging.rst:809 msgid "" "``Filters`` can be used by ``Handlers`` and ``Loggers`` for more " "sophisticated filtering than is provided by levels. The base filter class " @@ -957,7 +983,7 @@ msgid "" "If initialized with the empty string, all events are passed." msgstr "" -#: library/logging.rst:779 +#: library/logging.rst:819 msgid "" "Returns an instance of the :class:`Filter` class. If *name* is specified, it " "names a logger which, together with its children, will have its events " @@ -965,7 +991,7 @@ msgid "" "event." msgstr "" -#: library/logging.rst:786 +#: library/logging.rst:826 msgid "" "Is the specified record to be logged? Returns false for no, true for yes. " "Filters can either modify log records in-place or return a completely " @@ -973,7 +999,7 @@ msgid "" "future processing of the event." msgstr "" -#: library/logging.rst:791 +#: library/logging.rst:831 msgid "" "Note that filters attached to handlers are consulted before an event is " "emitted by the handler, whereas filters attached to loggers are consulted " @@ -983,13 +1009,13 @@ msgid "" "setting, unless the filter has also been applied to those descendant loggers." msgstr "" -#: library/logging.rst:798 +#: library/logging.rst:838 msgid "" "You don't actually need to subclass ``Filter``: you can pass any instance " "which has a ``filter`` method with the same semantics." msgstr "" -#: library/logging.rst:801 +#: library/logging.rst:841 msgid "" "You don't need to create specialized ``Filter`` classes, or use other " "classes with a ``filter`` method: you can use a function (or other callable) " @@ -1000,7 +1026,7 @@ msgid "" "value should conform to that returned by :meth:`~Filter.filter`." msgstr "" -#: library/logging.rst:811 +#: library/logging.rst:851 msgid "" "You can now return a :class:`LogRecord` instance from filters to replace the " "log record rather than modifying it in place. This allows filters attached " @@ -1008,7 +1034,7 @@ msgid "" "having side effects on other handlers." msgstr "" -#: library/logging.rst:817 +#: library/logging.rst:857 msgid "" "Although filters are used primarily to filter records based on more " "sophisticated criteria than levels, they get to see every record which is " @@ -1020,11 +1046,11 @@ msgid "" "contextual information into logs (see :ref:`filters-contextual`)." msgstr "" -#: library/logging.rst:830 +#: library/logging.rst:870 msgid "LogRecord Objects" msgstr "" -#: library/logging.rst:832 +#: library/logging.rst:872 msgid "" ":class:`LogRecord` instances are created automatically by the :class:" "`Logger` every time something is logged, and can be created manually via :" @@ -1032,17 +1058,17 @@ msgid "" "wire)." msgstr "" -#: library/logging.rst:840 +#: library/logging.rst:880 msgid "Contains all the information pertinent to the event being logged." msgstr "" -#: library/logging.rst:842 +#: library/logging.rst:882 msgid "" "The primary information is passed in *msg* and *args*, which are combined " "using ``msg % args`` to create the :attr:`!message` attribute of the record." msgstr "" -#: library/logging.rst:846 +#: library/logging.rst:886 msgid "" "The name of the logger used to log the event represented by this :class:`!" "LogRecord`. Note that the logger name in the :class:`!LogRecord` will always " @@ -1050,7 +1076,7 @@ msgid "" "different (ancestor) logger." msgstr "" -#: library/logging.rst:854 +#: library/logging.rst:894 msgid "" "The :ref:`numeric level ` of the logging event (such as ``10`` for " "``DEBUG``, ``20`` for ``INFO``, etc). Note that this is converted to *two* " @@ -1058,46 +1084,46 @@ msgid "" "attr:`!levelname` for the corresponding level name." msgstr "" -#: library/logging.rst:861 +#: library/logging.rst:901 msgid "" "The full string path of the source file where the logging call was made." msgstr "" -#: library/logging.rst:865 +#: library/logging.rst:905 msgid "The line number in the source file where the logging call was made." msgstr "" -#: library/logging.rst:869 +#: library/logging.rst:909 msgid "" "The event description message, which can be a %-format string with " "placeholders for variable data, or an arbitrary object (see :ref:`arbitrary-" "object-messages`)." msgstr "" -#: library/logging.rst:874 +#: library/logging.rst:914 msgid "" "Variable data to merge into the *msg* argument to obtain the event " "description." msgstr "" -#: library/logging.rst:878 +#: library/logging.rst:918 msgid "" "An exception tuple with the current exception information, as returned by :" "func:`sys.exc_info`, or ``None`` if no exception information is available." msgstr "" -#: library/logging.rst:883 +#: library/logging.rst:923 msgid "" "The name of the function or method from which the logging call was invoked." msgstr "" -#: library/logging.rst:887 +#: library/logging.rst:927 msgid "" "A text string representing stack information from the base of the stack in " "the current thread, up to the logging call." msgstr "" -#: library/logging.rst:894 +#: library/logging.rst:934 msgid "" "Returns the message for this :class:`LogRecord` instance after merging any " "user-supplied arguments with the message. If the user-supplied message " @@ -1106,7 +1132,7 @@ msgid "" "whose ``__str__`` method can return the actual format string to be used." msgstr "" -#: library/logging.rst:901 +#: library/logging.rst:941 msgid "" "The creation of a :class:`LogRecord` has been made more configurable by " "providing a factory which is used to create the record. The factory can be " @@ -1114,24 +1140,24 @@ msgid "" "this for the factory's signature)." msgstr "" -#: library/logging.rst:907 +#: library/logging.rst:947 msgid "" "This functionality can be used to inject your own values into a :class:" "`LogRecord` at creation time. You can use the following pattern::" msgstr "" -#: library/logging.rst:919 +#: library/logging.rst:959 msgid "" "With this pattern, multiple factories could be chained, and as long as they " "don't overwrite each other's attributes or unintentionally overwrite the " "standard attributes listed above, there should be no surprises." msgstr "" -#: library/logging.rst:928 +#: library/logging.rst:968 msgid "LogRecord attributes" msgstr "" -#: library/logging.rst:930 +#: library/logging.rst:970 msgid "" "The LogRecord has a number of attributes, most of which are derived from the " "parameters to the constructor. (Note that the names do not always correspond " @@ -1142,7 +1168,7 @@ msgid "" "style format string." msgstr "" -#: library/logging.rst:938 +#: library/logging.rst:978 msgid "" "If you are using {}-formatting (:func:`str.format`), you can use ``{attrname}" "`` as the placeholder in the format string. If you are using $-formatting (:" @@ -1150,7 +1176,7 @@ msgid "" "course, replace ``attrname`` with the actual attribute name you want to use." msgstr "" -#: library/logging.rst:944 +#: library/logging.rst:984 msgid "" "In the case of {}-formatting, you can specify formatting flags by placing " "them after the attribute name, separated from it with a colon. For example: " @@ -1159,323 +1185,323 @@ msgid "" "on the options available to you." msgstr "" -#: library/logging.rst:951 +#: library/logging.rst:991 msgid "Attribute name" msgstr "" -#: library/logging.rst:1369 +#: library/logging.rst:1351 msgid "Format" msgstr "" -#: library/logging.rst:1369 +#: library/logging.rst:1351 msgid "Description" msgstr "" -#: library/logging.rst:953 +#: library/logging.rst:993 msgid "args" msgstr "" -#: library/logging.rst:967 library/logging.rst:1013 +#: library/logging.rst:1007 library/logging.rst:1053 msgid "You shouldn't need to format this yourself." msgstr "" -#: library/logging.rst:953 +#: library/logging.rst:993 msgid "" "The tuple of arguments merged into ``msg`` to produce ``message``, or a dict " "whose values are used for the merge (when there is only one argument, and it " "is a dictionary)." msgstr "" -#: library/logging.rst:958 +#: library/logging.rst:998 msgid "asctime" msgstr "" -#: library/logging.rst:958 +#: library/logging.rst:998 msgid "``%(asctime)s``" msgstr "" -#: library/logging.rst:958 +#: library/logging.rst:998 msgid "" "Human-readable time when the :class:`LogRecord` was created. By default " "this is of the form '2003-07-08 16:49:45,896' (the numbers after the comma " "are millisecond portion of the time)." msgstr "" -#: library/logging.rst:964 +#: library/logging.rst:1004 msgid "created" msgstr "" -#: library/logging.rst:964 +#: library/logging.rst:1004 msgid "``%(created)f``" msgstr "" -#: library/logging.rst:964 +#: library/logging.rst:1004 msgid "" "Time when the :class:`LogRecord` was created (as returned by :func:`time." "time`)." msgstr "" -#: library/logging.rst:967 +#: library/logging.rst:1007 msgid "exc_info" msgstr "" -#: library/logging.rst:967 +#: library/logging.rst:1007 msgid "" "Exception tuple (à la ``sys.exc_info``) or, if no exception has occurred, " "``None``." msgstr "" -#: library/logging.rst:970 +#: library/logging.rst:1010 msgid "filename" msgstr "" -#: library/logging.rst:970 +#: library/logging.rst:1010 msgid "``%(filename)s``" msgstr "" -#: library/logging.rst:970 +#: library/logging.rst:1010 msgid "Filename portion of ``pathname``." msgstr "" -#: library/logging.rst:972 +#: library/logging.rst:1012 msgid "funcName" msgstr "" -#: library/logging.rst:972 +#: library/logging.rst:1012 msgid "``%(funcName)s``" msgstr "" -#: library/logging.rst:972 +#: library/logging.rst:1012 msgid "Name of function containing the logging call." msgstr "" -#: library/logging.rst:974 +#: library/logging.rst:1014 msgid "levelname" msgstr "" -#: library/logging.rst:974 +#: library/logging.rst:1014 msgid "``%(levelname)s``" msgstr "" -#: library/logging.rst:974 +#: library/logging.rst:1014 msgid "" "Text logging level for the message (``'DEBUG'``, ``'INFO'``, ``'WARNING'``, " "``'ERROR'``, ``'CRITICAL'``)." msgstr "" -#: library/logging.rst:978 +#: library/logging.rst:1018 msgid "levelno" msgstr "" -#: library/logging.rst:978 +#: library/logging.rst:1018 msgid "``%(levelno)s``" msgstr "" -#: library/logging.rst:978 +#: library/logging.rst:1018 msgid "" "Numeric logging level for the message (:const:`DEBUG`, :const:`INFO`, :const:" "`WARNING`, :const:`ERROR`, :const:`CRITICAL`)." msgstr "" -#: library/logging.rst:983 +#: library/logging.rst:1023 msgid "lineno" msgstr "" -#: library/logging.rst:983 +#: library/logging.rst:1023 msgid "``%(lineno)d``" msgstr "" -#: library/logging.rst:983 +#: library/logging.rst:1023 msgid "Source line number where the logging call was issued (if available)." msgstr "" -#: library/logging.rst:986 +#: library/logging.rst:1026 msgid "message" msgstr "" -#: library/logging.rst:986 +#: library/logging.rst:1026 msgid "``%(message)s``" msgstr "" -#: library/logging.rst:986 +#: library/logging.rst:1026 msgid "" "The logged message, computed as ``msg % args``. This is set when :meth:" "`Formatter.format` is invoked." msgstr "" -#: library/logging.rst:990 +#: library/logging.rst:1030 msgid "module" msgstr "" -#: library/logging.rst:990 +#: library/logging.rst:1030 msgid "``%(module)s``" msgstr "" -#: library/logging.rst:990 +#: library/logging.rst:1030 msgid "Module (name portion of ``filename``)." msgstr "" -#: library/logging.rst:992 +#: library/logging.rst:1032 msgid "msecs" msgstr "" -#: library/logging.rst:992 +#: library/logging.rst:1032 msgid "``%(msecs)d``" msgstr "" -#: library/logging.rst:992 +#: library/logging.rst:1032 msgid "" "Millisecond portion of the time when the :class:`LogRecord` was created." msgstr "" -#: library/logging.rst:995 +#: library/logging.rst:1035 msgid "msg" msgstr "" -#: library/logging.rst:995 +#: library/logging.rst:1035 msgid "" "The format string passed in the original logging call. Merged with ``args`` " "to produce ``message``, or an arbitrary object (see :ref:`arbitrary-object-" "messages`)." msgstr "" -#: library/logging.rst:1000 +#: library/logging.rst:1040 msgid "name" msgstr "" -#: library/logging.rst:1000 +#: library/logging.rst:1040 msgid "``%(name)s``" msgstr "" -#: library/logging.rst:1000 +#: library/logging.rst:1040 msgid "Name of the logger used to log the call." msgstr "" -#: library/logging.rst:1002 +#: library/logging.rst:1042 msgid "pathname" msgstr "" -#: library/logging.rst:1002 +#: library/logging.rst:1042 msgid "``%(pathname)s``" msgstr "" -#: library/logging.rst:1002 +#: library/logging.rst:1042 msgid "" "Full pathname of the source file where the logging call was issued (if " "available)." msgstr "" -#: library/logging.rst:1005 +#: library/logging.rst:1045 msgid "process" msgstr "" -#: library/logging.rst:1005 +#: library/logging.rst:1045 msgid "``%(process)d``" msgstr "" -#: library/logging.rst:1005 +#: library/logging.rst:1045 msgid "Process ID (if available)." msgstr "" -#: library/logging.rst:1007 +#: library/logging.rst:1047 msgid "processName" msgstr "" -#: library/logging.rst:1007 +#: library/logging.rst:1047 msgid "``%(processName)s``" msgstr "" -#: library/logging.rst:1007 +#: library/logging.rst:1047 msgid "Process name (if available)." msgstr "" -#: library/logging.rst:1009 +#: library/logging.rst:1049 msgid "relativeCreated" msgstr "" -#: library/logging.rst:1009 +#: library/logging.rst:1049 msgid "``%(relativeCreated)d``" msgstr "" -#: library/logging.rst:1009 +#: library/logging.rst:1049 msgid "" "Time in milliseconds when the LogRecord was created, relative to the time " "the logging module was loaded." msgstr "" -#: library/logging.rst:1013 +#: library/logging.rst:1053 msgid "stack_info" msgstr "" -#: library/logging.rst:1013 +#: library/logging.rst:1053 msgid "" "Stack frame information (where available) from the bottom of the stack in " "the current thread, up to and including the stack frame of the logging call " "which resulted in the creation of this record." msgstr "" -#: library/logging.rst:1019 +#: library/logging.rst:1059 msgid "thread" msgstr "" -#: library/logging.rst:1019 +#: library/logging.rst:1059 msgid "``%(thread)d``" msgstr "" -#: library/logging.rst:1019 +#: library/logging.rst:1059 msgid "Thread ID (if available)." msgstr "" -#: library/logging.rst:1021 +#: library/logging.rst:1061 msgid "threadName" msgstr "" -#: library/logging.rst:1021 +#: library/logging.rst:1061 msgid "``%(threadName)s``" msgstr "" -#: library/logging.rst:1021 +#: library/logging.rst:1061 msgid "Thread name (if available)." msgstr "" -#: library/logging.rst:1023 +#: library/logging.rst:1063 msgid "taskName" msgstr "" -#: library/logging.rst:1023 +#: library/logging.rst:1063 msgid "``%(taskName)s``" msgstr "" -#: library/logging.rst:1023 +#: library/logging.rst:1063 msgid ":class:`asyncio.Task` name (if available)." msgstr "" -#: library/logging.rst:1026 +#: library/logging.rst:1066 msgid "*processName* was added." msgstr "" -#: library/logging.rst:1029 +#: library/logging.rst:1069 msgid "*taskName* was added." msgstr "" -#: library/logging.rst:1035 +#: library/logging.rst:1075 msgid "LoggerAdapter Objects" msgstr "" -#: library/logging.rst:1037 +#: library/logging.rst:1077 msgid "" ":class:`LoggerAdapter` instances are used to conveniently pass contextual " "information into logging calls. For a usage example, see the section on :ref:" "`adding contextual information to your logging output `." msgstr "" -#: library/logging.rst:1043 +#: library/logging.rst:1083 msgid "" "Returns an instance of :class:`LoggerAdapter` initialized with an " "underlying :class:`Logger` instance and a dict-like object." msgstr "" -#: library/logging.rst:1048 +#: library/logging.rst:1088 msgid "" "Modifies the message and/or keyword arguments passed to a logging call in " "order to insert contextual information. This implementation takes the object " @@ -1484,15 +1510,15 @@ msgid "" "(possibly modified) versions of the arguments passed in." msgstr "" -#: library/logging.rst:1056 +#: library/logging.rst:1096 msgid "Delegates to the underlying :attr:`!manager`` on *logger*." msgstr "" -#: library/logging.rst:1060 +#: library/logging.rst:1100 msgid "Delegates to the underlying :meth:`!_log`` method on *logger*." msgstr "" -#: library/logging.rst:1062 +#: library/logging.rst:1102 msgid "" "In addition to the above, :class:`LoggerAdapter` supports the following " "methods of :class:`Logger`: :meth:`~Logger.debug`, :meth:`~Logger.info`, :" @@ -1504,24 +1530,24 @@ msgid "" "interchangeably." msgstr "" -#: library/logging.rst:1073 +#: library/logging.rst:1113 msgid "" "The :meth:`~Logger.isEnabledFor`, :meth:`~Logger.getEffectiveLevel`, :meth:" "`~Logger.setLevel` and :meth:`~Logger.hasHandlers` methods were added to :" "class:`LoggerAdapter`. These methods delegate to the underlying logger." msgstr "" -#: library/logging.rst:1079 +#: library/logging.rst:1119 msgid "" "Attribute :attr:`!manager` and method :meth:`!_log` were added, which " "delegate to the underlying logger and allow adapters to be nested." msgstr "" -#: library/logging.rst:1084 +#: library/logging.rst:1124 msgid "Thread Safety" msgstr "" -#: library/logging.rst:1086 +#: library/logging.rst:1126 msgid "" "The logging module is intended to be thread-safe without any special work " "needing to be done by its clients. It achieves this though using threading " @@ -1530,7 +1556,7 @@ msgid "" "O." msgstr "" -#: library/logging.rst:1091 +#: library/logging.rst:1131 msgid "" "If you are implementing asynchronous signal handlers using the :mod:`signal` " "module, you may not be able to use logging from within such handlers. This " @@ -1538,17 +1564,17 @@ msgid "" "always re-entrant, and so cannot be invoked from such signal handlers." msgstr "" -#: library/logging.rst:1098 +#: library/logging.rst:1138 msgid "Module-Level Functions" msgstr "" -#: library/logging.rst:1100 +#: library/logging.rst:1140 msgid "" "In addition to the classes described above, there are a number of module-" "level functions." msgstr "" -#: library/logging.rst:1106 +#: library/logging.rst:1146 msgid "" "Return a logger with the specified name or, if name is ``None``, return a " "logger which is the root logger of the hierarchy. If specified, the name is " @@ -1557,14 +1583,14 @@ msgid "" "logging." msgstr "" -#: library/logging.rst:1111 +#: library/logging.rst:1151 msgid "" "All calls to this function with a given name return the same logger " "instance. This means that logger instances never need to be passed between " "different parts of an application." msgstr "" -#: library/logging.rst:1118 +#: library/logging.rst:1158 msgid "" "Return either the standard :class:`Logger` class, or the last class passed " "to :func:`setLoggerClass`. This function may be called from within a new " @@ -1573,125 +1599,92 @@ msgid "" "example::" msgstr "" -#: library/logging.rst:1129 +#: library/logging.rst:1169 msgid "Return a callable which is used to create a :class:`LogRecord`." msgstr "" -#: library/logging.rst:1131 +#: library/logging.rst:1171 msgid "" "This function has been provided, along with :func:`setLogRecordFactory`, to " "allow developers more control over how the :class:`LogRecord` representing a " "logging event is constructed." msgstr "" -#: library/logging.rst:1136 +#: library/logging.rst:1176 msgid "" "See :func:`setLogRecordFactory` for more information about the how the " "factory is called." msgstr "" -#: library/logging.rst:1141 -msgid "" -"Logs a message with level :const:`DEBUG` on the root logger. The *msg* is " -"the message format string, and the *args* are the arguments which are merged " -"into *msg* using the string formatting operator. (Note that this means that " -"you can use keywords in the format string, together with a single dictionary " -"argument.)" -msgstr "" - -#: library/logging.rst:1146 -msgid "" -"There are three keyword arguments in *kwargs* which are inspected: " -"*exc_info* which, if it does not evaluate as false, causes exception " -"information to be added to the logging message. If an exception tuple (in " -"the format returned by :func:`sys.exc_info`) or an exception instance is " -"provided, it is used; otherwise, :func:`sys.exc_info` is called to get the " -"exception information." -msgstr "" - -#: library/logging.rst:1172 -msgid "" -"The third optional keyword argument is *extra* which can be used to pass a " -"dictionary which is used to populate the __dict__ of the LogRecord created " -"for the logging event with user-defined attributes. These custom attributes " -"can then be used as you like. For example, they could be incorporated into " -"logged messages. For example::" -msgstr "" - -#: library/logging.rst:1183 -msgid "would print something like:" -msgstr "" - -#: library/logging.rst:1189 +#: library/logging.rst:1181 msgid "" -"The keys in the dictionary passed in *extra* should not clash with the keys " -"used by the logging system. (See the :class:`Formatter` documentation for " -"more information on which keys are used by the logging system.)" +"This is a convenience function that calls :meth:`Logger.debug`, on the root " +"logger. The handling of the arguments is in every way identical to what is " +"described in that method." msgstr "" -#: library/logging.rst:1193 +#: library/logging.rst:1185 msgid "" -"If you choose to use these attributes in logged messages, you need to " -"exercise some care. In the above example, for instance, the :class:" -"`Formatter` has been set up with a format string which expects 'clientip' " -"and 'user' in the attribute dictionary of the LogRecord. If these are " -"missing, the message will not be logged because a string formatting " -"exception will occur. So in this case, you always need to pass the *extra* " -"dictionary with these keys." +"The only difference is that if the root logger has no handlers, then :func:" +"`basicConfig` is called, prior to calling ``debug`` on the root logger." msgstr "" -#: library/logging.rst:1207 +#: library/logging.rst:1188 msgid "" -"This function (as well as :func:`info`, :func:`warning`, :func:`error` and :" -"func:`critical`) will call :func:`basicConfig` if the root logger doesn't " -"have any handler attached." +"For very short scripts or quick demonstrations of ``logging`` facilities, " +"``debug`` and the other module-level functions may be convenient. However, " +"most programs will want to carefully and explicitly control the logging " +"configuration, and should therefore prefer creating a module-level logger " +"and calling :meth:`Logger.debug` (or other level-specific methods) on it, as " +"described at the beginnning of this documentation." msgstr "" -#: library/logging.rst:1216 +#: library/logging.rst:1198 msgid "" "Logs a message with level :const:`INFO` on the root logger. The arguments " -"are interpreted as for :func:`debug`." +"and behavior are otherwise the same as for :func:`debug`." msgstr "" -#: library/logging.rst:1222 +#: library/logging.rst:1204 msgid "" "Logs a message with level :const:`WARNING` on the root logger. The arguments " -"are interpreted as for :func:`debug`." +"and behavior are otherwise the same as for :func:`debug`." msgstr "" -#: library/logging.rst:1225 +#: library/logging.rst:1207 msgid "" "There is an obsolete function ``warn`` which is functionally identical to " "``warning``. As ``warn`` is deprecated, please do not use it - use " "``warning`` instead." msgstr "" -#: library/logging.rst:1232 +#: library/logging.rst:1214 msgid "" "Logs a message with level :const:`ERROR` on the root logger. The arguments " -"are interpreted as for :func:`debug`." +"and behavior are otherwise the same as for :func:`debug`." msgstr "" -#: library/logging.rst:1238 +#: library/logging.rst:1220 msgid "" "Logs a message with level :const:`CRITICAL` on the root logger. The " -"arguments are interpreted as for :func:`debug`." +"arguments and behavior are otherwise the same as for :func:`debug`." msgstr "" -#: library/logging.rst:1244 +#: library/logging.rst:1226 msgid "" "Logs a message with level :const:`ERROR` on the root logger. The arguments " -"are interpreted as for :func:`debug`. Exception info is added to the logging " -"message. This function should only be called from an exception handler." +"and behavior are otherwise the same as for :func:`debug`. Exception info is " +"added to the logging message. This function should only be called from an " +"exception handler." msgstr "" -#: library/logging.rst:1250 +#: library/logging.rst:1232 msgid "" -"Logs a message with level *level* on the root logger. The other arguments " -"are interpreted as for :func:`debug`." +"Logs a message with level *level* on the root logger. The arguments and " +"behavior are otherwise the same as for :func:`debug`." msgstr "" -#: library/logging.rst:1255 +#: library/logging.rst:1237 msgid "" "Provides an overriding level *level* for all loggers which takes precedence " "over the logger's own level. When the need arises to temporarily throttle " @@ -1705,7 +1698,7 @@ msgid "" "individual loggers." msgstr "" -#: library/logging.rst:1266 +#: library/logging.rst:1248 msgid "" "Note that if you have defined any custom logging level higher than " "``CRITICAL`` (this is not recommended), you won't be able to rely on the " @@ -1713,13 +1706,13 @@ msgid "" "a suitable value." msgstr "" -#: library/logging.rst:1271 +#: library/logging.rst:1253 msgid "" "The *level* parameter was defaulted to level ``CRITICAL``. See :issue:" "`28524` for more information about this change." msgstr "" -#: library/logging.rst:1277 +#: library/logging.rst:1259 msgid "" "Associates level *level* with text *levelName* in an internal dictionary, " "which is used to map numeric levels to a textual representation, for example " @@ -1729,24 +1722,24 @@ msgid "" "and they should increase in increasing order of severity." msgstr "" -#: library/logging.rst:1284 +#: library/logging.rst:1266 msgid "" "If you are thinking of defining your own levels, please see the section on :" "ref:`custom-levels`." msgstr "" -#: library/logging.rst:1289 +#: library/logging.rst:1271 msgid "" "Returns a mapping from level names to their corresponding logging levels. " "For example, the string \"CRITICAL\" maps to :const:`CRITICAL`. The returned " "mapping is copied from an internal mapping on each call to this function." msgstr "" -#: library/logging.rst:1297 +#: library/logging.rst:1279 msgid "Returns the textual or numeric representation of logging level *level*." msgstr "" -#: library/logging.rst:1299 +#: library/logging.rst:1281 msgid "" "If *level* is one of the predefined levels :const:`CRITICAL`, :const:" "`ERROR`, :const:`WARNING`, :const:`INFO` or :const:`DEBUG` then you get the " @@ -1756,20 +1749,20 @@ msgid "" "the corresponding string representation is returned." msgstr "" -#: library/logging.rst:1306 +#: library/logging.rst:1288 msgid "" "The *level* parameter also accepts a string representation of the level such " "as 'INFO'. In such cases, this functions returns the corresponding numeric " "value of the level." msgstr "" -#: library/logging.rst:1310 +#: library/logging.rst:1292 msgid "" "If no matching numeric or string value is passed in, the string 'Level %s' % " "level is returned." msgstr "" -#: library/logging.rst:1313 +#: library/logging.rst:1295 msgid "" "Levels are internally integers (as they need to be compared in the logging " "logic). This function is used to convert between an integer level and the " @@ -1778,7 +1771,7 @@ msgid "" "vice versa." msgstr "" -#: library/logging.rst:1319 +#: library/logging.rst:1301 msgid "" "In Python versions earlier than 3.4, this function could also be passed a " "text level, and would return the corresponding numeric value of the level. " @@ -1786,17 +1779,17 @@ msgid "" "Python 3.4, but reinstated in 3.4.2 due to retain backward compatibility." msgstr "" -#: library/logging.rst:1327 +#: library/logging.rst:1309 msgid "" "Returns a handler with the specified *name*, or ``None`` if there is no " "handler with that name." msgstr "" -#: library/logging.rst:1334 +#: library/logging.rst:1316 msgid "Returns an immutable set of all known handler names." msgstr "" -#: library/logging.rst:1340 +#: library/logging.rst:1322 msgid "" "Creates and returns a new :class:`LogRecord` instance whose attributes are " "defined by *attrdict*. This function is useful for taking a pickled :class:" @@ -1804,7 +1797,7 @@ msgid "" "as a :class:`LogRecord` instance at the receiving end." msgstr "" -#: library/logging.rst:1348 +#: library/logging.rst:1330 msgid "" "Does basic configuration for the logging system by creating a :class:" "`StreamHandler` with a default :class:`Formatter` and adding it to the root " @@ -1813,13 +1806,13 @@ msgid "" "no handlers are defined for the root logger." msgstr "" -#: library/logging.rst:1354 +#: library/logging.rst:1336 msgid "" "This function does nothing if the root logger already has handlers " "configured, unless the keyword argument *force* is set to ``True``." msgstr "" -#: library/logging.rst:1357 +#: library/logging.rst:1339 msgid "" "This function should be called from the main thread before other threads are " "started. In versions of Python prior to 2.7.1 and 3.2, if this function is " @@ -1828,54 +1821,54 @@ msgid "" "unexpected results such as messages being duplicated in the log." msgstr "" -#: library/logging.rst:1364 +#: library/logging.rst:1346 msgid "The following keyword arguments are supported." msgstr "" -#: library/logging.rst:1371 +#: library/logging.rst:1353 msgid "*filename*" msgstr "" -#: library/logging.rst:1371 +#: library/logging.rst:1353 msgid "" "Specifies that a :class:`FileHandler` be created, using the specified " "filename, rather than a :class:`StreamHandler`." msgstr "" -#: library/logging.rst:1375 +#: library/logging.rst:1357 msgid "*filemode*" msgstr "" -#: library/logging.rst:1375 +#: library/logging.rst:1357 msgid "" "If *filename* is specified, open the file in this :ref:`mode `. " "Defaults to ``'a'``." msgstr "" -#: library/logging.rst:1379 +#: library/logging.rst:1361 msgid "*format*" msgstr "" -#: library/logging.rst:1379 +#: library/logging.rst:1361 msgid "" "Use the specified format string for the handler. Defaults to attributes " "``levelname``, ``name`` and ``message`` separated by colons." msgstr "" -#: library/logging.rst:1384 +#: library/logging.rst:1366 msgid "*datefmt*" msgstr "" -#: library/logging.rst:1384 +#: library/logging.rst:1366 msgid "" "Use the specified date/time format, as accepted by :func:`time.strftime`." msgstr "" -#: library/logging.rst:1387 +#: library/logging.rst:1369 msgid "*style*" msgstr "" -#: library/logging.rst:1387 +#: library/logging.rst:1369 msgid "" "If *format* is specified, use this style for the format string. One of " "``'%'``, ``'{'`` or ``'$'`` for :ref:`printf-style `." msgstr "" -#: library/logging.rst:1398 +#: library/logging.rst:1380 msgid "*stream*" msgstr "" -#: library/logging.rst:1398 +#: library/logging.rst:1380 msgid "" "Use the specified stream to initialize the :class:`StreamHandler`. Note that " "this argument is incompatible with *filename* - if both are present, a " "``ValueError`` is raised." msgstr "" -#: library/logging.rst:1404 +#: library/logging.rst:1386 msgid "*handlers*" msgstr "" -#: library/logging.rst:1404 +#: library/logging.rst:1386 msgid "" "If specified, this should be an iterable of already created handlers to add " "to the root logger. Any handlers which don't already have a formatter set " @@ -1915,33 +1908,33 @@ msgid "" "present, a ``ValueError`` is raised." msgstr "" -#: library/logging.rst:1413 +#: library/logging.rst:1395 msgid "*force*" msgstr "" -#: library/logging.rst:1413 +#: library/logging.rst:1395 msgid "" "If this keyword argument is specified as true, any existing handlers " "attached to the root logger are removed and closed, before carrying out the " "configuration as specified by the other arguments." msgstr "" -#: library/logging.rst:1419 +#: library/logging.rst:1401 msgid "*encoding*" msgstr "" -#: library/logging.rst:1419 +#: library/logging.rst:1401 msgid "" "If this keyword argument is specified along with *filename*, its value is " "used when the :class:`FileHandler` is created, and thus used when opening " "the output file." msgstr "" -#: library/logging.rst:1424 +#: library/logging.rst:1406 msgid "*errors*" msgstr "" -#: library/logging.rst:1424 +#: library/logging.rst:1406 msgid "" "If this keyword argument is specified along with *filename*, its value is " "used when the :class:`FileHandler` is created, and thus used when opening " @@ -1950,39 +1943,39 @@ msgid "" "`open`, which means that it will be treated the same as passing 'errors'." msgstr "" -#: library/logging.rst:1435 +#: library/logging.rst:1417 msgid "The *style* argument was added." msgstr "" -#: library/logging.rst:1438 +#: library/logging.rst:1420 msgid "" "The *handlers* argument was added. Additional checks were added to catch " "situations where incompatible arguments are specified (e.g. *handlers* " "together with *stream* or *filename*, or *stream* together with *filename*)." msgstr "" -#: library/logging.rst:1444 +#: library/logging.rst:1426 msgid "The *force* argument was added." msgstr "" -#: library/logging.rst:1447 +#: library/logging.rst:1429 msgid "The *encoding* and *errors* arguments were added." msgstr "" -#: library/logging.rst:1452 +#: library/logging.rst:1434 msgid "" "Informs the logging system to perform an orderly shutdown by flushing and " "closing all handlers. This should be called at application exit and no " "further use of the logging system should be made after this call." msgstr "" -#: library/logging.rst:1456 +#: library/logging.rst:1438 msgid "" "When the logging module is imported, it registers this function as an exit " "handler (see :mod:`atexit`), so normally there's no need to do that manually." msgstr "" -#: library/logging.rst:1463 +#: library/logging.rst:1445 msgid "" "Tells the logging system to use the class *klass* when instantiating a " "logger. The class should define :meth:`!__init__` such that only a name " @@ -1994,32 +1987,32 @@ msgid "" "loggers." msgstr "" -#: library/logging.rst:1474 +#: library/logging.rst:1456 msgid "Set a callable which is used to create a :class:`LogRecord`." msgstr "" -#: library/logging.rst:1476 +#: library/logging.rst:1458 msgid "The factory callable to be used to instantiate a log record." msgstr "" -#: library/logging.rst:1478 +#: library/logging.rst:1460 msgid "" "This function has been provided, along with :func:`getLogRecordFactory`, to " "allow developers more control over how the :class:`LogRecord` representing a " "logging event is constructed." msgstr "" -#: library/logging.rst:1483 +#: library/logging.rst:1465 msgid "The factory has the following signature:" msgstr "" -#: library/logging.rst:1485 +#: library/logging.rst:1467 msgid "" "``factory(name, level, fn, lno, msg, args, exc_info, func=None, sinfo=None, " "**kwargs)``" msgstr "" -#: library/logging.rst:1487 +#: library/logging.rst:1469 msgid "The logger name." msgstr "" @@ -2027,7 +2020,7 @@ msgstr "" msgid "level" msgstr "" -#: library/logging.rst:1488 +#: library/logging.rst:1470 msgid "The logging level (numeric)." msgstr "" @@ -2035,7 +2028,7 @@ msgstr "" msgid "fn" msgstr "" -#: library/logging.rst:1489 +#: library/logging.rst:1471 msgid "The full pathname of the file where the logging call was made." msgstr "" @@ -2043,19 +2036,19 @@ msgstr "" msgid "lno" msgstr "" -#: library/logging.rst:1490 +#: library/logging.rst:1472 msgid "The line number in the file where the logging call was made." msgstr "" -#: library/logging.rst:1491 +#: library/logging.rst:1473 msgid "The logging message." msgstr "" -#: library/logging.rst:1492 +#: library/logging.rst:1474 msgid "The arguments for the logging message." msgstr "" -#: library/logging.rst:1493 +#: library/logging.rst:1475 msgid "An exception tuple, or ``None``." msgstr "" @@ -2063,7 +2056,7 @@ msgstr "" msgid "func" msgstr "" -#: library/logging.rst:1494 +#: library/logging.rst:1476 msgid "The name of the function or method which invoked the logging call." msgstr "" @@ -2071,7 +2064,7 @@ msgstr "" msgid "sinfo" msgstr "" -#: library/logging.rst:1496 +#: library/logging.rst:1478 msgid "" "A stack traceback such as is provided by :func:`traceback.print_stack`, " "showing the call hierarchy." @@ -2081,15 +2074,15 @@ msgstr "" msgid "kwargs" msgstr "" -#: library/logging.rst:1498 +#: library/logging.rst:1480 msgid "Additional keyword arguments." msgstr "" -#: library/logging.rst:1502 +#: library/logging.rst:1484 msgid "Module-Level Attributes" msgstr "" -#: library/logging.rst:1506 +#: library/logging.rst:1488 msgid "" "A \"handler of last resort\" is available through this attribute. This is a :" "class:`StreamHandler` writing to ``sys.stderr`` with a level of ``WARNING``, " @@ -2100,15 +2093,15 @@ msgid "" "reason, ``lastResort`` can be set to ``None``." msgstr "" -#: library/logging.rst:1518 +#: library/logging.rst:1500 msgid "Used to see if exceptions during handling should be propagated." msgstr "" -#: library/logging.rst:1520 +#: library/logging.rst:1502 msgid "Default: ``True``." msgstr "" -#: library/logging.rst:1522 +#: library/logging.rst:1504 msgid "" "If :data:`raiseExceptions` is ``False``, exceptions get silently ignored. " "This is what is mostly wanted for a logging system - most users will not " @@ -2116,22 +2109,22 @@ msgid "" "application errors." msgstr "" -#: library/logging.rst:1529 +#: library/logging.rst:1511 msgid "Integration with the warnings module" msgstr "" -#: library/logging.rst:1531 +#: library/logging.rst:1513 msgid "" "The :func:`captureWarnings` function can be used to integrate :mod:`logging` " "with the :mod:`warnings` module." msgstr "" -#: library/logging.rst:1536 +#: library/logging.rst:1518 msgid "" "This function is used to turn the capture of warnings by logging on and off." msgstr "" -#: library/logging.rst:1539 +#: library/logging.rst:1521 msgid "" "If *capture* is ``True``, warnings issued by the :mod:`warnings` module will " "be redirected to the logging system. Specifically, a warning will be " @@ -2140,46 +2133,46 @@ msgid "" "`WARNING`." msgstr "" -#: library/logging.rst:1544 +#: library/logging.rst:1526 msgid "" "If *capture* is ``False``, the redirection of warnings to the logging system " "will stop, and warnings will be redirected to their original destinations (i." "e. those in effect before ``captureWarnings(True)`` was called)." msgstr "" -#: library/logging.rst:1552 +#: library/logging.rst:1534 msgid "Module :mod:`logging.config`" msgstr "" -#: library/logging.rst:1552 +#: library/logging.rst:1534 msgid "Configuration API for the logging module." msgstr "" -#: library/logging.rst:1555 +#: library/logging.rst:1537 msgid "Module :mod:`logging.handlers`" msgstr "" -#: library/logging.rst:1555 +#: library/logging.rst:1537 msgid "Useful handlers included with the logging module." msgstr "" -#: library/logging.rst:1559 +#: library/logging.rst:1541 msgid ":pep:`282` - A Logging System" msgstr "" -#: library/logging.rst:1558 +#: library/logging.rst:1540 msgid "" "The proposal which described this feature for inclusion in the Python " "standard library." msgstr "" -#: library/logging.rst:1564 +#: library/logging.rst:1546 msgid "" "`Original Python logging package `_" msgstr "" -#: library/logging.rst:1562 +#: library/logging.rst:1544 msgid "" "This is the original source for the :mod:`logging` package. The version of " "the package available from this site is suitable for use with Python 1.5.2, " diff --git a/library/math.po b/library/math.po index 4b700c64f..a87ed4210 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-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: 2023-03-31 00:00+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -896,10 +896,11 @@ msgstr "" "Error_function>`_ döndürür." #: library/math.rst:593 +#, fuzzy msgid "" "The :func:`erf` function can be used to compute traditional statistical " "functions such as the `cumulative standard normal distribution `_::" +"wikipedia.org/wiki/Cumulative_distribution_function>`_::" msgstr "" ":func:`erf` fonksiyonu, `kümülatif standart normal dağılım `_: " diff --git a/library/os.po b/library/os.po index 8f0344b61..2fe53629a 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-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -287,14 +287,14 @@ msgstr "" #: library/os.rst:661 library/os.rst:687 library/os.rst:703 library/os.rst:719 #: library/os.rst:735 library/os.rst:1345 library/os.rst:1608 #: library/os.rst:1637 library/os.rst:2110 library/os.rst:2433 -#: library/os.rst:4040 library/os.rst:4054 library/os.rst:4068 -#: library/os.rst:4082 library/os.rst:4098 library/os.rst:4112 -#: library/os.rst:4129 library/os.rst:4144 library/os.rst:4227 -#: library/os.rst:4274 library/os.rst:4431 library/os.rst:4717 -#: library/os.rst:4812 library/os.rst:4843 library/os.rst:4869 -#: library/os.rst:4894 library/os.rst:4913 library/os.rst:4977 -#: library/os.rst:5000 library/os.rst:5016 library/os.rst:5034 -#: library/os.rst:5043 +#: library/os.rst:4036 library/os.rst:4050 library/os.rst:4064 +#: library/os.rst:4078 library/os.rst:4094 library/os.rst:4108 +#: library/os.rst:4125 library/os.rst:4140 library/os.rst:4223 +#: library/os.rst:4270 library/os.rst:4427 library/os.rst:4713 +#: library/os.rst:4808 library/os.rst:4839 library/os.rst:4865 +#: library/os.rst:4890 library/os.rst:4909 library/os.rst:4973 +#: library/os.rst:4996 library/os.rst:5012 library/os.rst:5030 +#: library/os.rst:5039 msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." msgstr "" @@ -450,8 +450,8 @@ msgid "" msgstr "" #: library/os.rst:1086 library/os.rst:1110 library/os.rst:1649 -#: library/os.rst:2533 library/os.rst:3416 library/os.rst:4568 -#: library/os.rst:4696 +#: library/os.rst:2533 library/os.rst:3412 library/os.rst:4564 +#: library/os.rst:4692 msgid ":ref:`Availability `: Unix, Windows." msgstr "" @@ -473,9 +473,9 @@ msgstr "" #: library/os.rst:376 library/os.rst:787 library/os.rst:1019 #: library/os.rst:1053 library/os.rst:1138 library/os.rst:1396 #: library/os.rst:1424 library/os.rst:1708 library/os.rst:1770 -#: library/os.rst:2124 library/os.rst:2499 library/os.rst:3245 -#: library/os.rst:3635 library/os.rst:5200 library/os.rst:5231 -#: library/os.rst:5240 +#: library/os.rst:2124 library/os.rst:2499 library/os.rst:3241 +#: library/os.rst:3631 library/os.rst:5196 library/os.rst:5227 +#: library/os.rst:5236 msgid ":ref:`Availability `: Unix." msgstr "" @@ -546,8 +546,8 @@ msgid "" "getpwuid(os.getuid())[0]`` to get the login name of the current real user id." msgstr "" -#: library/os.rst:462 library/os.rst:4251 library/os.rst:4673 -#: library/os.rst:4961 +#: library/os.rst:462 library/os.rst:4247 library/os.rst:4669 +#: library/os.rst:4957 msgid "" ":ref:`Availability `: Unix, Windows, not Emscripten, not WASI." msgstr "" @@ -843,7 +843,7 @@ msgid "" "or even ``socket.gethostbyaddr(socket.gethostname())``." msgstr "" -#: library/os.rst:4698 +#: library/os.rst:4694 msgid "" "Return type changed from a tuple to a tuple-like object with named " "attributes." @@ -1078,7 +1078,7 @@ msgid "" msgstr "" #: library/os.rst:1021 library/os.rst:1651 library/os.rst:2095 -#: library/os.rst:3381 +#: library/os.rst:3377 msgid "" "The function is limited on Emscripten and WASI, see :ref:`wasm-availability` " "for more information." @@ -1178,7 +1178,7 @@ msgid "" "``fd``, ``length``." msgstr "" -#: library/os.rst:3420 +#: library/os.rst:3416 msgid "Added support for Windows" msgstr "" @@ -1373,11 +1373,11 @@ msgid "" msgstr "" #: library/os.rst:2331 library/os.rst:2435 library/os.rst:2538 -#: library/os.rst:2676 library/os.rst:3436 +#: library/os.rst:2675 library/os.rst:3432 msgid "Added the *dir_fd* parameter." msgstr "" -#: library/os.rst:1576 library/os.rst:4794 +#: library/os.rst:1576 library/os.rst:4790 msgid "" "If the system call is interrupted and the signal handler does not raise an " "exception, the function now retries the system call instead of raising an :" @@ -1386,9 +1386,9 @@ msgstr "" #: library/os.rst:1963 library/os.rst:2026 library/os.rst:2112 #: library/os.rst:2170 library/os.rst:2242 library/os.rst:2370 -#: library/os.rst:2438 library/os.rst:2501 library/os.rst:2591 -#: library/os.rst:2969 library/os.rst:3423 library/os.rst:3479 -#: library/os.rst:3639 library/os.rst:4003 library/os.rst:4556 +#: library/os.rst:2438 library/os.rst:2501 library/os.rst:2590 +#: library/os.rst:2968 library/os.rst:3419 library/os.rst:3475 +#: library/os.rst:3635 library/os.rst:3999 library/os.rst:4552 msgid "Accepts a :term:`path-like object`." msgstr "" @@ -1926,7 +1926,7 @@ msgstr "" msgid "Get the \"inheritable\" flag of the specified handle (a boolean)." msgstr "" -#: library/os.rst:1855 library/os.rst:4591 library/os.rst:4636 +#: library/os.rst:1855 library/os.rst:4587 library/os.rst:4632 msgid ":ref:`Availability `: Windows." msgstr "" @@ -2241,7 +2241,7 @@ msgstr "" msgid ":const:`stat.S_IXOTH`" msgstr "" -#: library/os.rst:2084 library/os.rst:3469 +#: library/os.rst:2084 library/os.rst:3465 msgid "" "This function can support :ref:`specifying a file descriptor `, :" "ref:`paths relative to directory descriptors ` and :ref:`not " @@ -2358,7 +2358,7 @@ msgstr "" msgid ":ref:`Availability `: Unix, Windows, not Emscripten." msgstr "" -#: library/os.rst:4253 +#: library/os.rst:4249 msgid "Added Windows support." msgstr "" @@ -2366,7 +2366,7 @@ msgstr "" msgid "Added the *src_dir_fd*, *dst_dir_fd*, and *follow_symlinks* parameters." msgstr "" -#: library/os.rst:2623 library/os.rst:3391 +#: library/os.rst:2622 library/os.rst:3387 msgid "Accepts a :term:`path-like object` for *src* and *dst*." msgstr "" @@ -2387,7 +2387,7 @@ msgid "" "circumstances, they will be of type ``str``." msgstr "" -#: library/os.rst:2708 +#: library/os.rst:2707 msgid "" "This function can also support :ref:`specifying a file descriptor " "`; the file descriptor must refer to a directory." @@ -2413,7 +2413,7 @@ msgstr "" msgid "The *path* parameter became optional." msgstr "" -#: library/os.rst:3250 +#: library/os.rst:3246 msgid "Added support for specifying *path* as an open file descriptor." msgstr "" @@ -2522,7 +2522,7 @@ msgid "" "`." msgstr "" -#: library/os.rst:2535 library/os.rst:3384 +#: library/os.rst:2535 library/os.rst:3380 msgid "Added support for Windows 6.0 (Vista) symbolic links." msgstr "" @@ -2669,7 +2669,7 @@ msgid "" "included in that mapping, passing an integer for *name* is also accepted." msgstr "" -#: library/os.rst:3243 library/os.rst:3412 +#: library/os.rst:3239 library/os.rst:3408 msgid "" "This function can support :ref:`specifying a file descriptor `." msgstr "" @@ -2718,20 +2718,20 @@ msgid "" "the optional \"print name\" field that was previously returned." msgstr "" -#: library/os.rst:2554 +#: library/os.rst:2553 msgid "" "Remove (delete) the file *path*. If *path* is a directory, an :exc:" "`OSError` is raised. Use :func:`rmdir` to remove directories. If the file " "does not exist, a :exc:`FileNotFoundError` is raised." msgstr "" -#: library/os.rst:2671 library/os.rst:3363 +#: library/os.rst:2670 library/os.rst:3359 msgid "" "This function can support :ref:`paths relative to directory descriptors " "`." msgstr "" -#: library/os.rst:2561 +#: library/os.rst:2560 msgid "" "On Windows, attempting to remove a file that is in use causes an exception " "to be raised; on Unix, the directory entry is removed but the storage " @@ -2739,17 +2739,17 @@ msgid "" "longer in use." msgstr "" -#: library/os.rst:2565 +#: library/os.rst:2564 msgid "This function is semantically identical to :func:`unlink`." msgstr "" -#: library/os.rst:2589 library/os.rst:3434 +#: library/os.rst:2588 library/os.rst:3430 msgid "" "Raises an :ref:`auditing event ` ``os.remove`` with arguments " "``path``, ``dir_fd``." msgstr "" -#: library/os.rst:2580 +#: library/os.rst:2579 msgid "" "Remove directories recursively. Works like :func:`rmdir` except that, if " "the leaf directory is successfully removed, :func:`removedirs` tries to " @@ -2761,20 +2761,20 @@ msgid "" "could not be successfully removed." msgstr "" -#: library/os.rst:2597 +#: library/os.rst:2596 msgid "" "Rename the file or directory *src* to *dst*. If *dst* exists, the operation " "will fail with an :exc:`OSError` subclass in a number of cases:" msgstr "" -#: library/os.rst:2600 +#: library/os.rst:2599 msgid "" "On Windows, if *dst* exists a :exc:`FileExistsError` is always raised. The " "operation may fail if *src* and *dst* are on different filesystems. Use :" "func:`shutil.move` to support moves to a different filesystem." msgstr "" -#: library/os.rst:2604 +#: library/os.rst:2603 msgid "" "On Unix, if *src* is a file and *dst* is a directory or vice-versa, an :exc:" "`IsADirectoryError` or a :exc:`NotADirectoryError` will be raised " @@ -2786,29 +2786,29 @@ msgid "" "operation (this is a POSIX requirement)." msgstr "" -#: library/os.rst:2653 +#: library/os.rst:2652 msgid "" "This function can support specifying *src_dir_fd* and/or *dst_dir_fd* to " "supply :ref:`paths relative to directory descriptors `." msgstr "" -#: library/os.rst:2616 +#: library/os.rst:2615 msgid "" "If you want cross-platform overwriting of the destination, use :func:" "`replace`." msgstr "" -#: library/os.rst:2639 library/os.rst:2656 +#: library/os.rst:2638 library/os.rst:2655 msgid "" "Raises an :ref:`auditing event ` ``os.rename`` with arguments " "``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." msgstr "" -#: library/os.rst:2620 +#: library/os.rst:2619 msgid "Added the *src_dir_fd* and *dst_dir_fd* parameters." msgstr "" -#: library/os.rst:2629 +#: library/os.rst:2628 msgid "" "Recursive directory or file renaming function. Works like :func:`rename`, " "except creation of any intermediate directories needed to make the new " @@ -2817,17 +2817,17 @@ msgid "" "using :func:`removedirs`." msgstr "" -#: library/os.rst:2636 +#: library/os.rst:2635 msgid "" "This function can fail with the new directory structure made if you lack " "permissions needed to remove the leaf directory or file." msgstr "" -#: library/os.rst:2641 +#: library/os.rst:2640 msgid "Accepts a :term:`path-like object` for *old* and *new*." msgstr "" -#: library/os.rst:2647 +#: library/os.rst:2646 msgid "" "Rename the file or directory *src* to *dst*. If *dst* is a non-empty " "directory, :exc:`OSError` will be raised. If *dst* exists and is a file, it " @@ -2836,7 +2836,7 @@ msgid "" "renaming will be an atomic operation (this is a POSIX requirement)." msgstr "" -#: library/os.rst:2666 +#: library/os.rst:2665 msgid "" "Remove (delete) the directory *path*. If the directory does not exist or is " "not empty, a :exc:`FileNotFoundError` or an :exc:`OSError` is raised " @@ -2844,13 +2844,13 @@ msgid "" "rmtree` can be used." msgstr "" -#: library/os.rst:2674 +#: library/os.rst:2673 msgid "" "Raises an :ref:`auditing event ` ``os.rmdir`` with arguments " "``path``, ``dir_fd``." msgstr "" -#: library/os.rst:2685 +#: library/os.rst:2684 msgid "" "Return an iterator of :class:`os.DirEntry` objects corresponding to the " "entries in the directory given by *path*. The entries are yielded in " @@ -2860,7 +2860,7 @@ msgid "" "unspecified." msgstr "" -#: library/os.rst:2692 +#: library/os.rst:2691 msgid "" "Using :func:`scandir` instead of :func:`listdir` can significantly increase " "the performance of code that also needs file type or file attribute " @@ -2872,7 +2872,7 @@ msgid "" "Unix but only requires one for symbolic links on Windows." msgstr "" -#: library/os.rst:2702 +#: library/os.rst:2701 msgid "" "*path* may be a :term:`path-like object`. If *path* is of type ``bytes`` " "(directly or indirectly through the :class:`PathLike` interface), the type " @@ -2881,30 +2881,30 @@ msgid "" "they will be of type ``str``." msgstr "" -#: library/os.rst:2711 +#: library/os.rst:2710 msgid "" "Raises an :ref:`auditing event ` ``os.scandir`` with argument " "``path``." msgstr "" -#: library/os.rst:2713 +#: library/os.rst:2712 msgid "" "The :func:`scandir` iterator supports the :term:`context manager` protocol " "and has the following method:" msgstr "" -#: library/os.rst:2718 +#: library/os.rst:2717 msgid "Close the iterator and free acquired resources." msgstr "" -#: library/os.rst:2720 +#: library/os.rst:2719 msgid "" "This is called automatically when the iterator is exhausted or garbage " "collected, or when an error happens during iterating. However it is " "advisable to call it explicitly or use the :keyword:`with` statement." msgstr "" -#: library/os.rst:2727 +#: library/os.rst:2726 msgid "" "The following example shows a simple use of :func:`scandir` to display all " "the files (excluding directories) in the given *path* that don't start with " @@ -2912,7 +2912,7 @@ msgid "" "system call::" msgstr "" -#: library/os.rst:2739 +#: library/os.rst:2738 msgid "" "On Unix-based systems, :func:`scandir` uses the system's `opendir() `_ and " @@ -2923,7 +2923,7 @@ msgid "" "desktop/aa364428(v=vs.85).aspx>`_ functions." msgstr "" -#: library/os.rst:2751 +#: library/os.rst:2750 msgid "" "Added support for the :term:`context manager` protocol and the :func:" "`~scandir.close()` method. If a :func:`scandir` iterator is neither " @@ -2931,28 +2931,28 @@ msgid "" "its destructor." msgstr "" -#: library/os.rst:2757 +#: library/os.rst:2756 msgid "The function accepts a :term:`path-like object`." msgstr "" -#: library/os.rst:2759 +#: library/os.rst:2758 msgid "Added support for :ref:`file descriptors ` on Unix." msgstr "" -#: library/os.rst:2765 +#: library/os.rst:2764 msgid "" "Object yielded by :func:`scandir` to expose the file path and other file " "attributes of a directory entry." msgstr "" -#: library/os.rst:2768 +#: library/os.rst:2767 msgid "" ":func:`scandir` will provide as much of this information as possible without " "making additional system calls. When a ``stat()`` or ``lstat()`` system call " "is made, the ``os.DirEntry`` object will cache the result." msgstr "" -#: library/os.rst:2772 +#: library/os.rst:2771 msgid "" "``os.DirEntry`` instances are not intended to be stored in long-lived data " "structures; if you know the file metadata has changed or if a long time has " @@ -2960,7 +2960,7 @@ msgid "" "up-to-date information." msgstr "" -#: library/os.rst:2777 +#: library/os.rst:2776 msgid "" "Because the ``os.DirEntry`` methods can make operating system calls, they " "may also raise :exc:`OSError`. If you need very fine-grained control over " @@ -2968,29 +2968,29 @@ msgid "" "methods and handle as appropriate." msgstr "" -#: library/os.rst:2782 +#: library/os.rst:2781 msgid "" "To be directly usable as a :term:`path-like object`, ``os.DirEntry`` " "implements the :class:`PathLike` interface." msgstr "" -#: library/os.rst:2785 +#: library/os.rst:2784 msgid "Attributes and methods on a ``os.DirEntry`` instance are as follows:" msgstr "" -#: library/os.rst:2789 +#: library/os.rst:2788 msgid "" "The entry's base filename, relative to the :func:`scandir` *path* argument." msgstr "" -#: library/os.rst:2792 +#: library/os.rst:2791 msgid "" "The :attr:`name` attribute will be ``bytes`` if the :func:`scandir` *path* " "argument is of type ``bytes`` and ``str`` otherwise. Use :func:`~os." "fsdecode` to decode byte filenames." msgstr "" -#: library/os.rst:2798 +#: library/os.rst:2797 msgid "" "The entry's full path name: equivalent to ``os.path.join(scandir_path, entry." "name)`` where *scandir_path* is the :func:`scandir` *path* argument. The " @@ -3000,51 +3000,51 @@ msgid "" "attribute." msgstr "" -#: library/os.rst:2805 +#: library/os.rst:2804 msgid "" "The :attr:`path` attribute will be ``bytes`` if the :func:`scandir` *path* " "argument is of type ``bytes`` and ``str`` otherwise. Use :func:`~os." "fsdecode` to decode byte filenames." msgstr "" -#: library/os.rst:2811 +#: library/os.rst:2810 msgid "Return the inode number of the entry." msgstr "" -#: library/os.rst:2813 +#: library/os.rst:2812 msgid "" "The result is cached on the ``os.DirEntry`` object. Use ``os.stat(entry." "path, follow_symlinks=False).st_ino`` to fetch up-to-date information." msgstr "" -#: library/os.rst:2817 +#: library/os.rst:2816 msgid "" "On the first, uncached call, a system call is required on Windows but not on " "Unix." msgstr "" -#: library/os.rst:2822 +#: library/os.rst:2821 msgid "" "Return ``True`` if this entry is a directory or a symbolic link pointing to " "a directory; return ``False`` if the entry is or points to any other kind of " "file, or if it doesn't exist anymore." msgstr "" -#: library/os.rst:2826 +#: library/os.rst:2825 msgid "" "If *follow_symlinks* is ``False``, return ``True`` only if this entry is a " "directory (without following symlinks); return ``False`` if the entry is any " "other kind of file or if it doesn't exist anymore." msgstr "" -#: library/os.rst:2830 +#: library/os.rst:2829 msgid "" "The result is cached on the ``os.DirEntry`` object, with a separate cache " "for *follow_symlinks* ``True`` and ``False``. Call :func:`os.stat` along " "with :func:`stat.S_ISDIR` to fetch up-to-date information." msgstr "" -#: library/os.rst:2834 +#: library/os.rst:2833 msgid "" "On the first, uncached call, no system call is required in most cases. " "Specifically, for non-symlinks, neither Windows or Unix require a system " @@ -3054,46 +3054,46 @@ msgid "" "is ``False``." msgstr "" -#: library/os.rst:2871 +#: library/os.rst:2870 msgid "" "This method can raise :exc:`OSError`, such as :exc:`PermissionError`, but :" "exc:`FileNotFoundError` is caught and not raised." msgstr "" -#: library/os.rst:2846 +#: library/os.rst:2845 msgid "" "Return ``True`` if this entry is a file or a symbolic link pointing to a " "file; return ``False`` if the entry is or points to a directory or other non-" "file entry, or if it doesn't exist anymore." msgstr "" -#: library/os.rst:2850 +#: library/os.rst:2849 msgid "" "If *follow_symlinks* is ``False``, return ``True`` only if this entry is a " "file (without following symlinks); return ``False`` if the entry is a " "directory or other non-file entry, or if it doesn't exist anymore." msgstr "" -#: library/os.rst:2854 +#: library/os.rst:2853 msgid "" "The result is cached on the ``os.DirEntry`` object. Caching, system calls " "made, and exceptions raised are as per :func:`~os.DirEntry.is_dir`." msgstr "" -#: library/os.rst:2859 +#: library/os.rst:2858 msgid "" "Return ``True`` if this entry is a symbolic link (even if broken); return " "``False`` if the entry points to a directory or any kind of file, or if it " "doesn't exist anymore." msgstr "" -#: library/os.rst:2863 +#: library/os.rst:2862 msgid "" "The result is cached on the ``os.DirEntry`` object. Call :func:`os.path." "islink` to fetch up-to-date information." msgstr "" -#: library/os.rst:2866 +#: library/os.rst:2865 msgid "" "On the first, uncached call, no system call is required in most cases. " "Specifically, neither Windows or Unix require a system call, except on " @@ -3101,48 +3101,48 @@ msgid "" "``dirent.d_type == DT_UNKNOWN``." msgstr "" -#: library/os.rst:2876 +#: library/os.rst:2875 msgid "" "Return ``True`` if this entry is a junction (even if broken); return " "``False`` if the entry points to a regular directory, any kind of file, a " "symlink, or if it doesn't exist anymore." msgstr "" -#: library/os.rst:2880 +#: library/os.rst:2879 msgid "" "The result is cached on the ``os.DirEntry`` object. Call :func:`os.path." "isjunction` to fetch up-to-date information." msgstr "" -#: library/os.rst:2887 +#: library/os.rst:2886 msgid "" "Return a :class:`stat_result` object for this entry. This method follows " "symbolic links by default; to stat a symbolic link add the " "``follow_symlinks=False`` argument." msgstr "" -#: library/os.rst:2891 +#: library/os.rst:2890 msgid "" "On Unix, this method always requires a system call. On Windows, it only " "requires a system call if *follow_symlinks* is ``True`` and the entry is a " "reparse point (for example, a symbolic link or directory junction)." msgstr "" -#: library/os.rst:2896 +#: library/os.rst:2895 msgid "" "On Windows, the ``st_ino``, ``st_dev`` and ``st_nlink`` attributes of the :" "class:`stat_result` are always set to zero. Call :func:`os.stat` to get " "these attributes." msgstr "" -#: library/os.rst:2900 +#: library/os.rst:2899 msgid "" "The result is cached on the ``os.DirEntry`` object, with a separate cache " "for *follow_symlinks* ``True`` and ``False``. Call :func:`os.stat` to fetch " "up-to-date information." msgstr "" -#: library/os.rst:2904 +#: library/os.rst:2903 msgid "" "Note that there is a nice correspondence between several attributes and " "methods of ``os.DirEntry`` and of :class:`pathlib.Path`. In particular, the " @@ -3150,13 +3150,13 @@ msgid "" "``is_file()``, ``is_symlink()``, ``is_junction()``, and ``stat()`` methods." msgstr "" -#: library/os.rst:2912 +#: library/os.rst:2911 msgid "" "Added support for the :class:`~os.PathLike` interface. Added support for :" "class:`bytes` paths on Windows." msgstr "" -#: library/os.rst:2916 +#: library/os.rst:2915 msgid "" "The ``st_ctime`` attribute of a stat result is deprecated on Windows. The " "file creation time is properly available as ``st_birthtime``, and in the " @@ -3164,7 +3164,7 @@ msgid "" "time, if available." msgstr "" -#: library/os.rst:2925 +#: library/os.rst:2924 msgid "" "Get the status of a file or a file descriptor. Perform the equivalent of a :" "c:func:`stat` system call on the given path. *path* may be specified as " @@ -3173,19 +3173,19 @@ msgid "" "`stat_result` object." msgstr "" -#: library/os.rst:2931 +#: library/os.rst:2930 msgid "" "This function normally follows symlinks; to stat a symlink add the argument " "``follow_symlinks=False``, or use :func:`lstat`." msgstr "" -#: library/os.rst:3802 library/os.rst:3834 library/os.rst:3854 +#: library/os.rst:3798 library/os.rst:3830 library/os.rst:3850 msgid "" "This function can support :ref:`specifying a file descriptor ` and :" "ref:`not following symlinks `." msgstr "" -#: library/os.rst:2937 +#: library/os.rst:2936 msgid "" "On Windows, passing ``follow_symlinks=False`` will disable following all " "name-surrogate reparse points, which includes symlinks and directory " @@ -3199,21 +3199,21 @@ msgid "" "junction points, which will raise the usual exceptions." msgstr "" -#: library/os.rst:3722 +#: library/os.rst:3718 msgid "Example::" msgstr "" -#: library/os.rst:2963 +#: library/os.rst:2962 msgid ":func:`fstat` and :func:`lstat` functions." msgstr "" -#: library/os.rst:2965 +#: library/os.rst:2964 msgid "" "Added the *dir_fd* and *follow_symlinks* parameters, specifying a file " "descriptor instead of a path." msgstr "" -#: library/os.rst:2972 +#: library/os.rst:2971 msgid "" "On Windows, all reparse points that can be resolved by the operating system " "are now followed, and passing ``follow_symlinks=False`` disables following " @@ -3223,122 +3223,122 @@ msgid "" "of raising an error." msgstr "" -#: library/os.rst:2983 +#: library/os.rst:2982 msgid "" "Object whose attributes correspond roughly to the members of the :c:struct:" "`stat` structure. It is used for the result of :func:`os.stat`, :func:`os." "fstat` and :func:`os.lstat`." msgstr "" -#: library/os.rst:2987 +#: library/os.rst:2986 msgid "Attributes:" msgstr "" -#: library/os.rst:2991 +#: library/os.rst:2990 msgid "File mode: file type and file mode bits (permissions)." msgstr "" -#: library/os.rst:2995 +#: library/os.rst:2994 msgid "" "Platform dependent, but if non-zero, uniquely identifies the file for a " "given value of ``st_dev``. Typically:" msgstr "" -#: library/os.rst:2998 +#: library/os.rst:2997 msgid "the inode number on Unix," msgstr "" -#: library/os.rst:2999 +#: library/os.rst:2998 msgid "" "the `file index `_ on " "Windows" msgstr "" -#: library/os.rst:3005 +#: library/os.rst:3004 msgid "Identifier of the device on which this file resides." msgstr "" -#: library/os.rst:3009 +#: library/os.rst:3008 msgid "Number of hard links." msgstr "" -#: library/os.rst:3013 +#: library/os.rst:3012 msgid "User identifier of the file owner." msgstr "" -#: library/os.rst:3017 +#: library/os.rst:3016 msgid "Group identifier of the file owner." msgstr "" -#: library/os.rst:3021 +#: library/os.rst:3020 msgid "" "Size of the file in bytes, if it is a regular file or a symbolic link. The " "size of a symbolic link is the length of the pathname it contains, without a " "terminating null byte." msgstr "" -#: library/os.rst:3025 +#: library/os.rst:3024 msgid "Timestamps:" msgstr "" -#: library/os.rst:3029 +#: library/os.rst:3028 msgid "Time of most recent access expressed in seconds." msgstr "" -#: library/os.rst:3033 +#: library/os.rst:3032 msgid "Time of most recent content modification expressed in seconds." msgstr "" -#: library/os.rst:3037 +#: library/os.rst:3036 msgid "Time of most recent metadata change expressed in seconds." msgstr "" -#: library/os.rst:3039 +#: library/os.rst:3038 msgid "" "``st_ctime`` is deprecated on Windows. Use ``st_birthtime`` for the file " "creation time. In the future, ``st_ctime`` will contain the time of the most " "recent metadata change, as for other platforms." msgstr "" -#: library/os.rst:3046 +#: library/os.rst:3045 msgid "Time of most recent access expressed in nanoseconds as an integer." msgstr "" -#: library/os.rst:3052 +#: library/os.rst:3051 msgid "" "Time of most recent content modification expressed in nanoseconds as an " "integer." msgstr "" -#: library/os.rst:3059 +#: library/os.rst:3058 msgid "" "Time of most recent metadata change expressed in nanoseconds as an integer." msgstr "" -#: library/os.rst:3064 +#: library/os.rst:3063 msgid "" "``st_ctime_ns`` is deprecated on Windows. Use ``st_birthtime_ns`` for the " "file creation time. In the future, ``st_ctime`` will contain the time of the " "most recent metadata change, as for other platforms." msgstr "" -#: library/os.rst:3071 +#: library/os.rst:3070 msgid "" "Time of file creation expressed in seconds. This attribute is not always " "available, and may raise :exc:`AttributeError`." msgstr "" -#: library/os.rst:3074 +#: library/os.rst:3073 msgid "``st_birthtime`` is now available on Windows." msgstr "" -#: library/os.rst:3079 +#: library/os.rst:3078 msgid "" "Time of file creation expressed in nanoseconds as an integer. This attribute " "is not always available, and may raise :exc:`AttributeError`." msgstr "" -#: library/os.rst:3087 +#: library/os.rst:3086 msgid "" "The exact meaning and resolution of the :attr:`st_atime`, :attr:`st_mtime`, :" "attr:`st_ctime` and :attr:`st_birthtime` attributes depend on the operating " @@ -3348,7 +3348,7 @@ msgid "" "details." msgstr "" -#: library/os.rst:3094 +#: library/os.rst:3093 msgid "" "Similarly, although :attr:`st_atime_ns`, :attr:`st_mtime_ns`, :attr:" "`st_ctime_ns` and :attr:`st_birthtime_ns` are always expressed in " @@ -3361,74 +3361,74 @@ msgid "" "`st_birthtime_ns`." msgstr "" -#: library/os.rst:3104 +#: library/os.rst:3103 msgid "" "On some Unix systems (such as Linux), the following attributes may also be " "available:" msgstr "" -#: library/os.rst:3109 +#: library/os.rst:3108 msgid "" "Number of 512-byte blocks allocated for file. This may be smaller than :attr:" "`st_size`/512 when the file has holes." msgstr "" -#: library/os.rst:3114 +#: library/os.rst:3113 msgid "" "\"Preferred\" blocksize for efficient file system I/O. Writing to a file in " "smaller chunks may cause an inefficient read-modify-rewrite." msgstr "" -#: library/os.rst:3119 +#: library/os.rst:3118 msgid "Type of device if an inode device." msgstr "" -#: library/os.rst:3123 +#: library/os.rst:3122 msgid "User defined flags for file." msgstr "" -#: library/os.rst:3125 +#: library/os.rst:3124 msgid "" "On other Unix systems (such as FreeBSD), the following attributes may be " "available (but may be only filled out if root tries to use them):" msgstr "" -#: library/os.rst:3130 +#: library/os.rst:3129 msgid "File generation number." msgstr "" -#: library/os.rst:3132 +#: library/os.rst:3131 msgid "" "On Solaris and derivatives, the following attributes may also be available:" msgstr "" -#: library/os.rst:3137 +#: library/os.rst:3136 msgid "" "String that uniquely identifies the type of the filesystem that contains the " "file." msgstr "" -#: library/os.rst:3140 +#: library/os.rst:3139 msgid "On macOS systems, the following attributes may also be available:" msgstr "" -#: library/os.rst:3144 +#: library/os.rst:3143 msgid "Real size of the file." msgstr "" -#: library/os.rst:3148 +#: library/os.rst:3147 msgid "Creator of the file." msgstr "" -#: library/os.rst:3152 +#: library/os.rst:3151 msgid "File type." msgstr "" -#: library/os.rst:3154 +#: library/os.rst:3153 msgid "On Windows systems, the following attributes are also available:" msgstr "" -#: library/os.rst:3158 +#: library/os.rst:3157 msgid "" "Windows file attributes: ``dwFileAttributes`` member of the " "``BY_HANDLE_FILE_INFORMATION`` structure returned by :c:func:`!" @@ -3436,7 +3436,7 @@ msgid "" "FILE_ATTRIBUTE_ARCHIVE>` constants in the :mod:`stat` module." msgstr "" -#: library/os.rst:3168 +#: library/os.rst:3167 msgid "" "When :attr:`st_file_attributes` has the :const:`~stat." "FILE_ATTRIBUTE_REPARSE_POINT` set, this field contains the tag identifying " @@ -3444,14 +3444,14 @@ msgid "" "IO_REPARSE_TAG_SYMLINK>` constants in the :mod:`stat` module." msgstr "" -#: library/os.rst:3173 +#: library/os.rst:3172 msgid "" "The standard module :mod:`stat` defines functions and constants that are " "useful for extracting information from a :c:struct:`stat` structure. (On " "Windows, some items are filled with dummy values.)" msgstr "" -#: library/os.rst:3177 +#: library/os.rst:3176 msgid "" "For backward compatibility, a :class:`stat_result` instance is also " "accessible as a tuple of at least 10 integers giving the most important (and " @@ -3463,49 +3463,49 @@ msgid "" "class:`stat_result` as a tuple always returns integers." msgstr "" -#: library/os.rst:3186 +#: library/os.rst:3185 msgid "Windows now returns the file index as :attr:`st_ino` when available." msgstr "" -#: library/os.rst:3190 +#: library/os.rst:3189 msgid "Added the :attr:`st_fstype` member to Solaris/derivatives." msgstr "" -#: library/os.rst:3193 +#: library/os.rst:3192 msgid "Added the :attr:`st_reparse_tag` member on Windows." msgstr "" -#: library/os.rst:3196 +#: library/os.rst:3195 msgid "" "On Windows, the :attr:`st_mode` member now identifies special files as :" "const:`S_IFCHR`, :const:`S_IFIFO` or :const:`S_IFBLK` as appropriate." msgstr "" -#: library/os.rst:3201 +#: library/os.rst:3200 msgid "" "On Windows, :attr:`st_ctime` is deprecated. Eventually, it will contain the " "last metadata change time, for consistency with other platforms, but for now " "still contains creation time. Use :attr:`st_birthtime` for the creation time." msgstr "" -#: library/os.rst:3207 +#: library/os.rst:3206 msgid "" "On Windows, :attr:`st_ino` may now be up to 128 bits, depending on the file " "system. Previously it would not be above 64 bits, and larger file " "identifiers would be arbitrarily packed." msgstr "" -#: library/os.rst:3212 +#: library/os.rst:3210 msgid "" "On Windows, :attr:`st_rdev` no longer returns a value. Previously it would " "contain the same as :attr:`st_dev`, which was incorrect." msgstr "" -#: library/os.rst:3216 +#: library/os.rst:3213 msgid "Added the :attr:`st_birthtime` member on Windows." msgstr "" -#: library/os.rst:3222 +#: library/os.rst:3218 msgid "" "Perform a :c:func:`!statvfs` system call on the given path. The return " "value is an object whose attributes describe the filesystem on the given " @@ -3515,7 +3515,7 @@ msgid "" "`f_favail`, :attr:`f_flag`, :attr:`f_namemax`, :attr:`f_fsid`." msgstr "" -#: library/os.rst:3229 +#: library/os.rst:3225 msgid "" "Two module-level constants are defined for the :attr:`f_flag` attribute's " "bit-flags: if :const:`ST_RDONLY` is set, the filesystem is mounted read-" @@ -3523,7 +3523,7 @@ msgid "" "are disabled or not supported." msgstr "" -#: library/os.rst:3234 +#: library/os.rst:3230 msgid "" "Additional module-level constants are defined for GNU/glibc based systems. " "These are :const:`ST_NODEV` (disallow access to device special files), :" @@ -3536,11 +3536,11 @@ msgid "" "relative to mtime/ctime)." msgstr "" -#: library/os.rst:3247 +#: library/os.rst:3243 msgid "The :const:`ST_RDONLY` and :const:`ST_NOSUID` constants were added." msgstr "" -#: library/os.rst:3253 +#: library/os.rst:3249 msgid "" "The :const:`ST_NODEV`, :const:`ST_NOEXEC`, :const:`ST_SYNCHRONOUS`, :const:" "`ST_MANDLOCK`, :const:`ST_WRITE`, :const:`ST_APPEND`, :const:" @@ -3548,11 +3548,11 @@ msgid "" "`ST_RELATIME` constants were added." msgstr "" -#: library/os.rst:3262 +#: library/os.rst:3258 msgid "Added the :attr:`f_fsid` attribute." msgstr "" -#: library/os.rst:3268 +#: library/os.rst:3264 msgid "" "A :class:`set` object indicating which functions in the :mod:`os` module " "accept an open file descriptor for their *dir_fd* parameter. Different " @@ -3564,7 +3564,7 @@ msgid "" "(Specifying ``None`` for *dir_fd* is always supported on all platforms.)" msgstr "" -#: library/os.rst:3278 +#: library/os.rst:3274 msgid "" "To check whether a particular function accepts an open file descriptor for " "its *dir_fd* parameter, use the ``in`` operator on ``supports_dir_fd``. As " @@ -3572,13 +3572,13 @@ msgid "" "open file descriptors for *dir_fd* on the local platform::" msgstr "" -#: library/os.rst:3285 +#: library/os.rst:3281 msgid "" "Currently *dir_fd* parameters only work on Unix platforms; none of them work " "on Windows." msgstr "" -#: library/os.rst:3293 +#: library/os.rst:3289 msgid "" "A :class:`set` object indicating whether :func:`os.access` permits " "specifying ``True`` for its *effective_ids* parameter on the local platform. " @@ -3587,19 +3587,19 @@ msgid "" "func:`os.access`; otherwise it will be empty." msgstr "" -#: library/os.rst:3299 +#: library/os.rst:3295 msgid "" "This expression evaluates to ``True`` if :func:`os.access` supports " "``effective_ids=True`` on the local platform::" msgstr "" -#: library/os.rst:3304 +#: library/os.rst:3300 msgid "" "Currently *effective_ids* is only supported on Unix platforms; it does not " "work on Windows." msgstr "" -#: library/os.rst:3312 +#: library/os.rst:3308 msgid "" "A :class:`set` object indicating which functions in the :mod:`os` module " "permit specifying their *path* parameter as an open file descriptor on the " @@ -3608,7 +3608,7 @@ msgid "" "*path* arguments is not available on all platforms Python supports." msgstr "" -#: library/os.rst:3319 +#: library/os.rst:3315 msgid "" "To determine whether a particular function permits specifying an open file " "descriptor for its *path* parameter, use the ``in`` operator on " @@ -3617,7 +3617,7 @@ msgid "" "platform::" msgstr "" -#: library/os.rst:3332 +#: library/os.rst:3328 msgid "" "A :class:`set` object indicating which functions in the :mod:`os` module " "accept ``False`` for their *follow_symlinks* parameter on the local " @@ -3630,7 +3630,7 @@ msgid "" "on all platforms.)" msgstr "" -#: library/os.rst:3342 +#: library/os.rst:3338 msgid "" "To check whether a particular function accepts ``False`` for its " "*follow_symlinks* parameter, use the ``in`` operator on " @@ -3639,11 +3639,11 @@ msgid "" "stat` on the local platform::" msgstr "" -#: library/os.rst:3355 +#: library/os.rst:3351 msgid "Create a symbolic link pointing to *src* named *dst*." msgstr "" -#: library/os.rst:3357 +#: library/os.rst:3353 msgid "" "On Windows, a symlink represents either a file or a directory, and does not " "morph to the target dynamically. If the target is present, the type of the " @@ -3653,7 +3653,7 @@ msgid "" "ignored." msgstr "" -#: library/os.rst:3368 +#: library/os.rst:3364 msgid "" "On newer versions of Windows 10, unprivileged accounts can create symlinks " "if Developer Mode is enabled. When Developer Mode is not available/enabled, " @@ -3661,83 +3661,83 @@ msgid "" "must be run as an administrator." msgstr "" -#: library/os.rst:3374 +#: library/os.rst:3370 msgid "" ":exc:`OSError` is raised when the function is called by an unprivileged user." msgstr "" -#: library/os.rst:3377 +#: library/os.rst:3373 msgid "" "Raises an :ref:`auditing event ` ``os.symlink`` with arguments " "``src``, ``dst``, ``dir_fd``." msgstr "" -#: library/os.rst:3387 +#: library/os.rst:3383 msgid "" "Added the *dir_fd* parameter, and now allow *target_is_directory* on non-" "Windows platforms." msgstr "" -#: library/os.rst:3394 +#: library/os.rst:3390 msgid "Added support for unelevated symlinks on Windows with Developer Mode." msgstr "" -#: library/os.rst:3400 +#: library/os.rst:3396 msgid "Force write of everything to disk." msgstr "" -#: library/os.rst:3409 +#: library/os.rst:3405 msgid "" "Truncate the file corresponding to *path*, so that it is at most *length* " "bytes in size." msgstr "" -#: library/os.rst:3414 +#: library/os.rst:3410 msgid "" "Raises an :ref:`auditing event ` ``os.truncate`` with arguments " "``path``, ``length``." msgstr "" -#: library/os.rst:3429 +#: library/os.rst:3425 msgid "" "Remove (delete) the file *path*. This function is semantically identical " "to :func:`remove`; the ``unlink`` name is its traditional Unix name. Please " "see the documentation for :func:`remove` for further information." msgstr "" -#: library/os.rst:3445 +#: library/os.rst:3441 msgid "Set the access and modified times of the file specified by *path*." msgstr "" -#: library/os.rst:3447 +#: library/os.rst:3443 msgid "" ":func:`utime` takes two optional parameters, *times* and *ns*. These specify " "the times set on *path* and are used as follows:" msgstr "" -#: library/os.rst:3450 +#: library/os.rst:3446 msgid "" "If *ns* is specified, it must be a 2-tuple of the form ``(atime_ns, " "mtime_ns)`` where each member is an int expressing nanoseconds." msgstr "" -#: library/os.rst:3453 +#: library/os.rst:3449 msgid "" "If *times* is not ``None``, it must be a 2-tuple of the form ``(atime, " "mtime)`` where each member is an int or float expressing seconds." msgstr "" -#: library/os.rst:3456 +#: library/os.rst:3452 msgid "" "If *times* is ``None`` and *ns* is unspecified, this is equivalent to " "specifying ``ns=(atime_ns, mtime_ns)`` where both times are the current time." msgstr "" -#: library/os.rst:3460 +#: library/os.rst:3456 msgid "It is an error to specify tuples for both *times* and *ns*." msgstr "" -#: library/os.rst:3462 +#: library/os.rst:3458 msgid "" "Note that the exact times you set here may not be returned by a subsequent :" "func:`~os.stat` call, depending on the resolution with which your operating " @@ -3747,19 +3747,19 @@ msgid "" "func:`utime`." msgstr "" -#: library/os.rst:3473 +#: library/os.rst:3469 msgid "" "Raises an :ref:`auditing event ` ``os.utime`` with arguments " "``path``, ``times``, ``ns``, ``dir_fd``." msgstr "" -#: library/os.rst:3475 +#: library/os.rst:3471 msgid "" "Added support for specifying *path* as an open file descriptor, and the " "*dir_fd*, *follow_symlinks*, and *ns* parameters." msgstr "" -#: library/os.rst:3489 +#: library/os.rst:3485 msgid "" "Generate the file names in a directory tree by walking the tree either top-" "down or bottom-up. For each directory in the tree rooted at directory *top* " @@ -3767,7 +3767,7 @@ msgid "" "filenames)``." msgstr "" -#: library/os.rst:3494 +#: library/os.rst:3490 msgid "" "*dirpath* is a string, the path to the directory. *dirnames* is a list of " "the names of the subdirectories in *dirpath* (including symlinks to " @@ -3781,7 +3781,7 @@ msgid "" "unspecified." msgstr "" -#: library/os.rst:3505 +#: library/os.rst:3501 msgid "" "If optional argument *topdown* is ``True`` or not specified, the triple for " "a directory is generated before the triples for any of its subdirectories " @@ -3792,7 +3792,7 @@ msgid "" "its subdirectories are generated." msgstr "" -#: library/os.rst:3513 +#: library/os.rst:3509 msgid "" "When *topdown* is ``True``, the caller can modify the *dirnames* list in-" "place (perhaps using :keyword:`del` or slice assignment), and :func:`walk` " @@ -3805,7 +3805,7 @@ msgid "" "itself is generated." msgstr "" -#: library/os.rst:3522 +#: library/os.rst:3518 msgid "" "By default, errors from the :func:`scandir` call are ignored. If optional " "argument *onerror* is specified, it should be a function; it will be called " @@ -3815,66 +3815,66 @@ msgid "" "object." msgstr "" -#: library/os.rst:3528 +#: library/os.rst:3524 msgid "" "By default, :func:`walk` will not walk down into symbolic links that resolve " "to directories. Set *followlinks* to ``True`` to visit directories pointed " "to by symlinks, on systems that support them." msgstr "" -#: library/os.rst:3534 +#: library/os.rst:3530 msgid "" "Be aware that setting *followlinks* to ``True`` can lead to infinite " "recursion if a link points to a parent directory of itself. :func:`walk` " "does not keep track of the directories it visited already." msgstr "" -#: library/os.rst:3540 +#: library/os.rst:3536 msgid "" "If you pass a relative pathname, don't change the current working directory " "between resumptions of :func:`walk`. :func:`walk` never changes the current " "directory, and assumes that its caller doesn't either." msgstr "" -#: library/os.rst:3605 +#: library/os.rst:3601 msgid "" "This example displays the number of bytes taken by non-directory files in " "each directory under the starting directory, except that it doesn't look " "under any CVS subdirectory::" msgstr "" -#: library/os.rst:3557 +#: library/os.rst:3553 msgid "" "In the next example (simple implementation of :func:`shutil.rmtree`), " "walking the tree bottom-up is essential, :func:`rmdir` doesn't allow " "deleting a directory before the directory is empty::" msgstr "" -#: library/os.rst:3572 +#: library/os.rst:3568 msgid "" "Raises an :ref:`auditing event ` ``os.walk`` with arguments " "``top``, ``topdown``, ``onerror``, ``followlinks``." msgstr "" -#: library/os.rst:3574 +#: library/os.rst:3570 msgid "" "This function now calls :func:`os.scandir` instead of :func:`os.listdir`, " "making it faster by reducing the number of calls to :func:`os.stat`." msgstr "" -#: library/os.rst:3588 +#: library/os.rst:3584 msgid "" "This behaves exactly like :func:`walk`, except that it yields a 4-tuple " "``(dirpath, dirnames, filenames, dirfd)``, and it supports ``dir_fd``." msgstr "" -#: library/os.rst:3591 +#: library/os.rst:3587 msgid "" "*dirpath*, *dirnames* and *filenames* are identical to :func:`walk` output, " "and *dirfd* is a file descriptor referring to the directory *dirpath*." msgstr "" -#: library/os.rst:3594 +#: library/os.rst:3590 msgid "" "This function always supports :ref:`paths relative to directory descriptors " "` and :ref:`not following symlinks `. Note however " @@ -3882,30 +3882,30 @@ msgid "" "*follow_symlinks* is ``False``." msgstr "" -#: library/os.rst:3601 +#: library/os.rst:3597 msgid "" "Since :func:`fwalk` yields file descriptors, those are only valid until the " "next iteration step, so you should duplicate them (e.g. with :func:`dup`) if " "you want to keep them longer." msgstr "" -#: library/os.rst:3618 +#: library/os.rst:3614 msgid "" "In the next example, walking the tree bottom-up is essential: :func:`rmdir` " "doesn't allow deleting a directory before the directory is empty::" msgstr "" -#: library/os.rst:3633 +#: library/os.rst:3629 msgid "" "Raises an :ref:`auditing event ` ``os.fwalk`` with arguments " "``top``, ``topdown``, ``onerror``, ``follow_symlinks``, ``dir_fd``." msgstr "" -#: library/os.rst:3642 +#: library/os.rst:3638 msgid "Added support for :class:`bytes` paths." msgstr "" -#: library/os.rst:3648 +#: library/os.rst:3644 msgid "" "Create an anonymous file and return a file descriptor that refers to it. " "*flags* must be one of the ``os.MFD_*`` constants available on the system " @@ -3913,7 +3913,7 @@ msgid "" "descriptor is :ref:`non-inheritable `." msgstr "" -#: library/os.rst:3653 +#: library/os.rst:3649 msgid "" "The name supplied in *name* is used as a filename and will be displayed as " "the target of the corresponding symbolic link in the directory ``/proc/self/" @@ -3923,23 +3923,23 @@ msgid "" "side effects." msgstr "" -#: library/os.rst:3660 +#: library/os.rst:3656 msgid ":ref:`Availability `: Linux >= 3.17 with glibc >= 2.27." msgstr "" -#: library/os.rst:3683 +#: library/os.rst:3679 msgid "These flags can be passed to :func:`memfd_create`." msgstr "" -#: library/os.rst:3685 +#: library/os.rst:3681 msgid ":ref:`Availability `: Linux >= 3.17 with glibc >= 2.27" msgstr "" -#: library/os.rst:3687 +#: library/os.rst:3683 msgid "The ``MFD_HUGE*`` flags are only available since Linux 4.14." msgstr "" -#: library/os.rst:3694 +#: library/os.rst:3690 msgid "" "Create and return an event file descriptor. The file descriptors supports " "raw :func:`read` and :func:`write` with a buffer size of 8, :func:`~select." @@ -3948,7 +3948,7 @@ msgid "" "ref:`non-inheritable `." msgstr "" -#: library/os.rst:3700 +#: library/os.rst:3696 msgid "" "*initval* is the initial value of the event counter. The initial value must " "be an 32 bit unsigned integer. Please note that the initial value is limited " @@ -3956,86 +3956,86 @@ msgid "" "integer with a maximum value of 2\\ :sup:`64`\\ -\\ 2." msgstr "" -#: library/os.rst:3705 +#: library/os.rst:3701 msgid "" "*flags* can be constructed from :const:`EFD_CLOEXEC`, :const:`EFD_NONBLOCK`, " "and :const:`EFD_SEMAPHORE`." msgstr "" -#: library/os.rst:3708 +#: library/os.rst:3704 msgid "" "If :const:`EFD_SEMAPHORE` is specified and the event counter is non-zero, :" "func:`eventfd_read` returns 1 and decrements the counter by one." msgstr "" -#: library/os.rst:3711 +#: library/os.rst:3707 msgid "" "If :const:`EFD_SEMAPHORE` is not specified and the event counter is non-" "zero, :func:`eventfd_read` returns the current event counter value and " "resets the counter to zero." msgstr "" -#: library/os.rst:3715 +#: library/os.rst:3711 msgid "" "If the event counter is zero and :const:`EFD_NONBLOCK` is not specified, :" "func:`eventfd_read` blocks." msgstr "" -#: library/os.rst:3718 +#: library/os.rst:3714 msgid "" ":func:`eventfd_write` increments the event counter. Write blocks if the " "write operation would increment the counter to a value larger than 2\\ :sup:" "`64`\\ -\\ 2." msgstr "" -#: library/os.rst:3739 +#: library/os.rst:3735 msgid ":ref:`Availability `: Linux >= 2.6.27 with glibc >= 2.8" msgstr "" -#: library/os.rst:3745 +#: library/os.rst:3741 msgid "" "Read value from an :func:`eventfd` file descriptor and return a 64 bit " "unsigned int. The function does not verify that *fd* is an :func:`eventfd`." msgstr "" -#: library/os.rst:3757 library/os.rst:3774 +#: library/os.rst:3753 library/os.rst:3770 msgid ":ref:`Availability `: Linux >= 2.6.27" msgstr "" -#: library/os.rst:3754 +#: library/os.rst:3750 msgid "" "Add value to an :func:`eventfd` file descriptor. *value* must be a 64 bit " "unsigned int. The function does not verify that *fd* is an :func:`eventfd`." msgstr "" -#: library/os.rst:3763 +#: library/os.rst:3759 msgid "Set close-on-exec flag for new :func:`eventfd` file descriptor." msgstr "" -#: library/os.rst:3771 +#: library/os.rst:3767 msgid "" "Set :const:`O_NONBLOCK` status flag for new :func:`eventfd` file descriptor." msgstr "" -#: library/os.rst:3780 +#: library/os.rst:3776 msgid "" "Provide semaphore-like semantics for reads from a :func:`eventfd` file " "descriptor. On read the internal counter is decremented by one." msgstr "" -#: library/os.rst:3783 +#: library/os.rst:3779 msgid ":ref:`Availability `: Linux >= 2.6.30" msgstr "" -#: library/os.rst:3789 +#: library/os.rst:3785 msgid "Linux extended attributes" msgstr "" -#: library/os.rst:3793 +#: library/os.rst:3789 msgid "These functions are all available on Linux only." msgstr "" -#: library/os.rst:3797 +#: library/os.rst:3793 msgid "" "Return the value of the extended filesystem attribute *attribute* for " "*path*. *attribute* can be bytes or str (directly or indirectly through the :" @@ -4043,17 +4043,17 @@ msgid "" "encoding." msgstr "" -#: library/os.rst:3805 +#: library/os.rst:3801 msgid "" "Raises an :ref:`auditing event ` ``os.getxattr`` with arguments " "``path``, ``attribute``." msgstr "" -#: library/os.rst:3839 library/os.rst:3864 +#: library/os.rst:3835 library/os.rst:3860 msgid "Accepts a :term:`path-like object` for *path* and *attribute*." msgstr "" -#: library/os.rst:3813 +#: library/os.rst:3809 msgid "" "Return a list of the extended filesystem attributes on *path*. The " "attributes in the list are represented as strings decoded with the " @@ -4061,13 +4061,13 @@ msgid "" "the current directory." msgstr "" -#: library/os.rst:3821 +#: library/os.rst:3817 msgid "" "Raises an :ref:`auditing event ` ``os.listxattr`` with argument " "``path``." msgstr "" -#: library/os.rst:3829 +#: library/os.rst:3825 msgid "" "Removes the extended filesystem attribute *attribute* from *path*. " "*attribute* should be bytes or str (directly or indirectly through the :" @@ -4075,13 +4075,13 @@ msgid "" "`filesystem encoding and error handler`." msgstr "" -#: library/os.rst:3837 +#: library/os.rst:3833 msgid "" "Raises an :ref:`auditing event ` ``os.removexattr`` with arguments " "``path``, ``attribute``." msgstr "" -#: library/os.rst:3845 +#: library/os.rst:3841 msgid "" "Set the extended filesystem attribute *attribute* on *path* to *value*. " "*attribute* must be a bytes or str with no embedded NULs (directly or " @@ -4093,45 +4093,45 @@ msgid "" "will not be created and ``EEXISTS`` will be raised." msgstr "" -#: library/os.rst:3859 +#: library/os.rst:3855 msgid "" "A bug in Linux kernel versions less than 2.6.39 caused the flags argument to " "be ignored on some filesystems." msgstr "" -#: library/os.rst:3862 +#: library/os.rst:3858 msgid "" "Raises an :ref:`auditing event ` ``os.setxattr`` with arguments " "``path``, ``attribute``, ``value``, ``flags``." msgstr "" -#: library/os.rst:3870 +#: library/os.rst:3866 msgid "" "The maximum size the value of an extended attribute can be. Currently, this " "is 64 KiB on Linux." msgstr "" -#: library/os.rst:3876 +#: library/os.rst:3872 msgid "" "This is a possible value for the flags argument in :func:`setxattr`. It " "indicates the operation must create an attribute." msgstr "" -#: library/os.rst:3882 +#: library/os.rst:3878 msgid "" "This is a possible value for the flags argument in :func:`setxattr`. It " "indicates the operation must replace an existing attribute." msgstr "" -#: library/os.rst:3889 +#: library/os.rst:3885 msgid "Process Management" msgstr "" -#: library/os.rst:3891 +#: library/os.rst:3887 msgid "These functions may be used to create and manage processes." msgstr "" -#: library/os.rst:3893 +#: library/os.rst:3889 msgid "" "The various :func:`exec\\* ` functions take a list of arguments for " "the new program loaded into the process. In each case, the first of these " @@ -4142,7 +4142,7 @@ msgid "" "standard output; ``foo`` will seem to be ignored." msgstr "" -#: library/os.rst:3904 +#: library/os.rst:3900 msgid "" "Generate a :const:`SIGABRT` signal to the current process. On Unix, the " "default behavior is to produce a core dump; on Windows, the process " @@ -4151,37 +4151,37 @@ msgid "" "`SIGABRT` with :func:`signal.signal`." msgstr "" -#: library/os.rst:3913 +#: library/os.rst:3909 msgid "Add a path to the DLL search path." msgstr "" -#: library/os.rst:3915 +#: library/os.rst:3911 msgid "" "This search path is used when resolving dependencies for imported extension " "modules (the module itself is resolved through :data:`sys.path`), and also " "by :mod:`ctypes`." msgstr "" -#: library/os.rst:3919 +#: library/os.rst:3915 msgid "" "Remove the directory by calling **close()** on the returned object or using " "it in a :keyword:`with` statement." msgstr "" -#: library/os.rst:3922 +#: library/os.rst:3918 msgid "" "See the `Microsoft documentation `_ for more information about how " "DLLs are loaded." msgstr "" -#: library/os.rst:3926 +#: library/os.rst:3922 msgid "" "Raises an :ref:`auditing event ` ``os.add_dll_directory`` with " "argument ``path``." msgstr "" -#: library/os.rst:3930 +#: library/os.rst:3926 msgid "" "Previous versions of CPython would resolve DLLs using the default behavior " "for the current process. This led to inconsistencies, such as only sometimes " @@ -4189,14 +4189,14 @@ msgid "" "such as ``AddDllDirectory`` having no effect." msgstr "" -#: library/os.rst:3937 +#: library/os.rst:3933 msgid "" "In 3.8, the two primary ways DLLs are loaded now explicitly override the " "process-wide behavior to ensure consistency. See the :ref:`porting notes " "` for information on updating libraries." msgstr "" -#: library/os.rst:3952 +#: library/os.rst:3948 msgid "" "These functions all execute a new program, replacing the current process; " "they do not return. On Unix, the new executable is loaded into the current " @@ -4204,7 +4204,7 @@ msgid "" "reported as :exc:`OSError` exceptions." msgstr "" -#: library/os.rst:3957 +#: library/os.rst:3953 msgid "" "The current process is replaced immediately. Open file objects and " "descriptors are not flushed, so if there may be data buffered on these open " @@ -4212,7 +4212,7 @@ msgid "" "fsync` before calling an :func:`exec\\* ` function." msgstr "" -#: library/os.rst:3963 +#: library/os.rst:3959 msgid "" "The \"l\" and \"v\" variants of the :func:`exec\\* ` functions differ " "in how command-line arguments are passed. The \"l\" variants are perhaps " @@ -4225,7 +4225,7 @@ msgid "" "is not enforced." msgstr "" -#: library/os.rst:3972 +#: library/os.rst:3968 msgid "" "The variants which include a \"p\" near the end (:func:`execlp`, :func:" "`execlpe`, :func:`execvp`, and :func:`execvpe`) will use the :envvar:`PATH` " @@ -4239,7 +4239,7 @@ msgid "" "even on Windows, as plain names will not be resolved." msgstr "" -#: library/os.rst:3983 +#: library/os.rst:3979 msgid "" "For :func:`execle`, :func:`execlpe`, :func:`execve`, and :func:`execvpe` " "(note that these all end in \"e\"), the *env* parameter must be a mapping " @@ -4249,7 +4249,7 @@ msgid "" "process to inherit the environment of the current process." msgstr "" -#: library/os.rst:3990 +#: library/os.rst:3986 msgid "" "For :func:`execve` on some platforms, *path* may also be specified as an " "open file descriptor. This functionality may not be supported on your " @@ -4258,31 +4258,31 @@ msgid "" "`NotImplementedError`." msgstr "" -#: library/os.rst:3995 +#: library/os.rst:3991 msgid "" "Raises an :ref:`auditing event ` ``os.exec`` with arguments " "``path``, ``args``, ``env``." msgstr "" -#: library/os.rst:3999 +#: library/os.rst:3995 msgid "" "Added support for specifying *path* as an open file descriptor for :func:" "`execve`." msgstr "" -#: library/os.rst:4008 +#: library/os.rst:4004 msgid "" "Exit the process with status *n*, without calling cleanup handlers, flushing " "stdio buffers, etc." msgstr "" -#: library/os.rst:4013 +#: library/os.rst:4009 msgid "" "The standard way to exit is :func:`sys.exit(n) `. :func:`!_exit` " "should normally only be used in the child process after a :func:`fork`." msgstr "" -#: library/os.rst:4016 +#: library/os.rst:4012 msgid "" "The following exit codes are defined and can be used with :func:`_exit`, " "although they are not required. These are typically used for system " @@ -4290,139 +4290,139 @@ msgid "" "delivery program." msgstr "" -#: library/os.rst:4022 +#: library/os.rst:4018 msgid "" "Some of these may not be available on all Unix platforms, since there is " "some variation. These constants are defined where they are defined by the " "underlying platform." msgstr "" -#: library/os.rst:4029 +#: library/os.rst:4025 msgid "" "Exit code that means no error occurred. May be taken from the defined value " "of ``EXIT_SUCCESS`` on some platforms. Generally has a value of zero." msgstr "" -#: library/os.rst:4037 +#: library/os.rst:4033 msgid "" "Exit code that means the command was used incorrectly, such as when the " "wrong number of arguments are given." msgstr "" -#: library/os.rst:4045 +#: library/os.rst:4041 msgid "Exit code that means the input data was incorrect." msgstr "" -#: library/os.rst:4052 +#: library/os.rst:4048 msgid "Exit code that means an input file did not exist or was not readable." msgstr "" -#: library/os.rst:4059 +#: library/os.rst:4055 msgid "Exit code that means a specified user did not exist." msgstr "" -#: library/os.rst:4066 +#: library/os.rst:4062 msgid "Exit code that means a specified host did not exist." msgstr "" -#: library/os.rst:4073 +#: library/os.rst:4069 msgid "Exit code that means that a required service is unavailable." msgstr "" -#: library/os.rst:4080 +#: library/os.rst:4076 msgid "Exit code that means an internal software error was detected." msgstr "" -#: library/os.rst:4087 +#: library/os.rst:4083 msgid "" "Exit code that means an operating system error was detected, such as the " "inability to fork or create a pipe." msgstr "" -#: library/os.rst:4095 +#: library/os.rst:4091 msgid "" "Exit code that means some system file did not exist, could not be opened, or " "had some other kind of error." msgstr "" -#: library/os.rst:4103 +#: library/os.rst:4099 msgid "Exit code that means a user specified output file could not be created." msgstr "" -#: library/os.rst:4110 +#: library/os.rst:4106 msgid "" "Exit code that means that an error occurred while doing I/O on some file." msgstr "" -#: library/os.rst:4117 +#: library/os.rst:4113 msgid "" "Exit code that means a temporary failure occurred. This indicates something " "that may not really be an error, such as a network connection that couldn't " "be made during a retryable operation." msgstr "" -#: library/os.rst:4126 +#: library/os.rst:4122 msgid "" "Exit code that means that a protocol exchange was illegal, invalid, or not " "understood." msgstr "" -#: library/os.rst:4134 +#: library/os.rst:4130 msgid "" "Exit code that means that there were insufficient permissions to perform the " "operation (but not intended for file system problems)." msgstr "" -#: library/os.rst:4142 +#: library/os.rst:4138 msgid "Exit code that means that some kind of configuration error occurred." msgstr "" -#: library/os.rst:4149 +#: library/os.rst:4145 msgid "Exit code that means something like \"an entry was not found\"." msgstr "" -#: library/os.rst:4156 +#: library/os.rst:4152 msgid "" "Fork a child process. Return ``0`` in the child and the child's process id " "in the parent. If an error occurs :exc:`OSError` is raised." msgstr "" -#: library/os.rst:4159 +#: library/os.rst:4155 msgid "" "Note that some platforms including FreeBSD <= 6.3 and Cygwin have known " "issues when using ``fork()`` from a thread." msgstr "" -#: library/os.rst:4162 +#: library/os.rst:4158 msgid "" "Raises an :ref:`auditing event ` ``os.fork`` with no arguments." msgstr "" -#: library/os.rst:4166 +#: library/os.rst:4162 msgid "" "If you use TLS sockets in an application calling ``fork()``, see the warning " "in the :mod:`ssl` documentation." msgstr "" -#: library/os.rst:4215 +#: library/os.rst:4211 msgid "" "On macOS the use of this function is unsafe when mixed with using higher-" "level system APIs, and that includes using :mod:`urllib.request`." msgstr "" -#: library/os.rst:4174 +#: library/os.rst:4170 msgid "" "Calling ``fork()`` in a subinterpreter is no longer supported (:exc:" "`RuntimeError` is raised)." msgstr "" -#: library/os.rst:4178 +#: library/os.rst:4174 msgid "" "If Python is able to detect that your process has multiple threads, :func:" "`os.fork` now raises a :exc:`DeprecationWarning`." msgstr "" -#: library/os.rst:4182 +#: library/os.rst:4178 msgid "" "We chose to surface this as a warning, when detectable, to better inform " "developers of a design problem that the POSIX platform specifically notes as " @@ -4433,25 +4433,25 @@ msgid "" "``free``)." msgstr "" -#: library/os.rst:4191 +#: library/os.rst:4187 msgid "" "Users of macOS or users of libc or malloc implementations other than those " "typically found in glibc to date are among those already more likely to " "experience deadlocks running such code." msgstr "" -#: library/os.rst:4195 +#: library/os.rst:4191 msgid "" "See `this discussion on fork being incompatible with threads `_ for technical details of why we're surfacing " "this longstanding platform compatibility problem to developers." msgstr "" -#: library/os.rst:4447 +#: library/os.rst:4443 msgid ":ref:`Availability `: POSIX, not Emscripten, not WASI." msgstr "" -#: library/os.rst:4205 +#: library/os.rst:4201 msgid "" "Fork a child process, using a new pseudo-terminal as the child's controlling " "terminal. Return a pair of ``(pid, fd)``, where *pid* is ``0`` in the child, " @@ -4460,11 +4460,17 @@ msgid "" "the :mod:`pty` module. If an error occurs :exc:`OSError` is raised." msgstr "" -#: library/os.rst:4211 +#: library/os.rst:4207 msgid "" "Raises an :ref:`auditing event ` ``os.forkpty`` with no arguments." msgstr "" +#: library/os.rst:4214 +msgid "" +"Calling ``forkpty()`` in a subinterpreter is no longer supported (:exc:" +"`RuntimeError` is raised)." +msgstr "" + #: library/os.rst:4218 msgid "" "If Python is able to detect that your process has multiple threads, this now " @@ -4472,19 +4478,13 @@ msgid "" "fork`." msgstr "" -#: library/os.rst:4223 -msgid "" -"Calling ``forkpty()`` in a subinterpreter is no longer supported (:exc:" -"`RuntimeError` is raised)." -msgstr "" - -#: library/os.rst:4236 +#: library/os.rst:4232 msgid "" "Send signal *sig* to the process *pid*. Constants for the specific signals " "available on the host platform are defined in the :mod:`signal` module." msgstr "" -#: library/os.rst:4239 +#: library/os.rst:4235 msgid "" "Windows: The :const:`signal.CTRL_C_EVENT` and :const:`signal." "CTRL_BREAK_EVENT` signals are special signals which can only be sent to " @@ -4495,47 +4495,47 @@ msgid "" "process handles to be killed." msgstr "" -#: library/os.rst:4247 +#: library/os.rst:4243 msgid "See also :func:`signal.pthread_kill`." msgstr "" -#: library/os.rst:4249 +#: library/os.rst:4245 msgid "" "Raises an :ref:`auditing event ` ``os.kill`` with arguments " "``pid``, ``sig``." msgstr "" -#: library/os.rst:4263 +#: library/os.rst:4259 msgid "Send the signal *sig* to the process group *pgid*." msgstr "" -#: library/os.rst:4265 +#: library/os.rst:4261 msgid "" "Raises an :ref:`auditing event ` ``os.killpg`` with arguments " "``pgid``, ``sig``." msgstr "" -#: library/os.rst:4272 +#: library/os.rst:4268 msgid "" "Add *increment* to the process's \"niceness\". Return the new niceness." msgstr "" -#: library/os.rst:4279 +#: library/os.rst:4275 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:4283 +#: library/os.rst:4279 msgid "See the :manpage:`pidfd_open(2)` man page for more details." msgstr "" -#: library/os.rst:4285 +#: library/os.rst:4281 msgid ":ref:`Availability `: Linux >= 5.3" msgstr "" -#: library/os.rst:4290 +#: library/os.rst:4286 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 " @@ -4543,17 +4543,17 @@ msgid "" "immediately return the error :const:`~errno.EAGAIN` rather than blocking." msgstr "" -#: library/os.rst:4295 +#: library/os.rst:4291 msgid ":ref:`Availability `: Linux >= 5.10" msgstr "" -#: library/os.rst:4301 +#: library/os.rst:4297 msgid "" "Lock program segments into memory. The value of *op* (defined in ````) determines which segments are locked." msgstr "" -#: library/os.rst:4309 +#: library/os.rst:4305 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 " @@ -4563,7 +4563,7 @@ msgid "" "rather than bytes." msgstr "" -#: library/os.rst:4317 +#: library/os.rst:4313 msgid "" "The ``close`` method returns :const:`None` if the subprocess exited " "successfully, or the subprocess's return code if there was an error. On " @@ -4575,60 +4575,60 @@ msgid "" "contains the signed integer return code from the child process." msgstr "" -#: library/os.rst:4327 +#: library/os.rst:4323 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:4332 +#: library/os.rst:4328 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:4336 +#: library/os.rst:4332 msgid ":ref:`Availability `: not Emscripten, not WASI." msgstr "" -#: library/os.rst:4339 +#: library/os.rst:4335 msgid "" "The :ref:`Python UTF-8 Mode ` affects encodings used for *cmd* " "and pipe contents." msgstr "" -#: library/os.rst:4342 +#: library/os.rst:4338 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:4351 +#: library/os.rst:4347 msgid "Wraps the :c:func:`!posix_spawn` C library API for use from Python." msgstr "" -#: library/os.rst:4353 +#: library/os.rst:4349 msgid "" "Most users should use :func:`subprocess.run` instead of :func:`posix_spawn`." msgstr "" -#: library/os.rst:4355 +#: library/os.rst:4351 msgid "" "The positional-only arguments *path*, *args*, and *env* are similar to :func:" "`execve`." msgstr "" -#: library/os.rst:4358 +#: library/os.rst:4354 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:4362 +#: library/os.rst:4358 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 " @@ -4637,31 +4637,31 @@ msgid "" "describing the remaining tuple elements:" msgstr "" -#: library/os.rst:4370 +#: library/os.rst:4366 msgid "(``os.POSIX_SPAWN_OPEN``, *fd*, *path*, *flags*, *mode*)" msgstr "" -#: library/os.rst:4372 +#: library/os.rst:4368 msgid "Performs ``os.dup2(os.open(path, flags, mode), fd)``." msgstr "" -#: library/os.rst:4376 +#: library/os.rst:4372 msgid "(``os.POSIX_SPAWN_CLOSE``, *fd*)" msgstr "" -#: library/os.rst:4378 +#: library/os.rst:4374 msgid "Performs ``os.close(fd)``." msgstr "" -#: library/os.rst:4382 +#: library/os.rst:4378 msgid "(``os.POSIX_SPAWN_DUP2``, *fd*, *new_fd*)" msgstr "" -#: library/os.rst:4384 +#: library/os.rst:4380 msgid "Performs ``os.dup2(fd, new_fd)``." msgstr "" -#: library/os.rst:4386 +#: library/os.rst:4382 msgid "" "These tuples correspond to the C library :c:func:`!" "posix_spawn_file_actions_addopen`, :c:func:`!" @@ -4670,7 +4670,7 @@ msgid "" "`!posix_spawn` call itself." msgstr "" -#: library/os.rst:4392 +#: library/os.rst:4388 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 " @@ -4679,7 +4679,7 @@ msgid "" "corresponds to the C library :c:macro:`!POSIX_SPAWN_SETPGROUP` flag." msgstr "" -#: library/os.rst:4398 +#: library/os.rst:4394 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 " @@ -4690,7 +4690,7 @@ msgid "" "library :c:macro:`!POSIX_SPAWN_RESETIDS` flag." msgstr "" -#: library/os.rst:4406 +#: library/os.rst:4402 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:" @@ -4698,7 +4698,7 @@ msgid "" "is raised." msgstr "" -#: library/os.rst:4411 +#: library/os.rst:4407 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 " @@ -4706,14 +4706,14 @@ msgid "" "POSIX_SPAWN_SETSIGMASK` flag." msgstr "" -#: library/os.rst:4416 +#: library/os.rst:4412 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:4420 +#: library/os.rst:4416 msgid "" "The *scheduler* argument must be a tuple containing the (optional) scheduler " "policy and an instance of :class:`sched_param` with the scheduler " @@ -4723,78 +4723,78 @@ msgid "" "POSIX_SPAWN_SETSCHEDULER` flags." msgstr "" -#: library/os.rst:4443 +#: library/os.rst:4439 msgid "" "Raises an :ref:`auditing event ` ``os.posix_spawn`` with arguments " "``path``, ``argv``, ``env``." msgstr "" -#: library/os.rst:4437 +#: library/os.rst:4433 msgid "Wraps the :c:func:`!posix_spawnp` C library API for use from Python." msgstr "" -#: library/os.rst:4439 +#: library/os.rst:4435 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:4449 +#: library/os.rst:4445 msgid "See :func:`posix_spawn` documentation." msgstr "" -#: library/os.rst:4455 +#: library/os.rst:4451 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:4460 +#: library/os.rst:4456 msgid "*before* is a function called before forking a child process." msgstr "" -#: library/os.rst:4461 +#: library/os.rst:4457 msgid "" "*after_in_parent* is a function called from the parent process after forking " "a child process." msgstr "" -#: library/os.rst:4463 +#: library/os.rst:4459 msgid "*after_in_child* is a function called from the child process." msgstr "" -#: library/os.rst:4465 +#: library/os.rst:4461 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:4469 +#: library/os.rst:4465 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:4474 +#: library/os.rst:4470 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:4478 +#: library/os.rst:4474 msgid "There is no way to unregister a function." msgstr "" -#: library/os.rst:4494 +#: library/os.rst:4490 msgid "Execute the program *path* in a new process." msgstr "" -#: library/os.rst:4496 +#: library/os.rst:4492 msgid "" "(Note that the :mod:`subprocess` module provides more powerful facilities " "for spawning new processes and retrieving their results; using that module " @@ -4802,7 +4802,7 @@ msgid "" "`subprocess-replacements` section.)" msgstr "" -#: library/os.rst:4501 +#: library/os.rst:4497 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 " @@ -4811,13 +4811,13 @@ msgid "" "handle, so can be used with the :func:`waitpid` function." msgstr "" -#: library/os.rst:4507 +#: library/os.rst:4503 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:4510 +#: library/os.rst:4506 msgid "" "The \"l\" and \"v\" variants of the :func:`spawn\\* ` functions " "differ in how command-line arguments are passed. The \"l\" variants are " @@ -4829,7 +4829,7 @@ msgid "" "to the child process must start with the name of the command being run." msgstr "" -#: library/os.rst:4519 +#: library/os.rst:4515 msgid "" "The variants which include a second \"p\" near the end (:func:`spawnlp`, :" "func:`spawnlpe`, :func:`spawnvp`, and :func:`spawnvpe`) will use the :envvar:" @@ -4842,7 +4842,7 @@ msgid "" "appropriate absolute or relative path." msgstr "" -#: library/os.rst:4529 +#: library/os.rst:4525 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 " @@ -4854,19 +4854,19 @@ msgid "" "values will cause the function to fail, with a return value of ``127``." msgstr "" -#: library/os.rst:4538 +#: library/os.rst:4534 msgid "" "As an example, the following calls to :func:`spawnlp` and :func:`spawnvpe` " "are equivalent::" msgstr "" -#: library/os.rst:4547 +#: library/os.rst:4543 msgid "" "Raises an :ref:`auditing event ` ``os.spawn`` with arguments " "``mode``, ``path``, ``args``, ``env``." msgstr "" -#: library/os.rst:4551 +#: library/os.rst:4547 msgid "" ":func:`spawnlp`, :func:`spawnlpe`, :func:`spawnvp` and :func:`spawnvpe` are " "not available on Windows. :func:`spawnle` and :func:`spawnve` are not " @@ -4874,7 +4874,7 @@ msgid "" "instead." msgstr "" -#: library/os.rst:4563 +#: library/os.rst:4559 msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. If either of these values is given, the :func:" @@ -4882,7 +4882,7 @@ msgid "" "been created, with the process id as the return value." msgstr "" -#: library/os.rst:4573 +#: library/os.rst:4569 msgid "" "Possible value for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. If this is given as *mode*, the :func:`spawn\\* " @@ -4891,7 +4891,7 @@ msgid "" "successful, or ``-signal`` if a signal kills the process." msgstr "" -#: library/os.rst:4585 +#: library/os.rst:4581 msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. These are less portable than those listed above. :" @@ -4901,11 +4901,11 @@ msgid "" "function will not return." msgstr "" -#: library/os.rst:4596 +#: library/os.rst:4592 msgid "Start a file with its associated application." msgstr "" -#: library/os.rst:4598 +#: library/os.rst:4594 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:" @@ -4913,7 +4913,7 @@ msgid "" "whatever application (if any) its extension is associated." msgstr "" -#: library/os.rst:4603 +#: library/os.rst:4599 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 " @@ -4921,28 +4921,28 @@ msgid "" "as well as ``'explore'`` and ``'find'`` (to be used on directories)." msgstr "" -#: library/os.rst:4608 +#: library/os.rst:4604 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:4612 +#: library/os.rst:4608 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:4616 +#: library/os.rst:4612 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:4620 +#: library/os.rst:4616 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 " @@ -4953,32 +4953,32 @@ msgid "" "encoded for Win32." msgstr "" -#: library/os.rst:4628 +#: library/os.rst:4624 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:4632 +#: library/os.rst:4628 msgid "" "Raises an :ref:`auditing event ` ``os.startfile`` with arguments " "``path``, ``operation``." msgstr "" -#: library/os.rst:4634 +#: library/os.rst:4630 msgid "" "Raises an :ref:`auditing event ` ``os.startfile/2`` with arguments " "``path``, ``operation``, ``arguments``, ``cwd``, ``show_cmd``." msgstr "" -#: library/os.rst:4638 +#: library/os.rst:4634 msgid "" "Added the *arguments*, *cwd* and *show_cmd* arguments, and the ``os." "startfile/2`` audit event." msgstr "" -#: library/os.rst:4645 +#: library/os.rst:4641 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 " @@ -4989,13 +4989,13 @@ msgid "" "value of the Python function is system-dependent." msgstr "" -#: library/os.rst:4653 +#: library/os.rst:4649 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:4656 +#: library/os.rst:4652 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 :" @@ -5004,7 +5004,7 @@ msgid "" "shell documentation." msgstr "" -#: library/os.rst:4662 +#: library/os.rst:4658 msgid "" "The :mod:`subprocess` module provides more powerful facilities for spawning " "new processes and retrieving their results; using that module is preferable " @@ -5012,53 +5012,53 @@ msgid "" "the :mod:`subprocess` documentation for some helpful recipes." msgstr "" -#: library/os.rst:4667 +#: library/os.rst:4663 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:4671 +#: library/os.rst:4667 msgid "" "Raises an :ref:`auditing event ` ``os.system`` with argument " "``command``." msgstr "" -#: library/os.rst:4678 +#: library/os.rst:4674 msgid "" "Returns the current global process times. The return value is an object with " "five attributes:" msgstr "" -#: library/os.rst:4681 +#: library/os.rst:4677 msgid ":attr:`!user` - user time" msgstr "" -#: library/os.rst:4682 +#: library/os.rst:4678 msgid ":attr:`!system` - system time" msgstr "" -#: library/os.rst:4683 +#: library/os.rst:4679 msgid ":attr:`!children_user` - user time of all child processes" msgstr "" -#: library/os.rst:4684 +#: library/os.rst:4680 msgid ":attr:`!children_system` - system time of all child processes" msgstr "" -#: library/os.rst:4685 +#: library/os.rst:4681 msgid ":attr:`!elapsed` - elapsed real time since a fixed point in the past" msgstr "" -#: library/os.rst:4687 +#: library/os.rst:4683 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:4691 +#: library/os.rst:4687 msgid "" "See the Unix manual page :manpage:`times(2)` and `times(3) `_ manual page on Unix or `the " @@ -5068,7 +5068,7 @@ msgid "" "attributes are zero." msgstr "" -#: library/os.rst:4705 +#: library/os.rst:4701 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 " @@ -5077,87 +5077,87 @@ msgid "" "if a core file was produced." msgstr "" -#: library/os.rst:4711 +#: library/os.rst:4707 msgid "" "If there are no children that could be waited for, :exc:`ChildProcessError` " "is raised." msgstr "" -#: library/os.rst:4789 +#: library/os.rst:4785 msgid "" ":func:`waitstatus_to_exitcode` can be used to convert the exit status into " "an exit code." msgstr "" -#: library/os.rst:4721 +#: library/os.rst:4717 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:4728 +#: library/os.rst:4724 msgid "Wait for the completion of a child process." msgstr "" -#: library/os.rst:4730 +#: library/os.rst:4726 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:4733 +#: library/os.rst:4729 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:4737 +#: library/os.rst:4733 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:4740 +#: library/os.rst:4736 msgid ":attr:`!si_pid` (process ID)" msgstr "" -#: library/os.rst:4741 +#: library/os.rst:4737 msgid ":attr:`!si_uid` (real user ID of the child)" msgstr "" -#: library/os.rst:4742 +#: library/os.rst:4738 msgid ":attr:`!si_signo` (always :const:`~signal.SIGCHLD`)" msgstr "" -#: library/os.rst:4743 +#: library/os.rst:4739 msgid "" ":attr:`!si_status` (the exit status or signal number, depending on :attr:`!" "si_code`)" msgstr "" -#: library/os.rst:4744 +#: library/os.rst:4740 msgid ":attr:`!si_code` (see :data:`CLD_EXITED` for possible values)" msgstr "" -#: library/os.rst:4746 +#: library/os.rst:4742 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:4754 +#: library/os.rst:4750 msgid "This function is not available on macOS." msgstr "" -#: library/os.rst:4761 +#: library/os.rst:4757 msgid "The details of this function differ on Unix and Windows." msgstr "" -#: library/os.rst:4763 +#: library/os.rst:4759 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 " @@ -5166,7 +5166,7 @@ msgid "" "operation." msgstr "" -#: library/os.rst:4768 +#: library/os.rst:4764 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 " @@ -5176,7 +5176,7 @@ msgid "" "group ``-pid`` (the absolute value of *pid*)." msgstr "" -#: library/os.rst:4775 +#: library/os.rst:4771 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 " @@ -5185,7 +5185,7 @@ msgid "" "are :data:`WUNTRACED` and :data:`WCONTINUED`." msgstr "" -#: library/os.rst:4781 +#: library/os.rst:4777 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 " @@ -5197,7 +5197,7 @@ msgid "" "process handles." msgstr "" -#: library/os.rst:4802 +#: library/os.rst:4798 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 " @@ -5206,13 +5206,13 @@ msgid "" "same as that provided to :func:`waitpid` and :func:`wait4`." msgstr "" -#: library/os.rst:4823 +#: library/os.rst:4819 msgid "" ":func:`waitstatus_to_exitcode` can be used to convert the exit status into " "an exitcode." msgstr "" -#: library/os.rst:4817 +#: library/os.rst:4813 msgid "" "Similar to :func:`waitpid`, except a 3-element tuple, containing the child's " "process id, exit status indication, and resource usage information is " @@ -5221,118 +5221,118 @@ msgid "" "to :func:`waitpid`." msgstr "" -#: library/os.rst:4834 +#: library/os.rst:4830 msgid "" "These are the possible values for *idtype* in :func:`waitid`. They affect " "how *id* is interpreted:" msgstr "" -#: library/os.rst:4837 +#: library/os.rst:4833 msgid ":data:`!P_PID` - wait for the child whose PID is *id*." msgstr "" -#: library/os.rst:4838 +#: library/os.rst:4834 msgid ":data:`!P_PGID` - wait for any child whose progress group ID is *id*." msgstr "" -#: library/os.rst:4839 +#: library/os.rst:4835 msgid ":data:`!P_ALL` - wait for any child; *id* is ignored." msgstr "" -#: library/os.rst:4840 +#: library/os.rst:4836 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:4845 +#: library/os.rst:4841 msgid ":data:`!P_PIDFD` is only available on Linux >= 5.4." msgstr "" -#: library/os.rst:4848 +#: library/os.rst:4844 msgid "The :data:`!P_PIDFD` constant." msgstr "" -#: library/os.rst:4854 +#: library/os.rst:4850 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:4863 +#: library/os.rst:4859 msgid "" "This *options* flag for :func:`waitid` causes child processes that have " "terminated to be reported." msgstr "" -#: library/os.rst:4866 +#: library/os.rst:4862 msgid "" "The other ``wait*`` functions always report children that have terminated, " "so this option is not available for them." msgstr "" -#: library/os.rst:4876 +#: library/os.rst:4872 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:4911 +#: library/os.rst:4907 msgid "This option is not available for the other ``wait*`` functions." msgstr "" -#: library/os.rst:4888 +#: library/os.rst:4884 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:4892 +#: library/os.rst:4888 msgid "This option is not available for :func:`waitid`." msgstr "" -#: library/os.rst:4899 +#: library/os.rst:4895 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:4908 +#: library/os.rst:4904 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:4923 +#: library/os.rst:4919 msgid "" "These are the possible values for :attr:`!si_code` in the result returned " "by :func:`waitid`." msgstr "" -#: library/os.rst:4930 +#: library/os.rst:4926 msgid "Added :data:`CLD_KILLED` and :data:`CLD_STOPPED` values." msgstr "" -#: library/os.rst:4936 +#: library/os.rst:4932 msgid "Convert a wait status to an exit code." msgstr "" -#: library/os.rst:4938 +#: library/os.rst:4934 msgid "On Unix:" msgstr "" -#: library/os.rst:4940 +#: library/os.rst:4936 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:4943 +#: library/os.rst:4939 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 " @@ -5340,15 +5340,15 @@ msgid "" "than 0." msgstr "" -#: library/os.rst:4947 +#: library/os.rst:4943 msgid "Otherwise, raise a :exc:`ValueError`." msgstr "" -#: library/os.rst:4949 +#: library/os.rst:4945 msgid "On Windows, return *status* shifted right by 8 bits." msgstr "" -#: library/os.rst:4951 +#: library/os.rst:4947 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 " @@ -5356,221 +5356,221 @@ msgid "" "``WIFSTOPPED(status)`` is true." msgstr "" -#: library/os.rst:4958 +#: library/os.rst:4954 msgid "" ":func:`WIFEXITED`, :func:`WEXITSTATUS`, :func:`WIFSIGNALED`, :func:" "`WTERMSIG`, :func:`WIFSTOPPED`, :func:`WSTOPSIG` functions." msgstr "" -#: library/os.rst:4966 +#: library/os.rst:4962 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:4972 +#: library/os.rst:4968 msgid "" "Return ``True`` if a core dump was generated for the process, otherwise " "return ``False``." msgstr "" -#: library/os.rst:5041 +#: library/os.rst:5037 msgid "This function should be employed only if :func:`WIFSIGNALED` is true." msgstr "" -#: library/os.rst:4982 +#: library/os.rst:4978 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:4986 +#: library/os.rst:4982 msgid "See :data:`WCONTINUED` option." msgstr "" -#: library/os.rst:4993 +#: library/os.rst:4989 msgid "" "Return ``True`` if the process was stopped by delivery of a signal, " "otherwise return ``False``." msgstr "" -#: library/os.rst:4996 +#: library/os.rst:4992 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:5004 +#: library/os.rst:5000 msgid "" "Return ``True`` if the process was terminated by a signal, otherwise return " "``False``." msgstr "" -#: library/os.rst:5012 +#: library/os.rst:5008 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:5021 +#: library/os.rst:5017 msgid "Return the process exit status." msgstr "" -#: library/os.rst:5023 +#: library/os.rst:5019 msgid "This function should be employed only if :func:`WIFEXITED` is true." msgstr "" -#: library/os.rst:5030 +#: library/os.rst:5026 msgid "Return the signal which caused the process to stop." msgstr "" -#: library/os.rst:5032 +#: library/os.rst:5028 msgid "This function should be employed only if :func:`WIFSTOPPED` is true." msgstr "" -#: library/os.rst:5039 +#: library/os.rst:5035 msgid "Return the number of the signal that caused the process to terminate." msgstr "" -#: library/os.rst:5047 +#: library/os.rst:5043 msgid "Interface to the scheduler" msgstr "" -#: library/os.rst:5049 +#: library/os.rst:5045 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:5055 +#: library/os.rst:5051 msgid "" "The following scheduling policies are exposed if they are supported by the " "operating system." msgstr "" -#: library/os.rst:5060 +#: library/os.rst:5056 msgid "The default scheduling policy." msgstr "" -#: library/os.rst:5064 +#: library/os.rst:5060 msgid "" "Scheduling policy for CPU-intensive processes that tries to preserve " "interactivity on the rest of the computer." msgstr "" -#: library/os.rst:5069 +#: library/os.rst:5065 msgid "Scheduling policy for extremely low priority background tasks." msgstr "" -#: library/os.rst:5073 +#: library/os.rst:5069 msgid "Scheduling policy for sporadic server programs." msgstr "" -#: library/os.rst:5077 +#: library/os.rst:5073 msgid "A First In First Out scheduling policy." msgstr "" -#: library/os.rst:5081 +#: library/os.rst:5077 msgid "A round-robin scheduling policy." msgstr "" -#: library/os.rst:5085 +#: library/os.rst:5081 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:5092 +#: library/os.rst:5088 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:5096 +#: library/os.rst:5092 msgid "At the moment, there is only one possible parameter:" msgstr "" -#: library/os.rst:5100 +#: library/os.rst:5096 msgid "The scheduling priority for a scheduling policy." msgstr "" -#: library/os.rst:5105 +#: library/os.rst:5101 msgid "" "Get the minimum priority value for *policy*. *policy* is one of the " "scheduling policy constants above." msgstr "" -#: library/os.rst:5111 +#: library/os.rst:5107 msgid "" "Get the maximum priority value for *policy*. *policy* is one of the " "scheduling policy constants above." msgstr "" -#: library/os.rst:5117 +#: library/os.rst:5113 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:5124 +#: library/os.rst:5120 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:5131 +#: library/os.rst:5127 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:5137 +#: library/os.rst:5133 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:5143 +#: library/os.rst:5139 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:5149 +#: library/os.rst:5145 msgid "Voluntarily relinquish the CPU." msgstr "" -#: library/os.rst:5154 +#: library/os.rst:5150 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:5161 +#: library/os.rst:5157 msgid "Return the set of CPUs the process with PID *pid* is restricted to." msgstr "" -#: library/os.rst:5163 +#: library/os.rst:5159 msgid "" "If *pid* is zero, return the set of CPUs the calling thread of the current " "process is restricted to." msgstr "" -#: library/os.rst:5170 +#: library/os.rst:5166 msgid "Miscellaneous System Information" msgstr "" -#: library/os.rst:5175 +#: library/os.rst:5171 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 " @@ -5581,13 +5581,13 @@ msgid "" "included in that mapping, passing an integer for *name* is also accepted." msgstr "" -#: library/os.rst:5183 +#: library/os.rst:5179 msgid "" "If the configuration value specified by *name* isn't defined, ``None`` is " "returned." msgstr "" -#: library/os.rst:5186 +#: library/os.rst:5182 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 " @@ -5595,34 +5595,34 @@ msgid "" "`errno.EINVAL` for the error number." msgstr "" -#: library/os.rst:5196 +#: library/os.rst:5192 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:5205 +#: library/os.rst:5201 msgid "" "Return the number of logical CPUs in the system. Returns ``None`` if " "undetermined." msgstr "" -#: library/os.rst:5208 +#: library/os.rst:5204 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:5217 +#: library/os.rst:5213 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:5226 +#: library/os.rst:5222 msgid "" "Return integer-valued system configuration values. If the configuration " "value specified by *name* isn't defined, ``-1`` is returned. The comments " @@ -5631,44 +5631,44 @@ msgid "" "``sysconf_names``." msgstr "" -#: library/os.rst:5236 +#: library/os.rst:5232 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:5242 +#: library/os.rst:5238 msgid "Add ``'SC_MINSIGSTKSZ'`` name." msgstr "" -#: library/os.rst:5245 +#: library/os.rst:5241 msgid "" "The following data values are used to support path manipulation operations. " "These are defined for all platforms." msgstr "" -#: library/os.rst:5248 +#: library/os.rst:5244 msgid "" "Higher-level operations on pathnames are defined in the :mod:`os.path` " "module." msgstr "" -#: library/os.rst:5254 +#: library/os.rst:5250 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:5262 +#: library/os.rst:5258 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:5271 +#: library/os.rst:5267 msgid "" "The character used by the operating system to separate pathname components. " "This is ``'/'`` for POSIX and ``'\\\\'`` for Windows. Note that knowing " @@ -5677,7 +5677,7 @@ msgid "" "useful. Also available via :mod:`os.path`." msgstr "" -#: library/os.rst:5281 +#: library/os.rst:5277 msgid "" "An alternative character used by the operating system to separate pathname " "components, or ``None`` if only one separator character exists. This is set " @@ -5685,27 +5685,27 @@ msgid "" "via :mod:`os.path`." msgstr "" -#: library/os.rst:5290 +#: library/os.rst:5286 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:5298 +#: library/os.rst:5294 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:5305 +#: library/os.rst:5301 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:5312 +#: library/os.rst:5308 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 " @@ -5714,36 +5714,36 @@ msgid "" "default); use a single ``'\\n'`` instead, on all platforms." msgstr "" -#: library/os.rst:5321 +#: library/os.rst:5317 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:5332 +#: library/os.rst:5328 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:5340 +#: library/os.rst:5336 msgid "Random numbers" msgstr "" -#: library/os.rst:5345 +#: library/os.rst:5341 msgid "" "Get up to *size* random bytes. The function can return less bytes than " "requested." msgstr "" -#: library/os.rst:5348 +#: library/os.rst:5344 msgid "" "These bytes can be used to seed user-space random number generators or for " "cryptographic purposes." msgstr "" -#: library/os.rst:5351 +#: library/os.rst:5347 msgid "" "``getrandom()`` relies on entropy gathered from device drivers and other " "sources of environmental noise. Unnecessarily reading large quantities of " @@ -5751,36 +5751,36 @@ msgid "" "``/dev/urandom`` devices." msgstr "" -#: library/os.rst:5356 +#: library/os.rst:5352 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:5360 +#: library/os.rst:5356 msgid "" "See also the `Linux getrandom() manual page `_." msgstr "" -#: library/os.rst:5363 +#: library/os.rst:5359 msgid ":ref:`Availability `: Linux >= 3.17." msgstr "" -#: library/os.rst:5369 +#: library/os.rst:5365 msgid "" "Return a bytestring of *size* random bytes suitable for cryptographic use." msgstr "" -#: library/os.rst:5371 +#: library/os.rst:5367 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:5375 +#: library/os.rst:5371 msgid "" "On Linux, if the ``getrandom()`` syscall is available, it is used in " "blocking mode: block until the system urandom entropy pool is initialized " @@ -5790,63 +5790,63 @@ msgid "" "to poll until the system urandom entropy pool is initialized." msgstr "" -#: library/os.rst:5382 +#: library/os.rst:5378 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:5386 +#: library/os.rst:5382 msgid "On Windows, it will use ``BCryptGenRandom()``." msgstr "" -#: library/os.rst:5389 +#: library/os.rst:5385 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:5393 +#: library/os.rst:5389 msgid "" -"On Linux, ``getrandom()`` is now used in blocking mode to increase the " -"security." +"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:5397 +#: library/os.rst:5395 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:5401 +#: library/os.rst:5399 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." +"On Linux, ``getrandom()`` is now used in blocking mode to increase the " +"security." msgstr "" -#: library/os.rst:5407 +#: library/os.rst:5403 msgid "" "On Windows, ``BCryptGenRandom()`` is used instead of ``CryptGenRandom()`` " "which is deprecated." msgstr "" -#: library/os.rst:5413 +#: library/os.rst:5409 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:5417 +#: library/os.rst:5413 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:5424 +#: library/os.rst:5420 msgid "" "If this bit is set, then random bytes are drawn from the ``/dev/" "random`` pool instead of the ``/dev/urandom`` pool." @@ -5860,7 +5860,7 @@ msgstr "" msgid "effective id" msgstr "" -#: library/os.rst:438 library/os.rst:456 library/os.rst:666 library/os.rst:4259 +#: library/os.rst:438 library/os.rst:456 library/os.rst:666 library/os.rst:4255 msgid "process" msgstr "" @@ -5900,11 +5900,11 @@ msgstr "" msgid "gethostbyaddr() (in module socket)" msgstr "" -#: library/os.rst:2578 +#: library/os.rst:2577 msgid "deleting" msgstr "" -#: library/os.rst:2948 +#: library/os.rst:2947 msgid "module" msgstr "" @@ -5912,7 +5912,7 @@ msgstr "" msgid "pty" msgstr "" -#: library/os.rst:2376 library/os.rst:3485 library/os.rst:3584 +#: library/os.rst:2376 library/os.rst:3481 library/os.rst:3580 msgid "directory" msgstr "" @@ -5932,58 +5932,58 @@ msgstr "" msgid "and os.makedirs()" msgstr "" -#: library/os.rst:2948 +#: library/os.rst:2947 msgid "stat" msgstr "" -#: library/os.rst:3584 +#: library/os.rst:3580 msgid "walking" msgstr "" -#: library/os.rst:3584 +#: library/os.rst:3580 msgid "traversal" msgstr "" -#: library/os.rst:4259 +#: library/os.rst:4255 msgid "killing" msgstr "" -#: library/os.rst:4259 +#: library/os.rst:4255 msgid "signalling" msgstr "" -#: library/os.rst:5287 +#: library/os.rst:5283 msgid ". (dot)" msgstr "" -#: library/os.rst:5259 library/os.rst:5278 library/os.rst:5287 +#: library/os.rst:5255 library/os.rst:5274 library/os.rst:5283 msgid "in pathnames" msgstr "" -#: library/os.rst:5259 +#: library/os.rst:5255 msgid ".." msgstr "" -#: library/os.rst:5278 +#: library/os.rst:5274 msgid "/ (slash)" msgstr "" -#: library/os.rst:5268 +#: library/os.rst:5264 msgid "\\ (backslash)" msgstr "" -#: library/os.rst:5268 +#: library/os.rst:5264 msgid "in pathnames (Windows)" msgstr "" -#: library/os.rst:5294 +#: library/os.rst:5290 msgid ": (colon)" msgstr "" -#: library/os.rst:5294 +#: library/os.rst:5290 msgid "path separator (POSIX)" msgstr "" -#: library/os.rst:5294 +#: library/os.rst:5290 msgid "; (semicolon)" msgstr "" diff --git a/library/pdb.po b/library/pdb.po index 1b0948f4f..affa8a4dd 100644 --- a/library/pdb.po +++ b/library/pdb.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -337,25 +337,26 @@ msgstr "" msgid "" "If a file :file:`.pdbrc` exists in the user's home directory or in the " "current directory, it is read with ``'utf-8'`` encoding and executed as if " -"it had been typed at the debugger prompt. This is particularly useful for " -"aliases. If both files exist, the one in the home directory is read first " -"and aliases defined there can be overridden by the local file." +"it had been typed at the debugger prompt, with the exception that empty " +"lines and lines starting with ``#`` are ignored. This is particularly " +"useful for aliases. If both files exist, the one in the home directory is " +"read first and aliases defined there can be overridden by the local file." msgstr "" -#: library/pdb.rst:291 -msgid "" -":file:`.pdbrc` is now read with ``'utf-8'`` encoding. Previously, it was " -"read with the system locale encoding." -msgstr "" - -#: library/pdb.rst:295 +#: library/pdb.rst:292 msgid "" ":file:`.pdbrc` can now contain commands that continue debugging, such as :" "pdbcmd:`continue` or :pdbcmd:`next`. Previously, these commands had no " "effect." msgstr "" -#: library/pdb.rst:303 +#: library/pdb.rst:297 +msgid "" +":file:`.pdbrc` is now read with ``'utf-8'`` encoding. Previously, it was " +"read with the system locale encoding." +msgstr "" + +#: library/pdb.rst:304 msgid "" "Without argument, print the list of available commands. With a *command* as " "argument, print help about that command. ``help pdb`` displays the full " @@ -364,26 +365,26 @@ msgid "" "the ``!`` command." msgstr "" -#: library/pdb.rst:311 +#: library/pdb.rst:312 msgid "" "Print a stack trace, with the most recent frame at the bottom. An arrow " "(``>``) indicates the current frame, which determines the context of most " "commands." msgstr "" -#: library/pdb.rst:316 +#: library/pdb.rst:317 msgid "" "Move the current frame *count* (default one) levels down in the stack trace " "(to a newer frame)." msgstr "" -#: library/pdb.rst:321 +#: library/pdb.rst:322 msgid "" "Move the current frame *count* (default one) levels up in the stack trace " "(to an older frame)." msgstr "" -#: library/pdb.rst:326 +#: library/pdb.rst:327 msgid "" "With a *lineno* argument, set a break there in the current file. With a " "*function* argument, set a break at the first executable statement within " @@ -394,33 +395,33 @@ msgid "" "refer." msgstr "" -#: library/pdb.rst:333 +#: library/pdb.rst:334 msgid "" "If a second argument is present, it is an expression which must evaluate to " "true before the breakpoint is honored." msgstr "" -#: library/pdb.rst:336 +#: library/pdb.rst:337 msgid "" "Without argument, list all breaks, including for each breakpoint, the number " "of times that breakpoint has been hit, the current ignore count, and the " "associated condition if any." msgstr "" -#: library/pdb.rst:342 +#: library/pdb.rst:343 msgid "" "Temporary breakpoint, which is removed automatically when it is first hit. " "The arguments are the same as for :pdbcmd:`break`." msgstr "" -#: library/pdb.rst:347 +#: library/pdb.rst:348 msgid "" "With a *filename:lineno* argument, clear all the breakpoints at this line. " "With a space separated list of breakpoint numbers, clear those breakpoints. " "Without argument, clear all breaks (but first ask confirmation)." msgstr "" -#: library/pdb.rst:353 +#: library/pdb.rst:354 msgid "" "Disable the breakpoints given as a space separated list of breakpoint " "numbers. Disabling a breakpoint means it cannot cause the program to stop " @@ -428,11 +429,11 @@ msgid "" "breakpoints and can be (re-)enabled." msgstr "" -#: library/pdb.rst:360 +#: library/pdb.rst:361 msgid "Enable the breakpoints specified." msgstr "" -#: library/pdb.rst:364 +#: library/pdb.rst:365 msgid "" "Set the ignore count for the given breakpoint number. If *count* is " "omitted, the ignore count is set to 0. A breakpoint becomes active when the " @@ -441,39 +442,39 @@ msgid "" "associated condition evaluates to true." msgstr "" -#: library/pdb.rst:372 +#: library/pdb.rst:373 msgid "" "Set a new *condition* for the breakpoint, an expression which must evaluate " "to true before the breakpoint is honored. If *condition* is absent, any " "existing condition is removed; i.e., the breakpoint is made unconditional." msgstr "" -#: library/pdb.rst:378 +#: library/pdb.rst:379 msgid "" "Specify a list of commands for breakpoint number *bpnumber*. The commands " "themselves appear on the following lines. Type a line containing just " "``end`` to terminate the commands. An example::" msgstr "" -#: library/pdb.rst:387 +#: library/pdb.rst:388 msgid "" "To remove all commands from a breakpoint, type ``commands`` and follow it " "immediately with ``end``; that is, give no commands." msgstr "" -#: library/pdb.rst:390 +#: library/pdb.rst:391 msgid "" "With no *bpnumber* argument, ``commands`` refers to the last breakpoint set." msgstr "" -#: library/pdb.rst:392 +#: library/pdb.rst:393 msgid "" "You can use breakpoint commands to start your program up again. Simply use " "the :pdbcmd:`continue` command, or :pdbcmd:`step`, or any other command that " "resumes execution." msgstr "" -#: library/pdb.rst:396 +#: library/pdb.rst:397 msgid "" "Specifying any command resuming execution (currently :pdbcmd:`continue`, :" "pdbcmd:`step`, :pdbcmd:`next`, :pdbcmd:`return`, :pdbcmd:`jump`, :pdbcmd:" @@ -484,7 +485,7 @@ msgid "" "ambiguities about which list to execute." msgstr "" -#: library/pdb.rst:405 +#: library/pdb.rst:406 msgid "" "If you use the ``silent`` command in the command list, the usual message " "about stopping at a breakpoint is not printed. This may be desirable for " @@ -493,13 +494,13 @@ msgid "" "was reached." msgstr "" -#: library/pdb.rst:412 +#: library/pdb.rst:413 msgid "" "Execute the current line, stop at the first possible occasion (either in a " "function that is called or on the next line in the current function)." msgstr "" -#: library/pdb.rst:417 +#: library/pdb.rst:418 msgid "" "Continue execution until the next line in the current function is reached or " "it returns. (The difference between :pdbcmd:`next` and :pdbcmd:`step` is " @@ -508,46 +509,46 @@ msgid "" "line in the current function.)" msgstr "" -#: library/pdb.rst:425 +#: library/pdb.rst:426 msgid "" "Without argument, continue execution until the line with a number greater " "than the current one is reached." msgstr "" -#: library/pdb.rst:428 +#: library/pdb.rst:429 msgid "" "With *lineno*, continue execution until a line with a number greater or " "equal to *lineno* is reached. In both cases, also stop when the current " "frame returns." msgstr "" -#: library/pdb.rst:432 +#: library/pdb.rst:433 msgid "Allow giving an explicit line number." msgstr "" -#: library/pdb.rst:437 +#: library/pdb.rst:438 msgid "Continue execution until the current function returns." msgstr "" -#: library/pdb.rst:441 +#: library/pdb.rst:442 msgid "Continue execution, only stop when a breakpoint is encountered." msgstr "" -#: library/pdb.rst:445 +#: library/pdb.rst:446 msgid "" "Set the next line that will be executed. Only available in the bottom-most " "frame. This lets you jump back and execute code again, or jump forward to " "skip code that you don't want to run." msgstr "" -#: library/pdb.rst:449 +#: library/pdb.rst:450 msgid "" "It should be noted that not all jumps are allowed -- for instance it is not " "possible to jump into the middle of a :keyword:`for` loop or out of a :" "keyword:`finally` clause." msgstr "" -#: library/pdb.rst:455 +#: library/pdb.rst:456 msgid "" "List source code for the current file. Without arguments, list 11 lines " "around the current line or continue the previous listing. With ``.`` as " @@ -556,7 +557,7 @@ msgid "" "second argument is less than the first, it is interpreted as a count." msgstr "" -#: library/pdb.rst:461 +#: library/pdb.rst:462 msgid "" "The current line in the current frame is indicated by ``->``. If an " "exception is being debugged, the line where the exception was originally " @@ -564,90 +565,90 @@ msgid "" "line." msgstr "" -#: library/pdb.rst:466 +#: library/pdb.rst:467 msgid "Added the ``>>`` marker." msgstr "" -#: library/pdb.rst:471 +#: library/pdb.rst:472 msgid "" "List all source code for the current function or frame. Interesting lines " "are marked as for :pdbcmd:`list`." msgstr "" -#: library/pdb.rst:478 +#: library/pdb.rst:479 msgid "Print the arguments of the current function and their current values." msgstr "" -#: library/pdb.rst:482 +#: library/pdb.rst:483 msgid "Evaluate *expression* in the current context and print its value." msgstr "" -#: library/pdb.rst:486 +#: library/pdb.rst:487 msgid "" "``print()`` can also be used, but is not a debugger command --- this " "executes the Python :func:`print` function." msgstr "" -#: library/pdb.rst:492 +#: library/pdb.rst:493 msgid "" "Like the :pdbcmd:`p` command, except the value of *expression* is pretty-" "printed using the :mod:`pprint` module." msgstr "" -#: library/pdb.rst:497 +#: library/pdb.rst:498 msgid "Print the type of *expression*." msgstr "" -#: library/pdb.rst:501 +#: library/pdb.rst:502 msgid "Try to get source code of *expression* and display it." msgstr "" -#: library/pdb.rst:507 +#: library/pdb.rst:508 msgid "" "Display the value of *expression* if it changed, each time execution stops " "in the current frame." msgstr "" -#: library/pdb.rst:510 +#: library/pdb.rst:511 msgid "" "Without *expression*, list all display expressions for the current frame." msgstr "" -#: library/pdb.rst:514 +#: library/pdb.rst:515 msgid "" "Display evaluates *expression* and compares to the result of the previous " "evaluation of *expression*, so when the result is mutable, display may not " "be able to pick up the changes." msgstr "" -#: library/pdb.rst:518 +#: library/pdb.rst:519 msgid "Example::" msgstr "" -#: library/pdb.rst:526 +#: library/pdb.rst:527 msgid "" "Display won't realize ``lst`` has been changed because the result of " "evaluation is modified in place by ``lst.append(1)`` before being compared::" msgstr "" -#: library/pdb.rst:541 +#: library/pdb.rst:542 msgid "You can do some tricks with copy mechanism to make it work::" msgstr "" -#: library/pdb.rst:560 +#: library/pdb.rst:561 msgid "" "Do not display *expression* anymore in the current frame. Without " "*expression*, clear all display expressions for the current frame." msgstr "" -#: library/pdb.rst:567 +#: library/pdb.rst:568 msgid "" "Start an interactive interpreter (using the :mod:`code` module) whose global " "namespace contains all the (global and local) names found in the current " "scope." msgstr "" -#: library/pdb.rst:577 +#: library/pdb.rst:578 msgid "" "Create an alias called *name* that executes *command*. The *command* must " "*not* be enclosed in quotes. Replaceable parameters can be indicated by " @@ -656,7 +657,7 @@ msgid "" "arguments are given, all aliases are listed." msgstr "" -#: library/pdb.rst:583 +#: library/pdb.rst:584 msgid "" "Aliases may be nested and can contain anything that can be legally typed at " "the pdb prompt. Note that internal pdb commands *can* be overridden by " @@ -665,30 +666,30 @@ msgid "" "other words in the line are left alone." msgstr "" -#: library/pdb.rst:589 +#: library/pdb.rst:590 msgid "" "As an example, here are two useful aliases (especially when placed in the :" "file:`.pdbrc` file)::" msgstr "" -#: library/pdb.rst:599 +#: library/pdb.rst:600 msgid "Delete the specified alias *name*." msgstr "" -#: library/pdb.rst:603 +#: library/pdb.rst:604 msgid "" "Execute the (one-line) *statement* in the context of the current stack " "frame. The exclamation point can be omitted unless the first word of the " "statement resembles a debugger command, e.g.:" msgstr "" -#: library/pdb.rst:612 +#: library/pdb.rst:613 msgid "" "To set a global variable, you can prefix the assignment command with a :" "keyword:`global` statement on the same line, e.g.:" msgstr "" -#: library/pdb.rst:623 +#: library/pdb.rst:624 msgid "" "Restart the debugged Python program. If *args* is supplied, it is split " "with :mod:`shlex` and the result is used as the new :data:`sys.argv`. " @@ -696,25 +697,25 @@ msgid "" "`restart` is an alias for :pdbcmd:`run`." msgstr "" -#: library/pdb.rst:630 +#: library/pdb.rst:631 msgid "Quit from the debugger. The program being executed is aborted." msgstr "" -#: library/pdb.rst:634 +#: library/pdb.rst:635 msgid "" "Enter a recursive debugger that steps through *code* (which is an arbitrary " "expression or statement to be executed in the current environment)." msgstr "" -#: library/pdb.rst:640 +#: library/pdb.rst:641 msgid "Print the return value for the last return of the current function." msgstr "" -#: library/pdb.rst:643 +#: library/pdb.rst:644 msgid "Footnotes" msgstr "" -#: library/pdb.rst:644 +#: library/pdb.rst:645 msgid "" "Whether a frame is considered to originate in a certain module is determined " "by the ``__name__`` in the frame globals." diff --git a/library/pprint.po b/library/pprint.po index f1a1eca3d..21fac59a7 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-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -67,7 +67,7 @@ msgid "" "parameters." msgstr "" -#: library/pprint.rst:53 +#: library/pprint.rst:64 msgid "" "Prints the formatted representation of *object* on *stream*, followed by a " "newline. If *stream* is ``None``, :data:`sys.stdout` is used. This may be " @@ -76,37 +76,43 @@ msgid "" "use within a scope)." msgstr "" -#: library/pprint.rst:59 +#: library/pprint.rst:70 msgid "" "The configuration parameters *stream*, *indent*, *width*, *depth*, " "*compact*, *sort_dicts* and *underscore_numbers* are passed to the :class:" "`PrettyPrinter` constructor and their meanings are as described in its " -"documentation above." +"documentation below." msgstr "" -#: library/pprint.rst:78 +#: library/pprint.rst:75 +msgid "" +"Note that *sort_dicts* is ``True`` by default and you might want to use :" +"func:`~pprint.pp` instead where it is ``False`` by default." +msgstr "" + +#: library/pprint.rst:81 msgid "" "Return the formatted representation of *object* as a string. *indent*, " "*width*, *depth*, *compact*, *sort_dicts* and *underscore_numbers* are " "passed to the :class:`PrettyPrinter` constructor as formatting parameters " -"and their meanings are as described in its documentation above." +"and their meanings are as described in its documentation below." msgstr "" -#: library/pprint.rst:88 +#: library/pprint.rst:91 msgid "" "Determine if the formatted representation of *object* is \"readable\", or " "can be used to reconstruct the value using :func:`eval`. This always " "returns ``False`` for recursive objects." msgstr "" -#: library/pprint.rst:98 +#: library/pprint.rst:101 msgid "" "Determine if *object* requires a recursive representation. This function is " "subject to the same limitations as noted in :func:`saferepr` below and may " "raise an :exc:`RecursionError` if it fails to detect a recursive object." msgstr "" -#: library/pprint.rst:105 +#: library/pprint.rst:108 msgid "" "Return a string representation of *object*, protected against recursion in " "some common data structures, namely instances of :class:`dict`, :class:" @@ -116,21 +122,21 @@ msgid "" "id=number>``. The representation is not otherwise formatted." msgstr "" -#: library/pprint.rst:118 +#: library/pprint.rst:121 msgid "PrettyPrinter Objects" msgstr "" -#: library/pprint.rst:120 +#: library/pprint.rst:123 msgid "This module defines one class:" msgstr "" -#: library/pprint.rst:130 +#: library/pprint.rst:133 msgid "" "Construct a :class:`PrettyPrinter` instance. This constructor understands " "several keyword parameters." msgstr "" -#: library/pprint.rst:133 +#: library/pprint.rst:136 msgid "" "*stream* (default :data:`!sys.stdout`) is a :term:`file-like object` to " "which the output will be written by calling its :meth:`!write` method. If " @@ -138,19 +144,19 @@ msgid "" "`~PrettyPrinter.pprint` silently returns." msgstr "" -#: library/pprint.rst:138 +#: library/pprint.rst:141 msgid "" "Other values configure the manner in which nesting of complex data " "structures is displayed." msgstr "" -#: library/pprint.rst:141 +#: library/pprint.rst:144 msgid "" "*indent* (default 1) specifies the amount of indentation added for each " "nesting level." msgstr "" -#: library/pprint.rst:144 +#: library/pprint.rst:147 msgid "" "*depth* controls the number of nesting levels which may be printed; if the " "data structure being printed is too deep, the next contained level is " @@ -158,14 +164,14 @@ msgid "" "objects being formatted." msgstr "" -#: library/pprint.rst:149 +#: library/pprint.rst:152 msgid "" "*width* (default 80) specifies the desired maximum number of characters per " "line in the output. If a structure cannot be formatted within the width " "constraint, a best effort will be made." msgstr "" -#: library/pprint.rst:153 +#: library/pprint.rst:156 msgid "" "*compact* impacts the way that long sequences (lists, tuples, sets, etc) are " "formatted. If *compact* is false (the default) then each item of a sequence " @@ -173,52 +179,52 @@ msgid "" "as will fit within the *width* will be formatted on each output line." msgstr "" -#: library/pprint.rst:159 +#: library/pprint.rst:162 msgid "" "If *sort_dicts* is true (the default), dictionaries will be formatted with " "their keys sorted, otherwise they will display in insertion order." msgstr "" -#: library/pprint.rst:162 +#: library/pprint.rst:165 msgid "" "If *underscore_numbers* is true, integers will be formatted with the ``_`` " "character for a thousands separator, otherwise underscores are not displayed " "(the default)." msgstr "" -#: library/pprint.rst:166 +#: library/pprint.rst:169 msgid "Added the *compact* parameter." msgstr "" -#: library/pprint.rst:169 +#: library/pprint.rst:172 msgid "Added the *sort_dicts* parameter." msgstr "" -#: library/pprint.rst:172 +#: library/pprint.rst:175 msgid "Added the *underscore_numbers* parameter." msgstr "" -#: library/pprint.rst:175 +#: library/pprint.rst:178 msgid "No longer attempts to write to :data:`!sys.stdout` if it is ``None``." msgstr "" -#: library/pprint.rst:202 +#: library/pprint.rst:205 msgid ":class:`PrettyPrinter` instances have the following methods:" msgstr "" -#: library/pprint.rst:207 +#: library/pprint.rst:210 msgid "" "Return the formatted representation of *object*. This takes into account " "the options passed to the :class:`PrettyPrinter` constructor." msgstr "" -#: library/pprint.rst:213 +#: library/pprint.rst:216 msgid "" "Print the formatted representation of *object* on the configured stream, " "followed by a newline." msgstr "" -#: library/pprint.rst:216 +#: library/pprint.rst:219 msgid "" "The following methods provide the implementations for the corresponding " "functions of the same names. Using these methods on an instance is slightly " @@ -226,7 +232,7 @@ msgid "" "created." msgstr "" -#: library/pprint.rst:226 +#: library/pprint.rst:229 msgid "" "Determine if the formatted representation of the object is \"readable,\" or " "can be used to reconstruct the value using :func:`eval`. Note that this " @@ -235,18 +241,18 @@ msgid "" "returns ``False``." msgstr "" -#: library/pprint.rst:235 +#: library/pprint.rst:238 msgid "Determine if the object requires a recursive representation." msgstr "" -#: library/pprint.rst:237 +#: library/pprint.rst:240 msgid "" "This method is provided as a hook to allow subclasses to modify the way " "objects are converted to strings. The default implementation uses the " "internals of the :func:`saferepr` implementation." msgstr "" -#: library/pprint.rst:244 +#: library/pprint.rst:247 msgid "" "Returns three values: the formatted version of *object* as a string, a flag " "indicating whether the result is readable, and a flag indicating whether " @@ -264,45 +270,45 @@ msgid "" "of the current call." msgstr "" -#: library/pprint.rst:262 +#: library/pprint.rst:265 msgid "Example" msgstr "" -#: library/pprint.rst:264 +#: library/pprint.rst:267 msgid "" -"To demonstrate several uses of the :func:`~pprint.pprint` function and its " +"To demonstrate several uses of the :func:`~pprint.pp` function and its " "parameters, let's fetch information about a project from `PyPI `_::" msgstr "" -#: library/pprint.rst:273 -msgid "In its basic form, :func:`~pprint.pprint` shows the whole object::" +#: library/pprint.rst:276 +msgid "In its basic form, :func:`~pprint.pp` shows the whole object::" msgstr "" -#: library/pprint.rst:329 +#: library/pprint.rst:332 msgid "" "The result can be limited to a certain *depth* (ellipsis is used for deeper " "contents)::" msgstr "" -#: library/pprint.rst:375 +#: library/pprint.rst:378 msgid "" "Additionally, maximum character *width* can be suggested. If a long object " "cannot be split, the specified width will be exceeded::" msgstr "" -#: library/pprint.rst:224 +#: library/pprint.rst:227 msgid "built-in function" msgstr "" -#: library/pprint.rst:224 +#: library/pprint.rst:227 msgid "eval" msgstr "" -#: library/pprint.rst:125 +#: library/pprint.rst:128 msgid "..." msgstr "" -#: library/pprint.rst:125 +#: library/pprint.rst:128 msgid "placeholder" msgstr "" diff --git a/library/pydoc.po b/library/pydoc.po index 165ce2db7..373b0daa0 100644 --- a/library/pydoc.po +++ b/library/pydoc.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -26,7 +26,7 @@ msgstr "" #: library/pydoc.rst:19 msgid "" -"The :mod:`pydoc` module automatically generates documentation from Python " +"The :mod:`!pydoc` module automatically generates documentation from Python " "modules. The documentation can be presented as pages of text on the " "console, served to a web browser, or saved to HTML files." msgstr "" @@ -34,9 +34,9 @@ msgstr "" #: library/pydoc.rst:23 msgid "" "For modules, classes, functions and methods, the displayed documentation is " -"derived from the docstring (i.e. the :attr:`__doc__` attribute) of the " +"derived from the docstring (i.e. the :attr:`!__doc__` attribute) of the " "object, and recursively of its documentable members. If there is no " -"docstring, :mod:`pydoc` tries to obtain a description from the block of " +"docstring, :mod:`!pydoc` tries to obtain a description from the block of " "comment lines just above the definition of the class, function or method in " "the source file, or at the top of the module (see :func:`inspect." "getcomments`)." @@ -45,7 +45,7 @@ msgstr "" #: library/pydoc.rst:30 msgid "" "The built-in function :func:`help` invokes the online help system in the " -"interactive interpreter, which uses :mod:`pydoc` to generate its " +"interactive interpreter, which uses :mod:`!pydoc` to generate its " "documentation as text on the console. The same text documentation can also " "be viewed from outside the Python interpreter by running :program:`pydoc` as " "a script at the operating system's command prompt. For example, running ::" @@ -65,7 +65,7 @@ msgstr "" #: library/pydoc.rst:49 msgid "" -"In order to find objects and their documentation, :mod:`pydoc` imports the " +"In order to find objects and their documentation, :mod:`!pydoc` imports the " "module(s) to be documented. Therefore, any code on module level will be " "executed on that occasion. Use an ``if __name__ == '__main__':`` guard to " "only execute code when a file is invoked as a script and not just imported." @@ -134,7 +134,7 @@ msgid "" "Module docs for core modules are assumed to reside in ``https://docs.python." "org/X.Y/library/`` where ``X`` and ``Y`` are the major and minor version " "numbers of the Python interpreter. This can be overridden by setting the :" -"envvar:`PYTHONDOCS` environment variable to a different URL or to a local " +"envvar:`!PYTHONDOCS` environment variable to a different URL or to a local " "directory containing the Library Reference Manual pages." msgstr "" @@ -148,7 +148,7 @@ msgstr "" #: library/pydoc.rst:103 msgid "" -":mod:`pydoc` now uses :func:`inspect.signature` rather than :func:`inspect." +":mod:`!pydoc` now uses :func:`inspect.signature` rather than :func:`inspect." "getfullargspec` to extract signature information from callables." msgstr "" diff --git a/library/pyexpat.po b/library/pyexpat.po index 455e7d853..b76ee7253 100644 --- a/library/pyexpat.po +++ b/library/pyexpat.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -212,18 +212,54 @@ msgid "" "``errors.codes[errors.XML_ERROR_CANT_CHANGE_FEATURE_ONCE_PARSING]``." msgstr "" -#: library/pyexpat.rst:199 +#: library/pyexpat.rst:203 +msgid "" +"Calling ``SetReparseDeferralEnabled(False)`` has security implications, as " +"detailed below; please make sure to understand these consequences prior to " +"using the ``SetReparseDeferralEnabled`` method." +msgstr "" + +#: library/pyexpat.rst:207 +msgid "" +"Expat 2.6.0 introduced a security mechanism called \"reparse deferral\" " +"where instead of causing denial of service through quadratic runtime from " +"reparsing large tokens, reparsing of unfinished tokens is now delayed by " +"default until a sufficient amount of input is reached. Due to this delay, " +"registered handlers may — depending of the sizing of input chunks pushed to " +"Expat — no longer be called right after pushing new input to the parser. " +"Where immediate feedback and taking over responsiblity of protecting against " +"denial of service from large tokens are both wanted, calling " +"``SetReparseDeferralEnabled(False)`` disables reparse deferral for the " +"current Expat parser instance, temporarily or altogether. Calling " +"``SetReparseDeferralEnabled(True)`` allows re-enabling reparse deferral." +msgstr "" + +#: library/pyexpat.rst:220 +msgid "" +"Note that :meth:`SetReparseDeferralEnabled` has been backported to some " +"prior releases of CPython as a security fix. Check for availability of :" +"meth:`SetReparseDeferralEnabled` using :func:`hasattr` if used in code " +"running across a variety of Python versions." +msgstr "" + +#: library/pyexpat.rst:229 +msgid "" +"Returns whether reparse deferral is currently enabled for the given Expat " +"parser instance." +msgstr "" + +#: library/pyexpat.rst:235 msgid ":class:`xmlparser` objects have the following attributes:" msgstr "" -#: library/pyexpat.rst:204 +#: library/pyexpat.rst:240 msgid "" "The size of the buffer used when :attr:`buffer_text` is true. A new buffer " "size can be set by assigning a new integer value to this attribute. When the " "size is changed, the buffer will be flushed." msgstr "" -#: library/pyexpat.rst:212 +#: library/pyexpat.rst:248 msgid "" "Setting this to true causes the :class:`xmlparser` object to buffer textual " "content returned by Expat to avoid multiple calls to the :meth:" @@ -234,14 +270,14 @@ msgid "" "newlines may be chunked too." msgstr "" -#: library/pyexpat.rst:223 +#: library/pyexpat.rst:259 msgid "" "If :attr:`buffer_text` is enabled, the number of bytes stored in the buffer. " "These bytes represent UTF-8 encoded text. This attribute has no meaningful " "interpretation when :attr:`buffer_text` is false." msgstr "" -#: library/pyexpat.rst:230 +#: library/pyexpat.rst:266 msgid "" "Setting this attribute to a non-zero integer causes the attributes to be " "reported as a list rather than a dictionary. The attributes are presented " @@ -251,7 +287,7 @@ msgid "" "is false; it may be changed at any time." msgstr "" -#: library/pyexpat.rst:240 +#: library/pyexpat.rst:276 msgid "" "If set to a non-zero integer, the parser will report only those attributes " "which were specified in the document instance and not those which were " @@ -262,7 +298,7 @@ msgid "" "time." msgstr "" -#: library/pyexpat.rst:248 +#: library/pyexpat.rst:284 msgid "" "The following attributes contain values relating to the most recent error " "encountered by an :class:`xmlparser` object, and will only have correct " @@ -270,26 +306,26 @@ msgid "" "`xml.parsers.expat.ExpatError` exception." msgstr "" -#: library/pyexpat.rst:256 +#: library/pyexpat.rst:292 msgid "Byte index at which an error occurred." msgstr "" -#: library/pyexpat.rst:261 +#: library/pyexpat.rst:297 msgid "" "Numeric code specifying the problem. This value can be passed to the :func:" "`ErrorString` function, or compared to one of the constants defined in the " "``errors`` object." msgstr "" -#: library/pyexpat.rst:268 +#: library/pyexpat.rst:304 msgid "Column number at which an error occurred." msgstr "" -#: library/pyexpat.rst:273 +#: library/pyexpat.rst:309 msgid "Line number at which an error occurred." msgstr "" -#: library/pyexpat.rst:275 +#: library/pyexpat.rst:311 msgid "" "The following attributes contain values relating to the current parse " "location in an :class:`xmlparser` object. During a callback reporting a " @@ -299,19 +335,19 @@ msgid "" "whether there was an associated callback)." msgstr "" -#: library/pyexpat.rst:285 +#: library/pyexpat.rst:321 msgid "Current byte index in the parser input." msgstr "" -#: library/pyexpat.rst:290 +#: library/pyexpat.rst:326 msgid "Current column number in the parser input." msgstr "" -#: library/pyexpat.rst:295 +#: library/pyexpat.rst:331 msgid "Current line number in the parser input." msgstr "" -#: library/pyexpat.rst:297 +#: library/pyexpat.rst:333 msgid "" "Here is the list of handlers that can be set. To set a handler on an :class:" "`xmlparser` object *o*, use ``o.handlername = func``. *handlername* must be " @@ -320,7 +356,7 @@ msgid "" "unless otherwise stated." msgstr "" -#: library/pyexpat.rst:306 +#: library/pyexpat.rst:342 msgid "" "Called when the XML declaration is parsed. The XML declaration is the " "(optional) declaration of the applicable version of the XML recommendation, " @@ -331,7 +367,7 @@ msgid "" "only available with Expat version 1.95.0 or newer." msgstr "" -#: library/pyexpat.rst:317 +#: library/pyexpat.rst:353 msgid "" "Called when Expat begins parsing the document type declaration (``'``." msgstr "" -#: library/pyexpat.rst:434 +#: library/pyexpat.rst:470 msgid "" "Called at the start of a CDATA section. This and :attr:" "`EndCdataSectionHandler` are needed to be able to identify the syntactical " "start and end for CDATA sections." msgstr "" -#: library/pyexpat.rst:441 +#: library/pyexpat.rst:477 msgid "Called at the end of a CDATA section." msgstr "" -#: library/pyexpat.rst:446 +#: library/pyexpat.rst:482 msgid "" "Called for any characters in the XML document for which no applicable " "handler has been specified. This means characters that are part of a " @@ -465,14 +501,14 @@ msgid "" "supplied." msgstr "" -#: library/pyexpat.rst:453 +#: library/pyexpat.rst:489 msgid "" "This is the same as the :func:`DefaultHandler`, but doesn't inhibit " "expansion of internal entities. The entity reference will not be passed to " "the default handler." msgstr "" -#: library/pyexpat.rst:460 +#: library/pyexpat.rst:496 msgid "" "Called if the XML document hasn't been declared as being a standalone " "document. This happens when there is an external subset or a reference to a " @@ -482,7 +518,7 @@ msgid "" "set, no exception is raised by the parser for this condition." msgstr "" -#: library/pyexpat.rst:470 +#: library/pyexpat.rst:506 msgid "" "Called for references to external entities. *base* is the current base, as " "set by a previous call to :meth:`SetBase`. The public and system " @@ -491,7 +527,7 @@ msgid "" "is opaque and should only be used as described below." msgstr "" -#: library/pyexpat.rst:476 +#: library/pyexpat.rst:512 msgid "" "For external entities to be parsed, this handler must be implemented. It is " "responsible for creating the sub-parser using " @@ -501,130 +537,130 @@ msgid "" "`XML_ERROR_EXTERNAL_ENTITY_HANDLING` error, otherwise parsing will continue." msgstr "" -#: library/pyexpat.rst:484 +#: library/pyexpat.rst:520 msgid "" "If this handler is not provided, external entities are reported by the :attr:" "`DefaultHandler` callback, if provided." msgstr "" -#: library/pyexpat.rst:491 +#: library/pyexpat.rst:527 msgid "ExpatError Exceptions" msgstr "" -#: library/pyexpat.rst:496 +#: library/pyexpat.rst:532 msgid ":exc:`ExpatError` exceptions have a number of interesting attributes:" msgstr "" -#: library/pyexpat.rst:501 +#: library/pyexpat.rst:537 msgid "" "Expat's internal error number for the specific error. The :data:`errors." "messages ` dictionary maps these error " "numbers to Expat's error messages. For example::" msgstr "" -#: library/pyexpat.rst:513 +#: library/pyexpat.rst:549 msgid "" "The :mod:`~xml.parsers.expat.errors` module also provides error message " "constants and a dictionary :data:`~xml.parsers.expat.errors.codes` mapping " "these messages back to the error codes, see below." msgstr "" -#: library/pyexpat.rst:520 +#: library/pyexpat.rst:556 msgid "" "Line number on which the error was detected. The first line is numbered " "``1``." msgstr "" -#: library/pyexpat.rst:525 +#: library/pyexpat.rst:561 msgid "" "Character offset into the line where the error occurred. The first column " "is numbered ``0``." msgstr "" -#: library/pyexpat.rst:532 +#: library/pyexpat.rst:568 msgid "Example" msgstr "" -#: library/pyexpat.rst:534 +#: library/pyexpat.rst:570 msgid "" "The following program defines three handlers that just print out their " "arguments. ::" msgstr "" -#: library/pyexpat.rst:558 +#: library/pyexpat.rst:594 msgid "The output from this program is::" msgstr "" -#: library/pyexpat.rst:575 +#: library/pyexpat.rst:611 msgid "Content Model Descriptions" msgstr "" -#: library/pyexpat.rst:581 +#: library/pyexpat.rst:617 msgid "" "Content models are described using nested tuples. Each tuple contains four " "values: the type, the quantifier, the name, and a tuple of children. " "Children are simply additional content model descriptions." msgstr "" -#: library/pyexpat.rst:585 +#: library/pyexpat.rst:621 msgid "" "The values of the first two fields are constants defined in the :mod:`xml." "parsers.expat.model` module. These constants can be collected in two " "groups: the model type group and the quantifier group." msgstr "" -#: library/pyexpat.rst:589 +#: library/pyexpat.rst:625 msgid "The constants in the model type group are:" msgstr "" -#: library/pyexpat.rst:595 +#: library/pyexpat.rst:631 msgid "" "The element named by the model name was declared to have a content model of " "``ANY``." msgstr "" -#: library/pyexpat.rst:602 +#: library/pyexpat.rst:638 msgid "" "The named element allows a choice from a number of options; this is used for " "content models such as ``(A | B | C)``." msgstr "" -#: library/pyexpat.rst:609 +#: library/pyexpat.rst:645 msgid "Elements which are declared to be ``EMPTY`` have this model type." msgstr "" -#: library/pyexpat.rst:623 +#: library/pyexpat.rst:659 msgid "" "Models which represent a series of models which follow one after the other " "are indicated with this model type. This is used for models such as ``(A, " "B, C)``." msgstr "" -#: library/pyexpat.rst:626 +#: library/pyexpat.rst:662 msgid "The constants in the quantifier group are:" msgstr "" -#: library/pyexpat.rst:632 +#: library/pyexpat.rst:668 msgid "No modifier is given, so it can appear exactly once, as for ``A``." msgstr "" -#: library/pyexpat.rst:638 +#: library/pyexpat.rst:674 msgid "The model is optional: it can appear once or not at all, as for ``A?``." msgstr "" -#: library/pyexpat.rst:644 +#: library/pyexpat.rst:680 msgid "The model must occur one or more times (like ``A+``)." msgstr "" -#: library/pyexpat.rst:650 +#: library/pyexpat.rst:686 msgid "The model must occur zero or more times, as for ``A*``." msgstr "" -#: library/pyexpat.rst:656 +#: library/pyexpat.rst:692 msgid "Expat error constants" msgstr "" -#: library/pyexpat.rst:660 +#: library/pyexpat.rst:696 msgid "" "The following constants are provided in the :mod:`xml.parsers.expat.errors` " "module. These constants are useful in interpreting some of the attributes " @@ -635,205 +671,205 @@ msgid "" "XML_ERROR_{CONSTANT_NAME}]`." msgstr "" -#: library/pyexpat.rst:668 +#: library/pyexpat.rst:704 msgid "The ``errors`` module has the following attributes:" msgstr "" -#: library/pyexpat.rst:672 +#: library/pyexpat.rst:708 msgid "A dictionary mapping string descriptions to their error codes." msgstr "" -#: library/pyexpat.rst:679 +#: library/pyexpat.rst:715 msgid "A dictionary mapping numeric error codes to their string descriptions." msgstr "" -#: library/pyexpat.rst:689 +#: library/pyexpat.rst:725 msgid "" "An entity reference in an attribute value referred to an external entity " "instead of an internal entity." msgstr "" -#: library/pyexpat.rst:695 +#: library/pyexpat.rst:731 msgid "" "A character reference referred to a character which is illegal in XML (for " "example, character ``0``, or '``�``')." msgstr "" -#: library/pyexpat.rst:701 +#: library/pyexpat.rst:737 msgid "" "An entity reference referred to an entity which was declared with a " "notation, so cannot be parsed." msgstr "" -#: library/pyexpat.rst:707 +#: library/pyexpat.rst:743 msgid "An attribute was used more than once in a start tag." msgstr "" -#: library/pyexpat.rst:715 +#: library/pyexpat.rst:751 msgid "" "Raised when an input byte could not properly be assigned to a character; for " "example, a NUL byte (value ``0``) in a UTF-8 input stream." msgstr "" -#: library/pyexpat.rst:721 +#: library/pyexpat.rst:757 msgid "Something other than whitespace occurred after the document element." msgstr "" -#: library/pyexpat.rst:726 +#: library/pyexpat.rst:762 msgid "" "An XML declaration was found somewhere other than the start of the input " "data." msgstr "" -#: library/pyexpat.rst:731 +#: library/pyexpat.rst:767 msgid "" "The document contains no elements (XML requires all documents to contain " "exactly one top-level element).." msgstr "" -#: library/pyexpat.rst:737 +#: library/pyexpat.rst:773 msgid "Expat was not able to allocate memory internally." msgstr "" -#: library/pyexpat.rst:742 +#: library/pyexpat.rst:778 msgid "A parameter entity reference was found where it was not allowed." msgstr "" -#: library/pyexpat.rst:747 +#: library/pyexpat.rst:783 msgid "An incomplete character was found in the input." msgstr "" -#: library/pyexpat.rst:752 +#: library/pyexpat.rst:788 msgid "" "An entity reference contained another reference to the same entity; possibly " "via a different name, and possibly indirectly." msgstr "" -#: library/pyexpat.rst:758 +#: library/pyexpat.rst:794 msgid "Some unspecified syntax error was encountered." msgstr "" -#: library/pyexpat.rst:763 +#: library/pyexpat.rst:799 msgid "An end tag did not match the innermost open start tag." msgstr "" -#: library/pyexpat.rst:768 +#: library/pyexpat.rst:804 msgid "" "Some token (such as a start tag) was not closed before the end of the stream " "or the next token was encountered." msgstr "" -#: library/pyexpat.rst:774 +#: library/pyexpat.rst:810 msgid "A reference was made to an entity which was not defined." msgstr "" -#: library/pyexpat.rst:779 +#: library/pyexpat.rst:815 msgid "The document encoding is not supported by Expat." msgstr "" -#: library/pyexpat.rst:784 +#: library/pyexpat.rst:820 msgid "A CDATA marked section was not closed." msgstr "" -#: library/pyexpat.rst:792 +#: library/pyexpat.rst:828 msgid "" "The parser determined that the document was not \"standalone\" though it " "declared itself to be in the XML declaration, and the :attr:" "`NotStandaloneHandler` was set and returned ``0``." msgstr "" -#: library/pyexpat.rst:805 +#: library/pyexpat.rst:841 msgid "" "An operation was requested that requires DTD support to be compiled in, but " "Expat was configured without DTD support. This should never be reported by " "a standard build of the :mod:`xml.parsers.expat` module." msgstr "" -#: library/pyexpat.rst:812 +#: library/pyexpat.rst:848 msgid "" "A behavioral change was requested after parsing started that can only be " "changed before parsing has started. This is (currently) only raised by :" "meth:`UseForeignDTD`." msgstr "" -#: library/pyexpat.rst:819 +#: library/pyexpat.rst:855 msgid "An undeclared prefix was found when namespace processing was enabled." msgstr "" -#: library/pyexpat.rst:824 +#: library/pyexpat.rst:860 msgid "" "The document attempted to remove the namespace declaration associated with a " "prefix." msgstr "" -#: library/pyexpat.rst:830 +#: library/pyexpat.rst:866 msgid "A parameter entity contained incomplete markup." msgstr "" -#: library/pyexpat.rst:835 +#: library/pyexpat.rst:871 msgid "The document contained no document element at all." msgstr "" -#: library/pyexpat.rst:840 +#: library/pyexpat.rst:876 msgid "There was an error parsing a text declaration in an external entity." msgstr "" -#: library/pyexpat.rst:845 +#: library/pyexpat.rst:881 msgid "Characters were found in the public id that are not allowed." msgstr "" -#: library/pyexpat.rst:850 +#: library/pyexpat.rst:886 msgid "" "The requested operation was made on a suspended parser, but isn't allowed. " "This includes attempts to provide additional input or to stop the parser." msgstr "" -#: library/pyexpat.rst:856 +#: library/pyexpat.rst:892 msgid "" "An attempt to resume the parser was made when the parser had not been " "suspended." msgstr "" -#: library/pyexpat.rst:894 library/pyexpat.rst:899 +#: library/pyexpat.rst:930 library/pyexpat.rst:935 msgid "This should not be reported to Python applications." msgstr "" -#: library/pyexpat.rst:866 +#: library/pyexpat.rst:902 msgid "" "The requested operation was made on a parser which was finished parsing " "input, but isn't allowed. This includes attempts to provide additional " "input or to stop the parser." msgstr "" -#: library/pyexpat.rst:876 +#: library/pyexpat.rst:912 msgid "" "An attempt was made to undeclare reserved namespace prefix ``xml`` or to " "bind it to another namespace URI." msgstr "" -#: library/pyexpat.rst:883 +#: library/pyexpat.rst:919 msgid "" "An attempt was made to declare or undeclare reserved namespace prefix " "``xmlns``." msgstr "" -#: library/pyexpat.rst:888 +#: library/pyexpat.rst:924 msgid "" "An attempt was made to bind the URI of one the reserved namespace prefixes " "``xml`` and ``xmlns`` to another namespace prefix." msgstr "" -#: library/pyexpat.rst:904 +#: library/pyexpat.rst:940 msgid "" "The limit on input amplification factor (from DTD and entities) has been " "breached." msgstr "" -#: library/pyexpat.rst:909 +#: library/pyexpat.rst:945 msgid "Footnotes" msgstr "" -#: library/pyexpat.rst:910 +#: library/pyexpat.rst:946 msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See https://" diff --git a/library/resource.po b/library/resource.po index cff94d77f..4be06a27f 100644 --- a/library/resource.po +++ b/library/resource.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -221,58 +221,62 @@ msgstr "" msgid "The largest area of mapped memory which the process may occupy." msgstr "" -#: library/resource.rst:183 +#: library/resource.rst:268 +msgid ":ref:`Availability `: FreeBSD >= 11." +msgstr "" + +#: library/resource.rst:185 msgid "" "The maximum area (in bytes) of address space which may be taken by the " "process." msgstr "" -#: library/resource.rst:188 +#: library/resource.rst:190 msgid "The number of bytes that can be allocated for POSIX message queues." msgstr "" -#: library/resource.rst:227 +#: library/resource.rst:229 msgid ":ref:`Availability `: Linux >= 2.6.8." msgstr "" -#: library/resource.rst:197 +#: library/resource.rst:199 msgid "The ceiling for the process's nice level (calculated as 20 - rlim_cur)." msgstr "" -#: library/resource.rst:208 +#: library/resource.rst:210 msgid ":ref:`Availability `: Linux >= 2.6.12." msgstr "" -#: library/resource.rst:206 +#: library/resource.rst:208 msgid "The ceiling of the real-time priority." msgstr "" -#: library/resource.rst:215 +#: library/resource.rst:217 msgid "" "The time limit (in microseconds) on CPU time that a process can spend under " "real-time scheduling without making a blocking syscall." msgstr "" -#: library/resource.rst:218 +#: library/resource.rst:220 msgid ":ref:`Availability `: Linux >= 2.6.25." msgstr "" -#: library/resource.rst:225 +#: library/resource.rst:227 msgid "The number of signals which the process may queue." msgstr "" -#: library/resource.rst:233 +#: library/resource.rst:235 msgid "" "The maximum size (in bytes) of socket buffer usage for this user. This " "limits the amount of network memory, and hence the amount of mbufs, that " "this user may hold at any time." msgstr "" -#: library/resource.rst:250 library/resource.rst:258 +#: library/resource.rst:252 library/resource.rst:260 msgid ":ref:`Availability `: FreeBSD." msgstr "" -#: library/resource.rst:243 +#: library/resource.rst:245 msgid "" "The maximum size (in bytes) of the swap space that may be reserved or used " "by all of this user id's processes. This limit is enforced only if bit 1 of " @@ -281,27 +285,23 @@ msgid "" "this sysctl." msgstr "" -#: library/resource.rst:256 +#: library/resource.rst:258 msgid "The maximum number of pseudo-terminals created by this user id." msgstr "" -#: library/resource.rst:264 -msgid "The maximum number of kqueues this user id is allowed to create." -msgstr "" - #: library/resource.rst:266 -msgid ":ref:`Availability `: FreeBSD >= 11." +msgid "The maximum number of kqueues this user id is allowed to create." msgstr "" -#: library/resource.rst:271 +#: library/resource.rst:273 msgid "Resource Usage" msgstr "" -#: library/resource.rst:273 +#: library/resource.rst:275 msgid "These functions are used to retrieve resource usage information:" msgstr "" -#: library/resource.rst:278 +#: library/resource.rst:280 msgid "" "This function returns an object that describes the resources consumed by " "either the current process or its children, as specified by the *who* " @@ -309,11 +309,11 @@ msgid "" "`!RUSAGE_\\*` constants described below." msgstr "" -#: library/resource.rst:283 +#: library/resource.rst:285 msgid "A simple example::" msgstr "" -#: library/resource.rst:297 +#: library/resource.rst:299 msgid "" "The fields of the return value each describe how a particular system " "resource has been used, e.g. amount of time spent running is user mode or " @@ -322,13 +322,13 @@ msgid "" "is using." msgstr "" -#: library/resource.rst:302 +#: library/resource.rst:304 msgid "" "For backward compatibility, the return value is also accessible as a tuple " "of 16 elements." msgstr "" -#: library/resource.rst:305 +#: library/resource.rst:307 msgid "" "The fields :attr:`ru_utime` and :attr:`ru_stime` of the return value are " "floating point values representing the amount of time spent executing in " @@ -338,249 +338,249 @@ msgid "" "summary is presented here:" msgstr "" -#: library/resource.rst:312 +#: library/resource.rst:314 msgid "Index" msgstr "" -#: library/resource.rst:312 +#: library/resource.rst:314 msgid "Field" msgstr "" -#: library/resource.rst:312 +#: library/resource.rst:314 msgid "Resource" msgstr "" -#: library/resource.rst:314 +#: library/resource.rst:316 msgid "``0``" msgstr "" -#: library/resource.rst:314 +#: library/resource.rst:316 msgid ":attr:`ru_utime`" msgstr "" -#: library/resource.rst:314 +#: library/resource.rst:316 msgid "time in user mode (float seconds)" msgstr "" -#: library/resource.rst:316 +#: library/resource.rst:318 msgid "``1``" msgstr "" -#: library/resource.rst:316 +#: library/resource.rst:318 msgid ":attr:`ru_stime`" msgstr "" -#: library/resource.rst:316 +#: library/resource.rst:318 msgid "time in system mode (float seconds)" msgstr "" -#: library/resource.rst:318 +#: library/resource.rst:320 msgid "``2``" msgstr "" -#: library/resource.rst:318 +#: library/resource.rst:320 msgid ":attr:`ru_maxrss`" msgstr "" -#: library/resource.rst:318 +#: library/resource.rst:320 msgid "maximum resident set size" msgstr "" -#: library/resource.rst:320 +#: library/resource.rst:322 msgid "``3``" msgstr "" -#: library/resource.rst:320 +#: library/resource.rst:322 msgid ":attr:`ru_ixrss`" msgstr "" -#: library/resource.rst:320 +#: library/resource.rst:322 msgid "shared memory size" msgstr "" -#: library/resource.rst:322 +#: library/resource.rst:324 msgid "``4``" msgstr "" -#: library/resource.rst:322 +#: library/resource.rst:324 msgid ":attr:`ru_idrss`" msgstr "" -#: library/resource.rst:322 +#: library/resource.rst:324 msgid "unshared memory size" msgstr "" -#: library/resource.rst:324 +#: library/resource.rst:326 msgid "``5``" msgstr "" -#: library/resource.rst:324 +#: library/resource.rst:326 msgid ":attr:`ru_isrss`" msgstr "" -#: library/resource.rst:324 +#: library/resource.rst:326 msgid "unshared stack size" msgstr "" -#: library/resource.rst:326 +#: library/resource.rst:328 msgid "``6``" msgstr "" -#: library/resource.rst:326 +#: library/resource.rst:328 msgid ":attr:`ru_minflt`" msgstr "" -#: library/resource.rst:326 +#: library/resource.rst:328 msgid "page faults not requiring I/O" msgstr "" -#: library/resource.rst:328 +#: library/resource.rst:330 msgid "``7``" msgstr "" -#: library/resource.rst:328 +#: library/resource.rst:330 msgid ":attr:`ru_majflt`" msgstr "" -#: library/resource.rst:328 +#: library/resource.rst:330 msgid "page faults requiring I/O" msgstr "" -#: library/resource.rst:330 +#: library/resource.rst:332 msgid "``8``" msgstr "" -#: library/resource.rst:330 +#: library/resource.rst:332 msgid ":attr:`ru_nswap`" msgstr "" -#: library/resource.rst:330 +#: library/resource.rst:332 msgid "number of swap outs" msgstr "" -#: library/resource.rst:332 +#: library/resource.rst:334 msgid "``9``" msgstr "" -#: library/resource.rst:332 +#: library/resource.rst:334 msgid ":attr:`ru_inblock`" msgstr "" -#: library/resource.rst:332 +#: library/resource.rst:334 msgid "block input operations" msgstr "" -#: library/resource.rst:334 +#: library/resource.rst:336 msgid "``10``" msgstr "" -#: library/resource.rst:334 +#: library/resource.rst:336 msgid ":attr:`ru_oublock`" msgstr "" -#: library/resource.rst:334 +#: library/resource.rst:336 msgid "block output operations" msgstr "" -#: library/resource.rst:336 +#: library/resource.rst:338 msgid "``11``" msgstr "" -#: library/resource.rst:336 +#: library/resource.rst:338 msgid ":attr:`ru_msgsnd`" msgstr "" -#: library/resource.rst:336 +#: library/resource.rst:338 msgid "messages sent" msgstr "" -#: library/resource.rst:338 +#: library/resource.rst:340 msgid "``12``" msgstr "" -#: library/resource.rst:338 +#: library/resource.rst:340 msgid ":attr:`ru_msgrcv`" msgstr "" -#: library/resource.rst:338 +#: library/resource.rst:340 msgid "messages received" msgstr "" -#: library/resource.rst:340 +#: library/resource.rst:342 msgid "``13``" msgstr "" -#: library/resource.rst:340 +#: library/resource.rst:342 msgid ":attr:`ru_nsignals`" msgstr "" -#: library/resource.rst:340 +#: library/resource.rst:342 msgid "signals received" msgstr "" -#: library/resource.rst:342 +#: library/resource.rst:344 msgid "``14``" msgstr "" -#: library/resource.rst:342 +#: library/resource.rst:344 msgid ":attr:`ru_nvcsw`" msgstr "" -#: library/resource.rst:342 +#: library/resource.rst:344 msgid "voluntary context switches" msgstr "" -#: library/resource.rst:344 +#: library/resource.rst:346 msgid "``15``" msgstr "" -#: library/resource.rst:344 +#: library/resource.rst:346 msgid ":attr:`ru_nivcsw`" msgstr "" -#: library/resource.rst:344 +#: library/resource.rst:346 msgid "involuntary context switches" msgstr "" -#: library/resource.rst:347 +#: library/resource.rst:349 msgid "" "This function will raise a :exc:`ValueError` if an invalid *who* parameter " "is specified. It may also raise :exc:`error` exception in unusual " "circumstances." msgstr "" -#: library/resource.rst:353 +#: library/resource.rst:355 msgid "" "Returns the number of bytes in a system page. (This need not be the same as " "the hardware page size.)" msgstr "" -#: library/resource.rst:356 +#: library/resource.rst:358 msgid "" "The following :const:`!RUSAGE_\\*` symbols are passed to the :func:" "`getrusage` function to specify which processes information should be " "provided for." msgstr "" -#: library/resource.rst:362 +#: library/resource.rst:364 msgid "" "Pass to :func:`getrusage` to request resources consumed by the calling " "process, which is the sum of resources used by all threads in the process." msgstr "" -#: library/resource.rst:368 +#: library/resource.rst:370 msgid "" "Pass to :func:`getrusage` to request resources consumed by child processes " "of the calling process which have been terminated and waited for." msgstr "" -#: library/resource.rst:374 +#: library/resource.rst:376 msgid "" "Pass to :func:`getrusage` to request resources consumed by both the current " "process and child processes. May not be available on all systems." msgstr "" -#: library/resource.rst:380 +#: library/resource.rst:382 msgid "" "Pass to :func:`getrusage` to request resources consumed by the current " "thread. May not be available on all systems." diff --git a/library/ssl.po b/library/ssl.po index d23a78653..6181ca210 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-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -774,8 +774,8 @@ msgstr "" #: library/ssl.rst:740 msgid "" -"The option is deprecated since OpenSSL 1.1.0. It was added to 2.7.15, 3.6.3 " -"and 3.7.0 for backwards compatibility with OpenSSL 1.0.2." +"The option is deprecated since OpenSSL 1.1.0. It was added to 2.7.15 and " +"3.6.3 for backwards compatibility with OpenSSL 1.0.2." msgstr "" #: library/ssl.rst:746 diff --git a/library/statistics.po b/library/statistics.po index 5a8b4c38a..d4017625a 100644 --- a/library/statistics.po +++ b/library/statistics.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -132,7 +132,7 @@ msgid ":func:`median_grouped`" msgstr "" #: library/statistics.rst:82 -msgid "Median, or 50th percentile, of grouped data." +msgid "Median (50th percentile) of grouped data." msgstr "" #: library/statistics.rst:83 @@ -455,60 +455,63 @@ msgstr "" #: library/statistics.rst:334 msgid "" -"Return the median of grouped continuous data, calculated as the 50th " -"percentile, using interpolation. If *data* is empty, :exc:`StatisticsError` " -"is raised. *data* can be a sequence or iterable." +"Estimates the median for numeric data that has been `grouped or binned " +"`_ around the midpoints of " +"consecutive, fixed-width intervals." msgstr "" -#: library/statistics.rst:343 +#: library/statistics.rst:338 msgid "" -"In the following example, the data are rounded, so that each value " -"represents the midpoint of data classes, e.g. 1 is the midpoint of the class " -"0.5--1.5, 2 is the midpoint of 1.5--2.5, 3 is the midpoint of 2.5--3.5, " -"etc. With the data given, the middle value falls somewhere in the class " -"3.5--4.5, and interpolation is used to estimate it:" +"The *data* can be any iterable of numeric data with each value being exactly " +"the midpoint of a bin. At least one value must be present." msgstr "" -#: library/statistics.rst:354 +#: library/statistics.rst:341 +msgid "The *interval* is the width of each bin." +msgstr "" + +#: library/statistics.rst:343 msgid "" -"Optional argument *interval* represents the class interval, and defaults to " -"1. Changing the class interval naturally will change the interpolation:" +"For example, demographic information may have been summarized into " +"consecutive ten-year age groups with each group being represented by the 5-" +"year midpoints of the intervals:" msgstr "" -#: library/statistics.rst:364 +#: library/statistics.rst:359 msgid "" -"This function does not check whether the data points are at least *interval* " -"apart." +"The 50th percentile (median) is the 536th person out of the 1071 member " +"cohort. That person is in the 30 to 40 year old age group." msgstr "" -#: library/statistics.rst:369 +#: library/statistics.rst:362 msgid "" -"Under some circumstances, :func:`median_grouped` may coerce data points to " -"floats. This behaviour is likely to change in the future." +"The regular :func:`median` function would assume that everyone in the " +"tricenarian age group was exactly 35 years old. A more tenable assumption " +"is that the 484 members of that age group are evenly distributed between 30 " +"and 40. For that, we use :func:`median_grouped`:" msgstr "" -#: library/statistics.rst:374 +#: library/statistics.rst:376 msgid "" -"\"Statistics for the Behavioral Sciences\", Frederick J Gravetter and Larry " -"B Wallnau (8th Edition)." +"The caller is responsible for making sure the data points are separated by " +"exact multiples of *interval*. This is essential for getting a correct " +"result. The function does not check this precondition." msgstr "" -#: library/statistics.rst:377 +#: library/statistics.rst:380 msgid "" -"The `SSMEDIAN `_ function in the Gnome Gnumeric " -"spreadsheet, including `this discussion `_." +"Inputs may be any numeric type that can be coerced to a float during the " +"interpolation step." msgstr "" -#: library/statistics.rst:385 +#: library/statistics.rst:386 msgid "" "Return the single most common data point from discrete or nominal *data*. " "The mode (when it exists) is the most typical value and serves as a measure " "of central location." msgstr "" -#: library/statistics.rst:389 +#: library/statistics.rst:390 msgid "" "If there are multiple modes with the same frequency, returns the first one " "encountered in the *data*. If the smallest or largest of those is desired " @@ -516,38 +519,38 @@ msgid "" "input *data* is empty, :exc:`StatisticsError` is raised." msgstr "" -#: library/statistics.rst:394 +#: library/statistics.rst:395 msgid "" "``mode`` assumes discrete data and returns a single value. This is the " "standard treatment of the mode as commonly taught in schools:" msgstr "" -#: library/statistics.rst:402 +#: library/statistics.rst:403 msgid "" "The mode is unique in that it is the only statistic in this package that " "also applies to nominal (non-numeric) data:" msgstr "" -#: library/statistics.rst:410 +#: library/statistics.rst:411 msgid "" "Now handles multimodal datasets by returning the first mode encountered. " "Formerly, it raised :exc:`StatisticsError` when more than one mode was found." msgstr "" -#: library/statistics.rst:418 +#: library/statistics.rst:419 msgid "" "Return a list of the most frequently occurring values in the order they were " "first encountered in the *data*. Will return more than one result if there " "are multiple modes or an empty list if the *data* is empty:" msgstr "" -#: library/statistics.rst:434 +#: library/statistics.rst:435 msgid "" "Return the population standard deviation (the square root of the population " "variance). See :func:`pvariance` for arguments and other details." msgstr "" -#: library/statistics.rst:445 +#: library/statistics.rst:446 msgid "" "Return the population variance of *data*, a non-empty sequence or iterable " "of real-valued numbers. Variance, or second moment about the mean, is a " @@ -556,7 +559,7 @@ msgid "" "clustered closely around the mean." msgstr "" -#: library/statistics.rst:451 +#: library/statistics.rst:452 msgid "" "If the optional second argument *mu* is given, it is typically the mean of " "the *data*. It can also be used to compute the second moment around a point " @@ -564,39 +567,39 @@ msgid "" "arithmetic mean is automatically calculated." msgstr "" -#: library/statistics.rst:456 +#: library/statistics.rst:457 msgid "" "Use this function to calculate the variance from the entire population. To " "estimate the variance from a sample, the :func:`variance` function is " "usually a better choice." msgstr "" -#: library/statistics.rst:460 +#: library/statistics.rst:461 msgid "Raises :exc:`StatisticsError` if *data* is empty." msgstr "" -#: library/statistics.rst:532 library/statistics.rst:636 +#: library/statistics.rst:533 library/statistics.rst:637 msgid "Examples:" msgstr "" -#: library/statistics.rst:470 +#: library/statistics.rst:471 msgid "" "If you have already calculated the mean of your data, you can pass it as the " "optional second argument *mu* to avoid recalculation:" msgstr "" -#: library/statistics.rst:479 +#: library/statistics.rst:480 msgid "Decimals and Fractions are supported:" msgstr "" -#: library/statistics.rst:493 +#: library/statistics.rst:494 msgid "" "When called with the entire population, this gives the population variance " "σ². When called on a sample instead, this is the biased sample variance s², " "also known as variance with N degrees of freedom." msgstr "" -#: library/statistics.rst:497 +#: library/statistics.rst:498 msgid "" "If you somehow know the true population mean μ, you may use this function to " "calculate the variance of a sample, giving the known population mean as the " @@ -605,13 +608,13 @@ msgid "" "variance." msgstr "" -#: library/statistics.rst:506 +#: library/statistics.rst:507 msgid "" "Return the sample standard deviation (the square root of the sample " "variance). See :func:`variance` for arguments and other details." msgstr "" -#: library/statistics.rst:517 +#: library/statistics.rst:518 msgid "" "Return the sample variance of *data*, an iterable of at least two real-" "valued numbers. Variance, or second moment about the mean, is a measure of " @@ -620,41 +623,41 @@ msgid "" "closely around the mean." msgstr "" -#: library/statistics.rst:523 +#: library/statistics.rst:524 msgid "" "If the optional second argument *xbar* is given, it should be the mean of " "*data*. If it is missing or ``None`` (the default), the mean is " "automatically calculated." msgstr "" -#: library/statistics.rst:527 +#: library/statistics.rst:528 msgid "" "Use this function when your data is a sample from a population. To calculate " "the variance from the entire population, see :func:`pvariance`." msgstr "" -#: library/statistics.rst:530 +#: library/statistics.rst:531 msgid "Raises :exc:`StatisticsError` if *data* has fewer than two values." msgstr "" -#: library/statistics.rst:540 +#: library/statistics.rst:541 msgid "" "If you have already calculated the mean of your data, you can pass it as the " "optional second argument *xbar* to avoid recalculation:" msgstr "" -#: library/statistics.rst:549 +#: library/statistics.rst:550 msgid "" "This function does not attempt to verify that you have passed the actual " "mean as *xbar*. Using arbitrary values for *xbar* can lead to invalid or " "impossible results." msgstr "" -#: library/statistics.rst:553 +#: library/statistics.rst:554 msgid "Decimal and Fraction values are supported:" msgstr "" -#: library/statistics.rst:567 +#: library/statistics.rst:568 msgid "" "This is the sample variance s² with Bessel's correction, also known as " "variance with N-1 degrees of freedom. Provided that the data points are " @@ -662,20 +665,20 @@ msgid "" "should be an unbiased estimate of the true population variance." msgstr "" -#: library/statistics.rst:572 +#: library/statistics.rst:573 msgid "" "If you somehow know the actual population mean μ you should pass it to the :" "func:`pvariance` function as the *mu* parameter to get the variance of a " "sample." msgstr "" -#: library/statistics.rst:578 +#: library/statistics.rst:579 msgid "" "Divide *data* into *n* continuous intervals with equal probability. Returns " "a list of ``n - 1`` cut points separating the intervals." msgstr "" -#: library/statistics.rst:581 +#: library/statistics.rst:582 msgid "" "Set *n* to 4 for quartiles (the default). Set *n* to 10 for deciles. Set " "*n* to 100 for percentiles which gives the 99 cuts points that separate " @@ -683,28 +686,28 @@ msgid "" "not least 1." msgstr "" -#: library/statistics.rst:586 +#: library/statistics.rst:587 msgid "" "The *data* can be any iterable containing sample data. For meaningful " "results, the number of data points in *data* should be larger than *n*. " "Raises :exc:`StatisticsError` if there are not at least two data points." msgstr "" -#: library/statistics.rst:590 +#: library/statistics.rst:591 msgid "" "The cut points are linearly interpolated from the two nearest data points. " "For example, if a cut point falls one-third of the distance between two " "sample values, ``100`` and ``112``, the cut-point will evaluate to ``104``." msgstr "" -#: library/statistics.rst:595 +#: library/statistics.rst:596 msgid "" "The *method* for computing quantiles can be varied depending on whether the " "*data* includes or excludes the lowest and highest possible values from the " "population." msgstr "" -#: library/statistics.rst:599 +#: library/statistics.rst:600 msgid "" "The default *method* is \"exclusive\" and is used for data sampled from a " "population that can have more extreme values than found in the samples. The " @@ -714,7 +717,7 @@ msgid "" "70%, 80%, 90%." msgstr "" -#: library/statistics.rst:606 +#: library/statistics.rst:607 msgid "" "Setting the *method* to \"inclusive\" is used for describing population data " "or for samples that are known to include the most extreme values from the " @@ -726,19 +729,19 @@ msgid "" "80%, 90%, 100%." msgstr "" -#: library/statistics.rst:630 +#: library/statistics.rst:631 msgid "" "Return the sample covariance of two inputs *x* and *y*. Covariance is a " "measure of the joint variability of two inputs." msgstr "" -#: library/statistics.rst:633 +#: library/statistics.rst:634 msgid "" "Both inputs must be of the same length (no less than two), otherwise :exc:" "`StatisticsError` is raised." msgstr "" -#: library/statistics.rst:654 +#: library/statistics.rst:655 msgid "" "Return the `Pearson's correlation coefficient `_ for two inputs. Pearson's correlation " @@ -746,7 +749,7 @@ msgid "" "direction of a linear relationship." msgstr "" -#: library/statistics.rst:660 +#: library/statistics.rst:661 msgid "" "If *method* is \"ranked\", computes `Spearman's rank correlation coefficient " "`_ " @@ -755,30 +758,30 @@ msgid "" "strength of a monotonic relationship." msgstr "" -#: library/statistics.rst:666 +#: library/statistics.rst:667 msgid "" "Spearman's correlation coefficient is appropriate for ordinal data or for " "continuous data that doesn't meet the linear proportion requirement for " "Pearson's correlation coefficient." msgstr "" -#: library/statistics.rst:670 +#: library/statistics.rst:671 msgid "" "Both inputs must be of the same length (no less than two), and need not to " "be constant, otherwise :exc:`StatisticsError` is raised." msgstr "" -#: library/statistics.rst:673 +#: library/statistics.rst:674 msgid "" "Example with `Kepler's laws of planetary motion `_:" msgstr "" -#: library/statistics.rst:700 +#: library/statistics.rst:701 msgid "Added support for Spearman's rank correlation coefficient." msgstr "" -#: library/statistics.rst:705 +#: library/statistics.rst:706 msgid "" "Return the slope and intercept of `simple linear regression `_ parameters estimated using " @@ -787,11 +790,11 @@ msgid "" "this linear function:" msgstr "" -#: library/statistics.rst:711 +#: library/statistics.rst:712 msgid "*y = slope \\* x + intercept + noise*" msgstr "" -#: library/statistics.rst:713 +#: library/statistics.rst:714 msgid "" "where ``slope`` and ``intercept`` are the regression parameters that are " "estimated, and ``noise`` represents the variability of the data that was not " @@ -799,14 +802,14 @@ msgid "" "predicted and actual values of the dependent variable)." msgstr "" -#: library/statistics.rst:719 +#: library/statistics.rst:720 msgid "" "Both inputs must be of the same length (no less than two), and the " "independent variable *x* cannot be constant; otherwise a :exc:" "`StatisticsError` is raised." msgstr "" -#: library/statistics.rst:723 +#: library/statistics.rst:724 msgid "" "For example, we can use the `release dates of the Monty Python films " "`_ to predict the " @@ -814,7 +817,7 @@ msgid "" "2019 assuming that they had kept the pace." msgstr "" -#: library/statistics.rst:737 +#: library/statistics.rst:738 msgid "" "If *proportional* is true, the independent variable *x* and the dependent " "variable *y* are assumed to be directly proportional. The data is fit to a " @@ -822,38 +825,38 @@ msgid "" "the underlying linear function simplifies to:" msgstr "" -#: library/statistics.rst:743 +#: library/statistics.rst:744 msgid "*y = slope \\* x + noise*" msgstr "" -#: library/statistics.rst:745 +#: library/statistics.rst:746 msgid "" "Continuing the example from :func:`correlation`, we look to see how well a " "model based on major planets can predict the orbital distances for dwarf " "planets:" msgstr "" -#: library/statistics.rst:765 +#: library/statistics.rst:766 msgid "Added support for *proportional*." msgstr "" -#: library/statistics.rst:769 +#: library/statistics.rst:770 msgid "Exceptions" msgstr "" -#: library/statistics.rst:771 +#: library/statistics.rst:772 msgid "A single exception is defined:" msgstr "" -#: library/statistics.rst:775 +#: library/statistics.rst:776 msgid "Subclass of :exc:`ValueError` for statistics-related exceptions." msgstr "" -#: library/statistics.rst:779 +#: library/statistics.rst:780 msgid ":class:`NormalDist` objects" msgstr "" -#: library/statistics.rst:781 +#: library/statistics.rst:782 msgid "" ":class:`NormalDist` is a tool for creating and manipulating normal " "distributions of a `random variable `_ and have a wide range of " "applications in statistics." msgstr "" -#: library/statistics.rst:793 +#: library/statistics.rst:794 msgid "" "Returns a new *NormalDist* object where *mu* represents the `arithmetic mean " "`_ and *sigma* represents the " "`standard deviation `_." msgstr "" -#: library/statistics.rst:798 +#: library/statistics.rst:799 msgid "If *sigma* is negative, raises :exc:`StatisticsError`." msgstr "" -#: library/statistics.rst:802 +#: library/statistics.rst:803 msgid "" "A read-only property for the `arithmetic mean `_ of a normal distribution." msgstr "" -#: library/statistics.rst:808 +#: library/statistics.rst:809 msgid "" "A read-only property for the `median `_ of a normal distribution." msgstr "" -#: library/statistics.rst:814 +#: library/statistics.rst:815 msgid "" "A read-only property for the `mode `_ of a normal distribution." msgstr "" -#: library/statistics.rst:820 +#: library/statistics.rst:821 msgid "" "A read-only property for the `standard deviation `_ of a normal distribution." msgstr "" -#: library/statistics.rst:826 +#: library/statistics.rst:827 msgid "" "A read-only property for the `variance `_ of a normal distribution. Equal to the square of the standard " "deviation." msgstr "" -#: library/statistics.rst:832 +#: library/statistics.rst:833 msgid "" "Makes a normal distribution instance with *mu* and *sigma* parameters " "estimated from the *data* using :func:`fmean` and :func:`stdev`." msgstr "" -#: library/statistics.rst:835 +#: library/statistics.rst:836 msgid "" "The *data* can be any :term:`iterable` and should consist of values that can " "be converted to type :class:`float`. If *data* does not contain at least " @@ -925,20 +928,20 @@ msgid "" "dispersion." msgstr "" -#: library/statistics.rst:843 +#: library/statistics.rst:844 msgid "" "Generates *n* random samples for a given mean and standard deviation. " "Returns a :class:`list` of :class:`float` values." msgstr "" -#: library/statistics.rst:846 +#: library/statistics.rst:847 msgid "" "If *seed* is given, creates a new instance of the underlying random number " "generator. This is useful for creating reproducible results, even in a " "multi-threading context." msgstr "" -#: library/statistics.rst:852 +#: library/statistics.rst:853 msgid "" "Using a `probability density function (pdf) `_, compute the relative likelihood that a " @@ -946,7 +949,7 @@ msgid "" "the limit of the ratio ``P(x <= X < x+dx) / dx`` as *dx* approaches zero." msgstr "" -#: library/statistics.rst:858 +#: library/statistics.rst:859 msgid "" "The relative likelihood is computed as the probability of a sample occurring " "in a narrow range divided by the width of the range (hence the word " @@ -954,7 +957,7 @@ msgid "" "can be greater than ``1.0``." msgstr "" -#: library/statistics.rst:865 +#: library/statistics.rst:866 msgid "" "Using a `cumulative distribution function (cdf) `_, compute the probability that a " @@ -962,7 +965,7 @@ msgid "" "is written ``P(X <= x)``." msgstr "" -#: library/statistics.rst:872 +#: library/statistics.rst:873 msgid "" "Compute the inverse cumulative distribution function, also known as the " "`quantile function `_ or " @@ -971,34 +974,34 @@ msgid "" "function. Mathematically, it is written ``x : P(X <= x) = p``." msgstr "" -#: library/statistics.rst:878 +#: library/statistics.rst:879 msgid "" "Finds the value *x* of the random variable *X* such that the probability of " "the variable being less than or equal to that value equals the given " "probability *p*." msgstr "" -#: library/statistics.rst:884 +#: library/statistics.rst:885 msgid "" "Measures the agreement between two normal probability distributions. Returns " "a value between 0.0 and 1.0 giving `the overlapping area for the two " "probability density functions `_." msgstr "" -#: library/statistics.rst:891 +#: library/statistics.rst:892 msgid "" "Divide the normal distribution into *n* continuous intervals with equal " "probability. Returns a list of (n - 1) cut points separating the intervals." msgstr "" -#: library/statistics.rst:895 +#: library/statistics.rst:896 msgid "" "Set *n* to 4 for quartiles (the default). Set *n* to 10 for deciles. Set " "*n* to 100 for percentiles which gives the 99 cuts points that separate the " "normal distribution into 100 equal sized groups." msgstr "" -#: library/statistics.rst:901 +#: library/statistics.rst:902 msgid "" "Compute the `Standard Score `_ describing *x* in terms of the number of standard " @@ -1006,20 +1009,20 @@ msgid "" "mean) / stdev``." msgstr "" -#: library/statistics.rst:909 +#: library/statistics.rst:910 msgid "" "Instances of :class:`NormalDist` support addition, subtraction, " "multiplication and division by a constant. These operations are used for " "translation and scaling. For example:" msgstr "" -#: library/statistics.rst:919 +#: library/statistics.rst:920 msgid "" "Dividing a constant by an instance of :class:`NormalDist` is not supported " "because the result wouldn't be normally distributed." msgstr "" -#: library/statistics.rst:922 +#: library/statistics.rst:923 msgid "" "Since normal distributions arise from additive effects of independent " "variables, it is possible to `add and subtract two independent normally " @@ -1028,19 +1031,19 @@ msgid "" "class:`NormalDist`. For example:" msgstr "" -#: library/statistics.rst:942 -msgid ":class:`NormalDist` Examples and Recipes" +#: library/statistics.rst:943 +msgid "Examples and Recipes" msgstr "" -#: library/statistics.rst:946 +#: library/statistics.rst:947 msgid "Classic probability problems" msgstr "" -#: library/statistics.rst:948 +#: library/statistics.rst:949 msgid ":class:`NormalDist` readily solves classic probability problems." msgstr "" -#: library/statistics.rst:950 +#: library/statistics.rst:951 msgid "" "For example, given `historical data for SAT exams `_ showing that scores are " @@ -1049,35 +1052,35 @@ msgid "" "after rounding to the nearest whole number:" msgstr "" -#: library/statistics.rst:963 +#: library/statistics.rst:964 msgid "" "Find the `quartiles `_ and `deciles " "`_ for the SAT scores:" msgstr "" -#: library/statistics.rst:975 +#: library/statistics.rst:976 msgid "Monte Carlo inputs for simulations" msgstr "" -#: library/statistics.rst:977 +#: library/statistics.rst:978 msgid "" -"To estimate the distribution for a model than isn't easy to solve " +"To estimate the distribution for a model that isn't easy to solve " "analytically, :class:`NormalDist` can generate input samples for a `Monte " "Carlo simulation `_:" msgstr "" -#: library/statistics.rst:994 +#: library/statistics.rst:995 msgid "Approximating binomial distributions" msgstr "" -#: library/statistics.rst:996 +#: library/statistics.rst:997 msgid "" "Normal distributions can be used to approximate `Binomial distributions " "`_ when the sample " "size is large and when the probability of a successful trial is near 50%." msgstr "" -#: library/statistics.rst:1001 +#: library/statistics.rst:1002 msgid "" "For example, an open source conference has 750 attendees and two rooms with " "a 500 person capacity. There is a talk about Python and another about Ruby. " @@ -1086,15 +1089,15 @@ msgid "" "probability that the Python room will stay within its capacity limits?" msgstr "" -#: library/statistics.rst:1032 +#: library/statistics.rst:1033 msgid "Naive bayesian classifier" msgstr "" -#: library/statistics.rst:1034 +#: library/statistics.rst:1035 msgid "Normal distributions commonly arise in machine learning problems." msgstr "" -#: library/statistics.rst:1036 +#: library/statistics.rst:1037 msgid "" "Wikipedia has a `nice example of a Naive Bayesian Classifier `_. The " @@ -1102,20 +1105,20 @@ msgid "" "distributed features including height, weight, and foot size." msgstr "" -#: library/statistics.rst:1041 +#: library/statistics.rst:1042 msgid "" "We're given a training dataset with measurements for eight people. The " "measurements are assumed to be normally distributed, so we summarize the " "data with :class:`NormalDist`:" msgstr "" -#: library/statistics.rst:1054 +#: library/statistics.rst:1055 msgid "" "Next, we encounter a new person whose feature measurements are known but " "whose gender is unknown:" msgstr "" -#: library/statistics.rst:1063 +#: library/statistics.rst:1064 msgid "" "Starting with a 50% `prior probability `_ of being male or female, we compute the posterior as " @@ -1123,24 +1126,24 @@ msgid "" "given the gender:" msgstr "" -#: library/statistics.rst:1078 +#: library/statistics.rst:1079 msgid "" "The final prediction goes to the largest posterior. This is known as the " "`maximum a posteriori `_ or MAP:" msgstr "" -#: library/statistics.rst:1089 +#: library/statistics.rst:1090 msgid "Kernel density estimation" msgstr "" -#: library/statistics.rst:1091 +#: library/statistics.rst:1092 msgid "" "It is possible to estimate a continuous probability density function from a " "fixed number of discrete samples." msgstr "" -#: library/statistics.rst:1094 +#: library/statistics.rst:1095 msgid "" "The basic idea is to smooth the data using `a kernel function such as a " "normal distribution, triangular distribution, or uniform distribution " @@ -1150,7 +1153,7 @@ msgid "" "*bandwidth*." msgstr "" -#: library/statistics.rst:1111 +#: library/statistics.rst:1112 msgid "" "`Wikipedia has an example `_ where we can use the ``kde_normal()`` " @@ -1158,7 +1161,7 @@ msgid "" "small sample:" msgstr "" -#: library/statistics.rst:1123 +#: library/statistics.rst:1124 msgid "The points in ``xarr`` and ``yarr`` can be used to make a PDF plot:" msgstr "" diff --git a/library/stdtypes.po b/library/stdtypes.po index 548988d2f..f68d0cd2c 100644 --- a/library/stdtypes.po +++ b/library/stdtypes.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: 2023-02-01 18:55-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -137,8 +137,8 @@ msgstr "İşlem" msgid "Result" msgstr "Sonuç" -#: library/stdtypes.rst:276 library/stdtypes.rst:965 library/stdtypes.rst:2420 -#: library/stdtypes.rst:3638 +#: library/stdtypes.rst:276 library/stdtypes.rst:965 library/stdtypes.rst:2419 +#: library/stdtypes.rst:3637 msgid "Notes" msgstr "Notlar" @@ -150,7 +150,7 @@ msgstr "``x or y``" msgid "if *x* is true, then *x*, else *y*" msgstr "*x* doğruysa, *x*, aksi halde *y*" -#: library/stdtypes.rst:967 library/stdtypes.rst:1181 library/stdtypes.rst:3644 +#: library/stdtypes.rst:967 library/stdtypes.rst:1181 library/stdtypes.rst:3643 msgid "\\(1)" msgstr "\\(1)" @@ -162,8 +162,8 @@ msgstr "``x and y``" msgid "if *x* is false, then *x*, else *y*" msgstr "*x* yanlışsa, *x*, aksi halde *y*" -#: library/stdtypes.rst:289 library/stdtypes.rst:1209 library/stdtypes.rst:2432 -#: library/stdtypes.rst:3650 +#: library/stdtypes.rst:289 library/stdtypes.rst:1209 library/stdtypes.rst:2431 +#: library/stdtypes.rst:3649 msgid "\\(2)" msgstr "\\(2)" @@ -175,14 +175,14 @@ msgstr "``not x``" msgid "if *x* is false, then ``True``, else ``False``" msgstr "*x* yanlışsa, ``True``, aksi halde ``False``" -#: library/stdtypes.rst:979 library/stdtypes.rst:2434 library/stdtypes.rst:2438 -#: library/stdtypes.rst:3652 library/stdtypes.rst:3656 -#: library/stdtypes.rst:3658 +#: library/stdtypes.rst:979 library/stdtypes.rst:2433 library/stdtypes.rst:2437 +#: library/stdtypes.rst:3651 library/stdtypes.rst:3655 +#: library/stdtypes.rst:3657 msgid "\\(3)" msgstr "\\(3)" -#: library/stdtypes.rst:320 library/stdtypes.rst:1016 library/stdtypes.rst:2466 -#: library/stdtypes.rst:3688 +#: library/stdtypes.rst:320 library/stdtypes.rst:1016 library/stdtypes.rst:2465 +#: library/stdtypes.rst:3687 msgid "Notes:" msgstr "Notlar:" @@ -233,8 +233,8 @@ msgstr "" msgid "This table summarizes the comparison operations:" msgstr "Bu tablo karşılaştırma operatörlerini özetlemektedir:" -#: library/stdtypes.rst:2397 library/stdtypes.rst:3615 -#: library/stdtypes.rst:3638 +#: library/stdtypes.rst:2396 library/stdtypes.rst:3614 +#: library/stdtypes.rst:3637 msgid "Meaning" msgstr "Anlamı" @@ -572,7 +572,7 @@ msgstr "" "gerçek kısmı *re*, sanal kısmı *im* olan bir karmaşık sayı. *im* varsayılan " "olarak sıfırdır." -#: library/stdtypes.rst:1202 library/stdtypes.rst:3675 +#: library/stdtypes.rst:1202 library/stdtypes.rst:3674 msgid "\\(6)" msgstr "\\(6)" @@ -608,8 +608,8 @@ msgstr "``pow(x, y)``" msgid "*x* to the power *y*" msgstr "*x* üzeri *y*" -#: library/stdtypes.rst:313 library/stdtypes.rst:1194 library/stdtypes.rst:2456 -#: library/stdtypes.rst:3671 library/stdtypes.rst:3678 +#: library/stdtypes.rst:313 library/stdtypes.rst:1194 library/stdtypes.rst:2455 +#: library/stdtypes.rst:3670 library/stdtypes.rst:3677 msgid "\\(5)" msgstr "\\(5)" @@ -782,8 +782,8 @@ msgstr "``x | y``" msgid "bitwise :dfn:`or` of *x* and *y*" msgstr "bit düzeyinde *x* :dfn:`or` *y*" -#: library/stdtypes.rst:421 library/stdtypes.rst:1215 library/stdtypes.rst:2446 -#: library/stdtypes.rst:3664 +#: library/stdtypes.rst:421 library/stdtypes.rst:1215 library/stdtypes.rst:2445 +#: library/stdtypes.rst:3663 msgid "\\(4)" msgstr "\\(4)" @@ -1581,7 +1581,7 @@ msgstr "" "*x* 'in *s* içindeki ilk görüldüğü dizini (*i* dizininde veya sonrasında ve " "*j* dizininden önce)" -#: library/stdtypes.rst:3646 +#: library/stdtypes.rst:3645 msgid "\\(8)" msgstr "\\(8)" @@ -2420,13 +2420,14 @@ msgstr "" "'==' ve '!=' tanımlayın (nesne kimliğine göre karşılaştırmak yerine)." #: library/stdtypes.rst:1494 +#, fuzzy msgid "" -"The :attr:`~range.start`, :attr:`~range.stop` and :attr:`~range.step` " +"Added the :attr:`~range.start`, :attr:`~range.stop` and :attr:`~range.step` " "attributes." msgstr "" ":attr:`~range.start`, :attr:`~range.stop` ve :attr:`~range.step` özellikleri." -#: library/stdtypes.rst:1500 +#: library/stdtypes.rst:1499 #, fuzzy msgid "" "The `linspace recipe `_ shows " @@ -2437,11 +2438,11 @@ msgstr "" "nokta uygulamaları için uygun olan tembel bir aralığın nasıl uygulanacağını " "gösterir." -#: library/stdtypes.rst:1512 +#: library/stdtypes.rst:1511 msgid "Text Sequence Type --- :class:`str`" msgstr "Metin Sırası Türü --- :class:`str`" -#: library/stdtypes.rst:1514 +#: library/stdtypes.rst:1513 msgid "" "Textual data in Python is handled with :class:`str` objects, or :dfn:" "`strings`. Strings are immutable :ref:`sequences ` of Unicode code " @@ -2451,21 +2452,21 @@ msgstr "" "işlenir. Dizeler, Unicode kod noktalarının değişmez :ref:`dizgeleridir " "`. Dize değişmezleri çeşitli şekillerde yazılır:" -#: library/stdtypes.rst:1519 +#: library/stdtypes.rst:1518 msgid "Single quotes: ``'allows embedded \"double\" quotes'``" msgstr "Tek tırnak: ``'katıştırılmış \"çift\" tırnaklara izin verir'``" -#: library/stdtypes.rst:1520 +#: library/stdtypes.rst:1519 msgid "Double quotes: ``\"allows embedded 'single' quotes\"``" msgstr "Çift tırnak: ``\"katıştırılmış 'tek' tırnaklara izin verir\"``" -#: library/stdtypes.rst:1521 +#: library/stdtypes.rst:1520 msgid "" "Triple quoted: ``'''Three single quotes'''``, ``\"\"\"Three double " "quotes\"\"\"``" msgstr "Üçlü tırnak: ``'''Üç tek tırnak'''``, ``\"\"\"Üç çift tırnak\"\"\"``" -#: library/stdtypes.rst:1523 +#: library/stdtypes.rst:1522 msgid "" "Triple quoted strings may span multiple lines - all associated whitespace " "will be included in the string literal." @@ -2473,7 +2474,7 @@ msgstr "" "Üçlü tırnak içine alınmış dizeler birden çok satıra yayılabilir - ilişkili " "tüm boşluklar dize değişmezine dahil edilecektir." -#: library/stdtypes.rst:1526 +#: library/stdtypes.rst:1525 msgid "" "String literals that are part of a single expression and have only " "whitespace between them will be implicitly converted to a single string " @@ -2483,7 +2484,7 @@ msgstr "" "değişmezleri, örtük olarak tek bir dize değişmezine dönüştürülür. Yani, " "``(\"spam\" \"yumurtalar\") == \"spam yumurtalar\"``." -#: library/stdtypes.rst:1530 +#: library/stdtypes.rst:1529 #, fuzzy msgid "" "See :ref:`strings` for more about the various forms of string literal, " @@ -2495,7 +2496,7 @@ msgstr "" "değişmezinin çeşitli biçimleri hakkında daha fazla bilgi için bkz. :ref:" "`strings`." -#: library/stdtypes.rst:1534 +#: library/stdtypes.rst:1533 msgid "" "Strings may also be created from other objects using the :class:`str` " "constructor." @@ -2503,7 +2504,7 @@ msgstr "" "Dizeler, :class:`str` yapıcısı kullanılarak diğer nesnelerden de " "oluşturulabilir." -#: library/stdtypes.rst:1537 +#: library/stdtypes.rst:1536 msgid "" "Since there is no separate \"character\" type, indexing a string produces " "strings of length 1. That is, for a non-empty string *s*, ``s[0] == s[0:1]``." @@ -2512,7 +2513,7 @@ msgstr "" "uzunluğunda dizeler üretir. Yani, boş olmayan bir *s* dizesi için ``s[0] == " "s[0:1]``." -#: library/stdtypes.rst:1543 +#: library/stdtypes.rst:1542 msgid "" "There is also no mutable string type, but :meth:`str.join` or :class:`io." "StringIO` can be used to efficiently construct strings from multiple " @@ -2522,7 +2523,7 @@ msgstr "" "`io.StringIO` birden çok parçadan dizeleri verimli bir şekilde oluşturmak " "için kullanılabilir." -#: library/stdtypes.rst:1547 +#: library/stdtypes.rst:1546 msgid "" "For backwards compatibility with the Python 2 series, the ``u`` prefix is " "once again permitted on string literals. It has no effect on the meaning of " @@ -2532,7 +2533,7 @@ msgstr "" "ön ekine izin verilir. Bunun dize değişmezlerinin anlamı üzerinde hiçbir " "etkisi yoktur ve ``r`` ön ekiyle birleştirilemez." -#: library/stdtypes.rst:1559 +#: library/stdtypes.rst:1558 #, fuzzy msgid "" "Return a :ref:`string ` version of *object*. If *object* is not " @@ -2543,7 +2544,7 @@ msgstr "" "boş dizeyi döndürür. Aksi takdirde, ``str()`` davranışı, aşağıdaki gibi " "*kodlama* veya *hatalar* 'ın verilmesine bağlıdır." -#: library/stdtypes.rst:1563 +#: library/stdtypes.rst:1562 #, fuzzy msgid "" "If neither *encoding* nor *errors* is given, ``str(object)`` returns :meth:" @@ -2559,7 +2560,7 @@ msgstr "" "kendisidir. *object*'in bir :meth:`~object.__str__` metodu yoksa, :func:" "`str`, :meth:`repr(object) ` döndürmeye geri döner." -#: library/stdtypes.rst:1575 +#: library/stdtypes.rst:1574 msgid "" "If at least one of *encoding* or *errors* is given, *object* should be a :" "term:`bytes-like object` (e.g. :class:`bytes` or :class:`bytearray`). In " @@ -2579,7 +2580,7 @@ msgstr "" "elde edilir. Arabellek nesneleri hakkında bilgi için bkz. :ref:`binaryseq` " "ve :ref:`bufferobjects`." -#: library/stdtypes.rst:1584 +#: library/stdtypes.rst:1583 msgid "" "Passing a :class:`bytes` object to :func:`str` without the *encoding* or " "*errors* arguments falls under the first case of returning the informal " @@ -2591,7 +2592,7 @@ msgstr "" "girer (ayrıca bkz. Python için :option:`-b` komut satırı seçeneği). " "Örneğin::" -#: library/stdtypes.rst:1592 +#: library/stdtypes.rst:1591 msgid "" "For more information on the ``str`` class and its methods, see :ref:" "`textseq` and the :ref:`string-methods` section below. To output formatted " @@ -2603,11 +2604,11 @@ msgstr "" "dizelerin çıktısını almak için :ref:`f-strings` ve :ref:`formatstrings` " "bölümlerine bakın. Ayrıca, :ref:`stringservices` bölümüne de bakın." -#: library/stdtypes.rst:1604 +#: library/stdtypes.rst:1603 msgid "String Methods" msgstr "String (Dize) Metotları" -#: library/stdtypes.rst:1609 +#: library/stdtypes.rst:1608 msgid "" "Strings implement all of the :ref:`common ` sequence " "operations, along with the additional methods described below." @@ -2615,7 +2616,7 @@ msgstr "" "Dizeler, aşağıda açıklanan ek yöntemlerle birlikte tüm :ref:`ortak ` dizi işlemlerini uygular." -#: library/stdtypes.rst:1612 +#: library/stdtypes.rst:1611 #, fuzzy msgid "" "Strings also support two styles of string formatting, one providing a large " @@ -2632,7 +2633,7 @@ msgstr "" "stilini destekler, ancak genellikle işleyebileceği durumlar için daha " "hızlıdır (:ref:`old-string-formatting`)." -#: library/stdtypes.rst:1619 +#: library/stdtypes.rst:1618 msgid "" "The :ref:`textservices` section of the standard library covers a number of " "other modules that provide various text related utilities (including regular " @@ -2642,7 +2643,7 @@ msgstr "" "yardımcı programlar sağlayan bir dizi başka modülü kapsar (:mod:`re` " "modülündeki normal ifade desteği dahil)." -#: library/stdtypes.rst:1625 +#: library/stdtypes.rst:1624 msgid "" "Return a copy of the string with its first character capitalized and the " "rest lowercased." @@ -2650,7 +2651,7 @@ msgstr "" "İlk karakteri büyük ve geri kalanı küçük harf ile, dizenin bir kopyasını " "döndürür." -#: library/stdtypes.rst:1628 +#: library/stdtypes.rst:1627 #, fuzzy msgid "" "The first character is now put into titlecase rather than uppercase. This " @@ -2661,7 +2662,7 @@ msgstr "" "digraf gibi karakterlerin, sadece ilk harflerinin büyütüleceği anlamına " "gelir." -#: library/stdtypes.rst:1635 +#: library/stdtypes.rst:1634 msgid "" "Return a casefolded copy of the string. Casefolded strings may be used for " "caseless matching." @@ -2669,7 +2670,7 @@ msgstr "" "Dizenin küçük harfe katlanmış bir kopyasını döndürür. Küçük harfe katlanmış " "dizeler, büyük/küçük harfsiz eşleştirme için kullanılabilir." -#: library/stdtypes.rst:1638 +#: library/stdtypes.rst:1637 msgid "" "Casefolding is similar to lowercasing but more aggressive because it is " "intended to remove all case distinctions in a string. For example, the " @@ -2683,7 +2684,7 @@ msgstr "" "Zaten küçük harf olduğundan, :meth:`lower` ``'ß'`` için hiçbir şey yapmaz; :" "meth:`casefold` onu ``\"ss\"`` biçimine dönüştürür." -#: library/stdtypes.rst:1644 +#: library/stdtypes.rst:1643 #, fuzzy msgid "" "The casefolding algorithm is `described in section 3.13 'Default Case " @@ -2692,7 +2693,7 @@ msgid "" msgstr "" "Casefolding algoritması, Unicode Standardının 3.13 bölümünde açıklanmıştır." -#: library/stdtypes.rst:1653 +#: library/stdtypes.rst:1652 msgid "" "Return centered in a string of length *width*. Padding is done using the " "specified *fillchar* (default is an ASCII space). The original string is " @@ -2703,7 +2704,7 @@ msgstr "" "boşluğudur). *width*, ``len(s)`` değerinden küçük veya ona eşitse orijinal " "dize döndürülür." -#: library/stdtypes.rst:1661 +#: library/stdtypes.rst:1660 msgid "" "Return the number of non-overlapping occurrences of substring *sub* in the " "range [*start*, *end*]. Optional arguments *start* and *end* are " @@ -2713,23 +2714,23 @@ msgstr "" "sayısını döndürür. İsteğe bağlı bağımsız değişkenler *start* ve *end*, dilim " "notasyonunda olduğu gibi yorumlanır." -#: library/stdtypes.rst:1665 +#: library/stdtypes.rst:1664 msgid "" "If *sub* is empty, returns the number of empty strings between characters " "which is the length of the string plus one." msgstr "" -#: library/stdtypes.rst:1671 +#: library/stdtypes.rst:1670 msgid "Return the string encoded to :class:`bytes`." msgstr "" -#: library/stdtypes.rst:2812 +#: library/stdtypes.rst:2811 msgid "" "*encoding* defaults to ``'utf-8'``; see :ref:`standard-encodings` for " "possible values." msgstr "" -#: library/stdtypes.rst:1676 +#: library/stdtypes.rst:1675 msgid "" "*errors* controls how encoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " @@ -2744,18 +2745,18 @@ msgstr "" "register_error` ile kaydedilen diğer isimlerdir. Ayrıntılar için :ref:`error-" "handlers` bölümüne bakınız." -#: library/stdtypes.rst:1683 +#: library/stdtypes.rst:1682 msgid "" "For performance reasons, the value of *errors* is not checked for validity " "unless an encoding error actually occurs, :ref:`devmode` is enabled or a :" "ref:`debug build ` is used." msgstr "" -#: library/stdtypes.rst:2831 +#: library/stdtypes.rst:2830 msgid "Added support for keyword arguments." msgstr "" -#: library/stdtypes.rst:2834 +#: library/stdtypes.rst:2833 msgid "" "The value of the *errors* argument is now checked in :ref:`devmode` and in :" "ref:`debug mode `." @@ -2763,7 +2764,7 @@ msgstr "" "*errors* şimdi :ref:`devmode` ve :ref:`hata ayıklama modunda ` " "kontrol edilir." -#: library/stdtypes.rst:1698 +#: library/stdtypes.rst:1697 msgid "" "Return ``True`` if the string ends with the specified *suffix*, otherwise " "return ``False``. *suffix* can also be a tuple of suffixes to look for. " @@ -2775,7 +2776,7 @@ msgstr "" "bağlı *start* ile, o konumdan başlayarak test edin. İsteğe bağlı *end* ile, " "o konumda karşılaştırmayı bırakın." -#: library/stdtypes.rst:1706 +#: library/stdtypes.rst:1705 msgid "" "Return a copy of the string where all tab characters are replaced by one or " "more spaces, depending on the current column and the given tab size. Tab " @@ -2802,7 +2803,7 @@ msgstr "" "karakter değiştirilmeden kopyalanır ve mevcut sütun, karakterin " "yazdırıldığında nasıl temsil edildiğine bakılmaksızın bir artırılır." -#: library/stdtypes.rst:1727 +#: library/stdtypes.rst:1726 msgid "" "Return the lowest index in the string where substring *sub* is found within " "the slice ``s[start:end]``. Optional arguments *start* and *end* are " @@ -2812,7 +2813,7 @@ msgstr "" "dizini döndür. İsteğe bağlı argümanlar *start* ve *end*, dilim notasyonunda " "olduğu gibi yorumlanır. *sub* bulunamazsa ``-1`` döndürür." -#: library/stdtypes.rst:1733 +#: library/stdtypes.rst:1732 msgid "" "The :meth:`~str.find` method should be used only if you need to know the " "position of *sub*. To check if *sub* is a substring or not, use the :" @@ -2822,7 +2823,7 @@ msgstr "" "gerekiyorsa kullanılmalıdır. *sub* 'ın bir alt dize olup olmadığını kontrol " "etmek için :keyword:`in` operatörünü kullanın::" -#: library/stdtypes.rst:1743 +#: library/stdtypes.rst:1742 msgid "" "Perform a string formatting operation. The string on which this method is " "called can contain literal text or replacement fields delimited by braces " @@ -2838,7 +2839,7 @@ msgstr "" "değiştirme alanının, karşılık gelen argümanın dize değeriyle değiştirildiği " "dizenin bir kopyasını döndürür." -#: library/stdtypes.rst:1753 +#: library/stdtypes.rst:1752 msgid "" "See :ref:`formatstrings` for a description of the various formatting options " "that can be specified in format strings." @@ -2846,7 +2847,7 @@ msgstr "" "Biçim dizelerinde (f string) belirtilebilecek çeşitli biçimlendirme " "seçeneklerinin açıklaması için bkz. :ref:`formatstrings`." -#: library/stdtypes.rst:1757 +#: library/stdtypes.rst:1756 msgid "" "When formatting a number (:class:`int`, :class:`float`, :class:`complex`, :" "class:`decimal.Decimal` and subclasses) with the ``n`` type (ex: ``'{:n}'." @@ -2864,7 +2865,7 @@ msgstr "" "için ``LC_CTYPE`` yerel ayarını geçici olarak ``LC_NUMERIC`` yerel ayarına " "ayarlar. Bu geçici değişiklik diğer iş parçacıklarını etkiler." -#: library/stdtypes.rst:1766 +#: library/stdtypes.rst:1765 msgid "" "When formatting a number with the ``n`` type, the function sets temporarily " "the ``LC_CTYPE`` locale to the ``LC_NUMERIC`` locale in some cases." @@ -2873,7 +2874,7 @@ msgstr "" "``LC_CTYPE`` yerel ayarını geçici olarak ``LC_NUMERIC`` yerel ayarına " "ayarlar." -#: library/stdtypes.rst:1774 +#: library/stdtypes.rst:1773 msgid "" "Similar to ``str.format(**mapping)``, except that ``mapping`` is used " "directly and not copied to a :class:`dict`. This is useful if for example " @@ -2883,7 +2884,7 @@ msgstr "" "kullanılır ve bir :class:`dict` 'e kopyalanmaz. Örneğin, ``mapping`` bir " "dict alt sınıfı ise bu kullanışlıdır:" -#: library/stdtypes.rst:1790 +#: library/stdtypes.rst:1789 msgid "" "Like :meth:`~str.find`, but raise :exc:`ValueError` when the substring is " "not found." @@ -2891,7 +2892,7 @@ msgstr "" ":meth:`~str.find` gibi, ancak alt dize bulunamadığında :exc:`ValueError` " "yükseltir." -#: library/stdtypes.rst:1796 +#: library/stdtypes.rst:1795 msgid "" "Return ``True`` if all characters in the string are alphanumeric and there " "is at least one character, ``False`` otherwise. A character ``c`` is " @@ -2903,7 +2904,7 @@ msgstr "" "``True`` döndürüyorsa alfasayısaldır: ``c.isalpha()``, ``c.isdecimal()``, " "``c.isdigit()`` veya ``c.isnumeric()``." -#: library/stdtypes.rst:1804 +#: library/stdtypes.rst:1803 #, fuzzy msgid "" "Return ``True`` if all characters in the string are alphabetic and there is " @@ -2922,7 +2923,7 @@ msgstr "" "karakterlerdir. Bunun Unicode Standardında tanımlanan \"Alfabetik\" " "özelliğinden farklı olduğunu unutmayın." -#: library/stdtypes.rst:1815 +#: library/stdtypes.rst:1814 msgid "" "Return ``True`` if the string is empty or all characters in the string are " "ASCII, ``False`` otherwise. ASCII characters have code points in the range " @@ -2932,7 +2933,7 @@ msgstr "" "``False`` döndürür. ASCII karakterleri U+0000-U+007F aralığında kod " "noktalarına sahiptir." -#: library/stdtypes.rst:1824 +#: library/stdtypes.rst:1823 msgid "" "Return ``True`` if all characters in the string are decimal characters and " "there is at least one character, ``False`` otherwise. Decimal characters are " @@ -2946,7 +2947,7 @@ msgstr "" "ARAPÇA-HİNTÇE RAKAM SIFIR. Resmi olarak bir ondalık karakter Unicode Genel " "Kategorisi \"Nd\" içerisindeki bir karakterdir." -#: library/stdtypes.rst:1834 +#: library/stdtypes.rst:1833 msgid "" "Return ``True`` if all characters in the string are digits and there is at " "least one character, ``False`` otherwise. Digits include decimal characters " @@ -2962,7 +2963,7 @@ msgstr "" "rakamları kapsar. Resmi olarak rakam, Numeric_Type=Digit veya " "Numeric_Type=Decimal özellik değerine sahip bir karakterdir." -#: library/stdtypes.rst:1844 +#: library/stdtypes.rst:1843 msgid "" "Return ``True`` if the string is a valid identifier according to the " "language definition, section :ref:`identifiers`." @@ -2970,7 +2971,7 @@ msgstr "" ":ref:`identifiers` bölümüne göre dizge dil tanımına göre geçerli bir " "tanımlayıcı ise ``True`` döndürür." -#: library/stdtypes.rst:1847 +#: library/stdtypes.rst:1846 #, fuzzy msgid "" ":func:`keyword.iskeyword` can be used to test whether string ``s`` is a " @@ -2979,11 +2980,11 @@ msgstr "" ":func:`keyword.iskeyword` çağrısı yaparak ``s`` dizesinin :keyword:`def` ve :" "keyword:`class` gibi ayrılmış bir tanımlayıcı olup olmadığını test eder." -#: library/stdtypes.rst:1850 +#: library/stdtypes.rst:1849 msgid "Example: ::" msgstr "Örnek: ::" -#: library/stdtypes.rst:1863 +#: library/stdtypes.rst:1862 msgid "" "Return ``True`` if all cased characters [4]_ in the string are lowercase and " "there is at least one cased character, ``False`` otherwise." @@ -2991,7 +2992,7 @@ msgstr "" "Dizedeki tüm büyük harfli karakterler [4]_ küçük harfli ise ve en az bir " "büyük harfli karakter varsa ``True``, aksi takdirde ``False`` döndürür." -#: library/stdtypes.rst:1869 +#: library/stdtypes.rst:1868 msgid "" "Return ``True`` if all characters in the string are numeric characters, and " "there is at least one character, ``False`` otherwise. Numeric characters " @@ -3007,7 +3008,7 @@ msgstr "" "karakterler Numeric_Type=Digit, Numeric_Type=Decimal veya " "Numeric_Type=Numeric özellik değerine sahip karakterlerdir." -#: library/stdtypes.rst:1879 +#: library/stdtypes.rst:1878 msgid "" "Return ``True`` if all characters in the string are printable or the string " "is empty, ``False`` otherwise. Nonprintable characters are those characters " @@ -3026,7 +3027,7 @@ msgstr "" "data:`sys.stdout` veya :data:`sys.stderr` dosyalarına yazılan dizelerin " "işlenmesiyle bir ilgisi yoktur)" -#: library/stdtypes.rst:1890 +#: library/stdtypes.rst:1889 msgid "" "Return ``True`` if there are only whitespace characters in the string and " "there is at least one character, ``False`` otherwise." @@ -3034,7 +3035,7 @@ msgstr "" "Dizede yalnızca boşluk karakterleri varsa ve en az bir karakter varsa " "``True``, aksi takdirde ``False`` döndürür." -#: library/stdtypes.rst:1893 +#: library/stdtypes.rst:1892 msgid "" "A character is *whitespace* if in the Unicode character database (see :mod:" "`unicodedata`), either its general category is ``Zs`` (\"Separator, " @@ -3044,7 +3045,7 @@ msgstr "" "sınıfı ``WS``, ``B`` veya ``S``’den biri ise Unicode karakter veritabanında " "(bkz. :mod:`unicodedata`) *beyaz boşluk karakteri*’dir." -#: library/stdtypes.rst:1901 +#: library/stdtypes.rst:1900 msgid "" "Return ``True`` if the string is a titlecased string and there is at least " "one character, for example uppercase characters may only follow uncased " @@ -3056,7 +3057,7 @@ msgstr "" "karakterleri ve küçük harfli karakterler sadece büyük harfli karakterleri " "takip edebilir. Aksi takdirde ``False`` döndürür." -#: library/stdtypes.rst:1908 +#: library/stdtypes.rst:1907 msgid "" "Return ``True`` if all cased characters [4]_ in the string are uppercase and " "there is at least one cased character, ``False`` otherwise." @@ -3064,7 +3065,7 @@ msgstr "" "Dizedeki tüm karakterler [4]_ büyük harfli ise ve en az bir büyük harfli " "karakter varsa ``True``, aksi takdirde ``False`` döndürür." -#: library/stdtypes.rst:1926 +#: library/stdtypes.rst:1925 msgid "" "Return a string which is the concatenation of the strings in *iterable*. A :" "exc:`TypeError` will be raised if there are any non-string values in " @@ -3076,7 +3077,7 @@ msgstr "" "olmayan değerler varsa bir :exc:`TypeError` oluşacaktır. Öğeler arasındaki " "ayırıcı, bu yöntemi sağlayan dizedir." -#: library/stdtypes.rst:1934 +#: library/stdtypes.rst:1933 msgid "" "Return the string left justified in a string of length *width*. Padding is " "done using the specified *fillchar* (default is an ASCII space). The " @@ -3087,7 +3088,7 @@ msgstr "" "boşluğudur). *width*, ``len(s)`` değerinden küçük veya ona eşitse orijinal " "dize döndürülür." -#: library/stdtypes.rst:1941 +#: library/stdtypes.rst:1940 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "lowercase." @@ -3095,7 +3096,7 @@ msgstr "" "Dizenin tüm büyük harfli karakterlerini [4]_ küçük harfe dönüştürerek bir " "kopyasını döndürür." -#: library/stdtypes.rst:1944 +#: library/stdtypes.rst:1943 #, fuzzy msgid "" "The lowercasing algorithm used is `described in section 3.13 'Default Case " @@ -3104,7 +3105,7 @@ msgid "" msgstr "" "Harf küçültme algoritması, Unicode Standardının 3.13 bölümünde açıklanmıştır." -#: library/stdtypes.rst:1951 +#: library/stdtypes.rst:1950 msgid "" "Return a copy of the string with leading characters removed. The *chars* " "argument is a string specifying the set of characters to be removed. If " @@ -3118,7 +3119,7 @@ msgstr "" "boşlukları kaldırır. *chars* bağımsız değişkeni bir ön ek değildir; bunun " "yerine, değerlerinin tüm kombinasyonları çıkarılır::" -#: library/stdtypes.rst:1961 +#: library/stdtypes.rst:1960 msgid "" "See :meth:`str.removeprefix` for a method that will remove a single prefix " "string rather than all of a set of characters. For example::" @@ -3127,7 +3128,7 @@ msgstr "" "kaldıracak bir yöntem için :meth:`str.removeprefix` bölümüne bakın. " "Örneğin::" -#: library/stdtypes.rst:1972 +#: library/stdtypes.rst:1971 msgid "" "This static method returns a translation table usable for :meth:`str." "translate`." @@ -3135,7 +3136,7 @@ msgstr "" "Bu statik yöntem :meth:`str.translate` için kullanılabilecek bir çeviri " "tablosu döndürür." -#: library/stdtypes.rst:1974 +#: library/stdtypes.rst:1973 msgid "" "If there is only one argument, it must be a dictionary mapping Unicode " "ordinals (integers) or characters (strings of length 1) to Unicode ordinals, " @@ -3148,7 +3149,7 @@ msgstr "" "sözlük olmalıdır. Karakter anahtarları daha sonra sıradanlara " "dönüştürülecektir." -#: library/stdtypes.rst:1979 +#: library/stdtypes.rst:1978 msgid "" "If there are two arguments, they must be strings of equal length, and in the " "resulting dictionary, each character in x will be mapped to the character at " @@ -3160,7 +3161,7 @@ msgstr "" "eşlenecektir. Üçüncü bir bağımsız değişken varsa, karakterleri sonuçta " "``None`` ile eşlenecek bir dizge olmalıdır." -#: library/stdtypes.rst:1987 +#: library/stdtypes.rst:1986 msgid "" "Split the string at the first occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " @@ -3172,7 +3173,7 @@ msgstr "" "Ayırıcı bulunamazsa, dizenin kendisini ve ardından iki boş dizeyi içeren bir " "3'lü döndürür." -#: library/stdtypes.rst:1995 +#: library/stdtypes.rst:1994 msgid "" "If the string starts with the *prefix* string, return " "``string[len(prefix):]``. Otherwise, return a copy of the original string::" @@ -3180,7 +3181,7 @@ msgstr "" "Eğer dize *prefix* dizesi ile başlıyorsa, ``dize[len(prefix):]`` döndürür. " "Aksi takdirde, orijinal dizgenin bir kopyasını döndürür::" -#: library/stdtypes.rst:2009 +#: library/stdtypes.rst:2008 msgid "" "If the string ends with the *suffix* string and that *suffix* is not empty, " "return ``string[:-len(suffix)]``. Otherwise, return a copy of the original " @@ -3190,7 +3191,7 @@ msgstr "" "``dize[:-len(suffix)]`` döndürür. Aksi takdirde, orijinal dizenin bir " "kopyasını döndürür::" -#: library/stdtypes.rst:2023 +#: library/stdtypes.rst:2022 msgid "" "Return a copy of the string with all occurrences of substring *old* replaced " "by *new*. If the optional argument *count* is given, only the first *count* " @@ -3200,7 +3201,7 @@ msgstr "" "kopyasını döndürür. İsteğe bağlı olarak *count* bağımsız değişkeni " "verilirse, yalnızca ilk *count* oluşumu değiştirilir." -#: library/stdtypes.rst:2030 +#: library/stdtypes.rst:2029 msgid "" "Return the highest index in the string where substring *sub* is found, such " "that *sub* is contained within ``s[start:end]``. Optional arguments *start* " @@ -3211,7 +3212,7 @@ msgstr "" "*end* dilim gösterimindeki gibi yorumlanır. Başarısızlık durumunda ``-1`` " "döndürür." -#: library/stdtypes.rst:2037 +#: library/stdtypes.rst:2036 msgid "" "Like :meth:`rfind` but raises :exc:`ValueError` when the substring *sub* is " "not found." @@ -3219,7 +3220,7 @@ msgstr "" ":meth:`rfind` gibi, ancak *sub* alt dizesi bulunamadığında :exc:`ValueError` " "yükseltir." -#: library/stdtypes.rst:2043 +#: library/stdtypes.rst:2042 msgid "" "Return the string right justified in a string of length *width*. Padding is " "done using the specified *fillchar* (default is an ASCII space). The " @@ -3230,7 +3231,7 @@ msgstr "" "boşluğudur). *width*, ``len(s)`` değerinden küçük veya ona eşitse orijinal " "dize döndürülür." -#: library/stdtypes.rst:2050 +#: library/stdtypes.rst:2049 msgid "" "Split the string at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " @@ -3242,7 +3243,7 @@ msgstr "" "Ayırıcı bulunamazsa, dizenin kendisini ve ardından iki boş dizeyi içeren bir " "3'lü döndürür." -#: library/stdtypes.rst:2058 +#: library/stdtypes.rst:2057 msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done, the " @@ -3256,7 +3257,7 @@ msgstr "" "herhangi bir boşluk dizesi ayırıcıdır. Sağdan bölme dışında, :meth:`rsplit` " "aşağıda ayrıntılı olarak açıklanan :meth:`split` gibi davranır." -#: library/stdtypes.rst:2067 +#: library/stdtypes.rst:2066 msgid "" "Return a copy of the string with trailing characters removed. The *chars* " "argument is a string specifying the set of characters to be removed. If " @@ -3270,7 +3271,7 @@ msgstr "" "boşlukları kaldırır. *chars* bağımsız değişkeni bir ön ek değildir; bunun " "yerine, değerlerinin tüm kombinasyonları çıkarılır::" -#: library/stdtypes.rst:2077 +#: library/stdtypes.rst:2076 msgid "" "See :meth:`str.removesuffix` for a method that will remove a single suffix " "string rather than all of a set of characters. For example::" @@ -3279,7 +3280,7 @@ msgstr "" "kaldıracak bir yöntem için :meth:`str.removeprefix` bölümüne bakın. " "Örneğin::" -#: library/stdtypes.rst:2087 +#: library/stdtypes.rst:2086 msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done (thus, " @@ -3293,7 +3294,7 @@ msgstr "" "Eğer *maxsplit* belirtilmemişse veya ``-1`` ise, bölme sayısında bir " "sınırlama yoktur (tüm olası bölmeler yapılır)." -#: library/stdtypes.rst:2093 +#: library/stdtypes.rst:2092 msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns " @@ -3307,15 +3308,15 @@ msgstr "" "(örneğin, ``'1<>2<>3'.split('<>')``, ``['1', '2', '3']`` döndürür). Boş bir " "dizeyi belirtilen bir ayırıcıyla bölmek ``['']`` döndürür." -#: library/stdtypes.rst:2115 library/stdtypes.rst:2235 -#: library/stdtypes.rst:3150 library/stdtypes.rst:3257 -#: library/stdtypes.rst:3298 library/stdtypes.rst:3340 -#: library/stdtypes.rst:3372 library/stdtypes.rst:3422 -#: library/stdtypes.rst:3491 library/stdtypes.rst:3515 +#: library/stdtypes.rst:2114 library/stdtypes.rst:2234 +#: library/stdtypes.rst:3149 library/stdtypes.rst:3256 +#: library/stdtypes.rst:3297 library/stdtypes.rst:3339 +#: library/stdtypes.rst:3371 library/stdtypes.rst:3421 +#: library/stdtypes.rst:3490 library/stdtypes.rst:3514 msgid "For example::" msgstr "Örneğin: ::" -#: library/stdtypes.rst:2108 +#: library/stdtypes.rst:2107 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive whitespace are regarded as a single separator, " @@ -3330,7 +3331,7 @@ msgstr "" "dizeler olmaz. Dolayısıyla, boş bir dizeyi veya sadece beyaz boşluktan " "oluşan bir dizeyi ``None`` ayırıcısıyla bölmek ``[]`` döndürür." -#: library/stdtypes.rst:2130 +#: library/stdtypes.rst:2129 msgid "" "Return a list of the lines in the string, breaking at line boundaries. Line " "breaks are not included in the resulting list unless *keepends* is given and " @@ -3340,7 +3341,7 @@ msgstr "" "Satır sonları için *keepends* belirtilmediği ve true değerinde olmadığı " "sürece, satır sonları sonuç listesine dahil edilmez." -#: library/stdtypes.rst:2134 +#: library/stdtypes.rst:2133 msgid "" "This method splits on the following line boundaries. In particular, the " "boundaries are a superset of :term:`universal newlines`." @@ -3348,107 +3349,107 @@ msgstr "" "Bu yöntem aşağıdaki satır sınırlarında bölme yapar. Spesifik olarak, " "sınırlar :term:`universal newlines` 'ın bir üst kümesidir." -#: library/stdtypes.rst:2138 +#: library/stdtypes.rst:2137 msgid "Representation" msgstr "Temsil" -#: library/stdtypes.rst:2138 +#: library/stdtypes.rst:2137 msgid "Description" msgstr "Açıklama" -#: library/stdtypes.rst:2140 +#: library/stdtypes.rst:2139 msgid "``\\n``" msgstr "``\\n``" -#: library/stdtypes.rst:2140 +#: library/stdtypes.rst:2139 msgid "Line Feed" msgstr "Satır Atlama" -#: library/stdtypes.rst:2142 +#: library/stdtypes.rst:2141 msgid "``\\r``" msgstr "``\\r``" -#: library/stdtypes.rst:2142 +#: library/stdtypes.rst:2141 msgid "Carriage Return" msgstr "Satır Başına Alma" -#: library/stdtypes.rst:2144 +#: library/stdtypes.rst:2143 msgid "``\\r\\n``" msgstr "``\\r\\n``" -#: library/stdtypes.rst:2144 +#: library/stdtypes.rst:2143 msgid "Carriage Return + Line Feed" msgstr "Satır Başına Alma + Satır Atlama" -#: library/stdtypes.rst:2146 +#: library/stdtypes.rst:2145 msgid "``\\v`` or ``\\x0b``" msgstr "``\\v`` or ``\\x0b``" -#: library/stdtypes.rst:2146 +#: library/stdtypes.rst:2145 msgid "Line Tabulation" msgstr "Satır Tablolama" -#: library/stdtypes.rst:2148 +#: library/stdtypes.rst:2147 msgid "``\\f`` or ``\\x0c``" msgstr "``\\f`` or ``\\x0c``" -#: library/stdtypes.rst:2148 +#: library/stdtypes.rst:2147 msgid "Form Feed" msgstr "Form Besleme" -#: library/stdtypes.rst:2150 +#: library/stdtypes.rst:2149 msgid "``\\x1c``" msgstr "``\\x1c``" -#: library/stdtypes.rst:2150 +#: library/stdtypes.rst:2149 msgid "File Separator" msgstr "Dosya Ayırıcı" -#: library/stdtypes.rst:2152 +#: library/stdtypes.rst:2151 msgid "``\\x1d``" msgstr "``\\x1d``" -#: library/stdtypes.rst:2152 +#: library/stdtypes.rst:2151 msgid "Group Separator" msgstr "Grup Ayırıcı" -#: library/stdtypes.rst:2154 +#: library/stdtypes.rst:2153 msgid "``\\x1e``" msgstr "``\\x1e``" -#: library/stdtypes.rst:2154 +#: library/stdtypes.rst:2153 msgid "Record Separator" msgstr "Kayıt Ayırıcı" -#: library/stdtypes.rst:2156 +#: library/stdtypes.rst:2155 msgid "``\\x85``" msgstr "``\\x85``" -#: library/stdtypes.rst:2156 +#: library/stdtypes.rst:2155 msgid "Next Line (C1 Control Code)" msgstr "Yeni Satır (C1 Denetim Kodu)" -#: library/stdtypes.rst:2158 +#: library/stdtypes.rst:2157 msgid "``\\u2028``" msgstr "``\\u2028``" -#: library/stdtypes.rst:2158 +#: library/stdtypes.rst:2157 msgid "Line Separator" msgstr "Satır Ayrıcı" -#: library/stdtypes.rst:2160 +#: library/stdtypes.rst:2159 msgid "``\\u2029``" msgstr "``\\u2029``" -#: library/stdtypes.rst:2160 +#: library/stdtypes.rst:2159 msgid "Paragraph Separator" msgstr "Paragraf Ayırıcı" -#: library/stdtypes.rst:2165 +#: library/stdtypes.rst:2164 msgid "``\\v`` and ``\\f`` added to list of line boundaries." msgstr "``\\v`` ve ``\\f`` satır sınırlarına eklenir." -#: library/stdtypes.rst:2174 +#: library/stdtypes.rst:2173 msgid "" "Unlike :meth:`~str.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " @@ -3458,11 +3459,11 @@ msgstr "" "farklı olarak, bu yöntem boş dize için boş bir liste döndürür ve bir " "terminal satır sonu fazladan bir satır ile sonuçlanmaz::" -#: library/stdtypes.rst:2183 +#: library/stdtypes.rst:2182 msgid "For comparison, ``split('\\n')`` gives::" msgstr "Kıyaslayacak olursak ``split(‘\\n’)`` şu değeri verir::" -#: library/stdtypes.rst:2193 +#: library/stdtypes.rst:2192 msgid "" "Return ``True`` if string starts with the *prefix*, otherwise return " "``False``. *prefix* can also be a tuple of prefixes to look for. With " @@ -3474,7 +3475,7 @@ msgstr "" "İsteğe bağlı *start* ile, o konumdan başlayan dizeyi sınar. İsteğe bağlı " "*end* ile, dizeyi o konumda karşılaştırmayı durdurur." -#: library/stdtypes.rst:2201 +#: library/stdtypes.rst:2200 msgid "" "Return a copy of the string with the leading and trailing characters " "removed. The *chars* argument is a string specifying the set of characters " @@ -3489,7 +3490,7 @@ msgstr "" "veya son ek değildir; bunun yerine, değerlerinin tüm kombinasyonları " "çıkarılır::" -#: library/stdtypes.rst:2212 +#: library/stdtypes.rst:2211 msgid "" "The outermost leading and trailing *chars* argument values are stripped from " "the string. Characters are removed from the leading end until reaching a " @@ -3501,7 +3502,7 @@ msgstr "" "karakterine ulaşılana kadar önde gelen uçtan çıkarılır. Benzer bir işlem son " "uçta da gerçekleşir. Örneğin::" -#: library/stdtypes.rst:2225 +#: library/stdtypes.rst:2224 msgid "" "Return a copy of the string with uppercase characters converted to lowercase " "and vice versa. Note that it is not necessarily true that ``s.swapcase()." @@ -3511,7 +3512,7 @@ msgstr "" "dizenin bir kopyasını döndürür. ``s.swapcase().swapcase() == s`` ifadesinin " "mutlaka doğru olması gerekmediğine dikkat edin." -#: library/stdtypes.rst:2232 +#: library/stdtypes.rst:2231 msgid "" "Return a titlecased version of the string where words start with an " "uppercase character and the remaining characters are lowercase." @@ -3519,7 +3520,7 @@ msgstr "" "Sözcüklerin büyük harfle başladığı ve kalan karakterlerin küçük harf olduğu " "dizenin başlıklandırılmış bir sürümünü döndürür." -#: library/stdtypes.rst:3459 +#: library/stdtypes.rst:3458 msgid "" "The algorithm uses a simple language-independent definition of a word as " "groups of consecutive letters. The definition works in many contexts but it " @@ -3531,13 +3532,13 @@ msgstr "" "kısaltmalar ve iyeliklerdeki kesme işaretlerinin kelime sınırları " "oluşturduğu anlamına gelir ve bu istenen sonuç olmayabilir::" -#: library/stdtypes.rst:2248 +#: library/stdtypes.rst:2247 msgid "" "The :func:`string.capwords` function does not have this problem, as it " "splits words on spaces only." msgstr "" -#: library/stdtypes.rst:2251 +#: library/stdtypes.rst:2250 #, fuzzy msgid "" "Alternatively, a workaround for apostrophes can be constructed using regular " @@ -3546,7 +3547,7 @@ msgstr "" "Alternatif olarak, kesme işaretleri için geçici bir çözüm düzenli ifadeler " "kullanılarak oluşturulabilir::" -#: library/stdtypes.rst:2266 +#: library/stdtypes.rst:2265 #, fuzzy msgid "" "Return a copy of the string in which each character has been mapped through " @@ -3568,19 +3569,19 @@ msgstr "" "veya karakteri kendisiyle eşlemek için bir :exc:`LookupError` istisnası " "oluşturmak." -#: library/stdtypes.rst:2275 +#: library/stdtypes.rst:2274 msgid "" "You can use :meth:`str.maketrans` to create a translation map from character-" "to-character mappings in different formats." msgstr "" -#: library/stdtypes.rst:2278 +#: library/stdtypes.rst:2277 msgid "" "See also the :mod:`codecs` module for a more flexible approach to custom " "character mappings." msgstr "" -#: library/stdtypes.rst:2284 +#: library/stdtypes.rst:2283 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "uppercase. Note that ``s.upper().isupper()`` might be ``False`` if ``s`` " @@ -3589,7 +3590,7 @@ msgid "" "titlecase)." msgstr "" -#: library/stdtypes.rst:2290 +#: library/stdtypes.rst:2289 #, fuzzy msgid "" "The uppercasing algorithm used is `described in section 3.13 'Default Case " @@ -3598,7 +3599,7 @@ msgid "" msgstr "" "Harf büyütme algoritması, Unicode Standardının 3.13 bölümünde açıklanmıştır." -#: library/stdtypes.rst:2297 +#: library/stdtypes.rst:2296 msgid "" "Return a copy of the string left filled with ASCII ``'0'`` digits to make a " "string of length *width*. A leading sign prefix (``'+'``/``'-'``) is handled " @@ -3606,11 +3607,11 @@ msgid "" "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: library/stdtypes.rst:2315 +#: library/stdtypes.rst:2314 msgid "``printf``-style String Formatting" msgstr "" -#: library/stdtypes.rst:2328 +#: library/stdtypes.rst:2327 msgid "" "The formatting operations described here exhibit a variety of quirks that " "lead to a number of common errors (such as failing to display tuples and " @@ -3621,7 +3622,7 @@ msgid "" "or extensibility." msgstr "" -#: library/stdtypes.rst:2336 +#: library/stdtypes.rst:2335 msgid "" "String objects have one unique built-in operation: the ``%`` operator " "(modulo). This is also known as the string *formatting* or *interpolation* " @@ -3631,7 +3632,7 @@ msgid "" "in the C language." msgstr "" -#: library/stdtypes.rst:2342 +#: library/stdtypes.rst:2341 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " @@ -3639,36 +3640,36 @@ msgid "" "example, a dictionary)." msgstr "" -#: library/stdtypes.rst:3570 +#: library/stdtypes.rst:3569 msgid "" "A conversion specifier contains two or more characters and has the following " "components, which must occur in this order:" msgstr "" -#: library/stdtypes.rst:3573 +#: library/stdtypes.rst:3572 msgid "The ``'%'`` character, which marks the start of the specifier." msgstr "" -#: library/stdtypes.rst:3575 +#: library/stdtypes.rst:3574 msgid "" "Mapping key (optional), consisting of a parenthesised sequence of characters " "(for example, ``(somename)``)." msgstr "" -#: library/stdtypes.rst:3578 +#: library/stdtypes.rst:3577 msgid "" "Conversion flags (optional), which affect the result of some conversion " "types." msgstr "" -#: library/stdtypes.rst:3581 +#: library/stdtypes.rst:3580 msgid "" "Minimum field width (optional). If specified as an ``'*'`` (asterisk), the " "actual width is read from the next element of the tuple in *values*, and the " "object to convert comes after the minimum field width and optional precision." msgstr "" -#: library/stdtypes.rst:3585 +#: library/stdtypes.rst:3584 msgid "" "Precision (optional), given as a ``'.'`` (dot) followed by the precision. " "If specified as ``'*'`` (an asterisk), the actual precision is read from the " @@ -3676,15 +3677,15 @@ msgid "" "the precision." msgstr "" -#: library/stdtypes.rst:3590 +#: library/stdtypes.rst:3589 msgid "Length modifier (optional)." msgstr "" -#: library/stdtypes.rst:3592 +#: library/stdtypes.rst:3591 msgid "Conversion type." msgstr "" -#: library/stdtypes.rst:2376 +#: library/stdtypes.rst:2375 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the string *must* include a parenthesised mapping key into that " @@ -3692,277 +3693,277 @@ msgid "" "selects the value to be formatted from the mapping. For example:" msgstr "" -#: library/stdtypes.rst:3603 +#: library/stdtypes.rst:3602 msgid "" "In this case no ``*`` specifiers may occur in a format (since they require a " "sequential parameter list)." msgstr "" -#: library/stdtypes.rst:3606 +#: library/stdtypes.rst:3605 msgid "The conversion flag characters are:" msgstr "" -#: library/stdtypes.rst:3615 +#: library/stdtypes.rst:3614 msgid "Flag" msgstr "" -#: library/stdtypes.rst:3617 +#: library/stdtypes.rst:3616 msgid "``'#'``" msgstr "" -#: library/stdtypes.rst:3617 +#: library/stdtypes.rst:3616 msgid "" "The value conversion will use the \"alternate form\" (where defined below)." msgstr "" -#: library/stdtypes.rst:3620 +#: library/stdtypes.rst:3619 msgid "``'0'``" msgstr "" -#: library/stdtypes.rst:3620 +#: library/stdtypes.rst:3619 msgid "The conversion will be zero padded for numeric values." msgstr "" -#: library/stdtypes.rst:3622 +#: library/stdtypes.rst:3621 msgid "``'-'``" msgstr "" -#: library/stdtypes.rst:3622 +#: library/stdtypes.rst:3621 msgid "" "The converted value is left adjusted (overrides the ``'0'`` conversion if " "both are given)." msgstr "" -#: library/stdtypes.rst:3625 +#: library/stdtypes.rst:3624 msgid "``' '``" msgstr "" -#: library/stdtypes.rst:3625 +#: library/stdtypes.rst:3624 msgid "" "(a space) A blank should be left before a positive number (or empty string) " "produced by a signed conversion." msgstr "" -#: library/stdtypes.rst:3628 +#: library/stdtypes.rst:3627 msgid "``'+'``" msgstr "" -#: library/stdtypes.rst:3628 +#: library/stdtypes.rst:3627 msgid "" "A sign character (``'+'`` or ``'-'``) will precede the conversion (overrides " "a \"space\" flag)." msgstr "" -#: library/stdtypes.rst:3632 +#: library/stdtypes.rst:3631 msgid "" "A length modifier (``h``, ``l``, or ``L``) may be present, but is ignored as " "it is not necessary for Python -- so e.g. ``%ld`` is identical to ``%d``." msgstr "" -#: library/stdtypes.rst:3635 +#: library/stdtypes.rst:3634 msgid "The conversion types are:" msgstr "" -#: library/stdtypes.rst:3638 +#: library/stdtypes.rst:3637 msgid "Conversion" msgstr "" -#: library/stdtypes.rst:3640 +#: library/stdtypes.rst:3639 msgid "``'d'``" msgstr "" -#: library/stdtypes.rst:2424 library/stdtypes.rst:3642 +#: library/stdtypes.rst:2423 library/stdtypes.rst:3641 msgid "Signed integer decimal." msgstr "" -#: library/stdtypes.rst:3642 +#: library/stdtypes.rst:3641 msgid "``'i'``" msgstr "" -#: library/stdtypes.rst:3644 +#: library/stdtypes.rst:3643 msgid "``'o'``" msgstr "" -#: library/stdtypes.rst:3644 +#: library/stdtypes.rst:3643 msgid "Signed octal value." msgstr "" -#: library/stdtypes.rst:3646 +#: library/stdtypes.rst:3645 msgid "``'u'``" msgstr "" -#: library/stdtypes.rst:3646 +#: library/stdtypes.rst:3645 msgid "Obsolete type -- it is identical to ``'d'``." msgstr "" -#: library/stdtypes.rst:3648 +#: library/stdtypes.rst:3647 msgid "``'x'``" msgstr "" -#: library/stdtypes.rst:3648 +#: library/stdtypes.rst:3647 msgid "Signed hexadecimal (lowercase)." msgstr "" -#: library/stdtypes.rst:3650 +#: library/stdtypes.rst:3649 msgid "``'X'``" msgstr "" -#: library/stdtypes.rst:3650 +#: library/stdtypes.rst:3649 msgid "Signed hexadecimal (uppercase)." msgstr "" -#: library/stdtypes.rst:3652 +#: library/stdtypes.rst:3651 msgid "``'e'``" msgstr "" -#: library/stdtypes.rst:3652 +#: library/stdtypes.rst:3651 msgid "Floating point exponential format (lowercase)." msgstr "" -#: library/stdtypes.rst:3654 +#: library/stdtypes.rst:3653 msgid "``'E'``" msgstr "" -#: library/stdtypes.rst:3654 +#: library/stdtypes.rst:3653 msgid "Floating point exponential format (uppercase)." msgstr "" -#: library/stdtypes.rst:3656 +#: library/stdtypes.rst:3655 msgid "``'f'``" msgstr "" -#: library/stdtypes.rst:2440 library/stdtypes.rst:3658 +#: library/stdtypes.rst:2439 library/stdtypes.rst:3657 msgid "Floating point decimal format." msgstr "" -#: library/stdtypes.rst:3658 +#: library/stdtypes.rst:3657 msgid "``'F'``" msgstr "" -#: library/stdtypes.rst:3660 +#: library/stdtypes.rst:3659 msgid "``'g'``" msgstr "" -#: library/stdtypes.rst:3660 +#: library/stdtypes.rst:3659 msgid "" "Floating point format. Uses lowercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" -#: library/stdtypes.rst:3664 +#: library/stdtypes.rst:3663 msgid "``'G'``" msgstr "" -#: library/stdtypes.rst:3664 +#: library/stdtypes.rst:3663 msgid "" "Floating point format. Uses uppercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" -#: library/stdtypes.rst:3668 +#: library/stdtypes.rst:3667 msgid "``'c'``" msgstr "" -#: library/stdtypes.rst:2450 +#: library/stdtypes.rst:2449 msgid "Single character (accepts integer or single character string)." msgstr "" -#: library/stdtypes.rst:3681 +#: library/stdtypes.rst:3680 msgid "``'r'``" msgstr "" -#: library/stdtypes.rst:2453 +#: library/stdtypes.rst:2452 msgid "String (converts any Python object using :func:`repr`)." msgstr "" -#: library/stdtypes.rst:3675 +#: library/stdtypes.rst:3674 msgid "``'s'``" msgstr "" -#: library/stdtypes.rst:2456 +#: library/stdtypes.rst:2455 msgid "String (converts any Python object using :func:`str`)." msgstr "" -#: library/stdtypes.rst:3678 +#: library/stdtypes.rst:3677 msgid "``'a'``" msgstr "" -#: library/stdtypes.rst:2459 +#: library/stdtypes.rst:2458 msgid "String (converts any Python object using :func:`ascii`)." msgstr "" -#: library/stdtypes.rst:3684 +#: library/stdtypes.rst:3683 msgid "``'%'``" msgstr "" -#: library/stdtypes.rst:3684 +#: library/stdtypes.rst:3683 msgid "No argument is converted, results in a ``'%'`` character in the result." msgstr "" -#: library/stdtypes.rst:3691 +#: library/stdtypes.rst:3690 msgid "" "The alternate form causes a leading octal specifier (``'0o'``) to be " "inserted before the first digit." msgstr "" -#: library/stdtypes.rst:3695 +#: library/stdtypes.rst:3694 msgid "" "The alternate form causes a leading ``'0x'`` or ``'0X'`` (depending on " "whether the ``'x'`` or ``'X'`` format was used) to be inserted before the " "first digit." msgstr "" -#: library/stdtypes.rst:3699 +#: library/stdtypes.rst:3698 msgid "" "The alternate form causes the result to always contain a decimal point, even " "if no digits follow it." msgstr "" -#: library/stdtypes.rst:3702 +#: library/stdtypes.rst:3701 msgid "" "The precision determines the number of digits after the decimal point and " "defaults to 6." msgstr "" -#: library/stdtypes.rst:3706 +#: library/stdtypes.rst:3705 msgid "" "The alternate form causes the result to always contain a decimal point, and " "trailing zeroes are not removed as they would otherwise be." msgstr "" -#: library/stdtypes.rst:3709 +#: library/stdtypes.rst:3708 msgid "" "The precision determines the number of significant digits before and after " "the decimal point and defaults to 6." msgstr "" -#: library/stdtypes.rst:3713 +#: library/stdtypes.rst:3712 msgid "If precision is ``N``, the output is truncated to ``N`` characters." msgstr "" -#: library/stdtypes.rst:3722 +#: library/stdtypes.rst:3721 msgid "See :pep:`237`." msgstr "" -#: library/stdtypes.rst:2496 +#: library/stdtypes.rst:2495 msgid "" "Since Python strings have an explicit length, ``%s`` conversions do not " "assume that ``'\\0'`` is the end of the string." msgstr "" -#: library/stdtypes.rst:2501 +#: library/stdtypes.rst:2500 msgid "" "``%f`` conversions for numbers whose absolute value is over 1e50 are no " "longer replaced by ``%g`` conversions." msgstr "" -#: library/stdtypes.rst:2512 +#: library/stdtypes.rst:2511 msgid "" "Binary Sequence Types --- :class:`bytes`, :class:`bytearray`, :class:" "`memoryview`" msgstr "" -#: library/stdtypes.rst:2520 +#: library/stdtypes.rst:2519 msgid "" "The core built-in types for manipulating binary data are :class:`bytes` and :" "class:`bytearray`. They are supported by :class:`memoryview` which uses the :" @@ -3970,17 +3971,17 @@ msgid "" "objects without needing to make a copy." msgstr "" -#: library/stdtypes.rst:2525 +#: library/stdtypes.rst:2524 msgid "" "The :mod:`array` module supports efficient storage of basic data types like " "32-bit integers and IEEE754 double-precision floating values." msgstr "" -#: library/stdtypes.rst:2531 +#: library/stdtypes.rst:2530 msgid "Bytes Objects" msgstr "" -#: library/stdtypes.rst:2535 +#: library/stdtypes.rst:2534 msgid "" "Bytes objects are immutable sequences of single bytes. Since many major " "binary protocols are based on the ASCII text encoding, bytes objects offer " @@ -3988,41 +3989,41 @@ msgid "" "and are closely related to string objects in a variety of other ways." msgstr "" -#: library/stdtypes.rst:2542 +#: library/stdtypes.rst:2541 msgid "" "Firstly, the syntax for bytes literals is largely the same as that for " "string literals, except that a ``b`` prefix is added:" msgstr "" -#: library/stdtypes.rst:2545 +#: library/stdtypes.rst:2544 msgid "Single quotes: ``b'still allows embedded \"double\" quotes'``" msgstr "" -#: library/stdtypes.rst:2546 +#: library/stdtypes.rst:2545 #, fuzzy msgid "Double quotes: ``b\"still allows embedded 'single' quotes\"``" msgstr "Çift tırnak: ``b\"katıştırılmış 'tek' tırnaklara izin verir\"``" -#: library/stdtypes.rst:2547 +#: library/stdtypes.rst:2546 msgid "" "Triple quoted: ``b'''3 single quotes'''``, ``b\"\"\"3 double quotes\"\"\"``" msgstr "" -#: library/stdtypes.rst:2549 +#: library/stdtypes.rst:2548 msgid "" "Only ASCII characters are permitted in bytes literals (regardless of the " "declared source code encoding). Any binary values over 127 must be entered " "into bytes literals using the appropriate escape sequence." msgstr "" -#: library/stdtypes.rst:2553 +#: library/stdtypes.rst:2552 msgid "" "As with string literals, bytes literals may also use a ``r`` prefix to " "disable processing of escape sequences. See :ref:`strings` for more about " "the various forms of bytes literal, including supported escape sequences." msgstr "" -#: library/stdtypes.rst:2557 +#: library/stdtypes.rst:2556 msgid "" "While bytes literals and representations are based on ASCII text, bytes " "objects actually behave like immutable sequences of integers, with each " @@ -4035,29 +4036,29 @@ msgid "" "compatible will usually lead to data corruption)." msgstr "" -#: library/stdtypes.rst:2567 +#: library/stdtypes.rst:2566 msgid "" "In addition to the literal forms, bytes objects can be created in a number " "of other ways:" msgstr "" -#: library/stdtypes.rst:2570 +#: library/stdtypes.rst:2569 msgid "A zero-filled bytes object of a specified length: ``bytes(10)``" msgstr "" -#: library/stdtypes.rst:2571 +#: library/stdtypes.rst:2570 msgid "From an iterable of integers: ``bytes(range(20))``" msgstr "" -#: library/stdtypes.rst:2572 +#: library/stdtypes.rst:2571 msgid "Copying existing binary data via the buffer protocol: ``bytes(obj)``" msgstr "" -#: library/stdtypes.rst:2574 +#: library/stdtypes.rst:2573 msgid "Also see the :ref:`bytes ` built-in." msgstr "" -#: library/stdtypes.rst:2576 +#: library/stdtypes.rst:2575 msgid "" "Since 2 hexadecimal digits correspond precisely to a single byte, " "hexadecimal numbers are a commonly used format for describing binary data. " @@ -4065,32 +4066,32 @@ msgid "" "that format:" msgstr "" -#: library/stdtypes.rst:2582 +#: library/stdtypes.rst:2581 msgid "" "This :class:`bytes` class method returns a bytes object, decoding the given " "string object. The string must contain two hexadecimal digits per byte, " "with ASCII whitespace being ignored." msgstr "" -#: library/stdtypes.rst:2589 +#: library/stdtypes.rst:2588 msgid "" ":meth:`bytes.fromhex` now skips all ASCII whitespace in the string, not just " "spaces." msgstr "" -#: library/stdtypes.rst:2593 +#: library/stdtypes.rst:2592 msgid "" "A reverse conversion function exists to transform a bytes object into its " "hexadecimal representation." msgstr "" -#: library/stdtypes.rst:2683 +#: library/stdtypes.rst:2682 msgid "" "Return a string object containing two hexadecimal digits for each byte in " "the instance." msgstr "" -#: library/stdtypes.rst:2604 +#: library/stdtypes.rst:2603 msgid "" "If you want to make the hex string easier to read, you can specify a single " "character separator *sep* parameter to include in the output. By default, " @@ -4099,13 +4100,13 @@ msgid "" "the separator position from the right, negative values from the left." msgstr "" -#: library/stdtypes.rst:2621 +#: library/stdtypes.rst:2620 msgid "" ":meth:`bytes.hex` now supports optional *sep* and *bytes_per_sep* parameters " "to insert separators between bytes in the hex output." msgstr "" -#: library/stdtypes.rst:2625 +#: library/stdtypes.rst:2624 msgid "" "Since bytes objects are sequences of integers (akin to a tuple), for a bytes " "object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be a bytes " @@ -4113,58 +4114,58 @@ msgid "" "and slicing will produce a string of length 1)" msgstr "" -#: library/stdtypes.rst:2630 +#: library/stdtypes.rst:2629 msgid "" "The representation of bytes objects uses the literal format (``b'...'``) " "since it is often more useful than e.g. ``bytes([46, 46, 46])``. You can " "always convert a bytes object into a list of integers using ``list(b)``." msgstr "" -#: library/stdtypes.rst:2638 +#: library/stdtypes.rst:2637 msgid "Bytearray Objects" msgstr "" -#: library/stdtypes.rst:2642 +#: library/stdtypes.rst:2641 msgid "" ":class:`bytearray` objects are a mutable counterpart to :class:`bytes` " "objects." msgstr "" -#: library/stdtypes.rst:2647 +#: library/stdtypes.rst:2646 msgid "" "There is no dedicated literal syntax for bytearray objects, instead they are " "always created by calling the constructor:" msgstr "" -#: library/stdtypes.rst:2650 +#: library/stdtypes.rst:2649 msgid "Creating an empty instance: ``bytearray()``" msgstr "" -#: library/stdtypes.rst:2651 +#: library/stdtypes.rst:2650 msgid "Creating a zero-filled instance with a given length: ``bytearray(10)``" msgstr "" -#: library/stdtypes.rst:2652 +#: library/stdtypes.rst:2651 msgid "From an iterable of integers: ``bytearray(range(20))``" msgstr "" -#: library/stdtypes.rst:2653 +#: library/stdtypes.rst:2652 msgid "" "Copying existing binary data via the buffer protocol: ``bytearray(b'Hi!')``" msgstr "" -#: library/stdtypes.rst:2655 +#: library/stdtypes.rst:2654 msgid "" "As bytearray objects are mutable, they support the :ref:`mutable ` sequence operations in addition to the common bytes and bytearray " "operations described in :ref:`bytes-methods`." msgstr "" -#: library/stdtypes.rst:2659 +#: library/stdtypes.rst:2658 msgid "Also see the :ref:`bytearray ` built-in." msgstr "" -#: library/stdtypes.rst:2661 +#: library/stdtypes.rst:2660 msgid "" "Since 2 hexadecimal digits correspond precisely to a single byte, " "hexadecimal numbers are a commonly used format for describing binary data. " @@ -4172,33 +4173,33 @@ msgid "" "in that format:" msgstr "" -#: library/stdtypes.rst:2667 +#: library/stdtypes.rst:2666 msgid "" "This :class:`bytearray` class method returns bytearray object, decoding the " "given string object. The string must contain two hexadecimal digits per " "byte, with ASCII whitespace being ignored." msgstr "" -#: library/stdtypes.rst:2674 +#: library/stdtypes.rst:2673 msgid "" ":meth:`bytearray.fromhex` now skips all ASCII whitespace in the string, not " "just spaces." msgstr "" -#: library/stdtypes.rst:2678 +#: library/stdtypes.rst:2677 msgid "" "A reverse conversion function exists to transform a bytearray object into " "its hexadecimal representation." msgstr "" -#: library/stdtypes.rst:2691 +#: library/stdtypes.rst:2690 msgid "" "Similar to :meth:`bytes.hex`, :meth:`bytearray.hex` now supports optional " "*sep* and *bytes_per_sep* parameters to insert separators between bytes in " "the hex output." msgstr "" -#: library/stdtypes.rst:2696 +#: library/stdtypes.rst:2695 msgid "" "Since bytearray objects are sequences of integers (akin to a list), for a " "bytearray object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be " @@ -4206,7 +4207,7 @@ msgid "" "both indexing and slicing will produce a string of length 1)" msgstr "" -#: library/stdtypes.rst:2701 +#: library/stdtypes.rst:2700 msgid "" "The representation of bytearray objects uses the bytes literal format " "(``bytearray(b'...')``) since it is often more useful than e.g. " @@ -4214,11 +4215,11 @@ msgid "" "a list of integers using ``list(b)``." msgstr "" -#: library/stdtypes.rst:2710 +#: library/stdtypes.rst:2709 msgid "Bytes and Bytearray Operations" msgstr "" -#: library/stdtypes.rst:2715 +#: library/stdtypes.rst:2714 msgid "" "Both bytes and bytearray objects support the :ref:`common ` " "sequence operations. They interoperate not just with operands of the same " @@ -4227,98 +4228,98 @@ msgid "" "return type of the result may depend on the order of operands." msgstr "" -#: library/stdtypes.rst:2723 +#: library/stdtypes.rst:2722 msgid "" "The methods on bytes and bytearray objects don't accept strings as their " "arguments, just as the methods on strings don't accept bytes as their " "arguments. For example, you have to write::" msgstr "" -#: library/stdtypes.rst:2730 +#: library/stdtypes.rst:2729 msgid "and::" msgstr "" -#: library/stdtypes.rst:2735 +#: library/stdtypes.rst:2734 msgid "" "Some bytes and bytearray operations assume the use of ASCII compatible " "binary formats, and hence should be avoided when working with arbitrary " "binary data. These restrictions are covered below." msgstr "" -#: library/stdtypes.rst:2740 +#: library/stdtypes.rst:2739 msgid "" "Using these ASCII based operations to manipulate binary data that is not " "stored in an ASCII based format may lead to data corruption." msgstr "" -#: library/stdtypes.rst:2743 +#: library/stdtypes.rst:2742 msgid "" "The following methods on bytes and bytearray objects can be used with " "arbitrary binary data." msgstr "" -#: library/stdtypes.rst:2749 +#: library/stdtypes.rst:2748 msgid "" "Return the number of non-overlapping occurrences of subsequence *sub* in the " "range [*start*, *end*]. Optional arguments *start* and *end* are " "interpreted as in slice notation." msgstr "" -#: library/stdtypes.rst:2858 library/stdtypes.rst:2946 -#: library/stdtypes.rst:2959 +#: library/stdtypes.rst:2857 library/stdtypes.rst:2945 +#: library/stdtypes.rst:2958 msgid "" "The subsequence to search for may be any :term:`bytes-like object` or an " "integer in the range 0 to 255." msgstr "" -#: library/stdtypes.rst:2756 +#: library/stdtypes.rst:2755 msgid "" "If *sub* is empty, returns the number of empty slices between characters " "which is the length of the bytes object plus one." msgstr "" -#: library/stdtypes.rst:2870 library/stdtypes.rst:2949 -#: library/stdtypes.rst:2962 +#: library/stdtypes.rst:2869 library/stdtypes.rst:2948 +#: library/stdtypes.rst:2961 msgid "Also accept an integer in the range 0 to 255 as the subsequence." msgstr "" -#: library/stdtypes.rst:2766 +#: library/stdtypes.rst:2765 msgid "" "If the binary data starts with the *prefix* string, return " "``bytes[len(prefix):]``. Otherwise, return a copy of the original binary " "data::" msgstr "" -#: library/stdtypes.rst:2775 +#: library/stdtypes.rst:2774 msgid "The *prefix* may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:2801 library/stdtypes.rst:3027 -#: library/stdtypes.rst:3072 library/stdtypes.rst:3128 -#: library/stdtypes.rst:3216 library/stdtypes.rst:3383 -#: library/stdtypes.rst:3481 library/stdtypes.rst:3524 -#: library/stdtypes.rst:3726 +#: library/stdtypes.rst:2800 library/stdtypes.rst:3026 +#: library/stdtypes.rst:3071 library/stdtypes.rst:3127 +#: library/stdtypes.rst:3215 library/stdtypes.rst:3382 +#: library/stdtypes.rst:3480 library/stdtypes.rst:3523 +#: library/stdtypes.rst:3725 msgid "" "The bytearray version of this method does *not* operate in place - it always " "produces a new object, even if no changes were made." msgstr "" -#: library/stdtypes.rst:2788 +#: library/stdtypes.rst:2787 msgid "" "If the binary data ends with the *suffix* string and that *suffix* is not " "empty, return ``bytes[:-len(suffix)]``. Otherwise, return a copy of the " "original binary data::" msgstr "" -#: library/stdtypes.rst:2797 +#: library/stdtypes.rst:2796 msgid "The *suffix* may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:2810 +#: library/stdtypes.rst:2809 msgid "Return the bytes decoded to a :class:`str`." msgstr "" -#: library/stdtypes.rst:2815 +#: library/stdtypes.rst:2814 msgid "" "*errors* controls how decoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " @@ -4326,21 +4327,21 @@ msgid "" "`codecs.register_error`. See :ref:`error-handlers` for details." msgstr "" -#: library/stdtypes.rst:2821 +#: library/stdtypes.rst:2820 msgid "" "For performance reasons, the value of *errors* is not checked for validity " "unless a decoding error actually occurs, :ref:`devmode` is enabled or a :ref:" "`debug build ` is used." msgstr "" -#: library/stdtypes.rst:2827 +#: library/stdtypes.rst:2826 msgid "" "Passing the *encoding* argument to :class:`str` allows decoding any :term:" "`bytes-like object` directly, without needing to make a temporary :class:`!" "bytes` or :class:`!bytearray` object." msgstr "" -#: library/stdtypes.rst:2842 +#: library/stdtypes.rst:2841 msgid "" "Return ``True`` if the binary data ends with the specified *suffix*, " "otherwise return ``False``. *suffix* can also be a tuple of suffixes to " @@ -4348,11 +4349,11 @@ msgid "" "optional *end*, stop comparing at that position." msgstr "" -#: library/stdtypes.rst:2847 +#: library/stdtypes.rst:2846 msgid "The suffix(es) to search for may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:2853 +#: library/stdtypes.rst:2852 msgid "" "Return the lowest index in the data where the subsequence *sub* is found, " "such that *sub* is contained in the slice ``s[start:end]``. Optional " @@ -4360,20 +4361,20 @@ msgid "" "``-1`` if *sub* is not found." msgstr "" -#: library/stdtypes.rst:2863 +#: library/stdtypes.rst:2862 msgid "" "The :meth:`~bytes.find` method should be used only if you need to know the " "position of *sub*. To check if *sub* is a substring or not, use the :" "keyword:`in` operator::" msgstr "" -#: library/stdtypes.rst:2877 +#: library/stdtypes.rst:2876 msgid "" "Like :meth:`~bytes.find`, but raise :exc:`ValueError` when the subsequence " "is not found." msgstr "" -#: library/stdtypes.rst:2890 +#: library/stdtypes.rst:2889 msgid "" "Return a bytes or bytearray object which is the concatenation of the binary " "data sequences in *iterable*. A :exc:`TypeError` will be raised if there " @@ -4383,7 +4384,7 @@ msgid "" "method." msgstr "" -#: library/stdtypes.rst:2901 +#: library/stdtypes.rst:2900 msgid "" "This static method returns a translation table usable for :meth:`bytes." "translate` that will map each character in *from* into the character at the " @@ -4391,7 +4392,7 @@ msgid "" "objects ` and have the same length." msgstr "" -#: library/stdtypes.rst:2912 +#: library/stdtypes.rst:2911 msgid "" "Split the sequence at the first occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself or its " @@ -4400,24 +4401,24 @@ msgid "" "by two empty bytes or bytearray objects." msgstr "" -#: library/stdtypes.rst:2976 +#: library/stdtypes.rst:2975 msgid "The separator to search for may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:2925 +#: library/stdtypes.rst:2924 msgid "" "Return a copy of the sequence with all occurrences of subsequence *old* " "replaced by *new*. If the optional argument *count* is given, only the " "first *count* occurrences are replaced." msgstr "" -#: library/stdtypes.rst:2929 +#: library/stdtypes.rst:2928 msgid "" "The subsequence to search for and its replacement may be any :term:`bytes-" "like object`." msgstr "" -#: library/stdtypes.rst:2941 +#: library/stdtypes.rst:2940 msgid "" "Return the highest index in the sequence where the subsequence *sub* is " "found, such that *sub* is contained within ``s[start:end]``. Optional " @@ -4425,13 +4426,13 @@ msgid "" "``-1`` on failure." msgstr "" -#: library/stdtypes.rst:2956 +#: library/stdtypes.rst:2955 msgid "" "Like :meth:`~bytes.rfind` but raises :exc:`ValueError` when the subsequence " "*sub* is not found." msgstr "" -#: library/stdtypes.rst:2969 +#: library/stdtypes.rst:2968 msgid "" "Split the sequence at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself or its " @@ -4440,7 +4441,7 @@ msgid "" "followed by a copy of the original sequence." msgstr "" -#: library/stdtypes.rst:2982 +#: library/stdtypes.rst:2981 msgid "" "Return ``True`` if the binary data starts with the specified *prefix*, " "otherwise return ``False``. *prefix* can also be a tuple of prefixes to " @@ -4448,11 +4449,11 @@ msgid "" "optional *end*, stop comparing at that position." msgstr "" -#: library/stdtypes.rst:2987 +#: library/stdtypes.rst:2986 msgid "The prefix(es) to search for may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:2993 +#: library/stdtypes.rst:2992 msgid "" "Return a copy of the bytes or bytearray object where all bytes occurring in " "the optional argument *delete* are removed, and the remaining bytes have " @@ -4460,22 +4461,22 @@ msgid "" "object of length 256." msgstr "" -#: library/stdtypes.rst:2998 +#: library/stdtypes.rst:2997 msgid "" "You can use the :func:`bytes.maketrans` method to create a translation table." msgstr "" -#: library/stdtypes.rst:3001 +#: library/stdtypes.rst:3000 msgid "" "Set the *table* argument to ``None`` for translations that only delete " "characters::" msgstr "" -#: library/stdtypes.rst:3007 +#: library/stdtypes.rst:3006 msgid "*delete* is now supported as a keyword argument." msgstr "" -#: library/stdtypes.rst:3011 +#: library/stdtypes.rst:3010 msgid "" "The following methods on bytes and bytearray objects have default behaviours " "that assume the use of ASCII compatible binary formats, but can still be " @@ -4484,7 +4485,7 @@ msgid "" "instead produce new objects." msgstr "" -#: library/stdtypes.rst:3020 +#: library/stdtypes.rst:3019 msgid "" "Return a copy of the object centered in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -4492,7 +4493,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: library/stdtypes.rst:3034 +#: library/stdtypes.rst:3033 msgid "" "Return a copy of the object left justified in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -4500,7 +4501,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: library/stdtypes.rst:3048 +#: library/stdtypes.rst:3047 msgid "" "Return a copy of the sequence with specified leading bytes removed. The " "*chars* argument is a binary sequence specifying the set of byte values to " @@ -4510,14 +4511,14 @@ msgid "" "all combinations of its values are stripped::" msgstr "" -#: library/stdtypes.rst:3060 +#: library/stdtypes.rst:3059 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`. See :meth:`~bytes.removeprefix` for a method that will remove a " "single prefix string rather than all of a set of characters. For example::" msgstr "" -#: library/stdtypes.rst:3079 +#: library/stdtypes.rst:3078 msgid "" "Return a copy of the object right justified in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " @@ -4525,7 +4526,7 @@ msgid "" "less than or equal to ``len(s)``." msgstr "" -#: library/stdtypes.rst:3093 +#: library/stdtypes.rst:3092 msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given, at most *maxsplit* splits are " @@ -4535,7 +4536,7 @@ msgid "" "described in detail below." msgstr "" -#: library/stdtypes.rst:3104 +#: library/stdtypes.rst:3103 msgid "" "Return a copy of the sequence with specified trailing bytes removed. The " "*chars* argument is a binary sequence specifying the set of byte values to " @@ -4545,14 +4546,14 @@ msgid "" "all combinations of its values are stripped::" msgstr "" -#: library/stdtypes.rst:3116 +#: library/stdtypes.rst:3115 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`. See :meth:`~bytes.removesuffix` for a method that will remove a " "single suffix string rather than all of a set of characters. For example::" msgstr "" -#: library/stdtypes.rst:3135 +#: library/stdtypes.rst:3134 msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given and non-negative, at most " @@ -4561,7 +4562,7 @@ msgid "" "limit on the number of splits (all possible splits are made)." msgstr "" -#: library/stdtypes.rst:3141 +#: library/stdtypes.rst:3140 msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty subsequences (for example, ``b'1,,2'.split(b',')`` " @@ -4572,7 +4573,7 @@ msgid "" "object being split. The *sep* argument may be any :term:`bytes-like object`." msgstr "" -#: library/stdtypes.rst:3159 +#: library/stdtypes.rst:3158 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive ASCII whitespace are regarded as a single " @@ -4582,7 +4583,7 @@ msgid "" "without a specified separator returns ``[]``." msgstr "" -#: library/stdtypes.rst:3180 +#: library/stdtypes.rst:3179 msgid "" "Return a copy of the sequence with specified leading and trailing bytes " "removed. The *chars* argument is a binary sequence specifying the set of " @@ -4592,13 +4593,13 @@ msgid "" "a prefix or suffix; rather, all combinations of its values are stripped::" msgstr "" -#: library/stdtypes.rst:3193 +#: library/stdtypes.rst:3192 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`." msgstr "" -#: library/stdtypes.rst:3202 +#: library/stdtypes.rst:3201 msgid "" "The following methods on bytes and bytearray objects assume the use of ASCII " "compatible binary formats and should not be applied to arbitrary binary " @@ -4606,14 +4607,14 @@ msgid "" "operate in place, and instead produce new objects." msgstr "" -#: library/stdtypes.rst:3210 +#: library/stdtypes.rst:3209 msgid "" "Return a copy of the sequence with each byte interpreted as an ASCII " "character, and the first byte capitalized and the rest lowercased. Non-ASCII " "byte values are passed through unchanged." msgstr "" -#: library/stdtypes.rst:3223 +#: library/stdtypes.rst:3222 msgid "" "Return a copy of the sequence where all ASCII tab characters are replaced by " "one or more ASCII spaces, depending on the current column and the given tab " @@ -4629,7 +4630,7 @@ msgid "" "by one regardless of how the byte value is represented when printed::" msgstr "" -#: library/stdtypes.rst:3251 +#: library/stdtypes.rst:3250 msgid "" "Return ``True`` if all bytes in the sequence are alphabetical ASCII " "characters or ASCII decimal digits and the sequence is not empty, ``False`` " @@ -4638,7 +4639,7 @@ msgid "" "digits are those byte values in the sequence ``b'0123456789'``." msgstr "" -#: library/stdtypes.rst:3268 +#: library/stdtypes.rst:3267 msgid "" "Return ``True`` if all bytes in the sequence are alphabetic ASCII characters " "and the sequence is not empty, ``False`` otherwise. Alphabetic ASCII " @@ -4646,34 +4647,34 @@ msgid "" "``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``." msgstr "" -#: library/stdtypes.rst:3284 +#: library/stdtypes.rst:3283 msgid "" "Return ``True`` if the sequence is empty or all bytes in the sequence are " "ASCII, ``False`` otherwise. ASCII bytes are in the range 0-0x7F." msgstr "" -#: library/stdtypes.rst:3294 +#: library/stdtypes.rst:3293 msgid "" "Return ``True`` if all bytes in the sequence are ASCII decimal digits and " "the sequence is not empty, ``False`` otherwise. ASCII decimal digits are " "those byte values in the sequence ``b'0123456789'``." msgstr "" -#: library/stdtypes.rst:3309 +#: library/stdtypes.rst:3308 msgid "" "Return ``True`` if there is at least one lowercase ASCII character in the " "sequence and no uppercase ASCII characters, ``False`` otherwise." msgstr "" -#: library/stdtypes.rst:3361 library/stdtypes.rst:3427 -#: library/stdtypes.rst:3496 +#: library/stdtypes.rst:3360 library/stdtypes.rst:3426 +#: library/stdtypes.rst:3495 msgid "" "Lowercase ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " "values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``." msgstr "" -#: library/stdtypes.rst:3327 +#: library/stdtypes.rst:3326 msgid "" "Return ``True`` if all bytes in the sequence are ASCII whitespace and the " "sequence is not empty, ``False`` otherwise. ASCII whitespace characters are " @@ -4681,27 +4682,27 @@ msgid "" "newline, carriage return, vertical tab, form feed)." msgstr "" -#: library/stdtypes.rst:3336 +#: library/stdtypes.rst:3335 msgid "" "Return ``True`` if the sequence is ASCII titlecase and the sequence is not " "empty, ``False`` otherwise. See :meth:`bytes.title` for more details on the " "definition of \"titlecase\"." msgstr "" -#: library/stdtypes.rst:3351 +#: library/stdtypes.rst:3350 msgid "" "Return ``True`` if there is at least one uppercase alphabetic ASCII " "character in the sequence and no lowercase ASCII characters, ``False`` " "otherwise." msgstr "" -#: library/stdtypes.rst:3369 +#: library/stdtypes.rst:3368 msgid "" "Return a copy of the sequence with all the uppercase ASCII characters " "converted to their corresponding lowercase counterpart." msgstr "" -#: library/stdtypes.rst:3394 +#: library/stdtypes.rst:3393 msgid "" "Return a list of the lines in the binary sequence, breaking at ASCII line " "boundaries. This method uses the :term:`universal newlines` approach to " @@ -4709,20 +4710,20 @@ msgid "" "*keepends* is given and true." msgstr "" -#: library/stdtypes.rst:3406 +#: library/stdtypes.rst:3405 msgid "" "Unlike :meth:`~bytes.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " "does not result in an extra line::" msgstr "" -#: library/stdtypes.rst:3419 +#: library/stdtypes.rst:3418 msgid "" "Return a copy of the sequence with all the lowercase ASCII characters " "converted to their corresponding uppercase counterpart and vice-versa." msgstr "" -#: library/stdtypes.rst:3431 +#: library/stdtypes.rst:3430 msgid "" "Unlike :func:`str.swapcase()`, it is always the case that ``bin.swapcase()." "swapcase() == bin`` for the binary versions. Case conversions are " @@ -4730,14 +4731,14 @@ msgid "" "Unicode code points." msgstr "" -#: library/stdtypes.rst:3445 +#: library/stdtypes.rst:3444 msgid "" "Return a titlecased version of the binary sequence where words start with an " "uppercase ASCII character and the remaining characters are lowercase. " "Uncased byte values are left unmodified." msgstr "" -#: library/stdtypes.rst:3454 +#: library/stdtypes.rst:3453 msgid "" "Lowercase ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " @@ -4745,20 +4746,20 @@ msgid "" "values are uncased." msgstr "" -#: library/stdtypes.rst:3467 +#: library/stdtypes.rst:3466 msgid "" "A workaround for apostrophes can be constructed using regular expressions::" msgstr "" "Kesme işaretleri için geçici bir çözüm düzenli ifadeler kullanılarak " "oluşturulabilir::" -#: library/stdtypes.rst:3488 +#: library/stdtypes.rst:3487 msgid "" "Return a copy of the sequence with all the lowercase ASCII characters " "converted to their corresponding uppercase counterpart." msgstr "" -#: library/stdtypes.rst:3509 +#: library/stdtypes.rst:3508 msgid "" "Return a copy of the sequence left filled with ASCII ``b'0'`` digits to make " "a sequence of length *width*. A leading sign prefix (``b'+'``/ ``b'-'``) is " @@ -4767,11 +4768,11 @@ msgid "" "*width* is less than or equal to ``len(seq)``." msgstr "" -#: library/stdtypes.rst:3531 +#: library/stdtypes.rst:3530 msgid "``printf``-style Bytes Formatting" msgstr "" -#: library/stdtypes.rst:3548 +#: library/stdtypes.rst:3547 msgid "" "The formatting operations described here exhibit a variety of quirks that " "lead to a number of common errors (such as failing to display tuples and " @@ -4779,7 +4780,7 @@ msgid "" "dictionary, wrap it in a tuple." msgstr "" -#: library/stdtypes.rst:3553 +#: library/stdtypes.rst:3552 msgid "" "Bytes objects (``bytes``/``bytearray``) have one unique built-in operation: " "the ``%`` operator (modulo). This is also known as the bytes *formatting* or " @@ -4789,7 +4790,7 @@ msgid "" "func:`sprintf` in the C language." msgstr "" -#: library/stdtypes.rst:3560 +#: library/stdtypes.rst:3559 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " @@ -4797,7 +4798,7 @@ msgid "" "example, a dictionary)." msgstr "" -#: library/stdtypes.rst:3594 +#: library/stdtypes.rst:3593 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the bytes object *must* include a parenthesised mapping key into " @@ -4805,73 +4806,73 @@ msgid "" "mapping key selects the value to be formatted from the mapping. For example:" msgstr "" -#: library/stdtypes.rst:3668 +#: library/stdtypes.rst:3667 msgid "Single byte (accepts integer or single byte objects)." msgstr "" -#: library/stdtypes.rst:3671 +#: library/stdtypes.rst:3670 msgid "``'b'``" msgstr "" -#: library/stdtypes.rst:3671 +#: library/stdtypes.rst:3670 msgid "" "Bytes (any object that follows the :ref:`buffer protocol ` or " "has :meth:`~object.__bytes__`)." msgstr "" -#: library/stdtypes.rst:3675 +#: library/stdtypes.rst:3674 msgid "" "``'s'`` is an alias for ``'b'`` and should only be used for Python2/3 code " "bases." msgstr "" -#: library/stdtypes.rst:3678 +#: library/stdtypes.rst:3677 msgid "" "Bytes (converts any Python object using ``repr(obj).encode('ascii', " "'backslashreplace')``)." msgstr "" -#: library/stdtypes.rst:3681 +#: library/stdtypes.rst:3680 msgid "" "``'r'`` is an alias for ``'a'`` and should only be used for Python2/3 code " "bases." msgstr "" -#: library/stdtypes.rst:3681 +#: library/stdtypes.rst:3680 msgid "\\(7)" msgstr "" -#: library/stdtypes.rst:3716 +#: library/stdtypes.rst:3715 msgid "``b'%s'`` is deprecated, but will not be removed during the 3.x series." msgstr "" -#: library/stdtypes.rst:3719 +#: library/stdtypes.rst:3718 msgid "``b'%r'`` is deprecated, but will not be removed during the 3.x series." msgstr "" -#: library/stdtypes.rst:3731 +#: library/stdtypes.rst:3730 msgid ":pep:`461` - Adding % formatting to bytes and bytearray" msgstr "" -#: library/stdtypes.rst:3738 +#: library/stdtypes.rst:3737 msgid "Memory Views" msgstr "" -#: library/stdtypes.rst:3740 +#: library/stdtypes.rst:3739 msgid "" ":class:`memoryview` objects allow Python code to access the internal data of " "an object that supports the :ref:`buffer protocol ` without " "copying." msgstr "" -#: library/stdtypes.rst:3746 +#: library/stdtypes.rst:3745 msgid "" "Create a :class:`memoryview` that references *object*. *object* must " "support the buffer protocol. Built-in objects that support the buffer " "protocol include :class:`bytes` and :class:`bytearray`." msgstr "" -#: library/stdtypes.rst:3750 +#: library/stdtypes.rst:3749 msgid "" "A :class:`memoryview` has the notion of an *element*, which is the atomic " "memory unit handled by the originating *object*. For many simple types such " @@ -4879,32 +4880,32 @@ msgid "" "other types such as :class:`array.array` may have bigger elements." msgstr "" -#: library/stdtypes.rst:3755 +#: library/stdtypes.rst:3754 msgid "" "``len(view)`` is equal to the length of :class:`~memoryview.tolist`, which " "is the nested list representation of the view. If ``view.ndim = 1``, this is " "equal to the number of elements in the view." msgstr "" -#: library/stdtypes.rst:3759 +#: library/stdtypes.rst:3758 msgid "" "If ``view.ndim == 0``, ``len(view)`` now raises :exc:`TypeError` instead of " "returning 1." msgstr "" -#: library/stdtypes.rst:3762 +#: library/stdtypes.rst:3761 msgid "" "The :class:`~memoryview.itemsize` attribute will give you the number of " "bytes in a single element." msgstr "" -#: library/stdtypes.rst:3765 +#: library/stdtypes.rst:3764 msgid "" "A :class:`memoryview` supports slicing and indexing to expose its data. One-" "dimensional slicing will result in a subview::" msgstr "" -#: library/stdtypes.rst:3778 +#: library/stdtypes.rst:3777 msgid "" "If :class:`~memoryview.format` is one of the native format specifiers from " "the :mod:`struct` module, indexing with an integer or a tuple of integers is " @@ -4915,82 +4916,82 @@ msgid "" "memoryviews can be indexed with the empty tuple." msgstr "" -#: library/stdtypes.rst:3787 +#: library/stdtypes.rst:3786 msgid "Here is an example with a non-byte format::" msgstr "" -#: library/stdtypes.rst:3799 +#: library/stdtypes.rst:3798 msgid "" "If the underlying object is writable, the memoryview supports one-" "dimensional slice assignment. Resizing is not allowed::" msgstr "" -#: library/stdtypes.rst:3820 +#: library/stdtypes.rst:3819 msgid "" "One-dimensional memoryviews of :term:`hashable` (read-only) types with " "formats 'B', 'b' or 'c' are also hashable. The hash is defined as ``hash(m) " "== hash(m.tobytes())``::" msgstr "" -#: library/stdtypes.rst:3832 +#: library/stdtypes.rst:3831 msgid "" "One-dimensional memoryviews can now be sliced. One-dimensional memoryviews " "with formats 'B', 'b' or 'c' are now :term:`hashable`." msgstr "" -#: library/stdtypes.rst:3836 +#: library/stdtypes.rst:3835 msgid "" "memoryview is now registered automatically with :class:`collections.abc." "Sequence`" msgstr "" -#: library/stdtypes.rst:3840 +#: library/stdtypes.rst:3839 msgid "memoryviews can now be indexed with tuple of integers." msgstr "" -#: library/stdtypes.rst:3843 +#: library/stdtypes.rst:3842 msgid ":class:`memoryview` has several methods:" msgstr "" -#: library/stdtypes.rst:3847 +#: library/stdtypes.rst:3846 msgid "" "A memoryview and a :pep:`3118` exporter are equal if their shapes are " "equivalent and if all corresponding values are equal when the operands' " "respective format codes are interpreted using :mod:`struct` syntax." msgstr "" -#: library/stdtypes.rst:3851 +#: library/stdtypes.rst:3850 msgid "" "For the subset of :mod:`struct` format strings currently supported by :meth:" "`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == w.tolist()``::" msgstr "" -#: library/stdtypes.rst:3870 +#: library/stdtypes.rst:3869 msgid "" "If either format string is not supported by the :mod:`struct` module, then " "the objects will always compare as unequal (even if the format strings and " "buffer contents are identical)::" msgstr "" -#: library/stdtypes.rst:3886 +#: library/stdtypes.rst:3885 msgid "" "Note that, as with floating point numbers, ``v is w`` does *not* imply ``v " "== w`` for memoryview objects." msgstr "" -#: library/stdtypes.rst:3889 +#: library/stdtypes.rst:3888 msgid "" "Previous versions compared the raw memory disregarding the item format and " "the logical array structure." msgstr "" -#: library/stdtypes.rst:3895 +#: library/stdtypes.rst:3894 msgid "" "Return the data in the buffer as a bytestring. This is equivalent to " "calling the :class:`bytes` constructor on the memoryview. ::" msgstr "" -#: library/stdtypes.rst:3904 +#: library/stdtypes.rst:3903 msgid "" "For non-contiguous arrays the result is equal to the flattened list " "representation with all elements converted to bytes. :meth:`tobytes` " @@ -4998,7 +4999,7 @@ msgid "" "module syntax." msgstr "" -#: library/stdtypes.rst:3909 +#: library/stdtypes.rst:3908 msgid "" "*order* can be {'C', 'F', 'A'}. When *order* is 'C' or 'F', the data of the " "original array is converted to C or Fortran order. For contiguous views, 'A' " @@ -5007,36 +5008,36 @@ msgid "" "to C first. *order=None* is the same as *order='C'*." msgstr "" -#: library/stdtypes.rst:3918 +#: library/stdtypes.rst:3917 msgid "" "Return a string object containing two hexadecimal digits for each byte in " "the buffer. ::" msgstr "" -#: library/stdtypes.rst:3927 +#: library/stdtypes.rst:3926 msgid "" "Similar to :meth:`bytes.hex`, :meth:`memoryview.hex` now supports optional " "*sep* and *bytes_per_sep* parameters to insert separators between bytes in " "the hex output." msgstr "" -#: library/stdtypes.rst:3934 +#: library/stdtypes.rst:3933 msgid "Return the data in the buffer as a list of elements. ::" msgstr "" -#: library/stdtypes.rst:3944 +#: library/stdtypes.rst:3943 msgid "" ":meth:`tolist` now supports all single character native formats in :mod:" "`struct` module syntax as well as multi-dimensional representations." msgstr "" -#: library/stdtypes.rst:3951 +#: library/stdtypes.rst:3950 msgid "" "Return a readonly version of the memoryview object. The original memoryview " "object is unchanged. ::" msgstr "" -#: library/stdtypes.rst:3970 +#: library/stdtypes.rst:3969 msgid "" "Release the underlying buffer exposed by the memoryview object. Many " "objects take special actions when a view is held on them (for example, a :" @@ -5045,20 +5046,20 @@ msgid "" "resources) as soon as possible." msgstr "" -#: library/stdtypes.rst:3976 +#: library/stdtypes.rst:3975 msgid "" "After this method has been called, any further operation on the view raises " "a :class:`ValueError` (except :meth:`release()` itself which can be called " "multiple times)::" msgstr "" -#: library/stdtypes.rst:3987 +#: library/stdtypes.rst:3986 msgid "" "The context management protocol can be used for a similar effect, using the " "``with`` statement::" msgstr "" -#: library/stdtypes.rst:4003 +#: library/stdtypes.rst:4002 msgid "" "Cast a memoryview to a new format or shape. *shape* defaults to " "``[byte_length//new_itemsize]``, which means that the result view will be " @@ -5067,7 +5068,7 @@ msgid "" "contiguous -> 1D." msgstr "" -#: library/stdtypes.rst:4009 +#: library/stdtypes.rst:4008 msgid "" "The destination format is restricted to a single element native format in :" "mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' or " @@ -5075,50 +5076,50 @@ msgid "" "Note that all byte lengths may depend on the operating system." msgstr "" -#: library/stdtypes.rst:4015 +#: library/stdtypes.rst:4014 msgid "Cast 1D/long to 1D/unsigned bytes::" msgstr "" -#: library/stdtypes.rst:4038 +#: library/stdtypes.rst:4037 msgid "Cast 1D/unsigned bytes to 1D/char::" msgstr "" -#: library/stdtypes.rst:4051 +#: library/stdtypes.rst:4050 msgid "Cast 1D/bytes to 3D/ints to 1D/signed char::" msgstr "" -#: library/stdtypes.rst:4077 +#: library/stdtypes.rst:4076 msgid "Cast 1D/unsigned long to 2D/unsigned long::" msgstr "" -#: library/stdtypes.rst:4091 +#: library/stdtypes.rst:4090 msgid "The source format is no longer restricted when casting to a byte view." msgstr "" -#: library/stdtypes.rst:4094 +#: library/stdtypes.rst:4093 msgid "There are also several readonly attributes available:" msgstr "" -#: library/stdtypes.rst:4098 +#: library/stdtypes.rst:4097 msgid "The underlying object of the memoryview::" msgstr "" -#: library/stdtypes.rst:4109 +#: library/stdtypes.rst:4108 msgid "" "``nbytes == product(shape) * itemsize == len(m.tobytes())``. This is the " "amount of space in bytes that the array would use in a contiguous " "representation. It is not necessarily equal to ``len(m)``::" msgstr "" -#: library/stdtypes.rst:4128 +#: library/stdtypes.rst:4127 msgid "Multi-dimensional arrays::" msgstr "" -#: library/stdtypes.rst:4145 +#: library/stdtypes.rst:4144 msgid "A bool indicating whether the memory is read only." msgstr "" -#: library/stdtypes.rst:4149 +#: library/stdtypes.rst:4148 msgid "" "A string containing the format (in :mod:`struct` module style) for each " "element in the view. A memoryview can be created from exporters with " @@ -5126,59 +5127,59 @@ msgid "" "restricted to native single element formats." msgstr "" -#: library/stdtypes.rst:4154 +#: library/stdtypes.rst:4153 msgid "" "format ``'B'`` is now handled according to the struct module syntax. This " "means that ``memoryview(b'abc')[0] == b'abc'[0] == 97``." msgstr "" -#: library/stdtypes.rst:4160 +#: library/stdtypes.rst:4159 msgid "The size in bytes of each element of the memoryview::" msgstr "" -#: library/stdtypes.rst:4173 +#: library/stdtypes.rst:4172 msgid "" "An integer indicating how many dimensions of a multi-dimensional array the " "memory represents." msgstr "" -#: library/stdtypes.rst:4178 +#: library/stdtypes.rst:4177 msgid "" "A tuple of integers the length of :attr:`ndim` giving the shape of the " "memory as an N-dimensional array." msgstr "" -#: library/stdtypes.rst:4189 +#: library/stdtypes.rst:4188 msgid "An empty tuple instead of ``None`` when ndim = 0." msgstr "" -#: library/stdtypes.rst:4186 +#: library/stdtypes.rst:4185 msgid "" "A tuple of integers the length of :attr:`ndim` giving the size in bytes to " "access each element for each dimension of the array." msgstr "" -#: library/stdtypes.rst:4194 +#: library/stdtypes.rst:4193 msgid "Used internally for PIL-style arrays. The value is informational only." msgstr "" -#: library/stdtypes.rst:4198 +#: library/stdtypes.rst:4197 msgid "A bool indicating whether the memory is C-:term:`contiguous`." msgstr "Belleğin C-:term:`contiguous` olup olmadığını gösteren bir bool." -#: library/stdtypes.rst:4204 +#: library/stdtypes.rst:4203 msgid "A bool indicating whether the memory is Fortran :term:`contiguous`." msgstr "Belleğin Fortran :term:`contiguous` olup olmadığını gösteren bir bool." -#: library/stdtypes.rst:4210 +#: library/stdtypes.rst:4209 msgid "A bool indicating whether the memory is :term:`contiguous`." msgstr "Belleğin :term:`contiguous` olup olmadığını gösteren bir bool." -#: library/stdtypes.rst:4218 +#: library/stdtypes.rst:4217 msgid "Set Types --- :class:`set`, :class:`frozenset`" msgstr "Set Türleri --- :class:`set`, :class:`frozenset`" -#: library/stdtypes.rst:4222 +#: library/stdtypes.rst:4221 msgid "" "A :dfn:`set` object is an unordered collection of distinct :term:`hashable` " "objects. Common uses include membership testing, removing duplicates from a " @@ -5194,7 +5195,7 @@ msgstr "" "için yerleşik :class:`dict`, :class:`list` ve :class:`tuple` sınıflarına ve :" "mod:`collections` modülüne bakın)" -#: library/stdtypes.rst:4229 +#: library/stdtypes.rst:4228 msgid "" "Like other collections, sets support ``x in set``, ``len(set)``, and ``for x " "in set``. Being an unordered collection, sets do not record element " @@ -5206,7 +5207,7 @@ msgstr "" "eleman konumunu veya ekleme sırasını kaydetmez. Buna göre, kümeler " "dizinleme, dilimleme veya sıra benzeri davranışları desteklemez." -#: library/stdtypes.rst:4234 +#: library/stdtypes.rst:4233 msgid "" "There are currently two built-in set types, :class:`set` and :class:" "`frozenset`. The :class:`set` type is mutable --- the contents can be " @@ -5225,7 +5226,7 @@ msgstr "" "term:`hashable` --- içeriği oluşturulduktan sonra değiştirilemez; bu nedenle " "bir sözlük anahtarı veya başka bir kümenin öğesi olarak kullanılabilir." -#: library/stdtypes.rst:4242 +#: library/stdtypes.rst:4241 msgid "" "Non-empty sets (not frozensets) can be created by placing a comma-separated " "list of elements within braces, for example: ``{'jack', 'sjoerd'}``, in " @@ -5235,11 +5236,11 @@ msgstr "" "parantez içine virgülle ayrılmış bir öğe listesi yerleştirilerek " "oluşturulabilir, örneğin: ``{'jack', 'sjoerd'}``." -#: library/stdtypes.rst:4246 +#: library/stdtypes.rst:4245 msgid "The constructors for both classes work the same:" msgstr "Her iki sınıfın kurucuları aynı şekilde çalışır:" -#: library/stdtypes.rst:4251 +#: library/stdtypes.rst:4250 msgid "" "Return a new set or frozenset object whose elements are taken from " "*iterable*. The elements of a set must be :term:`hashable`. To represent " @@ -5251,24 +5252,24 @@ msgstr "" "kümelerini temsil etmek için, iç kümeler :class:`frozenset` nesneleri " "olmalıdır. Eğer *iterable* belirtilmemişse, yeni bir boş küme döndürülür." -#: library/stdtypes.rst:4257 +#: library/stdtypes.rst:4256 msgid "Sets can be created by several means:" msgstr "Setler çeşitli yollarla oluşturulabilir:" -#: library/stdtypes.rst:4259 +#: library/stdtypes.rst:4258 msgid "" "Use a comma-separated list of elements within braces: ``{'jack', 'sjoerd'}``" msgstr "" "Parantez içinde virgülle ayrılmış bir öğe listesi kullanın: ``{'jack', " "'sjoerd'}``" -#: library/stdtypes.rst:4260 +#: library/stdtypes.rst:4259 msgid "" "Use a set comprehension: ``{c for c in 'abracadabra' if c not in 'abc'}``" msgstr "" "Bir küme kavrayışı kullanın: ``{c for c in 'abracadabra' if c not in 'abc'}``" -#: library/stdtypes.rst:4261 +#: library/stdtypes.rst:4260 msgid "" "Use the type constructor: ``set()``, ``set('foobar')``, ``set(['a', 'b', " "'foo'])``" @@ -5276,26 +5277,26 @@ msgstr "" "Tür kurucusunu kullanın: ``set()``, ``set('foobar')``, ``set(['a', 'b', " "'foo'])``" -#: library/stdtypes.rst:4263 +#: library/stdtypes.rst:4262 msgid "" "Instances of :class:`set` and :class:`frozenset` provide the following " "operations:" msgstr "" ":class:`set` ve :class:`frozenset` örnekleri aşağıdaki işlemleri sağlar:" -#: library/stdtypes.rst:4268 +#: library/stdtypes.rst:4267 msgid "Return the number of elements in set *s* (cardinality of *s*)." msgstr "*s* kümesindeki eleman sayısını döndürür (*s*'nin kardinalitesi)." -#: library/stdtypes.rst:4272 +#: library/stdtypes.rst:4271 msgid "Test *x* for membership in *s*." msgstr "*x*'i *s* üyeliği için test edin." -#: library/stdtypes.rst:4276 +#: library/stdtypes.rst:4275 msgid "Test *x* for non-membership in *s*." msgstr "*x*'in *s*'ye üye olup olmadığını test edin." -#: library/stdtypes.rst:4280 +#: library/stdtypes.rst:4279 msgid "" "Return ``True`` if the set has no elements in common with *other*. Sets are " "disjoint if and only if their intersection is the empty set." @@ -5303,11 +5304,11 @@ msgstr "" "Kümenin *other* kümelerle ortak hiçbir elemanı yoksa ``True`` döndürür. " "Kümeler, ancak ve ancak kesişimleri boş küme ise ayrıktır." -#: library/stdtypes.rst:4286 +#: library/stdtypes.rst:4285 msgid "Test whether every element in the set is in *other*." msgstr "Kümedeki her elemanın *other* içinde olup olmadığını test edin." -#: library/stdtypes.rst:4290 +#: library/stdtypes.rst:4289 msgid "" "Test whether the set is a proper subset of *other*, that is, ``set <= other " "and set != other``." @@ -5315,11 +5316,11 @@ msgstr "" "Kümenin *other* kümenin uygun bir alt kümesi olup olmadığını, yani ``set <= " "other and set != other`` olup olmadığını test eder." -#: library/stdtypes.rst:4296 +#: library/stdtypes.rst:4295 msgid "Test whether every element in *other* is in the set." msgstr "Kümedeki her elemanın *other* içinde olup olmadığını test edin." -#: library/stdtypes.rst:4300 +#: library/stdtypes.rst:4299 msgid "" "Test whether the set is a proper superset of *other*, that is, ``set >= " "other and set != other``." @@ -5327,33 +5328,33 @@ msgstr "" "Kümenin *other* kümenin uygun bir üst kümesi olup olmadığını, yani ``set >= " "other and set != other`` olup olmadığını test edin." -#: library/stdtypes.rst:4306 +#: library/stdtypes.rst:4305 msgid "Return a new set with elements from the set and all others." msgstr "" "Kümedeki ve diğer tüm kümelerdeki elemanları içeren yeni bir küme döndürür." -#: library/stdtypes.rst:4311 +#: library/stdtypes.rst:4310 msgid "Return a new set with elements common to the set and all others." msgstr "" "Küme ve diğer tüm kümeler için ortak öğeler içeren yeni bir küme döndürür." -#: library/stdtypes.rst:4316 +#: library/stdtypes.rst:4315 msgid "Return a new set with elements in the set that are not in the others." msgstr "" "Küme içinde diğerlerinde olmayan elemanlar içeren yeni bir küme döndürür." -#: library/stdtypes.rst:4321 +#: library/stdtypes.rst:4320 msgid "" "Return a new set with elements in either the set or *other* but not both." msgstr "" "Elemanları ya kümede ya da *diğer* kümede olan ancak her ikisinde de olmayan " "yeni bir küme döndürür." -#: library/stdtypes.rst:4325 +#: library/stdtypes.rst:4324 msgid "Return a shallow copy of the set." msgstr "Kümenin yüzeysel bir kopyasını döndürür." -#: library/stdtypes.rst:4328 +#: library/stdtypes.rst:4327 msgid "" "Note, the non-operator versions of :meth:`union`, :meth:`intersection`, :" "meth:`difference`, :meth:`symmetric_difference`, :meth:`issubset`, and :meth:" @@ -5371,7 +5372,7 @@ msgstr "" "\n" "Translated with www.DeepL.com/Translator (free version)" -#: library/stdtypes.rst:4335 +#: library/stdtypes.rst:4334 msgid "" "Both :class:`set` and :class:`frozenset` support set to set comparisons. Two " "sets are equal if and only if every element of each set is contained in the " @@ -5390,7 +5391,7 @@ msgstr "" "\n" "Translated with www.DeepL.com/Translator (free version)" -#: library/stdtypes.rst:4342 +#: library/stdtypes.rst:4341 msgid "" "Instances of :class:`set` are compared to instances of :class:`frozenset` " "based on their members. For example, ``set('abc') == frozenset('abc')`` " @@ -5400,7 +5401,7 @@ msgstr "" "karşılaştırılır. Örneğin, ``set('abc') == frozenset('abc')`` ``True`` " "döndürür ve ``set('abc') in set([frozenset('abc')])`` de öyle." -#: library/stdtypes.rst:4346 +#: library/stdtypes.rst:4345 msgid "" "The subset and equality comparisons do not generalize to a total ordering " "function. For example, any two nonempty disjoint sets are not equal and are " @@ -5412,7 +5413,7 @@ msgstr "" "değildir ve birbirinin alt kümesi değildir, bu nedenle aşağıdakilerin *all* " "``Yanlış`` döndürür: ``ab``." -#: library/stdtypes.rst:4351 +#: library/stdtypes.rst:4350 msgid "" "Since sets only define partial ordering (subset relationships), the output " "of the :meth:`list.sort` method is undefined for lists of sets." @@ -5420,11 +5421,11 @@ msgstr "" "Kümeler yalnızca kısmi sıralama (alt küme ilişkileri) tanımladığından, :meth:" "`list.sort` yönteminin çıktısı küme listeleri için tanımsızdır." -#: library/stdtypes.rst:4354 +#: library/stdtypes.rst:4353 msgid "Set elements, like dictionary keys, must be :term:`hashable`." msgstr "Sözlük anahtarları gibi küme öğeleri de :term:`hashable` olmalıdır." -#: library/stdtypes.rst:4356 +#: library/stdtypes.rst:4355 msgid "" "Binary operations that mix :class:`set` instances with :class:`frozenset` " "return the type of the first operand. For example: ``frozenset('ab') | " @@ -5434,7 +5435,7 @@ msgstr "" "ilk işlenenin türünü döndürür. Örneğin: ``frozenset('ab') | set('bc')`` " "bir :class:`frozenset` örneği döndürür." -#: library/stdtypes.rst:4360 +#: library/stdtypes.rst:4359 msgid "" "The following table lists operations available for :class:`set` that do not " "apply to immutable instances of :class:`frozenset`:" @@ -5442,31 +5443,31 @@ msgstr "" "Aşağıdaki tabloda :class:`set` için kullanılabilen ve :class:`frozenset` 'in " "değişmez örneklerine uygulanmayan işlemler listelenmektedir:" -#: library/stdtypes.rst:4366 +#: library/stdtypes.rst:4365 msgid "Update the set, adding elements from all others." msgstr "Diğer tüm öğeleri ekleyerek seti güncelleyin." -#: library/stdtypes.rst:4371 +#: library/stdtypes.rst:4370 msgid "Update the set, keeping only elements found in it and all others." msgstr "" "Yalnızca içinde bulunan öğeleri ve diğerlerini koruyarak seti güncelleyin." -#: library/stdtypes.rst:4376 +#: library/stdtypes.rst:4375 msgid "Update the set, removing elements found in others." msgstr "Diğerlerinde bulunan öğeleri kaldırarak kümeyi güncelleyin." -#: library/stdtypes.rst:4381 +#: library/stdtypes.rst:4380 msgid "" "Update the set, keeping only elements found in either set, but not in both." msgstr "" "Kümeyi güncelleyin, yalnızca her iki kümede de bulunan öğeleri saklayın, " "ancak her ikisinde de bulunmayın." -#: library/stdtypes.rst:4385 +#: library/stdtypes.rst:4384 msgid "Add element *elem* to the set." msgstr "Kümeye *elem* öğesini ekleyin." -#: library/stdtypes.rst:4389 +#: library/stdtypes.rst:4388 msgid "" "Remove element *elem* from the set. Raises :exc:`KeyError` if *elem* is not " "contained in the set." @@ -5474,11 +5475,11 @@ msgstr "" "Kümeden *elem* elemanını kaldırır. Eğer *elem* kümede bulunmuyorsa :exc:" "`KeyError` değerini yükseltir." -#: library/stdtypes.rst:4394 +#: library/stdtypes.rst:4393 msgid "Remove element *elem* from the set if it is present." msgstr "Eğer varsa *elem* öğesini kümeden kaldırır." -#: library/stdtypes.rst:4398 +#: library/stdtypes.rst:4397 msgid "" "Remove and return an arbitrary element from the set. Raises :exc:`KeyError` " "if the set is empty." @@ -5486,11 +5487,11 @@ msgstr "" "Kümeden rastgele bir elemanı kaldırır ve döndürür. Küme boşsa :exc:" "`KeyError` değerini yükseltir." -#: library/stdtypes.rst:4403 +#: library/stdtypes.rst:4402 msgid "Remove all elements from the set." msgstr "Kümeden tüm öğeleri kaldırın." -#: library/stdtypes.rst:4406 +#: library/stdtypes.rst:4405 msgid "" "Note, the non-operator versions of the :meth:`update`, :meth:" "`intersection_update`, :meth:`difference_update`, and :meth:" @@ -5501,7 +5502,7 @@ msgstr "" "ve :meth:`symmetric_difference_update` metotlarının operatör olmayan " "versiyonları herhangi bir iterable'ı argüman olarak kabul edecektir." -#: library/stdtypes.rst:4411 +#: library/stdtypes.rst:4410 #, fuzzy msgid "" "Note, the *elem* argument to the :meth:`~object.__contains__`, :meth:" @@ -5512,11 +5513,11 @@ msgstr "" "*elem* argümanı bir küme olabilir. Eş değer bir frozenset aramayı " "desteklemek için, *elem*'den geçici bir tane oluşturulur." -#: library/stdtypes.rst:4420 +#: library/stdtypes.rst:4419 msgid "Mapping Types --- :class:`dict`" msgstr "Mapping Types --- :class:`dict`" -#: library/stdtypes.rst:4430 +#: library/stdtypes.rst:4429 msgid "" "A :term:`mapping` object maps :term:`hashable` values to arbitrary objects. " "Mappings are mutable objects. There is currently only one standard mapping " @@ -5530,7 +5531,7 @@ msgstr "" "class:`list`, :class:`set` ve :class:`tuple` sınıflarına ve :mod:" "`collections` modülüne bakın)." -#: library/stdtypes.rst:4436 +#: library/stdtypes.rst:4435 msgid "" "A dictionary's keys are *almost* arbitrary values. Values that are not :" "term:`hashable`, that is, values containing lists, dictionaries or other " @@ -5545,7 +5546,7 @@ msgstr "" "``True`` gibi) aynı sözlük girdisini indekslemek için birbirinin yerine " "kullanılabilir." -#: library/stdtypes.rst:4447 +#: library/stdtypes.rst:4446 msgid "" "Return a new dictionary initialized from an optional positional argument and " "a possibly empty set of keyword arguments." @@ -5553,27 +5554,27 @@ msgstr "" "İsteğe bağlı bir konumsal bağımsız değişken ve muhtemelen boş bir anahtar " "sözcük bağımsız değişken kümesinden başlatılan yeni bir sözlük döndürür." -#: library/stdtypes.rst:4450 +#: library/stdtypes.rst:4449 msgid "Dictionaries can be created by several means:" msgstr "Sözlükler çeşitli yollarla oluşturulabilir:" -#: library/stdtypes.rst:4452 +#: library/stdtypes.rst:4451 msgid "" "Use a comma-separated list of ``key: value`` pairs within braces: ``{'jack': " "4098, 'sjoerd': 4127}`` or ``{4098: 'jack', 4127: 'sjoerd'}``" msgstr "" -#: library/stdtypes.rst:4454 +#: library/stdtypes.rst:4453 msgid "Use a dict comprehension: ``{}``, ``{x: x ** 2 for x in range(10)}``" msgstr "" -#: library/stdtypes.rst:4455 +#: library/stdtypes.rst:4454 msgid "" "Use the type constructor: ``dict()``, ``dict([('foo', 100), ('bar', " "200)])``, ``dict(foo=100, bar=200)``" msgstr "" -#: library/stdtypes.rst:4458 +#: library/stdtypes.rst:4457 msgid "" "If no positional argument is given, an empty dictionary is created. If a " "positional argument is given and it is a mapping object, a dictionary is " @@ -5585,7 +5586,7 @@ msgid "" "value for that key becomes the corresponding value in the new dictionary." msgstr "" -#: library/stdtypes.rst:4468 +#: library/stdtypes.rst:4467 msgid "" "If keyword arguments are given, the keyword arguments and their values are " "added to the dictionary created from the positional argument. If a key " @@ -5593,39 +5594,39 @@ msgid "" "the value from the positional argument." msgstr "" -#: library/stdtypes.rst:4473 +#: library/stdtypes.rst:4472 msgid "" "To illustrate, the following examples all return a dictionary equal to " "``{\"one\": 1, \"two\": 2, \"three\": 3}``::" msgstr "" -#: library/stdtypes.rst:4485 +#: library/stdtypes.rst:4484 msgid "" "Providing keyword arguments as in the first example only works for keys that " "are valid Python identifiers. Otherwise, any valid keys can be used." msgstr "" -#: library/stdtypes.rst:4489 +#: library/stdtypes.rst:4488 msgid "" "These are the operations that dictionaries support (and therefore, custom " "mapping types should support too):" msgstr "" -#: library/stdtypes.rst:4494 +#: library/stdtypes.rst:4493 msgid "Return a list of all the keys used in the dictionary *d*." msgstr "" -#: library/stdtypes.rst:4498 +#: library/stdtypes.rst:4497 msgid "Return the number of items in the dictionary *d*." msgstr "" -#: library/stdtypes.rst:4502 +#: library/stdtypes.rst:4501 msgid "" "Return the item of *d* with key *key*. Raises a :exc:`KeyError` if *key* is " "not in the map." msgstr "" -#: library/stdtypes.rst:4507 +#: library/stdtypes.rst:4506 msgid "" "If a subclass of dict defines a method :meth:`__missing__` and *key* is not " "present, the ``d[key]`` operation calls that method with the key *key* as " @@ -5636,51 +5637,51 @@ msgid "" "an instance variable::" msgstr "" -#: library/stdtypes.rst:4526 +#: library/stdtypes.rst:4525 msgid "" "The example above shows part of the implementation of :class:`collections." "Counter`. A different ``__missing__`` method is used by :class:`collections." "defaultdict`." msgstr "" -#: library/stdtypes.rst:4532 +#: library/stdtypes.rst:4531 msgid "Set ``d[key]`` to *value*." msgstr "" -#: library/stdtypes.rst:4536 +#: library/stdtypes.rst:4535 msgid "" "Remove ``d[key]`` from *d*. Raises a :exc:`KeyError` if *key* is not in the " "map." msgstr "" -#: library/stdtypes.rst:4541 +#: library/stdtypes.rst:4540 msgid "Return ``True`` if *d* has a key *key*, else ``False``." msgstr "" -#: library/stdtypes.rst:4545 +#: library/stdtypes.rst:4544 msgid "Equivalent to ``not key in d``." msgstr "" -#: library/stdtypes.rst:4549 +#: library/stdtypes.rst:4548 msgid "" "Return an iterator over the keys of the dictionary. This is a shortcut for " "``iter(d.keys())``." msgstr "" -#: library/stdtypes.rst:4554 +#: library/stdtypes.rst:4553 msgid "Remove all items from the dictionary." msgstr "" -#: library/stdtypes.rst:4558 +#: library/stdtypes.rst:4557 msgid "Return a shallow copy of the dictionary." msgstr "" -#: library/stdtypes.rst:4562 +#: library/stdtypes.rst:4561 msgid "" "Create a new dictionary with keys from *iterable* and values set to *value*." msgstr "" -#: library/stdtypes.rst:4564 +#: library/stdtypes.rst:4563 msgid "" ":meth:`fromkeys` is a class method that returns a new dictionary. *value* " "defaults to ``None``. All of the values refer to just a single instance, so " @@ -5689,70 +5690,70 @@ msgid "" "` instead." msgstr "" -#: library/stdtypes.rst:4572 +#: library/stdtypes.rst:4571 msgid "" "Return the value for *key* if *key* is in the dictionary, else *default*. If " "*default* is not given, it defaults to ``None``, so that this method never " "raises a :exc:`KeyError`." msgstr "" -#: library/stdtypes.rst:4578 +#: library/stdtypes.rst:4577 msgid "" "Return a new view of the dictionary's items (``(key, value)`` pairs). See " "the :ref:`documentation of view objects `." msgstr "" -#: library/stdtypes.rst:4583 +#: library/stdtypes.rst:4582 msgid "" "Return a new view of the dictionary's keys. See the :ref:`documentation of " "view objects `." msgstr "" -#: library/stdtypes.rst:4588 +#: library/stdtypes.rst:4587 msgid "" "If *key* is in the dictionary, remove it and return its value, else return " "*default*. If *default* is not given and *key* is not in the dictionary, a :" "exc:`KeyError` is raised." msgstr "" -#: library/stdtypes.rst:4594 +#: library/stdtypes.rst:4593 msgid "" "Remove and return a ``(key, value)`` pair from the dictionary. Pairs are " "returned in :abbr:`LIFO (last-in, first-out)` order." msgstr "" -#: library/stdtypes.rst:4597 +#: library/stdtypes.rst:4596 msgid "" ":meth:`popitem` is useful to destructively iterate over a dictionary, as " "often used in set algorithms. If the dictionary is empty, calling :meth:" "`popitem` raises a :exc:`KeyError`." msgstr "" -#: library/stdtypes.rst:4601 +#: library/stdtypes.rst:4600 msgid "" "LIFO order is now guaranteed. In prior versions, :meth:`popitem` would " "return an arbitrary key/value pair." msgstr "" -#: library/stdtypes.rst:4607 +#: library/stdtypes.rst:4606 msgid "" "Return a reverse iterator over the keys of the dictionary. This is a " "shortcut for ``reversed(d.keys())``." msgstr "" -#: library/stdtypes.rst:4614 +#: library/stdtypes.rst:4613 msgid "" "If *key* is in the dictionary, return its value. If not, insert *key* with " "a value of *default* and return *default*. *default* defaults to ``None``." msgstr "" -#: library/stdtypes.rst:4620 +#: library/stdtypes.rst:4619 msgid "" "Update the dictionary with the key/value pairs from *other*, overwriting " "existing keys. Return ``None``." msgstr "" -#: library/stdtypes.rst:4623 +#: library/stdtypes.rst:4622 msgid "" ":meth:`update` accepts either another dictionary object or an iterable of " "key/value pairs (as tuples or other iterables of length two). If keyword " @@ -5760,71 +5761,71 @@ msgid "" "pairs: ``d.update(red=1, blue=2)``." msgstr "" -#: library/stdtypes.rst:4630 +#: library/stdtypes.rst:4629 msgid "" "Return a new view of the dictionary's values. See the :ref:`documentation " "of view objects `." msgstr "" -#: library/stdtypes.rst:4633 +#: library/stdtypes.rst:4632 msgid "" "An equality comparison between one ``dict.values()`` view and another will " "always return ``False``. This also applies when comparing ``dict.values()`` " "to itself::" msgstr "" -#: library/stdtypes.rst:4643 +#: library/stdtypes.rst:4642 msgid "" "Create a new dictionary with the merged keys and values of *d* and *other*, " "which must both be dictionaries. The values of *other* take priority when " "*d* and *other* share keys." msgstr "" -#: library/stdtypes.rst:4651 +#: library/stdtypes.rst:4650 msgid "" "Update the dictionary *d* with keys and values from *other*, which may be " "either a :term:`mapping` or an :term:`iterable` of key/value pairs. The " "values of *other* take priority when *d* and *other* share keys." msgstr "" -#: library/stdtypes.rst:4657 +#: library/stdtypes.rst:4656 msgid "" "Dictionaries compare equal if and only if they have the same ``(key, " "value)`` pairs (regardless of ordering). Order comparisons ('<', '<=', '>=', " "'>') raise :exc:`TypeError`." msgstr "" -#: library/stdtypes.rst:4661 +#: library/stdtypes.rst:4660 msgid "" "Dictionaries preserve insertion order. Note that updating a key does not " "affect the order. Keys added after deletion are inserted at the end. ::" msgstr "" -#: library/stdtypes.rst:4679 +#: library/stdtypes.rst:4678 msgid "" "Dictionary order is guaranteed to be insertion order. This behavior was an " "implementation detail of CPython from 3.6." msgstr "" -#: library/stdtypes.rst:4683 +#: library/stdtypes.rst:4682 msgid "Dictionaries and dictionary views are reversible. ::" msgstr "" -#: library/stdtypes.rst:4695 +#: library/stdtypes.rst:4694 msgid "Dictionaries are now reversible." msgstr "" -#: library/stdtypes.rst:4700 +#: library/stdtypes.rst:4699 msgid "" ":class:`types.MappingProxyType` can be used to create a read-only view of a :" "class:`dict`." msgstr "" -#: library/stdtypes.rst:4707 +#: library/stdtypes.rst:4706 msgid "Dictionary view objects" msgstr "" -#: library/stdtypes.rst:4709 +#: library/stdtypes.rst:4708 msgid "" "The objects returned by :meth:`dict.keys`, :meth:`dict.values` and :meth:" "`dict.items` are *view objects*. They provide a dynamic view on the " @@ -5832,23 +5833,23 @@ msgid "" "reflects these changes." msgstr "" -#: library/stdtypes.rst:4714 +#: library/stdtypes.rst:4713 msgid "" "Dictionary views can be iterated over to yield their respective data, and " "support membership tests:" msgstr "" -#: library/stdtypes.rst:4719 +#: library/stdtypes.rst:4718 msgid "Return the number of entries in the dictionary." msgstr "" -#: library/stdtypes.rst:4723 +#: library/stdtypes.rst:4722 msgid "" "Return an iterator over the keys, values or items (represented as tuples of " "``(key, value)``) in the dictionary." msgstr "" -#: library/stdtypes.rst:4726 +#: library/stdtypes.rst:4725 msgid "" "Keys and values are iterated over in insertion order. This allows the " "creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = zip(d." @@ -5856,39 +5857,39 @@ msgid "" "[(v, k) for (k, v) in d.items()]``." msgstr "" -#: library/stdtypes.rst:4731 +#: library/stdtypes.rst:4730 msgid "" "Iterating views while adding or deleting entries in the dictionary may raise " "a :exc:`RuntimeError` or fail to iterate over all entries." msgstr "" -#: library/stdtypes.rst:4734 +#: library/stdtypes.rst:4733 msgid "Dictionary order is guaranteed to be insertion order." msgstr "" -#: library/stdtypes.rst:4739 +#: library/stdtypes.rst:4738 msgid "" "Return ``True`` if *x* is in the underlying dictionary's keys, values or " "items (in the latter case, *x* should be a ``(key, value)`` tuple)." msgstr "" -#: library/stdtypes.rst:4744 +#: library/stdtypes.rst:4743 msgid "" "Return a reverse iterator over the keys, values or items of the dictionary. " "The view will be iterated in reverse order of the insertion." msgstr "" -#: library/stdtypes.rst:4747 +#: library/stdtypes.rst:4746 msgid "Dictionary views are now reversible." msgstr "" -#: library/stdtypes.rst:4752 +#: library/stdtypes.rst:4751 msgid "" "Return a :class:`types.MappingProxyType` that wraps the original dictionary " "to which the view refers." msgstr "" -#: library/stdtypes.rst:4757 +#: library/stdtypes.rst:4756 msgid "" "Keys views are set-like since their entries are unique and :term:`hashable`. " "Items views also have set-like operations since the (key, value) pairs are " @@ -5902,15 +5903,15 @@ msgid "" "input." msgstr "" -#: library/stdtypes.rst:4769 +#: library/stdtypes.rst:4768 msgid "An example of dictionary view usage::" msgstr "" -#: library/stdtypes.rst:4813 +#: library/stdtypes.rst:4812 msgid "Context Manager Types" msgstr "Bağlam Yöneticisi Türleri" -#: library/stdtypes.rst:4820 +#: library/stdtypes.rst:4819 msgid "" "Python's :keyword:`with` statement supports the concept of a runtime context " "defined by a context manager. This is implemented using a pair of methods " @@ -5918,7 +5919,7 @@ msgid "" "before the statement body is executed and exited when the statement ends:" msgstr "" -#: library/stdtypes.rst:4828 +#: library/stdtypes.rst:4827 msgid "" "Enter the runtime context and return either this object or another object " "related to the runtime context. The value returned by this method is bound " @@ -5926,14 +5927,14 @@ msgid "" "using this context manager." msgstr "" -#: library/stdtypes.rst:4833 +#: library/stdtypes.rst:4832 msgid "" "An example of a context manager that returns itself is a :term:`file " "object`. File objects return themselves from __enter__() to allow :func:" "`open` to be used as the context expression in a :keyword:`with` statement." msgstr "" -#: library/stdtypes.rst:4837 +#: library/stdtypes.rst:4836 msgid "" "An example of a context manager that returns a related object is the one " "returned by :func:`decimal.localcontext`. These managers set the active " @@ -5943,7 +5944,7 @@ msgid "" "the :keyword:`!with` statement." msgstr "" -#: library/stdtypes.rst:4847 +#: library/stdtypes.rst:4846 msgid "" "Exit the runtime context and return a Boolean flag indicating if any " "exception that occurred should be suppressed. If an exception occurred while " @@ -5952,7 +5953,7 @@ msgid "" "arguments are ``None``." msgstr "" -#: library/stdtypes.rst:4852 +#: library/stdtypes.rst:4851 msgid "" "Returning a true value from this method will cause the :keyword:`with` " "statement to suppress the exception and continue execution with the " @@ -5963,7 +5964,7 @@ msgid "" "statement." msgstr "" -#: library/stdtypes.rst:4859 +#: library/stdtypes.rst:4858 msgid "" "The exception passed in should never be reraised explicitly - instead, this " "method should return a false value to indicate that the method completed " @@ -5972,7 +5973,7 @@ msgid "" "__exit__` method has actually failed." msgstr "" -#: library/stdtypes.rst:4865 +#: library/stdtypes.rst:4864 msgid "" "Python defines several context managers to support easy thread " "synchronisation, prompt closure of files or other objects, and simpler " @@ -5981,7 +5982,7 @@ msgid "" "management protocol. See the :mod:`contextlib` module for some examples." msgstr "" -#: library/stdtypes.rst:4871 +#: library/stdtypes.rst:4870 msgid "" "Python's :term:`generator`\\s and the :class:`contextlib.contextmanager` " "decorator provide a convenient way to implement these protocols. If a " @@ -5991,7 +5992,7 @@ msgid "" "rather than the iterator produced by an undecorated generator function." msgstr "" -#: library/stdtypes.rst:4878 +#: library/stdtypes.rst:4877 msgid "" "Note that there is no specific slot for any of these methods in the type " "structure for Python objects in the Python/C API. Extension types wanting to " @@ -6000,23 +6001,23 @@ msgid "" "a single class dictionary lookup is negligible." msgstr "" -#: library/stdtypes.rst:4886 +#: library/stdtypes.rst:4885 msgid "" "Type Annotation Types --- :ref:`Generic Alias `, :ref:" "`Union `" msgstr "" -#: library/stdtypes.rst:4891 +#: library/stdtypes.rst:4890 msgid "" "The core built-in types for :term:`type annotations ` are :ref:" "`Generic Alias ` and :ref:`Union `." msgstr "" -#: library/stdtypes.rst:4898 +#: library/stdtypes.rst:4897 msgid "Generic Alias Type" msgstr "Genel Takma Ad Türü" -#: library/stdtypes.rst:4904 +#: library/stdtypes.rst:4903 msgid "" "``GenericAlias`` objects are generally created by :ref:`subscripting " "` a class. They are most often used with :ref:`container " @@ -6026,13 +6027,13 @@ msgid "" "are intended primarily for use with :term:`type annotations `." msgstr "" -#: library/stdtypes.rst:4914 +#: library/stdtypes.rst:4913 msgid "" "It is generally only possible to subscript a class if the class implements " "the special method :meth:`~object.__class_getitem__`." msgstr "" -#: library/stdtypes.rst:4917 +#: library/stdtypes.rst:4916 msgid "" "A ``GenericAlias`` object acts as a proxy for a :term:`generic type`, " "implementing *parameterized generics*." @@ -6040,7 +6041,7 @@ msgstr "" "Bir ``GenericAlias`` nesnesi, :term:`generic type` için bir vekil olarak " "hareket eder ve *parameterized generics* uygular." -#: library/stdtypes.rst:4920 +#: library/stdtypes.rst:4919 msgid "" "For a container class, the argument(s) supplied to a :ref:`subscription " "` of the class may indicate the type(s) of the elements an " @@ -6049,7 +6050,7 @@ msgid "" "`bytes`." msgstr "" -#: library/stdtypes.rst:4926 +#: library/stdtypes.rst:4925 msgid "" "For a class which defines :meth:`~object.__class_getitem__` but is not a " "container, the argument(s) supplied to a subscription of the class will " @@ -6058,7 +6059,7 @@ msgid "" "the :class:`str` data type and the :class:`bytes` data type:" msgstr "" -#: library/stdtypes.rst:4932 +#: library/stdtypes.rst:4931 msgid "" "If ``x = re.search('foo', 'foo')``, ``x`` will be a :ref:`re.Match ` object where the return values of ``x.group(0)`` and ``x[0]`` will " @@ -6066,7 +6067,7 @@ msgid "" "annotations with the ``GenericAlias`` ``re.Match[str]``." msgstr "" -#: library/stdtypes.rst:4938 +#: library/stdtypes.rst:4937 msgid "" "If ``y = re.search(b'bar', b'bar')``, (note the ``b`` for :class:`bytes`), " "``y`` will also be an instance of ``re.Match``, but the return values of ``y." @@ -6075,7 +6076,7 @@ msgid "" "objects>` objects with ``re.Match[bytes]``." msgstr "" -#: library/stdtypes.rst:4944 +#: library/stdtypes.rst:4943 msgid "" "``GenericAlias`` objects are instances of the class :class:`types." "GenericAlias`, which can also be used to create ``GenericAlias`` objects " @@ -6084,7 +6085,7 @@ msgstr "" "``GenericAlias`` nesneleri, doğrudan ``GenericAlias`` nesneleri oluşturmak " "için de kullanılabilen :class:`types.GenericAlias` sınıfının örnekleridir." -#: library/stdtypes.rst:4950 +#: library/stdtypes.rst:4949 msgid "" "Creates a ``GenericAlias`` representing a type ``T`` parameterized by types " "*X*, *Y*, and more depending on the ``T`` used. For example, a function " @@ -6095,7 +6096,7 @@ msgstr "" "Örneğin, :class:`float` elemanları içeren bir :class:`list` bekleyen bir " "fonksiyon::" -#: library/stdtypes.rst:4958 +#: library/stdtypes.rst:4957 msgid "" "Another example for :term:`mapping` objects, using a :class:`dict`, which is " "a generic type expecting two type parameters representing the key type and " @@ -6107,7 +6108,7 @@ msgstr "" "başka bir örnek. Bu örnekte, fonksiyon :class:`str` türünde anahtarları ve :" "class:`int` türünde değerleri olan bir ``dict`` bekler::" -#: library/stdtypes.rst:4966 +#: library/stdtypes.rst:4965 msgid "" "The builtin functions :func:`isinstance` and :func:`issubclass` do not " "accept ``GenericAlias`` types for their second argument::" @@ -6115,7 +6116,7 @@ msgstr "" "Yerleşik :func:`isinstance` ve :func:`issubclass` işlevleri ikinci " "argümanları için ``GenericAlias`` türlerini kabul etmez::" -#: library/stdtypes.rst:4974 +#: library/stdtypes.rst:4973 msgid "" "The Python runtime does not enforce :term:`type annotations `. " "This extends to generic types and their type parameters. When creating a " @@ -6129,7 +6130,7 @@ msgstr "" "elemanlar türlerine göre kontrol edilmez. Örneğin, aşağıdaki kod tavsiye " "edilmez, ancak hatasız çalışacaktır::" -#: library/stdtypes.rst:4984 +#: library/stdtypes.rst:4983 msgid "" "Furthermore, parameterized generics erase type parameters during object " "creation::" @@ -6137,7 +6138,7 @@ msgstr "" "Ayrıca, parametrelendirilmiş jenerikler nesne oluşturma sırasında tip " "parametrelerini siler::" -#: library/stdtypes.rst:4995 +#: library/stdtypes.rst:4994 msgid "" "Calling :func:`repr` or :func:`str` on a generic shows the parameterized " "type::" @@ -6145,7 +6146,7 @@ msgstr "" "Bir jenerik üzerinde :func:`repr` veya :func:`str` çağrısı " "parametrelendirilmiş türü gösterir::" -#: library/stdtypes.rst:5003 +#: library/stdtypes.rst:5002 msgid "" "The :meth:`~object.__getitem__` method of generic containers will raise an " "exception to disallow mistakes like ``dict[str][str]``::" @@ -6153,7 +6154,7 @@ msgstr "" "Genel kapsayıcıların :meth:`~object.__getitem__` metodu, ``dict[str][str]`` " "gibi hatalara izin vermemek için bir istisna oluşturacaktır::" -#: library/stdtypes.rst:5011 +#: library/stdtypes.rst:5010 msgid "" "However, such expressions are valid when :ref:`type variables ` " "are used. The index must have as many elements as there are type variable " @@ -6163,11 +6164,11 @@ msgstr "" "geçerlidir. Dizin, ``GenericAlias`` nesnesinin :attr:`~genericalias." "__args__` öğesindeki tür değişkeni öğeleri kadar öğeye sahip olmalıdır::" -#: library/stdtypes.rst:5022 +#: library/stdtypes.rst:5021 msgid "Standard Generic Classes" msgstr "Standart Jenerik Sınıflar" -#: library/stdtypes.rst:5024 +#: library/stdtypes.rst:5023 msgid "" "The following standard library classes support parameterized generics. This " "list is non-exhaustive." @@ -6175,235 +6176,235 @@ msgstr "" "Bu standart kütüphane sınıfları parametrelendirilmiş jenerikleri destekler. " "Bu liste kapsamlı değildir." -#: library/stdtypes.rst:5027 +#: library/stdtypes.rst:5026 msgid ":class:`tuple`" msgstr ":class:`tuple`" -#: library/stdtypes.rst:5028 +#: library/stdtypes.rst:5027 msgid ":class:`list`" msgstr ":class:`list`" -#: library/stdtypes.rst:5029 +#: library/stdtypes.rst:5028 msgid ":class:`dict`" msgstr ":class:`dict`" -#: library/stdtypes.rst:5030 +#: library/stdtypes.rst:5029 msgid ":class:`set`" msgstr ":class:`set`" -#: library/stdtypes.rst:5031 +#: library/stdtypes.rst:5030 msgid ":class:`frozenset`" msgstr ":class:`frozenset`" -#: library/stdtypes.rst:5032 +#: library/stdtypes.rst:5031 msgid ":class:`type`" msgstr ":class:`type`" -#: library/stdtypes.rst:5033 +#: library/stdtypes.rst:5032 msgid ":class:`collections.deque`" msgstr ":class:`collections.deque`" -#: library/stdtypes.rst:5034 +#: library/stdtypes.rst:5033 msgid ":class:`collections.defaultdict`" msgstr ":class:`collections.defaultdict`" -#: library/stdtypes.rst:5035 +#: library/stdtypes.rst:5034 msgid ":class:`collections.OrderedDict`" msgstr ":class:`collections.OrderedDict`" -#: library/stdtypes.rst:5036 +#: library/stdtypes.rst:5035 msgid ":class:`collections.Counter`" msgstr ":class:`collections.Counter`" -#: library/stdtypes.rst:5037 +#: library/stdtypes.rst:5036 msgid ":class:`collections.ChainMap`" msgstr ":class:`collections.ChainMap`" -#: library/stdtypes.rst:5038 +#: library/stdtypes.rst:5037 msgid ":class:`collections.abc.Awaitable`" msgstr ":class:`collections.abc.Awaitable`" -#: library/stdtypes.rst:5039 +#: library/stdtypes.rst:5038 msgid ":class:`collections.abc.Coroutine`" msgstr ":class:`collections.abc.Coroutine`" -#: library/stdtypes.rst:5040 +#: library/stdtypes.rst:5039 msgid ":class:`collections.abc.AsyncIterable`" msgstr ":class:`collections.abc.AsyncIterable`" -#: library/stdtypes.rst:5041 +#: library/stdtypes.rst:5040 msgid ":class:`collections.abc.AsyncIterator`" msgstr ":class:`collections.abc.AsyncIterator`" -#: library/stdtypes.rst:5042 +#: library/stdtypes.rst:5041 msgid ":class:`collections.abc.AsyncGenerator`" msgstr ":class:`collections.abc.AsyncGenerator`" -#: library/stdtypes.rst:5043 +#: library/stdtypes.rst:5042 msgid ":class:`collections.abc.Iterable`" msgstr ":class:`collections.abc.Iterable`" -#: library/stdtypes.rst:5044 +#: library/stdtypes.rst:5043 msgid ":class:`collections.abc.Iterator`" msgstr ":class:`collections.abc.Iterator`" -#: library/stdtypes.rst:5045 +#: library/stdtypes.rst:5044 msgid ":class:`collections.abc.Generator`" msgstr ":class:`collections.abc.Generator`" -#: library/stdtypes.rst:5046 +#: library/stdtypes.rst:5045 msgid ":class:`collections.abc.Reversible`" msgstr ":class:`collections.abc.Reversible`" -#: library/stdtypes.rst:5047 +#: library/stdtypes.rst:5046 msgid ":class:`collections.abc.Container`" msgstr ":class:`collections.abc.Container`" -#: library/stdtypes.rst:5048 +#: library/stdtypes.rst:5047 msgid ":class:`collections.abc.Collection`" msgstr ":class:`collections.abc.Collection`" -#: library/stdtypes.rst:5049 +#: library/stdtypes.rst:5048 msgid ":class:`collections.abc.Callable`" msgstr ":class:`collections.abc.Callable`" -#: library/stdtypes.rst:5050 +#: library/stdtypes.rst:5049 msgid ":class:`collections.abc.Set`" msgstr ":class:`collections.abc.Set`" -#: library/stdtypes.rst:5051 +#: library/stdtypes.rst:5050 msgid ":class:`collections.abc.MutableSet`" msgstr ":class:`collections.abc.MutableSet`" -#: library/stdtypes.rst:5052 +#: library/stdtypes.rst:5051 msgid ":class:`collections.abc.Mapping`" msgstr ":class:`collections.abc.Mapping`" -#: library/stdtypes.rst:5053 +#: library/stdtypes.rst:5052 msgid ":class:`collections.abc.MutableMapping`" msgstr ":class:`collections.abc.MutableMapping`" -#: library/stdtypes.rst:5054 +#: library/stdtypes.rst:5053 msgid ":class:`collections.abc.Sequence`" msgstr ":class:`collections.abc.Sequence`" -#: library/stdtypes.rst:5055 +#: library/stdtypes.rst:5054 msgid ":class:`collections.abc.MutableSequence`" msgstr ":class:`collections.abc.MutableSequence`" -#: library/stdtypes.rst:5056 +#: library/stdtypes.rst:5055 msgid ":class:`collections.abc.ByteString`" msgstr ":class:`collections.abc.ByteString`" -#: library/stdtypes.rst:5057 +#: library/stdtypes.rst:5056 msgid ":class:`collections.abc.MappingView`" msgstr ":class:`collections.abc.MappingView`" -#: library/stdtypes.rst:5058 +#: library/stdtypes.rst:5057 msgid ":class:`collections.abc.KeysView`" msgstr ":class:`collections.abc.KeysView`" -#: library/stdtypes.rst:5059 +#: library/stdtypes.rst:5058 msgid ":class:`collections.abc.ItemsView`" msgstr ":class:`collections.abc.ItemsView`" -#: library/stdtypes.rst:5060 +#: library/stdtypes.rst:5059 msgid ":class:`collections.abc.ValuesView`" msgstr ":class:`collections.abc.ValuesView`" -#: library/stdtypes.rst:5061 +#: library/stdtypes.rst:5060 msgid ":class:`contextlib.AbstractContextManager`" msgstr ":class:`contextlib.AbstractContextManager`" -#: library/stdtypes.rst:5062 +#: library/stdtypes.rst:5061 msgid ":class:`contextlib.AbstractAsyncContextManager`" msgstr ":class:`contextlib.AbstractAsyncContextManager`" -#: library/stdtypes.rst:5063 +#: library/stdtypes.rst:5062 msgid ":class:`dataclasses.Field`" msgstr ":class:`dataclasses.Field`" -#: library/stdtypes.rst:5064 +#: library/stdtypes.rst:5063 msgid ":class:`functools.cached_property`" msgstr ":class:`functools.cached_property`" -#: library/stdtypes.rst:5065 +#: library/stdtypes.rst:5064 msgid ":class:`functools.partialmethod`" msgstr "" -#: library/stdtypes.rst:5066 +#: library/stdtypes.rst:5065 msgid ":class:`os.PathLike`" msgstr ":class:`os.PathLike`" -#: library/stdtypes.rst:5067 +#: library/stdtypes.rst:5066 msgid ":class:`queue.LifoQueue`" msgstr ":class:`queue.LifoQueue`" -#: library/stdtypes.rst:5068 +#: library/stdtypes.rst:5067 msgid ":class:`queue.Queue`" msgstr ":class:`queue.Queue`" -#: library/stdtypes.rst:5069 +#: library/stdtypes.rst:5068 msgid ":class:`queue.PriorityQueue`" msgstr ":class:`queue.PriorityQueue`" -#: library/stdtypes.rst:5070 +#: library/stdtypes.rst:5069 msgid ":class:`queue.SimpleQueue`" msgstr ":class:`tuple`" -#: library/stdtypes.rst:5071 +#: library/stdtypes.rst:5070 msgid ":ref:`re.Pattern `" msgstr ":ref:`re.Pattern `" -#: library/stdtypes.rst:5072 +#: library/stdtypes.rst:5071 msgid ":ref:`re.Match `" msgstr ":ref:`re.Match `" -#: library/stdtypes.rst:5073 +#: library/stdtypes.rst:5072 msgid ":class:`shelve.BsdDbShelf`" msgstr ":class:`shelve.BsdDbShelf`" -#: library/stdtypes.rst:5074 +#: library/stdtypes.rst:5073 msgid ":class:`shelve.DbfilenameShelf`" msgstr ":class:`shelve.DbfilenameShelf`" -#: library/stdtypes.rst:5075 +#: library/stdtypes.rst:5074 msgid ":class:`shelve.Shelf`" msgstr ":class:`shelve.Shelf`" -#: library/stdtypes.rst:5076 +#: library/stdtypes.rst:5075 msgid ":class:`types.MappingProxyType`" msgstr ":class:`types.MappingProxyType`" -#: library/stdtypes.rst:5077 +#: library/stdtypes.rst:5076 msgid ":class:`weakref.WeakKeyDictionary`" msgstr "" -#: library/stdtypes.rst:5078 +#: library/stdtypes.rst:5077 msgid ":class:`weakref.WeakMethod`" msgstr "" -#: library/stdtypes.rst:5079 +#: library/stdtypes.rst:5078 msgid ":class:`weakref.WeakSet`" msgstr ":class:`weakref.WeakSet`" -#: library/stdtypes.rst:5080 +#: library/stdtypes.rst:5079 msgid ":class:`weakref.WeakValueDictionary`" msgstr "" -#: library/stdtypes.rst:5085 +#: library/stdtypes.rst:5084 msgid "Special Attributes of ``GenericAlias`` objects" msgstr "``GenericAlias`` objesinin Özel Öznitelikleri" -#: library/stdtypes.rst:5087 +#: library/stdtypes.rst:5086 msgid "All parameterized generics implement special read-only attributes." msgstr "Tüm parametreli jenerikler özel salt okunur öznitelikler uygular." -#: library/stdtypes.rst:5091 +#: library/stdtypes.rst:5090 msgid "This attribute points at the non-parameterized generic class::" msgstr "Bu öznitelik, parametrelendirilmemiş genel sınıfa işaret eder::" -#: library/stdtypes.rst:5099 +#: library/stdtypes.rst:5098 msgid "" "This attribute is a :class:`tuple` (possibly of length 1) of generic types " "passed to the original :meth:`~object.__class_getitem__` of the generic " @@ -6413,7 +6414,7 @@ msgstr "" "öğesine iletilen jenerik tiplerinden bir :class:`tuple` 'dır (muhtemelen 1 " "uzunluğunda)::" -#: library/stdtypes.rst:5109 +#: library/stdtypes.rst:5108 msgid "" "This attribute is a lazily computed tuple (possibly empty) of unique type " "variables found in ``__args__``::" @@ -6421,7 +6422,7 @@ msgstr "" "Bu öznitelik, ''__args__'' içinde bulunan benzersiz tür değişkenlerin tembel " "bir şekilde hesaplanmış bir demetidir (muhtemelen boş):" -#: library/stdtypes.rst:5120 +#: library/stdtypes.rst:5119 msgid "" "A ``GenericAlias`` object with :class:`typing.ParamSpec` parameters may not " "have correct ``__parameters__`` after substitution because :class:`typing." @@ -6431,49 +6432,49 @@ msgstr "" "değiştirildikten sonra doğru ``__parameters__`` olmayabilir çünkü :class:" "`typing.ParamSpec` öncelikle statik tip kontrolü için tasarlanmıştır." -#: library/stdtypes.rst:5127 +#: library/stdtypes.rst:5126 msgid "" "A boolean that is true if the alias has been unpacked using the ``*`` " "operator (see :data:`~typing.TypeVarTuple`)." msgstr "" -#: library/stdtypes.rst:5136 +#: library/stdtypes.rst:5135 msgid ":pep:`484` - Type Hints" msgstr "" -#: library/stdtypes.rst:5136 +#: library/stdtypes.rst:5135 msgid "Introducing Python's framework for type annotations." msgstr "" -#: library/stdtypes.rst:5141 +#: library/stdtypes.rst:5140 msgid ":pep:`585` - Type Hinting Generics In Standard Collections" msgstr "" ":pep:`585` - Standart Koleksiyonlarda Tip İma Etme (Type Hinting) Jenerikleri" -#: library/stdtypes.rst:5139 +#: library/stdtypes.rst:5138 msgid "" "Introducing the ability to natively parameterize standard-library classes, " "provided they implement the special class method :meth:`~object." "__class_getitem__`." msgstr "" -#: library/stdtypes.rst:5144 +#: library/stdtypes.rst:5143 msgid "" ":ref:`Generics`, :ref:`user-defined generics ` and :" "class:`typing.Generic`" msgstr "" -#: library/stdtypes.rst:5144 +#: library/stdtypes.rst:5143 msgid "" "Documentation on how to implement generic classes that can be parameterized " "at runtime and understood by static type-checkers." msgstr "" -#: library/stdtypes.rst:5153 +#: library/stdtypes.rst:5152 msgid "Union Type" msgstr "Sendika Türü" -#: library/stdtypes.rst:5159 +#: library/stdtypes.rst:5158 msgid "" "A union object holds the value of the ``|`` (bitwise or) operation on " "multiple :ref:`type objects `. These types are intended " @@ -6487,7 +6488,7 @@ msgstr "" "Birleşim türü ifadesi, aşağıdakilere kıyasla daha temiz tür ipucu sözdizimi " "sağlar :data:`typing.Union`." -#: library/stdtypes.rst:5166 +#: library/stdtypes.rst:5165 msgid "" "Defines a union object which holds types *X*, *Y*, and so forth. ``X | Y`` " "means either X or Y. It is equivalent to ``typing.Union[X, Y]``. For " @@ -6498,7 +6499,7 @@ msgstr "" "anlamına gelir. Bu, ``typing.Union[X, Y]`` ile eş değerdir. Örneğin, " "aşağıdaki işlev :class:`int` veya :class:`float`::" -#: library/stdtypes.rst:5176 +#: library/stdtypes.rst:5175 msgid "" "The ``|`` operand cannot be used at runtime to define unions where one or " "more members is a forward reference. For example, ``int | \"Foo\"``, where " @@ -6507,34 +6508,34 @@ msgid "" "a string, e.g. ``\"int | Foo\"``." msgstr "" -#: library/stdtypes.rst:5184 +#: library/stdtypes.rst:5183 msgid "" "Union objects can be tested for equality with other union objects. Details:" msgstr "" "Birlik nesneleri, diğer birlik nesneleriyle eşitlik açısından test " "edilebilir. Detaylar:" -#: library/stdtypes.rst:5186 +#: library/stdtypes.rst:5185 msgid "Unions of unions are flattened::" msgstr "Birliklerin birlikleri düzleştirimiştir::" -#: library/stdtypes.rst:5190 +#: library/stdtypes.rst:5189 msgid "Redundant types are removed::" msgstr "Gereksiz türler kaldırılır::" -#: library/stdtypes.rst:5194 +#: library/stdtypes.rst:5193 msgid "When comparing unions, the order is ignored::" msgstr "Birlikleri karşılaştırırken, sipariş göz ardı edilir::" -#: library/stdtypes.rst:5198 +#: library/stdtypes.rst:5197 msgid "It is compatible with :data:`typing.Union`::" msgstr ":data:`typing.Union`:: ile uyumludur:" -#: library/stdtypes.rst:5202 +#: library/stdtypes.rst:5201 msgid "Optional types can be spelled as a union with ``None``::" msgstr "İsteğe bağlı türler ``None``:: ile bir birlik olarak yazılabilir:" -#: library/stdtypes.rst:5209 +#: library/stdtypes.rst:5208 msgid "" "Calls to :func:`isinstance` and :func:`issubclass` are also supported with a " "union object::" @@ -6542,14 +6543,14 @@ msgstr "" ":func:`isinstance` ve :func:`issubclass` çağrıları da bir birlik nesnesiyle " "desteklenir::" -#: library/stdtypes.rst:5215 +#: library/stdtypes.rst:5214 #, fuzzy msgid "" "However, :ref:`parameterized generics ` in union objects " "cannot be checked::" msgstr "Ancak, :ref:`types-genericalias` içeren union nesneleri kullanılamaz::" -#: library/stdtypes.rst:5225 +#: library/stdtypes.rst:5224 msgid "" "The user-exposed type for the union object can be accessed from :data:`types." "UnionType` and used for :func:`isinstance` checks. An object cannot be " @@ -6559,7 +6560,7 @@ msgstr "" "erişilebilir ve :func:`isinstance` kontrolleri için kullanılabilir. Bir " "nesne şu türden örneklenemez::" -#: library/stdtypes.rst:5238 +#: library/stdtypes.rst:5237 #, fuzzy msgid "" "The :meth:`!__or__` method for type objects was added to support the syntax " @@ -6570,15 +6571,15 @@ msgstr "" "için eklendi. Eğer bir metaclass :meth:`__or__` metodunu uygularsa, Union " "bunu geçersiz kılabilir::" -#: library/stdtypes.rst:5258 +#: library/stdtypes.rst:5257 msgid ":pep:`604` -- PEP proposing the ``X | Y`` syntax and the Union type." msgstr ":pep:`604` -- ``X | Y`` sözdizimini ve Birlik türünü öneren PEP." -#: library/stdtypes.rst:5266 +#: library/stdtypes.rst:5265 msgid "Other Built-in Types" msgstr "Diğer Yerleşik Tipler" -#: library/stdtypes.rst:5268 +#: library/stdtypes.rst:5267 msgid "" "The interpreter supports several other kinds of objects. Most of these " "support only one or two operations." @@ -6586,11 +6587,11 @@ msgstr "" "Yorumlayıcı başka nesne türlerini de destekler. Bunların çoğu yalnızca bir " "veya iki işlemi destekler." -#: library/stdtypes.rst:5275 +#: library/stdtypes.rst:5274 msgid "Modules" msgstr "Modüller" -#: library/stdtypes.rst:5277 +#: library/stdtypes.rst:5276 msgid "" "The only special operation on a module is attribute access: ``m.name``, " "where *m* is a module and *name* accesses a name defined in *m*'s symbol " @@ -6608,7 +6609,7 @@ msgstr "" "bunun yerine bir yerlerde *foo* adında bir modül için (harici) bir " "*tanımlama* gerektirir)" -#: library/stdtypes.rst:5284 +#: library/stdtypes.rst:5283 msgid "" "A special attribute of every module is :attr:`~object.__dict__`. This is the " "dictionary containing the module's symbol table. Modifying this dictionary " @@ -6626,7 +6627,7 @@ msgstr "" "`` yazamazsınız). :attr:`~object.__dict__` öğesinin doğrudan değiştirilmesi " "önerilmez." -#: library/stdtypes.rst:5292 +#: library/stdtypes.rst:5291 msgid "" "Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````. Eğer bir dosyadan yüklenmişlerse, ```` şeklinde yazılırlar." -#: library/stdtypes.rst:5300 +#: library/stdtypes.rst:5299 msgid "Classes and Class Instances" msgstr "Sınıflar ve Sınıf Örnekleri" -#: library/stdtypes.rst:5302 +#: library/stdtypes.rst:5301 msgid "See :ref:`objects` and :ref:`class` for these." msgstr "Bunlar için :ref:`class` ve :ref:`objects` bakın." -#: library/stdtypes.rst:5308 +#: library/stdtypes.rst:5307 msgid "Functions" msgstr "Fonksiyonlar" -#: library/stdtypes.rst:5310 +#: library/stdtypes.rst:5309 msgid "" "Function objects are created by function definitions. The only operation on " "a function object is to call it: ``func(argument-list)``." @@ -6657,7 +6658,7 @@ msgstr "" "fonksiyon nesnesi üzerindeki tek işlem onu çağırmaktır: ``func(argument-" "list)``." -#: library/stdtypes.rst:5313 +#: library/stdtypes.rst:5312 msgid "" "There are really two flavors of function objects: built-in functions and " "user-defined functions. Both support the same operation (to call the " @@ -6669,15 +6670,15 @@ msgstr "" "çağırmak için), ancak uygulama farklıdır, dolayısıyla farklı nesne türleri " "vardır." -#: library/stdtypes.rst:5317 +#: library/stdtypes.rst:5316 msgid "See :ref:`function` for more information." msgstr "Daha fazla bilgi için :ref:`function` bölümüne bakınız." -#: library/stdtypes.rst:5323 +#: library/stdtypes.rst:5322 msgid "Methods" msgstr "Yöntemler" -#: library/stdtypes.rst:5327 +#: library/stdtypes.rst:5326 #, fuzzy msgid "" "Methods are functions that are called using the attribute notation. There " @@ -6690,7 +6691,7 @@ msgstr "" "yöntemleri. Yerleşik yöntemler, onları destekleyen türlerle birlikte " "tanımlanır." -#: library/stdtypes.rst:5332 +#: library/stdtypes.rst:5331 #, fuzzy msgid "" "If you access a method (a function defined in a class namespace) through an " @@ -6712,7 +6713,7 @@ msgstr "" "``m(arg-1, arg-2, ..., arg-n)`` çağrısı tamamen ``m.__func__(m.__self__, " "arg-1, arg-2, ..., arg-n)`` çağrısına eş değerdir." -#: library/stdtypes.rst:5343 +#: library/stdtypes.rst:5342 #, fuzzy msgid "" "Like :ref:`function objects `, bound method objects " @@ -6731,16 +6732,16 @@ msgstr "" "ayarlamak için, bunu temel işlev nesnesi üzerinde açıkça ayarlamanız " "gerekir::" -#: library/stdtypes.rst:5366 +#: library/stdtypes.rst:5365 #, fuzzy msgid "See :ref:`instance-methods` for more information." msgstr "Daha fazla bilgi için :ref:`types` sayfasına bakın." -#: library/stdtypes.rst:5374 +#: library/stdtypes.rst:5373 msgid "Code Objects" msgstr "Kod Nesneleri" -#: library/stdtypes.rst:5380 +#: library/stdtypes.rst:5379 #, fuzzy msgid "" "Code objects are used by the implementation to represent \"pseudo-compiled\" " @@ -6757,7 +6758,7 @@ msgstr "" "tarafından döndürülür ve :attr:`__code__` niteliği aracılığıyla işlev " "nesnelerinden çıkarılabilir. Ayrıca :mod:`code` modülüne de bakınız." -#: library/stdtypes.rst:5387 +#: library/stdtypes.rst:5386 #, fuzzy msgid "" "Accessing :attr:`~function.__code__` raises an :ref:`auditing event " @@ -6767,7 +6768,7 @@ msgstr "" "``__code__`` 'e erişmek,``obj`` ve ``\"__code__\"`` argümanlarıyla :ref:" "`denetim etkinliği ` ``object.__getattr__`` oluşturur." -#: library/stdtypes.rst:5394 +#: library/stdtypes.rst:5393 msgid "" "A code object can be executed or evaluated by passing it (instead of a " "source string) to the :func:`exec` or :func:`eval` built-in functions." @@ -6775,15 +6776,15 @@ msgstr "" "Bir kod nesnesi (kaynak dize yerine) :func:`exec` veya :func:`eval` yerleşik " "işlevlerine geçirilerek yürütülebilir veya değerlendirilebilir." -#: library/stdtypes.rst:5397 +#: library/stdtypes.rst:5396 msgid "See :ref:`types` for more information." msgstr "Daha fazla bilgi için :ref:`types` sayfasına bakın." -#: library/stdtypes.rst:5403 +#: library/stdtypes.rst:5402 msgid "Type Objects" msgstr "Type Objects" -#: library/stdtypes.rst:5409 +#: library/stdtypes.rst:5408 msgid "" "Type objects represent the various object types. An object's type is " "accessed by the built-in function :func:`type`. There are no special " @@ -6795,15 +6796,15 @@ msgstr "" "işlem yoktur. Standart modül :mod:`types` tüm standart yerleşik türler için " "isimleri tanımlar." -#: library/stdtypes.rst:5414 +#: library/stdtypes.rst:5413 msgid "Types are written like this: ````." msgstr "Türler şu şekilde yazılır: ````." -#: library/stdtypes.rst:5420 +#: library/stdtypes.rst:5419 msgid "The Null Object" msgstr "Null Nesne" -#: library/stdtypes.rst:5422 +#: library/stdtypes.rst:5421 msgid "" "This object is returned by functions that don't explicitly return a value. " "It supports no special operations. There is exactly one null object, named " @@ -6813,15 +6814,15 @@ msgstr "" "operasyonları desteklemez. Tam olarak ``None`` (yerleşik bir ad) adlı bir " "null nesne vardır. ``type(None)()`` aynı singleton'u üretir." -#: library/stdtypes.rst:5426 +#: library/stdtypes.rst:5425 msgid "It is written as ``None``." msgstr "''Yok'' olarak yazılmıştır." -#: library/stdtypes.rst:5433 +#: library/stdtypes.rst:5432 msgid "The Ellipsis Object" msgstr "Üç Nokta Nesnesi" -#: library/stdtypes.rst:5435 +#: library/stdtypes.rst:5434 msgid "" "This object is commonly used by slicing (see :ref:`slicings`). It supports " "no special operations. There is exactly one ellipsis object, named :const:" @@ -6833,15 +6834,15 @@ msgstr "" "ad) adında bir elips nesnesi vardır. ``type(Ellipsis)()``, :const:" "`Ellipsis` singletonunu üretir." -#: library/stdtypes.rst:5440 +#: library/stdtypes.rst:5439 msgid "It is written as ``Ellipsis`` or ``...``." msgstr "``Ellipsis`` veya ``...`` olarak yazılmıştır." -#: library/stdtypes.rst:5446 +#: library/stdtypes.rst:5445 msgid "The NotImplemented Object" msgstr "NotImplemented Nesnesi" -#: library/stdtypes.rst:5448 +#: library/stdtypes.rst:5447 #, fuzzy msgid "" "This object is returned from comparisons and binary operations when they are " @@ -6854,16 +6855,16 @@ msgstr "" "ref:`comparisons` sayfasına bakın. Tam olarak bir ``NotImplemented`` " "nesnesi vardır. ``type(NotImplemented)()``, singleton örneğini üretir." -#: library/stdtypes.rst:5453 +#: library/stdtypes.rst:5452 #, fuzzy msgid "It is written as :code:`NotImplemented`." msgstr "''NotImplemented'' olarak yazılmıştır." -#: library/stdtypes.rst:5459 +#: library/stdtypes.rst:5458 msgid "Internal Objects" msgstr "İç Nesneler" -#: library/stdtypes.rst:5461 +#: library/stdtypes.rst:5460 #, fuzzy msgid "" "See :ref:`types` for this information. It describes :ref:`stack frame " @@ -6873,11 +6874,11 @@ msgstr "" "Bu bilgi için :ref:`types` sayfasına bakın. Yığın çerçeve nesnelerini, geri " "izleme nesnelerini ve dilim nesnelerini açıklar." -#: library/stdtypes.rst:5469 +#: library/stdtypes.rst:5468 msgid "Special Attributes" msgstr "Özel Özellikler" -#: library/stdtypes.rst:5471 +#: library/stdtypes.rst:5470 msgid "" "The implementation adds a few special read-only attributes to several object " "types, where they are relevant. Some of these are not reported by the :func:" @@ -6887,7 +6888,7 @@ msgstr "" "öznitelik ekler. Bunlardan bazıları :func:`dir` yerleşik işlevi tarafından " "bildirilmez." -#: library/stdtypes.rst:5478 +#: library/stdtypes.rst:5477 msgid "" "A dictionary or other mapping object used to store an object's (writable) " "attributes." @@ -6895,20 +6896,20 @@ msgstr "" "Bir nesnenin (yazılabilir) özniteliklerini depolamak için kullanılan sözlük " "veya başka bir eşleme nesnesi." -#: library/stdtypes.rst:5484 +#: library/stdtypes.rst:5483 msgid "The class to which a class instance belongs." msgstr "Bir sınıf örneğinin ait olduğu sınıf." -#: library/stdtypes.rst:5489 +#: library/stdtypes.rst:5488 msgid "The tuple of base classes of a class object." msgstr "Bir sınıf elemanının temel sınıflarının kümesi." -#: library/stdtypes.rst:5494 +#: library/stdtypes.rst:5493 msgid "" "The name of the class, function, method, descriptor, or generator instance." msgstr "Sınıf, fonksiyon, yöntem, tanımlayıcı veya üretici örneğinin adı." -#: library/stdtypes.rst:5500 +#: library/stdtypes.rst:5499 msgid "" "The :term:`qualified name` of the class, function, method, descriptor, or " "generator instance." @@ -6916,13 +6917,13 @@ msgstr "" "Sınıf, fonksiyon, yöntem, tanımlayıcı veya üretici örneğinin :term:" "`qualified name`." -#: library/stdtypes.rst:5508 +#: library/stdtypes.rst:5507 msgid "" "The :ref:`type parameters ` of generic classes, functions, and :" "ref:`type aliases `." msgstr "" -#: library/stdtypes.rst:5516 +#: library/stdtypes.rst:5515 msgid "" "This attribute is a tuple of classes that are considered when looking for " "base classes during method resolution." @@ -6930,7 +6931,7 @@ msgstr "" "Bu öznitelik, yöntem çözümlemesi sırasında temel sınıfları ararken dikkate " "alınan bir sınıf kümesidir." -#: library/stdtypes.rst:5522 +#: library/stdtypes.rst:5521 msgid "" "This method can be overridden by a metaclass to customize the method " "resolution order for its instances. It is called at class instantiation, " @@ -6940,7 +6941,7 @@ msgstr "" "meta sınıf tarafından geçersiz kılınabilir. Sınıf örneğinde çağrılır ve " "sonucu :attr:`~class.__mro__` içinde depolanır." -#: library/stdtypes.rst:5529 +#: library/stdtypes.rst:5528 msgid "" "Each class keeps a list of weak references to its immediate subclasses. " "This method returns a list of all those references still alive. The list is " @@ -6950,11 +6951,11 @@ msgstr "" "tutar. Bu yöntem, hala var olan tüm bu başvuruların bir listesini " "döndürür. Liste tanım sırasına göredir. Örnek::" -#: library/stdtypes.rst:5540 +#: library/stdtypes.rst:5539 msgid "Integer string conversion length limitation" msgstr "" -#: library/stdtypes.rst:5542 +#: library/stdtypes.rst:5541 msgid "" "CPython has a global limit for converting between :class:`int` and :class:" "`str` to mitigate denial of service attacks. This limit *only* applies to " @@ -6962,7 +6963,7 @@ msgid "" "binary conversions are unlimited. The limit can be configured." msgstr "" -#: library/stdtypes.rst:5547 +#: library/stdtypes.rst:5546 msgid "" "The :class:`int` type in CPython is an arbitrary length number stored in " "binary form (commonly known as a \"bignum\"). There exists no algorithm that " @@ -6972,25 +6973,25 @@ msgid "" "value such as ``int('1' * 500_000)`` can take over a second on a fast CPU." msgstr "" -#: library/stdtypes.rst:5554 +#: library/stdtypes.rst:5553 msgid "" "Limiting conversion size offers a practical way to avoid `CVE-2020-10735 " "`_." msgstr "" -#: library/stdtypes.rst:5557 +#: library/stdtypes.rst:5556 msgid "" "The limit is applied to the number of digit characters in the input or " "output string when a non-linear conversion algorithm would be involved. " "Underscores and the sign are not counted towards the limit." msgstr "" -#: library/stdtypes.rst:5561 +#: library/stdtypes.rst:5560 msgid "" "When an operation would exceed the limit, a :exc:`ValueError` is raised:" msgstr "" -#: library/stdtypes.rst:5583 +#: library/stdtypes.rst:5582 msgid "" "The default limit is 4300 digits as provided in :data:`sys.int_info." "default_max_str_digits `. The lowest limit that can be " @@ -6998,95 +6999,95 @@ msgid "" "str_digits_check_threshold `." msgstr "" -#: library/stdtypes.rst:5588 +#: library/stdtypes.rst:5587 msgid "Verification:" msgstr "Doğrulama" -#: library/stdtypes.rst:5603 +#: library/stdtypes.rst:5602 msgid "Affected APIs" msgstr "" -#: library/stdtypes.rst:5605 +#: library/stdtypes.rst:5604 msgid "" "The limitation only applies to potentially slow conversions between :class:" "`int` and :class:`str` or :class:`bytes`:" msgstr "" -#: library/stdtypes.rst:5608 +#: library/stdtypes.rst:5607 msgid "``int(string)`` with default base 10." msgstr "" -#: library/stdtypes.rst:5609 +#: library/stdtypes.rst:5608 msgid "``int(string, base)`` for all bases that are not a power of 2." msgstr "" -#: library/stdtypes.rst:5610 +#: library/stdtypes.rst:5609 msgid "``str(integer)``." msgstr "" -#: library/stdtypes.rst:5611 +#: library/stdtypes.rst:5610 msgid "``repr(integer)``." msgstr "" -#: library/stdtypes.rst:5612 +#: library/stdtypes.rst:5611 msgid "" "any other string conversion to base 10, for example ``f\"{integer}\"``, " "``\"{}\".format(integer)``, or ``b\"%d\" % integer``." msgstr "" -#: library/stdtypes.rst:5615 +#: library/stdtypes.rst:5614 msgid "The limitations do not apply to functions with a linear algorithm:" msgstr "" -#: library/stdtypes.rst:5617 +#: library/stdtypes.rst:5616 msgid "``int(string, base)`` with base 2, 4, 8, 16, or 32." msgstr "" -#: library/stdtypes.rst:5618 +#: library/stdtypes.rst:5617 msgid ":func:`int.from_bytes` and :func:`int.to_bytes`." msgstr "" -#: library/stdtypes.rst:5619 +#: library/stdtypes.rst:5618 msgid ":func:`hex`, :func:`oct`, :func:`bin`." msgstr "" -#: library/stdtypes.rst:5620 +#: library/stdtypes.rst:5619 msgid ":ref:`formatspec` for hex, octal, and binary numbers." msgstr "" -#: library/stdtypes.rst:5621 +#: library/stdtypes.rst:5620 #, fuzzy msgid ":class:`str` to :class:`float`." msgstr ":class:`str` 'den :class:`float` 'a." -#: library/stdtypes.rst:5622 +#: library/stdtypes.rst:5621 msgid ":class:`str` to :class:`decimal.Decimal`." msgstr "" -#: library/stdtypes.rst:5625 +#: library/stdtypes.rst:5624 msgid "Configuring the limit" msgstr "" -#: library/stdtypes.rst:5627 +#: library/stdtypes.rst:5626 msgid "" "Before Python starts up you can use an environment variable or an " "interpreter command line flag to configure the limit:" msgstr "" -#: library/stdtypes.rst:5630 +#: library/stdtypes.rst:5629 msgid "" ":envvar:`PYTHONINTMAXSTRDIGITS`, e.g. ``PYTHONINTMAXSTRDIGITS=640 python3`` " "to set the limit to 640 or ``PYTHONINTMAXSTRDIGITS=0 python3`` to disable " "the limitation." msgstr "" -#: library/stdtypes.rst:5633 +#: library/stdtypes.rst:5632 msgid "" ":option:`-X int_max_str_digits <-X>`, e.g. ``python3 -X " "int_max_str_digits=640``" msgstr "" -#: library/stdtypes.rst:5635 +#: library/stdtypes.rst:5634 msgid "" ":data:`sys.flags.int_max_str_digits` contains the value of :envvar:" "`PYTHONINTMAXSTRDIGITS` or :option:`-X int_max_str_digits <-X>`. If both the " @@ -7095,38 +7096,38 @@ msgid "" "int_info.default_max_str_digits` was used during initialization." msgstr "" -#: library/stdtypes.rst:5641 +#: library/stdtypes.rst:5640 msgid "" "From code, you can inspect the current limit and set a new one using these :" "mod:`sys` APIs:" msgstr "" -#: library/stdtypes.rst:5644 +#: library/stdtypes.rst:5643 msgid "" ":func:`sys.get_int_max_str_digits` and :func:`sys.set_int_max_str_digits` " "are a getter and setter for the interpreter-wide limit. Subinterpreters have " "their own limit." msgstr "" -#: library/stdtypes.rst:5648 +#: library/stdtypes.rst:5647 msgid "" "Information about the default and minimum can be found in :data:`sys." "int_info`:" msgstr "" -#: library/stdtypes.rst:5650 +#: library/stdtypes.rst:5649 msgid "" ":data:`sys.int_info.default_max_str_digits ` is the compiled-" "in default limit." msgstr "" -#: library/stdtypes.rst:5652 +#: library/stdtypes.rst:5651 msgid "" ":data:`sys.int_info.str_digits_check_threshold ` is the lowest " "accepted value for the limit (other than 0 which disables it)." msgstr "" -#: library/stdtypes.rst:5659 +#: library/stdtypes.rst:5658 msgid "" "Setting a low limit *can* lead to problems. While rare, code exists that " "contains integer constants in decimal in their source that exceed the " @@ -7138,7 +7139,7 @@ msgid "" "constants is to convert them to ``0x`` hexadecimal form as it has no limit." msgstr "" -#: library/stdtypes.rst:5668 +#: library/stdtypes.rst:5667 msgid "" "Test your application thoroughly if you use a low limit. Ensure your tests " "run with the limit set early via the environment or flag so that it applies " @@ -7146,11 +7147,11 @@ msgid "" "to precompile ``.py`` sources to ``.pyc`` files." msgstr "" -#: library/stdtypes.rst:5674 +#: library/stdtypes.rst:5673 msgid "Recommended configuration" msgstr "" -#: library/stdtypes.rst:5676 +#: library/stdtypes.rst:5675 msgid "" "The default :data:`sys.int_info.default_max_str_digits` is expected to be " "reasonable for most applications. If your application requires a different " @@ -7158,19 +7159,19 @@ msgid "" "as these APIs were added in security patch releases in versions before 3.12." msgstr "" -#: library/stdtypes.rst:5681 +#: library/stdtypes.rst:5680 msgid "Example::" msgstr "Örnek::" -#: library/stdtypes.rst:5693 +#: library/stdtypes.rst:5692 msgid "If you need to disable it entirely, set it to ``0``." msgstr "" -#: library/stdtypes.rst:5697 +#: library/stdtypes.rst:5696 msgid "Footnotes" msgstr "Dipnotlar" -#: library/stdtypes.rst:5698 +#: library/stdtypes.rst:5697 msgid "" "Additional information on these special methods may be found in the Python " "Reference Manual (:ref:`customization`)." @@ -7178,7 +7179,7 @@ msgstr "" "Bu özel yöntemler hakkında daha fazla bilgi Python Referans El Kitabında (:" "ref:`customization`) bulunabilir." -#: library/stdtypes.rst:5701 +#: library/stdtypes.rst:5700 msgid "" "As a consequence, the list ``[1, 2]`` is considered equal to ``[1.0, 2.0]``, " "and similarly for tuples." @@ -7186,12 +7187,12 @@ msgstr "" "Sonuç olarak, ``[1, 2]`` listesi ``[1.0, 2.0]`` ve benzer şekilde demetler " "için eşit kabul edilir." -#: library/stdtypes.rst:5704 +#: library/stdtypes.rst:5703 msgid "They must have since the parser can't tell the type of the operands." msgstr "" "Ayrıştırıcı, işlenenlerin türünü söyleyemediğinden sahip olmaları gerekir." -#: library/stdtypes.rst:5706 +#: library/stdtypes.rst:5705 msgid "" "Cased characters are those with general category property being one of " "\"Lu\" (Letter, uppercase), \"Ll\" (Letter, lowercase), or \"Lt\" (Letter, " @@ -7201,7 +7202,7 @@ msgstr "" "\"Ll\" (Harf, küçük harf) veya \"Lt\" (Harf, başlık) karakterlerinden biri " "olan karakterlerdir." -#: library/stdtypes.rst:5709 +#: library/stdtypes.rst:5708 msgid "" "To format only a tuple you should therefore provide a singleton tuple whose " "only element is the tuple to be formatted." @@ -7215,11 +7216,11 @@ msgid "built-in" msgstr "Gömülü Türler" #: library/stdtypes.rst:316 library/stdtypes.rst:950 library/stdtypes.rst:1139 -#: library/stdtypes.rst:4422 library/stdtypes.rst:5405 +#: library/stdtypes.rst:4421 library/stdtypes.rst:5404 msgid "types" msgstr "" -#: library/stdtypes.rst:1154 library/stdtypes.rst:4422 +#: library/stdtypes.rst:1154 library/stdtypes.rst:4421 msgid "statement" msgstr "" @@ -7340,10 +7341,10 @@ msgid "is not" msgstr "``is not``" #: library/stdtypes.rst:208 library/stdtypes.rst:1117 library/stdtypes.rst:1259 -#: library/stdtypes.rst:1382 library/stdtypes.rst:1540 -#: library/stdtypes.rst:2533 library/stdtypes.rst:4220 -#: library/stdtypes.rst:4900 library/stdtypes.rst:5325 -#: library/stdtypes.rst:5369 +#: library/stdtypes.rst:1382 library/stdtypes.rst:1539 +#: library/stdtypes.rst:2532 library/stdtypes.rst:4219 +#: library/stdtypes.rst:4899 library/stdtypes.rst:5324 +#: library/stdtypes.rst:5368 #, fuzzy msgid "object" msgstr "Kod Nesneleri" @@ -7436,8 +7437,8 @@ msgstr "" msgid "arithmetic" msgstr "" -#: library/stdtypes.rst:950 library/stdtypes.rst:4422 library/stdtypes.rst:5390 -#: library/stdtypes.rst:5405 +#: library/stdtypes.rst:950 library/stdtypes.rst:4421 library/stdtypes.rst:5389 +#: library/stdtypes.rst:5404 msgid "built-in function" msgstr "" @@ -7454,7 +7455,7 @@ msgstr "" msgid "complex" msgstr ":func:`complex`" -#: library/stdtypes.rst:2390 library/stdtypes.rst:3608 +#: library/stdtypes.rst:2389 library/stdtypes.rst:3607 msgid "+ (plus)" msgstr "" @@ -7468,11 +7469,11 @@ msgstr "Grup Ayırıcı" msgid "binary operator" msgstr "Satır Ayrıcı" -#: library/stdtypes.rst:2390 library/stdtypes.rst:3608 +#: library/stdtypes.rst:2389 library/stdtypes.rst:3607 msgid "- (minus)" msgstr "" -#: library/stdtypes.rst:2347 library/stdtypes.rst:3565 +#: library/stdtypes.rst:2346 library/stdtypes.rst:3564 msgid "* (asterisk)" msgstr "" @@ -7484,7 +7485,7 @@ msgstr "" msgid "//" msgstr "" -#: library/stdtypes.rst:2317 library/stdtypes.rst:3533 +#: library/stdtypes.rst:2316 library/stdtypes.rst:3532 msgid "% (percent)" msgstr "" @@ -7492,7 +7493,7 @@ msgstr "" msgid "**" msgstr "" -#: library/stdtypes.rst:393 library/stdtypes.rst:1154 library/stdtypes.rst:4422 +#: library/stdtypes.rst:393 library/stdtypes.rst:1154 library/stdtypes.rst:4421 #, fuzzy msgid "operations on" msgstr "İşlem" @@ -7502,7 +7503,7 @@ msgstr "İşlem" msgid "conjugate() (complex number method)" msgstr "*c* karmaşık sayısının eşleniği" -#: library/stdtypes.rst:1606 library/stdtypes.rst:5405 +#: library/stdtypes.rst:1605 library/stdtypes.rst:5404 #, fuzzy msgid "module" msgstr "Modüller" @@ -7571,7 +7572,7 @@ msgstr "" msgid "iterator protocol" msgstr "" -#: library/stdtypes.rst:4815 +#: library/stdtypes.rst:4814 msgid "protocol" msgstr "" @@ -7598,7 +7599,7 @@ msgstr "" msgid "iteration over" msgstr "İşlem" -#: library/stdtypes.rst:4422 +#: library/stdtypes.rst:4421 msgid "len" msgstr "" @@ -7680,12 +7681,12 @@ msgstr "" msgid "list" msgstr "" -#: library/stdtypes.rst:2514 library/stdtypes.rst:2712 -#: library/stdtypes.rst:3533 +#: library/stdtypes.rst:2513 library/stdtypes.rst:2711 +#: library/stdtypes.rst:3532 msgid "bytearray" msgstr "" -#: library/stdtypes.rst:4422 library/stdtypes.rst:5405 +#: library/stdtypes.rst:4421 library/stdtypes.rst:5404 msgid "type" msgstr "" @@ -7693,7 +7694,7 @@ msgstr "" msgid "assignment" msgstr "" -#: library/stdtypes.rst:4422 +#: library/stdtypes.rst:4421 msgid "del" msgstr "" @@ -7734,231 +7735,231 @@ msgstr "" msgid "range" msgstr "Aralıklar" -#: library/stdtypes.rst:1553 library/stdtypes.rst:2317 +#: library/stdtypes.rst:1552 library/stdtypes.rst:2316 msgid "string" msgstr "" -#: library/stdtypes.rst:1504 +#: library/stdtypes.rst:1503 #, fuzzy msgid "text sequence type" msgstr "Değiştirilebilir Dizi Tipleri" -#: library/stdtypes.rst:1553 library/stdtypes.rst:1571 +#: library/stdtypes.rst:1552 library/stdtypes.rst:1570 #, fuzzy msgid "str (built-in class)" msgstr "Diğer Yerleşik Tipler" -#: library/stdtypes.rst:1504 +#: library/stdtypes.rst:1503 msgid "(see also string)" msgstr "" -#: library/stdtypes.rst:1540 +#: library/stdtypes.rst:1539 msgid "io.StringIO" msgstr "" -#: library/stdtypes.rst:2506 +#: library/stdtypes.rst:2505 msgid "buffer protocol" msgstr "" -#: library/stdtypes.rst:2514 library/stdtypes.rst:2712 -#: library/stdtypes.rst:3533 +#: library/stdtypes.rst:2513 library/stdtypes.rst:2711 +#: library/stdtypes.rst:3532 msgid "bytes" msgstr "" -#: library/stdtypes.rst:2712 +#: library/stdtypes.rst:2711 #, fuzzy msgid "methods" msgstr "Yöntemler" -#: library/stdtypes.rst:1606 +#: library/stdtypes.rst:1605 msgid "re" msgstr "" -#: library/stdtypes.rst:3387 +#: library/stdtypes.rst:3386 msgid "universal newlines" msgstr "" -#: library/stdtypes.rst:2125 +#: library/stdtypes.rst:2124 msgid "str.splitlines method" msgstr "" -#: library/stdtypes.rst:2317 +#: library/stdtypes.rst:2316 msgid "formatting, string (%)" msgstr "" -#: library/stdtypes.rst:2317 +#: library/stdtypes.rst:2316 msgid "interpolation, string (%)" msgstr "" -#: library/stdtypes.rst:2317 +#: library/stdtypes.rst:2316 msgid "formatting, printf" msgstr "" -#: library/stdtypes.rst:2317 +#: library/stdtypes.rst:2316 msgid "interpolation, printf" msgstr "" -#: library/stdtypes.rst:3533 +#: library/stdtypes.rst:3532 msgid "printf-style formatting" msgstr "" -#: library/stdtypes.rst:3533 +#: library/stdtypes.rst:3532 msgid "sprintf-style formatting" msgstr "" -#: library/stdtypes.rst:3565 +#: library/stdtypes.rst:3564 msgid "() (parentheses)" msgstr "" -#: library/stdtypes.rst:2390 library/stdtypes.rst:3608 +#: library/stdtypes.rst:2389 library/stdtypes.rst:3607 msgid "in printf-style formatting" msgstr "" -#: library/stdtypes.rst:3565 +#: library/stdtypes.rst:3564 msgid ". (dot)" msgstr "" -#: library/stdtypes.rst:3608 +#: library/stdtypes.rst:3607 msgid "# (hash)" msgstr "" -#: library/stdtypes.rst:3608 +#: library/stdtypes.rst:3607 msgid "space" msgstr "" -#: library/stdtypes.rst:2506 +#: library/stdtypes.rst:2505 #, fuzzy msgid "binary sequence types" msgstr "Değiştirilebilir Dizi Tipleri" -#: library/stdtypes.rst:2514 +#: library/stdtypes.rst:2513 msgid "memoryview" msgstr "" -#: library/stdtypes.rst:2514 +#: library/stdtypes.rst:2513 msgid "array" msgstr "" -#: library/stdtypes.rst:3387 +#: library/stdtypes.rst:3386 msgid "bytes.splitlines method" msgstr "" -#: library/stdtypes.rst:3387 +#: library/stdtypes.rst:3386 msgid "bytearray.splitlines method" msgstr "" -#: library/stdtypes.rst:3533 +#: library/stdtypes.rst:3532 msgid "formatting" msgstr "" -#: library/stdtypes.rst:3533 +#: library/stdtypes.rst:3532 msgid "bytes (%)" msgstr "" -#: library/stdtypes.rst:3533 +#: library/stdtypes.rst:3532 msgid "bytearray (%)" msgstr "" -#: library/stdtypes.rst:3533 +#: library/stdtypes.rst:3532 #, fuzzy msgid "interpolation" msgstr "Satır Tablolama" -#: library/stdtypes.rst:4220 +#: library/stdtypes.rst:4219 msgid "set" msgstr "" -#: library/stdtypes.rst:4422 +#: library/stdtypes.rst:4421 msgid "mapping" msgstr "" -#: library/stdtypes.rst:4422 +#: library/stdtypes.rst:4421 msgid "dictionary" msgstr "" -#: library/stdtypes.rst:4505 +#: library/stdtypes.rst:4504 msgid "__missing__()" msgstr "" -#: library/stdtypes.rst:4815 +#: library/stdtypes.rst:4814 #, fuzzy msgid "context manager" msgstr "Bağlam Yöneticisi Türleri" -#: library/stdtypes.rst:4815 +#: library/stdtypes.rst:4814 msgid "context management protocol" msgstr "" -#: library/stdtypes.rst:4815 +#: library/stdtypes.rst:4814 #, fuzzy msgid "context management" msgstr "Bağlam Yöneticisi Türleri" -#: library/stdtypes.rst:4888 +#: library/stdtypes.rst:4887 msgid "annotation" msgstr "" -#: library/stdtypes.rst:4888 +#: library/stdtypes.rst:4887 msgid "type annotation; type hint" msgstr "" -#: library/stdtypes.rst:4900 +#: library/stdtypes.rst:4899 #, fuzzy msgid "GenericAlias" msgstr "Genel Takma Ad Türü" -#: library/stdtypes.rst:4900 +#: library/stdtypes.rst:4899 msgid "Generic" msgstr "" -#: library/stdtypes.rst:4900 +#: library/stdtypes.rst:4899 msgid "Alias" msgstr "" -#: library/stdtypes.rst:5155 +#: library/stdtypes.rst:5154 #, fuzzy msgid "Union" msgstr "Sendika Türü" -#: library/stdtypes.rst:5155 +#: library/stdtypes.rst:5154 msgid "union" msgstr "" -#: library/stdtypes.rst:5325 +#: library/stdtypes.rst:5324 #, fuzzy msgid "method" msgstr "Yöntemler" -#: library/stdtypes.rst:5369 +#: library/stdtypes.rst:5368 msgid "code" msgstr "" -#: library/stdtypes.rst:5369 +#: library/stdtypes.rst:5368 #, fuzzy msgid "code object" msgstr "Kod Nesneleri" -#: library/stdtypes.rst:5376 +#: library/stdtypes.rst:5375 msgid "compile" msgstr "" -#: library/stdtypes.rst:5376 +#: library/stdtypes.rst:5375 msgid "__code__ (function object attribute)" msgstr "" -#: library/stdtypes.rst:5390 +#: library/stdtypes.rst:5389 msgid "exec" msgstr "" -#: library/stdtypes.rst:5390 +#: library/stdtypes.rst:5389 msgid "eval" msgstr "" -#: library/stdtypes.rst:5429 +#: library/stdtypes.rst:5428 msgid "..." msgstr "" -#: library/stdtypes.rst:5429 +#: library/stdtypes.rst:5428 msgid "ellipsis literal" msgstr "" diff --git a/library/threading.po b/library/threading.po index 4e643767e..8d62f690f 100644 --- a/library/threading.po +++ b/library/threading.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -481,11 +481,11 @@ msgid "" msgstr "" #: library/threading.rst:363 -msgid "Use the *target* name if *name* argument is omitted." +msgid "Added the *daemon* parameter." msgstr "" #: library/threading.rst:366 -msgid "Added the *daemon* argument." +msgid "Use the *target* name if *name* argument is omitted." msgstr "" #: library/threading.rst:371 diff --git a/library/time.po b/library/time.po index 07a36c60b..5e3e4c8b4 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-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: 2023-03-01 11:44+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -301,8 +301,8 @@ msgstr "" "Belirtilen *clk_id* saatinin netliğini (kesinliğini) döndür. *clk_id*'e " "uygun değerlerin bir listesi için :ref:`time-clock-id-constants`'a bakınız." -#: library/time.rst:174 library/time.rst:196 library/time.rst:717 -#: library/time.rst:853 library/time.rst:916 +#: library/time.rst:174 library/time.rst:196 library/time.rst:716 +#: library/time.rst:852 library/time.rst:915 msgid ":ref:`Availability `: Unix." msgstr ":ref:`Availability `: Unix." @@ -653,15 +653,6 @@ msgstr "Ya da ``select()`` kullanın (netlik: 1 mikrosaniye)." #: library/time.rst:384 msgid "" -"On Unix, the ``clock_nanosleep()`` and ``nanosleep()`` functions are now " -"used if available. On Windows, a waitable timer is now used." -msgstr "" -"Unix'de, ``clock_nanosleep()`` ve ``nanosleep()`` fonksiyonları artık " -"kullanılabiliyor. Windows'da, artık beklenebilir bir zamanlayıcı " -"kullanılıyor." - -#: library/time.rst:388 -msgid "" "The function now sleeps at least *secs* even if the sleep is interrupted by " "a signal, except if the signal handler raises an exception (see :pep:`475` " "for the rationale)." @@ -670,7 +661,16 @@ msgstr "" "sinyal işleyicisi tarafından bir istisna yükseltilmesi durumu hariç " "(açıklaması için :pep:`475`'e göz atın)." -#: library/time.rst:399 +#: library/time.rst:389 +msgid "" +"On Unix, the ``clock_nanosleep()`` and ``nanosleep()`` functions are now " +"used if available. On Windows, a waitable timer is now used." +msgstr "" +"Unix'de, ``clock_nanosleep()`` ve ``nanosleep()`` fonksiyonları artık " +"kullanılabiliyor. Windows'da, artık beklenebilir bir zamanlayıcı " +"kullanılıyor." + +#: library/time.rst:398 msgid "" "Convert a tuple or :class:`struct_time` representing a time as returned by :" "func:`gmtime` or :func:`localtime` to a string as specified by the *format* " @@ -685,7 +685,7 @@ msgstr "" "bir dize olmalıdır. :exc:`ValueError`, *t* içindeki herhangi bir alan izin " "verilen aralığın dışındaysa yükseltilir." -#: library/time.rst:405 +#: library/time.rst:404 msgid "" "0 is a legal argument for any position in the time tuple; if it is normally " "illegal the value is forced to a correct one." @@ -693,7 +693,7 @@ msgstr "" "0 zaman demeti içerisindeki herhangi bir pozisyon için geçerli bir " "argümandır; normalde geçersiz ise, değer doğru bir değere zorlanır." -#: library/time.rst:408 +#: library/time.rst:407 msgid "" "The following directives can be embedded in the *format* string. They are " "shown without the optional field width and precision specification, and are " @@ -703,152 +703,152 @@ msgstr "" "genişliği ve kesinlik belirtimi olmadan gösterilirler ve :func:`strftime` " "sonucunda belirtilen karakterlerle değiştirilirler:" -#: library/time.rst:413 +#: library/time.rst:412 msgid "Directive" msgstr "Yönerge" -#: library/time.rst:413 +#: library/time.rst:412 msgid "Meaning" msgstr "Anlamı" -#: library/time.rst:413 +#: library/time.rst:412 msgid "Notes" msgstr "Notlar" -#: library/time.rst:415 +#: library/time.rst:414 msgid "``%a``" msgstr "``%a``" -#: library/time.rst:415 +#: library/time.rst:414 msgid "Locale's abbreviated weekday name." msgstr "Yerel ayarın kısaltılmış hafta içi ismi." -#: library/time.rst:418 +#: library/time.rst:417 msgid "``%A``" msgstr "``%A``" -#: library/time.rst:418 +#: library/time.rst:417 msgid "Locale's full weekday name." msgstr "Yerel ayarın tam hafta içi ismi." -#: library/time.rst:420 +#: library/time.rst:419 msgid "``%b``" msgstr "``%b``" -#: library/time.rst:420 +#: library/time.rst:419 msgid "Locale's abbreviated month name." msgstr "Yerel ayarın kısaltılmış ay ismi." -#: library/time.rst:423 +#: library/time.rst:422 msgid "``%B``" msgstr "``%B``" -#: library/time.rst:423 +#: library/time.rst:422 msgid "Locale's full month name." msgstr "Yerel ayarın tam ay ismi." -#: library/time.rst:425 +#: library/time.rst:424 msgid "``%c``" msgstr "``%c``" -#: library/time.rst:425 +#: library/time.rst:424 msgid "Locale's appropriate date and time representation." msgstr "Yerel ayarın uygun tarih ve zaman gösterimi." -#: library/time.rst:428 +#: library/time.rst:427 msgid "``%d``" msgstr "``%d``" -#: library/time.rst:428 +#: library/time.rst:427 msgid "Day of the month as a decimal number [01,31]." msgstr "Onluk sayı şeklinde ayın günü [01,31]." -#: library/time.rst:431 +#: library/time.rst:430 msgid "``%f``" msgstr "" -#: library/time.rst:432 +#: library/time.rst:431 #, fuzzy msgid "Microseconds as a decimal number" msgstr "Onluk sayı şeklinde saniye [00,61]." -#: library/time.rst:432 +#: library/time.rst:431 msgid "[000000,999999]." msgstr "" -#: library/time.rst:431 +#: library/time.rst:430 msgid "\\(1)" msgstr "\\(1)" -#: library/time.rst:435 +#: library/time.rst:434 msgid "``%H``" msgstr "``%H``" -#: library/time.rst:435 +#: library/time.rst:434 msgid "Hour (24-hour clock) as a decimal number [00,23]." msgstr "Onluk sayı şeklinde saat (24-saatlik sistem) [00,23]." -#: library/time.rst:438 +#: library/time.rst:437 msgid "``%I``" msgstr "``%I``" -#: library/time.rst:438 +#: library/time.rst:437 msgid "Hour (12-hour clock) as a decimal number [01,12]." msgstr "Onluk sayı şeklinde saat (12-saatlik sistem) [01,12]." -#: library/time.rst:441 +#: library/time.rst:440 msgid "``%j``" msgstr "``%j``" -#: library/time.rst:441 +#: library/time.rst:440 msgid "Day of the year as a decimal number [001,366]." msgstr "Onluk sayı şeklinde yılın günü [001,366]." -#: library/time.rst:444 +#: library/time.rst:443 msgid "``%m``" msgstr "``%m``" -#: library/time.rst:444 +#: library/time.rst:443 msgid "Month as a decimal number [01,12]." msgstr "Onluk sayı şeklinde ay [01,12]." -#: library/time.rst:447 +#: library/time.rst:446 msgid "``%M``" msgstr "``%M``" -#: library/time.rst:447 +#: library/time.rst:446 msgid "Minute as a decimal number [00,59]." msgstr "Onluk sayı şeklinde dakika [00,59]." -#: library/time.rst:450 +#: library/time.rst:449 msgid "``%p``" msgstr "``%p``" -#: library/time.rst:450 +#: library/time.rst:449 msgid "Locale's equivalent of either AM or PM." msgstr "Yerel ayarın AM veya PM'e göre karşılığı." -#: library/time.rst:450 +#: library/time.rst:449 msgid "\\(2)" msgstr "\\(2)" -#: library/time.rst:453 +#: library/time.rst:452 msgid "``%S``" msgstr "``%S``" -#: library/time.rst:453 +#: library/time.rst:452 msgid "Second as a decimal number [00,61]." msgstr "Onluk sayı şeklinde saniye [00,61]." -#: library/time.rst:453 +#: library/time.rst:452 msgid "\\(3)" msgstr "\\(3)" -#: library/time.rst:456 +#: library/time.rst:455 msgid "``%U``" msgstr "``%U``" -#: library/time.rst:456 +#: library/time.rst:455 msgid "" "Week number of the year (Sunday as the first day of the week) as a decimal " "number [00,53]. All days in a new year preceding the first Sunday are " @@ -858,23 +858,23 @@ msgstr "" "numarası [00,53]. Yeni bir yılın ilk Pazar gününden önceki tüm günleri 0. " "hafta olarak kabul edilir." -#: library/time.rst:467 +#: library/time.rst:466 msgid "\\(4)" msgstr "" -#: library/time.rst:464 +#: library/time.rst:463 msgid "``%w``" msgstr "``%w``" -#: library/time.rst:464 +#: library/time.rst:463 msgid "Weekday as a decimal number [0(Sunday),6]." msgstr "Onluk sayı şeklinde hafta içi [0(Sunday),6]." -#: library/time.rst:467 +#: library/time.rst:466 msgid "``%W``" msgstr "``%W``" -#: library/time.rst:467 +#: library/time.rst:466 msgid "" "Week number of the year (Monday as the first day of the week) as a decimal " "number [00,53]. All days in a new year preceding the first Monday are " @@ -884,43 +884,43 @@ msgstr "" "numarası [00,53]. Yeni bir yılın ilk Pazartesi gününden önceki tüm günleri " "0. hafta olarak kabul edilir." -#: library/time.rst:475 +#: library/time.rst:474 msgid "``%x``" msgstr "``%x``" -#: library/time.rst:475 +#: library/time.rst:474 msgid "Locale's appropriate date representation." msgstr "Yerel ayarın uygun tarih gösterimi." -#: library/time.rst:478 +#: library/time.rst:477 msgid "``%X``" msgstr "``%X``" -#: library/time.rst:478 +#: library/time.rst:477 msgid "Locale's appropriate time representation." msgstr "Yerel ayarın uygun zaman gösterimi." -#: library/time.rst:481 +#: library/time.rst:480 msgid "``%y``" msgstr "``%y``" -#: library/time.rst:481 +#: library/time.rst:480 msgid "Year without century as a decimal number [00,99]." msgstr "Onluk sayı şeklinde yüzyıl olmadan yıl [00,99]." -#: library/time.rst:484 +#: library/time.rst:483 msgid "``%Y``" msgstr "``%Y``" -#: library/time.rst:484 +#: library/time.rst:483 msgid "Year with century as a decimal number." msgstr "Onluk sayı şeklinde yüzyıl ile birlikte yıl." -#: library/time.rst:487 +#: library/time.rst:486 msgid "``%z``" msgstr "``%z``" -#: library/time.rst:487 +#: library/time.rst:486 msgid "" "Time zone offset indicating a positive or negative time difference from UTC/" "GMT of the form +HHMM or -HHMM, where H represents decimal hour digits and M " @@ -930,29 +930,29 @@ msgstr "" "farkını gösteren saat dilimi farkı, burada H ondalık saat hanelerini ve M " "ondalık dakika hanelerini temsil eder [-23:59, +23:59]. [1]_" -#: library/time.rst:493 +#: library/time.rst:492 msgid "``%Z``" msgstr "``%Z``" -#: library/time.rst:493 +#: library/time.rst:492 msgid "Time zone name (no characters if no time zone exists). Deprecated. [1]_" msgstr "" "Yerel zaman ismi (yerel zaman bulunmuyorsa karakter girmeyin). Kullanımdan " "kaldırıldı. [1]_" -#: library/time.rst:496 +#: library/time.rst:495 msgid "``%%``" msgstr "``%%``" -#: library/time.rst:496 +#: library/time.rst:495 msgid "A literal ``'%'`` character." msgstr "Gerçek bir ``'%'`` karakteri." -#: library/time.rst:499 +#: library/time.rst:498 msgid "Notes:" msgstr "Notlar:" -#: library/time.rst:502 +#: library/time.rst:501 msgid "" "The ``%f`` format directive only applies to :func:`strptime`, not to :func:" "`strftime`. However, see also :meth:`datetime.datetime.strptime` and :meth:" @@ -960,7 +960,7 @@ msgid "" "to microseconds `." msgstr "" -#: library/time.rst:508 +#: library/time.rst:507 msgid "" "When used with the :func:`strptime` function, the ``%p`` directive only " "affects the output hour field if the ``%I`` directive is used to parse the " @@ -970,7 +970,7 @@ msgstr "" "ayrıştırmak için ``%I`` yönergesi kullanılıyorsa, çıkış saati alanını " "etkiler." -#: library/time.rst:514 +#: library/time.rst:513 msgid "" "The range really is ``0`` to ``61``; value ``60`` is valid in timestamps " "representing `leap seconds`_ and value ``61`` is supported for historical " @@ -980,7 +980,7 @@ msgstr "" "seconds`_ 'u temsil eden zaman damgalarında geçerlidir ve ``61`` değeriyse " "tarihsel nedenlerden ötürü desteklenmektedir." -#: library/time.rst:519 +#: library/time.rst:518 msgid "" "When used with the :func:`strptime` function, ``%U`` and ``%W`` are only " "used in calculations when the day of the week and the year are specified." @@ -988,7 +988,7 @@ msgstr "" "``%U`` ve ``%W`` ifadeleri, :func:`strptime` fonksiyonu ile kullanıldığında, " "yalnızca haftanın günü ve yıl belirtilmişse hesaplamalarda kullanılır." -#: library/time.rst:522 +#: library/time.rst:521 msgid "" "Here is an example, a format for dates compatible with that specified in " "the :rfc:`2822` Internet email standard. [1]_ ::" @@ -996,7 +996,7 @@ msgstr "" "İşte bir örnek, :rfc:`2822` İnternet e-posta standardında belirtilenle " "uyumlu tarih biçimi. [1]_ ::" -#: library/time.rst:529 +#: library/time.rst:528 msgid "" "Additional directives may be supported on certain platforms, but only the " "ones listed here have a meaning standardized by ANSI C. To see the full set " @@ -1008,7 +1008,7 @@ msgstr "" "Platformunuzda desteklenen tüm biçim kodlarını görmek için :manpage:" "`strftime(3)` belgelerine bakın." -#: library/time.rst:534 +#: library/time.rst:533 msgid "" "On some platforms, an optional field width and precision specification can " "immediately follow the initial ``'%'`` of a directive in the following " @@ -1020,7 +1020,7 @@ msgstr "" "bu da taşınabilir değil. Alan genişliği, 3 olduğu ``%j`` dışında normalde " "2'dir." -#: library/time.rst:545 +#: library/time.rst:544 msgid "" "Parse a string representing a time according to a format. The return value " "is a :class:`struct_time` as returned by :func:`gmtime` or :func:`localtime`." @@ -1029,7 +1029,7 @@ msgstr "" "değeri, :func:`gmtime` veya :func:`localtime` tarafından döndürülen bir :" "class:`struct_time` şeklindedir." -#: library/time.rst:549 +#: library/time.rst:548 msgid "" "The *format* parameter uses the same directives as those used by :func:" "`strftime`; it defaults to ``\"%a %b %d %H:%M:%S %Y\"`` which matches the " @@ -1048,11 +1048,11 @@ msgstr "" "0, 0, 0, 0, 1, -1)`` şeklindedir. Hem *string* hem de *format* dize " "olmalıdır." -#: library/time.rst:557 +#: library/time.rst:556 msgid "For example:" msgstr "Örnek olarak:" -#: library/time.rst:564 +#: library/time.rst:563 msgid "" "Support for the ``%Z`` directive is based on the values contained in " "``tzname`` and whether ``daylight`` is true. Because of this, it is " @@ -1064,7 +1064,7 @@ msgstr "" "zaman bilinen (ve gün ışığından yararlanma saat dilimleri olarak kabul " "edilen) UTC ve GMT'yi tanımak dışında platforma özgüdür." -#: library/time.rst:569 +#: library/time.rst:568 msgid "" "Only the directives specified in the documentation are supported. Because " "``strftime()`` is implemented per platform it can sometimes offer more " @@ -1077,7 +1077,7 @@ msgstr "" "sunabilir. Ancak ``strptime()`` herhangi bir platformdan bağımsızdır ve bu " "nedenle desteklendiği belgelenmeyen mevcut tüm yönergeleri desteklemeyebilir." -#: library/time.rst:578 +#: library/time.rst:577 msgid "" "The type of the time value sequence returned by :func:`gmtime`, :func:" "`localtime`, and :func:`strptime`. It is an object with a :term:`named " @@ -1089,105 +1089,105 @@ msgstr "" "nesnedir: değerlere dizin ve öznitelik adıyla erişilebilir. Aşağıdaki " "değerler mevcuttur:" -#: library/time.rst:585 +#: library/time.rst:584 msgid "Index" msgstr "Dizin" -#: library/time.rst:586 +#: library/time.rst:585 msgid "Attribute" msgstr "Öznitelik" -#: library/time.rst:587 +#: library/time.rst:586 msgid "Values" msgstr "Değerler" -#: library/time.rst:589 +#: library/time.rst:588 msgid "0" msgstr "0" -#: library/time.rst:591 +#: library/time.rst:590 msgid "(for example, 1993)" msgstr "(örnek olarak, 1993)" -#: library/time.rst:593 +#: library/time.rst:592 msgid "1" msgstr "1" -#: library/time.rst:595 +#: library/time.rst:594 msgid "range [1, 12]" msgstr "[1, 12] aralığı" -#: library/time.rst:597 +#: library/time.rst:596 msgid "2" msgstr "2" -#: library/time.rst:599 +#: library/time.rst:598 msgid "range [1, 31]" msgstr "[1, 31] aralığı" -#: library/time.rst:601 +#: library/time.rst:600 msgid "3" msgstr "3" -#: library/time.rst:603 +#: library/time.rst:602 msgid "range [0, 23]" msgstr "[0, 23] aralığı" -#: library/time.rst:605 +#: library/time.rst:604 msgid "4" msgstr "4" -#: library/time.rst:607 +#: library/time.rst:606 msgid "range [0, 59]" msgstr "[0, 59] aralığa" -#: library/time.rst:609 +#: library/time.rst:608 msgid "5" msgstr "5" -#: library/time.rst:611 +#: library/time.rst:610 #, fuzzy msgid "range [0, 61]; see :ref:`Note (2) ` in :func:`strftime`" msgstr "[0, 61] aralığı; :func:`strftime` içinde **(2)** açıklamasına göz atın" -#: library/time.rst:613 +#: library/time.rst:612 msgid "6" msgstr "6" -#: library/time.rst:615 +#: library/time.rst:614 #, fuzzy msgid "range [0, 6]; Monday is 0" msgstr "[0, 6] aralığı, Pazartesi 0'dır" -#: library/time.rst:617 +#: library/time.rst:616 msgid "7" msgstr "7" -#: library/time.rst:619 +#: library/time.rst:618 msgid "range [1, 366]" msgstr "[1, 366] aralığı" -#: library/time.rst:621 +#: library/time.rst:620 msgid "8" msgstr "8" -#: library/time.rst:623 +#: library/time.rst:622 msgid "0, 1 or -1; see below" msgstr "0, 1 veya -1; aşağıya bakınız" -#: library/time.rst:629 +#: library/time.rst:628 msgid "N/A" msgstr "N/A" -#: library/time.rst:627 +#: library/time.rst:626 msgid "abbreviation of timezone name" msgstr "saat diliminin adının kısaltması" -#: library/time.rst:631 +#: library/time.rst:630 msgid "offset east of UTC in seconds" msgstr "UTC'nin doğusundaki saniye farkı" -#: library/time.rst:633 +#: library/time.rst:632 msgid "" "Note that unlike the C structure, the month value is a range of [1, 12], not " "[0, 11]." @@ -1195,7 +1195,7 @@ msgstr "" "C yapısından farklı olarak, ay değerinin menzili [1, 12] arasındadır, [0, " "11] değil." -#: library/time.rst:636 +#: library/time.rst:635 msgid "" "In calls to :func:`mktime`, :attr:`tm_isdst` may be set to 1 when daylight " "savings time is in effect, and 0 when it is not. A value of -1 indicates " @@ -1206,7 +1206,7 @@ msgstr "" "1, etkin değilken 0 olarak ayarlanabilir. -1 değeri bunun bilinmediğini " "gösterir ve genellikle doğru durumun doldurulmasıyla sonuçlanır." -#: library/time.rst:640 +#: library/time.rst:639 msgid "" "When a tuple with an incorrect length is passed to a function expecting a :" "class:`struct_time`, or having elements of the wrong type, a :exc:" @@ -1216,7 +1216,7 @@ msgstr "" "iletildiğinde, veya yanlış türde elemanlara sahip olmak, bir :exc:" "`TypeError` yükseltir." -#: library/time.rst:646 +#: library/time.rst:645 msgid "" "Return the time in seconds since the epoch_ as a floating point number. The " "handling of `leap seconds`_ is platform dependent. On Windows and most Unix " @@ -1230,7 +1230,7 @@ msgstr "" "saniye cinsinden süreye dahil edilmez. Bu genellikle `Unix time `_ olarak anılır." -#: library/time.rst:652 +#: library/time.rst:651 msgid "" "Note that even though the time is always returned as a floating point " "number, not all systems provide time with a better precision than 1 second. " @@ -1243,7 +1243,7 @@ msgstr "" "Bu fonksiyon normalde azalmayan değerler döndürürken, sistem saati iki çağrı " "arasında geri ayarlanmışsa önceki çağrıdan daha düşük bir değer döndürebilir." -#: library/time.rst:658 +#: library/time.rst:657 msgid "" "The number returned by :func:`.time` may be converted into a more common " "time format (i.e. year, month, day, hour, etc...) in UTC by passing it to :" @@ -1258,7 +1258,7 @@ msgstr "" "iki durumda da, takvim tarihinin bileşenlerine nitelikler olarak " "erişilebilen bir :class:`struct_time` nesnesi döndürülür." -#: library/time.rst:665 +#: library/time.rst:664 msgid "" "Use :func:`time_ns` to avoid the precision loss caused by the :class:`float` " "type." @@ -1266,7 +1266,7 @@ msgstr "" ":class:`float` türünden kaynaklanan kesinlik kaybından kaçınmak için :func:" "`time_ns` kullanınız." -#: library/time.rst:671 +#: library/time.rst:670 msgid "" "Similar to :func:`~time.time` but returns time as an integer number of " "nanoseconds since the epoch_." @@ -1274,7 +1274,7 @@ msgstr "" ":func:`~time.time`'ye benzer, ancak zamanı, epoch_ 'den bu yana geçen " "nanosaniyelerin tamsayısı olarak döndürür." -#: library/time.rst:684 +#: library/time.rst:683 msgid "" "Return the value (in fractional seconds) of the sum of the system and user " "CPU time of the current thread. It does not include time elapsed during " @@ -1288,7 +1288,7 @@ msgstr "" "noktası tanımsızdır, böylece sadece aynı iş parçacığındaki iki çağrının " "sonuçları arasındaki fark geçerlidir." -#: library/time.rst:690 +#: library/time.rst:689 msgid "" "Use :func:`thread_time_ns` to avoid the precision loss caused by the :class:" "`float` type." @@ -1296,21 +1296,21 @@ msgstr "" ":class:`float` türünün neden olduğu kesinlik kaybını önlemek için :func:" "`thread_time_ns` kullanın." -#: library/time.rst:693 +#: library/time.rst:692 msgid ":ref:`Availability `: Linux, Unix, Windows." msgstr ":ref:`Availability `: Linux, Unix, Windows." -#: library/time.rst:695 +#: library/time.rst:694 msgid "Unix systems supporting ``CLOCK_THREAD_CPUTIME_ID``." msgstr "Unix sistemler ``CLOCK_THREAD_CPUTIME_ID`` destekliyor." -#: library/time.rst:702 +#: library/time.rst:701 msgid "Similar to :func:`thread_time` but return time as nanoseconds." msgstr "" ":func:`thread_time` ile benzer şekilde ama zamanı nanosaniyeler şeklinde " "döndürür." -#: library/time.rst:709 +#: library/time.rst:708 msgid "" "Reset the time conversion rules used by the library routines. The " "environment variable :envvar:`TZ` specifies how this is done. It will also " @@ -1329,7 +1329,7 @@ msgstr "" "ışığından yararlanma saatinin uygulandığı geçmiş, şimdi veya gelecek bir " "zaman varsa sıfırdan farklı)." -#: library/time.rst:721 +#: library/time.rst:720 msgid "" "Although in many cases, changing the :envvar:`TZ` environment variable may " "affect the output of functions like :func:`localtime` without calling :func:" @@ -1339,11 +1339,11 @@ msgstr "" "gibi işlevlerin çıktısını :func:`tzset` çağırmadan etkileyebilirse de, bu " "davranışa güvenilmemelidir." -#: library/time.rst:725 +#: library/time.rst:724 msgid "The :envvar:`TZ` environment variable should contain no whitespace." msgstr ":envvar:`TZ` çevre değişkeni boşluk karakteri içermemelidir." -#: library/time.rst:727 +#: library/time.rst:726 msgid "" "The standard format of the :envvar:`TZ` environment variable is (whitespace " "added for clarity)::" @@ -1351,15 +1351,15 @@ msgstr "" ":envvar:`TZ` çevre değişkeninin standart biçimi (boşluk karakteri açıklık " "için eklenmiştir)::" -#: library/time.rst:732 +#: library/time.rst:731 msgid "Where the components are:" msgstr "Bileşenlerin olduğu yerde:" -#: library/time.rst:736 +#: library/time.rst:735 msgid "``std`` and ``dst``" msgstr "``std`` ve ``dst``" -#: library/time.rst:735 +#: library/time.rst:734 msgid "" "Three or more alphanumerics giving the timezone abbreviations. These will be " "propagated into time.tzname" @@ -1367,11 +1367,11 @@ msgstr "" "Üç veya daha fazla harfler ve sayılar saat dilimi kısaltmalarını veriyor. " "Bunlar time.tzname içine yayılacaktır" -#: library/time.rst:742 +#: library/time.rst:741 msgid "``offset``" msgstr "``offset``" -#: library/time.rst:739 +#: library/time.rst:738 msgid "" "The offset has the form: ``± hh[:mm[:ss]]``. This indicates the value added " "the local time to arrive at UTC. If preceded by a '-', the timezone is east " @@ -1384,11 +1384,11 @@ msgstr "" "bir sapma yoksa, yaz saatinin standart saatten bir saat ileri olduğu " "varsayılır." -#: library/time.rst:764 +#: library/time.rst:763 msgid "``start[/time], end[/time]``" msgstr "``start[/time], end[/time]``" -#: library/time.rst:745 +#: library/time.rst:744 msgid "" "Indicates when to change to and back from DST. The format of the start and " "end dates are one of the following:" @@ -1396,11 +1396,11 @@ msgstr "" "DST'ye ne zaman geçileceğini ve DST'den geri dönüleceğini gösterir. " "Başlangıç ve bitiş tarihlerinin biçimi aşağıdakilerden biridir:" -#: library/time.rst:750 +#: library/time.rst:749 msgid ":samp:`J{n}`" msgstr ":samp:`J{n}`" -#: library/time.rst:749 +#: library/time.rst:748 msgid "" "The Julian day *n* (1 <= *n* <= 365). Leap days are not counted, so in all " "years February 28 is day 59 and March 1 is day 60." @@ -1408,11 +1408,11 @@ msgstr "" "Jülyen günü *n* (1 <= *n* <= 365). Artık günler sayılmaz, yani bütün " "yıllarda 28 Şubat 59. gün ve 1 Mart 60. gündür." -#: library/time.rst:754 +#: library/time.rst:753 msgid ":samp:`{n}`" msgstr ":samp:`{n}`" -#: library/time.rst:753 +#: library/time.rst:752 msgid "" "The zero-based Julian day (0 <= *n* <= 365). Leap days are counted, and it " "is possible to refer to February 29." @@ -1420,11 +1420,11 @@ msgstr "" "Sıfır tabanlı Jülyen günü (0 <= *n* <= 365). Artık günler dahil edilmiştir, " "ve 29 Şubat'tan bahsetmek mümkündür." -#: library/time.rst:761 +#: library/time.rst:760 msgid ":samp:`M{m}.{n}.{d}`" msgstr ":samp:`M{m}.{n}.{d}`" -#: library/time.rst:757 +#: library/time.rst:756 msgid "" "The *d*'th day (0 <= *d* <= 6) of week *n* of month *m* of the year (1 <= " "*n* <= 5, 1 <= *m* <= 12, where week 5 means \"the last *d* day in month " @@ -1435,7 +1435,7 @@ msgstr "" "5, 1 <= *m* <= 12, burada 5. hafta \"the last *d* day in month *m*\" " "anlamına gelir ve dördüncü veya beşinci haftada olabilir)." -#: library/time.rst:763 +#: library/time.rst:762 msgid "" "``time`` has the same format as ``offset`` except that no leading sign ('-' " "or '+') is allowed. The default, if time is not given, is 02:00:00." @@ -1444,7 +1444,7 @@ msgstr "" "haricinde aynı biçime sahiptir. Zaman verilmemişse, varsayılan olarak " "02:00:00'dır." -#: library/time.rst:777 +#: library/time.rst:776 msgid "" "On many Unix systems (including \\*BSD, Linux, Solaris, and Darwin), it is " "more convenient to use the system's zoneinfo (:manpage:`tzfile(5)`) " @@ -1463,11 +1463,11 @@ msgstr "" "Eastern'``, ``'Australia/Melbourne'``, ``'Egypt'`` veya ``'Europe/" "Amsterdam'``. ::" -#: library/time.rst:798 +#: library/time.rst:797 msgid "Clock ID Constants" msgstr "Saat Kimliği Sabitleri" -#: library/time.rst:800 +#: library/time.rst:799 msgid "" "These constants are used as parameters for :func:`clock_getres` and :func:" "`clock_gettime`." @@ -1475,7 +1475,7 @@ msgstr "" "Şu sabitler :func:`clock_getres` ve :func:`clock_gettime` için parametre " "olarak kullanılırlar." -#: library/time.rst:805 +#: library/time.rst:804 msgid "" "Identical to :data:`CLOCK_MONOTONIC`, except it also includes any time that " "the system is suspended." @@ -1483,7 +1483,7 @@ msgstr "" ":data:`CLOCK_MONOTONIC` ile aynı şekilde, ancak o sistemin askıya alındığı " "herhangi bir zamanı da içerir." -#: library/time.rst:808 +#: library/time.rst:807 msgid "" "This allows applications to get a suspend-aware monotonic clock without " "having to deal with the complications of :data:`CLOCK_REALTIME`, which may " @@ -1495,11 +1495,11 @@ msgstr "" "değiştirildiğinde süreksizliklere sahip olabilecek, askıya alma farkında " "monoton bir saat elde etmelerini sağlar." -#: library/time.rst:813 +#: library/time.rst:812 msgid ":ref:`Availability `: Linux >= 2.6.39." msgstr ":ref:`Availability `: Linux >= 2.6.39." -#: library/time.rst:820 +#: library/time.rst:819 msgid "" "The Solaris OS has a ``CLOCK_HIGHRES`` timer that attempts to use an optimal " "hardware source, and may give close to nanosecond resolution. " @@ -1509,11 +1509,11 @@ msgstr "" "yakın kesinlik sağlayabilen bir ``CLOCK_HIGHRES`` zamanlayıcıya sahiptir. " "``CLOCK_HIGHRES`` ayarlanamaz, yüksek kesinlikli saattir." -#: library/time.rst:824 +#: library/time.rst:823 msgid ":ref:`Availability `: Solaris." msgstr ":ref:`Availability `: Solaris." -#: library/time.rst:831 +#: library/time.rst:830 msgid "" "Clock that cannot be set and represents monotonic time since some " "unspecified starting point." @@ -1521,7 +1521,7 @@ msgstr "" "Belirsiz başlangıç noktasından beri ayarlanamayan ve monoton zamanı temsil " "eden saat." -#: library/time.rst:841 +#: library/time.rst:840 msgid "" "Similar to :data:`CLOCK_MONOTONIC`, but provides access to a raw hardware-" "based time that is not subject to NTP adjustments." @@ -1529,19 +1529,19 @@ msgstr "" ":data:`CLOCK_MONOTONIC` ile benzer, ama NTP ayarlamalarına tabii olmayan " "donanım bazlı ham zamana erişim sağlar." -#: library/time.rst:844 +#: library/time.rst:843 msgid ":ref:`Availability `: Linux >= 2.6.28, macOS >= 10.12." msgstr ":ref:`Availability `: Linux >= 2.6.28, macOS >= 10.12." -#: library/time.rst:860 +#: library/time.rst:859 msgid "High-resolution per-process timer from the CPU." msgstr "CPU'dan yüksek kesinlikli işlem başına zamanlayıcısı." -#: library/time.rst:862 +#: library/time.rst:861 msgid ":ref:`Availability `: FreeBSD, NetBSD >= 7, OpenBSD." msgstr ":ref:`Availability `: FreeBSD, NetBSD >= 7, OpenBSD." -#: library/time.rst:868 +#: library/time.rst:867 msgid "" "`International Atomic Time `_" @@ -1549,7 +1549,7 @@ msgstr "" "`International Atomic Time `_" -#: library/time.rst:870 +#: library/time.rst:869 msgid "" "The system must have a current leap second table in order for this to give " "the correct answer. PTP or NTP software can maintain a leap second table." @@ -1558,15 +1558,15 @@ msgstr "" "tablosuna sahip olması gerekir. PTP veya NTP yazılımı artık saniye " "tablosunu sürdürebilir." -#: library/time.rst:873 +#: library/time.rst:872 msgid ":ref:`Availability `: Linux." msgstr ":ref:`Availability `: Linux." -#: library/time.rst:879 +#: library/time.rst:878 msgid "Thread-specific CPU-time clock." msgstr "İş parçacığına özgü CPU zamanlayıcı saati." -#: library/time.rst:888 +#: library/time.rst:887 msgid "" "Time whose absolute value is the time the system has been running and not " "suspended, providing accurate uptime measurement, both absolute and interval." @@ -1574,11 +1574,11 @@ msgstr "" "Mutlak değeri sistemin çalıştığı ve askıya alınmadığı süre olan süre, hem " "mutlak hem de aralıklı olarak doğru çalışma süresi ölçümü sağlar." -#: library/time.rst:892 +#: library/time.rst:891 msgid ":ref:`Availability `: FreeBSD, OpenBSD >= 5.5." msgstr ":ref:`Availability `: FreeBSD, OpenBSD >= 5.5." -#: library/time.rst:899 +#: library/time.rst:898 msgid "" "Clock that increments monotonically, tracking the time since an arbitrary " "point, unaffected by frequency or time adjustments and not incremented while " @@ -1588,18 +1588,18 @@ msgstr "" "ediyor, sıklıktan ve zaman ayarlamalarından etkilenmiyor ve sistem " "uykudayken artmıyor." -#: library/time.rst:903 +#: library/time.rst:902 msgid ":ref:`Availability `: macOS >= 10.12." msgstr ":ref:`Availability `: macOS >= 10.12." -#: library/time.rst:907 +#: library/time.rst:906 msgid "" "The following constant is the only parameter that can be sent to :func:" "`clock_settime`." msgstr "" "Aşağıdaki sabit :func:`clock_settime`'a gönderilebilecek tek parametredir." -#: library/time.rst:913 +#: library/time.rst:912 msgid "" "System-wide real-time clock. Setting this clock requires appropriate " "privileges." @@ -1607,11 +1607,11 @@ msgstr "" "Sistem çapında gerçek zamanlı saat. Bu saati ayarlamak uygun izinleri " "gerektirir." -#: library/time.rst:924 +#: library/time.rst:923 msgid "Timezone Constants" msgstr "Saat dilimi Sabitleri" -#: library/time.rst:928 +#: library/time.rst:927 msgid "" "The offset of the local DST timezone, in seconds west of UTC, if one is " "defined. This is negative if the local DST timezone is east of UTC (as in " @@ -1623,13 +1623,13 @@ msgstr "" "Avrupa'da olduğu gibi) bu negatiftir. Bunu yalnızca ``daylight`` sıfır " "değilse kullanın. Aşağıdaki nota bakın." -#: library/time.rst:934 +#: library/time.rst:933 msgid "Nonzero if a DST timezone is defined. See note below." msgstr "" "Sıfırdan farklı, eğer bir DST saat dilimi tanımlanmışsa. Aşağıdaki nota göz " "atın." -#: library/time.rst:938 +#: library/time.rst:937 msgid "" "The offset of the local (non-DST) timezone, in seconds west of UTC (negative " "in most of Western Europe, positive in the US, zero in the UK). See note " @@ -1639,7 +1639,7 @@ msgstr "" "farkı (Batı Avrupa'nın çoğunda negatif, ABD'de pozitif, Birleşik Krallık'ta " "sıfır). Aşağıdaki nota bakın." -#: library/time.rst:943 +#: library/time.rst:942 msgid "" "A tuple of two strings: the first is the name of the local non-DST timezone, " "the second is the name of the local DST timezone. If no DST timezone is " @@ -1649,7 +1649,7 @@ msgstr "" "ikincisi yerel DST saat diliminin ismi. DST saat dilimi tanımlanmamışsa, " "ikinci dize kullanılmamalı. Aşağıdaki nota bakın." -#: library/time.rst:949 +#: library/time.rst:948 #, fuzzy msgid "" "For the above Timezone constants (:data:`altzone`, :data:`daylight`, :data:" @@ -1666,19 +1666,19 @@ msgstr "" "almak için :func:`localtime`'den :attr:`tm_gmtoff` ve :attr:`tm_zone` " "sonuçlarının kullanılması önerilir." -#: library/time.rst:959 +#: library/time.rst:958 msgid "Module :mod:`datetime`" msgstr ":mod:`datetime` modülü" -#: library/time.rst:959 +#: library/time.rst:958 msgid "More object-oriented interface to dates and times." msgstr "Tarihler ve zamanlar için daha fazla nesne tabanlı arayüz." -#: library/time.rst:963 +#: library/time.rst:962 msgid "Module :mod:`locale`" msgstr ":mod:`locale` modülü" -#: library/time.rst:962 +#: library/time.rst:961 msgid "" "Internationalization services. The locale setting affects the " "interpretation of many format specifiers in :func:`strftime` and :func:" @@ -1687,11 +1687,11 @@ msgstr "" "Uluslararasılaştırma servisleri. Yerel ayar, :func:`strftime` ve :func:" "`strptime` içindeki birçok biçim belirticisinin yorumlanmasını etkiler." -#: library/time.rst:966 +#: library/time.rst:965 msgid "Module :mod:`calendar`" msgstr ":mod:`calendar` modülü" -#: library/time.rst:966 +#: library/time.rst:965 msgid "" "General calendar-related functions. :func:`~calendar.timegm` is the " "inverse of :func:`gmtime` from this module." @@ -1699,11 +1699,11 @@ msgstr "" "Genel takvim ile alakalı fonksiyonlar. :func:`~calendar.timegm` bu " "modüldeki :func:`gmtime`'in tersidir." -#: library/time.rst:970 +#: library/time.rst:969 msgid "Footnotes" msgstr "Dipnotlar" -#: library/time.rst:971 +#: library/time.rst:970 msgid "" "The use of ``%Z`` is now deprecated, but the ``%z`` escape that expands to " "the preferred hour/minute offset is not supported by all ANSI C libraries. " @@ -1749,23 +1749,23 @@ msgstr "" msgid "Daylight Saving Time" msgstr "" -#: library/time.rst:336 library/time.rst:679 +#: library/time.rst:336 library/time.rst:678 msgid "benchmarking" msgstr "" -#: library/time.rst:679 +#: library/time.rst:678 msgid "CPU time" msgstr "" -#: library/time.rst:679 +#: library/time.rst:678 msgid "processor time" msgstr "" -#: library/time.rst:540 +#: library/time.rst:539 msgid "% (percent)" msgstr "" -#: library/time.rst:540 +#: library/time.rst:539 msgid "datetime format" msgstr "" diff --git a/library/typing.po b/library/typing.po index 96453afcd..ff4794d1f 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -403,7 +403,7 @@ msgid "" "of type :class:`int` and returns a :class:`str`." msgstr "" -#: library/typing.rst:2890 library/typing.rst:3032 +#: library/typing.rst:2889 library/typing.rst:3031 msgid "For example:" msgstr "" @@ -441,7 +441,7 @@ msgid "" "ReturnType]`` respectively." msgstr "" -#: library/typing.rst:3561 +#: library/typing.rst:3557 msgid "" "``Callable`` now supports :class:`ParamSpec` and :data:`Concatenate`. See :" "pep:`612` for more details." @@ -820,8 +820,8 @@ msgid "" "or :class:`bytes` arguments but cannot allow the two to mix." msgstr "" -#: library/typing.rst:934 library/typing.rst:1011 library/typing.rst:1234 -#: library/typing.rst:2830 +#: library/typing.rst:934 library/typing.rst:1010 library/typing.rst:1233 +#: library/typing.rst:2829 msgid "For example::" msgstr "" @@ -844,7 +844,7 @@ msgid "" "``LiteralString``." msgstr "" -#: library/typing.rst:1958 +#: library/typing.rst:1957 msgid "Example:" msgstr "" @@ -890,17 +890,17 @@ msgid "" "checkers should treat the two equivalently." msgstr "" -#: library/typing.rst:952 +#: library/typing.rst:951 msgid "Special type to represent the current enclosed class." msgstr "" -#: library/typing.rst:968 +#: library/typing.rst:967 msgid "" "This annotation is semantically equivalent to the following, albeit in a " "more succinct fashion::" msgstr "" -#: library/typing.rst:980 +#: library/typing.rst:979 msgid "" "In general, if something returns ``self``, as in the above examples, you " "should use ``Self`` as the return annotation. If ``Foo.return_self`` was " @@ -909,48 +909,48 @@ msgid "" "rather than ``SubclassOfFoo``." msgstr "" -#: library/typing.rst:986 +#: library/typing.rst:985 msgid "Other common use cases include:" msgstr "" -#: library/typing.rst:988 +#: library/typing.rst:987 msgid "" ":class:`classmethod`\\s that are used as alternative constructors and return " "instances of the ``cls`` parameter." msgstr "" -#: library/typing.rst:990 +#: library/typing.rst:989 msgid "Annotating an :meth:`~object.__enter__` method which returns self." msgstr "" -#: library/typing.rst:992 +#: library/typing.rst:991 msgid "" "You should not use ``Self`` as the return annotation if the method is not " "guaranteed to return an instance of a subclass when the class is subclassed::" msgstr "" -#: library/typing.rst:1003 +#: library/typing.rst:1002 msgid "See :pep:`673` for more details." msgstr "" -#: library/typing.rst:1009 +#: library/typing.rst:1008 msgid "" "Special annotation for explicitly declaring a :ref:`type alias `." msgstr "" -#: library/typing.rst:1017 +#: library/typing.rst:1016 msgid "" "``TypeAlias`` is particularly useful on older Python versions for annotating " "aliases that make use of forward references, as it can be hard for type " "checkers to distinguish these from normal variable assignments:" msgstr "" -#: library/typing.rst:1037 +#: library/typing.rst:1036 msgid "See :pep:`613` for more details." msgstr "" -#: library/typing.rst:1041 +#: library/typing.rst:1040 msgid "" ":data:`TypeAlias` is deprecated in favor of the :keyword:`type` statement, " "which creates instances of :class:`TypeAliasType` and which natively " @@ -961,71 +961,71 @@ msgid "" "to :keyword:`type` statements." msgstr "" -#: library/typing.rst:1052 +#: library/typing.rst:1051 msgid "Special forms" msgstr "" -#: library/typing.rst:1054 +#: library/typing.rst:1053 msgid "" "These can be used as types in annotations. They all support subscription " "using ``[]``, but each has a unique syntax." msgstr "" -#: library/typing.rst:1059 +#: library/typing.rst:1058 msgid "" "Union type; ``Union[X, Y]`` is equivalent to ``X | Y`` and means either X or " "Y." msgstr "" -#: library/typing.rst:1061 +#: library/typing.rst:1060 msgid "" "To define a union, use e.g. ``Union[int, str]`` or the shorthand ``int | " "str``. Using that shorthand is recommended. Details:" msgstr "" -#: library/typing.rst:1063 +#: library/typing.rst:1062 msgid "The arguments must be types and there must be at least one." msgstr "" -#: library/typing.rst:1065 +#: library/typing.rst:1064 msgid "Unions of unions are flattened, e.g.::" msgstr "" -#: library/typing.rst:1069 +#: library/typing.rst:1068 msgid "Unions of a single argument vanish, e.g.::" msgstr "" -#: library/typing.rst:1073 +#: library/typing.rst:1072 msgid "Redundant arguments are skipped, e.g.::" msgstr "" -#: library/typing.rst:1077 +#: library/typing.rst:1076 msgid "When comparing unions, the argument order is ignored, e.g.::" msgstr "" -#: library/typing.rst:1081 +#: library/typing.rst:1080 msgid "You cannot subclass or instantiate a ``Union``." msgstr "" -#: library/typing.rst:1083 +#: library/typing.rst:1082 msgid "You cannot write ``Union[X][Y]``." msgstr "" -#: library/typing.rst:1085 +#: library/typing.rst:1084 msgid "Don't remove explicit subclasses from unions at runtime." msgstr "" -#: library/typing.rst:1088 +#: library/typing.rst:1087 msgid "" "Unions can now be written as ``X | Y``. See :ref:`union type " "expressions`." msgstr "" -#: library/typing.rst:1094 +#: library/typing.rst:1093 msgid "``Optional[X]`` is equivalent to ``X | None`` (or ``Union[X, None]``)." msgstr "" -#: library/typing.rst:1096 +#: library/typing.rst:1095 msgid "" "Note that this is not the same concept as an optional argument, which is one " "that has a default. An optional argument with a default does not require " @@ -1033,24 +1033,24 @@ msgid "" "optional. For example::" msgstr "" -#: library/typing.rst:1104 +#: library/typing.rst:1103 msgid "" "On the other hand, if an explicit value of ``None`` is allowed, the use of " "``Optional`` is appropriate, whether the argument is optional or not. For " "example::" msgstr "" -#: library/typing.rst:1111 +#: library/typing.rst:1110 msgid "" "Optional can now be written as ``X | None``. See :ref:`union type " "expressions`." msgstr "" -#: library/typing.rst:1117 +#: library/typing.rst:1116 msgid "Special form for annotating higher-order functions." msgstr "" -#: library/typing.rst:1119 +#: library/typing.rst:1118 msgid "" "``Concatenate`` can be used in conjunction with :ref:`Callable ` and :class:`ParamSpec` to annotate a higher-order callable which " @@ -1061,7 +1061,7 @@ msgid "" "``Concatenate`` must be a :class:`ParamSpec` or ellipsis (``...``)." msgstr "" -#: library/typing.rst:1128 +#: library/typing.rst:1127 msgid "" "For example, to annotate a decorator ``with_lock`` which provides a :class:" "`threading.Lock` to the decorated function, ``Concatenate`` can be used to " @@ -1072,38 +1072,38 @@ msgid "" "passed in::" msgstr "" -#: library/typing.rst:1926 +#: library/typing.rst:1925 msgid "" ":pep:`612` -- Parameter Specification Variables (the PEP which introduced " "``ParamSpec`` and ``Concatenate``)" msgstr "" -#: library/typing.rst:1166 +#: library/typing.rst:1165 msgid ":class:`ParamSpec`" msgstr "" -#: library/typing.rst:1929 +#: library/typing.rst:1928 msgid ":ref:`annotating-callables`" msgstr "" -#: library/typing.rst:1171 +#: library/typing.rst:1170 msgid "Special typing form to define \"literal types\"." msgstr "" -#: library/typing.rst:1173 +#: library/typing.rst:1172 msgid "" "``Literal`` can be used to indicate to type checkers that the annotated " "object has a value equivalent to one of the provided literals." msgstr "" -#: library/typing.rst:1189 +#: library/typing.rst:1188 msgid "" "``Literal[...]`` cannot be subclassed. At runtime, an arbitrary value is " "allowed as type argument to ``Literal[...]``, but type checkers may impose " "restrictions. See :pep:`586` for more details about literal types." msgstr "" -#: library/typing.rst:1195 +#: library/typing.rst:1194 msgid "" "``Literal`` now de-duplicates parameters. Equality comparisons of " "``Literal`` objects are no longer order dependent. ``Literal`` objects will " @@ -1111,22 +1111,22 @@ msgid "" "their parameters are not :term:`hashable`." msgstr "" -#: library/typing.rst:1203 +#: library/typing.rst:1202 msgid "Special type construct to mark class variables." msgstr "" -#: library/typing.rst:1205 +#: library/typing.rst:1204 msgid "" "As introduced in :pep:`526`, a variable annotation wrapped in ClassVar " "indicates that a given attribute is intended to be used as a class variable " "and should not be set on instances of that class. Usage::" msgstr "" -#: library/typing.rst:1213 +#: library/typing.rst:1212 msgid ":data:`ClassVar` accepts only types and cannot be further subscribed." msgstr "" -#: library/typing.rst:1215 +#: library/typing.rst:1214 msgid "" ":data:`ClassVar` is not a class itself, and should not be used with :func:" "`isinstance` or :func:`issubclass`. :data:`ClassVar` does not change Python " @@ -1134,47 +1134,47 @@ msgid "" "example, a type checker might flag the following code as an error::" msgstr "" -#: library/typing.rst:1229 +#: library/typing.rst:1228 msgid "Special typing construct to indicate final names to type checkers." msgstr "" -#: library/typing.rst:1231 +#: library/typing.rst:1230 msgid "" "Final names cannot be reassigned in any scope. Final names declared in class " "scopes cannot be overridden in subclasses." msgstr "" -#: library/typing.rst:2846 +#: library/typing.rst:2845 msgid "" "There is no runtime checking of these properties. See :pep:`591` for more " "details." msgstr "" -#: library/typing.rst:1252 +#: library/typing.rst:1251 msgid "Special typing construct to mark a :class:`TypedDict` key as required." msgstr "" -#: library/typing.rst:1254 +#: library/typing.rst:1253 msgid "" "This is mainly useful for ``total=False`` TypedDicts. See :class:`TypedDict` " "and :pep:`655` for more details." msgstr "" -#: library/typing.rst:1261 +#: library/typing.rst:1260 msgid "" "Special typing construct to mark a :class:`TypedDict` key as potentially " "missing." msgstr "" -#: library/typing.rst:1264 +#: library/typing.rst:1263 msgid "See :class:`TypedDict` and :pep:`655` for more details." msgstr "" -#: library/typing.rst:1270 +#: library/typing.rst:1269 msgid "Special typing form to add context-specific metadata to an annotation." msgstr "" -#: library/typing.rst:1272 +#: library/typing.rst:1271 msgid "" "Add metadata ``x`` to a given type ``T`` by using the annotation " "``Annotated[T, x]``. Metadata added using ``Annotated`` can be used by " @@ -1182,7 +1182,7 @@ msgid "" "a :attr:`!__metadata__` attribute." msgstr "" -#: library/typing.rst:1277 +#: library/typing.rst:1276 msgid "" "If a library or tool encounters an annotation ``Annotated[T, x]`` and has no " "special logic for the metadata, it should ignore the metadata and simply " @@ -1191,7 +1191,7 @@ msgid "" "system." msgstr "" -#: library/typing.rst:1283 +#: library/typing.rst:1282 msgid "" "Using ``Annotated[T, x]`` as an annotation still allows for static " "typechecking of ``T``, as type checkers will simply ignore the metadata " @@ -1201,7 +1201,7 @@ msgid "" "for a function or class." msgstr "" -#: library/typing.rst:1290 +#: library/typing.rst:1289 msgid "" "The responsibility of how to interpret the metadata lies with the tool or " "library encountering an ``Annotated`` annotation. A tool or library " @@ -1209,105 +1209,105 @@ msgid "" "determine if they are of interest (e.g., using :func:`isinstance`)." msgstr "" -#: library/typing.rst:1298 +#: library/typing.rst:1297 msgid "" "Here is an example of how you might use ``Annotated`` to add metadata to " "type annotations if you were doing range analysis:" msgstr "" -#: library/typing.rst:1311 +#: library/typing.rst:1310 msgid "Details of the syntax:" msgstr "" -#: library/typing.rst:1313 +#: library/typing.rst:1312 msgid "The first argument to ``Annotated`` must be a valid type" msgstr "" -#: library/typing.rst:1315 +#: library/typing.rst:1314 msgid "" "Multiple metadata elements can be supplied (``Annotated`` supports variadic " "arguments)::" msgstr "" -#: library/typing.rst:1324 +#: library/typing.rst:1323 msgid "" "It is up to the tool consuming the annotations to decide whether the client " "is allowed to add multiple metadata elements to one annotation and how to " "merge those annotations." msgstr "" -#: library/typing.rst:1328 +#: library/typing.rst:1327 msgid "" "``Annotated`` must be subscripted with at least two arguments " "( ``Annotated[int]`` is not valid)" msgstr "" -#: library/typing.rst:1331 +#: library/typing.rst:1330 msgid "" "The order of the metadata elements is preserved and matters for equality " "checks::" msgstr "" -#: library/typing.rst:1338 +#: library/typing.rst:1337 msgid "" "Nested ``Annotated`` types are flattened. The order of the metadata elements " "starts with the innermost annotation::" msgstr "" -#: library/typing.rst:1345 +#: library/typing.rst:1344 msgid "Duplicated metadata elements are not removed::" msgstr "" -#: library/typing.rst:1351 +#: library/typing.rst:1350 msgid "``Annotated`` can be used with nested and generic aliases:" msgstr "" -#: library/typing.rst:1365 +#: library/typing.rst:1364 msgid "``Annotated`` cannot be used with an unpacked :class:`TypeVarTuple`::" msgstr "" -#: library/typing.rst:1369 +#: library/typing.rst:1368 msgid "This would be equivalent to::" msgstr "" -#: library/typing.rst:1373 +#: library/typing.rst:1372 msgid "" "where ``T1``, ``T2``, etc. are :class:`TypeVars `. This would be " "invalid: only one type should be passed to Annotated." msgstr "" -#: library/typing.rst:1376 +#: library/typing.rst:1375 msgid "" "By default, :func:`get_type_hints` strips the metadata from annotations. " "Pass ``include_extras=True`` to have the metadata preserved:" msgstr "" -#: library/typing.rst:1389 +#: library/typing.rst:1388 msgid "" "At runtime, the metadata associated with an ``Annotated`` type can be " "retrieved via the :attr:`!__metadata__` attribute:" msgstr "" -#: library/typing.rst:1403 +#: library/typing.rst:1402 msgid ":pep:`593` - Flexible function and variable annotations" msgstr "" -#: library/typing.rst:1404 +#: library/typing.rst:1403 msgid "The PEP introducing ``Annotated`` to the standard library." msgstr "" -#: library/typing.rst:1411 +#: library/typing.rst:1410 msgid "Special typing construct for marking user-defined type guard functions." msgstr "" -#: library/typing.rst:1413 +#: library/typing.rst:1412 msgid "" "``TypeGuard`` can be used to annotate the return type of a user-defined type " "guard function. ``TypeGuard`` only accepts a single type argument. At " "runtime, functions marked this way should return a boolean." msgstr "" -#: library/typing.rst:1417 +#: library/typing.rst:1416 msgid "" "``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static " "type checkers to determine a more precise type of an expression within a " @@ -1316,44 +1316,44 @@ msgid "" "conditional expression here is sometimes referred to as a \"type guard\"::" msgstr "" -#: library/typing.rst:1432 +#: library/typing.rst:1431 msgid "" "Sometimes it would be convenient to use a user-defined boolean function as a " "type guard. Such a function should use ``TypeGuard[...]`` as its return " "type to alert static type checkers to this intention." msgstr "" -#: library/typing.rst:1436 +#: library/typing.rst:1435 msgid "" "Using ``-> TypeGuard`` tells the static type checker that for a given " "function:" msgstr "" -#: library/typing.rst:1439 +#: library/typing.rst:1438 msgid "The return value is a boolean." msgstr "" -#: library/typing.rst:1440 +#: library/typing.rst:1439 msgid "" "If the return value is ``True``, the type of its argument is the type inside " "``TypeGuard``." msgstr "" -#: library/typing.rst:1457 +#: library/typing.rst:1456 msgid "" "If ``is_str_list`` is a class or instance method, then the type in " "``TypeGuard`` maps to the type of the second parameter after ``cls`` or " "``self``." msgstr "" -#: library/typing.rst:1461 +#: library/typing.rst:1460 msgid "" "In short, the form ``def foo(arg: TypeA) -> TypeGuard[TypeB]: ...``, means " "that if ``foo(arg)`` returns ``True``, then ``arg`` narrows from ``TypeA`` " "to ``TypeB``." msgstr "" -#: library/typing.rst:1467 +#: library/typing.rst:1466 msgid "" "``TypeB`` need not be a narrower form of ``TypeA`` -- it can even be a wider " "form. The main reason is to allow for things like narrowing ``list[object]`` " @@ -1362,24 +1362,24 @@ msgid "" "guards is left to the user." msgstr "" -#: library/typing.rst:1473 +#: library/typing.rst:1472 msgid "" "``TypeGuard`` also works with type variables. See :pep:`647` for more " "details." msgstr "" -#: library/typing.rst:1480 +#: library/typing.rst:1479 msgid "Typing operator to conceptually mark an object as having been unpacked." msgstr "" -#: library/typing.rst:1482 +#: library/typing.rst:1481 msgid "" "For example, using the unpack operator ``*`` on a :ref:`type variable tuple " "` is equivalent to using ``Unpack`` to mark the type variable " "tuple as having been unpacked::" msgstr "" -#: library/typing.rst:1491 +#: library/typing.rst:1490 msgid "" "In fact, ``Unpack`` can be used interchangeably with ``*`` in the context " "of :class:`typing.TypeVarTuple ` and :class:`builtins.tuple " @@ -1387,29 +1387,29 @@ msgid "" "versions of Python, where ``*`` couldn't be used in certain places::" msgstr "" -#: library/typing.rst:1505 +#: library/typing.rst:1504 msgid "" "``Unpack`` can also be used along with :class:`typing.TypedDict` for typing " "``**kwargs`` in a function signature::" msgstr "" -#: library/typing.rst:1518 +#: library/typing.rst:1517 msgid "" "See :pep:`692` for more details on using ``Unpack`` for ``**kwargs`` typing." msgstr "" -#: library/typing.rst:1523 +#: library/typing.rst:1522 msgid "Building generic types and type aliases" msgstr "" -#: library/typing.rst:1525 +#: library/typing.rst:1524 msgid "" "The following classes should not be used directly as annotations. Their " "intended purpose is to be building blocks for creating generic types and " "type aliases." msgstr "" -#: library/typing.rst:1529 +#: library/typing.rst:1528 msgid "" "These objects can be created through special syntax (:ref:`type parameter " "lists ` and the :keyword:`type` statement). For compatibility " @@ -1417,62 +1417,62 @@ msgid "" "syntax, as documented below." msgstr "" -#: library/typing.rst:1536 +#: library/typing.rst:1535 msgid "Abstract base class for generic types." msgstr "" -#: library/typing.rst:1538 +#: library/typing.rst:1537 msgid "" "A generic type is typically declared by adding a list of type parameters " "after the class name::" msgstr "" -#: library/typing.rst:1546 +#: library/typing.rst:1545 msgid "" "Such a class implicitly inherits from ``Generic``. The runtime semantics of " "this syntax are discussed in the :ref:`Language Reference `." msgstr "" -#: library/typing.rst:1550 +#: library/typing.rst:1549 msgid "This class can then be used as follows::" msgstr "" -#: library/typing.rst:1558 +#: library/typing.rst:1557 msgid "" "Here the brackets after the function name indicate a :ref:`generic function " "`." msgstr "" -#: library/typing.rst:1561 +#: library/typing.rst:1560 msgid "" "For backwards compatibility, generic classes can also be declared by " "explicitly inheriting from ``Generic``. In this case, the type parameters " "must be declared separately::" msgstr "" -#: library/typing.rst:1578 +#: library/typing.rst:1577 msgid "Type variable." msgstr "" -#: library/typing.rst:1580 +#: library/typing.rst:1579 msgid "" "The preferred way to construct a type variable is via the dedicated syntax " "for :ref:`generic functions `, :ref:`generic classes " "`, and :ref:`generic type aliases `::" msgstr "" -#: library/typing.rst:1588 +#: library/typing.rst:1587 msgid "" "This syntax can also be used to create bound and constrained type variables::" msgstr "" -#: library/typing.rst:1598 +#: library/typing.rst:1597 msgid "" "However, if desired, reusable type variables can also be constructed " "manually, like so::" msgstr "" -#: library/typing.rst:1604 +#: library/typing.rst:1603 msgid "" "Type variables exist primarily for the benefit of static type checkers. " "They serve as the parameters for generic types as well as for generic " @@ -1480,13 +1480,13 @@ msgid "" "information on generic types. Generic functions work as follows::" msgstr "" -#: library/typing.rst:1625 +#: library/typing.rst:1624 msgid "" "Note that type variables can be *bound*, *constrained*, or neither, but " "cannot be both bound *and* constrained." msgstr "" -#: library/typing.rst:1628 +#: library/typing.rst:1627 msgid "" "The variance of type variables is inferred by type checkers when they are " "created through the :ref:`type parameter syntax ` or when " @@ -1496,92 +1496,92 @@ msgid "" "invariant. See :pep:`484` and :pep:`695` for more details." msgstr "" -#: library/typing.rst:1636 +#: library/typing.rst:1635 msgid "" "Bound type variables and constrained type variables have different semantics " "in several important ways. Using a *bound* type variable means that the " "``TypeVar`` will be solved using the most specific type possible::" msgstr "" -#: library/typing.rst:1651 +#: library/typing.rst:1650 msgid "" "Type variables can be bound to concrete types, abstract types (ABCs or " "protocols), and even unions of types::" msgstr "" -#: library/typing.rst:1663 +#: library/typing.rst:1662 msgid "" "Using a *constrained* type variable, however, means that the ``TypeVar`` can " "only ever be solved as being exactly one of the constraints given::" msgstr "" -#: library/typing.rst:1674 +#: library/typing.rst:1673 msgid "At runtime, ``isinstance(x, T)`` will raise :exc:`TypeError`." msgstr "" -#: library/typing.rst:1678 +#: library/typing.rst:1677 msgid "The name of the type variable." msgstr "" -#: library/typing.rst:1682 +#: library/typing.rst:1681 msgid "Whether the type var has been explicitly marked as covariant." msgstr "" -#: library/typing.rst:1686 +#: library/typing.rst:1685 msgid "Whether the type var has been explicitly marked as contravariant." msgstr "" -#: library/typing.rst:1690 +#: library/typing.rst:1689 msgid "" "Whether the type variable's variance should be inferred by type checkers." msgstr "" -#: library/typing.rst:1696 +#: library/typing.rst:1695 msgid "The bound of the type variable, if any." msgstr "" -#: library/typing.rst:1700 +#: library/typing.rst:1699 msgid "" "For type variables created through :ref:`type parameter syntax `, the bound is evaluated only when the attribute is accessed, not " "when the type variable is created (see :ref:`lazy-evaluation`)." msgstr "" -#: library/typing.rst:1706 +#: library/typing.rst:1705 msgid "A tuple containing the constraints of the type variable, if any." msgstr "" -#: library/typing.rst:1710 +#: library/typing.rst:1709 msgid "" "For type variables created through :ref:`type parameter syntax `, the constraints are evaluated only when the attribute is accessed, " "not when the type variable is created (see :ref:`lazy-evaluation`)." msgstr "" -#: library/typing.rst:1716 +#: library/typing.rst:1715 msgid "" "Type variables can now be declared using the :ref:`type parameter ` syntax introduced by :pep:`695`. The ``infer_variance`` parameter " "was added." msgstr "" -#: library/typing.rst:1724 +#: library/typing.rst:1723 msgid "" "Type variable tuple. A specialized form of :ref:`type variable ` " "that enables *variadic* generics." msgstr "" -#: library/typing.rst:1727 +#: library/typing.rst:1726 msgid "" "Type variable tuples can be declared in :ref:`type parameter lists ` using a single asterisk (``*``) before the name::" msgstr "" -#: library/typing.rst:1733 +#: library/typing.rst:1732 msgid "Or by explicitly invoking the ``TypeVarTuple`` constructor::" msgstr "" -#: library/typing.rst:1741 +#: library/typing.rst:1740 msgid "" "A normal type variable enables parameterization with a single type. A type " "variable tuple, in contrast, allows parameterization with an *arbitrary* " @@ -1589,7 +1589,7 @@ msgid "" "wrapped in a tuple. For example::" msgstr "" -#: library/typing.rst:1763 +#: library/typing.rst:1762 msgid "" "Note the use of the unpacking operator ``*`` in ``tuple[T, *Ts]``. " "Conceptually, you can think of ``Ts`` as a tuple of type variables ``(T1, " @@ -1599,36 +1599,36 @@ msgid "" "` instead, as ``Unpack[Ts]``.)" msgstr "" -#: library/typing.rst:1771 +#: library/typing.rst:1770 msgid "" "Type variable tuples must *always* be unpacked. This helps distinguish type " "variable tuples from normal type variables::" msgstr "" -#: library/typing.rst:1778 +#: library/typing.rst:1777 msgid "" "Type variable tuples can be used in the same contexts as normal type " "variables. For example, in class definitions, arguments, and return types::" msgstr "" -#: library/typing.rst:1786 +#: library/typing.rst:1785 msgid "" "Type variable tuples can be happily combined with normal type variables:" msgstr "" -#: library/typing.rst:1802 +#: library/typing.rst:1801 msgid "" "However, note that at most one type variable tuple may appear in a single " "list of type arguments or type parameters::" msgstr "" -#: library/typing.rst:1809 +#: library/typing.rst:1808 msgid "" "Finally, an unpacked type variable tuple can be used as the type annotation " "of ``*args``::" msgstr "" -#: library/typing.rst:1819 +#: library/typing.rst:1818 msgid "" "In contrast to non-unpacked annotations of ``*args`` - e.g. ``*args: int``, " "which would specify that *all* arguments are ``int`` - ``*args: *Ts`` " @@ -1637,39 +1637,39 @@ msgid "" "``call_soon`` match the types of the (positional) arguments of ``callback``." msgstr "" -#: library/typing.rst:1826 +#: library/typing.rst:1825 msgid "See :pep:`646` for more details on type variable tuples." msgstr "" -#: library/typing.rst:1830 +#: library/typing.rst:1829 msgid "The name of the type variable tuple." msgstr "" -#: library/typing.rst:1836 +#: library/typing.rst:1835 msgid "" "Type variable tuples can now be declared using the :ref:`type parameter " "` syntax introduced by :pep:`695`." msgstr "" -#: library/typing.rst:1841 +#: library/typing.rst:1840 msgid "" "Parameter specification variable. A specialized version of :ref:`type " "variables `." msgstr "" -#: library/typing.rst:1844 +#: library/typing.rst:1843 msgid "" "In :ref:`type parameter lists `, parameter specifications can " "be declared with two asterisks (``**``)::" msgstr "" -#: library/typing.rst:1849 +#: library/typing.rst:1848 msgid "" "For compatibility with Python 3.11 and earlier, ``ParamSpec`` objects can " "also be created as follows::" msgstr "" -#: library/typing.rst:1854 +#: library/typing.rst:1853 msgid "" "Parameter specification variables exist primarily for the benefit of static " "type checkers. They are used to forward the parameter types of one callable " @@ -1679,7 +1679,7 @@ msgid "" "See :class:`Generic` for more information on generic types." msgstr "" -#: library/typing.rst:1861 +#: library/typing.rst:1860 msgid "" "For example, to add basic logging to a function, one can create a decorator " "``add_logging`` to log function calls. The parameter specification variable " @@ -1687,27 +1687,27 @@ msgid "" "new callable returned by it have inter-dependent type parameters::" msgstr "" -#: library/typing.rst:1881 +#: library/typing.rst:1880 msgid "" "Without ``ParamSpec``, the simplest way to annotate this previously was to " "use a :class:`TypeVar` with bound ``Callable[..., Any]``. However this " "causes two problems:" msgstr "" -#: library/typing.rst:1885 +#: library/typing.rst:1884 msgid "" "The type checker can't type check the ``inner`` function because ``*args`` " "and ``**kwargs`` have to be typed :data:`Any`." msgstr "" -#: library/typing.rst:1887 +#: library/typing.rst:1886 msgid "" ":func:`~cast` may be required in the body of the ``add_logging`` decorator " "when returning the ``inner`` function, or the static type checker must be " "told to ignore the ``return inner``." msgstr "" -#: library/typing.rst:1894 +#: library/typing.rst:1893 msgid "" "Since ``ParamSpec`` captures both positional and keyword parameters, ``P." "args`` and ``P.kwargs`` can be used to split a ``ParamSpec`` into its " @@ -1720,11 +1720,11 @@ msgid "" "`ParamSpecKwargs`." msgstr "" -#: library/typing.rst:1906 +#: library/typing.rst:1905 msgid "The name of the parameter specification." msgstr "" -#: library/typing.rst:1908 +#: library/typing.rst:1907 msgid "" "Parameter specification variables created with ``covariant=True`` or " "``contravariant=True`` can be used to declare covariant or contravariant " @@ -1733,23 +1733,23 @@ msgid "" "decided." msgstr "" -#: library/typing.rst:1918 +#: library/typing.rst:1917 msgid "" "Parameter specifications can now be declared using the :ref:`type parameter " "` syntax introduced by :pep:`695`." msgstr "" -#: library/typing.rst:1922 +#: library/typing.rst:1921 msgid "" "Only parameter specification variables defined in global scope can be " "pickled." msgstr "" -#: library/typing.rst:1928 +#: library/typing.rst:1927 msgid ":data:`Concatenate`" msgstr "" -#: library/typing.rst:1934 +#: library/typing.rst:1933 msgid "" "Arguments and keyword arguments attributes of a :class:`ParamSpec`. The ``P." "args`` attribute of a ``ParamSpec`` is an instance of ``ParamSpecArgs``, and " @@ -1757,71 +1757,71 @@ msgid "" "runtime introspection and have no special meaning to static type checkers." msgstr "" -#: library/typing.rst:1939 +#: library/typing.rst:1938 msgid "" "Calling :func:`get_origin` on either of these objects will return the " "original ``ParamSpec``:" msgstr "" -#: library/typing.rst:1956 +#: library/typing.rst:1955 msgid "The type of type aliases created through the :keyword:`type` statement." msgstr "" -#: library/typing.rst:1970 +#: library/typing.rst:1969 msgid "The name of the type alias:" msgstr "" -#: library/typing.rst:1980 +#: library/typing.rst:1979 msgid "The module in which the type alias was defined::" msgstr "" -#: library/typing.rst:1988 +#: library/typing.rst:1987 msgid "" "The type parameters of the type alias, or an empty tuple if the alias is not " "generic:" msgstr "" -#: library/typing.rst:2002 +#: library/typing.rst:2001 msgid "" "The type alias's value. This is :ref:`lazily evaluated `, " "so names used in the definition of the alias are not resolved until the " "``__value__`` attribute is accessed:" msgstr "" -#: library/typing.rst:2020 +#: library/typing.rst:2019 msgid "Other special directives" msgstr "" -#: library/typing.rst:2022 +#: library/typing.rst:2021 msgid "" "These functions and classes should not be used directly as annotations. " "Their intended purpose is to be building blocks for creating and declaring " "types." msgstr "" -#: library/typing.rst:2028 +#: library/typing.rst:2027 msgid "Typed version of :func:`collections.namedtuple`." msgstr "" -#: library/typing.rst:2107 library/typing.rst:3072 +#: library/typing.rst:2106 library/typing.rst:3071 msgid "Usage::" msgstr "" -#: library/typing.rst:2036 +#: library/typing.rst:2035 msgid "This is equivalent to::" msgstr "" -#: library/typing.rst:2040 +#: library/typing.rst:2039 msgid "" "To give a field a default value, you can assign to it in the class body::" msgstr "" -#: library/typing.rst:2049 +#: library/typing.rst:2048 msgid "" "Fields with a default value must come after any fields without a default." msgstr "" -#: library/typing.rst:2051 +#: library/typing.rst:2050 msgid "" "The resulting class has an extra attribute ``__annotations__`` giving a dict " "that maps the field names to the field types. (The field names are in the " @@ -1830,83 +1830,83 @@ msgid "" "API.)" msgstr "" -#: library/typing.rst:2057 +#: library/typing.rst:2056 msgid "``NamedTuple`` subclasses can also have docstrings and methods::" msgstr "" -#: library/typing.rst:2067 +#: library/typing.rst:2066 msgid "``NamedTuple`` subclasses can be generic::" msgstr "" -#: library/typing.rst:2073 +#: library/typing.rst:2072 msgid "Backward-compatible usage::" msgstr "" -#: library/typing.rst:2083 +#: library/typing.rst:2082 msgid "Added support for :pep:`526` variable annotation syntax." msgstr "" -#: library/typing.rst:2086 +#: library/typing.rst:2085 msgid "Added support for default values, methods, and docstrings." msgstr "" -#: library/typing.rst:2089 +#: library/typing.rst:2088 msgid "" "The ``_field_types`` and ``__annotations__`` attributes are now regular " "dictionaries instead of instances of ``OrderedDict``." msgstr "" -#: library/typing.rst:2093 +#: library/typing.rst:2092 msgid "" "Removed the ``_field_types`` attribute in favor of the more standard " "``__annotations__`` attribute which has the same information." msgstr "" -#: library/typing.rst:2097 +#: library/typing.rst:2096 msgid "Added support for generic namedtuples." msgstr "" -#: library/typing.rst:2102 +#: library/typing.rst:2101 msgid "Helper class to create low-overhead :ref:`distinct types `." msgstr "" -#: library/typing.rst:2104 +#: library/typing.rst:2103 msgid "" "A ``NewType`` is considered a distinct type by a typechecker. At runtime, " "however, calling a ``NewType`` returns its argument unchanged." msgstr "" -#: library/typing.rst:2114 +#: library/typing.rst:2113 msgid "The module in which the new type is defined." msgstr "" -#: library/typing.rst:2118 +#: library/typing.rst:2117 msgid "The name of the new type." msgstr "" -#: library/typing.rst:2122 +#: library/typing.rst:2121 msgid "The type that the new type is based on." msgstr "" -#: library/typing.rst:2126 +#: library/typing.rst:2125 msgid "``NewType`` is now a class rather than a function." msgstr "" -#: library/typing.rst:2131 +#: library/typing.rst:2130 msgid "Base class for protocol classes." msgstr "" -#: library/typing.rst:2133 +#: library/typing.rst:2132 msgid "Protocol classes are defined like this::" msgstr "" -#: library/typing.rst:2139 +#: library/typing.rst:2138 msgid "" "Such classes are primarily used with static type checkers that recognize " "structural subtyping (static duck-typing), for example::" msgstr "" -#: library/typing.rst:2151 +#: library/typing.rst:2150 msgid "" "See :pep:`544` for more details. Protocol classes decorated with :func:" "`runtime_checkable` (described later) act as simple-minded runtime protocols " @@ -1914,21 +1914,21 @@ msgid "" "signatures." msgstr "" -#: library/typing.rst:2156 +#: library/typing.rst:2155 msgid "Protocol classes can be generic, for example::" msgstr "" -#: library/typing.rst:2162 +#: library/typing.rst:2161 msgid "" "In code that needs to be compatible with Python 3.11 or older, generic " "Protocols can be written as follows::" msgstr "" -#: library/typing.rst:2175 +#: library/typing.rst:2174 msgid "Mark a protocol class as a runtime protocol." msgstr "" -#: library/typing.rst:2177 +#: library/typing.rst:2176 msgid "" "Such a protocol can be used with :func:`isinstance` and :func:`issubclass`. " "This raises :exc:`TypeError` when applied to a non-protocol class. This " @@ -1937,7 +1937,7 @@ msgid "" "Iterable`. For example::" msgstr "" -#: library/typing.rst:2197 +#: library/typing.rst:2196 msgid "" ":func:`!runtime_checkable` will check only the presence of the required " "methods or attributes, not their type signatures or types. For example, :" @@ -1948,7 +1948,7 @@ msgid "" "(instantiate) :class:`ssl.SSLObject`." msgstr "" -#: library/typing.rst:2208 +#: library/typing.rst:2207 msgid "" "An :func:`isinstance` check against a runtime-checkable protocol can be " "surprisingly slow compared to an ``isinstance()`` check against a non-" @@ -1956,7 +1956,7 @@ msgid "" "calls for structural checks in performance-sensitive code." msgstr "" -#: library/typing.rst:2216 +#: library/typing.rst:2215 msgid "" "The internal implementation of :func:`isinstance` checks against runtime-" "checkable protocols now uses :func:`inspect.getattr_static` to look up " @@ -1966,7 +1966,7 @@ msgid "" "versa. Most users are unlikely to be affected by this change." msgstr "" -#: library/typing.rst:2225 +#: library/typing.rst:2224 msgid "" "The members of a runtime-checkable protocol are now considered \"frozen\" at " "runtime as soon as the class has been created. Monkey-patching attributes " @@ -1975,13 +1975,13 @@ msgid "" "`\"What's new in Python 3.12\" ` for more details." msgstr "" -#: library/typing.rst:2236 +#: library/typing.rst:2235 msgid "" "Special construct to add type hints to a dictionary. At runtime it is a " "plain :class:`dict`." msgstr "" -#: library/typing.rst:2239 +#: library/typing.rst:2238 msgid "" "``TypedDict`` declares a dictionary type that expects all of its instances " "to have a certain set of keys, where each key is associated with a value of " @@ -1989,53 +1989,53 @@ msgid "" "enforced by type checkers. Usage::" msgstr "" -#: library/typing.rst:2255 +#: library/typing.rst:2254 msgid "" "To allow using this feature with older versions of Python that do not " "support :pep:`526`, ``TypedDict`` supports two additional equivalent " "syntactic forms:" msgstr "" -#: library/typing.rst:2259 +#: library/typing.rst:2258 msgid "Using a literal :class:`dict` as the second argument::" msgstr "" -#: library/typing.rst:2263 +#: library/typing.rst:2262 msgid "Using keyword arguments::" msgstr "" -#: library/typing.rst:2270 +#: library/typing.rst:2269 msgid "" "The keyword-argument syntax is deprecated in 3.11 and will be removed in " "3.13. It may also be unsupported by static type checkers." msgstr "" -#: library/typing.rst:2271 +#: library/typing.rst:2270 msgid "" "The functional syntax should also be used when any of the keys are not " "valid :ref:`identifiers `, for example because they are " "keywords or contain hyphens. Example::" msgstr "" -#: library/typing.rst:2283 +#: library/typing.rst:2282 msgid "" "By default, all keys must be present in a ``TypedDict``. It is possible to " "mark individual keys as non-required using :data:`NotRequired`::" msgstr "" -#: library/typing.rst:2294 +#: library/typing.rst:2293 msgid "" "This means that a ``Point2D`` ``TypedDict`` can have the ``label`` key " "omitted." msgstr "" -#: library/typing.rst:2297 +#: library/typing.rst:2296 msgid "" "It is also possible to mark all keys as non-required by default by " "specifying a totality of ``False``::" msgstr "" -#: library/typing.rst:2307 +#: library/typing.rst:2306 msgid "" "This means that a ``Point2D`` ``TypedDict`` can have any of the keys " "omitted. A type checker is only expected to support a literal ``False`` or " @@ -2043,53 +2043,53 @@ msgid "" "and makes all items defined in the class body required." msgstr "" -#: library/typing.rst:2312 +#: library/typing.rst:2311 msgid "" "Individual keys of a ``total=False`` ``TypedDict`` can be marked as required " "using :data:`Required`::" msgstr "" -#: library/typing.rst:2327 +#: library/typing.rst:2326 msgid "" "It is possible for a ``TypedDict`` type to inherit from one or more other " "``TypedDict`` types using the class-based syntax. Usage::" msgstr "" -#: library/typing.rst:2334 +#: library/typing.rst:2333 msgid "" "``Point3D`` has three items: ``x``, ``y`` and ``z``. It is equivalent to " "this definition::" msgstr "" -#: library/typing.rst:2342 +#: library/typing.rst:2341 msgid "" "A ``TypedDict`` cannot inherit from a non-\\ ``TypedDict`` class, except " "for :class:`Generic`. For example::" msgstr "" -#: library/typing.rst:2357 +#: library/typing.rst:2356 msgid "A ``TypedDict`` can be generic::" msgstr "" -#: library/typing.rst:2363 +#: library/typing.rst:2362 msgid "" "To create a generic ``TypedDict`` that is compatible with Python 3.11 or " "lower, inherit from :class:`Generic` explicitly:" msgstr "" -#: library/typing.rst:2374 +#: library/typing.rst:2373 msgid "" "A ``TypedDict`` can be introspected via annotations dicts (see :ref:" "`annotations-howto` for more information on annotations best practices), :" "attr:`__total__`, :attr:`__required_keys__`, and :attr:`__optional_keys__`." msgstr "" -#: library/typing.rst:2380 +#: library/typing.rst:2379 msgid "" "``Point2D.__total__`` gives the value of the ``total`` argument. Example:" msgstr "" -#: library/typing.rst:2396 +#: library/typing.rst:2395 msgid "" "This attribute reflects *only* the value of the ``total`` argument to the " "current ``TypedDict`` class, not whether the class is semantically total. " @@ -2100,21 +2100,21 @@ msgid "" "introspection." msgstr "" -#: library/typing.rst:2409 +#: library/typing.rst:2408 msgid "" "``Point2D.__required_keys__`` and ``Point2D.__optional_keys__`` return :" "class:`frozenset` objects containing required and non-required keys, " "respectively." msgstr "" -#: library/typing.rst:2412 +#: library/typing.rst:2411 msgid "" "Keys marked with :data:`Required` will always appear in " "``__required_keys__`` and keys marked with :data:`NotRequired` will always " "appear in ``__optional_keys__``." msgstr "" -#: library/typing.rst:2415 +#: library/typing.rst:2414 msgid "" "For backwards compatibility with Python 3.10 and below, it is also possible " "to use inheritance to declare both required and non-required keys in the " @@ -2123,7 +2123,7 @@ msgid "" "``TypedDict`` with a different value for ``total``:" msgstr "" -#: library/typing.rst:2440 +#: library/typing.rst:2439 msgid "" "If ``from __future__ import annotations`` is used or if annotations are " "given as strings, annotations are not evaluated when the ``TypedDict`` is " @@ -2132,130 +2132,130 @@ msgid "" "attributes may be incorrect." msgstr "" -#: library/typing.rst:2446 +#: library/typing.rst:2445 msgid "" "See :pep:`589` for more examples and detailed rules of using ``TypedDict``." msgstr "" -#: library/typing.rst:2450 +#: library/typing.rst:2449 msgid "" "Added support for marking individual keys as :data:`Required` or :data:" "`NotRequired`. See :pep:`655`." msgstr "" -#: library/typing.rst:2454 +#: library/typing.rst:2453 msgid "Added support for generic ``TypedDict``\\ s." msgstr "" -#: library/typing.rst:2458 +#: library/typing.rst:2457 msgid "Protocols" msgstr "" -#: library/typing.rst:2460 +#: library/typing.rst:2459 msgid "" "The following protocols are provided by the typing module. All are decorated " "with :func:`@runtime_checkable `." msgstr "" -#: library/typing.rst:2465 +#: library/typing.rst:2464 msgid "" "An ABC with one abstract method ``__abs__`` that is covariant in its return " "type." msgstr "" -#: library/typing.rst:2470 +#: library/typing.rst:2469 msgid "An ABC with one abstract method ``__bytes__``." msgstr "" -#: library/typing.rst:2474 +#: library/typing.rst:2473 msgid "An ABC with one abstract method ``__complex__``." msgstr "" -#: library/typing.rst:2478 +#: library/typing.rst:2477 msgid "An ABC with one abstract method ``__float__``." msgstr "" -#: library/typing.rst:2482 +#: library/typing.rst:2481 msgid "An ABC with one abstract method ``__index__``." msgstr "" -#: library/typing.rst:2488 +#: library/typing.rst:2487 msgid "An ABC with one abstract method ``__int__``." msgstr "" -#: library/typing.rst:2492 +#: library/typing.rst:2491 msgid "" "An ABC with one abstract method ``__round__`` that is covariant in its " "return type." msgstr "" -#: library/typing.rst:2496 +#: library/typing.rst:2495 msgid "ABCs for working with IO" msgstr "" -#: library/typing.rst:2502 +#: library/typing.rst:2501 msgid "" "Generic type ``IO[AnyStr]`` and its subclasses ``TextIO(IO[str])`` and " "``BinaryIO(IO[bytes])`` represent the types of I/O streams such as returned " "by :func:`open`." msgstr "" -#: library/typing.rst:2508 +#: library/typing.rst:2507 msgid "Functions and decorators" msgstr "" -#: library/typing.rst:2512 +#: library/typing.rst:2511 msgid "Cast a value to a type." msgstr "" -#: library/typing.rst:2514 +#: library/typing.rst:2513 msgid "" "This returns the value unchanged. To the type checker this signals that the " "return value has the designated type, but at runtime we intentionally don't " "check anything (we want this to be as fast as possible)." msgstr "" -#: library/typing.rst:2521 +#: library/typing.rst:2520 msgid "" "Ask a static type checker to confirm that *val* has an inferred type of " "*typ*." msgstr "" -#: library/typing.rst:2523 +#: library/typing.rst:2522 msgid "" "At runtime this does nothing: it returns the first argument unchanged with " "no checks or side effects, no matter the actual type of the argument." msgstr "" -#: library/typing.rst:2526 +#: library/typing.rst:2525 msgid "" "When a static type checker encounters a call to ``assert_type()``, it emits " "an error if the value is not of the specified type::" msgstr "" -#: library/typing.rst:2533 +#: library/typing.rst:2532 msgid "" "This function is useful for ensuring the type checker's understanding of a " "script is in line with the developer's intentions::" msgstr "" -#: library/typing.rst:2547 +#: library/typing.rst:2546 msgid "" "Ask a static type checker to confirm that a line of code is unreachable." msgstr "" -#: library/typing.rst:2549 +#: library/typing.rst:2548 msgid "Example::" msgstr "" -#: library/typing.rst:2560 +#: library/typing.rst:2559 msgid "" "Here, the annotations allow the type checker to infer that the last case can " "never execute, because ``arg`` is either an :class:`int` or a :class:`str`, " "and both options are covered by earlier cases." msgstr "" -#: library/typing.rst:2565 +#: library/typing.rst:2564 msgid "" "If a type checker finds that a call to ``assert_never()`` is reachable, it " "will emit an error. For example, if the type annotation for ``arg`` was " @@ -2265,47 +2265,47 @@ msgid "" "passed in must be the bottom type, :data:`Never`, and nothing else." msgstr "" -#: library/typing.rst:2573 +#: library/typing.rst:2572 msgid "At runtime, this throws an exception when called." msgstr "" -#: library/typing.rst:2576 +#: library/typing.rst:2575 msgid "" "`Unreachable Code and Exhaustiveness Checking `__ has more information about " "exhaustiveness checking with static typing." msgstr "" -#: library/typing.rst:2584 +#: library/typing.rst:2583 msgid "Ask a static type checker to reveal the inferred type of an expression." msgstr "" -#: library/typing.rst:2586 +#: library/typing.rst:2585 msgid "" "When a static type checker encounters a call to this function, it emits a " "diagnostic with the inferred type of the argument. For example::" msgstr "" -#: library/typing.rst:2592 +#: library/typing.rst:2591 msgid "" "This can be useful when you want to debug how your type checker handles a " "particular piece of code." msgstr "" -#: library/typing.rst:2595 +#: library/typing.rst:2594 msgid "" "At runtime, this function prints the runtime type of its argument to :data:" "`sys.stderr` and returns the argument unchanged (allowing the call to be " "used within an expression)::" msgstr "" -#: library/typing.rst:2602 +#: library/typing.rst:2601 msgid "" "Note that the runtime type may be different from (more or less specific " "than) the type statically inferred by a type checker." msgstr "" -#: library/typing.rst:2605 +#: library/typing.rst:2604 msgid "" "Most type checkers support ``reveal_type()`` anywhere, even if the name is " "not imported from ``typing``. Importing the name from ``typing``, however, " @@ -2313,13 +2313,13 @@ msgid "" "clearly." msgstr "" -#: library/typing.rst:2616 +#: library/typing.rst:2615 msgid "" "Decorator to mark an object as providing :func:`dataclass `-like behavior." msgstr "" -#: library/typing.rst:2619 +#: library/typing.rst:2618 msgid "" "``dataclass_transform`` may be used to decorate a class, metaclass, or a " "function that is itself a decorator. The presence of " @@ -2328,19 +2328,19 @@ msgid "" "to :func:`@dataclasses.dataclass `." msgstr "" -#: library/typing.rst:2626 +#: library/typing.rst:2625 msgid "Example usage with a decorator function:" msgstr "" -#: library/typing.rst:2640 +#: library/typing.rst:2639 msgid "On a base class::" msgstr "" -#: library/typing.rst:2649 +#: library/typing.rst:2648 msgid "On a metaclass::" msgstr "" -#: library/typing.rst:2660 +#: library/typing.rst:2659 msgid "" "The ``CustomerModel`` classes defined above will be treated by type checkers " "similarly to classes created with :func:`@dataclasses.dataclass `-decorated definitions for " "*func*." msgstr "" -#: library/typing.rst:2800 +#: library/typing.rst:2799 msgid "" "*func* is the function object for the implementation of the overloaded " "function. For example, given the definition of ``process`` in the " @@ -2558,32 +2558,32 @@ msgid "" "returns an empty sequence." msgstr "" -#: library/typing.rst:2807 +#: library/typing.rst:2806 msgid "" "``get_overloads()`` can be used for introspecting an overloaded function at " "runtime." msgstr "" -#: library/typing.rst:2815 +#: library/typing.rst:2814 msgid "Clear all registered overloads in the internal registry." msgstr "" -#: library/typing.rst:2817 +#: library/typing.rst:2816 msgid "This can be used to reclaim the memory used by the registry." msgstr "" -#: library/typing.rst:2824 +#: library/typing.rst:2823 msgid "Decorator to indicate final methods and final classes." msgstr "" -#: library/typing.rst:2826 +#: library/typing.rst:2825 msgid "" "Decorating a method with ``@final`` indicates to a type checker that the " "method cannot be overridden in a subclass. Decorating a class with " "``@final`` indicates that it cannot be subclassed." msgstr "" -#: library/typing.rst:2851 +#: library/typing.rst:2850 msgid "" "The decorator will now attempt to set a ``__final__`` attribute to ``True`` " "on the decorated object. Thus, a check like ``if getattr(obj, \"__final__\", " @@ -2593,11 +2593,11 @@ msgid "" "exception." msgstr "" -#: library/typing.rst:2862 +#: library/typing.rst:2861 msgid "Decorator to indicate that annotations are not type hints." msgstr "" -#: library/typing.rst:2864 +#: library/typing.rst:2863 msgid "" "This works as a class or function :term:`decorator`. With a class, it " "applies recursively to all methods and classes defined in that class (but " @@ -2605,38 +2605,38 @@ msgid "" "will ignore all annotations in a function or class with this decorator." msgstr "" -#: library/typing.rst:2870 +#: library/typing.rst:2869 msgid "``@no_type_check`` mutates the decorated object in place." msgstr "" -#: library/typing.rst:2874 +#: library/typing.rst:2873 msgid "Decorator to give another decorator the :func:`no_type_check` effect." msgstr "" -#: library/typing.rst:2876 +#: library/typing.rst:2875 msgid "" "This wraps the decorator with something that wraps the decorated function " "in :func:`no_type_check`." msgstr "" -#: library/typing.rst:2882 +#: library/typing.rst:2881 msgid "" "Decorator to indicate that a method in a subclass is intended to override a " "method or attribute in a superclass." msgstr "" -#: library/typing.rst:2885 +#: library/typing.rst:2884 msgid "" "Type checkers should emit an error if a method decorated with ``@override`` " "does not, in fact, override anything. This helps prevent bugs that may occur " "when a base class is changed without an equivalent change to a child class." msgstr "" -#: library/typing.rst:2907 +#: library/typing.rst:2906 msgid "There is no runtime checking of this property." msgstr "" -#: library/typing.rst:2909 +#: library/typing.rst:2908 msgid "" "The decorator will attempt to set an ``__override__`` attribute to ``True`` " "on the decorated object. Thus, a check like ``if getattr(obj, " @@ -2646,38 +2646,38 @@ msgid "" "without raising an exception." msgstr "" -#: library/typing.rst:2916 +#: library/typing.rst:2915 msgid "See :pep:`698` for more details." msgstr "" -#: library/typing.rst:2923 +#: library/typing.rst:2922 msgid "Decorator to mark a class or function as unavailable at runtime." msgstr "" -#: library/typing.rst:2925 +#: library/typing.rst:2924 msgid "" "This decorator is itself not available at runtime. It is mainly intended to " "mark classes that are defined in type stub files if an implementation " "returns an instance of a private class::" msgstr "" -#: library/typing.rst:2936 +#: library/typing.rst:2935 msgid "" "Note that returning instances of private classes is not recommended. It is " "usually preferable to make such classes public." msgstr "" -#: library/typing.rst:2940 +#: library/typing.rst:2939 msgid "Introspection helpers" msgstr "" -#: library/typing.rst:2944 +#: library/typing.rst:2943 msgid "" "Return a dictionary containing type hints for a function, method, module or " "class object." msgstr "" -#: library/typing.rst:2947 +#: library/typing.rst:2946 msgid "" "This is often the same as ``obj.__annotations__``. In addition, forward " "references encoded as string literals are handled by evaluating them in " @@ -2686,40 +2686,40 @@ msgid "" "__mro__`` in reverse order." msgstr "" -#: library/typing.rst:2953 +#: library/typing.rst:2952 msgid "" "The function recursively replaces all ``Annotated[T, ...]`` with ``T``, " "unless ``include_extras`` is set to ``True`` (see :class:`Annotated` for " "more information). For example:" msgstr "" -#: library/typing.rst:2970 +#: library/typing.rst:2969 msgid "" ":func:`get_type_hints` does not work with imported :ref:`type aliases ` that include forward references. Enabling postponed evaluation of " "annotations (:pep:`563`) may remove the need for most forward references." msgstr "" -#: library/typing.rst:2975 +#: library/typing.rst:2974 msgid "" "Added ``include_extras`` parameter as part of :pep:`593`. See the " "documentation on :data:`Annotated` for more information." msgstr "" -#: library/typing.rst:2979 +#: library/typing.rst:2978 msgid "" "Previously, ``Optional[t]`` was added for function and method annotations if " "a default value equal to ``None`` was set. Now the annotation is returned " "unchanged." msgstr "" -#: library/typing.rst:2986 +#: library/typing.rst:2985 msgid "" "Get the unsubscripted version of a type: for a typing object of the form " "``X[Y, Z, ...]`` return ``X``." msgstr "" -#: library/typing.rst:2989 +#: library/typing.rst:2988 msgid "" "If ``X`` is a typing-module alias for a builtin or :mod:`collections` class, " "it will be normalized to the original class. If ``X`` is an instance of :" @@ -2727,17 +2727,17 @@ msgid "" "class:`ParamSpec`. Return ``None`` for unsupported objects." msgstr "" -#: library/typing.rst:3018 +#: library/typing.rst:3017 msgid "Examples:" msgstr "" -#: library/typing.rst:3010 +#: library/typing.rst:3009 msgid "" "Get type arguments with all substitutions performed: for a typing object of " "the form ``X[Y, Z, ...]`` return ``(Y, Z, ...)``." msgstr "" -#: library/typing.rst:3013 +#: library/typing.rst:3012 msgid "" "If ``X`` is a union or :class:`Literal` contained in another generic type, " "the order of ``(Y, Z, ...)`` may be different from the order of the original " @@ -2745,40 +2745,40 @@ msgid "" "objects." msgstr "" -#: library/typing.rst:3030 +#: library/typing.rst:3029 msgid "Check if a type is a :class:`TypedDict`." msgstr "" -#: library/typing.rst:3051 +#: library/typing.rst:3050 msgid "" "Class used for internal typing representation of string forward references." msgstr "" -#: library/typing.rst:3053 +#: library/typing.rst:3052 msgid "" "For example, ``List[\"SomeClass\"]`` is implicitly transformed into " "``List[ForwardRef(\"SomeClass\")]``. ``ForwardRef`` should not be " "instantiated by a user, but may be used by introspection tools." msgstr "" -#: library/typing.rst:3058 +#: library/typing.rst:3057 msgid "" ":pep:`585` generic types such as ``list[\"SomeClass\"]`` will not be " "implicitly transformed into ``list[ForwardRef(\"SomeClass\")]`` and thus " "will not automatically resolve to ``list[SomeClass]``." msgstr "" -#: library/typing.rst:3065 +#: library/typing.rst:3064 msgid "Constant" msgstr "" -#: library/typing.rst:3069 +#: library/typing.rst:3068 msgid "" "A special constant that is assumed to be ``True`` by 3rd party static type " "checkers. It is ``False`` at runtime." msgstr "" -#: library/typing.rst:3080 +#: library/typing.rst:3079 msgid "" "The first type annotation must be enclosed in quotes, making it a \"forward " "reference\", to hide the ``expensive_mod`` reference from the interpreter " @@ -2786,7 +2786,7 @@ msgid "" "second annotation does not need to be enclosed in quotes." msgstr "" -#: library/typing.rst:3087 +#: library/typing.rst:3086 msgid "" "If ``from __future__ import annotations`` is used, annotations are not " "evaluated at function definition time. Instead, they are stored as strings " @@ -2794,11 +2794,11 @@ msgid "" "annotation (see :pep:`563`)." msgstr "" -#: library/typing.rst:3099 +#: library/typing.rst:3098 msgid "Deprecated aliases" msgstr "" -#: library/typing.rst:3101 +#: library/typing.rst:3100 msgid "" "This module defines several deprecated aliases to pre-existing standard " "library classes. These were originally included in the typing module in " @@ -2807,7 +2807,7 @@ msgid "" "existing classes were enhanced to support ``[]`` (see :pep:`585`)." msgstr "" -#: library/typing.rst:3108 +#: library/typing.rst:3107 msgid "" "The redundant types are deprecated as of Python 3.9. However, while the " "aliases may be removed at some point, removal of these aliases is not " @@ -2815,7 +2815,7 @@ msgid "" "the interpreter for these aliases." msgstr "" -#: library/typing.rst:3113 +#: library/typing.rst:3112 msgid "" "If at some point it is decided to remove these deprecated aliases, a " "deprecation warning will be issued by the interpreter for at least two " @@ -2823,188 +2823,188 @@ msgid "" "typing module without deprecation warnings until at least Python 3.14." msgstr "" -#: library/typing.rst:3118 +#: library/typing.rst:3117 msgid "" "Type checkers are encouraged to flag uses of the deprecated types if the " "program they are checking targets a minimum Python version of 3.9 or newer." msgstr "" -#: library/typing.rst:3124 +#: library/typing.rst:3123 msgid "Aliases to built-in types" msgstr "" -#: library/typing.rst:3128 +#: library/typing.rst:3127 msgid "Deprecated alias to :class:`dict`." msgstr "" -#: library/typing.rst:3130 +#: library/typing.rst:3129 msgid "" "Note that to annotate arguments, it is preferred to use an abstract " "collection type such as :class:`Mapping` rather than to use :class:`dict` " "or :class:`!typing.Dict`." msgstr "" -#: library/typing.rst:3376 +#: library/typing.rst:3372 msgid "This type can be used as follows::" msgstr "" -#: library/typing.rst:3139 +#: library/typing.rst:3138 msgid "" ":class:`builtins.dict ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3145 +#: library/typing.rst:3144 msgid "Deprecated alias to :class:`list`." msgstr "" -#: library/typing.rst:3147 +#: library/typing.rst:3146 msgid "" "Note that to annotate arguments, it is preferred to use an abstract " "collection type such as :class:`Sequence` or :class:`Iterable` rather than " "to use :class:`list` or :class:`!typing.List`." msgstr "" -#: library/typing.rst:3151 +#: library/typing.rst:3150 msgid "This type may be used as follows::" msgstr "" -#: library/typing.rst:3159 +#: library/typing.rst:3158 msgid "" ":class:`builtins.list ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3165 +#: library/typing.rst:3164 msgid "Deprecated alias to :class:`builtins.set `." msgstr "" -#: library/typing.rst:3167 +#: library/typing.rst:3166 msgid "" "Note that to annotate arguments, it is preferred to use an abstract " "collection type such as :class:`AbstractSet` rather than to use :class:`set` " "or :class:`!typing.Set`." msgstr "" -#: library/typing.rst:3171 +#: library/typing.rst:3170 msgid "" ":class:`builtins.set ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3177 +#: library/typing.rst:3176 msgid "Deprecated alias to :class:`builtins.frozenset `." msgstr "" -#: library/typing.rst:3179 +#: library/typing.rst:3178 msgid "" ":class:`builtins.frozenset ` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3186 +#: library/typing.rst:3185 msgid "Deprecated alias for :class:`tuple`." msgstr "" -#: library/typing.rst:3188 +#: library/typing.rst:3187 msgid "" ":class:`tuple` and ``Tuple`` are special-cased in the type system; see :ref:" "`annotating-tuples` for more details." msgstr "" -#: library/typing.rst:3191 +#: library/typing.rst:3190 msgid "" ":class:`builtins.tuple ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3197 +#: library/typing.rst:3196 msgid "Deprecated alias to :class:`type`." msgstr "" -#: library/typing.rst:3199 +#: library/typing.rst:3198 msgid "" "See :ref:`type-of-class-objects` for details on using :class:`type` or " "``typing.Type`` in type annotations." msgstr "" -#: library/typing.rst:3204 +#: library/typing.rst:3203 msgid "" ":class:`builtins.type ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3211 +#: library/typing.rst:3210 msgid "Aliases to types in :mod:`collections`" msgstr "" -#: library/typing.rst:3215 +#: library/typing.rst:3214 msgid "Deprecated alias to :class:`collections.defaultdict`." msgstr "" -#: library/typing.rst:3219 +#: library/typing.rst:3218 msgid "" ":class:`collections.defaultdict` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3225 +#: library/typing.rst:3224 msgid "Deprecated alias to :class:`collections.OrderedDict`." msgstr "" -#: library/typing.rst:3229 +#: library/typing.rst:3228 msgid "" ":class:`collections.OrderedDict` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3235 +#: library/typing.rst:3234 msgid "Deprecated alias to :class:`collections.ChainMap`." msgstr "" -#: library/typing.rst:3240 +#: library/typing.rst:3238 msgid "" ":class:`collections.ChainMap` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3246 +#: library/typing.rst:3244 msgid "Deprecated alias to :class:`collections.Counter`." msgstr "" -#: library/typing.rst:3251 +#: library/typing.rst:3248 msgid "" ":class:`collections.Counter` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3257 +#: library/typing.rst:3254 msgid "Deprecated alias to :class:`collections.deque`." msgstr "" -#: library/typing.rst:3262 +#: library/typing.rst:3258 msgid "" ":class:`collections.deque` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3269 +#: library/typing.rst:3265 msgid "Aliases to other concrete types" msgstr "" -#: library/typing.rst:3274 +#: library/typing.rst:3270 msgid "" "The ``typing.io`` namespace is deprecated and will be removed. These types " "should be directly imported from ``typing`` instead." msgstr "" -#: library/typing.rst:3278 +#: library/typing.rst:3274 msgid "" "Deprecated aliases corresponding to the return types from :func:`re.compile` " "and :func:`re.match`." msgstr "" -#: library/typing.rst:3281 +#: library/typing.rst:3277 msgid "" "These types (and the corresponding functions) are generic over :data:" "`AnyStr`. ``Pattern`` can be specialised as ``Pattern[str]`` or " @@ -3012,391 +3012,391 @@ msgid "" "``Match[bytes]``." msgstr "" -#: library/typing.rst:3289 +#: library/typing.rst:3285 msgid "" "The ``typing.re`` namespace is deprecated and will be removed. These types " "should be directly imported from ``typing`` instead." msgstr "" -#: library/typing.rst:3290 +#: library/typing.rst:3286 msgid "" "Classes ``Pattern`` and ``Match`` from :mod:`re` now support ``[]``. See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3296 +#: library/typing.rst:3292 msgid "Deprecated alias for :class:`str`." msgstr "" -#: library/typing.rst:3298 +#: library/typing.rst:3294 msgid "" "``Text`` is provided to supply a forward compatible path for Python 2 code: " "in Python 2, ``Text`` is an alias for ``unicode``." msgstr "" -#: library/typing.rst:3302 +#: library/typing.rst:3298 msgid "" "Use ``Text`` to indicate that a value must contain a unicode string in a " "manner that is compatible with both Python 2 and Python 3::" msgstr "" -#: library/typing.rst:3310 +#: library/typing.rst:3306 msgid "" "Python 2 is no longer supported, and most type checkers also no longer " "support type checking Python 2 code. Removal of the alias is not currently " "planned, but users are encouraged to use :class:`str` instead of ``Text``." msgstr "" -#: library/typing.rst:3320 +#: library/typing.rst:3316 msgid "Aliases to container ABCs in :mod:`collections.abc`" msgstr "" -#: library/typing.rst:3324 +#: library/typing.rst:3320 msgid "Deprecated alias to :class:`collections.abc.Set`." msgstr "" -#: library/typing.rst:3326 +#: library/typing.rst:3322 msgid "" ":class:`collections.abc.Set` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3332 +#: library/typing.rst:3328 msgid "" "This type represents the types :class:`bytes`, :class:`bytearray`, and :" "class:`memoryview` of byte sequences." msgstr "" -#: library/typing.rst:3336 +#: library/typing.rst:3332 msgid "" "Prefer :class:`collections.abc.Buffer`, or a union like ``bytes | bytearray " "| memoryview``." msgstr "" -#: library/typing.rst:3340 +#: library/typing.rst:3336 msgid "Deprecated alias to :class:`collections.abc.Collection`." msgstr "" -#: library/typing.rst:3344 +#: library/typing.rst:3340 msgid "" ":class:`collections.abc.Collection` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3350 +#: library/typing.rst:3346 msgid "Deprecated alias to :class:`collections.abc.Container`." msgstr "" -#: library/typing.rst:3352 +#: library/typing.rst:3348 msgid "" ":class:`collections.abc.Container` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3358 +#: library/typing.rst:3354 msgid "Deprecated alias to :class:`collections.abc.ItemsView`." msgstr "" -#: library/typing.rst:3360 +#: library/typing.rst:3356 msgid "" ":class:`collections.abc.ItemsView` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3366 +#: library/typing.rst:3362 msgid "Deprecated alias to :class:`collections.abc.KeysView`." msgstr "" -#: library/typing.rst:3368 +#: library/typing.rst:3364 msgid "" ":class:`collections.abc.KeysView` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3374 +#: library/typing.rst:3370 msgid "Deprecated alias to :class:`collections.abc.Mapping`." msgstr "" -#: library/typing.rst:3381 +#: library/typing.rst:3377 msgid "" ":class:`collections.abc.Mapping` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3387 +#: library/typing.rst:3383 msgid "Deprecated alias to :class:`collections.abc.MappingView`." msgstr "" -#: library/typing.rst:3389 +#: library/typing.rst:3385 msgid "" ":class:`collections.abc.MappingView` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3395 +#: library/typing.rst:3391 msgid "Deprecated alias to :class:`collections.abc.MutableMapping`." msgstr "" -#: library/typing.rst:3397 +#: library/typing.rst:3393 msgid "" ":class:`collections.abc.MutableMapping` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3404 +#: library/typing.rst:3400 msgid "Deprecated alias to :class:`collections.abc.MutableSequence`." msgstr "" -#: library/typing.rst:3406 +#: library/typing.rst:3402 msgid "" ":class:`collections.abc.MutableSequence` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3413 +#: library/typing.rst:3409 msgid "Deprecated alias to :class:`collections.abc.MutableSet`." msgstr "" -#: library/typing.rst:3415 +#: library/typing.rst:3411 msgid "" ":class:`collections.abc.MutableSet` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3421 +#: library/typing.rst:3417 msgid "Deprecated alias to :class:`collections.abc.Sequence`." msgstr "" -#: library/typing.rst:3423 +#: library/typing.rst:3419 msgid "" ":class:`collections.abc.Sequence` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3429 +#: library/typing.rst:3425 msgid "Deprecated alias to :class:`collections.abc.ValuesView`." msgstr "" -#: library/typing.rst:3431 +#: library/typing.rst:3427 msgid "" ":class:`collections.abc.ValuesView` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3438 +#: library/typing.rst:3434 msgid "Aliases to asynchronous ABCs in :mod:`collections.abc`" msgstr "" -#: library/typing.rst:3442 +#: library/typing.rst:3438 msgid "Deprecated alias to :class:`collections.abc.Coroutine`." msgstr "" -#: library/typing.rst:3444 +#: library/typing.rst:3440 msgid "" "The variance and order of type variables correspond to those of :class:" "`Generator`, for example::" msgstr "" -#: library/typing.rst:3455 +#: library/typing.rst:3451 msgid "" ":class:`collections.abc.Coroutine` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3461 +#: library/typing.rst:3457 msgid "Deprecated alias to :class:`collections.abc.AsyncGenerator`." msgstr "" -#: library/typing.rst:3463 +#: library/typing.rst:3459 msgid "" "An async generator can be annotated by the generic type " "``AsyncGenerator[YieldType, SendType]``. For example::" msgstr "" -#: library/typing.rst:3472 +#: library/typing.rst:3468 msgid "" "Unlike normal generators, async generators cannot return a value, so there " "is no ``ReturnType`` type parameter. As with :class:`Generator`, the " "``SendType`` behaves contravariantly." msgstr "" -#: library/typing.rst:3476 +#: library/typing.rst:3472 msgid "" "If your generator will only yield values, set the ``SendType`` to ``None``::" msgstr "" -#: library/typing.rst:3484 +#: library/typing.rst:3480 msgid "" "Alternatively, annotate your generator as having a return type of either " "``AsyncIterable[YieldType]`` or ``AsyncIterator[YieldType]``::" msgstr "" -#: library/typing.rst:3494 +#: library/typing.rst:3490 msgid "" ":class:`collections.abc.AsyncGenerator` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3501 +#: library/typing.rst:3497 msgid "Deprecated alias to :class:`collections.abc.AsyncIterable`." msgstr "" -#: library/typing.rst:3505 +#: library/typing.rst:3501 msgid "" ":class:`collections.abc.AsyncIterable` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3511 +#: library/typing.rst:3507 msgid "Deprecated alias to :class:`collections.abc.AsyncIterator`." msgstr "" -#: library/typing.rst:3515 +#: library/typing.rst:3511 msgid "" ":class:`collections.abc.AsyncIterator` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3521 +#: library/typing.rst:3517 msgid "Deprecated alias to :class:`collections.abc.Awaitable`." msgstr "" -#: library/typing.rst:3525 +#: library/typing.rst:3521 msgid "" ":class:`collections.abc.Awaitable` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3532 +#: library/typing.rst:3528 msgid "Aliases to other ABCs in :mod:`collections.abc`" msgstr "" -#: library/typing.rst:3536 +#: library/typing.rst:3532 msgid "Deprecated alias to :class:`collections.abc.Iterable`." msgstr "" -#: library/typing.rst:3538 +#: library/typing.rst:3534 msgid "" ":class:`collections.abc.Iterable` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3544 +#: library/typing.rst:3540 msgid "Deprecated alias to :class:`collections.abc.Iterator`." msgstr "" -#: library/typing.rst:3546 +#: library/typing.rst:3542 msgid "" ":class:`collections.abc.Iterator` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3552 +#: library/typing.rst:3548 msgid "Deprecated alias to :class:`collections.abc.Callable`." msgstr "" -#: library/typing.rst:3554 +#: library/typing.rst:3550 msgid "" "See :ref:`annotating-callables` for details on how to use :class:" "`collections.abc.Callable` and ``typing.Callable`` in type annotations." msgstr "" -#: library/typing.rst:3557 +#: library/typing.rst:3553 msgid "" ":class:`collections.abc.Callable` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3567 +#: library/typing.rst:3563 msgid "Deprecated alias to :class:`collections.abc.Generator`." msgstr "" -#: library/typing.rst:3569 +#: library/typing.rst:3565 msgid "" "A generator can be annotated by the generic type ``Generator[YieldType, " "SendType, ReturnType]``. For example::" msgstr "" -#: library/typing.rst:3578 +#: library/typing.rst:3574 msgid "" "Note that unlike many other generics in the typing module, the ``SendType`` " "of :class:`Generator` behaves contravariantly, not covariantly or " "invariantly." msgstr "" -#: library/typing.rst:3582 +#: library/typing.rst:3578 msgid "" "If your generator will only yield values, set the ``SendType`` and " "``ReturnType`` to ``None``::" msgstr "" -#: library/typing.rst:3590 +#: library/typing.rst:3586 msgid "" "Alternatively, annotate your generator as having a return type of either " "``Iterable[YieldType]`` or ``Iterator[YieldType]``::" msgstr "" -#: library/typing.rst:3598 +#: library/typing.rst:3594 msgid "" ":class:`collections.abc.Generator` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3604 +#: library/typing.rst:3600 msgid "Deprecated alias to :class:`collections.abc.Hashable`." msgstr "" -#: library/typing.rst:3606 +#: library/typing.rst:3602 msgid "Use :class:`collections.abc.Hashable` directly instead." msgstr "" -#: library/typing.rst:3611 +#: library/typing.rst:3607 msgid "Deprecated alias to :class:`collections.abc.Reversible`." msgstr "" -#: library/typing.rst:3613 +#: library/typing.rst:3609 msgid "" ":class:`collections.abc.Reversible` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3619 +#: library/typing.rst:3615 msgid "Deprecated alias to :class:`collections.abc.Sized`." msgstr "" -#: library/typing.rst:3621 +#: library/typing.rst:3617 msgid "Use :class:`collections.abc.Sized` directly instead." msgstr "" -#: library/typing.rst:3627 +#: library/typing.rst:3623 msgid "Aliases to :mod:`contextlib` ABCs" msgstr "" -#: library/typing.rst:3631 +#: library/typing.rst:3627 msgid "Deprecated alias to :class:`contextlib.AbstractContextManager`." msgstr "" -#: library/typing.rst:3636 +#: library/typing.rst:3631 msgid "" ":class:`contextlib.AbstractContextManager` now supports subscripting " "(``[]``). See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3643 +#: library/typing.rst:3638 msgid "Deprecated alias to :class:`contextlib.AbstractAsyncContextManager`." msgstr "" -#: library/typing.rst:3648 +#: library/typing.rst:3642 msgid "" ":class:`contextlib.AbstractAsyncContextManager` now supports subscripting " "(``[]``). See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3654 +#: library/typing.rst:3648 msgid "Deprecation Timeline of Major Features" msgstr "" -#: library/typing.rst:3656 +#: library/typing.rst:3650 msgid "" "Certain features in ``typing`` are deprecated and may be removed in a future " "version of Python. The following table summarizes major deprecations for " @@ -3404,98 +3404,98 @@ msgid "" "listed." msgstr "" -#: library/typing.rst:3663 +#: library/typing.rst:3657 msgid "Feature" msgstr "" -#: library/typing.rst:3664 +#: library/typing.rst:3658 msgid "Deprecated in" msgstr "" -#: library/typing.rst:3665 +#: library/typing.rst:3659 msgid "Projected removal" msgstr "" -#: library/typing.rst:3666 +#: library/typing.rst:3660 msgid "PEP/issue" msgstr "" -#: library/typing.rst:3667 +#: library/typing.rst:3661 msgid "``typing.io`` and ``typing.re`` submodules" msgstr "" -#: library/typing.rst:3668 +#: library/typing.rst:3662 msgid "3.8" msgstr "" -#: library/typing.rst:3669 +#: library/typing.rst:3663 msgid "3.13" msgstr "" -#: library/typing.rst:3670 +#: library/typing.rst:3664 msgid ":issue:`38291`" msgstr "" -#: library/typing.rst:3671 +#: library/typing.rst:3665 msgid "``typing`` versions of standard collections" msgstr "" -#: library/typing.rst:3676 +#: library/typing.rst:3670 msgid "3.9" msgstr "" -#: library/typing.rst:3673 +#: library/typing.rst:3667 msgid "Undecided (see :ref:`deprecated-aliases` for more information)" msgstr "" -#: library/typing.rst:3674 +#: library/typing.rst:3668 msgid ":pep:`585`" msgstr "" -#: library/typing.rst:3675 +#: library/typing.rst:3669 msgid ":class:`typing.ByteString`" msgstr "" -#: library/typing.rst:3677 +#: library/typing.rst:3671 msgid "3.14" msgstr "" -#: library/typing.rst:3678 +#: library/typing.rst:3672 msgid ":gh:`91896`" msgstr "" -#: library/typing.rst:3679 +#: library/typing.rst:3673 msgid ":data:`typing.Text`" msgstr "" -#: library/typing.rst:3680 +#: library/typing.rst:3674 msgid "3.11" msgstr "" -#: library/typing.rst:3685 library/typing.rst:3689 +#: library/typing.rst:3679 library/typing.rst:3683 msgid "Undecided" msgstr "" -#: library/typing.rst:3682 +#: library/typing.rst:3676 msgid ":gh:`92332`" msgstr "" -#: library/typing.rst:3683 +#: library/typing.rst:3677 msgid ":class:`typing.Hashable` and :class:`typing.Sized`" msgstr "" -#: library/typing.rst:3688 +#: library/typing.rst:3682 msgid "3.12" msgstr "" -#: library/typing.rst:3686 +#: library/typing.rst:3680 msgid ":gh:`94309`" msgstr "" -#: library/typing.rst:3687 +#: library/typing.rst:3681 msgid ":data:`typing.TypeAlias`" msgstr "" -#: library/typing.rst:3690 +#: library/typing.rst:3684 msgid ":pep:`695`" msgstr "" diff --git a/library/unittest.mock.po b/library/unittest.mock.po index 47427e40c..bfea3370d 100644 --- a/library/unittest.mock.po +++ b/library/unittest.mock.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2375,3 +2375,87 @@ msgid "" "won't be considered in the sealing chain. This allows one to prevent seal " "from fixing part of the mock object. ::" msgstr "" + +#: library/unittest.mock.rst:2788 +msgid "" +"Order of precedence of :attr:`side_effect`, :attr:`return_value` and *wraps*" +msgstr "" + +#: library/unittest.mock.rst:2790 +msgid "The order of their precedence is:" +msgstr "" + +#: library/unittest.mock.rst:2792 +msgid ":attr:`~Mock.side_effect`" +msgstr "" + +#: library/unittest.mock.rst:2793 +msgid ":attr:`~Mock.return_value`" +msgstr "" + +#: library/unittest.mock.rst:2794 +msgid "*wraps*" +msgstr "" + +#: library/unittest.mock.rst:2796 +msgid "" +"If all three are set, mock will return the value from :attr:`~Mock." +"side_effect`, ignoring :attr:`~Mock.return_value` and the wrapped object " +"altogether. If any two are set, the one with the higher precedence will " +"return the value. Regardless of the order of which was set first, the order " +"of precedence remains unchanged." +msgstr "" + +#: library/unittest.mock.rst:2814 +msgid "" +"As ``None`` is the default value of :attr:`~Mock.side_effect`, if you " +"reassign its value back to ``None``, the order of precedence will be checked " +"between :attr:`~Mock.return_value` and the wrapped object, ignoring :attr:" +"`~Mock.side_effect`." +msgstr "" + +#: library/unittest.mock.rst:2823 +msgid "" +"If the value being returned by :attr:`~Mock.side_effect` is :data:`DEFAULT`, " +"it is ignored and the order of precedence moves to the successor to obtain " +"the value to return." +msgstr "" + +#: library/unittest.mock.rst:2832 +msgid "" +"When :class:`Mock` wraps an object, the default value of :attr:`~Mock." +"return_value` will be :data:`DEFAULT`." +msgstr "" + +#: library/unittest.mock.rst:2841 +msgid "" +"The order of precedence will ignore this value and it will move to the last " +"successor which is the wrapped object." +msgstr "" + +#: library/unittest.mock.rst:2844 +msgid "" +"As the real call is being made to the wrapped object, creating an instance " +"of this mock will return the real instance of the class. The positional " +"arguments, if any, required by the wrapped object must be passed." +msgstr "" + +#: library/unittest.mock.rst:2862 +msgid "" +"But if you assign ``None`` to it, this will not be ignored as it is an " +"explicit assignment. So, the order of precedence will not move to the " +"wrapped object." +msgstr "" + +#: library/unittest.mock.rst:2870 +msgid "" +"Even if you set all three at once when initializing the mock, the order of " +"precedence remains the same:" +msgstr "" + +#: library/unittest.mock.rst:2887 +msgid "" +"If :attr:`~Mock.side_effect` is exhausted, the order of precedence will not " +"cause a value to be obtained from the successors. Instead, ``StopIteration`` " +"exception is raised." +msgstr "" diff --git a/library/urllib.request.po b/library/urllib.request.po index 5b2d393fe..cfb3bfb0e 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-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -182,33 +182,33 @@ msgid "" "HAS_SNI` is true)." msgstr "" -#: library/urllib.request.rst:112 +#: library/urllib.request.rst:111 msgid "*data* can be an iterable object." msgstr "" -#: library/urllib.request.rst:115 +#: library/urllib.request.rst:113 msgid "*cadefault* was added." msgstr "" -#: library/urllib.request.rst:118 +#: library/urllib.request.rst:116 msgid "*context* was added." msgstr "" -#: library/urllib.request.rst:121 +#: library/urllib.request.rst:119 msgid "" "HTTPS connection now send an ALPN extension with protocol indicator " "``http/1.1`` when no *context* is given. Custom *context* should set ALPN " "protocols with :meth:`~ssl.SSLContext.set_alpn_protocols`." msgstr "" -#: library/urllib.request.rst:128 +#: library/urllib.request.rst:126 msgid "" "*cafile*, *capath* and *cadefault* are deprecated in favor of *context*. " "Please use :meth:`ssl.SSLContext.load_cert_chain` instead, or let :func:`ssl." "create_default_context` select the system's trusted CA certificates for you." msgstr "" -#: library/urllib.request.rst:136 +#: library/urllib.request.rst:134 msgid "" "Install an :class:`OpenerDirector` instance as the default global opener. " "Installing an opener is only necessary if you want urlopen to use that " @@ -217,7 +217,7 @@ msgid "" "`OpenerDirector`, and any class with the appropriate interface will work." msgstr "" -#: library/urllib.request.rst:146 +#: library/urllib.request.rst:144 msgid "" "Return an :class:`OpenerDirector` instance, which chains the handlers in the " "order given. *handler*\\s can be either instances of :class:`BaseHandler`, " @@ -231,19 +231,19 @@ msgid "" "`HTTPErrorProcessor`." msgstr "" -#: library/urllib.request.rst:156 +#: library/urllib.request.rst:154 msgid "" "If the Python installation has SSL support (i.e., if the :mod:`ssl` module " "can be imported), :class:`HTTPSHandler` will also be added." msgstr "" -#: library/urllib.request.rst:159 +#: library/urllib.request.rst:157 msgid "" "A :class:`BaseHandler` subclass may also change its :attr:`handler_order` " "attribute to modify its position in the handlers list." msgstr "" -#: library/urllib.request.rst:165 +#: 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. " @@ -251,14 +251,14 @@ msgid "" "quote` function." msgstr "" -#: library/urllib.request.rst:172 +#: library/urllib.request.rst:170 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*." msgstr "" -#: library/urllib.request.rst:178 +#: library/urllib.request.rst:176 msgid "" "This helper function returns a dictionary of scheme to proxy server URL " "mappings. It scans the environment for variables named ``_proxy``, " @@ -268,7 +268,7 @@ msgid "" "uppercase environment variables exist (and disagree), lowercase is preferred." msgstr "" -#: library/urllib.request.rst:188 +#: library/urllib.request.rst:186 msgid "" "If the environment variable ``REQUEST_METHOD`` is set, which usually " "indicates your script is running in a CGI environment, the environment " @@ -279,19 +279,19 @@ msgid "" "(or at least the ``_proxy`` suffix)." msgstr "" -#: library/urllib.request.rst:197 +#: library/urllib.request.rst:195 msgid "The following classes are provided:" msgstr "" -#: library/urllib.request.rst:201 +#: library/urllib.request.rst:199 msgid "This class is an abstraction of a URL request." msgstr "" -#: library/urllib.request.rst:203 +#: library/urllib.request.rst:201 msgid "*url* should be a string containing a valid, properly encoded URL." msgstr "" -#: library/urllib.request.rst:205 +#: library/urllib.request.rst:203 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 " @@ -304,7 +304,7 @@ msgid "" "iterables." msgstr "" -#: library/urllib.request.rst:215 +#: library/urllib.request.rst:213 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." @@ -313,7 +313,7 @@ msgid "" "being used as the *data* parameter." msgstr "" -#: library/urllib.request.rst:221 +#: library/urllib.request.rst:219 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 " @@ -326,7 +326,7 @@ msgid "" "case." msgstr "" -#: library/urllib.request.rst:232 +#: library/urllib.request.rst:230 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 " @@ -334,13 +334,13 @@ msgid "" "default." msgstr "" -#: library/urllib.request.rst:237 +#: library/urllib.request.rst:235 msgid "" "The next two arguments are only of interest for correct handling of third-" "party HTTP cookies:" msgstr "" -#: library/urllib.request.rst:240 +#: library/urllib.request.rst:238 msgid "" "*origin_req_host* should be the request-host of the origin transaction, as " "defined by :rfc:`2965`. It defaults to ``http.cookiejar." @@ -350,7 +350,7 @@ msgid "" "for the page containing the image." msgstr "" -#: library/urllib.request.rst:248 +#: library/urllib.request.rst:246 msgid "" "*unverifiable* should indicate whether the request is unverifiable, as " "defined by :rfc:`2965`. It defaults to ``False``. An unverifiable request " @@ -359,7 +359,7 @@ msgid "" "option to approve the automatic fetching of the image, this should be true." msgstr "" -#: library/urllib.request.rst:255 +#: library/urllib.request.rst:253 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:" @@ -369,7 +369,7 @@ msgid "" "attribute in the class itself." msgstr "" -#: library/urllib.request.rst:263 +#: library/urllib.request.rst:261 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 " @@ -379,49 +379,49 @@ msgid "" "library." msgstr "" -#: library/urllib.request.rst:270 +#: library/urllib.request.rst:268 msgid ":attr:`Request.method` argument is added to the Request class." msgstr "" -#: library/urllib.request.rst:273 +#: library/urllib.request.rst:271 msgid "Default :attr:`Request.method` may be indicated at the class level." msgstr "" -#: library/urllib.request.rst:276 +#: library/urllib.request.rst:274 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:283 +#: library/urllib.request.rst:281 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:289 +#: library/urllib.request.rst:287 msgid "" "This is the base class for all registered handlers --- and handles only the " "simple mechanics of registration." msgstr "" -#: library/urllib.request.rst:295 +#: library/urllib.request.rst:293 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:301 +#: library/urllib.request.rst:299 msgid "A class to handle redirections." msgstr "" -#: library/urllib.request.rst:306 +#: library/urllib.request.rst:304 msgid "A class to handle HTTP Cookies." msgstr "" -#: library/urllib.request.rst:311 +#: library/urllib.request.rst:309 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 " @@ -432,11 +432,11 @@ msgid "" "Configuration Framework." msgstr "" -#: library/urllib.request.rst:319 +#: library/urllib.request.rst:317 msgid "To disable autodetected proxy pass an empty dictionary." msgstr "" -#: library/urllib.request.rst:321 +#: library/urllib.request.rst:319 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 " @@ -444,24 +444,24 @@ msgid "" "``cern.ch,ncsa.uiuc.edu,some.host:8080``." msgstr "" -#: library/urllib.request.rst:328 +#: library/urllib.request.rst:326 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:334 +#: library/urllib.request.rst:332 msgid "Keep a database of ``(realm, uri) -> (user, password)`` mappings." msgstr "" -#: library/urllib.request.rst:339 +#: library/urllib.request.rst:337 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:346 +#: library/urllib.request.rst:344 msgid "" "A variant of :class:`HTTPPasswordMgrWithDefaultRealm` that also has a " "database of ``uri -> is_authenticated`` mappings. Can be used by a " @@ -469,7 +469,7 @@ msgid "" "immediately instead of waiting for a ``401`` response first." msgstr "" -#: library/urllib.request.rst:356 +#: library/urllib.request.rst:354 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 " @@ -488,11 +488,11 @@ msgid "" "will automatically include the authentication credentials." msgstr "" -#: library/urllib.request.rst:373 +#: library/urllib.request.rst:371 msgid "Added ``is_authenticated`` support." msgstr "" -#: library/urllib.request.rst:379 +#: library/urllib.request.rst:377 msgid "" "Handle authentication with the remote host. *password_mgr*, if given, should " "be something that is compatible with :class:`HTTPPasswordMgr`; refer to " @@ -501,7 +501,7 @@ msgid "" "presented with a wrong Authentication scheme." msgstr "" -#: library/urllib.request.rst:422 +#: library/urllib.request.rst:420 msgid "" "Handle authentication with the proxy. *password_mgr*, if given, should be " "something that is compatible with :class:`HTTPPasswordMgr`; refer to " @@ -509,7 +509,7 @@ msgid "" "be supported." msgstr "" -#: library/urllib.request.rst:396 +#: library/urllib.request.rst:394 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 " @@ -517,7 +517,7 @@ msgid "" "`http-password-mgr` for information on the interface that must be supported." msgstr "" -#: library/urllib.request.rst:405 +#: library/urllib.request.rst:403 msgid "" "Handle authentication with the remote host. *password_mgr*, if given, should " "be something that is compatible with :class:`HTTPPasswordMgr`; refer to " @@ -530,108 +530,108 @@ msgid "" "Digest or Basic." msgstr "" -#: library/urllib.request.rst:415 +#: library/urllib.request.rst:413 msgid "Raise :exc:`ValueError` on unsupported Authentication Scheme." msgstr "" -#: library/urllib.request.rst:430 +#: library/urllib.request.rst:428 msgid "A class to handle opening of HTTP URLs." msgstr "" -#: library/urllib.request.rst:435 +#: library/urllib.request.rst:433 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:438 +#: library/urllib.request.rst:436 msgid "*context* and *check_hostname* were added." msgstr "" -#: library/urllib.request.rst:444 +#: library/urllib.request.rst:442 msgid "Open local files." msgstr "" -#: library/urllib.request.rst:448 +#: library/urllib.request.rst:446 msgid "Open data URLs." msgstr "" -#: library/urllib.request.rst:454 +#: library/urllib.request.rst:452 msgid "Open FTP URLs." msgstr "" -#: library/urllib.request.rst:459 +#: library/urllib.request.rst:457 msgid "" "Open FTP URLs, keeping a cache of open FTP connections to minimize delays." msgstr "" -#: library/urllib.request.rst:464 +#: library/urllib.request.rst:462 msgid "A catch-all class to handle unknown URLs." msgstr "" -#: library/urllib.request.rst:1175 +#: library/urllib.request.rst:1173 msgid "Process HTTP error responses." msgstr "" -#: library/urllib.request.rst:475 +#: library/urllib.request.rst:473 msgid "Request Objects" msgstr "" -#: library/urllib.request.rst:477 +#: library/urllib.request.rst:475 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:484 +#: library/urllib.request.rst:482 msgid "The original URL passed to the constructor." msgstr "" -#: library/urllib.request.rst:488 +#: library/urllib.request.rst:486 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:494 +#: library/urllib.request.rst:492 msgid "The URI scheme." msgstr "" -#: library/urllib.request.rst:498 +#: library/urllib.request.rst:496 msgid "" "The URI authority, typically a host, but may also contain a port separated " "by a colon." msgstr "" -#: library/urllib.request.rst:503 +#: library/urllib.request.rst:501 msgid "The original host for the request, without port." msgstr "" -#: library/urllib.request.rst:507 +#: library/urllib.request.rst:505 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:512 +#: library/urllib.request.rst:510 msgid "The entity body for the request, or ``None`` if not specified." msgstr "" -#: library/urllib.request.rst:514 +#: library/urllib.request.rst:512 msgid "" "Changing value of :attr:`Request.data` now deletes \"Content-Length\" header " "if it was previously set or calculated." msgstr "" -#: library/urllib.request.rst:520 +#: library/urllib.request.rst:518 msgid "" "boolean, indicates whether the request is unverifiable as defined by :rfc:" "`2965`." msgstr "" -#: library/urllib.request.rst:525 +#: library/urllib.request.rst:523 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 " @@ -642,13 +642,13 @@ msgid "" "argument." msgstr "" -#: library/urllib.request.rst:535 +#: library/urllib.request.rst:533 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:542 +#: library/urllib.request.rst:540 msgid "" "Return a string indicating the HTTP request method. If :attr:`Request." "method` is not ``None``, return its value, otherwise return ``'GET'`` if :" @@ -656,11 +656,11 @@ msgid "" "meaningful for HTTP requests." msgstr "" -#: library/urllib.request.rst:547 +#: library/urllib.request.rst:545 msgid "get_method now looks at the value of :attr:`Request.method`." msgstr "" -#: library/urllib.request.rst:553 +#: library/urllib.request.rst:551 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 " @@ -672,64 +672,64 @@ msgid "" "headers added using this method are also added to redirected requests." msgstr "" -#: library/urllib.request.rst:565 +#: library/urllib.request.rst:563 msgid "Add a header that will not be added to a redirected request." msgstr "" -#: library/urllib.request.rst:570 +#: library/urllib.request.rst:568 msgid "" "Return whether the instance has the named header (checks both regular and " "unredirected)." msgstr "" -#: library/urllib.request.rst:576 +#: library/urllib.request.rst:574 msgid "" "Remove named header from the request instance (both from regular and " "unredirected headers)." msgstr "" -#: library/urllib.request.rst:584 +#: library/urllib.request.rst:582 msgid "Return the URL given in the constructor." msgstr "" -#: library/urllib.request.rst:588 +#: library/urllib.request.rst:586 msgid "Returns :attr:`Request.full_url`" msgstr "" -#: library/urllib.request.rst:593 +#: library/urllib.request.rst:591 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:600 +#: library/urllib.request.rst:598 msgid "" "Return the value of the given header. If the header is not present, return " "the default value." msgstr "" -#: library/urllib.request.rst:606 +#: library/urllib.request.rst:604 msgid "" "Return a list of tuples (header_name, header_value) of the Request headers." msgstr "" -#: library/urllib.request.rst:608 +#: library/urllib.request.rst:606 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:617 +#: library/urllib.request.rst:615 msgid "OpenerDirector Objects" msgstr "" -#: library/urllib.request.rst:619 +#: library/urllib.request.rst:617 msgid ":class:`OpenerDirector` instances have the following methods:" msgstr "" -#: library/urllib.request.rst:624 +#: library/urllib.request.rst:622 msgid "" "*handler* should be an instance of :class:`BaseHandler`. The following " "methods are searched, and added to the possible chains (note that HTTP " @@ -740,53 +740,53 @@ msgid "" "`http_error_404` would handle HTTP 404 errors." msgstr "" -#: library/urllib.request.rst:632 +#: library/urllib.request.rst:630 msgid "" ":meth:`!_open` --- signal that the handler knows how to open " "*protocol* URLs." msgstr "" -#: library/urllib.request.rst:635 +#: library/urllib.request.rst:633 msgid "See |protocol_open|_ for more information." msgstr "" -#: library/urllib.request.rst:637 +#: library/urllib.request.rst:635 msgid "" ":meth:`!http_error_\\` --- signal that the handler knows how to " "handle HTTP errors with HTTP error code *type*." msgstr "" -#: library/urllib.request.rst:640 +#: library/urllib.request.rst:638 msgid "See |http_error_nnn|_ for more information." msgstr "" -#: library/urllib.request.rst:642 +#: library/urllib.request.rst:640 msgid "" ":meth:`!_error` --- signal that the handler knows how to handle " "errors from (non-\\ ``http``) *protocol*." msgstr "" -#: library/urllib.request.rst:645 +#: library/urllib.request.rst:643 msgid "" ":meth:`!_request` --- signal that the handler knows how to pre-" "process *protocol* requests." msgstr "" -#: library/urllib.request.rst:648 +#: library/urllib.request.rst:646 msgid "See |protocol_request|_ for more information." msgstr "" -#: library/urllib.request.rst:650 +#: library/urllib.request.rst:648 msgid "" ":meth:`!_response` --- signal that the handler knows how to post-" "process *protocol* responses." msgstr "" -#: library/urllib.request.rst:653 +#: library/urllib.request.rst:651 msgid "See |protocol_response|_ for more information." msgstr "" -#: library/urllib.request.rst:662 +#: library/urllib.request.rst:660 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 " @@ -798,7 +798,7 @@ msgid "" "HTTP, HTTPS and FTP connections." msgstr "" -#: library/urllib.request.rst:674 +#: library/urllib.request.rst:672 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 " @@ -807,28 +807,28 @@ msgid "" "http_error_\\` methods of the handler classes." msgstr "" -#: library/urllib.request.rst:680 +#: library/urllib.request.rst:678 msgid "" "Return values and exceptions raised are the same as those of :func:`urlopen`." msgstr "" -#: library/urllib.request.rst:682 +#: library/urllib.request.rst:680 msgid "OpenerDirector objects open URLs in three stages:" msgstr "" -#: library/urllib.request.rst:684 +#: library/urllib.request.rst:682 msgid "" "The order in which these methods are called within each stage is determined " "by sorting the handler instances." msgstr "" -#: library/urllib.request.rst:687 +#: library/urllib.request.rst:685 msgid "" "Every handler with a method named like :meth:`!_request` has that " "method called to pre-process the request." msgstr "" -#: library/urllib.request.rst:690 +#: library/urllib.request.rst:688 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-\\ :" @@ -836,7 +836,7 @@ msgid "" "`~urllib.error.URLError`). Exceptions are allowed to propagate." msgstr "" -#: library/urllib.request.rst:695 +#: library/urllib.request.rst:693 msgid "" "In fact, the above algorithm is first tried for methods named :meth:" "`~BaseHandler.default_open`. If all such methods return :const:`None`, the " @@ -845,64 +845,64 @@ msgid "" "named :meth:`~BaseHandler.unknown_open`." msgstr "" -#: library/urllib.request.rst:701 +#: library/urllib.request.rst:699 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:705 +#: library/urllib.request.rst:703 msgid "" "Every handler with a method named like :meth:`!_response` has that " "method called to post-process the response." msgstr "" -#: library/urllib.request.rst:712 +#: library/urllib.request.rst:710 msgid "BaseHandler Objects" msgstr "" -#: library/urllib.request.rst:714 +#: library/urllib.request.rst:712 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:721 +#: library/urllib.request.rst:719 msgid "Add a director as parent." msgstr "" -#: library/urllib.request.rst:726 +#: library/urllib.request.rst:724 msgid "Remove any parents." msgstr "" -#: library/urllib.request.rst:728 +#: library/urllib.request.rst:726 msgid "" "The following attribute and methods should only be used by classes derived " "from :class:`BaseHandler`." msgstr "" -#: library/urllib.request.rst:733 +#: library/urllib.request.rst:731 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:740 +#: library/urllib.request.rst:738 msgid "" "A valid :class:`OpenerDirector`, which can be used to open using a different " "protocol, or handle errors." msgstr "" -#: library/urllib.request.rst:746 +#: library/urllib.request.rst:744 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:749 +#: library/urllib.request.rst:747 msgid "" "This method, if implemented, will be called by the parent :class:" "`OpenerDirector`. It should return a file-like object as described in the " @@ -912,38 +912,38 @@ msgid "" "`MemoryError` should not be mapped to :exc:`~urllib.error.URLError`)." msgstr "" -#: library/urllib.request.rst:756 +#: library/urllib.request.rst:754 msgid "This method will be called before any protocol-specific open method." msgstr "" -#: library/urllib.request.rst:763 +#: library/urllib.request.rst:761 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:766 +#: library/urllib.request.rst:764 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:772 +#: library/urllib.request.rst:770 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:776 +#: library/urllib.request.rst:774 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:783 +#: library/urllib.request.rst:781 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 " @@ -952,7 +952,7 @@ msgid "" "other circumstances." msgstr "" -#: library/urllib.request.rst:788 +#: library/urllib.request.rst:786 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, " @@ -960,49 +960,49 @@ msgid "" "mapping object with the headers of the error." msgstr "" -#: library/urllib.request.rst:793 +#: library/urllib.request.rst:791 msgid "" "Return values and exceptions raised should be the same as those of :func:" "`urlopen`." msgstr "" -#: library/urllib.request.rst:800 +#: library/urllib.request.rst:798 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:804 +#: library/urllib.request.rst:802 msgid "Subclasses should override this method to handle specific HTTP errors." msgstr "" -#: library/urllib.request.rst:806 +#: library/urllib.request.rst:804 msgid "" "Arguments, return values and exceptions raised should be the same as for :" "meth:`~BaseHandler.http_error_default`." msgstr "" -#: library/urllib.request.rst:814 +#: library/urllib.request.rst:812 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:817 +#: library/urllib.request.rst:815 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:826 +#: library/urllib.request.rst:824 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:829 +#: 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. *response* will " @@ -1011,25 +1011,25 @@ msgid "" "return value of :func:`urlopen`." msgstr "" -#: library/urllib.request.rst:839 +#: library/urllib.request.rst:837 msgid "HTTPRedirectHandler Objects" msgstr "" -#: library/urllib.request.rst:843 +#: library/urllib.request.rst:841 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:847 +#: library/urllib.request.rst:845 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:854 +#: library/urllib.request.rst:852 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\\*` " @@ -1040,7 +1040,7 @@ msgid "" "URL, or return ``None`` if you can't but another handler might." msgstr "" -#: library/urllib.request.rst:864 +#: library/urllib.request.rst:862 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 " @@ -1049,54 +1049,54 @@ msgid "" "POST to a ``GET``, and the default implementation reproduces this behavior." msgstr "" -#: library/urllib.request.rst:873 +#: library/urllib.request.rst:871 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:879 +#: library/urllib.request.rst:877 msgid "" "The same as :meth:`http_error_301`, but called for the 'found' response." msgstr "" -#: library/urllib.request.rst:884 +#: library/urllib.request.rst:882 msgid "" "The same as :meth:`http_error_301`, but called for the 'see other' response." msgstr "" -#: library/urllib.request.rst:889 +#: library/urllib.request.rst:887 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:896 +#: library/urllib.request.rst:894 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:906 +#: library/urllib.request.rst:904 msgid "HTTPCookieProcessor Objects" msgstr "" -#: library/urllib.request.rst:908 +#: library/urllib.request.rst:906 msgid ":class:`HTTPCookieProcessor` instances have one attribute:" msgstr "" -#: library/urllib.request.rst:912 +#: library/urllib.request.rst:910 msgid "The :class:`http.cookiejar.CookieJar` in which cookies are stored." msgstr "" -#: library/urllib.request.rst:918 +#: library/urllib.request.rst:916 msgid "ProxyHandler Objects" msgstr "" -#: library/urllib.request.rst:924 +#: library/urllib.request.rst:922 msgid "" "The :class:`ProxyHandler` will have a method :meth:`!_open` for " "every *protocol* which has a proxy in the *proxies* dictionary given in the " @@ -1105,17 +1105,17 @@ msgid "" "actually execute the protocol." msgstr "" -#: library/urllib.request.rst:934 +#: library/urllib.request.rst:932 msgid "HTTPPasswordMgr Objects" msgstr "" -#: library/urllib.request.rst:936 +#: library/urllib.request.rst:934 msgid "" "These methods are available on :class:`HTTPPasswordMgr` and :class:" "`HTTPPasswordMgrWithDefaultRealm` objects." msgstr "" -#: library/urllib.request.rst:942 +#: library/urllib.request.rst:940 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 " @@ -1123,30 +1123,30 @@ msgid "" "of the given URIs is given." msgstr "" -#: library/urllib.request.rst:950 +#: library/urllib.request.rst:948 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:953 +#: library/urllib.request.rst:951 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:960 +#: library/urllib.request.rst:958 msgid "HTTPPasswordMgrWithPriorAuth Objects" msgstr "" -#: library/urllib.request.rst:962 +#: library/urllib.request.rst:960 msgid "" "This password manager extends :class:`HTTPPasswordMgrWithDefaultRealm` to " "support tracking URIs for which authentication credentials should always be " "sent." msgstr "" -#: library/urllib.request.rst:969 +#: library/urllib.request.rst:967 msgid "" "*realm*, *uri*, *user*, *passwd* are as for :meth:`HTTPPasswordMgr." "add_password`. *is_authenticated* sets the initial value of the " @@ -1154,25 +1154,25 @@ msgid "" "*is_authenticated* is specified as ``True``, *realm* is ignored." msgstr "" -#: library/urllib.request.rst:977 +#: library/urllib.request.rst:975 msgid "Same as for :class:`HTTPPasswordMgrWithDefaultRealm` objects" msgstr "" -#: library/urllib.request.rst:983 +#: library/urllib.request.rst:981 msgid "" "Update the ``is_authenticated`` flag for the given *uri* or list of URIs." msgstr "" -#: library/urllib.request.rst:989 +#: library/urllib.request.rst:987 msgid "" "Returns the current state of the ``is_authenticated`` flag for the given URI." msgstr "" -#: library/urllib.request.rst:996 +#: library/urllib.request.rst:994 msgid "AbstractBasicAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1001 +#: library/urllib.request.rst:999 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 " @@ -1181,7 +1181,7 @@ msgid "" "`Request` object, and *headers* should be the error headers." msgstr "" -#: library/urllib.request.rst:1007 +#: library/urllib.request.rst:1005 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, " @@ -1189,24 +1189,24 @@ msgid "" "and ``\"python.org:80\"`` are fine, ``\"joe:password@python.org\"`` is not)." msgstr "" -#: library/urllib.request.rst:1016 +#: library/urllib.request.rst:1014 msgid "HTTPBasicAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1021 library/urllib.request.rst:1032 -#: library/urllib.request.rst:1057 library/urllib.request.rst:1068 +#: library/urllib.request.rst:1019 library/urllib.request.rst:1030 +#: library/urllib.request.rst:1055 library/urllib.request.rst:1066 msgid "Retry the request with authentication information, if available." msgstr "" -#: library/urllib.request.rst:1027 +#: library/urllib.request.rst:1025 msgid "ProxyBasicAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1038 +#: library/urllib.request.rst:1036 msgid "AbstractDigestAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1043 +#: library/urllib.request.rst:1041 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 " @@ -1214,55 +1214,55 @@ msgid "" "should be the error headers." msgstr "" -#: library/urllib.request.rst:1052 +#: library/urllib.request.rst:1050 msgid "HTTPDigestAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1063 +#: library/urllib.request.rst:1061 msgid "ProxyDigestAuthHandler Objects" msgstr "" -#: library/urllib.request.rst:1074 +#: library/urllib.request.rst:1072 msgid "HTTPHandler Objects" msgstr "" -#: library/urllib.request.rst:1079 +#: library/urllib.request.rst:1077 msgid "" "Send an HTTP request, which can be either GET or POST, depending on ``req." "has_data()``." msgstr "" -#: library/urllib.request.rst:1086 +#: library/urllib.request.rst:1084 msgid "HTTPSHandler Objects" msgstr "" -#: library/urllib.request.rst:1091 +#: library/urllib.request.rst:1089 msgid "" "Send an HTTPS request, which can be either GET or POST, depending on ``req." "has_data()``." msgstr "" -#: library/urllib.request.rst:1098 +#: library/urllib.request.rst:1096 msgid "FileHandler Objects" msgstr "" -#: library/urllib.request.rst:1103 +#: library/urllib.request.rst:1101 msgid "" "Open the file locally, if there is no host name, or the host name is " "``'localhost'``." msgstr "" -#: library/urllib.request.rst:1106 +#: library/urllib.request.rst:1104 msgid "" "This method is applicable only for local hostnames. When a remote hostname " "is given, an :exc:`~urllib.error.URLError` is raised." msgstr "" -#: library/urllib.request.rst:1114 +#: library/urllib.request.rst:1112 msgid "DataHandler Objects" msgstr "" -#: library/urllib.request.rst:1118 +#: library/urllib.request.rst:1116 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 " @@ -1272,51 +1272,51 @@ msgid "" "implementation will raise an :exc:`ValueError` in that case." msgstr "" -#: library/urllib.request.rst:1129 +#: library/urllib.request.rst:1127 msgid "FTPHandler Objects" msgstr "" -#: library/urllib.request.rst:1134 +#: library/urllib.request.rst:1132 msgid "" "Open the FTP file indicated by *req*. The login is always done with empty " "username and password." msgstr "" -#: library/urllib.request.rst:1141 +#: library/urllib.request.rst:1139 msgid "CacheFTPHandler Objects" msgstr "" -#: library/urllib.request.rst:1143 +#: library/urllib.request.rst:1141 msgid "" ":class:`CacheFTPHandler` objects are :class:`FTPHandler` objects with the " "following additional methods:" msgstr "" -#: library/urllib.request.rst:1149 +#: library/urllib.request.rst:1147 msgid "Set timeout of connections to *t* seconds." msgstr "" -#: library/urllib.request.rst:1154 +#: library/urllib.request.rst:1152 msgid "Set maximum number of cached connections to *m*." msgstr "" -#: library/urllib.request.rst:1160 +#: library/urllib.request.rst:1158 msgid "UnknownHandler Objects" msgstr "" -#: library/urllib.request.rst:1165 +#: library/urllib.request.rst:1163 msgid "Raise a :exc:`~urllib.error.URLError` exception." msgstr "" -#: library/urllib.request.rst:1171 +#: library/urllib.request.rst:1169 msgid "HTTPErrorProcessor Objects" msgstr "" -#: library/urllib.request.rst:1177 +#: library/urllib.request.rst:1175 msgid "For 200 error codes, the response object is returned immediately." msgstr "" -#: library/urllib.request.rst:1179 +#: library/urllib.request.rst:1177 msgid "" "For non-200 error codes, this simply passes the job on to the :meth:`!" "http_error_\\` handler methods, via :meth:`OpenerDirector.error`. " @@ -1324,31 +1324,31 @@ msgid "" "error.HTTPError` if no other handler handles the error." msgstr "" -#: library/urllib.request.rst:1187 +#: library/urllib.request.rst:1185 msgid "Process HTTPS error responses." msgstr "" -#: library/urllib.request.rst:1189 +#: library/urllib.request.rst:1187 msgid "The behavior is same as :meth:`http_response`." msgstr "" -#: library/urllib.request.rst:1195 +#: library/urllib.request.rst:1193 msgid "Examples" msgstr "" -#: library/urllib.request.rst:1197 +#: library/urllib.request.rst:1195 msgid "" "In addition to the examples below, more examples are given in :ref:`urllib-" "howto`." msgstr "" -#: library/urllib.request.rst:1200 +#: library/urllib.request.rst:1198 msgid "" "This example gets the python.org main page and displays the first 300 bytes " "of it. ::" msgstr "" -#: library/urllib.request.rst:1213 +#: library/urllib.request.rst:1211 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 " @@ -1357,45 +1357,45 @@ msgid "" "appropriate encoding." msgstr "" -#: library/urllib.request.rst:1219 +#: library/urllib.request.rst:1217 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:1223 +#: library/urllib.request.rst:1221 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:1232 +#: library/urllib.request.rst:1230 msgid "" "It is also possible to achieve the same result without using the :term:" "`context manager` approach. ::" msgstr "" -#: library/urllib.request.rst:1241 +#: library/urllib.request.rst:1239 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:1253 +#: library/urllib.request.rst:1251 msgid "The code for the sample CGI used in the above example is::" msgstr "" -#: library/urllib.request.rst:1260 +#: library/urllib.request.rst:1258 msgid "Here is an example of doing a ``PUT`` request using :class:`Request`::" msgstr "" -#: library/urllib.request.rst:1270 +#: library/urllib.request.rst:1268 msgid "Use of Basic HTTP Authentication::" msgstr "" -#: library/urllib.request.rst:1284 +#: library/urllib.request.rst:1282 msgid "" ":func:`build_opener` provides many handlers by default, including a :class:" "`ProxyHandler`. By default, :class:`ProxyHandler` uses the environment " @@ -1404,71 +1404,71 @@ msgid "" "read to obtain the HTTP proxy's URL." msgstr "" -#: library/urllib.request.rst:1290 +#: library/urllib.request.rst:1288 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:1302 +#: library/urllib.request.rst:1300 msgid "Adding HTTP headers:" msgstr "" -#: library/urllib.request.rst:1304 +#: library/urllib.request.rst:1302 msgid "Use the *headers* argument to the :class:`Request` constructor, or::" msgstr "" -#: library/urllib.request.rst:1313 +#: library/urllib.request.rst:1311 msgid "" ":class:`OpenerDirector` automatically adds a :mailheader:`User-Agent` header " "to every :class:`Request`. To change this::" msgstr "" -#: library/urllib.request.rst:1321 +#: library/urllib.request.rst:1319 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:1328 +#: library/urllib.request.rst:1326 msgid "" "Here is an example session that uses the ``GET`` method to retrieve a URL " "containing parameters::" msgstr "" -#: library/urllib.request.rst:1339 +#: library/urllib.request.rst:1337 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:1350 +#: library/urllib.request.rst:1348 msgid "" "The following example uses an explicitly specified HTTP proxy, overriding " "environment settings::" msgstr "" -#: library/urllib.request.rst:1360 +#: library/urllib.request.rst:1358 msgid "" "The following example uses no proxies at all, overriding environment " "settings::" msgstr "" -#: library/urllib.request.rst:1370 +#: library/urllib.request.rst:1368 msgid "Legacy interface" msgstr "" -#: library/urllib.request.rst:1372 +#: library/urllib.request.rst:1370 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:1378 +#: library/urllib.request.rst:1376 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. " @@ -1478,7 +1478,7 @@ msgid "" "a remote object). Exceptions are the same as for :func:`urlopen`." msgstr "" -#: library/urllib.request.rst:1385 +#: library/urllib.request.rst:1383 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 " @@ -1490,11 +1490,11 @@ msgid "" "file size in response to a retrieval request." msgstr "" -#: library/urllib.request.rst:1394 +#: library/urllib.request.rst:1392 msgid "The following example illustrates the most common usage scenario::" msgstr "" -#: library/urllib.request.rst:1401 +#: library/urllib.request.rst:1399 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 " @@ -1503,7 +1503,7 @@ msgid "" "parse.urlencode` function." msgstr "" -#: library/urllib.request.rst:1407 +#: library/urllib.request.rst:1405 msgid "" ":func:`urlretrieve` will raise :exc:`~urllib.error.ContentTooShortError` " "when it detects that the amount of data available was less than the " @@ -1511,40 +1511,40 @@ msgid "" "This can occur, for example, when the download is interrupted." msgstr "" -#: library/urllib.request.rst:1412 +#: library/urllib.request.rst:1410 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:1416 +#: library/urllib.request.rst:1414 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:1419 +#: library/urllib.request.rst:1417 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:1425 +#: library/urllib.request.rst:1423 msgid "" "Cleans up temporary files that may have been left behind by previous calls " "to :func:`urlretrieve`." msgstr "" -#: library/urllib.request.rst:1432 +#: library/urllib.request.rst:1430 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:1436 +#: library/urllib.request.rst:1434 msgid "" "By default, the :class:`URLopener` class sends a :mailheader:`User-Agent` " "header of ``urllib/VVV``, where *VVV* is the :mod:`urllib` version number. " @@ -1554,7 +1554,7 @@ msgid "" "subclass definition." msgstr "" -#: library/urllib.request.rst:1442 +#: library/urllib.request.rst:1440 msgid "" "The optional *proxies* parameter should be a dictionary mapping scheme names " "to proxy URLs, where an empty dictionary turns proxies off completely. Its " @@ -1562,7 +1562,7 @@ msgid "" "be used if present, as discussed in the definition of :func:`urlopen`, above." msgstr "" -#: library/urllib.request.rst:1447 +#: library/urllib.request.rst:1445 msgid "" "Additional keyword parameters, collected in *x509*, may be used for " "authentication of the client when using the :file:`https:` scheme. The " @@ -1570,13 +1570,13 @@ msgid "" "certificate; both are needed to support client authentication." msgstr "" -#: library/urllib.request.rst:1452 +#: library/urllib.request.rst:1450 msgid "" ":class:`URLopener` objects will raise an :exc:`OSError` exception if the " "server returns an error code." msgstr "" -#: library/urllib.request.rst:1457 +#: library/urllib.request.rst:1455 msgid "" "Open *fullurl* using the appropriate protocol. This method sets up cache " "and proxy information, then calls the appropriate open method with its input " @@ -1585,15 +1585,15 @@ msgid "" "`urlopen`." msgstr "" -#: library/urllib.request.rst:1463 +#: library/urllib.request.rst:1461 msgid "This method always quotes *fullurl* using :func:`~urllib.parse.quote`." msgstr "" -#: library/urllib.request.rst:1467 +#: library/urllib.request.rst:1465 msgid "Overridable interface to open unknown URL types." msgstr "" -#: library/urllib.request.rst:1472 +#: library/urllib.request.rst:1470 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." @@ -1610,7 +1610,7 @@ msgid "" "*reporthook* is ignored for local URLs." msgstr "" -#: library/urllib.request.rst:1485 +#: library/urllib.request.rst:1483 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 " @@ -1619,7 +1619,7 @@ msgid "" "urlencode` function." msgstr "" -#: library/urllib.request.rst:1494 +#: library/urllib.request.rst:1492 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 " @@ -1627,7 +1627,7 @@ msgid "" "constructor." msgstr "" -#: library/urllib.request.rst:1504 +#: library/urllib.request.rst:1502 msgid "" ":class:`FancyURLopener` subclasses :class:`URLopener` providing default " "handling for the following HTTP response codes: 301, 302, 303, 307 and 401. " @@ -1638,14 +1638,14 @@ msgid "" "defaults to 10." msgstr "" -#: library/urllib.request.rst:1511 +#: library/urllib.request.rst:1509 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:1516 +#: library/urllib.request.rst:1514 msgid "" "According to the letter of :rfc:`2616`, 301 and 302 responses to POST " "requests must not be automatically redirected without confirmation by the " @@ -1654,13 +1654,13 @@ msgid "" "behaviour." msgstr "" -#: library/urllib.request.rst:1521 +#: library/urllib.request.rst:1519 msgid "" "The parameters to the constructor are the same as those for :class:" "`URLopener`." msgstr "" -#: library/urllib.request.rst:1525 +#: library/urllib.request.rst:1523 msgid "" "When performing basic authentication, a :class:`FancyURLopener` instance " "calls its :meth:`prompt_user_passwd` method. The default implementation " @@ -1669,59 +1669,59 @@ msgid "" "needed." msgstr "" -#: library/urllib.request.rst:1530 +#: library/urllib.request.rst:1528 msgid "" "The :class:`FancyURLopener` class offers one additional method that should " "be overloaded to provide the appropriate behavior:" msgstr "" -#: library/urllib.request.rst:1535 +#: library/urllib.request.rst:1533 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:1539 +#: library/urllib.request.rst:1537 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:1545 +#: library/urllib.request.rst:1543 msgid ":mod:`urllib.request` Restrictions" msgstr "" -#: library/urllib.request.rst:1551 +#: library/urllib.request.rst:1549 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:1554 +#: library/urllib.request.rst:1552 msgid "Added support for data URLs." msgstr "" -#: library/urllib.request.rst:1556 +#: library/urllib.request.rst:1554 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:1559 +#: library/urllib.request.rst:1557 msgid "" "There should be a function to query whether a particular URL is in the cache." msgstr "" -#: library/urllib.request.rst:1561 +#: library/urllib.request.rst:1559 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:1565 +#: library/urllib.request.rst:1563 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 " @@ -1729,7 +1729,7 @@ msgid "" "functions without using threads." msgstr "" -#: library/urllib.request.rst:1574 +#: library/urllib.request.rst:1572 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 " @@ -1739,7 +1739,7 @@ msgid "" "module :mod:`html.parser` to parse it." msgstr "" -#: library/urllib.request.rst:1583 +#: library/urllib.request.rst:1581 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 " @@ -1757,11 +1757,11 @@ msgid "" "meet your needs." msgstr "" -#: library/urllib.request.rst:1600 +#: library/urllib.request.rst:1598 msgid ":mod:`urllib.response` --- Response classes used by urllib" msgstr "" -#: library/urllib.request.rst:1605 +#: library/urllib.request.rst:1603 msgid "" "The :mod:`urllib.response` module defines functions and classes which define " "a minimal file-like interface, including ``read()`` and ``readline()``. " @@ -1770,46 +1770,46 @@ msgid "" "addinfourl` instance:" msgstr "" -#: library/urllib.request.rst:1614 +#: library/urllib.request.rst:1612 msgid "" "URL of the resource retrieved, commonly used to determine if a redirect was " "followed." msgstr "" -#: library/urllib.request.rst:1618 +#: library/urllib.request.rst:1616 msgid "" "Returns the headers of the response in the form of an :class:`~email.message." "EmailMessage` instance." msgstr "" -#: library/urllib.request.rst:1624 +#: library/urllib.request.rst:1622 msgid "Status code returned by server." msgstr "" -#: library/urllib.request.rst:1628 +#: library/urllib.request.rst:1626 msgid "Deprecated in favor of :attr:`~addinfourl.url`." msgstr "" -#: library/urllib.request.rst:1633 +#: library/urllib.request.rst:1631 msgid "Deprecated in favor of :attr:`~addinfourl.headers`." msgstr "" -#: library/urllib.request.rst:1638 library/urllib.request.rst:1643 +#: library/urllib.request.rst:1636 library/urllib.request.rst:1641 msgid "Deprecated in favor of :attr:`~addinfourl.status`." msgstr "" -#: library/urllib.request.rst:1547 library/urllib.request.rst:1570 +#: library/urllib.request.rst:1545 library/urllib.request.rst:1568 msgid "HTTP" msgstr "" -#: library/urllib.request.rst:1547 library/urllib.request.rst:1570 +#: library/urllib.request.rst:1545 library/urllib.request.rst:1568 msgid "protocol" msgstr "" -#: library/urllib.request.rst:1547 library/urllib.request.rst:1581 +#: library/urllib.request.rst:1545 library/urllib.request.rst:1579 msgid "FTP" msgstr "" -#: library/urllib.request.rst:1570 +#: library/urllib.request.rst:1568 msgid "HTML" msgstr "" diff --git a/library/venv.po b/library/venv.po index 5a7223f52..15b4984c1 100644 --- a/library/venv.po +++ b/library/venv.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -85,7 +85,7 @@ msgstr "" msgid "" "`Python Packaging User Guide: Creating and using virtual environments " "`__" +"environments/#create-and-use-virtual-environments>`__" msgstr "" #: includes/wasm-notavail.rst:3 diff --git a/library/xml.etree.elementtree.po b/library/xml.etree.elementtree.po index 85a6f7f2b..2b85b1664 100644 --- a/library/xml.etree.elementtree.po +++ b/library/xml.etree.elementtree.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -162,18 +162,25 @@ msgid "" "memory." msgstr "" -#: library/xml.etree.elementtree.rst:170 +#: library/xml.etree.elementtree.rst:169 +msgid "" +"Where *immediate* feedback through events is wanted, calling method :meth:" +"`XMLPullParser.flush` can help reduce delay; please make sure to study the " +"related security notes." +msgstr "" + +#: library/xml.etree.elementtree.rst:175 msgid "Finding interesting elements" msgstr "" -#: library/xml.etree.elementtree.rst:172 +#: library/xml.etree.elementtree.rst:177 msgid "" ":class:`Element` has some useful methods that help iterate recursively over " "all the sub-tree below it (its children, their children, and so on). For " "example, :meth:`Element.iter`::" msgstr "" -#: library/xml.etree.elementtree.rst:185 +#: library/xml.etree.elementtree.rst:190 msgid "" ":meth:`Element.findall` finds only elements with a tag which are direct " "children of the current element. :meth:`Element.find` finds the *first* " @@ -181,23 +188,23 @@ msgid "" "text content. :meth:`Element.get` accesses the element's attributes::" msgstr "" -#: library/xml.etree.elementtree.rst:199 +#: library/xml.etree.elementtree.rst:204 msgid "" "More sophisticated specification of which elements to look for is possible " "by using :ref:`XPath `." msgstr "" -#: library/xml.etree.elementtree.rst:203 +#: library/xml.etree.elementtree.rst:208 msgid "Modifying an XML File" msgstr "" -#: library/xml.etree.elementtree.rst:205 +#: library/xml.etree.elementtree.rst:210 msgid "" ":class:`ElementTree` provides a simple way to build XML documents and write " "them to files. The :meth:`ElementTree.write` method serves this purpose." msgstr "" -#: library/xml.etree.elementtree.rst:208 +#: library/xml.etree.elementtree.rst:213 msgid "" "Once created, an :class:`Element` object may be manipulated by directly " "changing its fields (such as :attr:`Element.text`), adding and modifying " @@ -205,23 +212,23 @@ msgid "" "example with :meth:`Element.append`)." msgstr "" -#: library/xml.etree.elementtree.rst:213 +#: library/xml.etree.elementtree.rst:218 msgid "" "Let's say we want to add one to each country's rank, and add an ``updated`` " "attribute to the rank element::" msgstr "" -#: library/xml.etree.elementtree.rst:223 library/xml.etree.elementtree.rst:267 +#: library/xml.etree.elementtree.rst:228 library/xml.etree.elementtree.rst:272 msgid "Our XML now looks like this:" msgstr "" -#: library/xml.etree.elementtree.rst:251 +#: library/xml.etree.elementtree.rst:256 msgid "" "We can remove elements using :meth:`Element.remove`. Let's say we want to " "remove all countries with a rank higher than 50::" msgstr "" -#: library/xml.etree.elementtree.rst:262 +#: library/xml.etree.elementtree.rst:267 msgid "" "Note that concurrent modification while iterating can lead to problems, just " "like when iterating and modifying Python lists or dicts. Therefore, the " @@ -229,21 +236,21 @@ msgid "" "only then iterates over the list of matches." msgstr "" -#: library/xml.etree.elementtree.rst:289 +#: library/xml.etree.elementtree.rst:294 msgid "Building XML documents" msgstr "" -#: library/xml.etree.elementtree.rst:291 +#: library/xml.etree.elementtree.rst:296 msgid "" "The :func:`SubElement` function also provides a convenient way to create new " "sub-elements for a given element::" msgstr "" -#: library/xml.etree.elementtree.rst:302 +#: library/xml.etree.elementtree.rst:307 msgid "Parsing XML with Namespaces" msgstr "" -#: library/xml.etree.elementtree.rst:304 +#: library/xml.etree.elementtree.rst:309 msgid "" "If the XML input has `namespaces `__, tags and attributes with prefixes in the form ``prefix:" @@ -253,34 +260,34 @@ msgid "" "prefixed tags." msgstr "" -#: library/xml.etree.elementtree.rst:312 +#: library/xml.etree.elementtree.rst:317 msgid "" "Here is an XML example that incorporates two namespaces, one with the prefix " "\"fictional\" and the other serving as the default namespace:" msgstr "" -#: library/xml.etree.elementtree.rst:333 +#: library/xml.etree.elementtree.rst:338 msgid "" "One way to search and explore this XML example is to manually add the URI to " "every tag or attribute in the xpath of a :meth:`~Element.find` or :meth:" "`~Element.findall`::" msgstr "" -#: library/xml.etree.elementtree.rst:344 +#: library/xml.etree.elementtree.rst:349 msgid "" "A better way to search the namespaced XML example is to create a dictionary " "with your own prefixes and use those in the search functions::" msgstr "" -#: library/xml.etree.elementtree.rst:356 +#: library/xml.etree.elementtree.rst:361 msgid "These two approaches both output::" msgstr "" -#: library/xml.etree.elementtree.rst:370 +#: library/xml.etree.elementtree.rst:375 msgid "XPath support" msgstr "" -#: library/xml.etree.elementtree.rst:372 +#: library/xml.etree.elementtree.rst:377 msgid "" "This module provides limited support for `XPath expressions `_ for locating elements in a tree. The goal is to support a " @@ -288,40 +295,40 @@ msgid "" "scope of the module." msgstr "" -#: library/xml.etree.elementtree.rst:378 library/xml.etree.elementtree.rst:772 +#: library/xml.etree.elementtree.rst:383 library/xml.etree.elementtree.rst:777 msgid "Example" msgstr "" -#: library/xml.etree.elementtree.rst:380 +#: library/xml.etree.elementtree.rst:385 msgid "" "Here's an example that demonstrates some of the XPath capabilities of the " "module. We'll be using the ``countrydata`` XML document from the :ref:" "`Parsing XML ` section::" msgstr "" -#: library/xml.etree.elementtree.rst:404 +#: library/xml.etree.elementtree.rst:409 msgid "" "For XML with namespaces, use the usual qualified ``{namespace}tag`` " "notation::" msgstr "" -#: library/xml.etree.elementtree.rst:411 +#: library/xml.etree.elementtree.rst:416 msgid "Supported XPath syntax" msgstr "" -#: library/xml.etree.elementtree.rst:416 +#: library/xml.etree.elementtree.rst:421 msgid "Syntax" msgstr "" -#: library/xml.etree.elementtree.rst:416 +#: library/xml.etree.elementtree.rst:421 msgid "Meaning" msgstr "" -#: library/xml.etree.elementtree.rst:418 +#: library/xml.etree.elementtree.rst:423 msgid "``tag``" msgstr "" -#: library/xml.etree.elementtree.rst:418 +#: library/xml.etree.elementtree.rst:423 msgid "" "Selects all child elements with the given tag. For example, ``spam`` selects " "all child elements named ``spam``, and ``spam/egg`` selects all " @@ -331,133 +338,133 @@ msgid "" "not in a namespace." msgstr "" -#: library/xml.etree.elementtree.rst:427 +#: library/xml.etree.elementtree.rst:432 msgid "Support for star-wildcards was added." msgstr "" -#: library/xml.etree.elementtree.rst:430 +#: library/xml.etree.elementtree.rst:435 msgid "``*``" msgstr "" -#: library/xml.etree.elementtree.rst:430 +#: library/xml.etree.elementtree.rst:435 msgid "" "Selects all child elements, including comments and processing instructions. " "For example, ``*/egg`` selects all grandchildren named ``egg``." msgstr "" -#: library/xml.etree.elementtree.rst:434 +#: library/xml.etree.elementtree.rst:439 msgid "``.``" msgstr "" -#: library/xml.etree.elementtree.rst:434 +#: library/xml.etree.elementtree.rst:439 msgid "" "Selects the current node. This is mostly useful at the beginning of the " "path, to indicate that it's a relative path." msgstr "" -#: library/xml.etree.elementtree.rst:438 +#: library/xml.etree.elementtree.rst:443 msgid "``//``" msgstr "" -#: library/xml.etree.elementtree.rst:438 +#: library/xml.etree.elementtree.rst:443 msgid "" "Selects all subelements, on all levels beneath the current element. For " "example, ``.//egg`` selects all ``egg`` elements in the entire tree." msgstr "" -#: library/xml.etree.elementtree.rst:442 +#: library/xml.etree.elementtree.rst:447 msgid "``..``" msgstr "" -#: library/xml.etree.elementtree.rst:442 +#: library/xml.etree.elementtree.rst:447 msgid "" "Selects the parent element. Returns ``None`` if the path attempts to reach " "the ancestors of the start element (the element ``find`` was called on)." msgstr "" -#: library/xml.etree.elementtree.rst:446 +#: library/xml.etree.elementtree.rst:451 msgid "``[@attrib]``" msgstr "" -#: library/xml.etree.elementtree.rst:446 +#: library/xml.etree.elementtree.rst:451 msgid "Selects all elements that have the given attribute." msgstr "" -#: library/xml.etree.elementtree.rst:448 +#: library/xml.etree.elementtree.rst:453 msgid "``[@attrib='value']``" msgstr "" -#: library/xml.etree.elementtree.rst:448 +#: library/xml.etree.elementtree.rst:453 msgid "" "Selects all elements for which the given attribute has the given value. The " "value cannot contain quotes." msgstr "" -#: library/xml.etree.elementtree.rst:452 +#: library/xml.etree.elementtree.rst:457 msgid "``[@attrib!='value']``" msgstr "" -#: library/xml.etree.elementtree.rst:452 +#: library/xml.etree.elementtree.rst:457 msgid "" "Selects all elements for which the given attribute does not have the given " "value. The value cannot contain quotes." msgstr "" -#: library/xml.etree.elementtree.rst:458 +#: library/xml.etree.elementtree.rst:463 msgid "``[tag]``" msgstr "" -#: library/xml.etree.elementtree.rst:458 +#: library/xml.etree.elementtree.rst:463 msgid "" "Selects all elements that have a child named ``tag``. Only immediate " "children are supported." msgstr "" -#: library/xml.etree.elementtree.rst:461 +#: library/xml.etree.elementtree.rst:466 msgid "``[.='text']``" msgstr "" -#: library/xml.etree.elementtree.rst:461 +#: library/xml.etree.elementtree.rst:466 msgid "" "Selects all elements whose complete text content, including descendants, " "equals the given ``text``." msgstr "" -#: library/xml.etree.elementtree.rst:466 +#: library/xml.etree.elementtree.rst:471 msgid "``[.!='text']``" msgstr "" -#: library/xml.etree.elementtree.rst:466 +#: library/xml.etree.elementtree.rst:471 msgid "" "Selects all elements whose complete text content, including descendants, " "does not equal the given ``text``." msgstr "" -#: library/xml.etree.elementtree.rst:472 +#: library/xml.etree.elementtree.rst:477 msgid "``[tag='text']``" msgstr "" -#: library/xml.etree.elementtree.rst:472 +#: library/xml.etree.elementtree.rst:477 msgid "" "Selects all elements that have a child named ``tag`` whose complete text " "content, including descendants, equals the given ``text``." msgstr "" -#: library/xml.etree.elementtree.rst:476 +#: library/xml.etree.elementtree.rst:481 msgid "``[tag!='text']``" msgstr "" -#: library/xml.etree.elementtree.rst:476 +#: library/xml.etree.elementtree.rst:481 msgid "" "Selects all elements that have a child named ``tag`` whose complete text " "content, including descendants, does not equal the given ``text``." msgstr "" -#: library/xml.etree.elementtree.rst:482 +#: library/xml.etree.elementtree.rst:487 msgid "``[position]``" msgstr "" -#: library/xml.etree.elementtree.rst:482 +#: library/xml.etree.elementtree.rst:487 msgid "" "Selects all elements that are located at the given position. The position " "can be either an integer (1 is the first position), the expression " @@ -465,26 +472,26 @@ msgid "" "position (e.g. ``last()-1``)." msgstr "" -#: library/xml.etree.elementtree.rst:489 +#: library/xml.etree.elementtree.rst:494 msgid "" "Predicates (expressions within square brackets) must be preceded by a tag " "name, an asterisk, or another predicate. ``position`` predicates must be " "preceded by a tag name." msgstr "" -#: library/xml.etree.elementtree.rst:494 library/xml.etree.elementtree.rst:824 +#: library/xml.etree.elementtree.rst:499 library/xml.etree.elementtree.rst:829 msgid "Reference" msgstr "" -#: library/xml.etree.elementtree.rst:499 library/xml.etree.elementtree.rst:829 +#: library/xml.etree.elementtree.rst:504 library/xml.etree.elementtree.rst:834 msgid "Functions" msgstr "" -#: library/xml.etree.elementtree.rst:503 +#: library/xml.etree.elementtree.rst:508 msgid "`C14N 2.0 `_ transformation function." msgstr "" -#: library/xml.etree.elementtree.rst:505 +#: library/xml.etree.elementtree.rst:510 msgid "" "Canonicalization is a way to normalise XML output in a way that allows byte-" "by-byte comparisons and digital signatures. It reduced the freedom that XML " @@ -493,7 +500,7 @@ msgid "" "declarations, the ordering of attributes, and ignorable whitespace." msgstr "" -#: library/xml.etree.elementtree.rst:511 +#: library/xml.etree.elementtree.rst:516 msgid "" "This function takes an XML data string (*xml_data*) or a file path or file-" "like object (*from_file*) as input, converts it to the canonical form, and " @@ -502,61 +509,61 @@ msgid "" "should therefore be opened in text mode with ``utf-8`` encoding." msgstr "" -#: library/xml.etree.elementtree.rst:518 +#: library/xml.etree.elementtree.rst:523 msgid "Typical uses::" msgstr "" -#: library/xml.etree.elementtree.rst:529 +#: library/xml.etree.elementtree.rst:534 msgid "The configuration *options* are as follows:" msgstr "" -#: library/xml.etree.elementtree.rst:531 +#: library/xml.etree.elementtree.rst:536 msgid "*with_comments*: set to true to include comments (default: false)" msgstr "" -#: library/xml.etree.elementtree.rst:532 +#: library/xml.etree.elementtree.rst:537 msgid "" "*strip_text*: set to true to strip whitespace before and after text content" msgstr "" -#: library/xml.etree.elementtree.rst:533 library/xml.etree.elementtree.rst:535 +#: library/xml.etree.elementtree.rst:538 library/xml.etree.elementtree.rst:540 msgid "(default: false)" msgstr "" -#: library/xml.etree.elementtree.rst:534 +#: library/xml.etree.elementtree.rst:539 msgid "" "*rewrite_prefixes*: set to true to replace namespace prefixes by " "\"n{number}\"" msgstr "" -#: library/xml.etree.elementtree.rst:536 +#: library/xml.etree.elementtree.rst:541 msgid "*qname_aware_tags*: a set of qname aware tag names in which prefixes" msgstr "" -#: library/xml.etree.elementtree.rst:537 library/xml.etree.elementtree.rst:539 +#: library/xml.etree.elementtree.rst:542 library/xml.etree.elementtree.rst:544 msgid "should be replaced in text content (default: empty)" msgstr "" -#: library/xml.etree.elementtree.rst:538 +#: library/xml.etree.elementtree.rst:543 msgid "" "*qname_aware_attrs*: a set of qname aware attribute names in which prefixes" msgstr "" -#: library/xml.etree.elementtree.rst:540 +#: library/xml.etree.elementtree.rst:545 msgid "*exclude_attrs*: a set of attribute names that should not be serialised" msgstr "" -#: library/xml.etree.elementtree.rst:541 +#: library/xml.etree.elementtree.rst:546 msgid "*exclude_tags*: a set of tag names that should not be serialised" msgstr "" -#: library/xml.etree.elementtree.rst:543 +#: library/xml.etree.elementtree.rst:548 msgid "" "In the option list above, \"a set\" refers to any collection or iterable of " "strings, no ordering is expected." msgstr "" -#: library/xml.etree.elementtree.rst:551 +#: library/xml.etree.elementtree.rst:556 msgid "" "Comment element factory. This factory function creates a special element " "that will be serialized as an XML comment by the standard serializer. The " @@ -565,7 +572,7 @@ msgid "" "representing a comment." msgstr "" -#: library/xml.etree.elementtree.rst:557 +#: library/xml.etree.elementtree.rst:562 msgid "" "Note that :class:`XMLParser` skips over comments in the input instead of " "creating comment objects for them. An :class:`ElementTree` will only contain " @@ -573,29 +580,29 @@ msgid "" "class:`Element` methods." msgstr "" -#: library/xml.etree.elementtree.rst:564 +#: library/xml.etree.elementtree.rst:569 msgid "" "Writes an element tree or element structure to sys.stdout. This function " "should be used for debugging only." msgstr "" -#: library/xml.etree.elementtree.rst:567 +#: library/xml.etree.elementtree.rst:572 msgid "" "The exact output format is implementation dependent. In this version, it's " "written as an ordinary XML file." msgstr "" -#: library/xml.etree.elementtree.rst:570 +#: library/xml.etree.elementtree.rst:575 msgid "*elem* is an element tree or an individual element." msgstr "" -#: library/xml.etree.elementtree.rst:572 +#: library/xml.etree.elementtree.rst:577 msgid "" "The :func:`dump` function now preserves the attribute order specified by the " "user." msgstr "" -#: library/xml.etree.elementtree.rst:579 +#: library/xml.etree.elementtree.rst:584 msgid "" "Parses an XML section from a string constant. Same as :func:`XML`. *text* " "is a string containing XML data. *parser* is an optional parser instance. " @@ -603,7 +610,7 @@ msgid "" "class:`Element` instance." msgstr "" -#: library/xml.etree.elementtree.rst:587 +#: library/xml.etree.elementtree.rst:592 msgid "" "Parses an XML document from a sequence of string fragments. *sequence* is a " "list or other sequence containing XML data fragments. *parser* is an " @@ -611,7 +618,7 @@ msgid "" "parser is used. Returns an :class:`Element` instance." msgstr "" -#: library/xml.etree.elementtree.rst:597 +#: library/xml.etree.elementtree.rst:602 msgid "" "Appends whitespace to the subtree to indent the tree visually. This can be " "used to generate pretty-printed XML output. *tree* can be an Element or " @@ -621,13 +628,13 @@ msgid "" "indentation level as *level*." msgstr "" -#: library/xml.etree.elementtree.rst:609 +#: library/xml.etree.elementtree.rst:614 msgid "" "Check if an object appears to be a valid element object. *element* is an " "element instance. Return ``True`` if this is an element object." msgstr "" -#: library/xml.etree.elementtree.rst:615 +#: library/xml.etree.elementtree.rst:620 msgid "" "Parses an XML section into an element tree incrementally, and reports what's " "going on to the user. *source* is a filename or :term:`file object` " @@ -644,7 +651,7 @@ msgid "" "read." msgstr "" -#: library/xml.etree.elementtree.rst:629 +#: library/xml.etree.elementtree.rst:634 msgid "" "Note that while :func:`iterparse` builds the tree incrementally, it issues " "blocking reads on *source* (or the file it names). As such, it's unsuitable " @@ -652,7 +659,7 @@ msgid "" "parsing, see :class:`XMLPullParser`." msgstr "" -#: library/xml.etree.elementtree.rst:636 +#: library/xml.etree.elementtree.rst:641 msgid "" ":func:`iterparse` only guarantees that it has seen the \">\" character of a " "starting tag when it emits a \"start\" event, so the attributes are defined, " @@ -661,19 +668,19 @@ msgid "" "present." msgstr "" -#: library/xml.etree.elementtree.rst:642 library/xml.etree.elementtree.rst:1481 +#: library/xml.etree.elementtree.rst:647 library/xml.etree.elementtree.rst:1520 msgid "If you need a fully populated element, look for \"end\" events instead." msgstr "" -#: library/xml.etree.elementtree.rst:644 +#: library/xml.etree.elementtree.rst:649 msgid "The *parser* argument." msgstr "" -#: library/xml.etree.elementtree.rst:647 library/xml.etree.elementtree.rst:1485 +#: library/xml.etree.elementtree.rst:652 library/xml.etree.elementtree.rst:1524 msgid "The ``comment`` and ``pi`` events were added." msgstr "" -#: library/xml.etree.elementtree.rst:653 +#: library/xml.etree.elementtree.rst:658 msgid "" "Parses an XML section into an element tree. *source* is a filename or file " "object containing XML data. *parser* is an optional parser instance. If " @@ -681,7 +688,7 @@ msgid "" "class:`ElementTree` instance." msgstr "" -#: library/xml.etree.elementtree.rst:661 +#: library/xml.etree.elementtree.rst:666 msgid "" "PI element factory. This factory function creates a special element that " "will be serialized as an XML processing instruction. *target* is a string " @@ -689,7 +696,7 @@ msgid "" "given. Returns an element instance, representing a processing instruction." msgstr "" -#: library/xml.etree.elementtree.rst:666 +#: library/xml.etree.elementtree.rst:671 msgid "" "Note that :class:`XMLParser` skips over processing instructions in the input " "instead of creating PI objects for them. An :class:`ElementTree` will only " @@ -697,7 +704,7 @@ msgid "" "tree using one of the :class:`Element` methods." msgstr "" -#: library/xml.etree.elementtree.rst:674 +#: library/xml.etree.elementtree.rst:679 msgid "" "Registers a namespace prefix. The registry is global, and any existing " "mapping for either the given prefix or the namespace URI will be removed. " @@ -706,13 +713,13 @@ msgid "" "all possible." msgstr "" -#: library/xml.etree.elementtree.rst:685 +#: library/xml.etree.elementtree.rst:690 msgid "" "Subelement factory. This function creates an element instance, and appends " "it to an existing element." msgstr "" -#: library/xml.etree.elementtree.rst:688 +#: library/xml.etree.elementtree.rst:693 msgid "" "The element name, attribute names, and attribute values can be either " "bytestrings or Unicode strings. *parent* is the parent element. *tag* is " @@ -721,7 +728,7 @@ msgid "" "arguments. Returns an element instance." msgstr "" -#: library/xml.etree.elementtree.rst:699 +#: library/xml.etree.elementtree.rst:704 msgid "" "Generates a string representation of an XML element, including all " "subelements. *element* is an :class:`Element` instance. *encoding* [1]_ is " @@ -733,22 +740,22 @@ msgid "" "Returns an (optionally) encoded string containing the XML data." msgstr "" -#: library/xml.etree.elementtree.rst:708 library/xml.etree.elementtree.rst:735 -#: library/xml.etree.elementtree.rst:1192 +#: library/xml.etree.elementtree.rst:713 library/xml.etree.elementtree.rst:740 +#: library/xml.etree.elementtree.rst:1197 msgid "Added the *short_empty_elements* parameter." msgstr "" -#: library/xml.etree.elementtree.rst:711 library/xml.etree.elementtree.rst:738 +#: library/xml.etree.elementtree.rst:716 library/xml.etree.elementtree.rst:743 msgid "Added the *xml_declaration* and *default_namespace* parameters." msgstr "" -#: library/xml.etree.elementtree.rst:714 +#: library/xml.etree.elementtree.rst:719 msgid "" "The :func:`tostring` function now preserves the attribute order specified by " "the user." msgstr "" -#: library/xml.etree.elementtree.rst:723 +#: library/xml.etree.elementtree.rst:728 msgid "" "Generates a string representation of an XML element, including all " "subelements. *element* is an :class:`Element` instance. *encoding* [1]_ is " @@ -762,13 +769,13 @@ msgid "" "join(tostringlist(element)) == tostring(element)``." msgstr "" -#: library/xml.etree.elementtree.rst:741 +#: library/xml.etree.elementtree.rst:746 msgid "" "The :func:`tostringlist` function now preserves the attribute order " "specified by the user." msgstr "" -#: library/xml.etree.elementtree.rst:748 +#: library/xml.etree.elementtree.rst:753 msgid "" "Parses an XML section from a string constant. This function can be used to " "embed \"XML literals\" in Python code. *text* is a string containing XML " @@ -776,7 +783,7 @@ msgid "" "class:`XMLParser` parser is used. Returns an :class:`Element` instance." msgstr "" -#: library/xml.etree.elementtree.rst:756 +#: library/xml.etree.elementtree.rst:761 msgid "" "Parses an XML section from a string constant, and also returns a dictionary " "which maps from element id:s to elements. *text* is a string containing XML " @@ -785,11 +792,11 @@ msgid "" "`Element` instance and a dictionary." msgstr "" -#: library/xml.etree.elementtree.rst:766 +#: library/xml.etree.elementtree.rst:771 msgid "XInclude support" msgstr "" -#: library/xml.etree.elementtree.rst:768 +#: library/xml.etree.elementtree.rst:773 msgid "" "This module provides limited support for `XInclude directives `_, via the :mod:`xml.etree.ElementInclude` helper " @@ -797,7 +804,7 @@ msgid "" "element trees, based on information in the tree." msgstr "" -#: library/xml.etree.elementtree.rst:774 +#: library/xml.etree.elementtree.rst:779 msgid "" "Here's an example that demonstrates use of the XInclude module. To include " "an XML document in the current document, use the ``{http://www.w3.org/2001/" @@ -805,43 +812,43 @@ msgid "" "and use the **href** attribute to specify the document to include." msgstr "" -#: library/xml.etree.elementtree.rst:783 +#: library/xml.etree.elementtree.rst:788 msgid "" "By default, the **href** attribute is treated as a file name. You can use " "custom loaders to override this behaviour. Also note that the standard " "helper does not support XPointer syntax." msgstr "" -#: library/xml.etree.elementtree.rst:785 +#: library/xml.etree.elementtree.rst:790 msgid "" "To process this file, load it as usual, and pass the root element to the :" "mod:`xml.etree.ElementTree` module:" msgstr "" -#: library/xml.etree.elementtree.rst:796 +#: library/xml.etree.elementtree.rst:801 msgid "" "The ElementInclude module replaces the ``{http://www.w3.org/2001/XInclude}" "include`` element with the root element from the **source.xml** document. " "The result might look something like this:" msgstr "" -#: library/xml.etree.elementtree.rst:804 +#: library/xml.etree.elementtree.rst:809 msgid "" "If the **parse** attribute is omitted, it defaults to \"xml\". The href " "attribute is required." msgstr "" -#: library/xml.etree.elementtree.rst:806 +#: library/xml.etree.elementtree.rst:811 msgid "" "To include a text document, use the ``{http://www.w3.org/2001/XInclude}" "include`` element, and set the **parse** attribute to \"text\":" msgstr "" -#: library/xml.etree.elementtree.rst:815 +#: library/xml.etree.elementtree.rst:820 msgid "The result might look something like:" msgstr "" -#: library/xml.etree.elementtree.rst:836 +#: library/xml.etree.elementtree.rst:841 msgid "" "Default loader. This default loader reads an included resource from disk. " "*href* is a URL. *parse* is for parse mode either \"xml\" or \"text\". " @@ -852,7 +859,7 @@ msgid "" "or raise an exception." msgstr "" -#: library/xml.etree.elementtree.rst:848 +#: library/xml.etree.elementtree.rst:853 msgid "" "This function expands XInclude directives. *elem* is the root element. " "*loader* is an optional resource loader. If omitted, it defaults to :func:" @@ -863,28 +870,28 @@ msgid "" "malicious content explosion. Pass a negative value to disable the limitation." msgstr "" -#: library/xml.etree.elementtree.rst:856 +#: library/xml.etree.elementtree.rst:861 msgid "" "Returns the expanded resource. If the parse mode is ``\"xml\"``, this is an " "ElementTree instance. If the parse mode is \"text\", this is a Unicode " "string. If the loader fails, it can return None or raise an exception." msgstr "" -#: library/xml.etree.elementtree.rst:861 +#: library/xml.etree.elementtree.rst:866 msgid "Added the *base_url* and *max_depth* parameters." msgstr "" -#: library/xml.etree.elementtree.rst:868 +#: library/xml.etree.elementtree.rst:873 msgid "Element Objects" msgstr "" -#: library/xml.etree.elementtree.rst:875 +#: library/xml.etree.elementtree.rst:880 msgid "" "Element class. This class defines the Element interface, and provides a " "reference implementation of this interface." msgstr "" -#: library/xml.etree.elementtree.rst:878 +#: library/xml.etree.elementtree.rst:883 msgid "" "The element name, attribute names, and attribute values can be either " "bytestrings or Unicode strings. *tag* is the element name. *attrib* is an " @@ -892,13 +899,13 @@ msgid "" "additional attributes, given as keyword arguments." msgstr "" -#: library/xml.etree.elementtree.rst:886 +#: library/xml.etree.elementtree.rst:891 msgid "" "A string identifying what kind of data this element represents (the element " "type, in other words)." msgstr "" -#: library/xml.etree.elementtree.rst:893 +#: library/xml.etree.elementtree.rst:898 msgid "" "These attributes can be used to hold additional data associated with the " "element. Their values are usually strings but may be any application-" @@ -909,7 +916,7 @@ msgid "" "the XML data" msgstr "" -#: library/xml.etree.elementtree.rst:905 +#: library/xml.etree.elementtree.rst:910 msgid "" "the *a* element has ``None`` for both *text* and *tail* attributes, the *b* " "element has *text* ``\"1\"`` and *tail* ``\"4\"``, the *c* element has " @@ -917,17 +924,17 @@ msgid "" "``None`` and *tail* ``\"3\"``." msgstr "" -#: library/xml.etree.elementtree.rst:910 +#: library/xml.etree.elementtree.rst:915 msgid "" "To collect the inner text of an element, see :meth:`itertext`, for example " "``\"\".join(element.itertext())``." msgstr "" -#: library/xml.etree.elementtree.rst:913 +#: library/xml.etree.elementtree.rst:918 msgid "Applications may store arbitrary objects in these attributes." msgstr "" -#: library/xml.etree.elementtree.rst:918 +#: library/xml.etree.elementtree.rst:923 msgid "" "A dictionary containing the element's attributes. Note that while the " "*attrib* value is always a real mutable Python dictionary, an ElementTree " @@ -936,59 +943,59 @@ msgid "" "implementations, use the dictionary methods below whenever possible." msgstr "" -#: library/xml.etree.elementtree.rst:924 +#: library/xml.etree.elementtree.rst:929 msgid "The following dictionary-like methods work on the element attributes." msgstr "" -#: library/xml.etree.elementtree.rst:929 +#: library/xml.etree.elementtree.rst:934 msgid "" "Resets an element. This function removes all subelements, clears all " "attributes, and sets the text and tail attributes to ``None``." msgstr "" -#: library/xml.etree.elementtree.rst:935 +#: library/xml.etree.elementtree.rst:940 msgid "Gets the element attribute named *key*." msgstr "" -#: library/xml.etree.elementtree.rst:937 +#: library/xml.etree.elementtree.rst:942 msgid "" "Returns the attribute value, or *default* if the attribute was not found." msgstr "" -#: library/xml.etree.elementtree.rst:942 +#: library/xml.etree.elementtree.rst:947 msgid "" "Returns the element attributes as a sequence of (name, value) pairs. The " "attributes are returned in an arbitrary order." msgstr "" -#: library/xml.etree.elementtree.rst:948 +#: library/xml.etree.elementtree.rst:953 msgid "" "Returns the elements attribute names as a list. The names are returned in " "an arbitrary order." msgstr "" -#: library/xml.etree.elementtree.rst:954 +#: library/xml.etree.elementtree.rst:959 msgid "Set the attribute *key* on the element to *value*." msgstr "" -#: library/xml.etree.elementtree.rst:956 +#: library/xml.etree.elementtree.rst:961 msgid "The following methods work on the element's children (subelements)." msgstr "" -#: library/xml.etree.elementtree.rst:961 +#: library/xml.etree.elementtree.rst:966 msgid "" "Adds the element *subelement* to the end of this element's internal list of " "subelements. Raises :exc:`TypeError` if *subelement* is not an :class:" "`Element`." msgstr "" -#: library/xml.etree.elementtree.rst:968 +#: library/xml.etree.elementtree.rst:973 msgid "" "Appends *subelements* from a sequence object with zero or more elements. " "Raises :exc:`TypeError` if a subelement is not an :class:`Element`." msgstr "" -#: library/xml.etree.elementtree.rst:976 +#: library/xml.etree.elementtree.rst:981 msgid "" "Finds the first subelement matching *match*. *match* may be a tag name or " "a :ref:`path `. Returns an element instance or " @@ -997,7 +1004,7 @@ msgid "" "expression into the given namespace." msgstr "" -#: library/xml.etree.elementtree.rst:985 +#: library/xml.etree.elementtree.rst:990 msgid "" "Finds all matching subelements, by tag name or :ref:`path `. Returns a list containing all matching elements in document " @@ -1006,7 +1013,7 @@ msgid "" "expression into the given namespace." msgstr "" -#: library/xml.etree.elementtree.rst:994 +#: library/xml.etree.elementtree.rst:999 msgid "" "Finds text for the first subelement matching *match*. *match* may be a tag " "name or a :ref:`path `. Returns the text content of the " @@ -1017,13 +1024,13 @@ msgid "" "into the given namespace." msgstr "" -#: library/xml.etree.elementtree.rst:1005 +#: library/xml.etree.elementtree.rst:1010 msgid "" "Inserts *subelement* at the given position in this element. Raises :exc:" "`TypeError` if *subelement* is not an :class:`Element`." msgstr "" -#: library/xml.etree.elementtree.rst:1011 +#: library/xml.etree.elementtree.rst:1016 msgid "" "Creates a tree :term:`iterator` with the current element as the root. The " "iterator iterates over this element and all elements below it, in document " @@ -1032,7 +1039,7 @@ msgid "" "structure is modified during iteration, the result is undefined." msgstr "" -#: library/xml.etree.elementtree.rst:1022 +#: library/xml.etree.elementtree.rst:1027 msgid "" "Finds all matching subelements, by tag name or :ref:`path `. Returns an iterable yielding all matching elements in document " @@ -1040,44 +1047,44 @@ msgid "" "name." msgstr "" -#: library/xml.etree.elementtree.rst:1033 +#: library/xml.etree.elementtree.rst:1038 msgid "" "Creates a text iterator. The iterator loops over this element and all " "subelements, in document order, and returns all inner text." msgstr "" -#: library/xml.etree.elementtree.rst:1041 +#: library/xml.etree.elementtree.rst:1046 msgid "" "Creates a new element object of the same type as this element. Do not call " "this method, use the :func:`SubElement` factory function instead." msgstr "" -#: library/xml.etree.elementtree.rst:1047 +#: library/xml.etree.elementtree.rst:1052 msgid "" "Removes *subelement* from the element. Unlike the find\\* methods this " "method compares elements based on the instance identity, not on tag value or " "contents." msgstr "" -#: library/xml.etree.elementtree.rst:1051 +#: library/xml.etree.elementtree.rst:1056 msgid "" ":class:`Element` objects also support the following sequence type methods " "for working with subelements: :meth:`~object.__delitem__`, :meth:`~object." "__getitem__`, :meth:`~object.__setitem__`, :meth:`~object.__len__`." msgstr "" -#: library/xml.etree.elementtree.rst:1056 +#: library/xml.etree.elementtree.rst:1061 msgid "" "Caution: Elements with no subelements will test as ``False``. Testing the " "truth value of an Element is deprecated and will raise an exception in " "Python 3.14. Use specific ``len(elem)`` or ``elem is None`` test instead.::" msgstr "" -#: library/xml.etree.elementtree.rst:1068 +#: library/xml.etree.elementtree.rst:1073 msgid "Testing the truth value of an Element emits :exc:`DeprecationWarning`." msgstr "" -#: library/xml.etree.elementtree.rst:1071 +#: library/xml.etree.elementtree.rst:1076 msgid "" "Prior to Python 3.8, the serialisation order of the XML attributes of " "elements was artificially made predictable by sorting the attributes by " @@ -1086,7 +1093,7 @@ msgid "" "attributes were originally parsed or created by user code." msgstr "" -#: library/xml.etree.elementtree.rst:1077 +#: library/xml.etree.elementtree.rst:1082 msgid "" "In general, user code should try not to depend on a specific ordering of " "attributes, given that the `XML Information Set `_ writer. Arguments are the " "same as for the :func:`canonicalize` function. This class does not build a " @@ -1322,11 +1329,11 @@ msgid "" "using the *write* function." msgstr "" -#: library/xml.etree.elementtree.rst:1356 +#: library/xml.etree.elementtree.rst:1361 msgid "XMLParser Objects" msgstr "" -#: library/xml.etree.elementtree.rst:1361 +#: library/xml.etree.elementtree.rst:1366 msgid "" "This class is the low-level building block of the module. It uses :mod:`xml." "parsers.expat` for efficient, event-based parsing of XML. It can be fed XML " @@ -1337,24 +1344,43 @@ msgid "" "XML file." msgstr "" -#: library/xml.etree.elementtree.rst:1369 +#: library/xml.etree.elementtree.rst:1374 msgid "" "Parameters are now :ref:`keyword-only `. The *html* " "argument no longer supported." msgstr "" -#: library/xml.etree.elementtree.rst:1376 +#: library/xml.etree.elementtree.rst:1381 msgid "" "Finishes feeding data to the parser. Returns the result of calling the " "``close()`` method of the *target* passed during construction; by default, " "this is the toplevel document element." msgstr "" -#: library/xml.etree.elementtree.rst:1383 +#: library/xml.etree.elementtree.rst:1388 msgid "Feeds data to the parser. *data* is encoded data." msgstr "" -#: library/xml.etree.elementtree.rst:1385 +#: library/xml.etree.elementtree.rst:1393 +#: library/xml.etree.elementtree.rst:1471 +msgid "" +"Triggers parsing of any previously fed unparsed data, which can be used to " +"ensure more immediate feedback, in particular with Expat >=2.6.0. The " +"implementation of :meth:`flush` temporarily disables reparse deferral with " +"Expat (if currently enabled) and triggers a reparse. Disabling reparse " +"deferral has security consequences; please see :meth:`xml.parsers.expat." +"xmlparser.SetReparseDeferralEnabled` for details." +msgstr "" + +#: library/xml.etree.elementtree.rst:1400 +#: library/xml.etree.elementtree.rst:1478 +msgid "" +"Note that :meth:`flush` has been backported to some prior releases of " +"CPython as a security fix. Check for availability of :meth:`flush` using :" +"func:`hasattr` if used in code running across a variety of Python versions." +msgstr "" + +#: library/xml.etree.elementtree.rst:1408 msgid "" ":meth:`XMLParser.feed` calls *target*\\'s ``start(tag, attrs_dict)`` method " "for each opening tag, its ``end(tag)`` method for each closing tag, and data " @@ -1365,11 +1391,11 @@ msgid "" "of an XML file::" msgstr "" -#: library/xml.etree.elementtree.rst:1429 +#: library/xml.etree.elementtree.rst:1452 msgid "XMLPullParser Objects" msgstr "" -#: library/xml.etree.elementtree.rst:1433 +#: library/xml.etree.elementtree.rst:1456 msgid "" "A pull parser suitable for non-blocking applications. Its input-side API is " "similar to that of :class:`XMLParser`, but instead of pushing calls to a " @@ -1381,11 +1407,11 @@ msgid "" "If *events* is omitted, only ``\"end\"`` events are reported." msgstr "" -#: library/xml.etree.elementtree.rst:1444 +#: library/xml.etree.elementtree.rst:1467 msgid "Feed the given bytes data to the parser." msgstr "" -#: library/xml.etree.elementtree.rst:1448 +#: library/xml.etree.elementtree.rst:1487 msgid "" "Signal the parser that the data stream is terminated. Unlike :meth:" "`XMLParser.close`, this method always returns :const:`None`. Any events not " @@ -1393,7 +1419,7 @@ msgid "" "`read_events`." msgstr "" -#: library/xml.etree.elementtree.rst:1455 +#: library/xml.etree.elementtree.rst:1494 msgid "" "Return an iterator over the events which have been encountered in the data " "fed to the parser. The iterator yields ``(event, elem)`` pairs, where " @@ -1402,25 +1428,25 @@ msgid "" "follows." msgstr "" -#: library/xml.etree.elementtree.rst:1461 +#: library/xml.etree.elementtree.rst:1500 msgid "``start``, ``end``: the current Element." msgstr "" -#: library/xml.etree.elementtree.rst:1462 +#: library/xml.etree.elementtree.rst:1501 msgid "``comment``, ``pi``: the current comment / processing instruction" msgstr "" -#: library/xml.etree.elementtree.rst:1463 +#: library/xml.etree.elementtree.rst:1502 msgid "" "``start-ns``: a tuple ``(prefix, uri)`` naming the declared namespace " "mapping." msgstr "" -#: library/xml.etree.elementtree.rst:1465 +#: library/xml.etree.elementtree.rst:1504 msgid "``end-ns``: :const:`None` (this may change in a future version)" msgstr "" -#: library/xml.etree.elementtree.rst:1467 +#: library/xml.etree.elementtree.rst:1506 msgid "" "Events provided in a previous call to :meth:`read_events` will not be " "yielded again. Events are consumed from the internal queue only when they " @@ -1429,7 +1455,7 @@ msgid "" "results." msgstr "" -#: library/xml.etree.elementtree.rst:1475 +#: library/xml.etree.elementtree.rst:1514 msgid "" ":class:`XMLPullParser` only guarantees that it has seen the \">\" character " "of a starting tag when it emits a \"start\" event, so the attributes are " @@ -1438,11 +1464,11 @@ msgid "" "be present." msgstr "" -#: library/xml.etree.elementtree.rst:1490 +#: library/xml.etree.elementtree.rst:1529 msgid "Exceptions" msgstr "" -#: library/xml.etree.elementtree.rst:1494 +#: library/xml.etree.elementtree.rst:1533 msgid "" "XML parse error, raised by the various parsing methods in this module when " "parsing fails. The string representation of an instance of this exception " @@ -1450,22 +1476,22 @@ msgid "" "following attributes available:" msgstr "" -#: library/xml.etree.elementtree.rst:1501 +#: library/xml.etree.elementtree.rst:1540 msgid "" "A numeric error code from the expat parser. See the documentation of :mod:" "`xml.parsers.expat` for the list of error codes and their meanings." msgstr "" -#: library/xml.etree.elementtree.rst:1506 +#: library/xml.etree.elementtree.rst:1545 msgid "" "A tuple of *line*, *column* numbers, specifying where the error occurred." msgstr "" -#: library/xml.etree.elementtree.rst:1509 +#: library/xml.etree.elementtree.rst:1548 msgid "Footnotes" msgstr "" -#: library/xml.etree.elementtree.rst:1510 +#: library/xml.etree.elementtree.rst:1549 msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See " diff --git a/reference/datamodel.po b/reference/datamodel.po index bb9c167c9..219da1fe0 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-03-01 20:27+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -340,33 +340,36 @@ msgid "" "These represent finite ordered sets indexed by non-negative numbers. The " "built-in function :func:`len` returns the number of items of a sequence. " "When the length of a sequence is *n*, the index set contains the numbers 0, " -"1, ..., *n*-1. Item *i* of sequence *a* is selected by ``a[i]``." +"1, ..., *n*-1. Item *i* of sequence *a* is selected by ``a[i]``. Some " +"sequences, including built-in sequences, interpret negative subscripts by " +"adding the sequence length. For example, ``a[-2]`` equals ``a[n-2]``, the " +"second to last item of sequence a with length ``n``." msgstr "" -#: reference/datamodel.rst:306 +#: reference/datamodel.rst:309 msgid "" "Sequences also support slicing: ``a[i:j]`` selects all items with index *k* " "such that *i* ``<=`` *k* ``<`` *j*. When used as an expression, a slice is " -"a sequence of the same type. This implies that the index set is renumbered " -"so that it starts at 0." +"a sequence of the same type. The comment above about negative indexes also " +"applies to negative slice positions." msgstr "" -#: reference/datamodel.rst:311 +#: reference/datamodel.rst:314 msgid "" "Some sequences also support \"extended slicing\" with a third \"step\" " "parameter: ``a[i:j:k]`` selects all items of *a* with index *x* where ``x = " "i + n*k``, *n* ``>=`` ``0`` and *i* ``<=`` *x* ``<`` *j*." msgstr "" -#: reference/datamodel.rst:315 +#: reference/datamodel.rst:318 msgid "Sequences are distinguished according to their mutability:" msgstr "" -#: reference/datamodel.rst:319 +#: reference/datamodel.rst:322 msgid "Immutable sequences" msgstr "" -#: reference/datamodel.rst:325 +#: reference/datamodel.rst:328 msgid "" "An object of an immutable sequence type cannot change once it is created. " "(If the object contains references to other objects, these other objects may " @@ -374,15 +377,15 @@ msgid "" "referenced by an immutable object cannot change.)" msgstr "" -#: reference/datamodel.rst:330 +#: reference/datamodel.rst:333 msgid "The following types are immutable sequences:" msgstr "" -#: reference/datamodel.rst:353 +#: reference/datamodel.rst:356 msgid "Strings" msgstr "" -#: reference/datamodel.rst:343 +#: reference/datamodel.rst:346 msgid "" "A string is a sequence of values that represent Unicode code points. All the " "code points in the range ``U+0000 - U+10FFFF`` can be represented in a " @@ -396,11 +399,11 @@ msgid "" "to achieve the opposite." msgstr "" -#: reference/datamodel.rst:366 +#: reference/datamodel.rst:369 msgid "Tuples" msgstr "" -#: reference/datamodel.rst:361 +#: reference/datamodel.rst:364 msgid "" "The items of a tuple are arbitrary Python objects. Tuples of two or more " "items are formed by comma-separated lists of expressions. A tuple of one " @@ -410,11 +413,11 @@ msgid "" "empty pair of parentheses." msgstr "" -#: reference/datamodel.rst:376 +#: reference/datamodel.rst:379 msgid "Bytes" msgstr "" -#: reference/datamodel.rst:371 +#: reference/datamodel.rst:374 msgid "" "A bytes object is an immutable array. The items are 8-bit bytes, " "represented by integers in the range 0 <= x < 256. Bytes literals (like " @@ -423,43 +426,43 @@ msgid "" "the :meth:`~bytes.decode` method." msgstr "" -#: reference/datamodel.rst:379 +#: reference/datamodel.rst:382 msgid "Mutable sequences" msgstr "" -#: reference/datamodel.rst:388 +#: reference/datamodel.rst:391 msgid "" "Mutable sequences can be changed after they are created. The subscription " "and slicing notations can be used as the target of assignment and :keyword:" "`del` (delete) statements." msgstr "" -#: reference/datamodel.rst:396 +#: reference/datamodel.rst:399 msgid "" "The :mod:`collections` and :mod:`array` module provide additional examples " "of mutable sequence types." msgstr "" -#: reference/datamodel.rst:399 +#: reference/datamodel.rst:402 msgid "There are currently two intrinsic mutable sequence types:" msgstr "" -#: reference/datamodel.rst:406 +#: reference/datamodel.rst:409 msgid "Lists" msgstr "" -#: reference/datamodel.rst:404 +#: reference/datamodel.rst:407 msgid "" "The items of a list are arbitrary Python objects. Lists are formed by " "placing a comma-separated list of expressions in square brackets. (Note that " "there are no special cases needed to form lists of length 0 or 1.)" msgstr "" -#: reference/datamodel.rst:415 +#: reference/datamodel.rst:418 msgid "Byte Arrays" msgstr "" -#: reference/datamodel.rst:411 +#: reference/datamodel.rst:414 msgid "" "A bytearray object is a mutable array. They are created by the built-in :" "func:`bytearray` constructor. Aside from being mutable (and hence " @@ -467,11 +470,11 @@ msgid "" "functionality as immutable :class:`bytes` objects." msgstr "" -#: reference/datamodel.rst:418 +#: reference/datamodel.rst:421 msgid "Set types" msgstr "" -#: reference/datamodel.rst:424 +#: reference/datamodel.rst:427 msgid "" "These represent unordered, finite sets of unique, immutable objects. As " "such, they cannot be indexed by any subscript. However, they can be iterated " @@ -481,7 +484,7 @@ msgid "" "union, difference, and symmetric difference." msgstr "" -#: reference/datamodel.rst:431 +#: reference/datamodel.rst:434 msgid "" "For set elements, the same immutability rules apply as for dictionary keys. " "Note that numeric types obey the normal rules for numeric comparison: if two " @@ -489,37 +492,37 @@ msgid "" "contained in a set." msgstr "" -#: reference/datamodel.rst:436 +#: reference/datamodel.rst:439 msgid "There are currently two intrinsic set types:" msgstr "" -#: reference/datamodel.rst:445 +#: reference/datamodel.rst:448 msgid "Sets" msgstr "" -#: reference/datamodel.rst:442 +#: reference/datamodel.rst:445 msgid "" "These represent a mutable set. They are created by the built-in :func:`set` " "constructor and can be modified afterwards by several methods, such as :meth:" "`~set.add`." msgstr "" -#: reference/datamodel.rst:454 +#: reference/datamodel.rst:457 msgid "Frozen sets" msgstr "" -#: reference/datamodel.rst:450 +#: reference/datamodel.rst:453 msgid "" "These represent an immutable set. They are created by the built-in :func:" "`frozenset` constructor. As a frozenset is immutable and :term:`hashable`, " "it can be used again as an element of another set, or as a dictionary key." msgstr "" -#: reference/datamodel.rst:457 +#: reference/datamodel.rst:460 msgid "Mappings" msgstr "" -#: reference/datamodel.rst:464 +#: reference/datamodel.rst:467 msgid "" "These represent finite sets of objects indexed by arbitrary index sets. The " "subscript notation ``a[k]`` selects the item indexed by ``k`` from the " @@ -528,15 +531,15 @@ msgid "" "returns the number of items in a mapping." msgstr "" -#: reference/datamodel.rst:470 +#: reference/datamodel.rst:473 msgid "There is currently a single intrinsic mapping type:" msgstr "" -#: reference/datamodel.rst:474 +#: reference/datamodel.rst:477 msgid "Dictionaries" msgstr "" -#: reference/datamodel.rst:478 +#: reference/datamodel.rst:481 msgid "" "These represent finite sets of objects indexed by nearly arbitrary values. " "The only types of values not acceptable as keys are values containing lists " @@ -548,7 +551,7 @@ msgid "" "interchangeably to index the same dictionary entry." msgstr "" -#: reference/datamodel.rst:487 +#: reference/datamodel.rst:490 msgid "" "Dictionaries preserve insertion order, meaning that keys will be produced in " "the same order they were added sequentially over the dictionary. Replacing " @@ -556,129 +559,129 @@ msgid "" "inserting it will add it to the end instead of keeping its old place." msgstr "" -#: reference/datamodel.rst:492 +#: reference/datamodel.rst:495 msgid "" "Dictionaries are mutable; they can be created by the ``{...}`` notation (see " "section :ref:`dict`)." msgstr "" -#: reference/datamodel.rst:499 +#: reference/datamodel.rst:502 msgid "" "The extension modules :mod:`dbm.ndbm` and :mod:`dbm.gnu` provide additional " "examples of mapping types, as does the :mod:`collections` module." msgstr "" -#: reference/datamodel.rst:503 +#: reference/datamodel.rst:506 msgid "" "Dictionaries did not preserve insertion order in versions of Python before " "3.6. In CPython 3.6, insertion order was preserved, but it was considered an " "implementation detail at that time rather than a language guarantee." msgstr "" -#: reference/datamodel.rst:510 +#: reference/datamodel.rst:513 msgid "Callable types" msgstr "" -#: reference/datamodel.rst:518 +#: reference/datamodel.rst:521 msgid "" "These are the types to which the function call operation (see section :ref:" "`calls`) can be applied:" msgstr "" -#: reference/datamodel.rst:525 +#: reference/datamodel.rst:528 msgid "User-defined functions" msgstr "" -#: reference/datamodel.rst:532 +#: reference/datamodel.rst:535 msgid "" "A user-defined function object is created by a function definition (see " "section :ref:`function`). It should be called with an argument list " "containing the same number of items as the function's formal parameter list." msgstr "" -#: reference/datamodel.rst:1127 reference/datamodel.rst:1322 +#: reference/datamodel.rst:1130 reference/datamodel.rst:1325 msgid "Special read-only attributes" msgstr "" -#: reference/datamodel.rst:582 +#: reference/datamodel.rst:585 msgid "Attribute" msgstr "" -#: reference/datamodel.rst:583 +#: reference/datamodel.rst:586 msgid "Meaning" msgstr "" -#: reference/datamodel.rst:552 +#: reference/datamodel.rst:555 msgid "" "A reference to the :class:`dictionary ` that holds the function's :ref:" "`global variables ` -- the global namespace of the module in which " "the function was defined." msgstr "" -#: reference/datamodel.rst:557 +#: reference/datamodel.rst:560 msgid "" "``None`` or a :class:`tuple` of cells that contain bindings for the " "function's free variables." msgstr "" -#: reference/datamodel.rst:560 +#: reference/datamodel.rst:563 msgid "" "A cell object has the attribute ``cell_contents``. This can be used to get " "the value of the cell, as well as set the value." msgstr "" -#: reference/datamodel.rst:1359 +#: reference/datamodel.rst:1362 msgid "Special writable attributes" msgstr "" -#: reference/datamodel.rst:577 +#: reference/datamodel.rst:580 msgid "Most of these attributes check the type of the assigned value:" msgstr "" -#: reference/datamodel.rst:586 +#: reference/datamodel.rst:589 msgid "" "The function's documentation string, or ``None`` if unavailable. Not " "inherited by subclasses." msgstr "" -#: reference/datamodel.rst:590 +#: reference/datamodel.rst:593 msgid "" "The function's name. See also: :attr:`__name__ attributes `." msgstr "" -#: reference/datamodel.rst:594 +#: reference/datamodel.rst:597 msgid "" "The function's :term:`qualified name`. See also: :attr:`__qualname__ " "attributes `." msgstr "" -#: reference/datamodel.rst:600 +#: reference/datamodel.rst:603 msgid "" "The name of the module the function was defined in, or ``None`` if " "unavailable." msgstr "" -#: reference/datamodel.rst:604 +#: reference/datamodel.rst:607 msgid "" "A :class:`tuple` containing default :term:`parameter` values for those " "parameters that have defaults, or ``None`` if no parameters have a default " "value." msgstr "" -#: reference/datamodel.rst:609 +#: reference/datamodel.rst:612 msgid "" "The :ref:`code object ` representing the compiled function " "body." msgstr "" -#: reference/datamodel.rst:613 +#: reference/datamodel.rst:616 msgid "" "The namespace supporting arbitrary function attributes. See also: :attr:" "`__dict__ attributes `." msgstr "" -#: reference/datamodel.rst:617 +#: reference/datamodel.rst:620 msgid "" "A :class:`dictionary ` containing annotations of :term:`parameters " "`. The keys of the dictionary are the parameter names, and " @@ -686,88 +689,88 @@ msgid "" "`annotations-howto`." msgstr "" -#: reference/datamodel.rst:624 +#: reference/datamodel.rst:627 msgid "" "A :class:`dictionary ` containing defaults for keyword-only :term:" "`parameters `." msgstr "" -#: reference/datamodel.rst:628 +#: reference/datamodel.rst:631 msgid "" "A :class:`tuple` containing the :ref:`type parameters ` of a :" "ref:`generic function `." msgstr "" -#: reference/datamodel.rst:633 +#: reference/datamodel.rst:636 msgid "" "Function objects also support getting and setting arbitrary attributes, " "which can be used, for example, to attach metadata to functions. Regular " "attribute dot-notation is used to get and set such attributes." msgstr "" -#: reference/datamodel.rst:639 +#: reference/datamodel.rst:642 msgid "" "CPython's current implementation only supports function attributes on user-" "defined functions. Function attributes on :ref:`built-in functions ` may be supported in the future." msgstr "" -#: reference/datamodel.rst:644 +#: reference/datamodel.rst:647 msgid "" "Additional information about a function's definition can be retrieved from " "its :ref:`code object ` (accessible via the :attr:`~function." "__code__` attribute)." msgstr "" -#: reference/datamodel.rst:652 +#: reference/datamodel.rst:655 msgid "Instance methods" msgstr "" -#: reference/datamodel.rst:659 +#: reference/datamodel.rst:662 msgid "" "An instance method object combines a class, a class instance and any " "callable object (normally a user-defined function)." msgstr "" -#: reference/datamodel.rst:1450 +#: reference/datamodel.rst:1453 msgid "Special read-only attributes:" msgstr "" -#: reference/datamodel.rst:674 +#: reference/datamodel.rst:677 msgid "" "Refers to the class instance object to which the method is :ref:`bound " "`" msgstr "" -#: reference/datamodel.rst:678 +#: reference/datamodel.rst:681 msgid "Refers to the original :ref:`function object `" msgstr "" -#: reference/datamodel.rst:681 +#: reference/datamodel.rst:684 msgid "" "The method's documentation (same as :attr:`method.__func__.__doc__ `). A :class:`string ` if the original function had a " "docstring, else ``None``." msgstr "" -#: reference/datamodel.rst:687 +#: reference/datamodel.rst:690 msgid "" "The name of the method (same as :attr:`method.__func__.__name__ `)" msgstr "" -#: reference/datamodel.rst:691 +#: reference/datamodel.rst:694 msgid "" "The name of the module the method was defined in, or ``None`` if unavailable." msgstr "" -#: reference/datamodel.rst:694 +#: reference/datamodel.rst:697 msgid "" "Methods also support accessing (but not setting) the arbitrary function " "attributes on the underlying :ref:`function object `." msgstr "" -#: reference/datamodel.rst:697 +#: reference/datamodel.rst:700 msgid "" "User-defined method objects may be created when getting an attribute of a " "class (perhaps via an instance of that class), if that attribute is a user-" @@ -775,7 +778,7 @@ msgid "" "`classmethod` object." msgstr "" -#: reference/datamodel.rst:704 +#: reference/datamodel.rst:707 msgid "" "When an instance method object is created by retrieving a user-defined :ref:" "`function object ` from a class via one of its " @@ -784,7 +787,7 @@ msgid "" "__func__` attribute is the original function object." msgstr "" -#: reference/datamodel.rst:710 +#: reference/datamodel.rst:713 msgid "" "When an instance method object is created by retrieving a :class:" "`classmethod` object from a class or instance, its :attr:`~method.__self__` " @@ -792,7 +795,7 @@ msgid "" "the function object underlying the class method." msgstr "" -#: reference/datamodel.rst:715 +#: reference/datamodel.rst:718 msgid "" "When an instance method object is called, the underlying function (:attr:" "`~method.__func__`) is called, inserting the class instance (:attr:`~method." @@ -802,7 +805,7 @@ msgid "" "f(x, 1)``." msgstr "" -#: reference/datamodel.rst:722 +#: reference/datamodel.rst:725 msgid "" "When an instance method object is derived from a :class:`classmethod` " "object, the \"class instance\" stored in :attr:`~method.__self__` will " @@ -811,7 +814,7 @@ msgid "" "function." msgstr "" -#: reference/datamodel.rst:727 +#: reference/datamodel.rst:730 msgid "" "Note that the transformation from :ref:`function object ` to instance method object happens each time the attribute is " @@ -824,11 +827,11 @@ msgid "" "this *only* happens when the function is an attribute of the class." msgstr "" -#: reference/datamodel.rst:741 +#: reference/datamodel.rst:744 msgid "Generator functions" msgstr "" -#: reference/datamodel.rst:747 +#: reference/datamodel.rst:750 msgid "" "A function or method which uses the :keyword:`yield` statement (see section :" "ref:`yield`) is called a :dfn:`generator function`. Such a function, when " @@ -841,11 +844,11 @@ msgid "" "values to be returned." msgstr "" -#: reference/datamodel.rst:759 +#: reference/datamodel.rst:762 msgid "Coroutine functions" msgstr "" -#: reference/datamodel.rst:764 +#: reference/datamodel.rst:767 msgid "" "A function or method which is defined using :keyword:`async def` is called " "a :dfn:`coroutine function`. Such a function, when called, returns a :term:" @@ -854,11 +857,11 @@ msgid "" "ref:`coroutine-objects` section." msgstr "" -#: reference/datamodel.rst:772 +#: reference/datamodel.rst:775 msgid "Asynchronous generator functions" msgstr "" -#: reference/datamodel.rst:778 +#: reference/datamodel.rst:781 msgid "" "A function or method which is defined using :keyword:`async def` and which " "uses the :keyword:`yield` statement is called a :dfn:`asynchronous generator " @@ -867,7 +870,7 @@ msgid "" "execute the body of the function." msgstr "" -#: reference/datamodel.rst:784 +#: reference/datamodel.rst:787 msgid "" "Calling the asynchronous iterator's :meth:`aiterator.__anext__ ` method will return an :term:`awaitable` which when awaited will " @@ -878,11 +881,11 @@ msgid "" "yielded." msgstr "" -#: reference/datamodel.rst:797 +#: reference/datamodel.rst:800 msgid "Built-in functions" msgstr "" -#: reference/datamodel.rst:804 +#: reference/datamodel.rst:807 msgid "" "A built-in function object is a wrapper around a C function. Examples of " "built-in functions are :func:`len` and :func:`math.sin` (:mod:`math` is a " @@ -890,32 +893,32 @@ msgid "" "determined by the C function. Special read-only attributes:" msgstr "" -#: reference/datamodel.rst:809 +#: reference/datamodel.rst:812 msgid "" ":attr:`!__doc__` is the function's documentation string, or ``None`` if " "unavailable. See :attr:`function.__doc__`." msgstr "" -#: reference/datamodel.rst:811 +#: reference/datamodel.rst:814 msgid "" ":attr:`!__name__` is the function's name. See :attr:`function.__name__`." msgstr "" -#: reference/datamodel.rst:812 +#: reference/datamodel.rst:815 msgid ":attr:`!__self__` is set to ``None`` (but see the next item)." msgstr "" -#: reference/datamodel.rst:813 +#: reference/datamodel.rst:816 msgid "" ":attr:`!__module__` is the name of the module the function was defined in or " "``None`` if unavailable. See :attr:`function.__module__`." msgstr "" -#: reference/datamodel.rst:821 +#: reference/datamodel.rst:824 msgid "Built-in methods" msgstr "" -#: reference/datamodel.rst:828 +#: reference/datamodel.rst:831 msgid "" "This is really a different disguise of a built-in function, this time " "containing an object passed to the C function as an implicit extra " @@ -926,11 +929,11 @@ msgid "" "__self__>`.)" msgstr "" -#: reference/datamodel.rst:837 +#: reference/datamodel.rst:840 msgid "Classes" msgstr "" -#: reference/datamodel.rst:839 +#: reference/datamodel.rst:842 msgid "" "Classes are callable. These objects normally act as factories for new " "instances of themselves, but variations are possible for class types that " @@ -939,21 +942,21 @@ msgid "" "initialize the new instance." msgstr "" -#: reference/datamodel.rst:847 +#: reference/datamodel.rst:850 msgid "Class Instances" msgstr "" -#: reference/datamodel.rst:849 +#: reference/datamodel.rst:852 msgid "" "Instances of arbitrary classes can be made callable by defining a :meth:" "`~object.__call__` method in their class." msgstr "" -#: reference/datamodel.rst:854 +#: reference/datamodel.rst:857 msgid "Modules" msgstr "" -#: reference/datamodel.rst:860 +#: reference/datamodel.rst:863 msgid "" "Modules are a basic organizational unit of Python code, and are created by " "the :ref:`import system ` as invoked either by the :keyword:" @@ -968,37 +971,37 @@ msgid "" "done)." msgstr "" -#: reference/datamodel.rst:873 +#: reference/datamodel.rst:876 msgid "" "Attribute assignment updates the module's namespace dictionary, e.g., ``m.x " "= 1`` is equivalent to ``m.__dict__[\"x\"] = 1``." msgstr "" -#: reference/datamodel.rst:883 +#: reference/datamodel.rst:886 msgid "Predefined (writable) attributes:" msgstr "" -#: reference/datamodel.rst:886 +#: reference/datamodel.rst:889 msgid ":attr:`__name__`" msgstr "" -#: reference/datamodel.rst:886 +#: reference/datamodel.rst:889 msgid "The module's name." msgstr "" -#: reference/datamodel.rst:990 +#: reference/datamodel.rst:993 msgid ":attr:`__doc__`" msgstr "" -#: reference/datamodel.rst:889 +#: reference/datamodel.rst:892 msgid "The module's documentation string, or ``None`` if unavailable." msgstr "" -#: reference/datamodel.rst:899 +#: reference/datamodel.rst:902 msgid ":attr:`__file__`" msgstr "" -#: reference/datamodel.rst:893 +#: reference/datamodel.rst:896 msgid "" "The pathname of the file from which the module was loaded, if it was loaded " "from a file. The :attr:`__file__` attribute may be missing for certain types " @@ -1007,24 +1010,24 @@ msgid "" "library, it's the pathname of the shared library file." msgstr "" -#: reference/datamodel.rst:997 +#: reference/datamodel.rst:1000 msgid ":attr:`__annotations__`" msgstr "" -#: reference/datamodel.rst:902 +#: reference/datamodel.rst:905 msgid "" "A dictionary containing :term:`variable annotations ` " "collected during module body execution. For best practices on working with :" "attr:`__annotations__`, please see :ref:`annotations-howto`." msgstr "" -#: reference/datamodel.rst:909 +#: reference/datamodel.rst:912 msgid "" "Special read-only attribute: :attr:`~object.__dict__` is the module's " "namespace as a dictionary object." msgstr "" -#: reference/datamodel.rst:914 +#: reference/datamodel.rst:917 msgid "" "Because of the way CPython clears module dictionaries, the module dictionary " "will be cleared when the module falls out of scope even if the dictionary " @@ -1032,11 +1035,11 @@ msgid "" "module around while using its dictionary directly." msgstr "" -#: reference/datamodel.rst:921 +#: reference/datamodel.rst:924 msgid "Custom classes" msgstr "" -#: reference/datamodel.rst:923 +#: reference/datamodel.rst:926 msgid "" "Custom class types are typically created by class definitions (see section :" "ref:`class`). A class has a namespace implemented by a dictionary object. " @@ -1052,7 +1055,7 @@ msgid "" "python.org/download/releases/2.3/mro/." msgstr "" -#: reference/datamodel.rst:947 +#: reference/datamodel.rst:950 msgid "" "When a class attribute reference (for class :class:`!C`, say) would yield a " "class method object, it is transformed into an instance method object whose :" @@ -1063,82 +1066,82 @@ msgid "" "contained in its :attr:`~object.__dict__`." msgstr "" -#: reference/datamodel.rst:958 +#: reference/datamodel.rst:961 msgid "" "Class attribute assignments update the class's dictionary, never the " "dictionary of a base class." msgstr "" -#: reference/datamodel.rst:963 +#: reference/datamodel.rst:966 msgid "" "A class object can be called (see above) to yield a class instance (see " "below)." msgstr "" -#: reference/datamodel.rst:974 +#: reference/datamodel.rst:977 msgid "Special attributes:" msgstr "" -#: reference/datamodel.rst:977 +#: reference/datamodel.rst:980 msgid ":attr:`~definition.__name__`" msgstr "" -#: reference/datamodel.rst:977 +#: reference/datamodel.rst:980 msgid "The class name." msgstr "" -#: reference/datamodel.rst:980 +#: reference/datamodel.rst:983 msgid ":attr:`__module__`" msgstr "" -#: reference/datamodel.rst:980 +#: reference/datamodel.rst:983 msgid "The name of the module in which the class was defined." msgstr "" -#: reference/datamodel.rst:983 +#: reference/datamodel.rst:986 msgid ":attr:`~object.__dict__`" msgstr "" -#: reference/datamodel.rst:983 +#: reference/datamodel.rst:986 msgid "The dictionary containing the class's namespace." msgstr "" -#: reference/datamodel.rst:987 +#: reference/datamodel.rst:990 msgid ":attr:`~class.__bases__`" msgstr "" -#: reference/datamodel.rst:986 +#: reference/datamodel.rst:989 msgid "" "A tuple containing the base classes, in the order of their occurrence in the " "base class list." msgstr "" -#: reference/datamodel.rst:990 +#: reference/datamodel.rst:993 msgid "The class's documentation string, or ``None`` if undefined." msgstr "" -#: reference/datamodel.rst:993 +#: reference/datamodel.rst:996 msgid "" "A dictionary containing :term:`variable annotations ` " "collected during class body execution. For best practices on working with :" "attr:`__annotations__`, please see :ref:`annotations-howto`." msgstr "" -#: reference/datamodel.rst:1002 +#: reference/datamodel.rst:1005 msgid ":attr:`__type_params__`" msgstr "" -#: reference/datamodel.rst:1000 +#: reference/datamodel.rst:1003 msgid "" "A tuple containing the :ref:`type parameters ` of a :ref:" "`generic class `." msgstr "" -#: reference/datamodel.rst:1005 +#: reference/datamodel.rst:1008 msgid "Class instances" msgstr "" -#: reference/datamodel.rst:1013 +#: reference/datamodel.rst:1016 msgid "" "A class instance is created by calling a class object (see above). A class " "instance has a namespace implemented as a dictionary which is the first " @@ -1155,7 +1158,7 @@ msgid "" "__getattr__` method, that is called to satisfy the lookup." msgstr "" -#: reference/datamodel.rst:1029 +#: reference/datamodel.rst:1032 msgid "" "Attribute assignments and deletions update the instance's dictionary, never " "a class's dictionary. If the class has a :meth:`~object.__setattr__` or :" @@ -1163,23 +1166,23 @@ msgid "" "instance dictionary directly." msgstr "" -#: reference/datamodel.rst:1039 +#: reference/datamodel.rst:1042 msgid "" "Class instances can pretend to be numbers, sequences, or mappings if they " "have methods with certain special names. See section :ref:`specialnames`." msgstr "" -#: reference/datamodel.rst:1046 +#: reference/datamodel.rst:1049 msgid "" "Special attributes: :attr:`~object.__dict__` is the attribute dictionary; :" "attr:`~instance.__class__` is the instance's class." msgstr "" -#: reference/datamodel.rst:1051 +#: reference/datamodel.rst:1054 msgid "I/O objects (also known as file objects)" msgstr "" -#: reference/datamodel.rst:1066 +#: reference/datamodel.rst:1069 msgid "" "A :term:`file object` represents an open file. Various shortcuts are " "available to create file objects: the :func:`open` built-in function, and " @@ -1188,7 +1191,7 @@ msgid "" "methods provided by extension modules)." msgstr "" -#: reference/datamodel.rst:1072 +#: reference/datamodel.rst:1075 msgid "" "The objects ``sys.stdin``, ``sys.stdout`` and ``sys.stderr`` are initialized " "to file objects corresponding to the interpreter's standard input, output " @@ -1196,22 +1199,22 @@ msgid "" "interface defined by the :class:`io.TextIOBase` abstract class." msgstr "" -#: reference/datamodel.rst:1080 +#: reference/datamodel.rst:1083 msgid "Internal types" msgstr "" -#: reference/datamodel.rst:1086 +#: reference/datamodel.rst:1089 msgid "" "A few types used internally by the interpreter are exposed to the user. " "Their definitions may change with future versions of the interpreter, but " "they are mentioned here for completeness." msgstr "" -#: reference/datamodel.rst:1094 +#: reference/datamodel.rst:1097 msgid "Code objects" msgstr "" -#: reference/datamodel.rst:1098 +#: reference/datamodel.rst:1101 msgid "" "Code objects represent *byte-compiled* executable Python code, or :term:" "`bytecode`. The difference between a code object and a function object is " @@ -1223,103 +1226,103 @@ msgid "" "no references (directly or indirectly) to mutable objects." msgstr "" -#: reference/datamodel.rst:1132 +#: reference/datamodel.rst:1135 msgid "The function name" msgstr "" -#: reference/datamodel.rst:1135 +#: reference/datamodel.rst:1138 msgid "The fully qualified function name" msgstr "" -#: reference/datamodel.rst:1140 +#: reference/datamodel.rst:1143 msgid "" "The total number of positional :term:`parameters ` (including " "positional-only parameters and parameters with default values) that the " "function has" msgstr "" -#: reference/datamodel.rst:1145 +#: reference/datamodel.rst:1148 msgid "" "The number of positional-only :term:`parameters ` (including " "arguments with default values) that the function has" msgstr "" -#: reference/datamodel.rst:1149 +#: reference/datamodel.rst:1152 msgid "" "The number of keyword-only :term:`parameters ` (including " "arguments with default values) that the function has" msgstr "" -#: reference/datamodel.rst:1153 +#: reference/datamodel.rst:1156 msgid "" "The number of :ref:`local variables ` used by the function " "(including parameters)" msgstr "" -#: reference/datamodel.rst:1157 +#: reference/datamodel.rst:1160 msgid "" "A :class:`tuple` containing the names of the local variables in the function " "(starting with the parameter names)" msgstr "" -#: reference/datamodel.rst:1161 +#: reference/datamodel.rst:1164 msgid "" "A :class:`tuple` containing the names of :ref:`local variables ` " "that are referenced by nested functions inside the function" msgstr "" -#: reference/datamodel.rst:1165 +#: reference/datamodel.rst:1168 msgid "A :class:`tuple` containing the names of free variables in the function" msgstr "" -#: reference/datamodel.rst:1168 +#: reference/datamodel.rst:1171 msgid "" "A string representing the sequence of :term:`bytecode` instructions in the " "function" msgstr "" -#: reference/datamodel.rst:1172 +#: reference/datamodel.rst:1175 msgid "" "A :class:`tuple` containing the literals used by the :term:`bytecode` in the " "function" msgstr "" -#: reference/datamodel.rst:1176 +#: reference/datamodel.rst:1179 msgid "" "A :class:`tuple` containing the names used by the :term:`bytecode` in the " "function" msgstr "" -#: reference/datamodel.rst:1180 +#: reference/datamodel.rst:1183 msgid "The name of the file from which the code was compiled" msgstr "" -#: reference/datamodel.rst:1183 +#: reference/datamodel.rst:1186 msgid "The line number of the first line of the function" msgstr "" -#: reference/datamodel.rst:1186 +#: reference/datamodel.rst:1189 msgid "" "A string encoding the mapping from :term:`bytecode` offsets to line numbers. " "For details, see the source code of the interpreter." msgstr "" -#: reference/datamodel.rst:1189 +#: reference/datamodel.rst:1192 msgid "" "This attribute of code objects is deprecated, and may be removed in Python " "3.14." msgstr "" -#: reference/datamodel.rst:1194 +#: reference/datamodel.rst:1197 msgid "The required stack size of the code object" msgstr "" -#: reference/datamodel.rst:1197 +#: reference/datamodel.rst:1200 msgid "" "An :class:`integer ` encoding a number of flags for the interpreter." msgstr "" -#: reference/datamodel.rst:1202 +#: reference/datamodel.rst:1205 msgid "" "The following flag bits are defined for :attr:`~codeobject.co_flags`: bit " "``0x04`` is set if the function uses the ``*arguments`` syntax to accept an " @@ -1330,7 +1333,7 @@ msgid "" "might be present." msgstr "" -#: reference/datamodel.rst:1210 +#: reference/datamodel.rst:1213 msgid "" "Future feature declarations (``from __future__ import division``) also use " "bits in :attr:`~codeobject.co_flags` to indicate whether a code object was " @@ -1339,29 +1342,29 @@ msgid "" "``0x1000`` were used in earlier versions of Python." msgstr "" -#: reference/datamodel.rst:1216 +#: reference/datamodel.rst:1219 msgid "" "Other bits in :attr:`~codeobject.co_flags` are reserved for internal use." msgstr "" -#: reference/datamodel.rst:1220 +#: reference/datamodel.rst:1223 msgid "" "If a code object represents a function, the first item in :attr:`~codeobject." "co_consts` is the documentation string of the function, or ``None`` if " "undefined." msgstr "" -#: reference/datamodel.rst:1225 +#: reference/datamodel.rst:1228 msgid "Methods on code objects" msgstr "" -#: reference/datamodel.rst:1229 +#: reference/datamodel.rst:1232 msgid "" "Returns an iterable over the source code positions of each :term:`bytecode` " "instruction in the code object." msgstr "" -#: reference/datamodel.rst:1232 +#: reference/datamodel.rst:1235 msgid "" "The iterator returns :class:`tuple`\\s containing the ``(start_line, " "end_line, start_column, end_column)``. The *i-th* tuple corresponds to the " @@ -1369,37 +1372,37 @@ msgid "" "information is 0-indexed utf-8 byte offsets on the given source line." msgstr "" -#: reference/datamodel.rst:1238 +#: reference/datamodel.rst:1241 msgid "" "This positional information can be missing. A non-exhaustive lists of cases " "where this may happen:" msgstr "" -#: reference/datamodel.rst:1241 +#: reference/datamodel.rst:1244 msgid "Running the interpreter with :option:`-X` ``no_debug_ranges``." msgstr "" -#: reference/datamodel.rst:1242 +#: reference/datamodel.rst:1245 msgid "" "Loading a pyc file compiled while using :option:`-X` ``no_debug_ranges``." msgstr "" -#: reference/datamodel.rst:1243 +#: reference/datamodel.rst:1246 msgid "Position tuples corresponding to artificial instructions." msgstr "" -#: reference/datamodel.rst:1244 +#: reference/datamodel.rst:1247 msgid "" "Line and column numbers that can't be represented due to implementation " "specific limitations." msgstr "" -#: reference/datamodel.rst:1247 +#: reference/datamodel.rst:1250 msgid "" "When this occurs, some or all of the tuple elements can be :const:`None`." msgstr "" -#: reference/datamodel.rst:1253 +#: reference/datamodel.rst:1256 msgid "" "This feature requires storing column positions in code objects which may " "result in a small increase of disk usage of compiled Python files or " @@ -1409,144 +1412,144 @@ msgid "" "environment variable can be used." msgstr "" -#: reference/datamodel.rst:1262 +#: reference/datamodel.rst:1265 msgid "" "Returns an iterator that yields information about successive ranges of :term:" "`bytecode`\\s. Each item yielded is a ``(start, end, lineno)`` :class:" "`tuple`:" msgstr "" -#: reference/datamodel.rst:1266 +#: reference/datamodel.rst:1269 msgid "" "``start`` (an :class:`int`) represents the offset (inclusive) of the start " "of the :term:`bytecode` range" msgstr "" -#: reference/datamodel.rst:1268 +#: reference/datamodel.rst:1271 msgid "" "``end`` (an :class:`int`) represents the offset (exclusive) of the end of " "the :term:`bytecode` range" msgstr "" -#: reference/datamodel.rst:1270 +#: reference/datamodel.rst:1273 msgid "" "``lineno`` is an :class:`int` representing the line number of the :term:" "`bytecode` range, or ``None`` if the bytecodes in the given range have no " "line number" msgstr "" -#: reference/datamodel.rst:1274 +#: reference/datamodel.rst:1277 msgid "The items yielded will have the following properties:" msgstr "" -#: reference/datamodel.rst:1276 +#: reference/datamodel.rst:1279 msgid "The first range yielded will have a ``start`` of 0." msgstr "" -#: reference/datamodel.rst:1277 +#: reference/datamodel.rst:1280 msgid "" "The ``(start, end)`` ranges will be non-decreasing and consecutive. That is, " "for any pair of :class:`tuple`\\s, the ``start`` of the second will be equal " "to the ``end`` of the first." msgstr "" -#: reference/datamodel.rst:1280 +#: reference/datamodel.rst:1283 msgid "No range will be backwards: ``end >= start`` for all triples." msgstr "" -#: reference/datamodel.rst:1281 +#: reference/datamodel.rst:1284 msgid "" "The last :class:`tuple` yielded will have ``end`` equal to the size of the :" "term:`bytecode`." msgstr "" -#: reference/datamodel.rst:1284 +#: reference/datamodel.rst:1287 msgid "" "Zero-width ranges, where ``start == end``, are allowed. Zero-width ranges " "are used for lines that are present in the source code, but have been " "eliminated by the :term:`bytecode` compiler." msgstr "" -#: reference/datamodel.rst:1292 +#: reference/datamodel.rst:1295 msgid ":pep:`626` - Precise line numbers for debugging and other tools." msgstr "" -#: reference/datamodel.rst:1293 +#: reference/datamodel.rst:1296 msgid "The PEP that introduced the :meth:`!co_lines` method." msgstr "" -#: reference/datamodel.rst:1297 +#: reference/datamodel.rst:1300 msgid "" "Return a copy of the code object with new values for the specified fields." msgstr "" -#: reference/datamodel.rst:1305 +#: reference/datamodel.rst:1308 msgid "Frame objects" msgstr "" -#: reference/datamodel.rst:1309 +#: reference/datamodel.rst:1312 msgid "" "Frame objects represent execution frames. They may occur in :ref:`traceback " "objects `, and are also passed to registered trace " "functions." msgstr "" -#: reference/datamodel.rst:1327 +#: reference/datamodel.rst:1330 msgid "" "Points to the previous stack frame (towards the caller), or ``None`` if this " "is the bottom stack frame" msgstr "" -#: reference/datamodel.rst:1331 +#: reference/datamodel.rst:1334 msgid "" "The :ref:`code object ` being executed in this frame. " "Accessing this attribute raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"f_code\"``." msgstr "" -#: reference/datamodel.rst:1336 +#: reference/datamodel.rst:1339 msgid "" "The dictionary used by the frame to look up :ref:`local variables `" msgstr "" -#: reference/datamodel.rst:1340 +#: reference/datamodel.rst:1343 msgid "" "The dictionary used by the frame to look up :ref:`global variables `" msgstr "" -#: reference/datamodel.rst:1344 +#: reference/datamodel.rst:1347 msgid "" "The dictionary used by the frame to look up :ref:`built-in (intrinsic) names " "`" msgstr "" -#: reference/datamodel.rst:1348 +#: reference/datamodel.rst:1351 msgid "" "The \"precise instruction\" of the frame object (this is an index into the :" "term:`bytecode` string of the :ref:`code object `)" msgstr "" -#: reference/datamodel.rst:1364 +#: reference/datamodel.rst:1367 msgid "" "If not ``None``, this is a function called for various events during code " "execution (this is used by debuggers). Normally an event is triggered for " "each new source line (see :attr:`~frame.f_trace_lines`)." msgstr "" -#: reference/datamodel.rst:1369 +#: reference/datamodel.rst:1372 msgid "" "Set this attribute to :const:`False` to disable triggering a tracing event " "for each source line." msgstr "" -#: reference/datamodel.rst:1373 +#: reference/datamodel.rst:1376 msgid "" "Set this attribute to :const:`True` to allow per-opcode events to be " "requested. Note that this may lead to undefined interpreter behaviour if " "exceptions raised by the trace function escape to the function being traced." msgstr "" -#: reference/datamodel.rst:1379 +#: reference/datamodel.rst:1382 msgid "" "The current line number of the frame -- writing to this from within a trace " "function jumps to the given line (only for the bottom-most frame). A " @@ -1554,15 +1557,15 @@ msgid "" "this attribute." msgstr "" -#: reference/datamodel.rst:1385 +#: reference/datamodel.rst:1388 msgid "Frame object methods" msgstr "" -#: reference/datamodel.rst:1387 +#: reference/datamodel.rst:1390 msgid "Frame objects support one method:" msgstr "" -#: reference/datamodel.rst:1391 +#: reference/datamodel.rst:1394 msgid "" "This method clears all references to :ref:`local variables ` held by " "the frame. Also, if the frame belonged to a :term:`generator`, the " @@ -1571,26 +1574,26 @@ msgid "" "and storing its :ref:`traceback ` for later use)." msgstr "" -#: reference/datamodel.rst:1397 +#: reference/datamodel.rst:1400 msgid ":exc:`RuntimeError` is raised if the frame is currently executing." msgstr "" -#: reference/datamodel.rst:1405 +#: reference/datamodel.rst:1408 msgid "Traceback objects" msgstr "" -#: reference/datamodel.rst:1418 +#: reference/datamodel.rst:1421 msgid "" "Traceback objects represent the stack trace of an :ref:`exception `. A traceback object is implicitly created when an exception occurs, " "and may also be explicitly created by calling :class:`types.TracebackType`." msgstr "" -#: reference/datamodel.rst:1423 +#: reference/datamodel.rst:1426 msgid "Traceback objects can now be explicitly instantiated from Python code." msgstr "" -#: reference/datamodel.rst:1426 +#: reference/datamodel.rst:1429 msgid "" "For implicitly created tracebacks, when the search for an exception handler " "unwinds the execution stack, at each unwound level a traceback object is " @@ -1601,7 +1604,7 @@ msgid "" "the caught exception." msgstr "" -#: reference/datamodel.rst:1435 +#: reference/datamodel.rst:1438 msgid "" "When the program contains no suitable handler, the stack trace is written " "(nicely formatted) to the standard error stream; if the interpreter is " @@ -1609,33 +1612,33 @@ msgid "" "last_traceback`." msgstr "" -#: reference/datamodel.rst:1440 +#: reference/datamodel.rst:1443 msgid "" "For explicitly created tracebacks, it is up to the creator of the traceback " "to determine how the :attr:`~traceback.tb_next` attributes should be linked " "to form a full stack trace." msgstr "" -#: reference/datamodel.rst:1455 +#: reference/datamodel.rst:1458 msgid "" "Points to the execution :ref:`frame ` of the current level." msgstr "" -#: reference/datamodel.rst:1458 +#: reference/datamodel.rst:1461 msgid "" "Accessing this attribute raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"tb_frame\"``." msgstr "" -#: reference/datamodel.rst:1463 +#: reference/datamodel.rst:1466 msgid "Gives the line number where the exception occurred" msgstr "" -#: reference/datamodel.rst:1466 +#: reference/datamodel.rst:1469 msgid "Indicates the \"precise instruction\"." msgstr "" -#: reference/datamodel.rst:1468 +#: reference/datamodel.rst:1471 msgid "" "The line number and last instruction in the traceback may differ from the " "line number of its :ref:`frame object ` if the exception " @@ -1643,39 +1646,39 @@ msgid "" "with a :keyword:`finally` clause." msgstr "" -#: reference/datamodel.rst:1479 +#: reference/datamodel.rst:1482 msgid "" "The special writable attribute :attr:`!tb_next` is the next level in the " "stack trace (towards the frame where the exception occurred), or ``None`` if " "there is no next level." msgstr "" -#: reference/datamodel.rst:1483 +#: reference/datamodel.rst:1486 msgid "This attribute is now writable" msgstr "" -#: reference/datamodel.rst:1488 +#: reference/datamodel.rst:1491 msgid "Slice objects" msgstr "" -#: reference/datamodel.rst:1492 +#: reference/datamodel.rst:1495 msgid "" "Slice objects are used to represent slices for :meth:`~object.__getitem__` " "methods. They are also created by the built-in :func:`slice` function." msgstr "" -#: reference/datamodel.rst:1501 +#: reference/datamodel.rst:1504 msgid "" "Special read-only attributes: :attr:`~slice.start` is the lower bound; :attr:" "`~slice.stop` is the upper bound; :attr:`~slice.step` is the step value; " "each is ``None`` if omitted. These attributes can have any type." msgstr "" -#: reference/datamodel.rst:1505 +#: reference/datamodel.rst:1508 msgid "Slice objects support one method:" msgstr "" -#: reference/datamodel.rst:1509 +#: reference/datamodel.rst:1512 msgid "" "This method takes a single integer argument *length* and computes " "information about the slice that the slice object would describe if applied " @@ -1685,11 +1688,11 @@ msgid "" "a manner consistent with regular slices." msgstr "" -#: reference/datamodel.rst:1518 +#: reference/datamodel.rst:1521 msgid "Static method objects" msgstr "" -#: reference/datamodel.rst:1520 +#: reference/datamodel.rst:1523 msgid "" "Static method objects provide a way of defeating the transformation of " "function objects to method objects described above. A static method object " @@ -1700,11 +1703,11 @@ msgid "" "method objects are created by the built-in :func:`staticmethod` constructor." msgstr "" -#: reference/datamodel.rst:1530 +#: reference/datamodel.rst:1533 msgid "Class method objects" msgstr "" -#: reference/datamodel.rst:1532 +#: reference/datamodel.rst:1535 msgid "" "A class method object, like a static method object, is a wrapper around " "another object that alters the way in which that object is retrieved from " @@ -1714,11 +1717,11 @@ msgid "" "`classmethod` constructor." msgstr "" -#: reference/datamodel.rst:1542 +#: reference/datamodel.rst:1545 msgid "Special method names" msgstr "" -#: reference/datamodel.rst:1548 +#: reference/datamodel.rst:1551 msgid "" "A class can implement certain operations that are invoked by special syntax " "(such as arithmetic operations or subscripting and slicing) by defining " @@ -1732,7 +1735,7 @@ msgid "" "`TypeError`)." msgstr "" -#: reference/datamodel.rst:1559 +#: reference/datamodel.rst:1562 msgid "" "Setting a special method to ``None`` indicates that the corresponding " "operation is not available. For example, if a class sets :meth:`~object." @@ -1741,7 +1744,7 @@ msgid "" "`~object.__getitem__`). [#]_" msgstr "" -#: reference/datamodel.rst:1565 +#: reference/datamodel.rst:1568 msgid "" "When implementing a class that emulates any built-in type, it is important " "that the emulation only be implemented to the degree that it makes sense for " @@ -1751,11 +1754,11 @@ msgid "" "the W3C's Document Object Model.)" msgstr "" -#: reference/datamodel.rst:1576 +#: reference/datamodel.rst:1579 msgid "Basic customization" msgstr "" -#: reference/datamodel.rst:1582 +#: reference/datamodel.rst:1585 msgid "" "Called to create a new instance of class *cls*. :meth:`__new__` is a static " "method (special-cased so you need not declare it as such) that takes the " @@ -1765,7 +1768,7 @@ msgid "" "new object instance (usually an instance of *cls*)." msgstr "" -#: reference/datamodel.rst:1589 +#: reference/datamodel.rst:1592 msgid "" "Typical implementations create a new instance of the class by invoking the " "superclass's :meth:`__new__` method using ``super().__new__(cls[, ...])`` " @@ -1773,7 +1776,7 @@ msgid "" "necessary before returning it." msgstr "" -#: reference/datamodel.rst:1594 +#: reference/datamodel.rst:1597 msgid "" "If :meth:`__new__` is invoked during object construction and it returns an " "instance of *cls*, then the new instance’s :meth:`__init__` method will be " @@ -1782,13 +1785,13 @@ msgid "" "constructor." msgstr "" -#: reference/datamodel.rst:1599 +#: reference/datamodel.rst:1602 msgid "" "If :meth:`__new__` does not return an instance of *cls*, then the new " "instance's :meth:`__init__` method will not be invoked." msgstr "" -#: reference/datamodel.rst:1602 +#: reference/datamodel.rst:1605 msgid "" ":meth:`__new__` is intended mainly to allow subclasses of immutable types " "(like int, str, or tuple) to customize instance creation. It is also " @@ -1796,7 +1799,7 @@ msgid "" "creation." msgstr "" -#: reference/datamodel.rst:1611 +#: reference/datamodel.rst:1614 msgid "" "Called after the instance has been created (by :meth:`__new__`), but before " "it is returned to the caller. The arguments are those passed to the class " @@ -1806,7 +1809,7 @@ msgid "" "example: ``super().__init__([args...])``." msgstr "" -#: reference/datamodel.rst:1618 +#: reference/datamodel.rst:1621 msgid "" "Because :meth:`__new__` and :meth:`__init__` work together in constructing " "objects (:meth:`__new__` to create it, and :meth:`__init__` to customize " @@ -1814,7 +1817,7 @@ msgid "" "will cause a :exc:`TypeError` to be raised at runtime." msgstr "" -#: reference/datamodel.rst:1631 +#: reference/datamodel.rst:1634 msgid "" "Called when the instance is about to be destroyed. This is also called a " "finalizer or (improperly) a destructor. If a base class has a :meth:" @@ -1823,7 +1826,7 @@ msgid "" "instance." msgstr "" -#: reference/datamodel.rst:1637 +#: reference/datamodel.rst:1640 msgid "" "It is possible (though not recommended!) for the :meth:`__del__` method to " "postpone destruction of the instance by creating a new reference to it. " @@ -1833,20 +1836,20 @@ msgid "" "it once." msgstr "" -#: reference/datamodel.rst:1644 +#: reference/datamodel.rst:1647 msgid "" "It is not guaranteed that :meth:`__del__` methods are called for objects " "that still exist when the interpreter exits." msgstr "" -#: reference/datamodel.rst:1649 +#: reference/datamodel.rst:1652 msgid "" "``del x`` doesn't directly call ``x.__del__()`` --- the former decrements " "the reference count for ``x`` by one, and the latter is only called when " "``x``'s reference count reaches zero." msgstr "" -#: reference/datamodel.rst:1654 +#: reference/datamodel.rst:1657 msgid "" "It is possible for a reference cycle to prevent the reference count of an " "object from going to zero. In this case, the cycle will be later detected " @@ -1857,18 +1860,18 @@ msgid "" "caught in the traceback." msgstr "" -#: reference/datamodel.rst:1664 +#: reference/datamodel.rst:1667 msgid "Documentation for the :mod:`gc` module." msgstr "" -#: reference/datamodel.rst:1668 +#: reference/datamodel.rst:1671 msgid "" "Due to the precarious circumstances under which :meth:`__del__` methods are " "invoked, exceptions that occur during their execution are ignored, and a " "warning is printed to ``sys.stderr`` instead. In particular:" msgstr "" -#: reference/datamodel.rst:1672 +#: reference/datamodel.rst:1675 msgid "" ":meth:`__del__` can be invoked when arbitrary code is being executed, " "including from any arbitrary thread. If :meth:`__del__` needs to take a " @@ -1877,7 +1880,7 @@ msgid "" "`__del__`." msgstr "" -#: reference/datamodel.rst:1678 +#: reference/datamodel.rst:1681 msgid "" ":meth:`__del__` can be executed during interpreter shutdown. As a " "consequence, the global variables it needs to access (including other " @@ -1888,7 +1891,7 @@ msgid "" "still available at the time when the :meth:`__del__` method is called." msgstr "" -#: reference/datamodel.rst:1693 +#: reference/datamodel.rst:1696 msgid "" "Called by the :func:`repr` built-in function to compute the \"official\" " "string representation of an object. If at all possible, this should look " @@ -1900,13 +1903,13 @@ msgid "" "an \"informal\" string representation of instances of that class is required." msgstr "" -#: reference/datamodel.rst:1702 +#: reference/datamodel.rst:1705 msgid "" "This is typically used for debugging, so it is important that the " "representation is information-rich and unambiguous." msgstr "" -#: reference/datamodel.rst:1713 +#: reference/datamodel.rst:1716 msgid "" "Called by :func:`str(object) ` and the built-in functions :func:" "`format` and :func:`print` to compute the \"informal\" or nicely printable " @@ -1914,26 +1917,26 @@ msgid "" "` object." msgstr "" -#: reference/datamodel.rst:1718 +#: reference/datamodel.rst:1721 msgid "" "This method differs from :meth:`object.__repr__` in that there is no " "expectation that :meth:`__str__` return a valid Python expression: a more " "convenient or concise representation can be used." msgstr "" -#: reference/datamodel.rst:1722 +#: reference/datamodel.rst:1725 msgid "" "The default implementation defined by the built-in type :class:`object` " "calls :meth:`object.__repr__`." msgstr "" -#: reference/datamodel.rst:1732 +#: reference/datamodel.rst:1735 msgid "" "Called by :ref:`bytes ` to compute a byte-string representation " "of an object. This should return a :class:`bytes` object." msgstr "" -#: reference/datamodel.rst:1743 +#: reference/datamodel.rst:1746 msgid "" "Called by the :func:`format` built-in function, and by extension, evaluation " "of :ref:`formatted string literals ` and the :meth:`str.format` " @@ -1945,28 +1948,28 @@ msgid "" "formatting option syntax." msgstr "" -#: reference/datamodel.rst:1753 +#: reference/datamodel.rst:1756 msgid "" "See :ref:`formatspec` for a description of the standard formatting syntax." msgstr "" -#: reference/datamodel.rst:1755 +#: reference/datamodel.rst:1758 msgid "The return value must be a string object." msgstr "" -#: reference/datamodel.rst:1757 +#: reference/datamodel.rst:1760 msgid "" "The __format__ method of ``object`` itself raises a :exc:`TypeError` if " "passed any non-empty string." msgstr "" -#: reference/datamodel.rst:1761 +#: reference/datamodel.rst:1764 msgid "" "``object.__format__(x, '')`` is now equivalent to ``str(x)`` rather than " "``format(str(x), '')``." msgstr "" -#: reference/datamodel.rst:1777 +#: reference/datamodel.rst:1780 msgid "" "These are the so-called \"rich comparison\" methods. The correspondence " "between operator symbols and method names is as follows: ``x.__hash__``." msgstr "" -#: reference/datamodel.rst:1866 +#: reference/datamodel.rst:1872 msgid "" "If a class that does not override :meth:`__eq__` wishes to suppress hash " "support, it should include ``__hash__ = None`` in the class definition. A " @@ -2085,7 +2095,7 @@ msgid "" "``isinstance(obj, collections.abc.Hashable)`` call." msgstr "" -#: reference/datamodel.rst:1875 +#: reference/datamodel.rst:1881 msgid "" "By default, the :meth:`__hash__` values of str and bytes objects are " "\"salted\" with an unpredictable random value. Although they remain " @@ -2093,7 +2103,7 @@ msgid "" "between repeated invocations of Python." msgstr "" -#: reference/datamodel.rst:1880 +#: reference/datamodel.rst:1886 msgid "" "This is intended to provide protection against a denial-of-service caused by " "carefully chosen inputs that exploit the worst case performance of a dict " @@ -2101,22 +2111,22 @@ msgid "" "advisories/ocert-2011-003.html for details." msgstr "" -#: reference/datamodel.rst:1885 +#: reference/datamodel.rst:1891 msgid "" "Changing hash values affects the iteration order of sets. Python has never " "made guarantees about this ordering (and it typically varies between 32-bit " "and 64-bit builds)." msgstr "" -#: reference/datamodel.rst:1889 +#: reference/datamodel.rst:1895 msgid "See also :envvar:`PYTHONHASHSEED`." msgstr "" -#: reference/datamodel.rst:1891 +#: reference/datamodel.rst:1897 msgid "Hash randomization is enabled by default." msgstr "" -#: reference/datamodel.rst:1899 +#: reference/datamodel.rst:1905 msgid "" "Called to implement truth value testing and the built-in operation " "``bool()``; should return ``False`` or ``True``. When this method is not " @@ -2125,18 +2135,18 @@ msgid "" "meth:`!__len__` nor :meth:`!__bool__`, all its instances are considered true." msgstr "" -#: reference/datamodel.rst:1910 +#: reference/datamodel.rst:1916 msgid "Customizing attribute access" msgstr "" -#: reference/datamodel.rst:1912 +#: reference/datamodel.rst:1918 msgid "" "The following methods can be defined to customize the meaning of attribute " "access (use of, assignment to, or deletion of ``x.name``) for class " "instances." msgstr "" -#: reference/datamodel.rst:1920 +#: reference/datamodel.rst:1926 msgid "" "Called when the default attribute access fails with an :exc:`AttributeError` " "(either :meth:`__getattribute__` raises an :exc:`AttributeError` because " @@ -2146,7 +2156,7 @@ msgid "" "attribute value or raise an :exc:`AttributeError` exception." msgstr "" -#: reference/datamodel.rst:1927 +#: reference/datamodel.rst:1933 msgid "" "Note that if the attribute is found through the normal mechanism, :meth:" "`__getattr__` is not called. (This is an intentional asymmetry between :" @@ -2159,7 +2169,7 @@ msgid "" "actually get total control over attribute access." msgstr "" -#: reference/datamodel.rst:1940 +#: reference/datamodel.rst:1946 msgid "" "Called unconditionally to implement attribute accesses for instances of the " "class. If the class also defines :meth:`__getattr__`, the latter will not be " @@ -2171,82 +2181,82 @@ msgid "" "example, ``object.__getattribute__(self, name)``." msgstr "" -#: reference/datamodel.rst:1951 +#: reference/datamodel.rst:1957 msgid "" "This method may still be bypassed when looking up special methods as the " "result of implicit invocation via language syntax or :ref:`built-in " "functions `. See :ref:`special-lookup`." msgstr "" -#: reference/datamodel.rst:1956 +#: reference/datamodel.rst:1962 msgid "" "Raises an :ref:`auditing event ` ``object.__getattr__`` with " "arguments ``obj``, ``name``." msgstr "" -#: reference/datamodel.rst:1958 +#: reference/datamodel.rst:1964 msgid "" "For certain sensitive attribute accesses, raises an :ref:`auditing event " "` ``object.__getattr__`` with arguments ``obj`` and ``name``." msgstr "" -#: reference/datamodel.rst:1965 +#: reference/datamodel.rst:1971 msgid "" "Called when an attribute assignment is attempted. This is called instead of " "the normal mechanism (i.e. store the value in the instance dictionary). " "*name* is the attribute name, *value* is the value to be assigned to it." msgstr "" -#: reference/datamodel.rst:1969 +#: reference/datamodel.rst:1975 msgid "" "If :meth:`__setattr__` wants to assign to an instance attribute, it should " "call the base class method with the same name, for example, ``object." "__setattr__(self, name, value)``." msgstr "" -#: reference/datamodel.rst:1973 +#: reference/datamodel.rst:1979 msgid "" "Raises an :ref:`auditing event ` ``object.__setattr__`` with " "arguments ``obj``, ``name``, ``value``." msgstr "" -#: reference/datamodel.rst:1975 +#: reference/datamodel.rst:1981 msgid "" "For certain sensitive attribute assignments, raises an :ref:`auditing event " "` ``object.__setattr__`` with arguments ``obj``, ``name``, " "``value``." msgstr "" -#: reference/datamodel.rst:1982 +#: reference/datamodel.rst:1988 msgid "" "Like :meth:`__setattr__` but for attribute deletion instead of assignment. " "This should only be implemented if ``del obj.name`` is meaningful for the " "object." msgstr "" -#: reference/datamodel.rst:1985 +#: reference/datamodel.rst:1991 msgid "" "Raises an :ref:`auditing event ` ``object.__delattr__`` with " "arguments ``obj``, ``name``." msgstr "" -#: reference/datamodel.rst:1987 +#: reference/datamodel.rst:1993 msgid "" "For certain sensitive attribute deletions, raises an :ref:`auditing event " "` ``object.__delattr__`` with arguments ``obj`` and ``name``." msgstr "" -#: reference/datamodel.rst:1994 +#: reference/datamodel.rst:2000 msgid "" "Called when :func:`dir` is called on the object. An iterable must be " "returned. :func:`dir` converts the returned iterable to a list and sorts it." msgstr "" -#: reference/datamodel.rst:1999 +#: reference/datamodel.rst:2005 msgid "Customizing module attribute access" msgstr "" -#: reference/datamodel.rst:2006 +#: reference/datamodel.rst:2012 msgid "" "Special names ``__getattr__`` and ``__dir__`` can be also used to customize " "access to module attributes. The ``__getattr__`` function at the module " @@ -2258,21 +2268,21 @@ msgid "" "with the attribute name and the result is returned." msgstr "" -#: reference/datamodel.rst:2015 +#: reference/datamodel.rst:2021 msgid "" "The ``__dir__`` function should accept no arguments, and return an iterable " "of strings that represents the names accessible on module. If present, this " "function overrides the standard :func:`dir` search on a module." msgstr "" -#: reference/datamodel.rst:2019 +#: reference/datamodel.rst:2025 msgid "" "For a more fine grained customization of the module behavior (setting " "attributes, properties, etc.), one can set the ``__class__`` attribute of a " "module object to a subclass of :class:`types.ModuleType`. For example::" msgstr "" -#: reference/datamodel.rst:2037 +#: reference/datamodel.rst:2043 msgid "" "Defining module ``__getattr__`` and setting module ``__class__`` only affect " "lookups made using the attribute access syntax -- directly accessing the " @@ -2280,27 +2290,27 @@ msgid "" "module's globals dictionary) is unaffected." msgstr "" -#: reference/datamodel.rst:2042 +#: reference/datamodel.rst:2048 msgid "``__class__`` module attribute is now writable." msgstr "" -#: reference/datamodel.rst:2045 +#: reference/datamodel.rst:2051 msgid "``__getattr__`` and ``__dir__`` module attributes." msgstr "" -#: reference/datamodel.rst:2050 +#: reference/datamodel.rst:2056 msgid ":pep:`562` - Module __getattr__ and __dir__" msgstr "" -#: reference/datamodel.rst:2051 +#: reference/datamodel.rst:2057 msgid "Describes the ``__getattr__`` and ``__dir__`` functions on modules." msgstr "" -#: reference/datamodel.rst:2057 +#: reference/datamodel.rst:2063 msgid "Implementing Descriptors" msgstr "" -#: reference/datamodel.rst:2059 +#: reference/datamodel.rst:2065 msgid "" "The following methods only apply when an instance of the class containing " "the method (a so-called *descriptor* class) appears in an *owner* class (the " @@ -2310,7 +2320,7 @@ msgid "" "the owner class' :attr:`~object.__dict__`." msgstr "" -#: reference/datamodel.rst:2069 +#: reference/datamodel.rst:2075 msgid "" "Called to get the attribute of the owner class (class attribute access) or " "of an instance of that class (instance attribute access). The optional " @@ -2319,13 +2329,13 @@ msgid "" "accessed through the *owner*." msgstr "" -#: reference/datamodel.rst:2075 +#: reference/datamodel.rst:2081 msgid "" "This method should return the computed attribute value or raise an :exc:" "`AttributeError` exception." msgstr "" -#: reference/datamodel.rst:2078 +#: reference/datamodel.rst:2084 msgid "" ":PEP:`252` specifies that :meth:`__get__` is callable with one or two " "arguments. Python's own built-in descriptors support this specification; " @@ -2335,31 +2345,31 @@ msgid "" "not." msgstr "" -#: reference/datamodel.rst:2087 +#: reference/datamodel.rst:2093 msgid "" "Called to set the attribute on an instance *instance* of the owner class to " "a new value, *value*." msgstr "" -#: reference/datamodel.rst:2090 +#: reference/datamodel.rst:2096 msgid "" "Note, adding :meth:`__set__` or :meth:`__delete__` changes the kind of " "descriptor to a \"data descriptor\". See :ref:`descriptor-invocation` for " "more details." msgstr "" -#: reference/datamodel.rst:2096 +#: reference/datamodel.rst:2102 msgid "" "Called to delete the attribute on an instance *instance* of the owner class." msgstr "" -#: reference/datamodel.rst:2098 +#: reference/datamodel.rst:2104 msgid "" "Instances of descriptors may also have the :attr:`!__objclass__` attribute " "present:" msgstr "" -#: reference/datamodel.rst:2103 +#: reference/datamodel.rst:2109 msgid "" "The attribute :attr:`!__objclass__` is interpreted by the :mod:`inspect` " "module as specifying the class where this object was defined (setting this " @@ -2370,11 +2380,11 @@ msgid "" "are implemented in C)." msgstr "" -#: reference/datamodel.rst:2114 +#: reference/datamodel.rst:2120 msgid "Invoking Descriptors" msgstr "" -#: reference/datamodel.rst:2116 +#: reference/datamodel.rst:2122 msgid "" "In general, a descriptor is an object attribute with \"binding behavior\", " "one whose attribute access has been overridden by methods in the descriptor " @@ -2383,7 +2393,7 @@ msgid "" "is said to be a descriptor." msgstr "" -#: reference/datamodel.rst:2122 +#: reference/datamodel.rst:2128 msgid "" "The default behavior for attribute access is to get, set, or delete the " "attribute from an object's dictionary. For instance, ``a.x`` has a lookup " @@ -2391,7 +2401,7 @@ msgid "" "continuing through the base classes of ``type(a)`` excluding metaclasses." msgstr "" -#: reference/datamodel.rst:2127 +#: reference/datamodel.rst:2133 msgid "" "However, if the looked-up value is an object defining one of the descriptor " "methods, then Python may override the default behavior and invoke the " @@ -2399,54 +2409,54 @@ msgid "" "depends on which descriptor methods were defined and how they were called." msgstr "" -#: reference/datamodel.rst:2132 +#: reference/datamodel.rst:2138 msgid "" "The starting point for descriptor invocation is a binding, ``a.x``. How the " "arguments are assembled depends on ``a``:" msgstr "" -#: reference/datamodel.rst:2137 +#: reference/datamodel.rst:2143 msgid "Direct Call" msgstr "" -#: reference/datamodel.rst:2136 +#: reference/datamodel.rst:2142 msgid "" "The simplest and least common call is when user code directly invokes a " "descriptor method: ``x.__get__(a)``." msgstr "" -#: reference/datamodel.rst:2141 +#: reference/datamodel.rst:2147 msgid "Instance Binding" msgstr "" -#: reference/datamodel.rst:2140 +#: reference/datamodel.rst:2146 msgid "" "If binding to an object instance, ``a.x`` is transformed into the call: " "``type(a).__dict__['x'].__get__(a, type(a))``." msgstr "" -#: reference/datamodel.rst:2145 +#: reference/datamodel.rst:2151 msgid "Class Binding" msgstr "" -#: reference/datamodel.rst:2144 +#: reference/datamodel.rst:2150 msgid "" "If binding to a class, ``A.x`` is transformed into the call: ``A." "__dict__['x'].__get__(None, A)``." msgstr "" -#: reference/datamodel.rst:2151 +#: reference/datamodel.rst:2157 msgid "Super Binding" msgstr "" -#: reference/datamodel.rst:2148 +#: reference/datamodel.rst:2154 msgid "" "A dotted lookup such as ``super(A, a).x`` searches ``a.__class__.__mro__`` " "for a base class ``B`` following ``A`` and then returns ``B.__dict__['x']." "__get__(a, A)``. If not a descriptor, ``x`` is returned unchanged." msgstr "" -#: reference/datamodel.rst:2185 +#: reference/datamodel.rst:2191 msgid "" "For instance bindings, the precedence of descriptor invocation depends on " "which descriptor methods are defined. A descriptor can define any " @@ -2464,7 +2474,7 @@ msgid "" "instances." msgstr "" -#: reference/datamodel.rst:2200 +#: reference/datamodel.rst:2206 msgid "" "Python methods (including those decorated with :func:`@staticmethod " "` and :func:`@classmethod `) are implemented as " @@ -2473,30 +2483,30 @@ msgid "" "from other instances of the same class." msgstr "" -#: reference/datamodel.rst:2206 +#: reference/datamodel.rst:2212 msgid "" "The :func:`property` function is implemented as a data descriptor. " "Accordingly, instances cannot override the behavior of a property." msgstr "" -#: reference/datamodel.rst:2213 +#: reference/datamodel.rst:2219 msgid "__slots__" msgstr "" -#: reference/datamodel.rst:2215 +#: reference/datamodel.rst:2221 msgid "" "*__slots__* allow us to explicitly declare data members (like properties) " "and deny the creation of :attr:`~object.__dict__` and *__weakref__* (unless " "explicitly declared in *__slots__* or available in a parent.)" msgstr "" -#: reference/datamodel.rst:2219 +#: reference/datamodel.rst:2225 msgid "" "The space saved over using :attr:`~object.__dict__` can be significant. " "Attribute lookup speed can be significantly improved as well." msgstr "" -#: reference/datamodel.rst:2224 +#: reference/datamodel.rst:2230 msgid "" "This class variable can be assigned a string, iterable, or sequence of " "strings with variable names used by instances. *__slots__* reserves space " @@ -2504,18 +2514,18 @@ msgid "" "`~object.__dict__` and *__weakref__* for each instance." msgstr "" -#: reference/datamodel.rst:2233 +#: reference/datamodel.rst:2239 msgid "Notes on using *__slots__*:" msgstr "" -#: reference/datamodel.rst:2235 +#: reference/datamodel.rst:2241 msgid "" "When inheriting from a class without *__slots__*, the :attr:`~object." "__dict__` and *__weakref__* attribute of the instances will always be " "accessible." msgstr "" -#: reference/datamodel.rst:2239 +#: reference/datamodel.rst:2245 msgid "" "Without a :attr:`~object.__dict__` variable, instances cannot be assigned " "new variables not listed in the *__slots__* definition. Attempts to assign " @@ -2524,7 +2534,7 @@ msgid "" "sequence of strings in the *__slots__* declaration." msgstr "" -#: reference/datamodel.rst:2246 +#: reference/datamodel.rst:2252 msgid "" "Without a *__weakref__* variable for each instance, classes defining " "*__slots__* do not support :mod:`weak references ` to its " @@ -2532,7 +2542,7 @@ msgid "" "to the sequence of strings in the *__slots__* declaration." msgstr "" -#: reference/datamodel.rst:2252 +#: reference/datamodel.rst:2258 msgid "" "*__slots__* are implemented at the class level by creating :ref:`descriptors " "` for each variable name. As a result, class attributes cannot " @@ -2540,7 +2550,7 @@ msgid "" "otherwise, the class attribute would overwrite the descriptor assignment." msgstr "" -#: reference/datamodel.rst:2258 +#: reference/datamodel.rst:2264 msgid "" "The action of a *__slots__* declaration is not limited to the class where it " "is defined. *__slots__* declared in parents are available in child classes. " @@ -2549,7 +2559,7 @@ msgid "" "names of any *additional* slots)." msgstr "" -#: reference/datamodel.rst:2264 +#: reference/datamodel.rst:2270 msgid "" "If a class defines a slot also defined in a base class, the instance " "variable defined by the base class slot is inaccessible (except by " @@ -2558,7 +2568,7 @@ msgid "" "prevent this." msgstr "" -#: reference/datamodel.rst:2269 +#: reference/datamodel.rst:2275 msgid "" ":exc:`TypeError` will be raised if nonempty *__slots__* are defined for a " "class derived from a :c:member:`\"variable-length\" built-in type " @@ -2566,11 +2576,11 @@ msgid "" "`tuple`." msgstr "" -#: reference/datamodel.rst:2274 +#: reference/datamodel.rst:2280 msgid "Any non-string :term:`iterable` may be assigned to *__slots__*." msgstr "" -#: reference/datamodel.rst:2276 +#: reference/datamodel.rst:2282 msgid "" "If a :class:`dictionary ` is used to assign *__slots__*, the " "dictionary keys will be used as the slot names. The values of the dictionary " @@ -2578,13 +2588,13 @@ msgid "" "func:`inspect.getdoc` and displayed in the output of :func:`help`." msgstr "" -#: reference/datamodel.rst:2281 +#: reference/datamodel.rst:2287 msgid "" ":attr:`~instance.__class__` assignment works only if both classes have the " "same *__slots__*." msgstr "" -#: reference/datamodel.rst:2284 +#: reference/datamodel.rst:2290 msgid "" ":ref:`Multiple inheritance ` with multiple slotted parent " "classes can be used, but only one parent is allowed to have attributes " @@ -2592,18 +2602,18 @@ msgid "" "raise :exc:`TypeError`." msgstr "" -#: reference/datamodel.rst:2290 +#: reference/datamodel.rst:2296 msgid "" "If an :term:`iterator` is used for *__slots__* then a :term:`descriptor` is " "created for each of the iterator's values. However, the *__slots__* " "attribute will be an empty iterator." msgstr "" -#: reference/datamodel.rst:2298 +#: reference/datamodel.rst:2304 msgid "Customizing class creation" msgstr "" -#: reference/datamodel.rst:2300 +#: reference/datamodel.rst:2306 msgid "" "Whenever a class inherits from another class, :meth:`~object." "__init_subclass__` is called on the parent class. This way, it is possible " @@ -2613,14 +2623,14 @@ msgid "" "future subclasses of the class defining the method." msgstr "" -#: reference/datamodel.rst:2309 +#: reference/datamodel.rst:2315 msgid "" "This method is called whenever the containing class is subclassed. *cls* is " "then the new subclass. If defined as a normal instance method, this method " "is implicitly converted to a class method." msgstr "" -#: reference/datamodel.rst:2313 +#: reference/datamodel.rst:2319 msgid "" "Keyword arguments which are given to a new class are passed to the parent " "class's ``__init_subclass__``. For compatibility with other classes using " @@ -2628,13 +2638,13 @@ msgid "" "pass the others over to the base class, as in::" msgstr "" -#: reference/datamodel.rst:2327 +#: reference/datamodel.rst:2333 msgid "" "The default implementation ``object.__init_subclass__`` does nothing, but " "raises an error if it is called with any arguments." msgstr "" -#: reference/datamodel.rst:2332 +#: reference/datamodel.rst:2338 msgid "" "The metaclass hint ``metaclass`` is consumed by the rest of the type " "machinery, and is never passed to ``__init_subclass__`` implementations. The " @@ -2642,41 +2652,41 @@ msgid "" "``type(cls)``." msgstr "" -#: reference/datamodel.rst:2340 +#: reference/datamodel.rst:2346 msgid "" "When a class is created, :meth:`type.__new__` scans the class variables and " "makes callbacks to those with a :meth:`~object.__set_name__` hook." msgstr "" -#: reference/datamodel.rst:2345 +#: reference/datamodel.rst:2351 msgid "" "Automatically called at the time the owning class *owner* is created. The " "object has been assigned to *name* in that class::" msgstr "" -#: reference/datamodel.rst:2351 +#: reference/datamodel.rst:2357 msgid "" "If the class variable is assigned after the class is created, :meth:" "`__set_name__` will not be called automatically. If needed, :meth:" "`__set_name__` can be called directly::" msgstr "" -#: reference/datamodel.rst:2362 +#: reference/datamodel.rst:2368 msgid "See :ref:`class-object-creation` for more details." msgstr "" -#: reference/datamodel.rst:2370 +#: reference/datamodel.rst:2376 msgid "Metaclasses" msgstr "" -#: reference/datamodel.rst:2377 +#: reference/datamodel.rst:2383 msgid "" "By default, classes are constructed using :func:`type`. The class body is " "executed in a new namespace and the class name is bound locally to the " "result of ``type(name, bases, namespace)``." msgstr "" -#: reference/datamodel.rst:2381 +#: reference/datamodel.rst:2387 msgid "" "The class creation process can be customized by passing the ``metaclass`` " "keyword argument in the class definition line, or by inheriting from an " @@ -2684,41 +2694,41 @@ msgid "" "both ``MyClass`` and ``MySubclass`` are instances of ``Meta``::" msgstr "" -#: reference/datamodel.rst:2395 +#: reference/datamodel.rst:2401 msgid "" "Any other keyword arguments that are specified in the class definition are " "passed through to all metaclass operations described below." msgstr "" -#: reference/datamodel.rst:2398 +#: reference/datamodel.rst:2404 msgid "When a class definition is executed, the following steps occur:" msgstr "" -#: reference/datamodel.rst:2400 +#: reference/datamodel.rst:2406 msgid "MRO entries are resolved;" msgstr "" -#: reference/datamodel.rst:2401 +#: reference/datamodel.rst:2407 msgid "the appropriate metaclass is determined;" msgstr "" -#: reference/datamodel.rst:2402 +#: reference/datamodel.rst:2408 msgid "the class namespace is prepared;" msgstr "" -#: reference/datamodel.rst:2403 +#: reference/datamodel.rst:2409 msgid "the class body is executed;" msgstr "" -#: reference/datamodel.rst:2404 +#: reference/datamodel.rst:2410 msgid "the class object is created." msgstr "" -#: reference/datamodel.rst:2408 +#: reference/datamodel.rst:2414 msgid "Resolving MRO entries" msgstr "" -#: reference/datamodel.rst:2412 +#: reference/datamodel.rst:2418 msgid "" "If a base that appears in a class definition is not an instance of :class:" "`type`, then an :meth:`!__mro_entries__` method is searched on the base. If " @@ -2730,59 +2740,59 @@ msgid "" "is ignored." msgstr "" -#: reference/datamodel.rst:2424 +#: reference/datamodel.rst:2430 msgid ":func:`types.resolve_bases`" msgstr "" -#: reference/datamodel.rst:2424 +#: reference/datamodel.rst:2430 msgid "Dynamically resolve bases that are not instances of :class:`type`." msgstr "" -#: reference/datamodel.rst:2428 +#: reference/datamodel.rst:2434 msgid ":func:`types.get_original_bases`" msgstr "" -#: reference/datamodel.rst:2427 +#: reference/datamodel.rst:2433 msgid "" "Retrieve a class's \"original bases\" prior to modifications by :meth:" "`~object.__mro_entries__`." msgstr "" -#: reference/datamodel.rst:2430 +#: reference/datamodel.rst:2436 msgid ":pep:`560`" msgstr "" -#: reference/datamodel.rst:2431 +#: reference/datamodel.rst:2437 msgid "Core support for typing module and generic types." msgstr "" -#: reference/datamodel.rst:2435 +#: reference/datamodel.rst:2441 msgid "Determining the appropriate metaclass" msgstr "" -#: reference/datamodel.rst:2439 +#: reference/datamodel.rst:2445 msgid "" "The appropriate metaclass for a class definition is determined as follows:" msgstr "" -#: reference/datamodel.rst:2441 +#: reference/datamodel.rst:2447 msgid "" "if no bases and no explicit metaclass are given, then :func:`type` is used;" msgstr "" -#: reference/datamodel.rst:2442 +#: reference/datamodel.rst:2448 msgid "" "if an explicit metaclass is given and it is *not* an instance of :func:" "`type`, then it is used directly as the metaclass;" msgstr "" -#: reference/datamodel.rst:2444 +#: reference/datamodel.rst:2450 msgid "" "if an instance of :func:`type` is given as the explicit metaclass, or bases " "are defined, then the most derived metaclass is used." msgstr "" -#: reference/datamodel.rst:2447 +#: reference/datamodel.rst:2453 msgid "" "The most derived metaclass is selected from the explicitly specified " "metaclass (if any) and the metaclasses (i.e. ``type(cls)``) of all specified " @@ -2791,11 +2801,11 @@ msgid "" "that criterion, then the class definition will fail with ``TypeError``." msgstr "" -#: reference/datamodel.rst:2457 +#: reference/datamodel.rst:2463 msgid "Preparing the class namespace" msgstr "" -#: reference/datamodel.rst:2462 +#: reference/datamodel.rst:2468 msgid "" "Once the appropriate metaclass has been identified, then the class namespace " "is prepared. If the metaclass has a ``__prepare__`` attribute, it is called " @@ -2807,25 +2817,25 @@ msgid "" "copied into a new ``dict``." msgstr "" -#: reference/datamodel.rst:2471 +#: reference/datamodel.rst:2477 msgid "" "If the metaclass has no ``__prepare__`` attribute, then the class namespace " "is initialised as an empty ordered mapping." msgstr "" -#: reference/datamodel.rst:2476 +#: reference/datamodel.rst:2482 msgid ":pep:`3115` - Metaclasses in Python 3000" msgstr "" -#: reference/datamodel.rst:2477 +#: reference/datamodel.rst:2483 msgid "Introduced the ``__prepare__`` namespace hook" msgstr "" -#: reference/datamodel.rst:2481 +#: reference/datamodel.rst:2487 msgid "Executing the class body" msgstr "" -#: reference/datamodel.rst:2486 +#: reference/datamodel.rst:2492 msgid "" "The class body is executed (approximately) as ``exec(body, globals(), " "namespace)``. The key difference from a normal call to :func:`exec` is that " @@ -2834,7 +2844,7 @@ msgid "" "inside a function." msgstr "" -#: reference/datamodel.rst:2492 +#: reference/datamodel.rst:2498 msgid "" "However, even when the class definition occurs inside the function, methods " "defined inside the class still cannot see names defined at the class scope. " @@ -2843,11 +2853,11 @@ msgid "" "reference described in the next section." msgstr "" -#: reference/datamodel.rst:2501 +#: reference/datamodel.rst:2507 msgid "Creating the class object" msgstr "" -#: reference/datamodel.rst:2508 +#: reference/datamodel.rst:2514 msgid "" "Once the class namespace has been populated by executing the class body, the " "class object is created by calling ``metaclass(name, bases, namespace, " @@ -2855,7 +2865,7 @@ msgid "" "to ``__prepare__``)." msgstr "" -#: reference/datamodel.rst:2513 +#: reference/datamodel.rst:2519 msgid "" "This class object is the one that will be referenced by the zero-argument " "form of :func:`super`. ``__class__`` is an implicit closure reference " @@ -2866,7 +2876,7 @@ msgid "" "is identified based on the first argument passed to the method." msgstr "" -#: reference/datamodel.rst:2523 +#: reference/datamodel.rst:2529 msgid "" "In CPython 3.6 and later, the ``__class__`` cell is passed to the metaclass " "as a ``__classcell__`` entry in the class namespace. If present, this must " @@ -2875,39 +2885,39 @@ msgid "" "in Python 3.8." msgstr "" -#: reference/datamodel.rst:2529 +#: reference/datamodel.rst:2535 msgid "" "When using the default metaclass :class:`type`, or any metaclass that " "ultimately calls ``type.__new__``, the following additional customization " "steps are invoked after creating the class object:" msgstr "" -#: reference/datamodel.rst:2533 +#: reference/datamodel.rst:2539 msgid "" "The ``type.__new__`` method collects all of the attributes in the class " "namespace that define a :meth:`~object.__set_name__` method;" msgstr "" -#: reference/datamodel.rst:2535 +#: reference/datamodel.rst:2541 msgid "" "Those ``__set_name__`` methods are called with the class being defined and " "the assigned name of that particular attribute;" msgstr "" -#: reference/datamodel.rst:2537 +#: reference/datamodel.rst:2543 msgid "" "The :meth:`~object.__init_subclass__` hook is called on the immediate parent " "of the new class in its method resolution order." msgstr "" -#: reference/datamodel.rst:2540 +#: reference/datamodel.rst:2546 msgid "" "After the class object is created, it is passed to the class decorators " "included in the class definition (if any) and the resulting object is bound " "in the local namespace as the defined class." msgstr "" -#: reference/datamodel.rst:2544 +#: reference/datamodel.rst:2550 msgid "" "When a new class is created by ``type.__new__``, the object provided as the " "namespace parameter is copied to a new ordered mapping and the original " @@ -2915,19 +2925,19 @@ msgid "" "becomes the :attr:`~object.__dict__` attribute of the class object." msgstr "" -#: reference/datamodel.rst:2551 +#: reference/datamodel.rst:2557 msgid ":pep:`3135` - New super" msgstr "" -#: reference/datamodel.rst:2552 +#: reference/datamodel.rst:2558 msgid "Describes the implicit ``__class__`` closure reference" msgstr "" -#: reference/datamodel.rst:2556 +#: reference/datamodel.rst:2562 msgid "Uses for metaclasses" msgstr "" -#: reference/datamodel.rst:2558 +#: reference/datamodel.rst:2564 msgid "" "The potential uses for metaclasses are boundless. Some ideas that have been " "explored include enum, logging, interface checking, automatic delegation, " @@ -2935,17 +2945,17 @@ msgid "" "locking/synchronization." msgstr "" -#: reference/datamodel.rst:2565 +#: reference/datamodel.rst:2571 msgid "Customizing instance and subclass checks" msgstr "" -#: reference/datamodel.rst:2567 +#: reference/datamodel.rst:2573 msgid "" "The following methods are used to override the default behavior of the :func:" "`isinstance` and :func:`issubclass` built-in functions." msgstr "" -#: reference/datamodel.rst:2570 +#: reference/datamodel.rst:2576 msgid "" "In particular, the metaclass :class:`abc.ABCMeta` implements these methods " "in order to allow the addition of Abstract Base Classes (ABCs) as \"virtual " @@ -2953,21 +2963,21 @@ msgid "" "other ABCs." msgstr "" -#: reference/datamodel.rst:2577 +#: reference/datamodel.rst:2583 msgid "" "Return true if *instance* should be considered a (direct or indirect) " "instance of *class*. If defined, called to implement ``isinstance(instance, " "class)``." msgstr "" -#: reference/datamodel.rst:2584 +#: reference/datamodel.rst:2590 msgid "" "Return true if *subclass* should be considered a (direct or indirect) " "subclass of *class*. If defined, called to implement ``issubclass(subclass, " "class)``." msgstr "" -#: reference/datamodel.rst:2589 +#: reference/datamodel.rst:2595 msgid "" "Note that these methods are looked up on the type (metaclass) of a class. " "They cannot be defined as class methods in the actual class. This is " @@ -2975,11 +2985,11 @@ msgid "" "only in this case the instance is itself a class." msgstr "" -#: reference/datamodel.rst:2600 +#: reference/datamodel.rst:2606 msgid ":pep:`3119` - Introducing Abstract Base Classes" msgstr "" -#: reference/datamodel.rst:2597 +#: reference/datamodel.rst:2603 msgid "" "Includes the specification for customizing :func:`isinstance` and :func:" "`issubclass` behavior through :meth:`~class.__instancecheck__` and :meth:" @@ -2988,11 +2998,11 @@ msgid "" "language." msgstr "" -#: reference/datamodel.rst:2605 +#: reference/datamodel.rst:2611 msgid "Emulating generic types" msgstr "" -#: reference/datamodel.rst:2607 +#: reference/datamodel.rst:2613 msgid "" "When using :term:`type annotations`, it is often useful to " "*parameterize* a :term:`generic type` using Python's square-brackets " @@ -3000,65 +3010,65 @@ msgid "" "a :class:`list` in which all the elements are of type :class:`int`." msgstr "" -#: reference/datamodel.rst:2615 +#: reference/datamodel.rst:2621 msgid ":pep:`484` - Type Hints" msgstr "" -#: reference/datamodel.rst:2615 +#: reference/datamodel.rst:2621 msgid "Introducing Python's framework for type annotations" msgstr "" -#: reference/datamodel.rst:2618 +#: reference/datamodel.rst:2624 msgid ":ref:`Generic Alias Types`" msgstr "" -#: reference/datamodel.rst:2618 +#: reference/datamodel.rst:2624 msgid "Documentation for objects representing parameterized generic classes" msgstr "" -#: reference/datamodel.rst:2621 +#: reference/datamodel.rst:2627 msgid "" ":ref:`Generics`, :ref:`user-defined generics` and :" "class:`typing.Generic`" msgstr "" -#: reference/datamodel.rst:2621 +#: reference/datamodel.rst:2627 msgid "" "Documentation on how to implement generic classes that can be parameterized " "at runtime and understood by static type-checkers." msgstr "" -#: reference/datamodel.rst:2624 +#: reference/datamodel.rst:2630 msgid "" "A class can *generally* only be parameterized if it defines the special " "class method ``__class_getitem__()``." msgstr "" -#: reference/datamodel.rst:2629 +#: reference/datamodel.rst:2635 msgid "" "Return an object representing the specialization of a generic class by type " "arguments found in *key*." msgstr "" -#: reference/datamodel.rst:2632 +#: reference/datamodel.rst:2638 msgid "" "When defined on a class, ``__class_getitem__()`` is automatically a class " "method. As such, there is no need for it to be decorated with :func:" "`@classmethod` when it is defined." msgstr "" -#: reference/datamodel.rst:2638 +#: reference/datamodel.rst:2644 msgid "The purpose of *__class_getitem__*" msgstr "" -#: reference/datamodel.rst:2640 +#: reference/datamodel.rst:2646 msgid "" "The purpose of :meth:`~object.__class_getitem__` is to allow runtime " "parameterization of standard-library generic classes in order to more easily " "apply :term:`type hints` to these classes." msgstr "" -#: reference/datamodel.rst:2644 +#: reference/datamodel.rst:2650 msgid "" "To implement custom generic classes that can be parameterized at runtime and " "understood by static type-checkers, users should either inherit from a " @@ -3067,7 +3077,7 @@ msgid "" "own implementation of ``__class_getitem__()``." msgstr "" -#: reference/datamodel.rst:2650 +#: reference/datamodel.rst:2656 msgid "" "Custom implementations of :meth:`~object.__class_getitem__` on classes " "defined outside of the standard library may not be understood by third-party " @@ -3075,11 +3085,11 @@ msgid "" "purposes other than type hinting is discouraged." msgstr "" -#: reference/datamodel.rst:2660 +#: reference/datamodel.rst:2666 msgid "*__class_getitem__* versus *__getitem__*" msgstr "" -#: reference/datamodel.rst:2662 +#: reference/datamodel.rst:2668 msgid "" "Usually, the :ref:`subscription` of an object using square " "brackets will call the :meth:`~object.__getitem__` instance method defined " @@ -3089,14 +3099,14 @@ msgid "" "genericalias>` object if it is properly defined." msgstr "" -#: reference/datamodel.rst:2669 +#: reference/datamodel.rst:2675 msgid "" "Presented with the :term:`expression` ``obj[x]``, the Python interpreter " "follows something like the following process to decide whether :meth:" "`~object.__getitem__` or :meth:`~object.__class_getitem__` should be called::" msgstr "" -#: reference/datamodel.rst:2697 +#: reference/datamodel.rst:2703 msgid "" "In Python, all classes are themselves instances of other classes. The class " "of a class is known as that class's :term:`metaclass`, and most classes have " @@ -3106,40 +3116,40 @@ msgid "" "__class_getitem__` being called::" msgstr "" -#: reference/datamodel.rst:2716 +#: reference/datamodel.rst:2722 msgid "" "However, if a class has a custom metaclass that defines :meth:`~object." "__getitem__`, subscribing the class may result in different behaviour. An " "example of this can be found in the :mod:`enum` module::" msgstr "" -#: reference/datamodel.rst:2741 +#: reference/datamodel.rst:2747 msgid ":pep:`560` - Core Support for typing module and generic types" msgstr "" -#: reference/datamodel.rst:2740 +#: reference/datamodel.rst:2746 msgid "" "Introducing :meth:`~object.__class_getitem__`, and outlining when a :ref:" "`subscription` results in ``__class_getitem__()`` being " "called instead of :meth:`~object.__getitem__`" msgstr "" -#: reference/datamodel.rst:2748 +#: reference/datamodel.rst:2754 msgid "Emulating callable objects" msgstr "" -#: reference/datamodel.rst:2755 +#: reference/datamodel.rst:2761 msgid "" "Called when the instance is \"called\" as a function; if this method is " "defined, ``x(arg1, arg2, ...)`` roughly translates to ``type(x).__call__(x, " "arg1, ...)``." msgstr "" -#: reference/datamodel.rst:2762 +#: reference/datamodel.rst:2768 msgid "Emulating container types" msgstr "" -#: reference/datamodel.rst:2764 +#: reference/datamodel.rst:2770 msgid "" "The following methods can be defined to implement container objects. " "Containers usually are :term:`sequences ` (such as :class:`lists " @@ -3175,7 +3185,7 @@ msgid "" "should iterate through the values." msgstr "" -#: reference/datamodel.rst:2805 +#: reference/datamodel.rst:2811 msgid "" "Called to implement the built-in function :func:`len`. Should return the " "length of the object, an integer ``>=`` 0. Also, an object that doesn't " @@ -3183,7 +3193,7 @@ msgid "" "returns zero is considered to be false in a Boolean context." msgstr "" -#: reference/datamodel.rst:2812 +#: reference/datamodel.rst:2818 msgid "" "In CPython, the length is required to be at most :data:`sys.maxsize`. If the " "length is larger than :data:`!sys.maxsize` some features (such as :func:" @@ -3192,7 +3202,7 @@ msgid "" "`~object.__bool__` method." msgstr "" -#: reference/datamodel.rst:2821 +#: reference/datamodel.rst:2827 msgid "" "Called to implement :func:`operator.length_hint`. Should return an estimated " "length for the object (which may be greater or less than the actual length). " @@ -3202,20 +3212,20 @@ msgid "" "never required for correctness." msgstr "" -#: reference/datamodel.rst:2835 +#: reference/datamodel.rst:2841 msgid "" "Slicing is done exclusively with the following three methods. A call like ::" msgstr "" -#: reference/datamodel.rst:2839 +#: reference/datamodel.rst:2845 msgid "is translated to ::" msgstr "" -#: reference/datamodel.rst:2843 +#: reference/datamodel.rst:2849 msgid "and so forth. Missing slice items are always filled in with ``None``." msgstr "" -#: reference/datamodel.rst:2848 +#: reference/datamodel.rst:2854 msgid "" "Called to implement evaluation of ``self[key]``. For :term:`sequence` types, " "the accepted keys should be integers. Optionally, they may support :class:" @@ -3227,20 +3237,20 @@ msgid "" "`KeyError` should be raised." msgstr "" -#: reference/datamodel.rst:2860 +#: reference/datamodel.rst:2866 msgid "" ":keyword:`for` loops expect that an :exc:`IndexError` will be raised for " "illegal indexes to allow proper detection of the end of the sequence." msgstr "" -#: reference/datamodel.rst:2865 +#: reference/datamodel.rst:2871 msgid "" "When :ref:`subscripting` a *class*, the special class method :" "meth:`~object.__class_getitem__` may be called instead of ``__getitem__()``. " "See :ref:`classgetitem-versus-getitem` for more details." msgstr "" -#: reference/datamodel.rst:2873 +#: reference/datamodel.rst:2879 msgid "" "Called to implement assignment to ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -3249,7 +3259,7 @@ msgid "" "for improper *key* values as for the :meth:`__getitem__` method." msgstr "" -#: reference/datamodel.rst:2882 +#: reference/datamodel.rst:2888 msgid "" "Called to implement deletion of ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -3258,13 +3268,13 @@ msgid "" "values as for the :meth:`__getitem__` method." msgstr "" -#: reference/datamodel.rst:2891 +#: reference/datamodel.rst:2897 msgid "" "Called by :class:`dict`\\ .\\ :meth:`__getitem__` to implement ``self[key]`` " "for dict subclasses when key is not in the dictionary." msgstr "" -#: reference/datamodel.rst:2897 +#: reference/datamodel.rst:2903 msgid "" "This method is called when an :term:`iterator` is required for a container. " "This method should return a new iterator object that can iterate over all " @@ -3272,14 +3282,14 @@ msgid "" "of the container." msgstr "" -#: reference/datamodel.rst:2905 +#: reference/datamodel.rst:2911 msgid "" "Called (if present) by the :func:`reversed` built-in to implement reverse " "iteration. It should return a new iterator object that iterates over all " "the objects in the container in reverse order." msgstr "" -#: reference/datamodel.rst:2909 +#: reference/datamodel.rst:2915 msgid "" "If the :meth:`__reversed__` method is not provided, the :func:`reversed` " "built-in will fall back to using the sequence protocol (:meth:`__len__` and :" @@ -3288,7 +3298,7 @@ msgid "" "more efficient than the one provided by :func:`reversed`." msgstr "" -#: reference/datamodel.rst:2916 +#: reference/datamodel.rst:2922 msgid "" "The membership test operators (:keyword:`in` and :keyword:`not in`) are " "normally implemented as an iteration through a container. However, container " @@ -3296,14 +3306,14 @@ msgid "" "implementation, which also does not require the object be iterable." msgstr "" -#: reference/datamodel.rst:2923 +#: reference/datamodel.rst:2929 msgid "" "Called to implement membership test operators. Should return true if *item* " "is in *self*, false otherwise. For mapping objects, this should consider " "the keys of the mapping rather than the values or the key-item pairs." msgstr "" -#: reference/datamodel.rst:2927 +#: reference/datamodel.rst:2933 msgid "" "For objects that don't define :meth:`__contains__`, the membership test " "first tries iteration via :meth:`__iter__`, then the old sequence iteration " @@ -3311,11 +3321,11 @@ msgid "" "reference `." msgstr "" -#: reference/datamodel.rst:2936 +#: reference/datamodel.rst:2942 msgid "Emulating numeric types" msgstr "" -#: reference/datamodel.rst:2938 +#: reference/datamodel.rst:2944 msgid "" "The following methods can be defined to emulate numeric objects. Methods " "corresponding to operations that are not supported by the particular kind of " @@ -3323,7 +3333,7 @@ msgid "" "should be left undefined." msgstr "" -#: reference/datamodel.rst:2964 +#: reference/datamodel.rst:2970 msgid "" "These methods are called to implement the binary arithmetic operations " "(``+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:" @@ -3337,13 +3347,13 @@ msgid "" "function is to be supported." msgstr "" -#: reference/datamodel.rst:2975 +#: reference/datamodel.rst:2981 msgid "" "If one of those methods does not support the operation with the supplied " "arguments, it should return :data:`NotImplemented`." msgstr "" -#: reference/datamodel.rst:2998 +#: reference/datamodel.rst:3004 msgid "" "These methods are called to implement the binary arithmetic operations " "(``+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:" @@ -3356,13 +3366,13 @@ msgid "" "`NotImplemented`." msgstr "" -#: reference/datamodel.rst:3010 +#: reference/datamodel.rst:3016 msgid "" "Note that ternary :func:`pow` will not try calling :meth:`__rpow__` (the " "coercion rules would become too complicated)." msgstr "" -#: reference/datamodel.rst:3015 +#: reference/datamodel.rst:3021 msgid "" "If the right operand's type is a subclass of the left operand's type and " "that subclass provides a different implementation of the reflected method " @@ -3371,7 +3381,7 @@ msgid "" "ancestors' operations." msgstr "" -#: reference/datamodel.rst:3036 +#: reference/datamodel.rst:3042 msgid "" "These methods are called to implement the augmented arithmetic assignments " "(``+=``, ``-=``, ``*=``, ``@=``, ``/=``, ``//=``, ``%=``, ``**=``, ``<<=``, " @@ -3389,19 +3399,19 @@ msgid "" "data model." msgstr "" -#: reference/datamodel.rst:3059 +#: reference/datamodel.rst:3065 msgid "" "Called to implement the unary arithmetic operations (``-``, ``+``, :func:" "`abs` and ``~``)." msgstr "" -#: reference/datamodel.rst:3072 +#: reference/datamodel.rst:3078 msgid "" "Called to implement the built-in functions :func:`complex`, :func:`int` and :" "func:`float`. Should return a value of the appropriate type." msgstr "" -#: reference/datamodel.rst:3079 +#: reference/datamodel.rst:3085 msgid "" "Called to implement :func:`operator.index`, and whenever Python needs to " "losslessly convert the numeric object to an integer object (such as in " @@ -3410,14 +3420,14 @@ msgid "" "integer type. Must return an integer." msgstr "" -#: reference/datamodel.rst:3085 +#: reference/datamodel.rst:3091 msgid "" "If :meth:`__int__`, :meth:`__float__` and :meth:`__complex__` are not " "defined then corresponding built-in functions :func:`int`, :func:`float` " "and :func:`complex` fall back to :meth:`__index__`." msgstr "" -#: reference/datamodel.rst:3097 +#: reference/datamodel.rst:3103 msgid "" "Called to implement the built-in function :func:`round` and :mod:`math` " "functions :func:`~math.trunc`, :func:`~math.floor` and :func:`~math.ceil`. " @@ -3426,21 +3436,21 @@ msgid "" "(typically an :class:`int`)." msgstr "" -#: reference/datamodel.rst:3103 +#: reference/datamodel.rst:3109 msgid "" "The built-in function :func:`int` falls back to :meth:`__trunc__` if " "neither :meth:`__int__` nor :meth:`__index__` is defined." msgstr "" -#: reference/datamodel.rst:3106 +#: reference/datamodel.rst:3112 msgid "The delegation of :func:`int` to :meth:`__trunc__` is deprecated." msgstr "" -#: reference/datamodel.rst:3113 +#: reference/datamodel.rst:3119 msgid "With Statement Context Managers" msgstr "" -#: reference/datamodel.rst:3115 +#: reference/datamodel.rst:3121 msgid "" "A :dfn:`context manager` is an object that defines the runtime context to be " "established when executing a :keyword:`with` statement. The context manager " @@ -3450,32 +3460,32 @@ msgid "" "can also be used by directly invoking their methods." msgstr "" -#: reference/datamodel.rst:3126 +#: reference/datamodel.rst:3132 msgid "" "Typical uses of context managers include saving and restoring various kinds " "of global state, locking and unlocking resources, closing opened files, etc." msgstr "" -#: reference/datamodel.rst:3129 +#: reference/datamodel.rst:3135 msgid "" "For more information on context managers, see :ref:`typecontextmanager`." msgstr "" -#: reference/datamodel.rst:3134 +#: reference/datamodel.rst:3140 msgid "" "Enter the runtime context related to this object. The :keyword:`with` " "statement will bind this method's return value to the target(s) specified in " "the :keyword:`!as` clause of the statement, if any." msgstr "" -#: reference/datamodel.rst:3141 +#: reference/datamodel.rst:3147 msgid "" "Exit the runtime context related to this object. The parameters describe the " "exception that caused the context to be exited. If the context was exited " "without an exception, all three arguments will be :const:`None`." msgstr "" -#: reference/datamodel.rst:3145 +#: reference/datamodel.rst:3151 msgid "" "If an exception is supplied, and the method wishes to suppress the exception " "(i.e., prevent it from being propagated), it should return a true value. " @@ -3483,27 +3493,27 @@ msgid "" "method." msgstr "" -#: reference/datamodel.rst:3149 +#: reference/datamodel.rst:3155 msgid "" "Note that :meth:`~object.__exit__` methods should not reraise the passed-in " "exception; this is the caller's responsibility." msgstr "" -#: reference/datamodel.rst:3156 +#: reference/datamodel.rst:3162 msgid ":pep:`343` - The \"with\" statement" msgstr "" -#: reference/datamodel.rst:3156 +#: reference/datamodel.rst:3162 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: reference/datamodel.rst:3163 +#: reference/datamodel.rst:3169 msgid "Customizing positional arguments in class pattern matching" msgstr "" -#: reference/datamodel.rst:3165 +#: reference/datamodel.rst:3171 msgid "" "When using a class name in a pattern, positional arguments in the pattern " "are not allowed by default, i.e. ``case MyClass(x, y)`` is typically invalid " @@ -3511,7 +3521,7 @@ msgid "" "pattern, the class needs to define a *__match_args__* attribute." msgstr "" -#: reference/datamodel.rst:3172 +#: reference/datamodel.rst:3178 msgid "" "This class variable can be assigned a tuple of strings. When this class is " "used in a class pattern with positional arguments, each positional argument " @@ -3520,7 +3530,7 @@ msgid "" "to setting it to ``()``." msgstr "" -#: reference/datamodel.rst:3178 +#: reference/datamodel.rst:3184 msgid "" "For example, if ``MyClass.__match_args__`` is ``(\"left\", \"center\", " "\"right\")`` that means that ``case MyClass(x, y)`` is equivalent to ``case " @@ -3530,19 +3540,19 @@ msgid "" "exc:`TypeError`." msgstr "" -#: reference/datamodel.rst:3188 +#: reference/datamodel.rst:3194 msgid ":pep:`634` - Structural Pattern Matching" msgstr "" -#: reference/datamodel.rst:3189 +#: reference/datamodel.rst:3195 msgid "The specification for the Python ``match`` statement." msgstr "" -#: reference/datamodel.rst:3195 +#: reference/datamodel.rst:3201 msgid "Emulating buffer types" msgstr "" -#: reference/datamodel.rst:3197 +#: reference/datamodel.rst:3203 msgid "" "The :ref:`buffer protocol ` provides a way for Python objects " "to expose efficient access to a low-level memory array. This protocol is " @@ -3550,13 +3560,13 @@ msgid "" "and third-party libraries may define additional buffer types." msgstr "" -#: reference/datamodel.rst:3202 +#: reference/datamodel.rst:3208 msgid "" "While buffer types are usually implemented in C, it is also possible to " "implement the protocol in Python." msgstr "" -#: reference/datamodel.rst:3207 +#: reference/datamodel.rst:3213 msgid "" "Called when a buffer is requested from *self* (for example, by the :class:" "`memoryview` constructor). The *flags* argument is an integer representing " @@ -3566,7 +3576,7 @@ msgid "" "`memoryview` object." msgstr "" -#: reference/datamodel.rst:3216 +#: reference/datamodel.rst:3222 msgid "" "Called when a buffer is no longer needed. The *buffer* argument is a :class:" "`memoryview` object that was previously returned by :meth:`~object." @@ -3575,28 +3585,28 @@ msgid "" "to perform any cleanup are not required to implement this method." msgstr "" -#: reference/datamodel.rst:3228 +#: reference/datamodel.rst:3234 msgid ":pep:`688` - Making the buffer protocol accessible in Python" msgstr "" -#: reference/datamodel.rst:3228 +#: reference/datamodel.rst:3234 msgid "" "Introduces the Python ``__buffer__`` and ``__release_buffer__`` methods." msgstr "" -#: reference/datamodel.rst:3230 +#: reference/datamodel.rst:3236 msgid ":class:`collections.abc.Buffer`" msgstr "" -#: reference/datamodel.rst:3231 +#: reference/datamodel.rst:3237 msgid "ABC for buffer types." msgstr "" -#: reference/datamodel.rst:3236 +#: reference/datamodel.rst:3242 msgid "Special method lookup" msgstr "" -#: reference/datamodel.rst:3238 +#: reference/datamodel.rst:3244 msgid "" "For custom classes, implicit invocations of special methods are only " "guaranteed to work correctly if defined on an object's type, not in the " @@ -3604,7 +3614,7 @@ msgid "" "following code raises an exception::" msgstr "" -#: reference/datamodel.rst:3253 +#: reference/datamodel.rst:3259 msgid "" "The rationale behind this behaviour lies with a number of special methods " "such as :meth:`~object.__hash__` and :meth:`~object.__repr__` that are " @@ -3613,21 +3623,21 @@ msgid "" "invoked on the type object itself::" msgstr "" -#: reference/datamodel.rst:3267 +#: reference/datamodel.rst:3273 msgid "" "Incorrectly attempting to invoke an unbound method of a class in this way is " "sometimes referred to as 'metaclass confusion', and is avoided by bypassing " "the instance when looking up special methods::" msgstr "" -#: reference/datamodel.rst:3276 +#: reference/datamodel.rst:3282 msgid "" "In addition to bypassing any instance attributes in the interest of " "correctness, implicit special method lookup generally also bypasses the :" "meth:`~object.__getattribute__` method even of the object's metaclass::" msgstr "" -#: reference/datamodel.rst:3302 +#: reference/datamodel.rst:3308 msgid "" "Bypassing the :meth:`~object.__getattribute__` machinery in this fashion " "provides significant scope for speed optimisations within the interpreter, " @@ -3636,36 +3646,36 @@ msgid "" "consistently invoked by the interpreter)." msgstr "" -#: reference/datamodel.rst:3313 +#: reference/datamodel.rst:3319 msgid "Coroutines" msgstr "" -#: reference/datamodel.rst:3317 +#: reference/datamodel.rst:3323 msgid "Awaitable Objects" msgstr "" -#: reference/datamodel.rst:3319 +#: reference/datamodel.rst:3325 msgid "" "An :term:`awaitable` object generally implements an :meth:`~object." "__await__` method. :term:`Coroutine objects ` returned from :" "keyword:`async def` functions are awaitable." msgstr "" -#: reference/datamodel.rst:3325 +#: reference/datamodel.rst:3331 msgid "" "The :term:`generator iterator` objects returned from generators decorated " "with :func:`types.coroutine` are also awaitable, but they do not implement :" "meth:`~object.__await__`." msgstr "" -#: reference/datamodel.rst:3331 +#: reference/datamodel.rst:3337 msgid "" "Must return an :term:`iterator`. Should be used to implement :term:" "`awaitable` objects. For instance, :class:`asyncio.Future` implements this " "method to be compatible with the :keyword:`await` expression." msgstr "" -#: reference/datamodel.rst:3337 +#: reference/datamodel.rst:3343 msgid "" "The language doesn't place any restriction on the type or value of the " "objects yielded by the iterator returned by ``__await__``, as this is " @@ -3673,15 +3683,15 @@ msgid "" "g. :mod:`asyncio`) that will be managing the :term:`awaitable` object." msgstr "" -#: reference/datamodel.rst:3345 +#: reference/datamodel.rst:3351 msgid ":pep:`492` for additional information about awaitable objects." msgstr "" -#: reference/datamodel.rst:3351 +#: reference/datamodel.rst:3357 msgid "Coroutine Objects" msgstr "" -#: reference/datamodel.rst:3353 +#: reference/datamodel.rst:3359 msgid "" ":term:`Coroutine objects ` are :term:`awaitable` objects. A " "coroutine's execution can be controlled by calling :meth:`~object.__await__` " @@ -3692,18 +3702,18 @@ msgid "" "should not directly raise unhandled :exc:`StopIteration` exceptions." msgstr "" -#: reference/datamodel.rst:3361 +#: reference/datamodel.rst:3367 msgid "" "Coroutines also have the methods listed below, which are analogous to those " "of generators (see :ref:`generator-methods`). However, unlike generators, " "coroutines do not directly support iteration." msgstr "" -#: reference/datamodel.rst:3365 +#: reference/datamodel.rst:3371 msgid "It is a :exc:`RuntimeError` to await on a coroutine more than once." msgstr "" -#: reference/datamodel.rst:3371 +#: reference/datamodel.rst:3377 msgid "" "Starts or resumes execution of the coroutine. If *value* is ``None``, this " "is equivalent to advancing the iterator returned by :meth:`~object." @@ -3714,7 +3724,7 @@ msgid "" "value, described above." msgstr "" -#: reference/datamodel.rst:3382 +#: reference/datamodel.rst:3388 msgid "" "Raises the specified exception in the coroutine. This method delegates to " "the :meth:`~generator.throw` method of the iterator that caused the " @@ -3725,13 +3735,13 @@ msgid "" "not caught in the coroutine, it propagates back to the caller." msgstr "" -#: reference/datamodel.rst:3393 +#: reference/datamodel.rst:3399 msgid "" "The second signature \\(type\\[, value\\[, traceback\\]\\]\\) is deprecated " "and may be removed in a future version of Python." msgstr "" -#: reference/datamodel.rst:3398 +#: reference/datamodel.rst:3404 msgid "" "Causes the coroutine to clean itself up and exit. If the coroutine is " "suspended, this method first delegates to the :meth:`~generator.close` " @@ -3741,99 +3751,99 @@ msgid "" "is marked as having finished executing, even if it was never started." msgstr "" -#: reference/datamodel.rst:3406 +#: reference/datamodel.rst:3412 msgid "" "Coroutine objects are automatically closed using the above process when they " "are about to be destroyed." msgstr "" -#: reference/datamodel.rst:3412 +#: reference/datamodel.rst:3418 msgid "Asynchronous Iterators" msgstr "" -#: reference/datamodel.rst:3414 +#: reference/datamodel.rst:3420 msgid "" "An *asynchronous iterator* can call asynchronous code in its ``__anext__`` " "method." msgstr "" -#: reference/datamodel.rst:3417 +#: reference/datamodel.rst:3423 msgid "" "Asynchronous iterators can be used in an :keyword:`async for` statement." msgstr "" -#: reference/datamodel.rst:3421 +#: reference/datamodel.rst:3427 msgid "Must return an *asynchronous iterator* object." msgstr "" -#: reference/datamodel.rst:3425 +#: reference/datamodel.rst:3431 msgid "" "Must return an *awaitable* resulting in a next value of the iterator. " "Should raise a :exc:`StopAsyncIteration` error when the iteration is over." msgstr "" -#: reference/datamodel.rst:3428 +#: reference/datamodel.rst:3434 msgid "An example of an asynchronous iterable object::" msgstr "" -#: reference/datamodel.rst:3445 +#: reference/datamodel.rst:3451 msgid "" "Prior to Python 3.7, :meth:`~object.__aiter__` could return an *awaitable* " "that would resolve to an :term:`asynchronous iterator `." msgstr "" -#: reference/datamodel.rst:3450 +#: reference/datamodel.rst:3456 msgid "" "Starting with Python 3.7, :meth:`~object.__aiter__` must return an " "asynchronous iterator object. Returning anything else will result in a :exc:" "`TypeError` error." msgstr "" -#: reference/datamodel.rst:3458 +#: reference/datamodel.rst:3464 msgid "Asynchronous Context Managers" msgstr "" -#: reference/datamodel.rst:3460 +#: reference/datamodel.rst:3466 msgid "" "An *asynchronous context manager* is a *context manager* that is able to " "suspend execution in its ``__aenter__`` and ``__aexit__`` methods." msgstr "" -#: reference/datamodel.rst:3463 +#: reference/datamodel.rst:3469 msgid "" "Asynchronous context managers can be used in an :keyword:`async with` " "statement." msgstr "" -#: reference/datamodel.rst:3467 +#: reference/datamodel.rst:3473 msgid "" "Semantically similar to :meth:`~object.__enter__`, the only difference being " "that it must return an *awaitable*." msgstr "" -#: reference/datamodel.rst:3472 +#: reference/datamodel.rst:3478 msgid "" "Semantically similar to :meth:`~object.__exit__`, the only difference being " "that it must return an *awaitable*." msgstr "" -#: reference/datamodel.rst:3475 +#: reference/datamodel.rst:3481 msgid "An example of an asynchronous context manager class::" msgstr "" -#: reference/datamodel.rst:3488 +#: reference/datamodel.rst:3494 msgid "Footnotes" msgstr "" -#: reference/datamodel.rst:3489 +#: reference/datamodel.rst:3495 msgid "" "It *is* possible in some cases to change an object's type, under certain " "controlled conditions. It generally isn't a good idea though, since it can " "lead to some very strange behaviour if it is handled incorrectly." msgstr "" -#: reference/datamodel.rst:3493 +#: reference/datamodel.rst:3499 msgid "" "The :meth:`~object.__hash__`, :meth:`~object.__iter__`, :meth:`~object." "__reversed__`, and :meth:`~object.__contains__` methods have special " @@ -3841,7 +3851,7 @@ msgid "" "by relying on the behavior that ``None`` is not callable." msgstr "" -#: reference/datamodel.rst:3499 +#: reference/datamodel.rst:3505 msgid "" "\"Does not support\" here means that the class has no such method, or the " "method returns :data:`NotImplemented`. Do not set the method to ``None`` if " @@ -3849,7 +3859,7 @@ msgid "" "instead have the opposite effect of explicitly *blocking* such fallback." msgstr "" -#: reference/datamodel.rst:3505 +#: reference/datamodel.rst:3511 msgid "" "For operands of the same type, it is assumed that if the non-reflected " "method -- such as :meth:`~object.__add__` -- fails then the overall " @@ -3858,13 +3868,13 @@ msgstr "" #: reference/datamodel.rst:148 reference/datamodel.rst:180 #: reference/datamodel.rst:225 reference/datamodel.rst:261 -#: reference/datamodel.rst:292 reference/datamodel.rst:356 -#: reference/datamodel.rst:402 reference/datamodel.rst:440 -#: reference/datamodel.rst:459 reference/datamodel.rst:512 -#: reference/datamodel.rst:654 reference/datamodel.rst:823 -#: reference/datamodel.rst:938 reference/datamodel.rst:1034 -#: reference/datamodel.rst:1200 reference/datamodel.rst:1407 -#: reference/datamodel.rst:2831 +#: reference/datamodel.rst:292 reference/datamodel.rst:359 +#: reference/datamodel.rst:405 reference/datamodel.rst:443 +#: reference/datamodel.rst:462 reference/datamodel.rst:515 +#: reference/datamodel.rst:657 reference/datamodel.rst:826 +#: reference/datamodel.rst:941 reference/datamodel.rst:1037 +#: reference/datamodel.rst:1203 reference/datamodel.rst:1410 +#: reference/datamodel.rst:2837 msgid "object" msgstr "" @@ -3872,11 +3882,11 @@ msgstr "" msgid "data" msgstr "" -#: reference/datamodel.rst:292 reference/datamodel.rst:420 -#: reference/datamodel.rst:799 reference/datamodel.rst:1490 -#: reference/datamodel.rst:1735 reference/datamodel.rst:2372 -#: reference/datamodel.rst:2959 reference/datamodel.rst:3008 -#: reference/datamodel.rst:3067 reference/datamodel.rst:3095 +#: reference/datamodel.rst:292 reference/datamodel.rst:423 +#: reference/datamodel.rst:802 reference/datamodel.rst:1493 +#: reference/datamodel.rst:1738 reference/datamodel.rst:2378 +#: reference/datamodel.rst:2965 reference/datamodel.rst:3014 +#: reference/datamodel.rst:3073 reference/datamodel.rst:3101 msgid "built-in function" msgstr "" @@ -3884,7 +3894,7 @@ msgstr "" msgid "id" msgstr "" -#: reference/datamodel.rst:122 reference/datamodel.rst:2372 +#: reference/datamodel.rst:122 reference/datamodel.rst:2378 msgid "type" msgstr "" @@ -3920,7 +3930,7 @@ msgstr "" msgid "unreachable object" msgstr "" -#: reference/datamodel.rst:938 +#: reference/datamodel.rst:941 msgid "container" msgstr "" @@ -3932,21 +3942,21 @@ msgstr "" msgid "extension" msgstr "" -#: reference/datamodel.rst:393 reference/datamodel.rst:495 -#: reference/datamodel.rst:876 reference/datamodel.rst:1053 +#: reference/datamodel.rst:396 reference/datamodel.rst:498 +#: reference/datamodel.rst:879 reference/datamodel.rst:1056 msgid "module" msgstr "" -#: reference/datamodel.rst:261 reference/datamodel.rst:799 +#: reference/datamodel.rst:261 reference/datamodel.rst:802 msgid "C" msgstr "" -#: reference/datamodel.rst:261 reference/datamodel.rst:799 +#: reference/datamodel.rst:261 reference/datamodel.rst:802 msgid "language" msgstr "" -#: reference/datamodel.rst:938 reference/datamodel.rst:1007 -#: reference/datamodel.rst:1027 +#: reference/datamodel.rst:941 reference/datamodel.rst:1010 +#: reference/datamodel.rst:1030 msgid "attribute" msgstr "" @@ -3966,11 +3976,11 @@ msgstr "" msgid "ellipsis literal" msgstr "" -#: reference/datamodel.rst:1034 +#: reference/datamodel.rst:1037 msgid "numeric" msgstr "" -#: reference/datamodel.rst:231 reference/datamodel.rst:336 +#: reference/datamodel.rst:231 reference/datamodel.rst:339 msgid "integer" msgstr "" @@ -4002,15 +4012,15 @@ msgstr "" msgid "Java" msgstr "" -#: reference/datamodel.rst:3067 +#: reference/datamodel.rst:3073 msgid "complex" msgstr "" -#: reference/datamodel.rst:420 reference/datamodel.rst:2801 +#: reference/datamodel.rst:423 reference/datamodel.rst:2807 msgid "len" msgstr "" -#: reference/datamodel.rst:1034 +#: reference/datamodel.rst:1037 msgid "sequence" msgstr "" @@ -4022,757 +4032,757 @@ msgstr "" msgid "item selection" msgstr "" -#: reference/datamodel.rst:381 reference/datamodel.rst:459 +#: reference/datamodel.rst:384 reference/datamodel.rst:462 msgid "subscription" msgstr "" -#: reference/datamodel.rst:381 +#: reference/datamodel.rst:384 msgid "slicing" msgstr "" -#: reference/datamodel.rst:321 +#: reference/datamodel.rst:324 msgid "immutable sequence" msgstr "" -#: reference/datamodel.rst:321 +#: reference/datamodel.rst:324 msgid "immutable" msgstr "" -#: reference/datamodel.rst:1705 reference/datamodel.rst:1735 +#: reference/datamodel.rst:1708 reference/datamodel.rst:1738 msgid "string" msgstr "" -#: reference/datamodel.rst:332 +#: reference/datamodel.rst:335 msgid "immutable sequences" msgstr "" -#: reference/datamodel.rst:336 +#: reference/datamodel.rst:339 msgid "chr" msgstr "" -#: reference/datamodel.rst:336 +#: reference/datamodel.rst:339 msgid "ord" msgstr "" -#: reference/datamodel.rst:336 +#: reference/datamodel.rst:339 msgid "character" msgstr "" -#: reference/datamodel.rst:336 +#: reference/datamodel.rst:339 msgid "Unicode" msgstr "" -#: reference/datamodel.rst:356 +#: reference/datamodel.rst:359 msgid "tuple" msgstr "" -#: reference/datamodel.rst:356 +#: reference/datamodel.rst:359 msgid "singleton" msgstr "" -#: reference/datamodel.rst:356 +#: reference/datamodel.rst:359 msgid "empty" msgstr "" -#: reference/datamodel.rst:1730 +#: reference/datamodel.rst:1733 msgid "bytes" msgstr "" -#: reference/datamodel.rst:369 +#: reference/datamodel.rst:372 msgid "byte" msgstr "" -#: reference/datamodel.rst:381 +#: reference/datamodel.rst:384 msgid "mutable sequence" msgstr "" -#: reference/datamodel.rst:381 +#: reference/datamodel.rst:384 msgid "mutable" msgstr "" -#: reference/datamodel.rst:956 reference/datamodel.rst:1027 +#: reference/datamodel.rst:959 reference/datamodel.rst:1030 msgid "assignment" msgstr "" -#: reference/datamodel.rst:856 reference/datamodel.rst:1626 -#: reference/datamodel.rst:3122 +#: reference/datamodel.rst:859 reference/datamodel.rst:1629 +#: reference/datamodel.rst:3128 msgid "statement" msgstr "" -#: reference/datamodel.rst:393 +#: reference/datamodel.rst:396 msgid "array" msgstr "" -#: reference/datamodel.rst:394 +#: reference/datamodel.rst:397 msgid "collections" msgstr "" -#: reference/datamodel.rst:402 +#: reference/datamodel.rst:405 msgid "list" msgstr "" -#: reference/datamodel.rst:409 +#: reference/datamodel.rst:412 msgid "bytearray" msgstr "" -#: reference/datamodel.rst:420 +#: reference/datamodel.rst:423 msgid "set type" msgstr "" -#: reference/datamodel.rst:440 +#: reference/datamodel.rst:443 msgid "set" msgstr "" -#: reference/datamodel.rst:448 +#: reference/datamodel.rst:451 msgid "frozenset" msgstr "" -#: reference/datamodel.rst:1034 +#: reference/datamodel.rst:1037 msgid "mapping" msgstr "" -#: reference/datamodel.rst:938 reference/datamodel.rst:1816 +#: reference/datamodel.rst:941 reference/datamodel.rst:1822 msgid "dictionary" msgstr "" -#: reference/datamodel.rst:495 +#: reference/datamodel.rst:498 msgid "dbm.ndbm" msgstr "" -#: reference/datamodel.rst:495 +#: reference/datamodel.rst:498 msgid "dbm.gnu" msgstr "" -#: reference/datamodel.rst:512 +#: reference/datamodel.rst:515 msgid "callable" msgstr "" -#: reference/datamodel.rst:527 reference/datamodel.rst:761 -#: reference/datamodel.rst:799 +#: reference/datamodel.rst:530 reference/datamodel.rst:764 +#: reference/datamodel.rst:802 msgid "function" msgstr "" -#: reference/datamodel.rst:938 reference/datamodel.rst:2753 +#: reference/datamodel.rst:941 reference/datamodel.rst:2759 msgid "call" msgstr "" -#: reference/datamodel.rst:512 +#: reference/datamodel.rst:515 msgid "invocation" msgstr "" -#: reference/datamodel.rst:512 +#: reference/datamodel.rst:515 msgid "argument" msgstr "" -#: reference/datamodel.rst:654 +#: reference/datamodel.rst:657 msgid "user-defined" msgstr "" -#: reference/datamodel.rst:527 +#: reference/datamodel.rst:530 msgid "user-defined function" msgstr "" -#: reference/datamodel.rst:540 +#: reference/datamodel.rst:543 msgid "__closure__ (function attribute)" msgstr "" -#: reference/datamodel.rst:540 +#: reference/datamodel.rst:543 msgid "__globals__ (function attribute)" msgstr "" -#: reference/datamodel.rst:540 +#: reference/datamodel.rst:543 msgid "global" msgstr "" -#: reference/datamodel.rst:876 +#: reference/datamodel.rst:879 msgid "namespace" msgstr "" -#: reference/datamodel.rst:566 +#: reference/datamodel.rst:569 msgid "__doc__ (function attribute)" msgstr "" -#: reference/datamodel.rst:566 +#: reference/datamodel.rst:569 msgid "__name__ (function attribute)" msgstr "" -#: reference/datamodel.rst:566 +#: reference/datamodel.rst:569 msgid "__module__ (function attribute)" msgstr "" -#: reference/datamodel.rst:566 +#: reference/datamodel.rst:569 msgid "__dict__ (function attribute)" msgstr "" -#: reference/datamodel.rst:566 +#: reference/datamodel.rst:569 msgid "__defaults__ (function attribute)" msgstr "" -#: reference/datamodel.rst:566 +#: reference/datamodel.rst:569 msgid "__code__ (function attribute)" msgstr "" -#: reference/datamodel.rst:566 +#: reference/datamodel.rst:569 msgid "__annotations__ (function attribute)" msgstr "" -#: reference/datamodel.rst:566 +#: reference/datamodel.rst:569 msgid "__kwdefaults__ (function attribute)" msgstr "" -#: reference/datamodel.rst:566 +#: reference/datamodel.rst:569 msgid "__type_params__ (function attribute)" msgstr "" -#: reference/datamodel.rst:823 +#: reference/datamodel.rst:826 msgid "method" msgstr "" -#: reference/datamodel.rst:654 +#: reference/datamodel.rst:657 msgid "user-defined method" msgstr "" -#: reference/datamodel.rst:662 +#: reference/datamodel.rst:665 msgid "__func__ (method attribute)" msgstr "" -#: reference/datamodel.rst:662 +#: reference/datamodel.rst:665 msgid "__self__ (method attribute)" msgstr "" -#: reference/datamodel.rst:662 +#: reference/datamodel.rst:665 msgid "__doc__ (method attribute)" msgstr "" -#: reference/datamodel.rst:662 +#: reference/datamodel.rst:665 msgid "__name__ (method attribute)" msgstr "" -#: reference/datamodel.rst:662 +#: reference/datamodel.rst:665 msgid "__module__ (method attribute)" msgstr "" -#: reference/datamodel.rst:1200 +#: reference/datamodel.rst:1203 msgid "generator" msgstr "" -#: reference/datamodel.rst:743 +#: reference/datamodel.rst:746 msgid "iterator" msgstr "" -#: reference/datamodel.rst:3309 +#: reference/datamodel.rst:3315 msgid "coroutine" msgstr "" -#: reference/datamodel.rst:774 +#: reference/datamodel.rst:777 msgid "asynchronous generator" msgstr "" -#: reference/datamodel.rst:774 +#: reference/datamodel.rst:777 msgid "asynchronous iterator" msgstr "" -#: reference/datamodel.rst:823 +#: reference/datamodel.rst:826 msgid "built-in method" msgstr "" -#: reference/datamodel.rst:823 +#: reference/datamodel.rst:826 msgid "built-in" msgstr "" -#: reference/datamodel.rst:856 +#: reference/datamodel.rst:859 msgid "import" msgstr "" -#: reference/datamodel.rst:876 +#: reference/datamodel.rst:879 msgid "__name__ (module attribute)" msgstr "" -#: reference/datamodel.rst:876 +#: reference/datamodel.rst:879 msgid "__doc__ (module attribute)" msgstr "" -#: reference/datamodel.rst:876 +#: reference/datamodel.rst:879 msgid "__file__ (module attribute)" msgstr "" -#: reference/datamodel.rst:876 +#: reference/datamodel.rst:879 msgid "__annotations__ (module attribute)" msgstr "" -#: reference/datamodel.rst:907 +#: reference/datamodel.rst:910 msgid "__dict__ (module attribute)" msgstr "" -#: reference/datamodel.rst:956 reference/datamodel.rst:1609 -#: reference/datamodel.rst:2483 +#: reference/datamodel.rst:959 reference/datamodel.rst:1612 +#: reference/datamodel.rst:2489 msgid "class" msgstr "" -#: reference/datamodel.rst:1007 reference/datamodel.rst:1027 +#: reference/datamodel.rst:1010 reference/datamodel.rst:1030 msgid "class instance" msgstr "" -#: reference/datamodel.rst:1007 reference/datamodel.rst:2753 +#: reference/datamodel.rst:1010 reference/datamodel.rst:2759 msgid "instance" msgstr "" -#: reference/datamodel.rst:961 +#: reference/datamodel.rst:964 msgid "class object" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:968 msgid "__name__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:968 msgid "__module__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:968 msgid "__dict__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:968 msgid "__bases__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:968 msgid "__doc__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:968 msgid "__annotations__ (class attribute)" msgstr "" -#: reference/datamodel.rst:965 +#: reference/datamodel.rst:968 msgid "__type_params__ (class attribute)" msgstr "" -#: reference/datamodel.rst:1042 +#: reference/datamodel.rst:1045 msgid "__dict__ (instance attribute)" msgstr "" -#: reference/datamodel.rst:1042 +#: reference/datamodel.rst:1045 msgid "__class__ (instance attribute)" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "open" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "io" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "popen() (in module os)" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "makefile() (socket method)" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "sys.stdin" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "sys.stdout" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "sys.stderr" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "stdio" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "stdin (in module sys)" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "stdout (in module sys)" msgstr "" -#: reference/datamodel.rst:1053 +#: reference/datamodel.rst:1056 msgid "stderr (in module sys)" msgstr "" -#: reference/datamodel.rst:1082 +#: reference/datamodel.rst:1085 msgid "internal type" msgstr "" -#: reference/datamodel.rst:1082 +#: reference/datamodel.rst:1085 msgid "types, internal" msgstr "" -#: reference/datamodel.rst:1096 +#: reference/datamodel.rst:1099 msgid "bytecode" msgstr "" -#: reference/datamodel.rst:1096 +#: reference/datamodel.rst:1099 msgid "code" msgstr "" -#: reference/datamodel.rst:1096 +#: reference/datamodel.rst:1099 msgid "code object" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_argcount (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_posonlyargcount (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_kwonlyargcount (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_code (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_consts (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_filename (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_firstlineno (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_flags (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_lnotab (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_name (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_names (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_nlocals (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_stacksize (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_varnames (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_cellvars (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_freevars (code object attribute)" msgstr "" -#: reference/datamodel.rst:1107 +#: reference/datamodel.rst:1110 msgid "co_qualname (code object attribute)" msgstr "" -#: reference/datamodel.rst:1218 +#: reference/datamodel.rst:1221 msgid "documentation string" msgstr "" -#: reference/datamodel.rst:1307 +#: reference/datamodel.rst:1310 msgid "frame" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1316 msgid "f_back (frame attribute)" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1316 msgid "f_code (frame attribute)" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1316 msgid "f_globals (frame attribute)" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1316 msgid "f_locals (frame attribute)" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1316 msgid "f_lasti (frame attribute)" msgstr "" -#: reference/datamodel.rst:1313 +#: reference/datamodel.rst:1316 msgid "f_builtins (frame attribute)" msgstr "" -#: reference/datamodel.rst:1352 +#: reference/datamodel.rst:1355 msgid "f_trace (frame attribute)" msgstr "" -#: reference/datamodel.rst:1352 +#: reference/datamodel.rst:1355 msgid "f_trace_lines (frame attribute)" msgstr "" -#: reference/datamodel.rst:1352 +#: reference/datamodel.rst:1355 msgid "f_trace_opcodes (frame attribute)" msgstr "" -#: reference/datamodel.rst:1352 +#: reference/datamodel.rst:1355 msgid "f_lineno (frame attribute)" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "traceback" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "stack" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "trace" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "exception" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "handler" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "execution" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "exc_info (in module sys)" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "last_traceback (in module sys)" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "sys.exc_info" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "sys.exception" msgstr "" -#: reference/datamodel.rst:1407 +#: reference/datamodel.rst:1410 msgid "sys.last_traceback" msgstr "" -#: reference/datamodel.rst:1444 +#: reference/datamodel.rst:1447 msgid "tb_frame (traceback attribute)" msgstr "" -#: reference/datamodel.rst:1444 +#: reference/datamodel.rst:1447 msgid "tb_lineno (traceback attribute)" msgstr "" -#: reference/datamodel.rst:1444 +#: reference/datamodel.rst:1447 msgid "tb_lasti (traceback attribute)" msgstr "" -#: reference/datamodel.rst:1444 +#: reference/datamodel.rst:1447 msgid "try" msgstr "" -#: reference/datamodel.rst:1474 +#: reference/datamodel.rst:1477 msgid "tb_next (traceback attribute)" msgstr "" -#: reference/datamodel.rst:2831 +#: reference/datamodel.rst:2837 msgid "slice" msgstr "" -#: reference/datamodel.rst:1496 +#: reference/datamodel.rst:1499 msgid "start (slice object attribute)" msgstr "" -#: reference/datamodel.rst:1496 +#: reference/datamodel.rst:1499 msgid "stop (slice object attribute)" msgstr "" -#: reference/datamodel.rst:1496 +#: reference/datamodel.rst:1499 msgid "step (slice object attribute)" msgstr "" -#: reference/datamodel.rst:1544 +#: reference/datamodel.rst:1547 msgid "operator" msgstr "" -#: reference/datamodel.rst:1544 +#: reference/datamodel.rst:1547 msgid "overloading" msgstr "" -#: reference/datamodel.rst:1544 +#: reference/datamodel.rst:1547 msgid "__getitem__() (mapping object method)" msgstr "" -#: reference/datamodel.rst:1580 +#: reference/datamodel.rst:1583 msgid "subclassing" msgstr "" -#: reference/datamodel.rst:1580 +#: reference/datamodel.rst:1583 msgid "immutable types" msgstr "" -#: reference/datamodel.rst:1609 +#: reference/datamodel.rst:1612 msgid "constructor" msgstr "" -#: reference/datamodel.rst:1626 +#: reference/datamodel.rst:1629 msgid "destructor" msgstr "" -#: reference/datamodel.rst:1626 +#: reference/datamodel.rst:1629 msgid "finalizer" msgstr "" -#: reference/datamodel.rst:1626 +#: reference/datamodel.rst:1629 msgid "del" msgstr "" -#: reference/datamodel.rst:1688 +#: reference/datamodel.rst:1691 msgid "repr() (built-in function)" msgstr "" -#: reference/datamodel.rst:1688 +#: reference/datamodel.rst:1691 msgid "__repr__() (object method)" msgstr "" -#: reference/datamodel.rst:1705 +#: reference/datamodel.rst:1708 msgid "__str__() (object method)" msgstr "" -#: reference/datamodel.rst:1705 +#: reference/datamodel.rst:1708 msgid "format() (built-in function)" msgstr "" -#: reference/datamodel.rst:1705 +#: reference/datamodel.rst:1708 msgid "print() (built-in function)" msgstr "" -#: reference/datamodel.rst:1735 +#: reference/datamodel.rst:1738 msgid "__format__() (object method)" msgstr "" -#: reference/datamodel.rst:1735 +#: reference/datamodel.rst:1738 msgid "conversion" msgstr "" -#: reference/datamodel.rst:1735 +#: reference/datamodel.rst:1738 msgid "print" msgstr "" -#: reference/datamodel.rst:1774 +#: reference/datamodel.rst:1777 msgid "comparisons" msgstr "" -#: reference/datamodel.rst:1816 +#: reference/datamodel.rst:1822 msgid "hash" msgstr "" -#: reference/datamodel.rst:1897 +#: reference/datamodel.rst:1903 msgid "__len__() (mapping object method)" msgstr "" -#: reference/datamodel.rst:2001 +#: reference/datamodel.rst:2007 msgid "__getattr__ (module attribute)" msgstr "" -#: reference/datamodel.rst:2001 +#: reference/datamodel.rst:2007 msgid "__dir__ (module attribute)" msgstr "" -#: reference/datamodel.rst:2001 +#: reference/datamodel.rst:2007 msgid "__class__ (module attribute)" msgstr "" -#: reference/datamodel.rst:2372 +#: reference/datamodel.rst:2378 msgid "metaclass" msgstr "" -#: reference/datamodel.rst:2372 +#: reference/datamodel.rst:2378 msgid "= (equals)" msgstr "" -#: reference/datamodel.rst:2372 +#: reference/datamodel.rst:2378 msgid "class definition" msgstr "" -#: reference/datamodel.rst:2436 +#: reference/datamodel.rst:2442 msgid "metaclass hint" msgstr "" -#: reference/datamodel.rst:2459 +#: reference/datamodel.rst:2465 msgid "__prepare__ (metaclass method)" msgstr "" -#: reference/datamodel.rst:2483 +#: reference/datamodel.rst:2489 msgid "body" msgstr "" -#: reference/datamodel.rst:2503 +#: reference/datamodel.rst:2509 msgid "__class__ (method cell)" msgstr "" -#: reference/datamodel.rst:2503 +#: reference/datamodel.rst:2509 msgid "__classcell__ (class namespace entry)" msgstr "" -#: reference/datamodel.rst:2801 +#: reference/datamodel.rst:2807 msgid "__bool__() (object method)" msgstr "" -#: reference/datamodel.rst:2994 +#: reference/datamodel.rst:3000 msgid "divmod" msgstr "" -#: reference/datamodel.rst:2994 reference/datamodel.rst:3008 +#: reference/datamodel.rst:3000 reference/datamodel.rst:3014 msgid "pow" msgstr "" -#: reference/datamodel.rst:3057 +#: reference/datamodel.rst:3063 msgid "abs" msgstr "" -#: reference/datamodel.rst:3067 +#: reference/datamodel.rst:3073 msgid "int" msgstr "" -#: reference/datamodel.rst:3067 +#: reference/datamodel.rst:3073 msgid "float" msgstr "" -#: reference/datamodel.rst:3095 +#: reference/datamodel.rst:3101 msgid "round" msgstr "" -#: reference/datamodel.rst:3122 +#: reference/datamodel.rst:3128 msgid "with" msgstr "" -#: reference/datamodel.rst:3122 +#: reference/datamodel.rst:3128 msgid "context manager" msgstr "" diff --git a/reference/lexical_analysis.po b/reference/lexical_analysis.po index 68ea1eafb..125434a42 100644 --- a/reference/lexical_analysis.po +++ b/reference/lexical_analysis.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -114,24 +114,23 @@ msgstr "" #: reference/lexical_analysis.rst:99 msgid "" -"If no encoding declaration is found, the default encoding is UTF-8. In " -"addition, if the first bytes of the file are the UTF-8 byte-order mark " -"(``b'\\xef\\xbb\\xbf'``), the declared file encoding is UTF-8 (this is " -"supported, among others, by Microsoft's :program:`notepad`)." +"If no encoding declaration is found, the default encoding is UTF-8. If the " +"implicit or explicit encoding of a file is UTF-8, an initial UTF-8 byte-" +"order mark (b'\\xef\\xbb\\xbf') is ignored rather than being a syntax error." msgstr "" -#: reference/lexical_analysis.rst:104 +#: reference/lexical_analysis.rst:103 msgid "" "If an encoding is declared, the encoding name must be recognized by Python " "(see :ref:`standard-encodings`). The encoding is used for all lexical " "analysis, including string literals, comments and identifiers." msgstr "" -#: reference/lexical_analysis.rst:113 +#: reference/lexical_analysis.rst:112 msgid "Explicit line joining" msgstr "" -#: reference/lexical_analysis.rst:117 +#: reference/lexical_analysis.rst:116 msgid "" "Two or more physical lines may be joined into logical lines using backslash " "characters (``\\``), as follows: when a physical line ends in a backslash " @@ -140,7 +139,7 @@ msgid "" "following end-of-line character. For example::" msgstr "" -#: reference/lexical_analysis.rst:128 +#: reference/lexical_analysis.rst:127 msgid "" "A line ending in a backslash cannot carry a comment. A backslash does not " "continue a comment. A backslash does not continue a token except for string " @@ -149,17 +148,17 @@ msgid "" "line outside a string literal." msgstr "" -#: reference/lexical_analysis.rst:138 +#: reference/lexical_analysis.rst:137 msgid "Implicit line joining" msgstr "" -#: reference/lexical_analysis.rst:140 +#: reference/lexical_analysis.rst:139 msgid "" "Expressions in parentheses, square brackets or curly braces can be split " "over more than one physical line without using backslashes. For example::" msgstr "" -#: reference/lexical_analysis.rst:148 +#: reference/lexical_analysis.rst:147 msgid "" "Implicitly continued lines can carry comments. The indentation of the " "continuation lines is not important. Blank continuation lines are allowed. " @@ -168,11 +167,11 @@ msgid "" "that case they cannot carry comments." msgstr "" -#: reference/lexical_analysis.rst:158 +#: reference/lexical_analysis.rst:157 msgid "Blank lines" msgstr "" -#: reference/lexical_analysis.rst:162 +#: reference/lexical_analysis.rst:161 msgid "" "A logical line that contains only spaces, tabs, formfeeds and possibly a " "comment, is ignored (i.e., no NEWLINE token is generated). During " @@ -183,18 +182,18 @@ msgid "" "statement." msgstr "" -#: reference/lexical_analysis.rst:173 +#: reference/lexical_analysis.rst:172 msgid "Indentation" msgstr "" -#: reference/lexical_analysis.rst:177 +#: reference/lexical_analysis.rst:176 msgid "" "Leading whitespace (spaces and tabs) at the beginning of a logical line is " "used to compute the indentation level of the line, which in turn is used to " "determine the grouping of statements." msgstr "" -#: reference/lexical_analysis.rst:181 +#: reference/lexical_analysis.rst:180 msgid "" "Tabs are replaced (from left to right) by one to eight spaces such that the " "total number of characters up to and including the replacement is a multiple " @@ -205,14 +204,14 @@ msgid "" "the indentation." msgstr "" -#: reference/lexical_analysis.rst:189 +#: reference/lexical_analysis.rst:188 msgid "" "Indentation is rejected as inconsistent if a source file mixes tabs and " "spaces in a way that makes the meaning dependent on the worth of a tab in " "spaces; a :exc:`TabError` is raised in that case." msgstr "" -#: reference/lexical_analysis.rst:193 +#: reference/lexical_analysis.rst:192 msgid "" "**Cross-platform compatibility note:** because of the nature of text editors " "on non-UNIX platforms, it is unwise to use a mixture of spaces and tabs for " @@ -220,7 +219,7 @@ msgid "" "different platforms may explicitly limit the maximum indentation level." msgstr "" -#: reference/lexical_analysis.rst:198 +#: reference/lexical_analysis.rst:197 msgid "" "A formfeed character may be present at the start of the line; it will be " "ignored for the indentation calculations above. Formfeed characters " @@ -228,13 +227,13 @@ msgid "" "instance, they may reset the space count to zero)." msgstr "" -#: reference/lexical_analysis.rst:205 +#: reference/lexical_analysis.rst:204 msgid "" "The indentation levels of consecutive lines are used to generate INDENT and " "DEDENT tokens, using a stack, as follows." msgstr "" -#: reference/lexical_analysis.rst:208 +#: reference/lexical_analysis.rst:207 msgid "" "Before the first line of the file is read, a single zero is pushed on the " "stack; this will never be popped off again. The numbers pushed on the stack " @@ -248,28 +247,28 @@ msgid "" "number remaining on the stack that is larger than zero." msgstr "" -#: reference/lexical_analysis.rst:219 +#: reference/lexical_analysis.rst:218 msgid "" "Here is an example of a correctly (though confusingly) indented piece of " "Python code::" msgstr "" -#: reference/lexical_analysis.rst:234 +#: reference/lexical_analysis.rst:233 msgid "The following example shows various indentation errors::" msgstr "" -#: reference/lexical_analysis.rst:244 +#: reference/lexical_analysis.rst:243 msgid "" "(Actually, the first three errors are detected by the parser; only the last " "error is found by the lexical analyzer --- the indentation of ``return r`` " "does not match a level popped off the stack.)" msgstr "" -#: reference/lexical_analysis.rst:252 +#: reference/lexical_analysis.rst:251 msgid "Whitespace between tokens" msgstr "" -#: reference/lexical_analysis.rst:254 +#: reference/lexical_analysis.rst:253 msgid "" "Except at the beginning of a logical line or in string literals, the " "whitespace characters space, tab and formfeed can be used interchangeably to " @@ -278,11 +277,11 @@ msgid "" "is one token, but a b is two tokens)." msgstr "" -#: reference/lexical_analysis.rst:264 +#: reference/lexical_analysis.rst:263 msgid "Other tokens" msgstr "" -#: reference/lexical_analysis.rst:266 +#: reference/lexical_analysis.rst:265 msgid "" "Besides NEWLINE, INDENT and DEDENT, the following categories of tokens " "exist: *identifiers*, *keywords*, *literals*, *operators*, and *delimiters*. " @@ -292,24 +291,24 @@ msgid "" "from left to right." msgstr "" -#: reference/lexical_analysis.rst:276 +#: reference/lexical_analysis.rst:275 msgid "Identifiers and keywords" msgstr "" -#: reference/lexical_analysis.rst:280 +#: reference/lexical_analysis.rst:279 msgid "" "Identifiers (also referred to as *names*) are described by the following " "lexical definitions." msgstr "" -#: reference/lexical_analysis.rst:283 +#: reference/lexical_analysis.rst:282 msgid "" "The syntax of identifiers in Python is based on the Unicode standard annex " "UAX-31, with elaboration and changes as defined below; see also :pep:`3131` " "for further details." msgstr "" -#: reference/lexical_analysis.rst:287 +#: reference/lexical_analysis.rst:286 msgid "" "Within the ASCII range (U+0001..U+007F), the valid characters for " "identifiers are the same as in Python 2.x: the uppercase and lowercase " @@ -317,7 +316,7 @@ msgid "" "character, the digits ``0`` through ``9``." msgstr "" -#: reference/lexical_analysis.rst:292 +#: reference/lexical_analysis.rst:291 msgid "" "Python 3.0 introduces additional characters from outside the ASCII range " "(see :pep:`3131`). For these characters, the classification uses the " @@ -325,94 +324,94 @@ msgid "" "`unicodedata` module." msgstr "" -#: reference/lexical_analysis.rst:296 +#: reference/lexical_analysis.rst:295 msgid "Identifiers are unlimited in length. Case is significant." msgstr "" -#: reference/lexical_analysis.rst:305 +#: reference/lexical_analysis.rst:304 msgid "The Unicode category codes mentioned above stand for:" msgstr "" -#: reference/lexical_analysis.rst:307 +#: reference/lexical_analysis.rst:306 msgid "*Lu* - uppercase letters" msgstr "" -#: reference/lexical_analysis.rst:308 +#: reference/lexical_analysis.rst:307 msgid "*Ll* - lowercase letters" msgstr "" -#: reference/lexical_analysis.rst:309 +#: reference/lexical_analysis.rst:308 msgid "*Lt* - titlecase letters" msgstr "" -#: reference/lexical_analysis.rst:310 +#: reference/lexical_analysis.rst:309 msgid "*Lm* - modifier letters" msgstr "" -#: reference/lexical_analysis.rst:311 +#: reference/lexical_analysis.rst:310 msgid "*Lo* - other letters" msgstr "" -#: reference/lexical_analysis.rst:312 +#: reference/lexical_analysis.rst:311 msgid "*Nl* - letter numbers" msgstr "" -#: reference/lexical_analysis.rst:313 +#: reference/lexical_analysis.rst:312 msgid "*Mn* - nonspacing marks" msgstr "" -#: reference/lexical_analysis.rst:314 +#: reference/lexical_analysis.rst:313 msgid "*Mc* - spacing combining marks" msgstr "" -#: reference/lexical_analysis.rst:315 +#: reference/lexical_analysis.rst:314 msgid "*Nd* - decimal numbers" msgstr "" -#: reference/lexical_analysis.rst:316 +#: reference/lexical_analysis.rst:315 msgid "*Pc* - connector punctuations" msgstr "" -#: reference/lexical_analysis.rst:317 +#: reference/lexical_analysis.rst:316 msgid "" "*Other_ID_Start* - explicit list of characters in `PropList.txt `_ to support backwards " "compatibility" msgstr "" -#: reference/lexical_analysis.rst:320 +#: reference/lexical_analysis.rst:319 msgid "*Other_ID_Continue* - likewise" msgstr "" -#: reference/lexical_analysis.rst:322 +#: reference/lexical_analysis.rst:321 msgid "" "All identifiers are converted into the normal form NFKC while parsing; " "comparison of identifiers is based on NFKC." msgstr "" -#: reference/lexical_analysis.rst:325 +#: reference/lexical_analysis.rst:324 msgid "" "A non-normative HTML file listing all valid identifier characters for " "Unicode 15.0.0 can be found at https://www.unicode.org/Public/15.0.0/ucd/" "DerivedCoreProperties.txt" msgstr "" -#: reference/lexical_analysis.rst:333 +#: reference/lexical_analysis.rst:332 msgid "Keywords" msgstr "" -#: reference/lexical_analysis.rst:339 +#: reference/lexical_analysis.rst:338 msgid "" "The following identifiers are used as reserved words, or *keywords* of the " "language, and cannot be used as ordinary identifiers. They must be spelled " "exactly as written here:" msgstr "" -#: reference/lexical_analysis.rst:357 +#: reference/lexical_analysis.rst:356 msgid "Soft Keywords" msgstr "" -#: reference/lexical_analysis.rst:363 +#: reference/lexical_analysis.rst:362 msgid "" "Some identifiers are only reserved under specific contexts. These are known " "as *soft keywords*. The identifiers ``match``, ``case``, ``type`` and ``_`` " @@ -420,82 +419,82 @@ msgid "" "is done at the parser level, not when tokenizing." msgstr "" -#: reference/lexical_analysis.rst:368 +#: reference/lexical_analysis.rst:367 msgid "" "As soft keywords, their use in the grammar is possible while still " "preserving compatibility with existing code that uses these names as " "identifier names." msgstr "" -#: reference/lexical_analysis.rst:372 +#: reference/lexical_analysis.rst:371 msgid "" "``match``, ``case``, and ``_`` are used in the :keyword:`match` statement. " "``type`` is used in the :keyword:`type` statement." msgstr "" -#: reference/lexical_analysis.rst:375 +#: reference/lexical_analysis.rst:374 msgid "``type`` is now a soft keyword." msgstr "" -#: reference/lexical_analysis.rst:384 +#: reference/lexical_analysis.rst:383 msgid "Reserved classes of identifiers" msgstr "" -#: reference/lexical_analysis.rst:386 +#: reference/lexical_analysis.rst:385 msgid "" "Certain classes of identifiers (besides keywords) have special meanings. " "These classes are identified by the patterns of leading and trailing " "underscore characters:" msgstr "" -#: reference/lexical_analysis.rst:391 +#: reference/lexical_analysis.rst:390 msgid "``_*``" msgstr "" -#: reference/lexical_analysis.rst:391 +#: reference/lexical_analysis.rst:390 msgid "Not imported by ``from module import *``." msgstr "" -#: reference/lexical_analysis.rst:412 +#: reference/lexical_analysis.rst:411 msgid "``_``" msgstr "" -#: reference/lexical_analysis.rst:394 +#: reference/lexical_analysis.rst:393 msgid "" "In a ``case`` pattern within a :keyword:`match` statement, ``_`` is a :ref:" "`soft keyword ` that denotes a :ref:`wildcard `." msgstr "" -#: reference/lexical_analysis.rst:398 +#: reference/lexical_analysis.rst:397 msgid "" "Separately, the interactive interpreter makes the result of the last " "evaluation available in the variable ``_``. (It is stored in the :mod:" "`builtins` module, alongside built-in functions like ``print``.)" msgstr "" -#: reference/lexical_analysis.rst:403 +#: reference/lexical_analysis.rst:402 msgid "" "Elsewhere, ``_`` is a regular identifier. It is often used to name " "\"special\" items, but it is not special to Python itself." msgstr "" -#: reference/lexical_analysis.rst:408 +#: reference/lexical_analysis.rst:407 msgid "" "The name ``_`` is often used in conjunction with internationalization; refer " "to the documentation for the :mod:`gettext` module for more information on " "this convention." msgstr "" -#: reference/lexical_analysis.rst:412 +#: reference/lexical_analysis.rst:411 msgid "It is also commonly used for unused variables." msgstr "" -#: reference/lexical_analysis.rst:420 +#: reference/lexical_analysis.rst:419 msgid "``__*__``" msgstr "" -#: reference/lexical_analysis.rst:415 +#: reference/lexical_analysis.rst:414 msgid "" "System-defined names, informally known as \"dunder\" names. These names are " "defined by the interpreter and its implementation (including the standard " @@ -505,11 +504,11 @@ msgid "" "explicitly documented use, is subject to breakage without warning." msgstr "" -#: reference/lexical_analysis.rst:427 +#: reference/lexical_analysis.rst:426 msgid "``__*``" msgstr "" -#: reference/lexical_analysis.rst:423 +#: reference/lexical_analysis.rst:422 msgid "" "Class-private names. Names in this category, when used within the context " "of a class definition, are re-written to use a mangled form to help avoid " @@ -517,23 +516,23 @@ msgid "" "section :ref:`atom-identifiers`." msgstr "" -#: reference/lexical_analysis.rst:432 +#: reference/lexical_analysis.rst:431 msgid "Literals" msgstr "" -#: reference/lexical_analysis.rst:436 +#: reference/lexical_analysis.rst:435 msgid "Literals are notations for constant values of some built-in types." msgstr "" -#: reference/lexical_analysis.rst:447 +#: reference/lexical_analysis.rst:446 msgid "String and Bytes literals" msgstr "" -#: reference/lexical_analysis.rst:449 +#: reference/lexical_analysis.rst:448 msgid "String literals are described by the following lexical definitions:" msgstr "" -#: reference/lexical_analysis.rst:474 +#: reference/lexical_analysis.rst:473 msgid "" "One syntactic restriction not indicated by these productions is that " "whitespace is not allowed between the :token:`~python-grammar:stringprefix` " @@ -543,7 +542,7 @@ msgid "" "`encodings`." msgstr "" -#: reference/lexical_analysis.rst:484 +#: reference/lexical_analysis.rst:483 msgid "" "In plain English: Both types of literals can be enclosed in matching single " "quotes (``'``) or double quotes (``\"``). They can also be enclosed in " @@ -556,7 +555,7 @@ msgid "" "sequences>` below for examples." msgstr "" -#: reference/lexical_analysis.rst:497 +#: reference/lexical_analysis.rst:496 msgid "" "Bytes literals are always prefixed with ``'b'`` or ``'B'``; they produce an " "instance of the :class:`bytes` type instead of the :class:`str` type. They " @@ -564,7 +563,7 @@ msgid "" "greater must be expressed with escapes." msgstr "" -#: reference/lexical_analysis.rst:506 +#: reference/lexical_analysis.rst:505 msgid "" "Both string and bytes literals may optionally be prefixed with a letter " "``'r'`` or ``'R'``; such strings are called :dfn:`raw strings` and treat " @@ -574,20 +573,20 @@ msgid "" "3.x's the ``'ur'`` syntax is not supported." msgstr "" -#: reference/lexical_analysis.rst:513 +#: reference/lexical_analysis.rst:512 msgid "" "The ``'rb'`` prefix of raw bytes literals has been added as a synonym of " "``'br'``." msgstr "" -#: reference/lexical_analysis.rst:517 +#: reference/lexical_analysis.rst:516 msgid "" "Support for the unicode legacy literal (``u'value'``) was reintroduced to " "simplify the maintenance of dual Python 2.x and 3.x codebases. See :pep:" "`414` for more information." msgstr "" -#: reference/lexical_analysis.rst:526 +#: reference/lexical_analysis.rst:524 msgid "" "A string literal with ``'f'`` or ``'F'`` in its prefix is a :dfn:`formatted " "string literal`; see :ref:`f-strings`. The ``'f'`` may be combined with " @@ -595,7 +594,7 @@ msgid "" "are possible, but formatted bytes literals are not." msgstr "" -#: reference/lexical_analysis.rst:531 +#: reference/lexical_analysis.rst:529 msgid "" "In triple-quoted literals, unescaped newlines and quotes are allowed (and " "are retained), except that three unescaped quotes in a row terminate the " @@ -603,243 +602,243 @@ msgid "" "either ``'`` or ``\"``.)" msgstr "" -#: reference/lexical_analysis.rst:554 +#: reference/lexical_analysis.rst:552 msgid "Escape sequences" msgstr "" -#: reference/lexical_analysis.rst:556 +#: reference/lexical_analysis.rst:554 msgid "" "Unless an ``'r'`` or ``'R'`` prefix is present, escape sequences in string " "and bytes literals are interpreted according to rules similar to those used " "by Standard C. The recognized escape sequences are:" msgstr "" -#: reference/lexical_analysis.rst:561 reference/lexical_analysis.rst:594 +#: reference/lexical_analysis.rst:559 reference/lexical_analysis.rst:592 msgid "Escape Sequence" msgstr "" -#: reference/lexical_analysis.rst:561 reference/lexical_analysis.rst:594 +#: reference/lexical_analysis.rst:559 reference/lexical_analysis.rst:592 msgid "Meaning" msgstr "" -#: reference/lexical_analysis.rst:561 reference/lexical_analysis.rst:594 +#: reference/lexical_analysis.rst:559 reference/lexical_analysis.rst:592 msgid "Notes" msgstr "" -#: reference/lexical_analysis.rst:563 +#: reference/lexical_analysis.rst:561 msgid "``\\``\\ " msgstr "" -#: reference/lexical_analysis.rst:563 +#: reference/lexical_analysis.rst:561 msgid "Backslash and newline ignored" msgstr "" -#: reference/lexical_analysis.rst:563 +#: reference/lexical_analysis.rst:561 msgid "\\(1)" msgstr "" -#: reference/lexical_analysis.rst:565 +#: reference/lexical_analysis.rst:563 msgid "``\\\\``" msgstr "" -#: reference/lexical_analysis.rst:565 +#: reference/lexical_analysis.rst:563 msgid "Backslash (``\\``)" msgstr "" -#: reference/lexical_analysis.rst:567 +#: reference/lexical_analysis.rst:565 msgid "``\\'``" msgstr "" -#: reference/lexical_analysis.rst:567 +#: reference/lexical_analysis.rst:565 msgid "Single quote (``'``)" msgstr "" -#: reference/lexical_analysis.rst:569 +#: reference/lexical_analysis.rst:567 msgid "``\\\"``" msgstr "" -#: reference/lexical_analysis.rst:569 +#: reference/lexical_analysis.rst:567 msgid "Double quote (``\"``)" msgstr "" -#: reference/lexical_analysis.rst:571 +#: reference/lexical_analysis.rst:569 msgid "``\\a``" msgstr "" -#: reference/lexical_analysis.rst:571 +#: reference/lexical_analysis.rst:569 msgid "ASCII Bell (BEL)" msgstr "" -#: reference/lexical_analysis.rst:573 +#: reference/lexical_analysis.rst:571 msgid "``\\b``" msgstr "" -#: reference/lexical_analysis.rst:573 +#: reference/lexical_analysis.rst:571 msgid "ASCII Backspace (BS)" msgstr "" -#: reference/lexical_analysis.rst:575 +#: reference/lexical_analysis.rst:573 msgid "``\\f``" msgstr "" -#: reference/lexical_analysis.rst:575 +#: reference/lexical_analysis.rst:573 msgid "ASCII Formfeed (FF)" msgstr "" -#: reference/lexical_analysis.rst:577 +#: reference/lexical_analysis.rst:575 msgid "``\\n``" msgstr "" -#: reference/lexical_analysis.rst:577 +#: reference/lexical_analysis.rst:575 msgid "ASCII Linefeed (LF)" msgstr "" -#: reference/lexical_analysis.rst:579 +#: reference/lexical_analysis.rst:577 msgid "``\\r``" msgstr "" -#: reference/lexical_analysis.rst:579 +#: reference/lexical_analysis.rst:577 msgid "ASCII Carriage Return (CR)" msgstr "" -#: reference/lexical_analysis.rst:581 +#: reference/lexical_analysis.rst:579 msgid "``\\t``" msgstr "" -#: reference/lexical_analysis.rst:581 +#: reference/lexical_analysis.rst:579 msgid "ASCII Horizontal Tab (TAB)" msgstr "" -#: reference/lexical_analysis.rst:583 +#: reference/lexical_analysis.rst:581 msgid "``\\v``" msgstr "" -#: reference/lexical_analysis.rst:583 +#: reference/lexical_analysis.rst:581 msgid "ASCII Vertical Tab (VT)" msgstr "" -#: reference/lexical_analysis.rst:585 +#: reference/lexical_analysis.rst:583 msgid ":samp:`\\\\\\\\{ooo}`" msgstr "" -#: reference/lexical_analysis.rst:585 +#: reference/lexical_analysis.rst:583 msgid "Character with octal value *ooo*" msgstr "" -#: reference/lexical_analysis.rst:585 +#: reference/lexical_analysis.rst:583 msgid "(2,4)" msgstr "" -#: reference/lexical_analysis.rst:588 +#: reference/lexical_analysis.rst:586 msgid ":samp:`\\\\x{hh}`" msgstr "" -#: reference/lexical_analysis.rst:588 +#: reference/lexical_analysis.rst:586 msgid "Character with hex value *hh*" msgstr "" -#: reference/lexical_analysis.rst:588 +#: reference/lexical_analysis.rst:586 msgid "(3,4)" msgstr "" -#: reference/lexical_analysis.rst:591 +#: reference/lexical_analysis.rst:589 msgid "Escape sequences only recognized in string literals are:" msgstr "" -#: reference/lexical_analysis.rst:596 +#: reference/lexical_analysis.rst:594 msgid ":samp:`\\\\N\\\\{{name}\\\\}`" msgstr "" -#: reference/lexical_analysis.rst:596 +#: reference/lexical_analysis.rst:594 msgid "Character named *name* in the Unicode database" msgstr "" -#: reference/lexical_analysis.rst:596 +#: reference/lexical_analysis.rst:594 msgid "\\(5)" msgstr "" -#: reference/lexical_analysis.rst:599 +#: reference/lexical_analysis.rst:597 msgid ":samp:`\\\\u{xxxx}`" msgstr "" -#: reference/lexical_analysis.rst:599 +#: reference/lexical_analysis.rst:597 msgid "Character with 16-bit hex value *xxxx*" msgstr "" -#: reference/lexical_analysis.rst:599 +#: reference/lexical_analysis.rst:597 msgid "\\(6)" msgstr "" -#: reference/lexical_analysis.rst:602 +#: reference/lexical_analysis.rst:600 msgid ":samp:`\\\\U{xxxxxxxx}`" msgstr "" -#: reference/lexical_analysis.rst:602 +#: reference/lexical_analysis.rst:600 msgid "Character with 32-bit hex value *xxxxxxxx*" msgstr "" -#: reference/lexical_analysis.rst:602 +#: reference/lexical_analysis.rst:600 msgid "\\(7)" msgstr "" -#: reference/lexical_analysis.rst:606 +#: reference/lexical_analysis.rst:604 msgid "Notes:" msgstr "" -#: reference/lexical_analysis.rst:609 +#: reference/lexical_analysis.rst:607 msgid "A backslash can be added at the end of a line to ignore the newline::" msgstr "" -#: reference/lexical_analysis.rst:615 +#: reference/lexical_analysis.rst:613 msgid "" "The same result can be achieved using :ref:`triple-quoted strings " "`, or parentheses and :ref:`string literal concatenation `." msgstr "" -#: reference/lexical_analysis.rst:620 +#: reference/lexical_analysis.rst:618 msgid "As in Standard C, up to three octal digits are accepted." msgstr "" -#: reference/lexical_analysis.rst:622 +#: reference/lexical_analysis.rst:620 msgid "" "Octal escapes with value larger than ``0o377`` produce a :exc:" "`DeprecationWarning`." msgstr "" -#: reference/lexical_analysis.rst:626 +#: reference/lexical_analysis.rst:624 msgid "" "Octal escapes with value larger than ``0o377`` produce a :exc:" "`SyntaxWarning`. In a future Python version they will be eventually a :exc:" "`SyntaxError`." msgstr "" -#: reference/lexical_analysis.rst:632 +#: reference/lexical_analysis.rst:630 msgid "Unlike in Standard C, exactly two hex digits are required." msgstr "" -#: reference/lexical_analysis.rst:635 +#: reference/lexical_analysis.rst:633 msgid "" "In a bytes literal, hexadecimal and octal escapes denote the byte with the " "given value. In a string literal, these escapes denote a Unicode character " "with the given value." msgstr "" -#: reference/lexical_analysis.rst:640 +#: reference/lexical_analysis.rst:638 msgid "Support for name aliases [#]_ has been added." msgstr "" -#: reference/lexical_analysis.rst:644 +#: reference/lexical_analysis.rst:642 msgid "Exactly four hex digits are required." msgstr "" -#: reference/lexical_analysis.rst:647 +#: reference/lexical_analysis.rst:645 msgid "" "Any Unicode character can be encoded this way. Exactly eight hex digits are " "required." msgstr "" -#: reference/lexical_analysis.rst:653 +#: reference/lexical_analysis.rst:651 msgid "" "Unlike Standard C, all unrecognized escape sequences are left in the string " "unchanged, i.e., *the backslash is left in the result*. (This behavior is " @@ -849,17 +848,17 @@ msgid "" "category of unrecognized escapes for bytes literals." msgstr "" -#: reference/lexical_analysis.rst:660 +#: reference/lexical_analysis.rst:658 msgid "Unrecognized escape sequences produce a :exc:`DeprecationWarning`." msgstr "" -#: reference/lexical_analysis.rst:663 +#: reference/lexical_analysis.rst:661 msgid "" "Unrecognized escape sequences produce a :exc:`SyntaxWarning`. In a future " "Python version they will be eventually a :exc:`SyntaxError`." msgstr "" -#: reference/lexical_analysis.rst:667 +#: reference/lexical_analysis.rst:665 msgid "" "Even in a raw literal, quotes can be escaped with a backslash, but the " "backslash remains in the result; for example, ``r\"\\\"\"`` is a valid " @@ -872,11 +871,11 @@ msgid "" "continuation." msgstr "" -#: reference/lexical_analysis.rst:680 +#: reference/lexical_analysis.rst:678 msgid "String literal concatenation" msgstr "" -#: reference/lexical_analysis.rst:682 +#: reference/lexical_analysis.rst:680 msgid "" "Multiple adjacent string or bytes literals (delimited by whitespace), " "possibly using different quoting conventions, are allowed, and their meaning " @@ -886,7 +885,7 @@ msgid "" "lines, or even to add comments to parts of strings, for example::" msgstr "" -#: reference/lexical_analysis.rst:693 +#: reference/lexical_analysis.rst:691 msgid "" "Note that this feature is defined at the syntactical level, but implemented " "at compile time. The '+' operator must be used to concatenate string " @@ -896,11 +895,11 @@ msgid "" "with plain string literals." msgstr "" -#: reference/lexical_analysis.rst:716 +#: reference/lexical_analysis.rst:714 msgid "f-strings" msgstr "" -#: reference/lexical_analysis.rst:720 +#: reference/lexical_analysis.rst:718 msgid "" "A :dfn:`formatted string literal` or :dfn:`f-string` is a string literal " "that is prefixed with ``'f'`` or ``'F'``. These strings may contain " @@ -909,14 +908,14 @@ msgid "" "are really expressions evaluated at run time." msgstr "" -#: reference/lexical_analysis.rst:726 +#: reference/lexical_analysis.rst:724 msgid "" "Escape sequences are decoded like in ordinary string literals (except when a " "literal is also marked as a raw string). After decoding, the grammar for " "the contents of the string is:" msgstr "" -#: reference/lexical_analysis.rst:740 +#: reference/lexical_analysis.rst:738 msgid "" "The parts of the string outside curly braces are treated literally, except " "that any doubled curly braces ``'{{'`` or ``'}}'`` are replaced with the " @@ -929,7 +928,7 @@ msgid "" "replacement field ends with a closing curly bracket ``'}'``." msgstr "" -#: reference/lexical_analysis.rst:750 +#: reference/lexical_analysis.rst:748 msgid "" "Expressions in formatted string literals are treated like regular Python " "expressions surrounded by parentheses, with a few exceptions. An empty " @@ -943,20 +942,20 @@ msgid "" "replacement fields must be closed in a different line." msgstr "" -#: reference/lexical_analysis.rst:767 +#: reference/lexical_analysis.rst:765 msgid "" "Prior to Python 3.7, an :keyword:`await` expression and comprehensions " "containing an :keyword:`async for` clause were illegal in the expressions in " "formatted string literals due to a problem with the implementation." msgstr "" -#: reference/lexical_analysis.rst:772 +#: reference/lexical_analysis.rst:770 msgid "" "Prior to Python 3.12, comments were not allowed inside f-string replacement " "fields." msgstr "" -#: reference/lexical_analysis.rst:776 +#: reference/lexical_analysis.rst:774 msgid "" "When the equal sign ``'='`` is provided, the output will have the expression " "text, the ``'='`` and the evaluated value. Spaces after the opening brace " @@ -967,18 +966,18 @@ msgid "" "r'`` is declared." msgstr "" -#: reference/lexical_analysis.rst:784 +#: reference/lexical_analysis.rst:782 msgid "The equal sign ``'='``." msgstr "" -#: reference/lexical_analysis.rst:787 +#: reference/lexical_analysis.rst:785 msgid "" "If a conversion is specified, the result of evaluating the expression is " "converted before formatting. Conversion ``'!s'`` calls :func:`str` on the " "result, ``'!r'`` calls :func:`repr`, and ``'!a'`` calls :func:`ascii`." msgstr "" -#: reference/lexical_analysis.rst:791 +#: reference/lexical_analysis.rst:789 msgid "" "The result is then formatted using the :func:`format` protocol. The format " "specifier is passed to the :meth:`~object.__format__` method of the " @@ -987,7 +986,7 @@ msgid "" "value of the whole string." msgstr "" -#: reference/lexical_analysis.rst:797 +#: reference/lexical_analysis.rst:795 msgid "" "Top-level format specifiers may include nested replacement fields. These " "nested fields may include their own conversion fields and :ref:`format " @@ -996,116 +995,116 @@ msgid "" "as that used by the :meth:`str.format` method." msgstr "" -#: reference/lexical_analysis.rst:803 +#: reference/lexical_analysis.rst:801 msgid "" "Formatted string literals may be concatenated, but replacement fields cannot " "be split across literals." msgstr "" -#: reference/lexical_analysis.rst:806 +#: reference/lexical_analysis.rst:804 msgid "Some examples of formatted string literals::" msgstr "" -#: reference/lexical_analysis.rst:838 +#: reference/lexical_analysis.rst:836 msgid "" "Reusing the outer f-string quoting type inside a replacement field is " "permitted::" msgstr "" -#: reference/lexical_analysis.rst:845 +#: reference/lexical_analysis.rst:843 msgid "" "Prior to Python 3.12, reuse of the same quoting type of the outer f-string " "inside a replacement field was not possible." msgstr "" -#: reference/lexical_analysis.rst:849 +#: reference/lexical_analysis.rst:847 msgid "" "Backslashes are also allowed in replacement fields and are evaluated the " "same way as in any other context::" msgstr "" -#: reference/lexical_analysis.rst:859 +#: reference/lexical_analysis.rst:857 msgid "" "Prior to Python 3.12, backslashes were not permitted inside an f-string " "replacement field." msgstr "" -#: reference/lexical_analysis.rst:863 +#: reference/lexical_analysis.rst:861 msgid "" "Formatted string literals cannot be used as docstrings, even if they do not " "include expressions." msgstr "" -#: reference/lexical_analysis.rst:874 +#: reference/lexical_analysis.rst:872 msgid "" "See also :pep:`498` for the proposal that added formatted string literals, " "and :meth:`str.format`, which uses a related format string mechanism." msgstr "" -#: reference/lexical_analysis.rst:881 +#: reference/lexical_analysis.rst:879 msgid "Numeric literals" msgstr "" -#: reference/lexical_analysis.rst:887 +#: reference/lexical_analysis.rst:885 msgid "" "There are three types of numeric literals: integers, floating point numbers, " "and imaginary numbers. There are no complex literals (complex numbers can " "be formed by adding a real number and an imaginary number)." msgstr "" -#: reference/lexical_analysis.rst:891 +#: reference/lexical_analysis.rst:889 msgid "" "Note that numeric literals do not include a sign; a phrase like ``-1`` is " "actually an expression composed of the unary operator '``-``' and the " "literal ``1``." msgstr "" -#: reference/lexical_analysis.rst:905 +#: reference/lexical_analysis.rst:903 msgid "Integer literals" msgstr "" -#: reference/lexical_analysis.rst:907 +#: reference/lexical_analysis.rst:905 msgid "Integer literals are described by the following lexical definitions:" msgstr "" -#: reference/lexical_analysis.rst:921 +#: reference/lexical_analysis.rst:919 msgid "" "There is no limit for the length of integer literals apart from what can be " "stored in available memory." msgstr "" -#: reference/lexical_analysis.rst:924 +#: reference/lexical_analysis.rst:922 msgid "" "Underscores are ignored for determining the numeric value of the literal. " "They can be used to group digits for enhanced readability. One underscore " "can occur between digits, and after base specifiers like ``0x``." msgstr "" -#: reference/lexical_analysis.rst:928 +#: reference/lexical_analysis.rst:926 msgid "" "Note that leading zeros in a non-zero decimal number are not allowed. This " "is for disambiguation with C-style octal literals, which Python used before " "version 3.0." msgstr "" -#: reference/lexical_analysis.rst:932 +#: reference/lexical_analysis.rst:930 msgid "Some examples of integer literals::" msgstr "" -#: reference/lexical_analysis.rst:938 reference/lexical_analysis.rst:970 +#: reference/lexical_analysis.rst:936 reference/lexical_analysis.rst:968 msgid "Underscores are now allowed for grouping purposes in literals." msgstr "" -#: reference/lexical_analysis.rst:949 +#: reference/lexical_analysis.rst:947 msgid "Floating point literals" msgstr "" -#: reference/lexical_analysis.rst:951 +#: reference/lexical_analysis.rst:949 msgid "" "Floating point literals are described by the following lexical definitions:" msgstr "" -#: reference/lexical_analysis.rst:961 +#: reference/lexical_analysis.rst:959 msgid "" "Note that the integer and exponent parts are always interpreted using radix " "10. For example, ``077e010`` is legal, and denotes the same number as " @@ -1114,19 +1113,19 @@ msgid "" "grouping." msgstr "" -#: reference/lexical_analysis.rst:966 +#: reference/lexical_analysis.rst:964 msgid "Some examples of floating point literals::" msgstr "" -#: reference/lexical_analysis.rst:979 +#: reference/lexical_analysis.rst:977 msgid "Imaginary literals" msgstr "" -#: reference/lexical_analysis.rst:981 +#: reference/lexical_analysis.rst:979 msgid "Imaginary literals are described by the following lexical definitions:" msgstr "" -#: reference/lexical_analysis.rst:986 +#: reference/lexical_analysis.rst:984 msgid "" "An imaginary literal yields a complex number with a real part of 0.0. " "Complex numbers are represented as a pair of floating point numbers and have " @@ -1135,23 +1134,23 @@ msgid "" "Some examples of imaginary literals::" msgstr "" -#: reference/lexical_analysis.rst:998 +#: reference/lexical_analysis.rst:996 msgid "Operators" msgstr "" -#: reference/lexical_analysis.rst:1002 +#: reference/lexical_analysis.rst:1000 msgid "The following tokens are operators:" msgstr "" -#: reference/lexical_analysis.rst:1015 +#: reference/lexical_analysis.rst:1013 msgid "Delimiters" msgstr "" -#: reference/lexical_analysis.rst:1019 +#: reference/lexical_analysis.rst:1017 msgid "The following tokens serve as delimiters in the grammar:" msgstr "" -#: reference/lexical_analysis.rst:1028 +#: reference/lexical_analysis.rst:1026 msgid "" "The period can also occur in floating-point and imaginary literals. A " "sequence of three periods has a special meaning as an ellipsis literal. The " @@ -1159,23 +1158,23 @@ msgid "" "as delimiters, but also perform an operation." msgstr "" -#: reference/lexical_analysis.rst:1033 +#: reference/lexical_analysis.rst:1031 msgid "" "The following printing ASCII characters have special meaning as part of " "other tokens or are otherwise significant to the lexical analyzer:" msgstr "" -#: reference/lexical_analysis.rst:1040 +#: reference/lexical_analysis.rst:1038 msgid "" "The following printing ASCII characters are not used in Python. Their " "occurrence outside string literals and comments is an unconditional error:" msgstr "" -#: reference/lexical_analysis.rst:1049 +#: reference/lexical_analysis.rst:1047 msgid "Footnotes" msgstr "" -#: reference/lexical_analysis.rst:1050 +#: reference/lexical_analysis.rst:1048 msgid "https://www.unicode.org/Public/15.0.0/ucd/NameAliases.txt" msgstr "" @@ -1199,12 +1198,12 @@ msgstr "" msgid "logical line" msgstr "" -#: reference/lexical_analysis.rst:35 reference/lexical_analysis.rst:115 -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:35 reference/lexical_analysis.rst:114 +#: reference/lexical_analysis.rst:533 msgid "physical line" msgstr "" -#: reference/lexical_analysis.rst:35 reference/lexical_analysis.rst:115 +#: reference/lexical_analysis.rst:35 reference/lexical_analysis.rst:114 msgid "line joining" msgstr "" @@ -1236,359 +1235,359 @@ msgstr "" msgid "source encoding declaration" msgstr "" -#: reference/lexical_analysis.rst:115 +#: reference/lexical_analysis.rst:114 msgid "line continuation" msgstr "" -#: reference/lexical_analysis.rst:115 +#: reference/lexical_analysis.rst:114 msgid "backslash character" msgstr "" -#: reference/lexical_analysis.rst:160 +#: reference/lexical_analysis.rst:159 msgid "blank line" msgstr "" -#: reference/lexical_analysis.rst:175 +#: reference/lexical_analysis.rst:174 msgid "indentation" msgstr "" -#: reference/lexical_analysis.rst:175 +#: reference/lexical_analysis.rst:174 msgid "leading whitespace" msgstr "" -#: reference/lexical_analysis.rst:175 +#: reference/lexical_analysis.rst:174 msgid "space" msgstr "" -#: reference/lexical_analysis.rst:175 +#: reference/lexical_analysis.rst:174 msgid "tab" msgstr "" -#: reference/lexical_analysis.rst:175 +#: reference/lexical_analysis.rst:174 msgid "grouping" msgstr "" -#: reference/lexical_analysis.rst:175 +#: reference/lexical_analysis.rst:174 msgid "statement grouping" msgstr "" -#: reference/lexical_analysis.rst:203 +#: reference/lexical_analysis.rst:202 msgid "INDENT token" msgstr "" -#: reference/lexical_analysis.rst:203 +#: reference/lexical_analysis.rst:202 msgid "DEDENT token" msgstr "" -#: reference/lexical_analysis.rst:278 +#: reference/lexical_analysis.rst:277 msgid "identifier" msgstr "" -#: reference/lexical_analysis.rst:278 +#: reference/lexical_analysis.rst:277 msgid "name" msgstr "" -#: reference/lexical_analysis.rst:335 reference/lexical_analysis.rst:359 +#: reference/lexical_analysis.rst:334 reference/lexical_analysis.rst:358 msgid "keyword" msgstr "" -#: reference/lexical_analysis.rst:335 +#: reference/lexical_analysis.rst:334 msgid "reserved word" msgstr "" -#: reference/lexical_analysis.rst:359 +#: reference/lexical_analysis.rst:358 msgid "soft keyword" msgstr "" -#: reference/lexical_analysis.rst:378 +#: reference/lexical_analysis.rst:377 msgid "_, identifiers" msgstr "" -#: reference/lexical_analysis.rst:378 +#: reference/lexical_analysis.rst:377 msgid "__, identifiers" msgstr "" -#: reference/lexical_analysis.rst:434 +#: reference/lexical_analysis.rst:433 msgid "literal" msgstr "" -#: reference/lexical_analysis.rst:434 +#: reference/lexical_analysis.rst:433 msgid "constant" msgstr "" -#: reference/lexical_analysis.rst:439 reference/lexical_analysis.rst:480 +#: reference/lexical_analysis.rst:438 reference/lexical_analysis.rst:479 msgid "string literal" msgstr "" -#: reference/lexical_analysis.rst:439 reference/lexical_analysis.rst:493 +#: reference/lexical_analysis.rst:438 reference/lexical_analysis.rst:492 msgid "bytes literal" msgstr "" -#: reference/lexical_analysis.rst:439 +#: reference/lexical_analysis.rst:438 msgid "ASCII" msgstr "" -#: reference/lexical_analysis.rst:439 +#: reference/lexical_analysis.rst:438 msgid "' (single quote)" msgstr "" -#: reference/lexical_analysis.rst:439 +#: reference/lexical_analysis.rst:438 msgid "\" (double quote)" msgstr "" -#: reference/lexical_analysis.rst:439 +#: reference/lexical_analysis.rst:438 msgid "u'" msgstr "" -#: reference/lexical_analysis.rst:439 +#: reference/lexical_analysis.rst:438 msgid "u\"" msgstr "" -#: reference/lexical_analysis.rst:480 +#: reference/lexical_analysis.rst:479 msgid "triple-quoted string" msgstr "" -#: reference/lexical_analysis.rst:480 +#: reference/lexical_analysis.rst:479 msgid "Unicode Consortium" msgstr "" -#: reference/lexical_analysis.rst:480 +#: reference/lexical_analysis.rst:479 msgid "raw string" msgstr "" -#: reference/lexical_analysis.rst:480 +#: reference/lexical_analysis.rst:479 msgid "\"\"\"" msgstr "" -#: reference/lexical_analysis.rst:480 +#: reference/lexical_analysis.rst:479 msgid "'''" msgstr "" -#: reference/lexical_analysis.rst:493 +#: reference/lexical_analysis.rst:492 msgid "b'" msgstr "" -#: reference/lexical_analysis.rst:493 +#: reference/lexical_analysis.rst:492 msgid "b\"" msgstr "" -#: reference/lexical_analysis.rst:502 +#: reference/lexical_analysis.rst:501 msgid "r'" msgstr "" -#: reference/lexical_analysis.rst:502 +#: reference/lexical_analysis.rst:501 msgid "raw string literal" msgstr "" -#: reference/lexical_analysis.rst:502 +#: reference/lexical_analysis.rst:501 msgid "r\"" msgstr "" -#: reference/lexical_analysis.rst:522 +#: reference/lexical_analysis.rst:520 msgid "f'" msgstr "" -#: reference/lexical_analysis.rst:522 reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:520 reference/lexical_analysis.rst:698 msgid "formatted string literal" msgstr "" -#: reference/lexical_analysis.rst:522 +#: reference/lexical_analysis.rst:520 msgid "f\"" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "escape sequence" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "Standard C" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "C" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\ (backslash)" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\\\" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\a" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\b" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\f" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\n" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\r" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\t" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\v" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\x" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\N" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\u" msgstr "" -#: reference/lexical_analysis.rst:535 +#: reference/lexical_analysis.rst:533 msgid "\\U" msgstr "" -#: reference/lexical_analysis.rst:651 +#: reference/lexical_analysis.rst:649 msgid "unrecognized escape sequence" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "interpolated string literal" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "string" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "formatted literal" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "interpolated literal" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "f-string" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "fstring" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "{} (curly brackets)" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "in formatted string literal" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "! (exclamation)" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid ": (colon)" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "= (equals)" msgstr "" -#: reference/lexical_analysis.rst:700 +#: reference/lexical_analysis.rst:698 msgid "for help in debugging using string literals" msgstr "" -#: reference/lexical_analysis.rst:883 +#: reference/lexical_analysis.rst:881 msgid "number" msgstr "" -#: reference/lexical_analysis.rst:883 +#: reference/lexical_analysis.rst:881 msgid "numeric literal" msgstr "" -#: reference/lexical_analysis.rst:883 reference/lexical_analysis.rst:896 +#: reference/lexical_analysis.rst:881 reference/lexical_analysis.rst:894 msgid "integer literal" msgstr "" -#: reference/lexical_analysis.rst:883 +#: reference/lexical_analysis.rst:881 msgid "floating point literal" msgstr "" -#: reference/lexical_analysis.rst:883 +#: reference/lexical_analysis.rst:881 msgid "hexadecimal literal" msgstr "" -#: reference/lexical_analysis.rst:883 +#: reference/lexical_analysis.rst:881 msgid "octal literal" msgstr "" -#: reference/lexical_analysis.rst:883 +#: reference/lexical_analysis.rst:881 msgid "binary literal" msgstr "" -#: reference/lexical_analysis.rst:883 +#: reference/lexical_analysis.rst:881 msgid "decimal literal" msgstr "" -#: reference/lexical_analysis.rst:883 +#: reference/lexical_analysis.rst:881 msgid "imaginary literal" msgstr "" -#: reference/lexical_analysis.rst:883 +#: reference/lexical_analysis.rst:881 msgid "complex literal" msgstr "" -#: reference/lexical_analysis.rst:896 +#: reference/lexical_analysis.rst:894 msgid "0b" msgstr "" -#: reference/lexical_analysis.rst:896 +#: reference/lexical_analysis.rst:894 msgid "0o" msgstr "" -#: reference/lexical_analysis.rst:896 +#: reference/lexical_analysis.rst:894 msgid "0x" msgstr "" -#: reference/lexical_analysis.rst:896 reference/lexical_analysis.rst:942 +#: reference/lexical_analysis.rst:894 reference/lexical_analysis.rst:940 msgid "_ (underscore)" msgstr "" -#: reference/lexical_analysis.rst:896 reference/lexical_analysis.rst:942 -#: reference/lexical_analysis.rst:974 +#: reference/lexical_analysis.rst:894 reference/lexical_analysis.rst:940 +#: reference/lexical_analysis.rst:972 msgid "in numeric literal" msgstr "" -#: reference/lexical_analysis.rst:942 +#: reference/lexical_analysis.rst:940 msgid ". (dot)" msgstr "" -#: reference/lexical_analysis.rst:942 +#: reference/lexical_analysis.rst:940 msgid "e" msgstr "" -#: reference/lexical_analysis.rst:974 +#: reference/lexical_analysis.rst:972 msgid "j" msgstr "" -#: reference/lexical_analysis.rst:1000 +#: reference/lexical_analysis.rst:998 msgid "operators" msgstr "" -#: reference/lexical_analysis.rst:1017 +#: reference/lexical_analysis.rst:1015 msgid "delimiters" msgstr "" diff --git a/reference/simple_stmts.po b/reference/simple_stmts.po index b57726531..0dc8400d3 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-01-01 00:16+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -626,11 +626,11 @@ msgstr "" #: reference/simple_stmts.rst:667 msgid "" -"The :attr:`~BaseException.__suppress_context__` attribute to suppress " +"Added the :attr:`~BaseException.__suppress_context__` attribute to suppress " "automatic display of the exception context." msgstr "" -#: reference/simple_stmts.rst:671 +#: reference/simple_stmts.rst:670 msgid "" "If the traceback of the active exception is modified in an :keyword:`except` " "clause, a subsequent ``raise`` statement re-raises the exception with the " @@ -638,41 +638,41 @@ msgid "" "traceback it had when it was caught." msgstr "" -#: reference/simple_stmts.rst:680 +#: reference/simple_stmts.rst:679 msgid "The :keyword:`!break` statement" msgstr "" -#: reference/simple_stmts.rst:691 +#: reference/simple_stmts.rst:690 msgid "" ":keyword:`break` may only occur syntactically nested in a :keyword:`for` or :" "keyword:`while` loop, but not nested in a function or class definition " "within that loop." msgstr "" -#: reference/simple_stmts.rst:698 +#: reference/simple_stmts.rst:697 msgid "" "It terminates the nearest enclosing loop, skipping the optional :keyword:`!" "else` clause if the loop has one." msgstr "" -#: reference/simple_stmts.rst:701 +#: reference/simple_stmts.rst:700 msgid "" "If a :keyword:`for` loop is terminated by :keyword:`break`, the loop control " "target keeps its current value." msgstr "" -#: reference/simple_stmts.rst:706 +#: reference/simple_stmts.rst:705 msgid "" "When :keyword:`break` passes control out of a :keyword:`try` statement with " "a :keyword:`finally` clause, that :keyword:`!finally` clause is executed " "before really leaving the loop." msgstr "" -#: reference/simple_stmts.rst:714 +#: reference/simple_stmts.rst:713 msgid "The :keyword:`!continue` statement" msgstr "" -#: reference/simple_stmts.rst:726 +#: reference/simple_stmts.rst:725 msgid "" ":keyword:`continue` may only occur syntactically nested in a :keyword:`for` " "or :keyword:`while` loop, but not nested in a function or class definition " @@ -680,41 +680,41 @@ msgid "" "loop." msgstr "" -#: reference/simple_stmts.rst:730 +#: reference/simple_stmts.rst:729 msgid "" "When :keyword:`continue` passes control out of a :keyword:`try` statement " "with a :keyword:`finally` clause, that :keyword:`!finally` clause is " "executed before really starting the next loop cycle." msgstr "" -#: reference/simple_stmts.rst:739 +#: reference/simple_stmts.rst:738 msgid "The :keyword:`!import` statement" msgstr "" -#: reference/simple_stmts.rst:760 +#: reference/simple_stmts.rst:759 msgid "" "The basic import statement (no :keyword:`from` clause) is executed in two " "steps:" msgstr "" -#: reference/simple_stmts.rst:763 +#: reference/simple_stmts.rst:762 msgid "find a module, loading and initializing it if necessary" msgstr "" -#: reference/simple_stmts.rst:764 +#: reference/simple_stmts.rst:763 msgid "" "define a name or names in the local namespace for the scope where the :" "keyword:`import` statement occurs." msgstr "" -#: reference/simple_stmts.rst:767 +#: reference/simple_stmts.rst:766 msgid "" "When the statement contains multiple clauses (separated by commas) the two " "steps are carried out separately for each clause, just as though the clauses " "had been separated out into individual import statements." msgstr "" -#: reference/simple_stmts.rst:772 +#: reference/simple_stmts.rst:771 msgid "" "The details of the first step, finding and loading modules, are described in " "greater detail in the section on the :ref:`import system `, " @@ -725,26 +725,26 @@ msgid "" "module, which includes execution of the module's code." msgstr "" -#: reference/simple_stmts.rst:780 +#: reference/simple_stmts.rst:779 msgid "" "If the requested module is retrieved successfully, it will be made available " "in the local namespace in one of three ways:" msgstr "" -#: reference/simple_stmts.rst:785 +#: reference/simple_stmts.rst:784 msgid "" "If the module name is followed by :keyword:`!as`, then the name following :" "keyword:`!as` is bound directly to the imported module." msgstr "" -#: reference/simple_stmts.rst:787 +#: reference/simple_stmts.rst:786 msgid "" "If no other name is specified, and the module being imported is a top level " "module, the module's name is bound in the local namespace as a reference to " "the imported module" msgstr "" -#: reference/simple_stmts.rst:790 +#: reference/simple_stmts.rst:789 msgid "" "If the module being imported is *not* a top level module, then the name of " "the top level package that contains the module is bound in the local " @@ -752,53 +752,53 @@ msgid "" "be accessed using its full qualified name rather than directly" msgstr "" -#: reference/simple_stmts.rst:800 +#: reference/simple_stmts.rst:799 msgid "The :keyword:`from` form uses a slightly more complex process:" msgstr "" -#: reference/simple_stmts.rst:802 +#: reference/simple_stmts.rst:801 msgid "" "find the module specified in the :keyword:`from` clause, loading and " "initializing it if necessary;" msgstr "" -#: reference/simple_stmts.rst:804 +#: reference/simple_stmts.rst:803 msgid "for each of the identifiers specified in the :keyword:`import` clauses:" msgstr "" -#: reference/simple_stmts.rst:806 +#: reference/simple_stmts.rst:805 msgid "check if the imported module has an attribute by that name" msgstr "" -#: reference/simple_stmts.rst:807 +#: reference/simple_stmts.rst:806 msgid "" "if not, attempt to import a submodule with that name and then check the " "imported module again for that attribute" msgstr "" -#: reference/simple_stmts.rst:809 +#: reference/simple_stmts.rst:808 msgid "if the attribute is not found, :exc:`ImportError` is raised." msgstr "" -#: reference/simple_stmts.rst:810 +#: reference/simple_stmts.rst:809 msgid "" "otherwise, a reference to that value is stored in the local namespace, using " "the name in the :keyword:`!as` clause if it is present, otherwise using the " "attribute name" msgstr "" -#: reference/simple_stmts.rst:814 +#: reference/simple_stmts.rst:813 msgid "Examples::" msgstr "" -#: reference/simple_stmts.rst:824 +#: reference/simple_stmts.rst:823 msgid "" "If the list of identifiers is replaced by a star (``'*'``), all public names " "defined in the module are bound in the local namespace for the scope where " "the :keyword:`import` statement occurs." msgstr "" -#: reference/simple_stmts.rst:830 +#: reference/simple_stmts.rst:829 msgid "" "The *public names* defined by a module are determined by checking the " "module's namespace for a variable named ``__all__``; if defined, it must be " @@ -811,14 +811,14 @@ msgid "" "API (such as library modules which were imported and used within the module)." msgstr "" -#: reference/simple_stmts.rst:840 +#: reference/simple_stmts.rst:839 msgid "" "The wild card form of import --- ``from module import *`` --- is only " "allowed at the module level. Attempting to use it in class or function " "definitions will raise a :exc:`SyntaxError`." msgstr "" -#: reference/simple_stmts.rst:847 +#: reference/simple_stmts.rst:846 msgid "" "When specifying what module to import you do not have to specify the " "absolute name of the module. When a module or package is contained within " @@ -835,31 +835,31 @@ msgid "" "the :ref:`relativeimports` section." msgstr "" -#: reference/simple_stmts.rst:861 +#: reference/simple_stmts.rst:860 msgid "" ":func:`importlib.import_module` is provided to support applications that " "determine dynamically the modules to be loaded." msgstr "" -#: reference/simple_stmts.rst:864 +#: reference/simple_stmts.rst:863 msgid "" "Raises an :ref:`auditing event ` ``import`` with arguments " "``module``, ``filename``, ``sys.path``, ``sys.meta_path``, ``sys." "path_hooks``." msgstr "" -#: reference/simple_stmts.rst:869 +#: reference/simple_stmts.rst:868 msgid "Future statements" msgstr "" -#: reference/simple_stmts.rst:875 +#: reference/simple_stmts.rst:874 msgid "" "A :dfn:`future statement` is a directive to the compiler that a particular " "module should be compiled using syntax or semantics that will be available " "in a specified future release of Python where the feature becomes standard." msgstr "" -#: reference/simple_stmts.rst:879 +#: reference/simple_stmts.rst:878 msgid "" "The future statement is intended to ease migration to future versions of " "Python that introduce incompatible changes to the language. It allows use " @@ -867,35 +867,35 @@ msgid "" "feature becomes standard." msgstr "" -#: reference/simple_stmts.rst:891 +#: reference/simple_stmts.rst:890 msgid "" "A future statement must appear near the top of the module. The only lines " "that can appear before a future statement are:" msgstr "" -#: reference/simple_stmts.rst:894 +#: reference/simple_stmts.rst:893 msgid "the module docstring (if any)," msgstr "" -#: reference/simple_stmts.rst:895 +#: reference/simple_stmts.rst:894 msgid "comments," msgstr "" -#: reference/simple_stmts.rst:896 +#: reference/simple_stmts.rst:895 msgid "blank lines, and" msgstr "" -#: reference/simple_stmts.rst:897 +#: reference/simple_stmts.rst:896 msgid "other future statements." msgstr "" -#: reference/simple_stmts.rst:899 +#: reference/simple_stmts.rst:898 msgid "" "The only feature that requires using the future statement is ``annotations`` " "(see :pep:`563`)." msgstr "" -#: reference/simple_stmts.rst:902 +#: reference/simple_stmts.rst:901 msgid "" "All historical features enabled by the future statement are still recognized " "by Python 3. The list includes ``absolute_import``, ``division``, " @@ -905,7 +905,7 @@ msgid "" "compatibility." msgstr "" -#: reference/simple_stmts.rst:909 +#: reference/simple_stmts.rst:908 msgid "" "A future statement is recognized and treated specially at compile time: " "Changes to the semantics of core constructs are often implemented by " @@ -915,37 +915,37 @@ msgid "" "cannot be pushed off until runtime." msgstr "" -#: reference/simple_stmts.rst:916 +#: reference/simple_stmts.rst:915 msgid "" "For any given release, the compiler knows which feature names have been " "defined, and raises a compile-time error if a future statement contains a " "feature not known to it." msgstr "" -#: reference/simple_stmts.rst:920 +#: reference/simple_stmts.rst:919 msgid "" "The direct runtime semantics are the same as for any import statement: there " "is a standard module :mod:`__future__`, described later, and it will be " "imported in the usual way at the time the future statement is executed." msgstr "" -#: reference/simple_stmts.rst:924 +#: reference/simple_stmts.rst:923 msgid "" "The interesting runtime semantics depend on the specific feature enabled by " "the future statement." msgstr "" -#: reference/simple_stmts.rst:927 +#: reference/simple_stmts.rst:926 msgid "Note that there is nothing special about the statement::" msgstr "" -#: reference/simple_stmts.rst:931 +#: reference/simple_stmts.rst:930 msgid "" "That is not a future statement; it's an ordinary import statement with no " "special semantics or syntax restrictions." msgstr "" -#: reference/simple_stmts.rst:934 +#: reference/simple_stmts.rst:933 msgid "" "Code compiled by calls to the built-in functions :func:`exec` and :func:" "`compile` that occur in a module :mod:`!M` containing a future statement " @@ -954,7 +954,7 @@ msgid "" "--- see the documentation of that function for details." msgstr "" -#: reference/simple_stmts.rst:940 +#: reference/simple_stmts.rst:939 msgid "" "A future statement typed at an interactive interpreter prompt will take " "effect for the rest of the interpreter session. If an interpreter is " @@ -963,19 +963,19 @@ msgid "" "interactive session started after the script is executed." msgstr "" -#: reference/simple_stmts.rst:948 +#: reference/simple_stmts.rst:947 msgid ":pep:`236` - Back to the __future__" msgstr "" -#: reference/simple_stmts.rst:949 +#: reference/simple_stmts.rst:948 msgid "The original proposal for the __future__ mechanism." msgstr "" -#: reference/simple_stmts.rst:955 +#: reference/simple_stmts.rst:954 msgid "The :keyword:`!global` statement" msgstr "" -#: reference/simple_stmts.rst:965 +#: reference/simple_stmts.rst:964 msgid "" "The :keyword:`global` statement is a declaration which holds for the entire " "current code block. It means that the listed identifiers are to be " @@ -984,13 +984,13 @@ msgid "" "globals without being declared global." msgstr "" -#: reference/simple_stmts.rst:971 +#: reference/simple_stmts.rst:970 msgid "" "Names listed in a :keyword:`global` statement must not be used in the same " "code block textually preceding that :keyword:`!global` statement." msgstr "" -#: reference/simple_stmts.rst:974 +#: reference/simple_stmts.rst:973 msgid "" "Names listed in a :keyword:`global` statement must not be defined as formal " "parameters, or as targets in :keyword:`with` statements or :keyword:`except` " @@ -998,14 +998,14 @@ msgid "" "function definition, :keyword:`import` statement, or variable annotation." msgstr "" -#: reference/simple_stmts.rst:981 +#: reference/simple_stmts.rst:980 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:990 +#: reference/simple_stmts.rst:989 msgid "" "**Programmer's note:** :keyword:`global` is a directive to the parser. It " "applies only to code parsed at the same time as the :keyword:`!global` " @@ -1017,66 +1017,69 @@ msgid "" "func:`compile` functions." msgstr "" -#: reference/simple_stmts.rst:1002 +#: reference/simple_stmts.rst:1001 msgid "The :keyword:`!nonlocal` statement" msgstr "" -#: reference/simple_stmts.rst:1010 +#: reference/simple_stmts.rst:1009 msgid "" -"The :keyword:`nonlocal` statement causes the listed identifiers to refer to " -"previously bound variables in the nearest enclosing scope excluding globals. " -"This is important because the default behavior for binding is to search the " -"local namespace first. The statement allows encapsulated code to rebind " -"variables outside of the local scope besides the global (module) scope." +"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 " +"the enclosing functions. The :keyword:`nonlocal` statement causes the listed " +"identifiers to refer to names previously bound in nonlocal scopes. It allows " +"encapsulated code to rebind such nonlocal identifiers. If a name is bound " +"in more than one nonlocal scope, the nearest binding is used. If a name is " +"not bound in any nonlocal scope, or if there is no nonlocal scope, a :exc:" +"`SyntaxError` is raised." msgstr "" -#: reference/simple_stmts.rst:1016 +#: reference/simple_stmts.rst:1018 msgid "" -"Names listed in a :keyword:`nonlocal` statement, unlike those listed in a :" -"keyword:`global` statement, must refer to pre-existing bindings in an " -"enclosing scope (the scope in which a new binding should be created cannot " -"be determined unambiguously)." +"The nonlocal statement applies to the entire scope of a function or class " +"body. A :exc:`SyntaxError` is raised if a variable is used or assigned to " +"prior to its nonlocal declaration in the scope." msgstr "" -#: reference/simple_stmts.rst:1021 -msgid "" -"Names listed in a :keyword:`nonlocal` statement must not collide with pre-" -"existing bindings in the local scope." +#: reference/simple_stmts.rst:1024 +msgid ":pep:`3104` - Access to Names in Outer Scopes" msgstr "" -#: reference/simple_stmts.rst:1026 -msgid ":pep:`3104` - Access to Names in Outer Scopes" +#: reference/simple_stmts.rst:1025 +msgid "The specification for the :keyword:`nonlocal` statement." msgstr "" #: reference/simple_stmts.rst:1027 -msgid "The specification for the :keyword:`nonlocal` statement." +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:1032 +#: reference/simple_stmts.rst:1035 msgid "The :keyword:`!type` statement" msgstr "" -#: reference/simple_stmts.rst:1039 +#: reference/simple_stmts.rst:1042 msgid "" "The :keyword:`!type` statement declares a type alias, which is an instance " "of :class:`typing.TypeAliasType`." msgstr "" -#: reference/simple_stmts.rst:1042 +#: reference/simple_stmts.rst:1045 msgid "For example, the following statement creates a type alias::" msgstr "" -#: reference/simple_stmts.rst:1046 +#: reference/simple_stmts.rst:1049 msgid "This code is roughly equivalent to::" msgstr "" -#: reference/simple_stmts.rst:1052 +#: reference/simple_stmts.rst:1055 msgid "" "``annotation-def`` indicates an :ref:`annotation scope `, " "which behaves mostly like a function, but with several small differences." msgstr "" -#: reference/simple_stmts.rst:1055 +#: reference/simple_stmts.rst:1058 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 " @@ -1085,21 +1088,21 @@ msgid "" "not yet defined." msgstr "" -#: reference/simple_stmts.rst:1061 +#: reference/simple_stmts.rst:1064 msgid "" "Type aliases may be made generic by adding a :ref:`type parameter list ` after the name. See :ref:`generic-type-aliases` for more." msgstr "" -#: reference/simple_stmts.rst:1064 +#: reference/simple_stmts.rst:1067 msgid ":keyword:`!type` is a :ref:`soft keyword `." msgstr "" -#: reference/simple_stmts.rst:1071 +#: reference/simple_stmts.rst:1074 msgid ":pep:`695` - Type Parameter Syntax" msgstr "" -#: reference/simple_stmts.rst:1071 +#: reference/simple_stmts.rst:1074 msgid "" "Introduced the :keyword:`!type` statement and syntax for generic classes and " "functions." @@ -1112,8 +1115,8 @@ msgstr "" #: reference/simple_stmts.rst:39 reference/simple_stmts.rst:263 #: reference/simple_stmts.rst:379 reference/simple_stmts.rst:444 #: reference/simple_stmts.rst:483 reference/simple_stmts.rst:556 -#: reference/simple_stmts.rst:716 reference/simple_stmts.rst:871 -#: reference/simple_stmts.rst:1004 reference/simple_stmts.rst:1034 +#: reference/simple_stmts.rst:715 reference/simple_stmts.rst:870 +#: reference/simple_stmts.rst:1003 reference/simple_stmts.rst:1037 msgid "statement" msgstr "" @@ -1126,7 +1129,7 @@ msgstr "" msgid "list" msgstr "" -#: reference/simple_stmts.rst:985 +#: reference/simple_stmts.rst:984 msgid "built-in function" msgstr "" @@ -1188,12 +1191,12 @@ msgstr "" msgid "assignment" msgstr "" -#: reference/simple_stmts.rst:741 reference/simple_stmts.rst:957 +#: reference/simple_stmts.rst:740 reference/simple_stmts.rst:956 msgid "binding" msgstr "" -#: reference/simple_stmts.rst:457 reference/simple_stmts.rst:796 -#: reference/simple_stmts.rst:957 +#: reference/simple_stmts.rst:457 reference/simple_stmts.rst:795 +#: reference/simple_stmts.rst:956 msgid "name" msgstr "" @@ -1209,12 +1212,12 @@ msgstr "" msgid "attribute" msgstr "" -#: reference/simple_stmts.rst:116 reference/simple_stmts.rst:695 +#: reference/simple_stmts.rst:116 reference/simple_stmts.rst:694 msgid "target" msgstr "" -#: reference/simple_stmts.rst:379 reference/simple_stmts.rst:957 -#: reference/simple_stmts.rst:1004 +#: reference/simple_stmts.rst:379 reference/simple_stmts.rst:956 +#: reference/simple_stmts.rst:1003 msgid ", (comma)" msgstr "" @@ -1222,7 +1225,7 @@ msgstr "" msgid "in target list" msgstr "" -#: reference/simple_stmts.rst:822 +#: reference/simple_stmts.rst:821 msgid "* (asterisk)" msgstr "" @@ -1359,7 +1362,7 @@ msgid "__debug__" msgstr "" #: reference/simple_stmts.rst:520 reference/simple_stmts.rst:588 -#: reference/simple_stmts.rst:741 +#: reference/simple_stmts.rst:740 msgid "exception" msgstr "" @@ -1387,7 +1390,7 @@ msgstr "" msgid "deletion" msgstr "" -#: reference/simple_stmts.rst:957 +#: reference/simple_stmts.rst:956 msgid "global" msgstr "" @@ -1411,12 +1414,12 @@ msgstr "" msgid "class" msgstr "" -#: reference/simple_stmts.rst:695 reference/simple_stmts.rst:716 -#: reference/simple_stmts.rst:741 +#: reference/simple_stmts.rst:694 reference/simple_stmts.rst:715 +#: reference/simple_stmts.rst:740 msgid "keyword" msgstr "" -#: reference/simple_stmts.rst:704 reference/simple_stmts.rst:716 +#: reference/simple_stmts.rst:703 reference/simple_stmts.rst:715 msgid "finally" msgstr "" @@ -1464,102 +1467,102 @@ msgstr "" msgid "__context__ (exception attribute)" msgstr "" -#: reference/simple_stmts.rst:682 +#: reference/simple_stmts.rst:681 msgid "break" msgstr "" -#: reference/simple_stmts.rst:716 +#: reference/simple_stmts.rst:715 msgid "for" msgstr "" -#: reference/simple_stmts.rst:716 +#: reference/simple_stmts.rst:715 msgid "while" msgstr "" -#: reference/simple_stmts.rst:716 +#: reference/simple_stmts.rst:715 msgid "loop" msgstr "" -#: reference/simple_stmts.rst:695 +#: reference/simple_stmts.rst:694 msgid "else" msgstr "" -#: reference/simple_stmts.rst:695 +#: reference/simple_stmts.rst:694 msgid "loop control" msgstr "" -#: reference/simple_stmts.rst:716 +#: reference/simple_stmts.rst:715 msgid "continue" msgstr "" -#: reference/simple_stmts.rst:844 +#: reference/simple_stmts.rst:843 msgid "import" msgstr "" -#: reference/simple_stmts.rst:741 +#: reference/simple_stmts.rst:740 msgid "module" msgstr "" -#: reference/simple_stmts.rst:741 +#: reference/simple_stmts.rst:740 msgid "importing" msgstr "" -#: reference/simple_stmts.rst:796 +#: reference/simple_stmts.rst:795 msgid "from" msgstr "" -#: reference/simple_stmts.rst:783 +#: reference/simple_stmts.rst:782 msgid "as" msgstr "" -#: reference/simple_stmts.rst:741 +#: reference/simple_stmts.rst:740 msgid "ImportError" msgstr "" -#: reference/simple_stmts.rst:783 reference/simple_stmts.rst:822 +#: reference/simple_stmts.rst:782 reference/simple_stmts.rst:821 msgid "import statement" msgstr "" -#: reference/simple_stmts.rst:828 +#: reference/simple_stmts.rst:827 msgid "__all__ (optional module attribute)" msgstr "" -#: reference/simple_stmts.rst:844 +#: reference/simple_stmts.rst:843 msgid "relative" msgstr "" -#: reference/simple_stmts.rst:871 +#: reference/simple_stmts.rst:870 msgid "future" msgstr "" -#: reference/simple_stmts.rst:871 +#: reference/simple_stmts.rst:870 msgid "__future__" msgstr "" -#: reference/simple_stmts.rst:871 +#: reference/simple_stmts.rst:870 msgid "future statement" msgstr "" -#: reference/simple_stmts.rst:1004 +#: reference/simple_stmts.rst:1003 msgid "identifier list" msgstr "" -#: reference/simple_stmts.rst:985 +#: reference/simple_stmts.rst:984 msgid "exec" msgstr "" -#: reference/simple_stmts.rst:985 +#: reference/simple_stmts.rst:984 msgid "eval" msgstr "" -#: reference/simple_stmts.rst:985 +#: reference/simple_stmts.rst:984 msgid "compile" msgstr "" -#: reference/simple_stmts.rst:1004 +#: reference/simple_stmts.rst:1003 msgid "nonlocal" msgstr "" -#: reference/simple_stmts.rst:1034 +#: reference/simple_stmts.rst:1037 msgid "type" msgstr "" diff --git a/sphinx.po b/sphinx.po index e8176750a..42efcc657 100644 --- a/sphinx.po +++ b/sphinx.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-01-04 05:12+0300\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: 2022-12-28 16:25-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -123,16 +123,18 @@ msgstr "" "bulabilirsin." #: tools/templates/indexcontent.html:10 -msgid "Parts of the documentation:" -msgstr "Dokümantasyonun bölümleri:" +msgid "Documentation sections:" +msgstr "" #: tools/templates/indexcontent.html:13 msgid "What's new in Python %(version)s?" msgstr "Python %(version)s sürümündeki yenilikler nelerdir?" #: tools/templates/indexcontent.html:14 +#, fuzzy msgid "" -"or all \"What's new\" documents since 2.0" +"Or all \"What's new\" documents since Python " +"2.0" msgstr "" "veya 2.0'dan bu yana tüm \"Yenilikler\" " "belgeleri" @@ -142,99 +144,113 @@ msgid "Tutorial" msgstr "Öğretici" #: tools/templates/indexcontent.html:16 -msgid "start here" -msgstr "buradan başla" +msgid "Start here: a tour of Python's syntax and features" +msgstr "" #: tools/templates/indexcontent.html:17 -msgid "Library Reference" +#, fuzzy +msgid "Library reference" msgstr "Kütüphane Referansı" #: tools/templates/indexcontent.html:18 -msgid "keep this under your pillow" -msgstr "bunu yastığının altında tut" +msgid "Standard library and builtins" +msgstr "" #: tools/templates/indexcontent.html:19 -msgid "Language Reference" +#, fuzzy +msgid "Language reference" msgstr "Dil Referansı" #: tools/templates/indexcontent.html:20 -msgid "describes syntax and language elements" +#, fuzzy +msgid "Syntax and language elements" msgstr "söz dizimi ve dil öğelerini açıklar" #: tools/templates/indexcontent.html:21 -msgid "Python Setup and Usage" +#, fuzzy +msgid "Python setup and usage" msgstr "Python Kurulumu ve Kullanımı" #: tools/templates/indexcontent.html:22 -msgid "how to use Python on different platforms" -msgstr "Python farklı platformlarda nasıl kullanılır" +msgid "How to install, configure, and use Python" +msgstr "" #: tools/templates/indexcontent.html:23 msgid "Python HOWTOs" msgstr "Python NASIL'ları" #: tools/templates/indexcontent.html:24 -msgid "in-depth documents on specific topics" -msgstr "spesifik konularda ayrıntılı dokümanlar" +msgid "In-depth topic manuals" +msgstr "" #: tools/templates/indexcontent.html:26 -msgid "Installing Python Modules" +#, fuzzy +msgid "Installing Python modules" msgstr "Python Modüllerini Yükleme" #: tools/templates/indexcontent.html:27 -msgid "installing from the Python Package Index & other sources" -msgstr "Python Paket Dizini'nden yükleme & diğer kaynaklar" +msgid "Third-party modules and PyPI.org" +msgstr "" #: tools/templates/indexcontent.html:28 -msgid "Distributing Python Modules" +#, fuzzy +msgid "Distributing Python modules" msgstr "Python Modüllerini Dağıtma" #: tools/templates/indexcontent.html:29 -msgid "publishing modules for installation by others" +#, fuzzy +msgid "Publishing modules for use by other people" msgstr "modülleri başkaları tarafından yüklenmek üzere yayımlama" #: tools/templates/indexcontent.html:30 -msgid "Extending and Embedding" +#, fuzzy +msgid "Extending and embedding" msgstr "Genişletme ve Gömme" #: tools/templates/indexcontent.html:31 -msgid "tutorial for C/C++ programmers" +#, fuzzy +msgid "For C/C++ programmers" msgstr "C/C++ programcıları için öğretici" #: tools/templates/indexcontent.html:32 -msgid "Python/C API" +#, fuzzy +msgid "Python's C API" msgstr "Python/C API (Uygulama Programlama Arayüzü)" #: tools/templates/indexcontent.html:33 -msgid "reference for C/C++ programmers" -msgstr "C/C++ programcıları için referans" +msgid "C API reference" +msgstr "" #: tools/templates/indexcontent.html:34 msgid "FAQs" msgstr "SSS (Sıkça Sorulan Sorular)" #: tools/templates/indexcontent.html:35 -msgid "frequently asked questions (with answers!)" +#, fuzzy +msgid "Frequently asked questions (with answers!)" msgstr "sıkça sorulan sorular (cevaplarla!)" #: tools/templates/indexcontent.html:39 -msgid "Indices and tables:" -msgstr "Endeksler ve tablolar:" +msgid "Indices, glossary, and search:" +msgstr "" #: tools/templates/indexcontent.html:42 -msgid "Global Module Index" +#, fuzzy +msgid "Global module index" msgstr "Genel Modül Endeksi" #: tools/templates/indexcontent.html:43 -msgid "quick access to all modules" -msgstr "tüm modüllere çabuk erişim" +msgid "All modules and libraries" +msgstr "" #: tools/templates/indexcontent.html:44 -msgid "General Index" +#, fuzzy +msgid "General index" msgstr "Genel Endeks" #: tools/templates/indexcontent.html:45 -msgid "all functions, classes, terms" +#, fuzzy +msgid "All functions, classes, and terms" msgstr "tüm fonksiyonlar, sınıflar, terimler" #: tools/templates/indexcontent.html:46 @@ -242,31 +258,36 @@ msgid "Glossary" msgstr "Sözlük" #: tools/templates/indexcontent.html:47 -msgid "the most important terms explained" -msgstr "en önemli terimler, açıklamalarıyla birlikte" +msgid "Terms explained" +msgstr "" #: tools/templates/indexcontent.html:49 msgid "Search page" msgstr "Arama sayfası" #: tools/templates/indexcontent.html:50 -msgid "search this documentation" +#, fuzzy +msgid "Search this documentation" msgstr "bu dokümantasyonu ara" #: tools/templates/indexcontent.html:51 -msgid "Complete Table of Contents" +#, fuzzy +msgid "Complete table of contents" msgstr "Bütün İçeriklerin Tablosu" #: tools/templates/indexcontent.html:52 -msgid "lists all sections and subsections" +#, fuzzy +msgid "Lists all sections and subsections" msgstr "tüm bölümleri ve alt bölümleri listeler" #: tools/templates/indexcontent.html:56 -msgid "Meta information:" +#, fuzzy +msgid "Project information:" msgstr "Meta bilgiler:" #: tools/templates/indexcontent.html:59 -msgid "Reporting bugs" +#, fuzzy +msgid "Reporting issues" msgstr "Hataları bildirme" #: tools/templates/indexcontent.html:60 @@ -274,11 +295,12 @@ msgid "Contributing to Docs" msgstr "Dokümantasyona Katkıda Bulunma" #: tools/templates/indexcontent.html:61 -msgid "About the documentation" -msgstr "Dokümantasyon hakkında" +msgid "Download the documentation" +msgstr "Dokümantasyonu indir" #: tools/templates/indexcontent.html:63 -msgid "History and License of Python" +#, fuzzy +msgid "History and license of Python" msgstr "Python'un tarihçesi ve Lisansı" #: tools/templates/indexcontent.html:64 @@ -286,8 +308,8 @@ msgid "Copyright" msgstr "Telif Hakkı" #: tools/templates/indexcontent.html:65 -msgid "Download the documentation" -msgstr "Dokümantasyonu indir" +msgid "About the documentation" +msgstr "Dokümantasyon hakkında" #: tools/templates/indexsidebar.html:1 msgid "Download" @@ -362,3 +384,33 @@ msgstr "" #: tools/templates/layout.html:16 msgid "the current stable release" msgstr "mevcut kararlı sürüm" + +#~ msgid "Parts of the documentation:" +#~ msgstr "Dokümantasyonun bölümleri:" + +#~ msgid "start here" +#~ msgstr "buradan başla" + +#~ msgid "keep this under your pillow" +#~ msgstr "bunu yastığının altında tut" + +#~ msgid "how to use Python on different platforms" +#~ msgstr "Python farklı platformlarda nasıl kullanılır" + +#~ msgid "in-depth documents on specific topics" +#~ msgstr "spesifik konularda ayrıntılı dokümanlar" + +#~ msgid "installing from the Python Package Index & other sources" +#~ msgstr "Python Paket Dizini'nden yükleme & diğer kaynaklar" + +#~ msgid "reference for C/C++ programmers" +#~ msgstr "C/C++ programcıları için referans" + +#~ msgid "Indices and tables:" +#~ msgstr "Endeksler ve tablolar:" + +#~ msgid "quick access to all modules" +#~ msgstr "tüm modüllere çabuk erişim" + +#~ msgid "the most important terms explained" +#~ msgstr "en önemli terimler, açıklamalarıyla birlikte" diff --git a/tutorial/errors.po b/tutorial/errors.po index e5f8f4a3f..c099d6daa 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: 2023-12-01 14:57+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: 2022-12-28 22:18+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -45,13 +45,14 @@ msgstr "" "belki de en sık karşılaşılan hatalardan biridir::" #: tutorial/errors.rst:26 +#, fuzzy msgid "" -"The parser repeats the offending line and displays a little 'arrow' pointing " -"at the earliest point in the line where the error was detected. The error " -"is caused by (or at least detected at) the token *preceding* the arrow: 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 '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." 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 fc969df10..73b91d732 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: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: 2024-02-27 22:42+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -486,20 +486,10 @@ msgstr "" "dizine alınabilir ve dilimlenebilir::" #: tutorial/introduction.rst:408 -msgid "" -"All slice operations return a new list containing the requested elements. " -"This means that the following slice returns a :ref:`shallow copy " -"` of the list::" -msgstr "" -"Tüm dilim işlemleri, istenen ögeleri içeren yeni bir liste döndürür. Bu, " -"aşağıdaki dilimin listenin bir :ref:`shallow copy ` " -"döndürdüğü anlamına gelir::" - -#: tutorial/introduction.rst:415 msgid "Lists also support operations like concatenation::" msgstr "Ayrıca listeler birleştirme gibi işlemleri de destekler::" -#: tutorial/introduction.rst:420 +#: tutorial/introduction.rst:413 msgid "" "Unlike strings, which are :term:`immutable`, lists are a :term:`mutable` " "type, i.e. it is possible to change their content::" @@ -507,7 +497,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:430 +#: tutorial/introduction.rst:423 #, fuzzy msgid "" "You can also add new items at the end of the list, by using the :meth:`!list." @@ -517,7 +507,25 @@ msgstr "" "öğeler ekleyebilirsiniz (yöntemler hakkında daha fazla bilgiyi daha sonra " "göreceğiz)::" -#: tutorial/introduction.rst:438 +#: tutorial/introduction.rst:431 +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 " +"to the list through one variable will be seen through all other variables " +"that refer to it.::" +msgstr "" + +#: tutorial/introduction.rst:444 +msgid "" +"All slice operations return a new list containing the requested elements. " +"This means that the following slice returns a :ref:`shallow copy " +"` of the list::" +msgstr "" +"Tüm dilim işlemleri, istenen ögeleri içeren yeni bir liste döndürür. Bu, " +"aşağıdaki dilimin listenin bir :ref:`shallow copy ` " +"döndürdüğü anlamına gelir::" + +#: tutorial/introduction.rst:455 msgid "" "Assignment to slices is also possible, and this can even change the size of " "the list or clear it entirely::" @@ -525,11 +533,11 @@ msgstr "" "Dilimlere atama da mümkündür ve bu, listenin boyutunu bile değiştirebilir " "veya tamamen temizleyebilir::" -#: tutorial/introduction.rst:457 +#: tutorial/introduction.rst:474 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:463 +#: tutorial/introduction.rst:480 msgid "" "It is possible to nest lists (create lists containing other lists), for " "example::" @@ -537,11 +545,11 @@ msgstr "" "Listeleri iç içe yerleştirmek (diğer listeleri içeren listeler oluşturmak) " "mümkündür, örneğin::" -#: tutorial/introduction.rst:479 +#: tutorial/introduction.rst:496 msgid "First Steps Towards Programming" msgstr "Programlamaya Doğru İlk Adımlar" -#: tutorial/introduction.rst:481 +#: tutorial/introduction.rst:498 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 " @@ -552,11 +560,11 @@ msgstr "" "kullanabiliriz. Örneğin, `Fibonacci serisinin `_ ilk alt dizisini aşağıdaki gibi yazabiliriz:" -#: tutorial/introduction.rst:501 +#: tutorial/introduction.rst:518 msgid "This example introduces several new features." msgstr "Bu örnek, birkaç yeni özellik sunar." -#: tutorial/introduction.rst:503 +#: tutorial/introduction.rst:520 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 " @@ -568,7 +576,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:509 +#: tutorial/introduction.rst:526 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 " @@ -588,7 +596,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:518 +#: tutorial/introduction.rst:535 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 " @@ -609,7 +617,7 @@ msgstr "" "tahmin edemez). Bir temel blok içindeki her satırın aynı miktarda girintili " "olması gerektiğini unutmayın." -#: tutorial/introduction.rst:527 +#: tutorial/introduction.rst:544 msgid "" "The :func:`print` function writes the value of the argument(s) it is given. " "It differs from just writing the expression you want to write (as we did " @@ -625,7 +633,7 @@ 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:538 +#: tutorial/introduction.rst:555 msgid "" "The keyword argument *end* can be used to avoid the newline after the " "output, or end the output with a different string::" @@ -633,11 +641,11 @@ 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:550 +#: tutorial/introduction.rst:567 msgid "Footnotes" msgstr "Dipnotlar" -#: tutorial/introduction.rst:551 +#: tutorial/introduction.rst:568 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 " @@ -647,7 +655,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:555 +#: tutorial/introduction.rst:572 msgid "" "Unlike other languages, special characters such as ``\\n`` have the same " "meaning with both single (``'...'``) and double (``\"...\"``) quotes. The " diff --git a/using/cmdline.po b/using/cmdline.po index a0f7f33bc..1ab97e000 100644 --- a/using/cmdline.po +++ b/using/cmdline.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -323,22 +323,23 @@ msgstr "" #: using/cmdline.rst:245 msgid "" -"Issue a warning when comparing :class:`bytes` or :class:`bytearray` with :" -"class:`str` or :class:`bytes` with :class:`int`. Issue an error when the " -"option is given twice (:option:`!-bb`)." +"Issue a warning when converting :class:`bytes` or :class:`bytearray` to :" +"class:`str` without specifying encoding or comparing :class:`!bytes` or :" +"class:`!bytearray` with :class:`!str` or :class:`!bytes` with :class:`int`. " +"Issue an error when the option is given twice (:option:`!-bb`)." msgstr "" -#: using/cmdline.rst:249 -msgid "Affects comparisons of :class:`bytes` with :class:`int`." +#: using/cmdline.rst:250 +msgid "Affects also comparisons of :class:`bytes` with :class:`int`." msgstr "" -#: using/cmdline.rst:254 +#: using/cmdline.rst:255 msgid "" "If given, Python won't try to write ``.pyc`` files on the import of source " "modules. See also :envvar:`PYTHONDONTWRITEBYTECODE`." msgstr "" -#: using/cmdline.rst:260 +#: using/cmdline.rst:261 msgid "" "Control the validation behavior of hash-based ``.pyc`` files. See :ref:`pyc-" "invalidation`. When set to ``default``, checked and unchecked hash-based " @@ -349,35 +350,35 @@ msgid "" "corresponding source files." msgstr "" -#: using/cmdline.rst:268 +#: using/cmdline.rst:269 msgid "" "The semantics of timestamp-based ``.pyc`` files are unaffected by this " "option." msgstr "" -#: using/cmdline.rst:274 +#: using/cmdline.rst:275 msgid "" "Turn on parser debugging output (for expert only). See also the :envvar:" "`PYTHONDEBUG` environment variable." msgstr "" -#: using/cmdline.rst:277 +#: using/cmdline.rst:278 msgid "" "This option requires a :ref:`debug build of Python `, otherwise " "it's ignored." msgstr "" -#: using/cmdline.rst:283 +#: using/cmdline.rst:284 msgid "" "Ignore all ``PYTHON*`` environment variables, e.g. :envvar:`PYTHONPATH` and :" "envvar:`PYTHONHOME`, that might be set." msgstr "" -#: using/cmdline.rst:286 +#: using/cmdline.rst:287 msgid "See also the :option:`-P` and :option:`-I` (isolated) options." msgstr "" -#: using/cmdline.rst:291 +#: using/cmdline.rst:292 msgid "" "When a script is passed as first argument or the :option:`-c` option is " "used, enter interactive mode after executing the script or the command, even " @@ -385,19 +386,19 @@ msgid "" "`PYTHONSTARTUP` file is not read." msgstr "" -#: using/cmdline.rst:296 +#: using/cmdline.rst:297 msgid "" "This can be useful to inspect global variables or a stack trace when a " "script raises an exception. See also :envvar:`PYTHONINSPECT`." msgstr "" -#: using/cmdline.rst:302 +#: using/cmdline.rst:303 msgid "" "Run Python in isolated mode. This also implies :option:`-E`, :option:`-P` " "and :option:`-s` options." msgstr "" -#: using/cmdline.rst:305 +#: using/cmdline.rst:306 msgid "" "In isolated mode :data:`sys.path` contains neither the script's directory " "nor the user's site-packages directory. All ``PYTHON*`` environment " @@ -405,7 +406,7 @@ msgid "" "the user from injecting malicious code." msgstr "" -#: using/cmdline.rst:315 +#: using/cmdline.rst:316 msgid "" "Remove assert statements and any code conditional on the value of :const:" "`__debug__`. Augment the filename for compiled (:term:`bytecode`) files by " @@ -413,58 +414,58 @@ msgid "" "envvar:`PYTHONOPTIMIZE`." msgstr "" -#: using/cmdline.rst:330 +#: using/cmdline.rst:331 msgid "Modify ``.pyc`` filenames according to :pep:`488`." msgstr "" -#: using/cmdline.rst:326 +#: using/cmdline.rst:327 msgid "" "Do :option:`-O` and also discard docstrings. Augment the filename for " "compiled (:term:`bytecode`) files by adding ``.opt-2`` before the ``.pyc`` " "extension (see :pep:`488`)." msgstr "" -#: using/cmdline.rst:336 +#: using/cmdline.rst:337 msgid "Don't prepend a potentially unsafe path to :data:`sys.path`:" msgstr "" -#: using/cmdline.rst:338 +#: using/cmdline.rst:339 msgid "" "``python -m module`` command line: Don't prepend the current working " "directory." msgstr "" -#: using/cmdline.rst:340 +#: using/cmdline.rst:341 msgid "" "``python script.py`` command line: Don't prepend the script's directory. If " "it's a symbolic link, resolve symbolic links." msgstr "" -#: using/cmdline.rst:342 +#: using/cmdline.rst:343 msgid "" "``python -c code`` and ``python`` (REPL) command lines: Don't prepend an " "empty string, which means the current working directory." msgstr "" -#: using/cmdline.rst:345 +#: using/cmdline.rst:346 msgid "" "See also the :envvar:`PYTHONSAFEPATH` environment variable, and :option:`-E` " "and :option:`-I` (isolated) options." msgstr "" -#: using/cmdline.rst:353 +#: using/cmdline.rst:354 msgid "" "Don't display the copyright and version messages even in interactive mode." msgstr "" -#: using/cmdline.rst:360 +#: using/cmdline.rst:361 msgid "" "Turn on hash randomization. This option only has an effect if the :envvar:" "`PYTHONHASHSEED` environment variable is set to ``0``, since hash " "randomization is enabled by default." msgstr "" -#: using/cmdline.rst:364 +#: using/cmdline.rst:365 msgid "" "On previous versions of Python, this option turns on hash randomization, so " "that the :meth:`~object.__hash__` values of str and bytes objects are " @@ -473,7 +474,7 @@ msgid "" "between repeated invocations of Python." msgstr "" -#: using/cmdline.rst:370 +#: using/cmdline.rst:371 msgid "" "Hash randomization is intended to provide protection against a denial-of-" "service caused by carefully chosen inputs that exploit the worst case " @@ -481,27 +482,31 @@ msgid "" "http://ocert.org/advisories/ocert-2011-003.html for details." msgstr "" -#: using/cmdline.rst:375 +#: using/cmdline.rst:376 msgid "" ":envvar:`PYTHONHASHSEED` allows you to set a fixed value for the hash seed " "secret." msgstr "" -#: using/cmdline.rst:378 +#: using/cmdline.rst:381 msgid "The option is no longer ignored." msgstr "" -#: using/cmdline.rst:386 +#: using/cmdline.rst:387 msgid "" "Don't add the :data:`user site-packages directory ` to :data:" "`sys.path`." msgstr "" -#: using/cmdline.rst:805 using/cmdline.rst:817 +#: using/cmdline.rst:390 +msgid "See also :envvar:`PYTHONNOUSERSITE`." +msgstr "" + +#: using/cmdline.rst:802 using/cmdline.rst:814 msgid ":pep:`370` -- Per user site-packages directory" msgstr "" -#: using/cmdline.rst:396 +#: using/cmdline.rst:399 msgid "" "Disable the import of the module :mod:`site` and the site-dependent " "manipulations of :data:`sys.path` that it entails. Also disable these " @@ -509,21 +514,21 @@ msgid "" "main` if you want them to be triggered)." msgstr "" -#: using/cmdline.rst:404 +#: using/cmdline.rst:407 msgid "" "Force the stdout and stderr streams to be unbuffered. This option has no " "effect on the stdin stream." msgstr "" -#: using/cmdline.rst:407 +#: using/cmdline.rst:410 msgid "See also :envvar:`PYTHONUNBUFFERED`." msgstr "" -#: using/cmdline.rst:409 +#: using/cmdline.rst:412 msgid "The text layer of the stdout and stderr streams now is unbuffered." msgstr "" -#: using/cmdline.rst:415 +#: using/cmdline.rst:418 msgid "" "Print a message each time a module is initialized, showing the place " "(filename or built-in module) from which it is loaded. When given twice (:" @@ -531,60 +536,60 @@ msgid "" "searching for a module. Also provides information on module cleanup at exit." msgstr "" -#: using/cmdline.rst:420 +#: using/cmdline.rst:423 msgid "" "The :mod:`site` module reports the site-specific paths and :file:`.pth` " "files being processed." msgstr "" -#: using/cmdline.rst:424 +#: using/cmdline.rst:427 msgid "See also :envvar:`PYTHONVERBOSE`." msgstr "" -#: using/cmdline.rst:430 +#: using/cmdline.rst:433 msgid "" "Warning control. Python's warning machinery by default prints warning " "messages to :data:`sys.stderr`." msgstr "" -#: using/cmdline.rst:833 +#: using/cmdline.rst:830 msgid "" "The simplest settings apply a particular action unconditionally to all " "warnings emitted by a process (even those that are otherwise ignored by " "default)::" msgstr "" -#: using/cmdline.rst:444 +#: using/cmdline.rst:447 msgid "" "The action names can be abbreviated as desired and the interpreter will " "resolve them to the appropriate action name. For example, ``-Wi`` is the " "same as ``-Wignore``." msgstr "" -#: using/cmdline.rst:448 +#: using/cmdline.rst:451 msgid "The full form of argument is::" msgstr "" -#: using/cmdline.rst:452 +#: using/cmdline.rst:455 msgid "" "Empty fields match all values; trailing empty fields may be omitted. For " "example ``-W ignore::DeprecationWarning`` ignores all DeprecationWarning " "warnings." msgstr "" -#: using/cmdline.rst:456 +#: using/cmdline.rst:459 msgid "" "The *action* field is as explained above but only applies to warnings that " "match the remaining fields." msgstr "" -#: using/cmdline.rst:459 +#: using/cmdline.rst:462 msgid "" "The *message* field must match the whole warning message; this match is case-" "insensitive." msgstr "" -#: using/cmdline.rst:462 +#: using/cmdline.rst:465 msgid "" "The *category* field matches the warning category (ex: " "``DeprecationWarning``). This must be a class name; the match test whether " @@ -592,19 +597,19 @@ msgid "" "warning category." msgstr "" -#: using/cmdline.rst:467 +#: using/cmdline.rst:470 msgid "" "The *module* field matches the (fully qualified) module name; this match is " "case-sensitive." msgstr "" -#: using/cmdline.rst:470 +#: using/cmdline.rst:473 msgid "" "The *lineno* field matches the line number, where zero matches all line " "numbers and is thus equivalent to an omitted line number." msgstr "" -#: using/cmdline.rst:473 +#: using/cmdline.rst:476 msgid "" "Multiple :option:`-W` options can be given; when a warning matches more than " "one option, the action for the last matching option is performed. Invalid :" @@ -612,7 +617,7 @@ msgid "" "invalid options when the first warning is issued)." msgstr "" -#: using/cmdline.rst:478 +#: using/cmdline.rst:481 msgid "" "Warnings can also be controlled using the :envvar:`PYTHONWARNINGS` " "environment variable and from within a Python program using the :mod:" @@ -620,31 +625,31 @@ msgid "" "can be used to use a regular expression on the warning message." msgstr "" -#: using/cmdline.rst:844 +#: using/cmdline.rst:841 msgid "" "See :ref:`warning-filter` and :ref:`describing-warning-filters` for more " "details." msgstr "" -#: using/cmdline.rst:489 +#: using/cmdline.rst:492 msgid "" "Skip the first line of the source, allowing use of non-Unix forms of ``#!" "cmd``. This is intended for a DOS specific hack only." msgstr "" -#: using/cmdline.rst:495 +#: using/cmdline.rst:498 msgid "" "Reserved for various implementation-specific options. CPython currently " "defines the following possible values:" msgstr "" -#: using/cmdline.rst:498 +#: using/cmdline.rst:501 msgid "" "``-X faulthandler`` to enable :mod:`faulthandler`. See also :envvar:" "`PYTHONFAULTHANDLER`." msgstr "" -#: using/cmdline.rst:500 +#: using/cmdline.rst:503 msgid "" "``-X showrefcount`` to output the total reference count and number of used " "memory blocks when the program finishes or after each statement in the " @@ -652,7 +657,7 @@ msgid "" "build>`." msgstr "" -#: using/cmdline.rst:504 +#: using/cmdline.rst:507 msgid "" "``-X tracemalloc`` to start tracing Python memory allocations using the :mod:" "`tracemalloc` module. By default, only the most recent frame is stored in a " @@ -661,14 +666,14 @@ msgid "" "envvar:`PYTHONTRACEMALLOC` for more information." msgstr "" -#: using/cmdline.rst:510 +#: using/cmdline.rst:513 msgid "" "``-X int_max_str_digits`` configures the :ref:`integer string conversion " "length limitation `. See also :envvar:" "`PYTHONINTMAXSTRDIGITS`." msgstr "" -#: using/cmdline.rst:513 +#: using/cmdline.rst:516 msgid "" "``-X importtime`` to show how long each import takes. It shows module name, " "cumulative time (including nested imports) and self time (excluding nested " @@ -677,34 +682,35 @@ msgid "" "asyncio'``. See also :envvar:`PYTHONPROFILEIMPORTTIME`." msgstr "" -#: using/cmdline.rst:518 +#: using/cmdline.rst:521 msgid "" "``-X dev``: enable :ref:`Python Development Mode `, introducing " -"additional runtime checks that are too expensive to be enabled by default." +"additional runtime checks that are too expensive to be enabled by default. " +"See also :envvar:`PYTHONDEVMODE`." msgstr "" -#: using/cmdline.rst:521 +#: using/cmdline.rst:524 msgid "" "``-X utf8`` enables the :ref:`Python UTF-8 Mode `. ``-X utf8=0`` " "explicitly disables :ref:`Python UTF-8 Mode ` (even when it would " "otherwise activate automatically). See also :envvar:`PYTHONUTF8`." msgstr "" -#: using/cmdline.rst:525 +#: using/cmdline.rst:528 msgid "" "``-X pycache_prefix=PATH`` enables writing ``.pyc`` files to a parallel tree " "rooted at the given directory instead of to the code tree. See also :envvar:" "`PYTHONPYCACHEPREFIX`." msgstr "" -#: using/cmdline.rst:528 +#: using/cmdline.rst:531 msgid "" "``-X warn_default_encoding`` issues a :class:`EncodingWarning` when the " "locale-specific default encoding is used for opening files. See also :envvar:" "`PYTHONWARNDEFAULTENCODING`." msgstr "" -#: using/cmdline.rst:531 +#: using/cmdline.rst:534 msgid "" "``-X no_debug_ranges`` disables the inclusion of the tables mapping extra " "location information (end line, start column offset and end column offset) " @@ -714,7 +720,7 @@ msgid "" "envvar:`PYTHONNODEBUGRANGES`." msgstr "" -#: using/cmdline.rst:537 +#: using/cmdline.rst:540 msgid "" "``-X frozen_modules`` determines whether or not frozen modules are ignored " "by the import machinery. A value of \"on\" means they get imported and " @@ -725,7 +731,7 @@ msgid "" "are always used, even if this flag is set to \"off\"." msgstr "" -#: using/cmdline.rst:544 +#: using/cmdline.rst:547 msgid "" "``-X perf`` enables support for the Linux ``perf`` profiler. When this " "option is provided, the ``perf`` profiler will be able to report Python " @@ -734,82 +740,73 @@ msgid "" "also :envvar:`PYTHONPERFSUPPORT` and :ref:`perf_profiling`." msgstr "" -#: using/cmdline.rst:550 +#: using/cmdline.rst:553 msgid "" "It also allows passing arbitrary values and retrieving them through the :" "data:`sys._xoptions` dictionary." msgstr "" -#: using/cmdline.rst:553 -msgid "The :option:`-X` option was added." +#: using/cmdline.rst:558 +msgid "Added the ``-X faulthandler`` option." msgstr "" -#: using/cmdline.rst:556 -msgid "The ``-X faulthandler`` option." +#: using/cmdline.rst:561 +msgid "Added the ``-X showrefcount`` and ``-X tracemalloc`` options." msgstr "" -#: using/cmdline.rst:559 -msgid "The ``-X showrefcount`` and ``-X tracemalloc`` options." +#: using/cmdline.rst:564 +msgid "Added the ``-X showalloccount`` option." msgstr "" -#: using/cmdline.rst:562 -msgid "The ``-X showalloccount`` option." +#: using/cmdline.rst:567 +msgid "Added the ``-X importtime``, ``-X dev`` and ``-X utf8`` options." msgstr "" -#: using/cmdline.rst:565 -msgid "The ``-X importtime``, ``-X dev`` and ``-X utf8`` options." -msgstr "" - -#: using/cmdline.rst:568 +#: using/cmdline.rst:570 msgid "" -"The ``-X pycache_prefix`` option. The ``-X dev`` option now logs ``close()`` " -"exceptions in :class:`io.IOBase` destructor." +"Added the ``-X pycache_prefix`` option. The ``-X dev`` option now logs " +"``close()`` exceptions in :class:`io.IOBase` destructor." msgstr "" -#: using/cmdline.rst:572 +#: using/cmdline.rst:574 msgid "" "Using ``-X dev`` option, check *encoding* and *errors* arguments on string " "encoding and decoding operations." msgstr "" -#: using/cmdline.rst:576 +#: using/cmdline.rst:578 msgid "The ``-X showalloccount`` option has been removed." msgstr "" -#: using/cmdline.rst:578 +#: using/cmdline.rst:580 msgid "" -"The ``-X warn_default_encoding`` option. Removed the ``-X oldparser`` option." -msgstr "" - -#: using/cmdline.rst:582 -msgid "The ``-X no_debug_ranges`` option." +"Added the ``-X warn_default_encoding`` option. Removed the ``-X oldparser`` " +"option." msgstr "" -#: using/cmdline.rst:585 -msgid "The ``-X frozen_modules`` option." +#: using/cmdline.rst:584 +msgid "" +"Added the ``-X no_debug_ranges``, ``-X frozen_modules`` and ``-X " +"int_max_str_digits`` options." msgstr "" #: using/cmdline.rst:588 -msgid "The ``-X int_max_str_digits`` option." +msgid "Added the ``-X perf`` option." msgstr "" -#: using/cmdline.rst:591 -msgid "The ``-X perf`` option." -msgstr "" - -#: using/cmdline.rst:596 +#: using/cmdline.rst:593 msgid "Options you shouldn't use" msgstr "" -#: using/cmdline.rst:600 +#: using/cmdline.rst:597 msgid "Reserved for use by Jython_." msgstr "" -#: using/cmdline.rst:608 +#: using/cmdline.rst:605 msgid "Environment variables" msgstr "" -#: using/cmdline.rst:610 +#: using/cmdline.rst:607 msgid "" "These environment variables influence Python's behavior, they are processed " "before the command-line switches other than -E or -I. It is customary that " @@ -817,7 +814,7 @@ msgid "" "conflict." msgstr "" -#: using/cmdline.rst:617 +#: using/cmdline.rst:614 msgid "" "Change the location of the standard Python libraries. By default, the " "libraries are searched in :file:`{prefix}/lib/python{version}` and :file:" @@ -826,14 +823,14 @@ msgid "" "file:`/usr/local`." msgstr "" -#: using/cmdline.rst:623 +#: using/cmdline.rst:620 msgid "" "When :envvar:`PYTHONHOME` is set to a single directory, its value replaces " "both :file:`{prefix}` and :file:`{exec_prefix}`. To specify different " "values for these, set :envvar:`PYTHONHOME` to :file:`{prefix}:{exec_prefix}`." msgstr "" -#: using/cmdline.rst:630 +#: using/cmdline.rst:627 msgid "" "Augment the default search path for module files. The format is the same as " "the shell's :envvar:`PATH`: one or more directory pathnames separated by :" @@ -841,21 +838,21 @@ msgid "" "existent directories are silently ignored." msgstr "" -#: using/cmdline.rst:635 +#: using/cmdline.rst:632 msgid "" "In addition to normal directories, individual :envvar:`PYTHONPATH` entries " "may refer to zipfiles containing pure Python modules (in either source or " "compiled form). Extension modules cannot be imported from zipfiles." msgstr "" -#: using/cmdline.rst:639 +#: using/cmdline.rst:636 msgid "" "The default search path is installation dependent, but generally begins " "with :file:`{prefix}/lib/python{version}` (see :envvar:`PYTHONHOME` above). " "It is *always* appended to :envvar:`PYTHONPATH`." msgstr "" -#: using/cmdline.rst:643 +#: using/cmdline.rst:640 msgid "" "An additional directory will be inserted in the search path in front of :" "envvar:`PYTHONPATH` as described above under :ref:`using-on-interface-" @@ -863,19 +860,19 @@ msgid "" "the variable :data:`sys.path`." msgstr "" -#: using/cmdline.rst:651 +#: using/cmdline.rst:648 msgid "" "If this is set to a non-empty string, don't prepend a potentially unsafe " "path to :data:`sys.path`: see the :option:`-P` option for details." msgstr "" -#: using/cmdline.rst:659 +#: using/cmdline.rst:656 msgid "" "If this is set to a non-empty string, it overrides the :data:`sys." "platlibdir` value." msgstr "" -#: using/cmdline.rst:667 +#: using/cmdline.rst:664 msgid "" "If this is the name of a readable file, the Python commands in that file are " "executed before the first prompt is displayed in interactive mode. The file " @@ -886,26 +883,26 @@ msgid "" "file." msgstr "" -#: using/cmdline.rst:674 +#: using/cmdline.rst:671 msgid "" "Raises an :ref:`auditing event ` ``cpython.run_startup`` with " "argument ``filename``." msgstr "" -#: using/cmdline.rst:676 +#: using/cmdline.rst:673 msgid "" "Raises an :ref:`auditing event ` ``cpython.run_startup`` with the " "filename as the argument when called on startup." msgstr "" -#: using/cmdline.rst:682 +#: using/cmdline.rst:679 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-O` option. If set to an integer, it is equivalent to specifying :" "option:`-O` multiple times." msgstr "" -#: using/cmdline.rst:689 +#: using/cmdline.rst:686 msgid "" "If this is set, it names a callable using dotted-path notation. The module " "containing the callable will be imported and then the callable will be run " @@ -916,58 +913,58 @@ msgid "" "breakpointhook` to do nothing but return immediately." msgstr "" -#: using/cmdline.rst:701 +#: using/cmdline.rst:698 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-d` option. If set to an integer, it is equivalent to specifying :" "option:`-d` multiple times." msgstr "" -#: using/cmdline.rst:705 +#: using/cmdline.rst:702 msgid "" "This environment variable requires a :ref:`debug build of Python `, otherwise it's ignored." msgstr "" -#: using/cmdline.rst:711 +#: using/cmdline.rst:708 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-i` option." msgstr "" -#: using/cmdline.rst:714 +#: using/cmdline.rst:711 msgid "" "This variable can also be modified by Python code using :data:`os.environ` " "to force inspect mode on program termination." msgstr "" -#: using/cmdline.rst:720 +#: using/cmdline.rst:717 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-u` option." msgstr "" -#: using/cmdline.rst:726 +#: using/cmdline.rst:723 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-v` option. If set to an integer, it is equivalent to specifying :" "option:`-v` multiple times." msgstr "" -#: using/cmdline.rst:733 +#: using/cmdline.rst:730 msgid "" "If this is set, Python ignores case in :keyword:`import` statements. This " "only works on Windows and macOS." msgstr "" -#: using/cmdline.rst:739 +#: using/cmdline.rst:736 msgid "" "If this is set to a non-empty string, Python won't try to write ``.pyc`` " "files on the import of source modules. This is equivalent to specifying " "the :option:`-B` option." msgstr "" -#: using/cmdline.rst:746 +#: using/cmdline.rst:743 msgid "" "If this is set, Python will write ``.pyc`` files in a mirror directory tree " "at this path, instead of in ``__pycache__`` directories within the source " @@ -975,40 +972,40 @@ msgid "" "``pycache_prefix=PATH`` option." msgstr "" -#: using/cmdline.rst:756 +#: using/cmdline.rst:753 msgid "" "If this variable is not set or set to ``random``, a random value is used to " "seed the hashes of str and bytes objects." msgstr "" -#: using/cmdline.rst:759 +#: using/cmdline.rst:756 msgid "" "If :envvar:`PYTHONHASHSEED` is set to an integer value, it is used as a " "fixed seed for generating the hash() of the types covered by the hash " "randomization." msgstr "" -#: using/cmdline.rst:763 +#: using/cmdline.rst:760 msgid "" "Its purpose is to allow repeatable hashing, such as for selftests for the " "interpreter itself, or to allow a cluster of python processes to share hash " "values." msgstr "" -#: using/cmdline.rst:767 +#: using/cmdline.rst:764 msgid "" "The integer must be a decimal number in the range [0,4294967295]. " "Specifying the value 0 will disable hash randomization." msgstr "" -#: using/cmdline.rst:774 +#: using/cmdline.rst:771 msgid "" "If this variable is set to an integer, it is used to configure the " "interpreter's global :ref:`integer string conversion length limitation " "`." msgstr "" -#: using/cmdline.rst:782 +#: using/cmdline.rst:779 msgid "" "If this is set before running the interpreter, it overrides the encoding " "used for stdin/stdout/stderr, in the syntax ``encodingname:errorhandler``. " @@ -1016,17 +1013,17 @@ msgid "" "have the same meaning as in :func:`str.encode`." msgstr "" -#: using/cmdline.rst:787 +#: using/cmdline.rst:784 msgid "" "For stderr, the ``:errorhandler`` part is ignored; the handler will always " "be ``'backslashreplace'``." msgstr "" -#: using/cmdline.rst:790 +#: using/cmdline.rst:787 msgid "The ``encodingname`` part is now optional." msgstr "" -#: using/cmdline.rst:793 +#: using/cmdline.rst:790 msgid "" "On Windows, the encoding specified by this variable is ignored for " "interactive console buffers unless :envvar:`PYTHONLEGACYWINDOWSSTDIO` is " @@ -1034,13 +1031,13 @@ msgid "" "not affected." msgstr "" -#: using/cmdline.rst:800 +#: using/cmdline.rst:797 msgid "" "If this is set, Python won't add the :data:`user site-packages directory " "` to :data:`sys.path`." msgstr "" -#: using/cmdline.rst:810 +#: using/cmdline.rst:807 msgid "" "Defines the :data:`user base directory `, which is used to " "compute the path of the :data:`user site-packages directory ` of the :mod:`asyncio` module." msgstr "" -#: using/cmdline.rst:892 +#: using/cmdline.rst:889 msgid "Set the Python memory allocators and/or install debug hooks." msgstr "" -#: using/cmdline.rst:894 +#: using/cmdline.rst:891 msgid "Set the family of memory allocators used by Python:" msgstr "" -#: using/cmdline.rst:896 +#: using/cmdline.rst:893 msgid "" "``default``: use the :ref:`default memory allocators `." msgstr "" -#: using/cmdline.rst:898 +#: using/cmdline.rst:895 msgid "" "``malloc``: use the :c:func:`malloc` function of the C library for all " "domains (:c:macro:`PYMEM_DOMAIN_RAW`, :c:macro:`PYMEM_DOMAIN_MEM`, :c:macro:" "`PYMEM_DOMAIN_OBJ`)." msgstr "" -#: using/cmdline.rst:901 +#: using/cmdline.rst:898 msgid "" "``pymalloc``: use the :ref:`pymalloc allocator ` for :c:macro:" "`PYMEM_DOMAIN_MEM` and :c:macro:`PYMEM_DOMAIN_OBJ` domains and use the :c:" "func:`malloc` function for the :c:macro:`PYMEM_DOMAIN_RAW` domain." msgstr "" -#: using/cmdline.rst:905 +#: using/cmdline.rst:902 msgid "Install :ref:`debug hooks `:" msgstr "" -#: using/cmdline.rst:907 +#: using/cmdline.rst:904 msgid "" "``debug``: install debug hooks on top of the :ref:`default memory allocators " "`." msgstr "" -#: using/cmdline.rst:909 +#: using/cmdline.rst:906 msgid "``malloc_debug``: same as ``malloc`` but also install debug hooks." msgstr "" -#: using/cmdline.rst:910 +#: using/cmdline.rst:907 msgid "``pymalloc_debug``: same as ``pymalloc`` but also install debug hooks." msgstr "" -#: using/cmdline.rst:912 +#: using/cmdline.rst:911 msgid "Added the ``\"default\"`` allocator." msgstr "" -#: using/cmdline.rst:920 +#: using/cmdline.rst:917 msgid "" "If set to a non-empty string, Python will print statistics of the :ref:" "`pymalloc memory allocator ` every time a new pymalloc object " "arena is created, and on shutdown." msgstr "" -#: using/cmdline.rst:924 +#: using/cmdline.rst:921 msgid "" "This variable is ignored if the :envvar:`PYTHONMALLOC` environment variable " "is used to force the :c:func:`malloc` allocator of the C library, or if " "Python is configured without ``pymalloc`` support." msgstr "" -#: using/cmdline.rst:928 +#: using/cmdline.rst:925 msgid "" "This variable can now also be used on Python compiled in release mode. It " "now has no effect if set to an empty string." msgstr "" -#: using/cmdline.rst:935 +#: using/cmdline.rst:932 msgid "" "If set to a non-empty string, the default :term:`filesystem encoding and " "error handler` mode will revert to their pre-3.6 values of 'mbcs' and " @@ -1171,41 +1168,41 @@ msgid "" "'surrogatepass' are used." msgstr "" -#: using/cmdline.rst:940 +#: using/cmdline.rst:937 msgid "" "This may also be enabled at runtime with :func:`sys." "_enablelegacywindowsfsencoding()`." msgstr "" -#: using/cmdline.rst:957 +#: using/cmdline.rst:954 msgid ":ref:`Availability `: Windows." msgstr "" -#: using/cmdline.rst:945 +#: using/cmdline.rst:942 msgid "See :pep:`529` for more details." msgstr "" -#: using/cmdline.rst:950 +#: using/cmdline.rst:947 msgid "" "If set to a non-empty string, does not use the new console reader and " "writer. This means that Unicode characters will be encoded according to the " "active console code page, rather than using utf-8." msgstr "" -#: using/cmdline.rst:954 +#: using/cmdline.rst:951 msgid "" "This variable is ignored if the standard streams are redirected (to files or " "pipes) rather than referring to console buffers." msgstr "" -#: using/cmdline.rst:964 +#: using/cmdline.rst:961 msgid "" "If set to the value ``0``, causes the main Python command line application " "to skip coercing the legacy ASCII-based C and POSIX locales to a more " "capable UTF-8 based alternative." msgstr "" -#: using/cmdline.rst:968 +#: using/cmdline.rst:965 msgid "" "If this variable is *not* set (or is set to a value other than ``0``), the " "``LC_ALL`` locale override environment variable is also not set, and the " @@ -1216,19 +1213,19 @@ msgid "" "runtime:" msgstr "" -#: using/cmdline.rst:976 +#: using/cmdline.rst:973 msgid "``C.UTF-8``" msgstr "" -#: using/cmdline.rst:977 +#: using/cmdline.rst:974 msgid "``C.utf8``" msgstr "" -#: using/cmdline.rst:978 +#: using/cmdline.rst:975 msgid "``UTF-8``" msgstr "" -#: using/cmdline.rst:980 +#: using/cmdline.rst:977 msgid "" "If setting one of these locale categories succeeds, then the ``LC_CTYPE`` " "environment variable will also be set accordingly in the current process " @@ -1241,7 +1238,7 @@ msgid "" "(such as Python's own :func:`locale.getdefaultlocale`)." msgstr "" -#: using/cmdline.rst:990 +#: using/cmdline.rst:987 msgid "" "Configuring one of these locales (either explicitly or via the above " "implicit locale coercion) automatically enables the ``surrogateescape`` :ref:" @@ -1251,7 +1248,7 @@ msgid "" "envvar:`PYTHONIOENCODING` as usual." msgstr "" -#: using/cmdline.rst:997 +#: using/cmdline.rst:994 msgid "" "For debugging purposes, setting ``PYTHONCOERCECLOCALE=warn`` will cause " "Python to emit warning messages on ``stderr`` if either the locale coercion " @@ -1259,7 +1256,7 @@ msgid "" "active when the Python runtime is initialized." msgstr "" -#: using/cmdline.rst:1002 +#: using/cmdline.rst:999 msgid "" "Also note that even when locale coercion is disabled, or when it fails to " "find a suitable target locale, :envvar:`PYTHONUTF8` will still activate by " @@ -1268,15 +1265,15 @@ msgid "" "system interfaces." msgstr "" -#: using/cmdline.rst:1008 +#: using/cmdline.rst:1005 msgid ":ref:`Availability `: Unix." msgstr "" -#: using/cmdline.rst:1010 +#: using/cmdline.rst:1007 msgid "See :pep:`538` for more details." msgstr "" -#: using/cmdline.rst:1016 +#: using/cmdline.rst:1013 msgid "" "If this environment variable is set to a non-empty string, enable :ref:" "`Python Development Mode `, introducing additional runtime checks " @@ -1284,31 +1281,31 @@ msgid "" "setting the :option:`-X` ``dev`` option." msgstr "" -#: using/cmdline.rst:1025 +#: using/cmdline.rst:1022 msgid "If set to ``1``, enable the :ref:`Python UTF-8 Mode `." msgstr "" -#: using/cmdline.rst:1027 +#: using/cmdline.rst:1024 msgid "If set to ``0``, disable the :ref:`Python UTF-8 Mode `." msgstr "" -#: using/cmdline.rst:1029 +#: using/cmdline.rst:1026 msgid "" "Setting any other non-empty string causes an error during interpreter " "initialisation." msgstr "" -#: using/cmdline.rst:1036 +#: using/cmdline.rst:1033 msgid "" "If this environment variable is set to a non-empty string, issue a :class:" "`EncodingWarning` when the locale-specific default encoding is used." msgstr "" -#: using/cmdline.rst:1039 +#: using/cmdline.rst:1036 msgid "See :ref:`io-encoding-warning` for details." msgstr "" -#: using/cmdline.rst:1045 +#: using/cmdline.rst:1042 msgid "" "If this variable is set, it disables the inclusion of the tables mapping " "extra location information (end line, start column offset and end column " @@ -1317,38 +1314,38 @@ msgid "" "visual location indicators when the interpreter displays tracebacks." msgstr "" -#: using/cmdline.rst:1055 +#: using/cmdline.rst:1052 msgid "" "If this variable is set to a nonzero value, it enables support for the Linux " "``perf`` profiler so Python calls can be detected by it." msgstr "" -#: using/cmdline.rst:1058 +#: using/cmdline.rst:1055 msgid "If set to ``0``, disable Linux ``perf`` profiler support." msgstr "" -#: using/cmdline.rst:1060 +#: using/cmdline.rst:1057 msgid "" "See also the :option:`-X perf <-X>` command-line option and :ref:" "`perf_profiling`." msgstr "" -#: using/cmdline.rst:1067 +#: using/cmdline.rst:1064 msgid "Debug-mode variables" msgstr "" -#: using/cmdline.rst:1071 +#: using/cmdline.rst:1068 msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter." msgstr "" -#: using/cmdline.rst:1081 +#: using/cmdline.rst:1078 msgid "" "Need Python configured with the :option:`--with-trace-refs` build option." msgstr "" -#: using/cmdline.rst:1078 +#: using/cmdline.rst:1075 msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter into a file called *FILENAME*." diff --git a/using/configure.po b/using/configure.po index 722aa6f25..f5e2b6410 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: 2023-12-01 14:57+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -20,91 +20,91 @@ msgstr "" msgid "Configure Python" msgstr "" -#: using/configure.rst:6 +#: using/configure.rst:8 msgid "Build Requirements" msgstr "" -#: using/configure.rst:8 +#: using/configure.rst:10 msgid "Features required to build CPython:" msgstr "" -#: using/configure.rst:10 +#: using/configure.rst:12 msgid "" "A `C11 `_ compiler. `Optional C11 " "features `_ are not required." msgstr "" -#: using/configure.rst:15 +#: using/configure.rst:17 msgid "" "Support for `IEEE 754 `_ floating " "point numbers and `floating point Not-a-Number (NaN) `_." msgstr "" -#: using/configure.rst:19 +#: using/configure.rst:21 msgid "Support for threads." msgstr "" -#: using/configure.rst:21 +#: using/configure.rst:23 msgid "OpenSSL 1.1.1 or newer for the :mod:`ssl` and :mod:`hashlib` modules." msgstr "" -#: using/configure.rst:23 +#: using/configure.rst:25 msgid "On Windows, Microsoft Visual Studio 2017 or later is required." msgstr "" -#: using/configure.rst:25 -msgid "" -"C11 compiler, IEEE 754 and NaN support are now required. On Windows, Visual " -"Studio 2017 or later is required." +#: using/configure.rst:27 +msgid "On Windows, Visual Studio 2015 or later is required." msgstr "" -#: using/configure.rst:29 -msgid "OpenSSL 1.1.1 is now required." +#: using/configure.rst:30 +msgid "" +"Selected C99 features are now required, like ```` and ``static " +"inline`` functions." msgstr "" -#: using/configure.rst:32 +#: using/configure.rst:34 msgid "Thread support and OpenSSL 1.0.2 are now required." msgstr "" -#: using/configure.rst:35 -msgid "" -"Selected C99 features are now required, like ```` and ``static " -"inline`` functions." +#: using/configure.rst:37 +msgid "OpenSSL 1.1.1 is now required." msgstr "" -#: using/configure.rst:39 -msgid "On Windows, Visual Studio 2015 or later is required." +#: using/configure.rst:40 +msgid "" +"C11 compiler, IEEE 754 and NaN support are now required. On Windows, Visual " +"Studio 2017 or later is required." msgstr "" -#: using/configure.rst:42 +#: using/configure.rst:44 msgid "" "See also :pep:`7` \"Style Guide for C Code\" and :pep:`11` \"CPython " "platform support\"." msgstr "" -#: using/configure.rst:47 +#: using/configure.rst:49 msgid "Generated files" msgstr "" -#: using/configure.rst:49 +#: using/configure.rst:51 msgid "" "To reduce build dependencies, Python source code contains multiple generated " "files. Commands to regenerate all generated files::" msgstr "" -#: using/configure.rst:57 +#: using/configure.rst:59 msgid "" "The ``Makefile.pre.in`` file documents generated files, their inputs, and " "tools used to regenerate them. Search for ``regen-*`` make targets." msgstr "" -#: using/configure.rst:61 +#: using/configure.rst:63 msgid "configure script" msgstr "" -#: using/configure.rst:63 +#: using/configure.rst:65 msgid "" "The ``make regen-configure`` command regenerates the ``aclocal.m4`` file and " "the ``configure`` script using the ``Tools/build/regen-configure.sh`` shell " @@ -112,73 +112,73 @@ msgid "" "have a reproducible output." msgstr "" -#: using/configure.rst:68 +#: using/configure.rst:70 msgid "The container is optional, the following command can be run locally::" msgstr "" -#: using/configure.rst:72 +#: using/configure.rst:74 msgid "" "The generated files can change depending on the exact ``autoconf-archive``, " "``aclocal`` and ``pkg-config`` versions." msgstr "" -#: using/configure.rst:79 +#: using/configure.rst:81 msgid "Configure Options" msgstr "" -#: using/configure.rst:81 +#: using/configure.rst:83 msgid "List all ``./configure`` script options using::" msgstr "" -#: using/configure.rst:85 +#: using/configure.rst:87 msgid "" "See also the :file:`Misc/SpecialBuilds.txt` in the Python source " "distribution." msgstr "" -#: using/configure.rst:88 +#: using/configure.rst:90 msgid "General Options" msgstr "" -#: using/configure.rst:92 +#: using/configure.rst:94 msgid "" "Support loadable extensions in the :mod:`!_sqlite` extension module (default " "is no) of the :mod:`sqlite3` module." msgstr "" -#: using/configure.rst:95 +#: using/configure.rst:97 msgid "" "See the :meth:`sqlite3.Connection.enable_load_extension` method of the :mod:" "`sqlite3` module." msgstr "" -#: using/configure.rst:102 +#: using/configure.rst:104 msgid "" "Disable IPv6 support (enabled by default if supported), see the :mod:" "`socket` module." msgstr "" -#: using/configure.rst:107 +#: using/configure.rst:109 msgid "Define the size in bits of Python :class:`int` digits: 15 or 30 bits." msgstr "" -#: using/configure.rst:109 +#: using/configure.rst:111 msgid "By default, the digit size is 30." msgstr "" -#: using/configure.rst:111 +#: using/configure.rst:113 msgid "Define the ``PYLONG_BITS_IN_DIGIT`` to ``15`` or ``30``." msgstr "" -#: using/configure.rst:113 +#: using/configure.rst:115 msgid "See :data:`sys.int_info.bits_per_digit `." msgstr "" -#: using/configure.rst:117 +#: using/configure.rst:119 msgid "Set the Python executable suffix to *SUFFIX*." msgstr "" -#: using/configure.rst:119 +#: using/configure.rst:121 msgid "" "The default suffix is ``.exe`` on Windows and macOS (``python.exe`` " "executable), ``.js`` on Emscripten node, ``.html`` on Emscripten browser, ``." @@ -186,95 +186,95 @@ msgid "" "executable)." msgstr "" -#: using/configure.rst:124 +#: using/configure.rst:126 msgid "" "The default suffix on WASM platform is one of ``.js``, ``.html`` or ``." "wasm``." msgstr "" -#: using/configure.rst:130 +#: using/configure.rst:132 msgid "" "Select the default time zone search path for :const:`zoneinfo.TZPATH`. See " "the :ref:`Compile-time configuration ` of " "the :mod:`zoneinfo` module." msgstr "" -#: using/configure.rst:134 +#: using/configure.rst:136 msgid "" "Default: ``/usr/share/zoneinfo:/usr/lib/zoneinfo:/usr/share/lib/zoneinfo:/" "etc/zoneinfo``." msgstr "" -#: using/configure.rst:136 +#: using/configure.rst:138 msgid "See :data:`os.pathsep` path separator." msgstr "" -#: using/configure.rst:142 +#: using/configure.rst:144 msgid "" "Build the ``_decimal`` extension module using a thread-local context rather " "than a coroutine-local context (default), see the :mod:`decimal` module." msgstr "" -#: using/configure.rst:145 +#: using/configure.rst:147 msgid "See :const:`decimal.HAVE_CONTEXTVAR` and the :mod:`contextvars` module." msgstr "" -#: using/configure.rst:151 +#: using/configure.rst:153 msgid "Override order to check db backends for the :mod:`dbm` module" msgstr "" -#: using/configure.rst:153 +#: using/configure.rst:155 msgid "" "A valid value is a colon (``:``) separated string with the backend names:" msgstr "" -#: using/configure.rst:155 +#: using/configure.rst:157 msgid "``ndbm``;" msgstr "" -#: using/configure.rst:156 +#: using/configure.rst:158 msgid "``gdbm``;" msgstr "" -#: using/configure.rst:157 +#: using/configure.rst:159 msgid "``bdb``." msgstr "" -#: using/configure.rst:161 +#: using/configure.rst:163 msgid "Disable C locale coercion to a UTF-8 based locale (enabled by default)." msgstr "" -#: using/configure.rst:163 +#: using/configure.rst:165 msgid "Don't define the ``PY_COERCE_C_LOCALE`` macro." msgstr "" -#: using/configure.rst:165 +#: using/configure.rst:167 msgid "See :envvar:`PYTHONCOERCECLOCALE` and the :pep:`538`." msgstr "" -#: using/configure.rst:169 +#: using/configure.rst:171 msgid "Disable all freelists except the empty tuple singleton." msgstr "" -#: using/configure.rst:175 +#: using/configure.rst:177 msgid "Python library directory name (default is ``lib``)." msgstr "" -#: using/configure.rst:177 +#: using/configure.rst:179 msgid "Fedora and SuSE use ``lib64`` on 64-bit platforms." msgstr "" -#: using/configure.rst:179 +#: using/configure.rst:181 msgid "See :data:`sys.platlibdir`." msgstr "" -#: using/configure.rst:185 +#: using/configure.rst:187 msgid "" "Directory of wheel packages used by the :mod:`ensurepip` module (none by " "default)." msgstr "" -#: using/configure.rst:188 +#: using/configure.rst:190 msgid "" "Some Linux distribution packaging policies recommend against bundling " "dependencies. For example, Fedora installs wheel packages in the ``/usr/" @@ -282,201 +282,201 @@ msgid "" "_bundled` package." msgstr "" -#: using/configure.rst:197 +#: using/configure.rst:199 msgid "" "Whether configure should use :program:`pkg-config` to detect build " "dependencies." msgstr "" -#: using/configure.rst:200 +#: using/configure.rst:202 msgid "``check`` (default): :program:`pkg-config` is optional" msgstr "" -#: using/configure.rst:201 +#: using/configure.rst:203 msgid "``yes``: :program:`pkg-config` is mandatory" msgstr "" -#: using/configure.rst:202 +#: using/configure.rst:204 msgid "``no``: configure does not use :program:`pkg-config` even when present" msgstr "" -#: using/configure.rst:208 +#: using/configure.rst:210 msgid "Turn on internal statistics gathering." msgstr "" -#: using/configure.rst:210 +#: using/configure.rst:212 msgid "" "The statistics will be dumped to a arbitrary (probably unique) file in ``/" "tmp/py_stats/``, or ``C:\\temp\\py_stats\\`` on Windows. If that directory " "does not exist, results will be printed on stdout." msgstr "" -#: using/configure.rst:214 +#: using/configure.rst:216 msgid "Use ``Tools/scripts/summarize_stats.py`` to read the stats." msgstr "" -#: using/configure.rst:219 +#: using/configure.rst:221 msgid "WebAssembly Options" msgstr "" -#: using/configure.rst:223 +#: using/configure.rst:225 msgid "Set build flavor for ``wasm32-emscripten``." msgstr "" -#: using/configure.rst:225 +#: using/configure.rst:227 msgid "``browser`` (default): preload minimal stdlib, default MEMFS." msgstr "" -#: using/configure.rst:226 +#: using/configure.rst:228 msgid "``node``: NODERAWFS and pthread support." msgstr "" -#: using/configure.rst:232 +#: using/configure.rst:234 msgid "Turn on dynamic linking support for WASM." msgstr "" -#: using/configure.rst:234 +#: using/configure.rst:236 msgid "" "Dynamic linking enables ``dlopen``. File size of the executable increases " "due to limited dead code elimination and additional features." msgstr "" -#: using/configure.rst:241 +#: using/configure.rst:243 msgid "Turn on pthreads support for WASM." msgstr "" -#: using/configure.rst:247 +#: using/configure.rst:249 msgid "Install Options" msgstr "" -#: using/configure.rst:251 +#: using/configure.rst:253 msgid "" "Install architecture-independent files in PREFIX. On Unix, it defaults to :" "file:`/usr/local`." msgstr "" -#: using/configure.rst:254 +#: using/configure.rst:256 msgid "This value can be retrieved at runtime using :data:`sys.prefix`." msgstr "" -#: using/configure.rst:256 +#: using/configure.rst:258 msgid "" "As an example, one can use ``--prefix=\"$HOME/.local/\"`` to install a " "Python in its home directory." msgstr "" -#: using/configure.rst:261 +#: using/configure.rst:263 msgid "" "Install architecture-dependent files in EPREFIX, defaults to :option:`--" "prefix`." msgstr "" -#: using/configure.rst:263 +#: using/configure.rst:265 msgid "This value can be retrieved at runtime using :data:`sys.exec_prefix`." msgstr "" -#: using/configure.rst:267 +#: using/configure.rst:269 msgid "" "Don't build nor install test modules, like the :mod:`test` package or the :" "mod:`!_testcapi` extension module (built and installed by default)." msgstr "" -#: using/configure.rst:274 +#: using/configure.rst:276 msgid "Select the :mod:`ensurepip` command run on Python installation:" msgstr "" -#: using/configure.rst:276 +#: using/configure.rst:278 msgid "" "``upgrade`` (default): run ``python -m ensurepip --altinstall --upgrade`` " "command." msgstr "" -#: using/configure.rst:278 +#: using/configure.rst:280 msgid "``install``: run ``python -m ensurepip --altinstall`` command;" msgstr "" -#: using/configure.rst:279 +#: using/configure.rst:281 msgid "``no``: don't run ensurepip;" msgstr "" -#: using/configure.rst:285 +#: using/configure.rst:287 msgid "Performance options" msgstr "" -#: using/configure.rst:287 +#: using/configure.rst:289 msgid "" "Configuring Python using ``--enable-optimizations --with-lto`` (PGO + LTO) " "is recommended for best performance. The experimental ``--enable-bolt`` flag " "can also be used to improve performance." msgstr "" -#: using/configure.rst:293 +#: using/configure.rst:295 msgid "" "Enable Profile Guided Optimization (PGO) using :envvar:`PROFILE_TASK` " "(disabled by default)." msgstr "" -#: using/configure.rst:296 +#: using/configure.rst:298 msgid "" "The C compiler Clang requires ``llvm-profdata`` program for PGO. On macOS, " "GCC also requires it: GCC is just an alias to Clang on macOS." msgstr "" -#: using/configure.rst:299 +#: using/configure.rst:301 msgid "" "Disable also semantic interposition in libpython if ``--enable-shared`` and " "GCC is used: add ``-fno-semantic-interposition`` to the compiler and linker " "flags." msgstr "" -#: using/configure.rst:305 +#: using/configure.rst:307 msgid "Use ``-fno-semantic-interposition`` on GCC." msgstr "" -#: using/configure.rst:310 +#: using/configure.rst:312 msgid "" "Environment variable used in the Makefile: Python command line arguments for " "the PGO generation task." msgstr "" -#: using/configure.rst:313 +#: using/configure.rst:315 msgid "Default: ``-m test --pgo --timeout=$(TESTTIMEOUT)``." msgstr "" -#: using/configure.rst:319 +#: using/configure.rst:321 msgid "Enable Link Time Optimization (LTO) in any build (disabled by default)." msgstr "" -#: using/configure.rst:321 +#: using/configure.rst:323 msgid "" "The C compiler Clang requires ``llvm-ar`` for LTO (``ar`` on macOS), as well " "as an LTO-aware linker (``ld.gold`` or ``lld``)." msgstr "" -#: using/configure.rst:326 +#: using/configure.rst:328 msgid "To use ThinLTO feature, use ``--with-lto=thin`` on Clang." msgstr "" -#: using/configure.rst:329 +#: using/configure.rst:331 msgid "" "Use ThinLTO as the default optimization policy on Clang if the compiler " "accepts the flag." msgstr "" -#: using/configure.rst:334 +#: using/configure.rst:336 msgid "" "Enable usage of the `BOLT post-link binary optimizer `_ (disabled by default)." msgstr "" -#: using/configure.rst:338 +#: using/configure.rst:340 msgid "" "BOLT is part of the LLVM project but is not always included in their binary " "distributions. This flag requires that ``llvm-bolt`` and ``merge-fdata`` are " "available." msgstr "" -#: using/configure.rst:342 +#: using/configure.rst:344 msgid "" "BOLT is still a fairly new project so this flag should be considered " "experimental for now. Because this tool operates on machine code its success " @@ -487,7 +487,7 @@ msgid "" "encouraged." msgstr "" -#: using/configure.rst:350 +#: using/configure.rst:352 msgid "" "The :envvar:`!BOLT_INSTRUMENT_FLAGS` and :envvar:`!BOLT_APPLY_FLAGS` :" "program:`configure` variables can be defined to override the default set of " @@ -495,101 +495,101 @@ msgid "" "binaries, respectively." msgstr "" -#: using/configure.rst:359 +#: using/configure.rst:361 msgid "" "Enable computed gotos in evaluation loop (enabled by default on supported " "compilers)." msgstr "" -#: using/configure.rst:364 +#: using/configure.rst:366 msgid "" "Disable the specialized Python memory allocator :ref:`pymalloc ` " "(enabled by default)." msgstr "" -#: using/configure.rst:367 +#: using/configure.rst:369 msgid "See also :envvar:`PYTHONMALLOC` environment variable." msgstr "" -#: using/configure.rst:371 +#: using/configure.rst:373 msgid "" "Disable static documentation strings to reduce the memory footprint (enabled " "by default). Documentation strings defined in Python are not affected." msgstr "" -#: using/configure.rst:374 +#: using/configure.rst:376 msgid "Don't define the ``WITH_DOC_STRINGS`` macro." msgstr "" -#: using/configure.rst:376 +#: using/configure.rst:378 msgid "See the ``PyDoc_STRVAR()`` macro." msgstr "" -#: using/configure.rst:380 +#: using/configure.rst:382 msgid "Enable C-level code profiling with ``gprof`` (disabled by default)." msgstr "" -#: using/configure.rst:384 +#: using/configure.rst:386 msgid "" "Add ``-fstrict-overflow`` to the C compiler flags (by default we add ``-fno-" "strict-overflow`` instead)." msgstr "" -#: using/configure.rst:391 +#: using/configure.rst:393 msgid "Python Debug Build" msgstr "" -#: using/configure.rst:393 +#: using/configure.rst:395 msgid "" "A debug build is Python built with the :option:`--with-pydebug` configure " "option." msgstr "" -#: using/configure.rst:396 +#: using/configure.rst:398 msgid "Effects of a debug build:" msgstr "" -#: using/configure.rst:398 +#: using/configure.rst:400 msgid "" "Display all warnings by default: the list of default warning filters is " "empty in the :mod:`warnings` module." msgstr "" -#: using/configure.rst:400 +#: using/configure.rst:402 msgid "Add ``d`` to :data:`sys.abiflags`." msgstr "" -#: using/configure.rst:401 +#: using/configure.rst:403 msgid "Add :func:`!sys.gettotalrefcount` function." msgstr "" -#: using/configure.rst:402 +#: using/configure.rst:404 msgid "Add :option:`-X showrefcount <-X>` command line option." msgstr "" -#: using/configure.rst:403 +#: using/configure.rst:405 msgid "" "Add :option:`-d` command line option and :envvar:`PYTHONDEBUG` environment " "variable to debug the parser." msgstr "" -#: using/configure.rst:405 +#: using/configure.rst:407 msgid "" "Add support for the ``__lltrace__`` variable: enable low-level tracing in " "the bytecode evaluation loop if the variable is defined." msgstr "" -#: using/configure.rst:407 +#: using/configure.rst:409 msgid "" "Install :ref:`debug hooks on memory allocators ` " "to detect buffer overflow and other memory errors." msgstr "" -#: using/configure.rst:409 +#: using/configure.rst:411 msgid "Define ``Py_DEBUG`` and ``Py_REF_DEBUG`` macros." msgstr "" -#: using/configure.rst:410 +#: using/configure.rst:412 msgid "" "Add runtime checks: code surrounded by ``#ifdef Py_DEBUG`` and ``#endif``. " "Enable ``assert(...)`` and ``_PyObject_ASSERT(...)`` assertions: don't set " @@ -597,45 +597,45 @@ msgid "" "option). Main runtime checks:" msgstr "" -#: using/configure.rst:415 +#: using/configure.rst:417 msgid "Add sanity checks on the function arguments." msgstr "" -#: using/configure.rst:416 +#: using/configure.rst:418 msgid "" "Unicode and int objects are created with their memory filled with a pattern " "to detect usage of uninitialized objects." msgstr "" -#: using/configure.rst:418 +#: using/configure.rst:420 msgid "" "Ensure that functions which can clear or replace the current exception are " "not called with an exception raised." msgstr "" -#: using/configure.rst:420 +#: using/configure.rst:422 msgid "Check that deallocator functions don't change the current exception." msgstr "" -#: using/configure.rst:421 +#: using/configure.rst:423 msgid "" "The garbage collector (:func:`gc.collect` function) runs some basic checks " "on objects consistency." msgstr "" -#: using/configure.rst:423 +#: using/configure.rst:425 msgid "" "The :c:macro:`!Py_SAFE_DOWNCAST()` macro checks for integer underflow and " "overflow when downcasting from wide types to narrow types." msgstr "" -#: using/configure.rst:426 +#: using/configure.rst:428 msgid "" "See also the :ref:`Python Development Mode ` and the :option:`--" "with-trace-refs` configure option." msgstr "" -#: using/configure.rst:429 +#: using/configure.rst:431 msgid "" "Release builds and debug builds are now ABI compatible: defining the " "``Py_DEBUG`` macro no longer implies the ``Py_TRACE_REFS`` macro (see the :" @@ -643,320 +643,320 @@ msgid "" "incompatibility." msgstr "" -#: using/configure.rst:437 +#: using/configure.rst:439 msgid "Debug options" msgstr "" -#: using/configure.rst:441 +#: using/configure.rst:443 msgid "" ":ref:`Build Python in debug mode `: define the ``Py_DEBUG`` " "macro (disabled by default)." msgstr "" -#: using/configure.rst:446 +#: using/configure.rst:448 msgid "Enable tracing references for debugging purpose (disabled by default)." msgstr "" -#: using/configure.rst:448 +#: using/configure.rst:450 msgid "Effects:" msgstr "" -#: using/configure.rst:450 +#: using/configure.rst:452 msgid "Define the ``Py_TRACE_REFS`` macro." msgstr "" -#: using/configure.rst:451 +#: using/configure.rst:453 msgid "Add :func:`!sys.getobjects` function." msgstr "" -#: using/configure.rst:452 +#: using/configure.rst:454 msgid "Add :envvar:`PYTHONDUMPREFS` environment variable." msgstr "" -#: using/configure.rst:454 +#: using/configure.rst:456 msgid "" "This build is not ABI compatible with release build (default build) or debug " "build (``Py_DEBUG`` and ``Py_REF_DEBUG`` macros)." msgstr "" -#: using/configure.rst:461 +#: using/configure.rst:463 msgid "" "Build with C assertions enabled (default is no): ``assert(...);`` and " "``_PyObject_ASSERT(...);``." msgstr "" -#: using/configure.rst:464 +#: using/configure.rst:466 msgid "" "If set, the ``NDEBUG`` macro is not defined in the :envvar:`OPT` compiler " "variable." msgstr "" -#: using/configure.rst:467 +#: using/configure.rst:469 msgid "" "See also the :option:`--with-pydebug` option (:ref:`debug build `) which also enables assertions." msgstr "" -#: using/configure.rst:474 +#: using/configure.rst:476 msgid "Enable Valgrind support (default is no)." msgstr "" -#: using/configure.rst:478 +#: using/configure.rst:480 msgid "Enable DTrace support (default is no)." msgstr "" -#: using/configure.rst:480 +#: using/configure.rst:482 msgid "" "See :ref:`Instrumenting CPython with DTrace and SystemTap `." msgstr "" -#: using/configure.rst:487 +#: using/configure.rst:489 msgid "" "Enable AddressSanitizer memory error detector, ``asan`` (default is no)." msgstr "" -#: using/configure.rst:493 +#: using/configure.rst:495 msgid "" "Enable MemorySanitizer allocation error detector, ``msan`` (default is no)." msgstr "" -#: using/configure.rst:499 +#: using/configure.rst:501 msgid "" "Enable UndefinedBehaviorSanitizer undefined behaviour detector, ``ubsan`` " "(default is no)." msgstr "" -#: using/configure.rst:506 +#: using/configure.rst:508 msgid "Linker options" msgstr "" -#: using/configure.rst:510 +#: using/configure.rst:512 msgid "Enable building a shared Python library: ``libpython`` (default is no)." msgstr "" -#: using/configure.rst:514 +#: using/configure.rst:516 msgid "" "Do not build ``libpythonMAJOR.MINOR.a`` and do not install ``python.o`` " "(built and enabled by default)." msgstr "" -#: using/configure.rst:521 +#: using/configure.rst:523 msgid "Libraries options" msgstr "" -#: using/configure.rst:525 +#: using/configure.rst:527 msgid "Link against additional libraries (default is no)." msgstr "" -#: using/configure.rst:529 +#: using/configure.rst:531 msgid "" "Build the :mod:`!pyexpat` module using an installed ``expat`` library " "(default is no)." msgstr "" -#: using/configure.rst:534 +#: using/configure.rst:536 msgid "" "Build the ``_decimal`` extension module using an installed ``mpdec`` " "library, see the :mod:`decimal` module (default is no)." msgstr "" -#: using/configure.rst:541 +#: using/configure.rst:543 msgid "Use ``editline`` library for backend of the :mod:`readline` module." msgstr "" -#: using/configure.rst:543 +#: using/configure.rst:545 msgid "Define the ``WITH_EDITLINE`` macro." msgstr "" -#: using/configure.rst:549 +#: using/configure.rst:551 msgid "Don't build the :mod:`readline` module (built by default)." msgstr "" -#: using/configure.rst:551 +#: using/configure.rst:553 msgid "Don't define the ``HAVE_LIBREADLINE`` macro." msgstr "" -#: using/configure.rst:557 +#: using/configure.rst:559 msgid "" "Override ``libm`` math library to *STRING* (default is system-dependent)." msgstr "" -#: using/configure.rst:561 +#: using/configure.rst:563 msgid "Override ``libc`` C library to *STRING* (default is system-dependent)." msgstr "" -#: using/configure.rst:565 +#: using/configure.rst:567 msgid "Root of the OpenSSL directory." msgstr "" -#: using/configure.rst:571 +#: using/configure.rst:573 msgid "Set runtime library directory (rpath) for OpenSSL libraries:" msgstr "" -#: using/configure.rst:573 +#: using/configure.rst:575 msgid "``no`` (default): don't set rpath;" msgstr "" -#: using/configure.rst:574 +#: using/configure.rst:576 msgid "" "``auto``: auto-detect rpath from :option:`--with-openssl` and ``pkg-config``;" msgstr "" -#: using/configure.rst:576 +#: using/configure.rst:578 msgid "*DIR*: set an explicit rpath." msgstr "" -#: using/configure.rst:582 +#: using/configure.rst:584 msgid "Security Options" msgstr "" -#: using/configure.rst:586 +#: using/configure.rst:588 msgid "Select hash algorithm for use in ``Python/pyhash.c``:" msgstr "" -#: using/configure.rst:588 +#: using/configure.rst:590 msgid "``siphash13`` (default);" msgstr "" -#: using/configure.rst:589 +#: using/configure.rst:591 msgid "``siphash24``;" msgstr "" -#: using/configure.rst:590 +#: using/configure.rst:592 msgid "``fnv``." msgstr "" -#: using/configure.rst:594 +#: using/configure.rst:596 msgid "``siphash13`` is added and it is the new default." msgstr "" -#: using/configure.rst:599 +#: using/configure.rst:601 msgid "Built-in hash modules:" msgstr "" -#: using/configure.rst:601 +#: using/configure.rst:603 msgid "``md5``;" msgstr "" -#: using/configure.rst:602 +#: using/configure.rst:604 msgid "``sha1``;" msgstr "" -#: using/configure.rst:603 +#: using/configure.rst:605 msgid "``sha256``;" msgstr "" -#: using/configure.rst:604 +#: using/configure.rst:606 msgid "``sha512``;" msgstr "" -#: using/configure.rst:605 +#: using/configure.rst:607 msgid "``sha3`` (with shake);" msgstr "" -#: using/configure.rst:606 +#: using/configure.rst:608 msgid "``blake2``." msgstr "" -#: using/configure.rst:612 +#: using/configure.rst:614 msgid "Override the OpenSSL default cipher suites string:" msgstr "" -#: using/configure.rst:614 +#: using/configure.rst:616 msgid "``python`` (default): use Python's preferred selection;" msgstr "" -#: using/configure.rst:615 +#: using/configure.rst:617 msgid "``openssl``: leave OpenSSL's defaults untouched;" msgstr "" -#: using/configure.rst:616 +#: using/configure.rst:618 msgid "*STRING*: use a custom string" msgstr "" -#: using/configure.rst:618 +#: using/configure.rst:620 msgid "See the :mod:`ssl` module." msgstr "" -#: using/configure.rst:624 +#: using/configure.rst:626 msgid "" "The settings ``python`` and *STRING* also set TLS 1.2 as minimum protocol " "version." msgstr "" -#: using/configure.rst:628 +#: using/configure.rst:630 msgid "macOS Options" msgstr "" -#: using/configure.rst:630 +#: using/configure.rst:632 msgid "See ``Mac/README.rst``." msgstr "" -#: using/configure.rst:635 +#: using/configure.rst:637 msgid "" "Create a universal binary build. *SDKDIR* specifies which macOS SDK should " "be used to perform the build (default is no)." msgstr "" -#: using/configure.rst:641 +#: using/configure.rst:643 msgid "" "Create a Python.framework rather than a traditional Unix install. Optional " "*INSTALLDIR* specifies the installation path (default is no)." msgstr "" -#: using/configure.rst:646 +#: using/configure.rst:648 msgid "" "Specify the kind of universal binary that should be created. This option is " "only valid when :option:`--enable-universalsdk` is set." msgstr "" -#: using/configure.rst:649 +#: using/configure.rst:651 msgid "Options:" msgstr "" -#: using/configure.rst:651 +#: using/configure.rst:653 msgid "``universal2``;" msgstr "" -#: using/configure.rst:652 +#: using/configure.rst:654 msgid "``32-bit``;" msgstr "" -#: using/configure.rst:653 +#: using/configure.rst:655 msgid "``64-bit``;" msgstr "" -#: using/configure.rst:654 +#: using/configure.rst:656 msgid "``3-way``;" msgstr "" -#: using/configure.rst:655 +#: using/configure.rst:657 msgid "``intel``;" msgstr "" -#: using/configure.rst:656 +#: using/configure.rst:658 msgid "``intel-32``;" msgstr "" -#: using/configure.rst:657 +#: using/configure.rst:659 msgid "``intel-64``;" msgstr "" -#: using/configure.rst:658 +#: using/configure.rst:660 msgid "``all``." msgstr "" -#: using/configure.rst:662 +#: using/configure.rst:664 msgid "" "Specify the name for the python framework on macOS only valid when :option:" "`--enable-framework` is set (default: ``Python``)." msgstr "" -#: using/configure.rst:667 +#: using/configure.rst:669 msgid "Cross Compiling Options" msgstr "" -#: using/configure.rst:669 +#: using/configure.rst:671 msgid "" "Cross compiling, also known as cross building, can be used to build Python " "for another CPU architecture or platform. Cross compiling requires a Python " @@ -964,95 +964,95 @@ msgid "" "match the version of the cross compiled host Python." msgstr "" -#: using/configure.rst:676 +#: using/configure.rst:678 msgid "" "configure for building on BUILD, usually guessed by :program:`config.guess`." msgstr "" -#: using/configure.rst:680 +#: using/configure.rst:682 msgid "cross-compile to build programs to run on HOST (target platform)" msgstr "" -#: using/configure.rst:684 +#: using/configure.rst:686 msgid "path to build ``python`` binary for cross compiling" msgstr "" -#: using/configure.rst:690 +#: using/configure.rst:692 msgid "An environment variable that points to a file with configure overrides." msgstr "" -#: using/configure.rst:692 -msgid "Example *config.site* file::" +#: using/configure.rst:694 +msgid "Example *config.site* file:" msgstr "" -#: using/configure.rst:700 +#: using/configure.rst:704 msgid "Cross compiling example::" msgstr "" -#: using/configure.rst:709 +#: using/configure.rst:713 msgid "Python Build System" msgstr "" -#: using/configure.rst:712 +#: using/configure.rst:716 msgid "Main files of the build system" msgstr "" -#: using/configure.rst:714 +#: using/configure.rst:718 msgid ":file:`configure.ac` => :file:`configure`;" msgstr "" -#: using/configure.rst:715 +#: using/configure.rst:719 msgid "" ":file:`Makefile.pre.in` => :file:`Makefile` (created by :file:`configure`);" msgstr "" -#: using/configure.rst:716 +#: using/configure.rst:720 msgid ":file:`pyconfig.h` (created by :file:`configure`);" msgstr "" -#: using/configure.rst:717 +#: using/configure.rst:721 msgid "" ":file:`Modules/Setup`: C extensions built by the Makefile using :file:" "`Module/makesetup` shell script;" msgstr "" -#: using/configure.rst:721 +#: using/configure.rst:725 msgid "Main build steps" msgstr "" -#: using/configure.rst:723 +#: using/configure.rst:727 msgid "C files (``.c``) are built as object files (``.o``)." msgstr "" -#: using/configure.rst:724 +#: using/configure.rst:728 msgid "A static ``libpython`` library (``.a``) is created from objects files." msgstr "" -#: using/configure.rst:725 +#: using/configure.rst:729 msgid "" "``python.o`` and the static ``libpython`` library are linked into the final " "``python`` program." msgstr "" -#: using/configure.rst:727 +#: using/configure.rst:731 msgid "C extensions are built by the Makefile (see :file:`Modules/Setup`)." msgstr "" -#: using/configure.rst:730 +#: using/configure.rst:734 msgid "Main Makefile targets" msgstr "" -#: using/configure.rst:732 +#: using/configure.rst:736 msgid "``make``: Build Python with the standard library." msgstr "" -#: using/configure.rst:733 +#: using/configure.rst:737 msgid "" "``make platform:``: build the ``python`` program, but don't build the " "standard library extension modules." msgstr "" -#: using/configure.rst:735 +#: using/configure.rst:739 msgid "" "``make profile-opt``: build Python using Profile Guided Optimization (PGO). " "You can use the configure :option:`--enable-optimizations` option to make " @@ -1060,53 +1060,53 @@ msgid "" "``make``)." msgstr "" -#: using/configure.rst:739 +#: using/configure.rst:743 msgid "" "``make buildbottest``: Build Python and run the Python test suite, the same " "way than buildbots test Python. Set ``TESTTIMEOUT`` variable (in seconds) to " "change the test timeout (1200 by default: 20 minutes)." msgstr "" -#: using/configure.rst:742 +#: using/configure.rst:746 msgid "``make install``: Build and install Python." msgstr "" -#: using/configure.rst:743 +#: using/configure.rst:747 msgid "" "``make regen-all``: Regenerate (almost) all generated files; ``make regen-" "stdlib-module-names`` and ``autoconf`` must be run separately for the " "remaining generated files." msgstr "" -#: using/configure.rst:746 +#: using/configure.rst:750 msgid "``make clean``: Remove built files." msgstr "" -#: using/configure.rst:747 +#: using/configure.rst:751 msgid "" "``make distclean``: Same than ``make clean``, but remove also files created " "by the configure script." msgstr "" -#: using/configure.rst:751 +#: using/configure.rst:755 msgid "C extensions" msgstr "" -#: using/configure.rst:753 +#: using/configure.rst:757 msgid "" "Some C extensions are built as built-in modules, like the ``sys`` module. " "They are built with the ``Py_BUILD_CORE_BUILTIN`` macro defined. Built-in " -"modules have no ``__file__`` attribute::" +"modules have no ``__file__`` attribute:" msgstr "" -#: using/configure.rst:765 +#: using/configure.rst:771 msgid "" "Other C extensions are built as dynamic libraries, like the ``_asyncio`` " "module. They are built with the ``Py_BUILD_CORE_MODULE`` macro defined. " -"Example on Linux x86-64::" +"Example on Linux x86-64:" msgstr "" -#: using/configure.rst:775 +#: using/configure.rst:783 msgid "" ":file:`Modules/Setup` is used to generate Makefile targets to build C " "extensions. At the beginning of the files, C extensions are built as built-" @@ -1114,303 +1114,303 @@ msgid "" "dynamic libraries." msgstr "" -#: using/configure.rst:779 +#: using/configure.rst:787 msgid "" "The :c:macro:`!PyAPI_FUNC()`, :c:macro:`!PyAPI_DATA()` and :c:macro:" "`PyMODINIT_FUNC` macros of :file:`Include/exports.h` are defined differently " "depending if the ``Py_BUILD_CORE_MODULE`` macro is defined:" msgstr "" -#: using/configure.rst:783 +#: using/configure.rst:791 msgid "Use ``Py_EXPORTED_SYMBOL`` if the ``Py_BUILD_CORE_MODULE`` is defined" msgstr "" -#: using/configure.rst:784 +#: using/configure.rst:792 msgid "Use ``Py_IMPORTED_SYMBOL`` otherwise." msgstr "" -#: using/configure.rst:786 +#: using/configure.rst:794 msgid "" "If the ``Py_BUILD_CORE_BUILTIN`` macro is used by mistake on a C extension " "built as a shared library, its :samp:`PyInit_{xxx}()` function is not " "exported, causing an :exc:`ImportError` on import." msgstr "" -#: using/configure.rst:792 +#: using/configure.rst:800 msgid "Compiler and linker flags" msgstr "" -#: using/configure.rst:794 +#: using/configure.rst:802 msgid "" "Options set by the ``./configure`` script and environment variables and used " "by ``Makefile``." msgstr "" -#: using/configure.rst:798 +#: using/configure.rst:806 msgid "Preprocessor flags" msgstr "" -#: using/configure.rst:802 +#: using/configure.rst:810 msgid "" "Value of :envvar:`CPPFLAGS` variable passed to the ``./configure`` script." msgstr "" -#: using/configure.rst:808 +#: using/configure.rst:816 msgid "" "(Objective) C/C++ preprocessor flags, e.g. :samp:`-I{include_dir}` if you " "have headers in a nonstandard directory *include_dir*." msgstr "" -#: using/configure.rst:1001 +#: using/configure.rst:1009 msgid "" "Both :envvar:`CPPFLAGS` and :envvar:`LDFLAGS` need to contain the shell's " "value to be able to build extension modules using the directories specified " "in the environment variables." msgstr "" -#: using/configure.rst:821 +#: using/configure.rst:829 msgid "" "Extra preprocessor flags added for building the interpreter object files." msgstr "" -#: using/configure.rst:823 +#: using/configure.rst:831 msgid "" "Default: ``$(BASECPPFLAGS) -I. -I$(srcdir)/Include $(CONFIGURE_CPPFLAGS) " "$(CPPFLAGS)``." msgstr "" -#: using/configure.rst:828 +#: using/configure.rst:836 msgid "Compiler flags" msgstr "" -#: using/configure.rst:832 +#: using/configure.rst:840 msgid "C compiler command." msgstr "" -#: using/configure.rst:834 +#: using/configure.rst:842 msgid "Example: ``gcc -pthread``." msgstr "" -#: using/configure.rst:838 +#: using/configure.rst:846 msgid "C++ compiler command." msgstr "" -#: using/configure.rst:840 +#: using/configure.rst:848 msgid "Example: ``g++ -pthread``." msgstr "" -#: using/configure.rst:844 +#: using/configure.rst:852 msgid "C compiler flags." msgstr "" -#: using/configure.rst:848 +#: using/configure.rst:856 msgid "" ":envvar:`CFLAGS_NODIST` is used for building the interpreter and stdlib C " "extensions. Use it when a compiler flag should *not* be part of :envvar:" "`CFLAGS` once Python is installed (:gh:`65320`)." msgstr "" -#: using/configure.rst:852 +#: using/configure.rst:860 msgid "In particular, :envvar:`CFLAGS` should not contain:" msgstr "" -#: using/configure.rst:854 +#: using/configure.rst:862 msgid "" "the compiler flag ``-I`` (for setting the search path for include files). " "The ``-I`` flags are processed from left to right, and any flags in :envvar:" "`CFLAGS` would take precedence over user- and package-supplied ``-I`` flags." msgstr "" -#: using/configure.rst:859 +#: using/configure.rst:867 msgid "" "hardening flags such as ``-Werror`` because distributions cannot control " "whether packages installed by users conform to such heightened standards." msgstr "" -#: using/configure.rst:867 +#: using/configure.rst:875 msgid "" "Options passed to the :mod:`compileall` command line when building PYC files " "in ``make install``. Default: ``-j0``." msgstr "" -#: using/configure.rst:874 +#: using/configure.rst:882 msgid "Extra C compiler flags." msgstr "" -#: using/configure.rst:878 +#: using/configure.rst:886 msgid "" "Value of :envvar:`CFLAGS` variable passed to the ``./configure`` script." msgstr "" -#: using/configure.rst:885 +#: using/configure.rst:893 msgid "" "Value of :envvar:`CFLAGS_NODIST` variable passed to the ``./configure`` " "script." msgstr "" -#: using/configure.rst:892 +#: using/configure.rst:900 msgid "Base compiler flags." msgstr "" -#: using/configure.rst:896 +#: using/configure.rst:904 msgid "Optimization flags." msgstr "" -#: using/configure.rst:900 +#: using/configure.rst:908 msgid "Strict or non-strict aliasing flags used to compile ``Python/dtoa.c``." msgstr "" -#: using/configure.rst:906 +#: using/configure.rst:914 msgid "Compiler flags used to build a shared library." msgstr "" -#: using/configure.rst:908 +#: using/configure.rst:916 msgid "For example, ``-fPIC`` is used on Linux and on BSD." msgstr "" -#: using/configure.rst:912 +#: using/configure.rst:920 msgid "Extra C flags added for building the interpreter object files." msgstr "" -#: using/configure.rst:914 +#: using/configure.rst:922 msgid "" "Default: ``$(CCSHARED)`` when :option:`--enable-shared` is used, or an empty " "string otherwise." msgstr "" -#: using/configure.rst:919 +#: using/configure.rst:927 msgid "" "Default: ``$(BASECFLAGS) $(OPT) $(CONFIGURE_CFLAGS) $(CFLAGS) " "$(EXTRA_CFLAGS)``." msgstr "" -#: using/configure.rst:923 +#: using/configure.rst:931 msgid "" "Default: ``$(CONFIGURE_CFLAGS_NODIST) $(CFLAGS_NODIST) -I$(srcdir)/Include/" "internal``." msgstr "" -#: using/configure.rst:929 +#: using/configure.rst:937 msgid "C flags used for building the interpreter object files." msgstr "" -#: using/configure.rst:931 +#: using/configure.rst:939 msgid "" "Default: ``$(PY_CFLAGS) $(PY_CFLAGS_NODIST) $(PY_CPPFLAGS) " "$(CFLAGSFORSHARED)``." msgstr "" -#: using/configure.rst:937 +#: using/configure.rst:945 msgid "Default: ``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE``." msgstr "" -#: using/configure.rst:943 +#: using/configure.rst:951 msgid "" "Compiler flags to build a standard library extension module as a built-in " "module, like the :mod:`posix` module." msgstr "" -#: using/configure.rst:946 +#: using/configure.rst:954 msgid "Default: ``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE_BUILTIN``." msgstr "" -#: using/configure.rst:952 +#: using/configure.rst:960 msgid "Purify command. Purify is a memory debugger program." msgstr "" -#: using/configure.rst:954 +#: using/configure.rst:962 msgid "Default: empty string (not used)." msgstr "" -#: using/configure.rst:958 +#: using/configure.rst:966 msgid "Linker flags" msgstr "" -#: using/configure.rst:962 +#: using/configure.rst:970 msgid "" "Linker command used to build programs like ``python`` and ``_testembed``." msgstr "" -#: using/configure.rst:964 +#: using/configure.rst:972 msgid "Default: ``$(PURIFY) $(CC)``." msgstr "" -#: using/configure.rst:968 +#: using/configure.rst:976 msgid "" "Value of :envvar:`LDFLAGS` variable passed to the ``./configure`` script." msgstr "" -#: using/configure.rst:970 +#: using/configure.rst:978 msgid "" "Avoid assigning :envvar:`CFLAGS`, :envvar:`LDFLAGS`, etc. so users can use " "them on the command line to append to these values without stomping the pre-" "set values." msgstr "" -#: using/configure.rst:978 +#: using/configure.rst:986 msgid "" ":envvar:`LDFLAGS_NODIST` is used in the same manner as :envvar:" "`CFLAGS_NODIST`. Use it when a linker flag should *not* be part of :envvar:" "`LDFLAGS` once Python is installed (:gh:`65320`)." msgstr "" -#: using/configure.rst:982 +#: using/configure.rst:990 msgid "In particular, :envvar:`LDFLAGS` should not contain:" msgstr "" -#: using/configure.rst:984 +#: using/configure.rst:992 msgid "" "the compiler flag ``-L`` (for setting the search path for libraries). The ``-" "L`` flags are processed from left to right, and any flags in :envvar:" "`LDFLAGS` would take precedence over user- and package-supplied ``-L`` flags." msgstr "" -#: using/configure.rst:991 +#: using/configure.rst:999 msgid "" "Value of :envvar:`LDFLAGS_NODIST` variable passed to the ``./configure`` " "script." msgstr "" -#: using/configure.rst:998 +#: using/configure.rst:1006 msgid "" "Linker flags, e.g. :samp:`-L{lib_dir}` if you have libraries in a " "nonstandard directory *lib_dir*." msgstr "" -#: using/configure.rst:1007 +#: using/configure.rst:1015 msgid "" "Linker flags to pass libraries to the linker when linking the Python " "executable." msgstr "" -#: using/configure.rst:1010 +#: using/configure.rst:1018 msgid "Example: ``-lrt``." msgstr "" -#: using/configure.rst:1014 +#: using/configure.rst:1022 msgid "Command to build a shared library." msgstr "" -#: using/configure.rst:1016 +#: using/configure.rst:1024 msgid "Default: ``@LDSHARED@ $(PY_LDFLAGS)``." msgstr "" -#: using/configure.rst:1020 +#: using/configure.rst:1028 msgid "Command to build ``libpython`` shared library." msgstr "" -#: using/configure.rst:1022 +#: using/configure.rst:1030 msgid "Default: ``@BLDSHARED@ $(PY_CORE_LDFLAGS)``." msgstr "" -#: using/configure.rst:1026 +#: using/configure.rst:1034 msgid "Default: ``$(CONFIGURE_LDFLAGS) $(LDFLAGS)``." msgstr "" -#: using/configure.rst:1030 +#: using/configure.rst:1038 msgid "Default: ``$(CONFIGURE_LDFLAGS_NODIST) $(LDFLAGS_NODIST)``." msgstr "" -#: using/configure.rst:1036 +#: using/configure.rst:1044 msgid "Linker flags used for building the interpreter object files." msgstr "" diff --git a/using/mac.po b/using/mac.po index 6a23a6b78..8fa2eb37a 100644 --- a/using/mac.po +++ b/using/mac.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2024-02-24 17:22+0000\n" +"POT-Creation-Date: 2024-04-01 00:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -224,54 +224,87 @@ msgid "" msgstr "" #: using/mac.rst:155 +msgid "A number of alternative macOS GUI toolkits are available:" +msgstr "" + +#: using/mac.rst:157 +msgid "" +"`PySide `__: Official Python bindings to " +"the `Qt GUI toolkit `__." +msgstr "" + +#: using/mac.rst:160 msgid "" -"*wxPython* is another popular cross-platform GUI toolkit that runs natively " -"on macOS. Packages and documentation are available from https://www.wxpython." -"org." +"`PyQt `__: Alternative " +"Python bindings to Qt." msgstr "" -#: using/mac.rst:158 +#: using/mac.rst:163 msgid "" -"*PyQt* is another popular cross-platform GUI toolkit that runs natively on " -"macOS. More information can be found at https://riverbankcomputing.com/" -"software/pyqt/intro." +"`Kivy `__: A cross-platform GUI toolkit that supports " +"desktop and mobile platforms." msgstr "" -#: using/mac.rst:162 +#: using/mac.rst:166 msgid "" -"*PySide* is another cross-platform Qt-based toolkit. More information at " -"https://www.qt.io/qt-for-python." +"`Toga `__: Part of the `BeeWare Project " +"`__; supports desktop, mobile, web and console apps." msgstr "" #: using/mac.rst:169 +msgid "" +"`wxPython `__: A cross-platform toolkit that " +"supports desktop operating systems." +msgstr "" + +#: using/mac.rst:175 msgid "Distributing Python Applications" msgstr "" -#: using/mac.rst:171 +#: using/mac.rst:177 msgid "" -"The standard tool for deploying standalone Python applications on the Mac " -"is :program:`py2app`. More information on installing and using :program:" -"`py2app` can be found at https://pypi.org/project/py2app/." +"A range of tools exist for converting your Python code into a standalone " +"distributable application:" msgstr "" -#: using/mac.rst:177 +#: using/mac.rst:180 +msgid "" +"`py2app `__: Supports creating macOS ``." +"app`` bundles from a Python project." +msgstr "" + +#: using/mac.rst:183 +msgid "" +"`Briefcase `__: Part of the `BeeWare " +"Project `__; a cross-platform packaging tool that " +"supports creation of ``.app`` bundles on macOS, as well as managing signing " +"and notarization." +msgstr "" + +#: using/mac.rst:188 +msgid "" +"`PyInstaller `__: A cross-platform packaging tool " +"that creates a single file or folder as a distributable artifact." +msgstr "" + +#: using/mac.rst:192 msgid "Other Resources" msgstr "" -#: using/mac.rst:179 +#: using/mac.rst:194 msgid "" "The Pythonmac-SIG mailing list is an excellent support resource for Python " "users and developers on the Mac:" msgstr "" -#: using/mac.rst:182 +#: using/mac.rst:197 msgid "https://www.python.org/community/sigs/current/pythonmac-sig/" msgstr "" -#: using/mac.rst:184 +#: using/mac.rst:199 msgid "Another useful resource is the MacPython wiki:" msgstr "" -#: using/mac.rst:186 +#: using/mac.rst:201 msgid "https://wiki.python.org/moin/MacPython" msgstr ""