diff --git a/Makefile b/Makefile index 48e1695b5..89a808006 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 := cd778b4917b29b4868aa339e920f947ab6cb6cb9 +CPYTHON_CURRENT_COMMIT := 4c9da4c964a62c2972fa40b30ab11f19f89178f4 LANGUAGE := tr BRANCH := 3.12 diff --git a/bugs.po b/bugs.po index 73422a30c..5d390d5ca 100644 --- a/bugs.po +++ b/bugs.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-03-01 00:18+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: 2023-03-01 12:08+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -114,9 +114,10 @@ msgstr "" "kılavuz." #: bugs.rst:41 +#, fuzzy msgid "" -"`Documentation Translations `_" +"`Documentation Translations `_" msgstr "" "`Dokümantasyon Çevirileri `_" diff --git a/c-api/set.po b/c-api/set.po index 8c01dc94a..9ed664aef 100644 --- a/c-api/set.po +++ b/c-api/set.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: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -166,9 +166,9 @@ msgid "" "Return ``1`` if found and removed, ``0`` if not found (no action taken), and " "``-1`` if an error is encountered. Does not raise :exc:`KeyError` for " "missing keys. Raise a :exc:`TypeError` if the *key* is unhashable. Unlike " -"the Python :meth:`~set.discard` method, this function does not automatically " -"convert unhashable sets into temporary frozensets. Raise :exc:`SystemError` " -"if *set* is not an instance of :class:`set` or its subtype." +"the Python :meth:`~frozenset.discard` method, this function does not " +"automatically convert unhashable sets into temporary frozensets. Raise :exc:" +"`SystemError` if *set* is not an instance of :class:`set` or its subtype." msgstr "" #: c-api/set.rst:158 diff --git a/extending/newtypes.po b/extending/newtypes.po index ac156ba48..c04f4673c 100644 --- a/extending/newtypes.po +++ b/extending/newtypes.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -295,7 +295,7 @@ msgid "" "defined this way can have an associated doc string simply by providing the " "text in the table. An application can use the introspection API to retrieve " "the descriptor from the class object, and get the doc string using its :attr:" -"`__doc__` attribute." +"`!__doc__` attribute." msgstr "" #: extending/newtypes.rst:301 @@ -413,7 +413,7 @@ msgstr "" #: extending/newtypes.rst:451 msgid "" -":c:type:`Py_hash_t` is a signed integer type with a platform-varying width. " +":c:type:`!Py_hash_t` is a signed integer type with a platform-varying width. " "Returning ``-1`` from :c:member:`~PyTypeObject.tp_hash` indicates an error, " "which is why you should be careful to avoid returning it when hash " "computation is successful, as seen above." diff --git a/glossary.po b/glossary.po index 9876fa60d..93be3a334 100644 --- a/glossary.po +++ b/glossary.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: 2022-12-28 16:12-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2603,10 +2603,21 @@ msgstr "" "bir anahtar kelimeye sahip birkaç yapıdan biridir." #: glossary.rst:1134 +msgid "static type checker" +msgstr "" + +#: glossary.rst:1136 +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:1139 msgid "strong reference" msgstr "güçlü referans" -#: glossary.rst:1136 +#: glossary.rst:1141 #, fuzzy msgid "" "In Python's C API, a strong reference is a reference to an object which is " @@ -2618,7 +2629,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:1142 +#: glossary.rst:1147 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 " @@ -2630,15 +2641,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:1147 +#: glossary.rst:1152 msgid "See also :term:`borrowed reference`." msgstr "Ayrıca bkz. :term:`ödünç alınan referans `." -#: glossary.rst:1148 +#: glossary.rst:1153 msgid "text encoding" msgstr "yazı çözümleme" -#: glossary.rst:1150 +#: glossary.rst:1155 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 " @@ -2648,7 +2659,7 @@ msgstr "" "``U+10FFFF`` aralığında). Bir dizeyi depolamak veya aktarmak için, bir bayt " "dizisi olarak seri hale getirilmesi gerekir." -#: glossary.rst:1154 +#: glossary.rst:1159 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\"." @@ -2657,7 +2668,7 @@ msgstr "" "olarak bilinir ve dizeyi bayt dizisinden yeniden oluşturmak \"kod çözme " "(decoding)\" olarak bilinir." -#: glossary.rst:1157 +#: glossary.rst:1162 msgid "" "There are a variety of different text serialization :ref:`codecs `, which are collectively referred to as \"text encodings\"." @@ -2665,11 +2676,11 @@ msgstr "" "Toplu olarak \"metin kodlamaları\" olarak adlandırılan çeşitli farklı metin " "serileştirme :ref:`kodekleri ` vardır." -#: glossary.rst:1160 +#: glossary.rst:1165 msgid "text file" msgstr "yazı dosyası" -#: glossary.rst:1162 +#: glossary.rst:1167 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:" @@ -2683,7 +2694,7 @@ msgstr "" "metin modunda açılan dosyalar (``'r'`` veya ``'w'``), :data:`sys.stdin`, :" "data:`sys.stdout` ve :class:`io.StringIO` örnekleri verilebilir." -#: glossary.rst:1169 +#: glossary.rst:1174 msgid "" "See also :term:`binary file` for a file object able to read and write :term:" "`bytes-like objects `." @@ -2691,11 +2702,11 @@ msgstr "" "Ayrıca :term:`ikili dosyaları ` okuyabilen ve yazabilen bir " "dosya nesnesi için :term:`bayt benzeri nesnelere ` bakın." -#: glossary.rst:1171 +#: glossary.rst:1176 msgid "triple-quoted string" msgstr "üç tırnaklı dize" -#: glossary.rst:1173 +#: glossary.rst:1178 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 " @@ -2712,11 +2723,11 @@ msgstr "" "yayılabilir, bu da onları özellikle belge dizileri yazarken kullanışlı hale " "getirir." -#: glossary.rst:1180 +#: glossary.rst:1185 msgid "type" msgstr "tip" -#: glossary.rst:1182 +#: glossary.rst:1187 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." @@ -2726,15 +2737,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:1186 +#: glossary.rst:1191 msgid "type alias" msgstr "tip takma adı" -#: glossary.rst:1188 +#: glossary.rst:1193 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:1190 +#: glossary.rst:1195 msgid "" "Type aliases are useful for simplifying :term:`type hints `. For " "example::" @@ -2742,19 +2753,19 @@ msgstr "" "Tür takma adları, :term:`tür ipuçlarını ` basitleştirmek için " "kullanışlıdır. Örneğin::" -#: glossary.rst:1197 +#: glossary.rst:1202 msgid "could be made more readable like this::" msgstr "bu şekilde daha okunaklı hale getirilebilir::" -#: glossary.rst:1218 +#: glossary.rst:1223 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:1205 +#: glossary.rst:1210 msgid "type hint" msgstr "tür ipucu" -#: glossary.rst:1207 +#: glossary.rst:1212 msgid "" "An :term:`annotation` that specifies the expected type for a variable, a " "class attribute, or a function parameter or return value." @@ -2762,17 +2773,18 @@ 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:1210 +#: glossary.rst:1215 +#, fuzzy msgid "" "Type hints are optional and are not enforced by Python but they are useful " -"to static type analysis tools, and aid IDEs with code completion and " -"refactoring." +"to :term:`static type checkers `. They can also aid " +"IDEs with code completion and refactoring." msgstr "" "Tür ipuçları isteğe bağlıdır ve Python tarafından uygulanmaz, ancak bunlar " "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:1214 +#: glossary.rst:1219 msgid "" "Type hints of global variables, class attributes, and functions, but not " "local variables, can be accessed using :func:`typing.get_type_hints`." @@ -2781,11 +2793,11 @@ msgstr "" "yerel değişkenlere değil, :func:`typing.get_type_hints` kullanılarak " "erişilebilir." -#: glossary.rst:1219 +#: glossary.rst:1224 msgid "universal newlines" msgstr "evrensel yeni satırlar" -#: glossary.rst:1221 +#: glossary.rst:1226 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 " @@ -2798,23 +2810,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:1226 +#: glossary.rst:1231 msgid "variable annotation" msgstr "değişken açıklama" -#: glossary.rst:1228 +#: glossary.rst:1233 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:1230 +#: glossary.rst:1235 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:1235 +#: glossary.rst:1240 msgid "" "Variable annotations are usually used for :term:`type hints `: " "for example this variable is expected to take :class:`int` values::" @@ -2822,11 +2834,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:1241 +#: glossary.rst:1246 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:1243 +#: glossary.rst:1248 msgid "" "See :term:`function annotation`, :pep:`484` and :pep:`526`, which describe " "this functionality. Also see :ref:`annotations-howto` for best practices on " @@ -2836,11 +2848,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:1247 +#: glossary.rst:1252 msgid "virtual environment" msgstr "sanal ortam" -#: glossary.rst:1249 +#: glossary.rst:1254 msgid "" "A cooperatively isolated runtime environment that allows Python users and " "applications to install and upgrade Python distribution packages without " @@ -2852,15 +2864,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:1254 +#: glossary.rst:1259 msgid "See also :mod:`venv`." msgstr "Ayrıca bakınız :mod:`venv`." -#: glossary.rst:1255 +#: glossary.rst:1260 msgid "virtual machine" msgstr "sanal makine" -#: glossary.rst:1257 +#: glossary.rst:1262 msgid "" "A computer defined entirely in software. Python's virtual machine executes " "the :term:`bytecode` emitted by the bytecode compiler." @@ -2868,11 +2880,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:1259 +#: glossary.rst:1264 msgid "Zen of Python" msgstr "Python'un Zen'i" -#: glossary.rst:1261 +#: glossary.rst:1266 msgid "" "Listing of Python design principles and philosophies that are helpful in " "understanding and using the language. The listing can be found by typing " diff --git a/howto/descriptor.po b/howto/descriptor.po index 25ae4d665..9fbeba1b6 100644 --- a/howto/descriptor.po +++ b/howto/descriptor.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -418,15 +418,15 @@ msgid "Descriptor protocol" msgstr "" #: howto/descriptor.rst:524 -msgid "``descr.__get__(self, obj, type=None) -> value``" +msgid "``descr.__get__(self, obj, type=None)``" msgstr "" #: howto/descriptor.rst:526 -msgid "``descr.__set__(self, obj, value) -> None``" +msgid "``descr.__set__(self, obj, value)``" msgstr "" #: howto/descriptor.rst:528 -msgid "``descr.__delete__(self, obj) -> None``" +msgid "``descr.__delete__(self, obj)``" msgstr "" #: howto/descriptor.rst:530 @@ -686,11 +686,11 @@ msgid "" "it can be updated:" msgstr "" -#: howto/descriptor.rst:948 +#: howto/descriptor.rst:952 msgid "Pure Python Equivalents" msgstr "" -#: howto/descriptor.rst:950 +#: howto/descriptor.rst:954 msgid "" "The descriptor protocol is simple and offers exciting possibilities. " "Several use cases are so common that they have been prepackaged into built-" @@ -698,36 +698,36 @@ msgid "" "\\_\\_slots\\_\\_ are all based on the descriptor protocol." msgstr "" -#: howto/descriptor.rst:957 +#: howto/descriptor.rst:961 msgid "Properties" msgstr "" -#: howto/descriptor.rst:959 +#: howto/descriptor.rst:963 msgid "" "Calling :func:`property` is a succinct way of building a data descriptor " "that triggers a function call upon access to an attribute. Its signature " "is::" msgstr "" -#: howto/descriptor.rst:964 +#: howto/descriptor.rst:968 msgid "" "The documentation shows a typical use to define a managed attribute ``x``:" msgstr "" -#: howto/descriptor.rst:988 +#: howto/descriptor.rst:992 msgid "" "To see how :func:`property` is implemented in terms of the descriptor " "protocol, here is a pure Python equivalent:" msgstr "" -#: howto/descriptor.rst:1091 +#: howto/descriptor.rst:1132 msgid "" "The :func:`property` builtin helps whenever a user interface has granted " "attribute access and then subsequent changes require the intervention of a " "method." msgstr "" -#: howto/descriptor.rst:1095 +#: howto/descriptor.rst:1136 msgid "" "For instance, a spreadsheet class may grant access to a cell value through " "``Cell('b10').value``. Subsequent improvements to the program require the " @@ -737,23 +737,23 @@ msgid "" "descriptor:" msgstr "" -#: howto/descriptor.rst:1112 +#: howto/descriptor.rst:1153 msgid "" "Either the built-in :func:`property` or our :func:`Property` equivalent " "would work in this example." msgstr "" -#: howto/descriptor.rst:1117 +#: howto/descriptor.rst:1158 msgid "Functions and methods" msgstr "" -#: howto/descriptor.rst:1119 +#: howto/descriptor.rst:1160 msgid "" "Python's object oriented features are built upon a function based " "environment. Using non-data descriptors, the two are merged seamlessly." msgstr "" -#: howto/descriptor.rst:1122 +#: howto/descriptor.rst:1163 msgid "" "Functions stored in class dictionaries get turned into methods when invoked. " "Methods only differ from regular functions in that the object instance is " @@ -761,13 +761,13 @@ msgid "" "*self* but could be called *this* or any other variable name." msgstr "" -#: howto/descriptor.rst:1127 +#: howto/descriptor.rst:1168 msgid "" "Methods can be created manually with :class:`types.MethodType` which is " "roughly equivalent to:" msgstr "" -#: howto/descriptor.rst:1144 +#: howto/descriptor.rst:1185 msgid "" "To support automatic creation of methods, functions include the :meth:" "`__get__` method for binding methods during attribute access. This means " @@ -775,58 +775,58 @@ msgid "" "dotted lookup from an instance. Here's how it works:" msgstr "" -#: howto/descriptor.rst:1160 +#: howto/descriptor.rst:1201 msgid "" "Running the following class in the interpreter shows how the function " "descriptor works in practice:" msgstr "" -#: howto/descriptor.rst:1169 +#: howto/descriptor.rst:1210 msgid "" "The function has a :term:`qualified name` attribute to support introspection:" msgstr "" -#: howto/descriptor.rst:1176 +#: howto/descriptor.rst:1217 msgid "" "Accessing the function through the class dictionary does not invoke :meth:" "`__get__`. Instead, it just returns the underlying function object::" msgstr "" -#: howto/descriptor.rst:1182 +#: howto/descriptor.rst:1223 msgid "" "Dotted access from a class calls :meth:`__get__` which just returns the " "underlying function unchanged::" msgstr "" -#: howto/descriptor.rst:1188 +#: howto/descriptor.rst:1229 msgid "" "The interesting behavior occurs during dotted access from an instance. The " "dotted lookup calls :meth:`__get__` which returns a bound method object::" msgstr "" -#: howto/descriptor.rst:1195 +#: howto/descriptor.rst:1236 msgid "" "Internally, the bound method stores the underlying function and the bound " "instance::" msgstr "" -#: howto/descriptor.rst:1204 +#: howto/descriptor.rst:1245 msgid "" "If you have ever wondered where *self* comes from in regular methods or " "where *cls* comes from in class methods, this is it!" msgstr "" -#: howto/descriptor.rst:1209 +#: howto/descriptor.rst:1250 msgid "Kinds of methods" msgstr "" -#: howto/descriptor.rst:1211 +#: howto/descriptor.rst:1252 msgid "" "Non-data descriptors provide a simple mechanism for variations on the usual " "patterns of binding functions into methods." msgstr "" -#: howto/descriptor.rst:1214 +#: howto/descriptor.rst:1255 msgid "" "To recap, functions have a :meth:`__get__` method so that they can be " "converted to a method when accessed as attributes. The non-data descriptor " @@ -834,55 +834,55 @@ msgid "" "f(*args)`` becomes ``f(*args)``." msgstr "" -#: howto/descriptor.rst:1219 +#: howto/descriptor.rst:1260 msgid "This chart summarizes the binding and its two most useful variants:" msgstr "" -#: howto/descriptor.rst:1222 +#: howto/descriptor.rst:1263 msgid "Transformation" msgstr "" -#: howto/descriptor.rst:1222 +#: howto/descriptor.rst:1263 msgid "Called from an object" msgstr "" -#: howto/descriptor.rst:1222 +#: howto/descriptor.rst:1263 msgid "Called from a class" msgstr "" -#: howto/descriptor.rst:1225 +#: howto/descriptor.rst:1266 msgid "function" msgstr "" -#: howto/descriptor.rst:1225 +#: howto/descriptor.rst:1266 msgid "f(obj, \\*args)" msgstr "" -#: howto/descriptor.rst:1227 +#: howto/descriptor.rst:1268 msgid "f(\\*args)" msgstr "" -#: howto/descriptor.rst:1227 +#: howto/descriptor.rst:1268 msgid "staticmethod" msgstr "" -#: howto/descriptor.rst:1229 +#: howto/descriptor.rst:1270 msgid "classmethod" msgstr "" -#: howto/descriptor.rst:1229 +#: howto/descriptor.rst:1270 msgid "f(type(obj), \\*args)" msgstr "" -#: howto/descriptor.rst:1229 +#: howto/descriptor.rst:1270 msgid "f(cls, \\*args)" msgstr "" -#: howto/descriptor.rst:1234 +#: howto/descriptor.rst:1275 msgid "Static methods" msgstr "" -#: howto/descriptor.rst:1236 +#: howto/descriptor.rst:1277 msgid "" "Static methods return the underlying function without changes. Calling " "either ``c.f`` or ``C.f`` is the equivalent of a direct lookup into ``object." @@ -891,13 +891,13 @@ msgid "" "a class." msgstr "" -#: howto/descriptor.rst:1242 +#: howto/descriptor.rst:1283 msgid "" "Good candidates for static methods are methods that do not reference the " "``self`` variable." msgstr "" -#: howto/descriptor.rst:1245 +#: howto/descriptor.rst:1286 msgid "" "For instance, a statistics package may include a container class for " "experimental data. The class provides normal methods for computing the " @@ -909,19 +909,19 @@ msgid "" "``s.erf(1.5) --> .9332`` or ``Sample.erf(1.5) --> .9332``." msgstr "" -#: howto/descriptor.rst:1254 +#: howto/descriptor.rst:1295 msgid "" "Since static methods return the underlying function with no changes, the " "example calls are unexciting:" msgstr "" -#: howto/descriptor.rst:1271 +#: howto/descriptor.rst:1312 msgid "" "Using the non-data descriptor protocol, a pure Python version of :func:" "`staticmethod` would look like this:" msgstr "" -#: howto/descriptor.rst:1291 +#: howto/descriptor.rst:1332 msgid "" "The :func:`functools.update_wrapper` call adds a ``__wrapped__`` attribute " "that refers to the underlying function. Also it carries forward the " @@ -929,18 +929,18 @@ msgid "" "``__name__``, ``__qualname__``, ``__doc__``, and ``__annotations__``." msgstr "" -#: howto/descriptor.rst:1359 +#: howto/descriptor.rst:1400 msgid "Class methods" msgstr "" -#: howto/descriptor.rst:1361 +#: howto/descriptor.rst:1402 msgid "" "Unlike static methods, class methods prepend the class reference to the " "argument list before calling the function. This format is the same for " "whether the caller is an object or a class:" msgstr "" -#: howto/descriptor.rst:1379 +#: howto/descriptor.rst:1420 msgid "" "This behavior is useful whenever the method only needs to have a class " "reference and does not rely on data stored in a specific instance. One use " @@ -949,17 +949,17 @@ msgid "" "of keys. The pure Python equivalent is:" msgstr "" -#: howto/descriptor.rst:1396 +#: howto/descriptor.rst:1437 msgid "Now a new dictionary of unique keys can be constructed like this:" msgstr "" -#: howto/descriptor.rst:1406 +#: howto/descriptor.rst:1447 msgid "" "Using the non-data descriptor protocol, a pure Python version of :func:" "`classmethod` would look like this:" msgstr "" -#: howto/descriptor.rst:1484 +#: howto/descriptor.rst:1525 msgid "" "The code path for ``hasattr(type(self.f), '__get__')`` was added in Python " "3.9 and makes it possible for :func:`classmethod` to support chained " @@ -967,7 +967,7 @@ msgid "" "together. In Python 3.11, this functionality was deprecated." msgstr "" -#: howto/descriptor.rst:1502 +#: howto/descriptor.rst:1543 msgid "" "The :func:`functools.update_wrapper` call in ``ClassMethod`` adds a " "``__wrapped__`` attribute that refers to the underlying function. Also it " @@ -976,30 +976,30 @@ msgid "" "``__annotations__``." msgstr "" -#: howto/descriptor.rst:1510 +#: howto/descriptor.rst:1551 msgid "Member objects and __slots__" msgstr "" -#: howto/descriptor.rst:1512 +#: howto/descriptor.rst:1553 msgid "" "When a class defines ``__slots__``, it replaces instance dictionaries with a " "fixed-length array of slot values. From a user point of view that has " "several effects:" msgstr "" -#: howto/descriptor.rst:1516 +#: howto/descriptor.rst:1557 msgid "" "1. Provides immediate detection of bugs due to misspelled attribute " "assignments. Only attribute names specified in ``__slots__`` are allowed:" msgstr "" -#: howto/descriptor.rst:1532 +#: howto/descriptor.rst:1573 msgid "" "2. Helps create immutable objects where descriptors manage access to private " "attributes stored in ``__slots__``:" msgstr "" -#: howto/descriptor.rst:1567 +#: howto/descriptor.rst:1608 msgid "" "3. Saves memory. On a 64-bit Linux build, an instance with two attributes " "takes 48 bytes with ``__slots__`` and 152 bytes without. This `flyweight " @@ -1007,19 +1007,19 @@ msgid "" "only matters when a large number of instances are going to be created." msgstr "" -#: howto/descriptor.rst:1572 +#: howto/descriptor.rst:1613 msgid "" "4. Improves speed. Reading instance variables is 35% faster with " "``__slots__`` (as measured with Python 3.10 on an Apple M1 processor)." msgstr "" -#: howto/descriptor.rst:1575 +#: howto/descriptor.rst:1616 msgid "" "5. Blocks tools like :func:`functools.cached_property` which require an " "instance dictionary to function correctly:" msgstr "" -#: howto/descriptor.rst:1597 +#: howto/descriptor.rst:1638 msgid "" "It is not possible to create an exact drop-in pure Python version of " "``__slots__`` because it requires direct access to C structures and control " @@ -1029,36 +1029,36 @@ msgid "" "managed by member descriptors:" msgstr "" -#: howto/descriptor.rst:1642 +#: howto/descriptor.rst:1683 msgid "" "The :meth:`type.__new__` method takes care of adding member objects to class " "variables:" msgstr "" -#: howto/descriptor.rst:1658 +#: howto/descriptor.rst:1699 msgid "" "The :meth:`object.__new__` method takes care of creating instances that have " "slots instead of an instance dictionary. Here is a rough simulation in pure " "Python:" msgstr "" -#: howto/descriptor.rst:1693 +#: howto/descriptor.rst:1734 msgid "" "To use the simulation in a real class, just inherit from :class:`Object` and " "set the :term:`metaclass` to :class:`Type`:" msgstr "" -#: howto/descriptor.rst:1707 +#: howto/descriptor.rst:1748 msgid "" "At this point, the metaclass has loaded member objects for *x* and *y*::" msgstr "" -#: howto/descriptor.rst:1728 +#: howto/descriptor.rst:1769 msgid "" "When instances are created, they have a ``slot_values`` list where the " "attributes are stored:" msgstr "" -#: howto/descriptor.rst:1740 +#: howto/descriptor.rst:1781 msgid "Misspelled or unassigned attributes will raise an exception:" msgstr "" diff --git a/howto/enum.po b/howto/enum.po index 4cba356af..5e918c12f 100644 --- a/howto/enum.po +++ b/howto/enum.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -482,22 +482,14 @@ msgstr "" msgid "The complete signature is::" msgstr "" -#: howto/enum.rst:0 -msgid "value" -msgstr "" - #: howto/enum.rst:610 -msgid "What the new enum class will record as its name." -msgstr "" - -#: howto/enum.rst:0 -msgid "names" +msgid "*value*: What the new enum class will record as its name." msgstr "" #: howto/enum.rst:612 msgid "" -"The enum members. This can be a whitespace- or comma-separated string " -"(values will start at 1 unless otherwise specified)::" +"*names*: The enum members. This can be a whitespace- or comma-separated " +"string (values will start at 1 unless otherwise specified)::" msgstr "" #: howto/enum.rst:617 @@ -512,36 +504,20 @@ msgstr "" msgid "or a mapping::" msgstr "" -#: howto/enum.rst:0 -msgid "module" -msgstr "" - #: howto/enum.rst:629 -msgid "name of module where new enum class can be found." -msgstr "" - -#: howto/enum.rst:0 -msgid "qualname" +msgid "*module*: name of module where new enum class can be found." msgstr "" #: howto/enum.rst:631 -msgid "where in module new enum class can be found." -msgstr "" - -#: howto/enum.rst:0 -msgid "type" +msgid "*qualname*: where in module new enum class can be found." msgstr "" #: howto/enum.rst:633 -msgid "type to mix in to new enum class." -msgstr "" - -#: howto/enum.rst:0 -msgid "start" +msgid "*type*: type to mix in to new enum class." msgstr "" #: howto/enum.rst:635 -msgid "number to start counting at if only names are passed in." +msgid "*start*: number to start counting at if only names are passed in." msgstr "" #: howto/enum.rst:637 @@ -1260,36 +1236,36 @@ msgid "" "alias::" msgstr "" -#: howto/enum.rst:1446 +#: howto/enum.rst:1445 msgid "" "This is a useful example for subclassing Enum to add or change other " "behaviors as well as disallowing aliases. If the only desired change is " "disallowing aliases, the :func:`unique` decorator can be used instead." msgstr "" -#: howto/enum.rst:1452 +#: howto/enum.rst:1451 msgid "Planet" msgstr "" -#: howto/enum.rst:1454 +#: howto/enum.rst:1453 msgid "" "If :meth:`__new__` or :meth:`__init__` is defined, the value of the enum " "member will be passed to those methods::" msgstr "" -#: howto/enum.rst:1483 +#: howto/enum.rst:1482 msgid "TimePeriod" msgstr "" -#: howto/enum.rst:1485 +#: howto/enum.rst:1484 msgid "An example to show the :attr:`_ignore_` attribute in use::" msgstr "" -#: howto/enum.rst:1504 +#: howto/enum.rst:1503 msgid "Subclassing EnumType" msgstr "" -#: howto/enum.rst:1506 +#: howto/enum.rst:1505 msgid "" "While most enum needs can be met by customizing :class:`Enum` subclasses, " "either with class decorators or custom functions, :class:`EnumType` can be " diff --git a/howto/isolating-extensions.po b/howto/isolating-extensions.po index 822ef4570..6ce426160 100644 --- a/howto/isolating-extensions.po +++ b/howto/isolating-extensions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -443,54 +443,163 @@ msgstr "" #: howto/isolating-extensions.rst:342 msgid "" -"Please refer to the :ref:`the documentation ` of :c:macro:" -"`Py_TPFLAGS_HAVE_GC` and :c:member:`~PyTypeObject.tp_traverse` for " -"additional considerations." +"Please refer to the the documentation of :c:macro:`Py_TPFLAGS_HAVE_GC` and :" +"c:member:`~PyTypeObject.tp_traverse` for additional considerations." msgstr "" #: howto/isolating-extensions.rst:346 msgid "" -"If your traverse function delegates to the ``tp_traverse`` of its base class " -"(or another type), ensure that ``Py_TYPE(self)`` is visited only once. Note " -"that only heap type are expected to visit the type in ``tp_traverse``." +"The API for defining heap types grew organically, leaving it somewhat " +"awkward to use in its current state. The following sections will guide you " +"through common issues." msgstr "" -#: howto/isolating-extensions.rst:350 -msgid "For example, if your traverse function includes::" +#: howto/isolating-extensions.rst:352 +msgid "``tp_traverse`` in Python 3.8 and lower" msgstr "" #: howto/isolating-extensions.rst:354 +msgid "" +"The requirement to visit the type from ``tp_traverse`` was added in Python " +"3.9. If you support Python 3.8 and lower, the traverse function must *not* " +"visit the type, so it must be more complicated::" +msgstr "" + +#: howto/isolating-extensions.rst:366 +msgid "" +"Unfortunately, :c:data:`Py_Version` was only added in Python 3.11. As a " +"replacement, use:" +msgstr "" + +#: howto/isolating-extensions.rst:369 +msgid ":c:macro:`PY_VERSION_HEX`, if not using the stable ABI, or" +msgstr "" + +#: howto/isolating-extensions.rst:370 +msgid "" +":py:data:`sys.version_info` (via :c:func:`PySys_GetObject` and :c:func:" +"`PyArg_ParseTuple`)." +msgstr "" + +#: howto/isolating-extensions.rst:375 +msgid "Delegating ``tp_traverse``" +msgstr "" + +#: howto/isolating-extensions.rst:377 +msgid "" +"If your traverse function delegates to the :c:member:`~PyTypeObject." +"tp_traverse` of its base class (or another type), ensure that " +"``Py_TYPE(self)`` is visited only once. Note that only heap type are " +"expected to visit the type in ``tp_traverse``." +msgstr "" + +#: howto/isolating-extensions.rst:382 +msgid "For example, if your traverse function includes::" +msgstr "" + +#: howto/isolating-extensions.rst:386 msgid "...and ``base`` may be a static type, then it should also include::" msgstr "" -#: howto/isolating-extensions.rst:362 +#: howto/isolating-extensions.rst:396 +msgid "" +"It is not necessary to handle the type's reference count in :c:member:" +"`~PyTypeObject.tp_new` and :c:member:`~PyTypeObject.tp_clear`." +msgstr "" + +#: howto/isolating-extensions.rst:401 +msgid "Defining ``tp_dealloc``" +msgstr "" + +#: howto/isolating-extensions.rst:403 +msgid "" +"If your type has a custom :c:member:`~PyTypeObject.tp_dealloc` function, it " +"needs to:" +msgstr "" + +#: howto/isolating-extensions.rst:406 +msgid "" +"call :c:func:`PyObject_GC_UnTrack` before any fields are invalidated, and" +msgstr "" + +#: howto/isolating-extensions.rst:407 +msgid "decrement the reference count of the type." +msgstr "" + +#: howto/isolating-extensions.rst:409 +msgid "" +"To keep the type valid while ``tp_free`` is called, the type's refcount " +"needs to be decremented *after* the instance is deallocated. For example::" +msgstr "" + +#: howto/isolating-extensions.rst:421 +msgid "" +"The default ``tp_dealloc`` function does this, so if your type does *not* " +"override ``tp_dealloc`` you don't need to add it." +msgstr "" + +#: howto/isolating-extensions.rst:427 +msgid "Not overriding ``tp_free``" +msgstr "" + +#: howto/isolating-extensions.rst:429 +msgid "" +"The :c:member:`~PyTypeObject.tp_free` slot of a heap type must be set to :c:" +"func:`PyObject_GC_Del`. This is the default; do not override it." +msgstr "" + +#: howto/isolating-extensions.rst:435 +msgid "Avoiding ``PyObject_New``" +msgstr "" + +#: howto/isolating-extensions.rst:437 +msgid "GC-tracked objects need to be allocated using GC-aware functions." +msgstr "" + +#: howto/isolating-extensions.rst:439 +msgid "If you use use :c:func:`PyObject_New` or :c:func:`PyObject_NewVar`:" +msgstr "" + +#: howto/isolating-extensions.rst:441 +msgid "" +"Get and call type's :c:member:`~PyTypeObject.tp_alloc` slot, if possible. " +"That is, replace ``TYPE *o = PyObject_New(TYPE, typeobj)`` with::" +msgstr "" + +#: howto/isolating-extensions.rst:446 +msgid "" +"Replace ``o = PyObject_NewVar(TYPE, typeobj, size)`` with the same, but use " +"size instead of the 0." +msgstr "" + +#: howto/isolating-extensions.rst:449 msgid "" -"It is not necessary to handle the type's reference count in ``tp_new`` and " -"``tp_clear``." +"If the above is not possible (e.g. inside a custom ``tp_alloc``), call :c:" +"func:`PyObject_GC_New` or :c:func:`PyObject_GC_NewVar`::" msgstr "" -#: howto/isolating-extensions.rst:367 +#: howto/isolating-extensions.rst:458 msgid "Module State Access from Classes" msgstr "" -#: howto/isolating-extensions.rst:369 +#: howto/isolating-extensions.rst:460 msgid "" "If you have a type object defined with :c:func:`PyType_FromModuleAndSpec`, " "you can call :c:func:`PyType_GetModule` to get the associated module, and " "then :c:func:`PyModule_GetState` to get the module's state." msgstr "" -#: howto/isolating-extensions.rst:373 +#: howto/isolating-extensions.rst:464 msgid "" "To save a some tedious error-handling boilerplate code, you can combine " "these two steps with :c:func:`PyType_GetModuleState`, resulting in::" msgstr "" -#: howto/isolating-extensions.rst:383 +#: howto/isolating-extensions.rst:474 msgid "Module State Access from Regular Methods" msgstr "" -#: howto/isolating-extensions.rst:385 +#: howto/isolating-extensions.rst:476 msgid "" "Accessing the module-level state from methods of a class is somewhat more " "complicated, but is possible thanks to API introduced in Python 3.9. To get " @@ -498,27 +607,27 @@ msgid "" "module state from it." msgstr "" -#: howto/isolating-extensions.rst:390 +#: howto/isolating-extensions.rst:481 msgid "" "The largest roadblock is getting *the class a method was defined in*, or " "that method's \"defining class\" for short. The defining class can have a " "reference to the module it is part of." msgstr "" -#: howto/isolating-extensions.rst:394 +#: howto/isolating-extensions.rst:485 msgid "" "Do not confuse the defining class with :c:expr:`Py_TYPE(self)`. If the " "method is called on a *subclass* of your type, ``Py_TYPE(self)`` will refer " "to that subclass, which may be defined in different module than yours." msgstr "" -#: howto/isolating-extensions.rst:399 +#: howto/isolating-extensions.rst:490 msgid "" "The following Python code can illustrate the concept. ``Base." "get_defining_class`` returns ``Base`` even if ``type(self) == Sub``:" msgstr "" -#: howto/isolating-extensions.rst:415 +#: howto/isolating-extensions.rst:506 msgid "" "For a method to get its \"defining class\", it must use the :ref:" "`METH_METHOD | METH_FASTCALL | METH_KEYWORDS `__." msgstr "" -#: howto/isolating-extensions.rst:526 +#: howto/isolating-extensions.rst:617 msgid "Per-Class Scope" msgstr "" -#: howto/isolating-extensions.rst:528 +#: howto/isolating-extensions.rst:619 msgid "" "It is currently (as of Python 3.11) not possible to attach state to " "individual *types* without relying on CPython implementation details (which " @@ -623,11 +732,11 @@ msgid "" "per-class scope)." msgstr "" -#: howto/isolating-extensions.rst:535 +#: howto/isolating-extensions.rst:626 msgid "Lossless Conversion to Heap Types" msgstr "" -#: howto/isolating-extensions.rst:537 +#: howto/isolating-extensions.rst:628 msgid "" "The heap type API was not designed for \"lossless\" conversion from static " "types; that is, creating a type that works exactly like a given static type." diff --git a/howto/perf_profiling.po b/howto/perf_profiling.po index f16e6ce0f..a618bb193 100644 --- a/howto/perf_profiling.po +++ b/howto/perf_profiling.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-10-05 21:24+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -78,7 +78,7 @@ msgstr "" #: howto/perf_profiling.rst:100 msgid "" "As you can see, the Python functions are not shown in the output, only " -"``_Py_Eval_EvalFrameDefault`` (the function that evaluates the Python " +"``_PyEval_EvalFrameDefault`` (the function that evaluates the Python " "bytecode) shows up. Unfortunately that's not very useful because all Python " "functions use the same C function to evaluate bytecode so we cannot know " "which Python function corresponds to which bytecode-evaluating function." diff --git a/howto/pyporting.po b/howto/pyporting.po index a69246d7f..2a3f1ae6b 100644 --- a/howto/pyporting.po +++ b/howto/pyporting.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -107,58 +107,59 @@ msgstr "" #: howto/pyporting.rst:42 msgid "" -"Consider using optional static type checking to make sure your type usage " -"works in both Python 2 and 3 (e.g. use mypy_ to check your typing under both " -"Python 2 and Python 3; ``python -m pip install mypy``)." +"Consider using optional :term:`static type checking ` " +"to make sure your type usage works in both Python 2 and 3 (e.g. use mypy_ to " +"check your typing under both Python 2 and Python 3; ``python -m pip install " +"mypy``)." msgstr "" -#: howto/pyporting.rst:48 +#: howto/pyporting.rst:49 msgid "" "Note: Using ``python -m pip install`` guarantees that the ``pip`` you invoke " "is the one installed for the Python currently in use, whether it be a system-" "wide ``pip`` or one installed within a :ref:`virtual environment `." msgstr "" -#: howto/pyporting.rst:54 +#: howto/pyporting.rst:55 msgid "Details" msgstr "" -#: howto/pyporting.rst:56 +#: howto/pyporting.rst:57 msgid "" "Even if other factors - say, dependencies over which you have no control - " "still require you to support Python 2, that does not prevent you taking the " "step of including Python 3 support." msgstr "" -#: howto/pyporting.rst:60 +#: howto/pyporting.rst:61 msgid "" "Most changes required to support Python 3 lead to cleaner code using newer " "practices even in Python 2 code." msgstr "" -#: howto/pyporting.rst:65 +#: howto/pyporting.rst:66 msgid "Different versions of Python 2" msgstr "" -#: howto/pyporting.rst:67 +#: howto/pyporting.rst:68 msgid "" "Ideally, your code should be compatible with Python 2.7, which was the last " "supported version of Python 2." msgstr "" -#: howto/pyporting.rst:70 +#: howto/pyporting.rst:71 msgid "" "Some of the tools mentioned in this guide will not work with Python 2.6." msgstr "" -#: howto/pyporting.rst:72 +#: howto/pyporting.rst:73 msgid "" "If absolutely necessary, the six_ project can help you support Python 2.5 " "and 3 simultaneously. Do realize, though, that nearly all the projects " "listed in this guide will not be available to you." msgstr "" -#: howto/pyporting.rst:76 +#: howto/pyporting.rst:77 msgid "" "If you are able to skip Python 2.5 and older, the required changes to your " "code will be minimal. At worst you will have to use a function instead of a " @@ -166,12 +167,12 @@ msgid "" "built-in one." msgstr "" -#: howto/pyporting.rst:83 +#: howto/pyporting.rst:84 msgid "" "Make sure you specify the proper version support in your ``setup.py`` file" msgstr "" -#: howto/pyporting.rst:85 +#: howto/pyporting.rst:86 msgid "" "In your ``setup.py`` file you should have the proper `trove classifier`_ " "specifying what versions of Python you support. As your project does not " @@ -181,11 +182,11 @@ msgid "" "Python :: 2.7``." msgstr "" -#: howto/pyporting.rst:94 +#: howto/pyporting.rst:95 msgid "Have good test coverage" msgstr "" -#: howto/pyporting.rst:96 +#: howto/pyporting.rst:97 msgid "" "Once you have your code supporting the oldest version of Python 2 you want " "it to, you will want to make sure your test suite has good coverage. A good " @@ -197,11 +198,11 @@ msgid "" "test coverage then coverage.py_ is recommended." msgstr "" -#: howto/pyporting.rst:107 +#: howto/pyporting.rst:108 msgid "Be aware of the differences between Python 2 and 3" msgstr "" -#: howto/pyporting.rst:109 +#: howto/pyporting.rst:110 msgid "" "Once you have your code well-tested you are ready to begin porting your code " "to Python 3! But to fully understand how your code is going to change and " @@ -209,34 +210,34 @@ msgid "" "changes Python 3 makes in terms of Python 2." msgstr "" -#: howto/pyporting.rst:114 +#: howto/pyporting.rst:115 msgid "" "Some resources for understanding the differences and their implications for " "you code:" msgstr "" -#: howto/pyporting.rst:117 +#: howto/pyporting.rst:118 msgid "" "the :ref:`\"What's New\" ` doc for each release of Python 3" msgstr "" -#: howto/pyporting.rst:118 +#: howto/pyporting.rst:119 msgid "the `Porting to Python 3`_ book (which is free online)" msgstr "" -#: howto/pyporting.rst:119 +#: howto/pyporting.rst:120 msgid "the handy `cheat sheet`_ from the Python-Future project." msgstr "" -#: howto/pyporting.rst:123 +#: howto/pyporting.rst:124 msgid "Update your code" msgstr "" -#: howto/pyporting.rst:125 +#: howto/pyporting.rst:126 msgid "There are tools available that can port your code automatically." msgstr "" -#: howto/pyporting.rst:127 +#: howto/pyporting.rst:128 msgid "" "Futurize_ does its best to make Python 3 idioms and practices exist in " "Python 2, e.g. backporting the ``bytes`` type from Python 3 so that you have " @@ -244,13 +245,13 @@ msgid "" "approach for most cases." msgstr "" -#: howto/pyporting.rst:132 +#: howto/pyporting.rst:133 msgid "" "Modernize_, on the other hand, is more conservative and targets a Python 2/3 " "subset of Python, directly relying on six_ to help provide compatibility." msgstr "" -#: howto/pyporting.rst:135 +#: howto/pyporting.rst:136 msgid "" "A good approach is to run the tool over your test suite first and visually " "inspect the diff to make sure the transformation is accurate. After you have " @@ -259,22 +260,22 @@ msgid "" "tests which fail is a translation failure." msgstr "" -#: howto/pyporting.rst:141 +#: howto/pyporting.rst:142 msgid "" "Unfortunately the tools can't automate everything to make your code work " "under Python 3, and you will also need to read the tools' documentation in " "case some options you need are turned off by default." msgstr "" -#: howto/pyporting.rst:145 +#: howto/pyporting.rst:146 msgid "Key issues to be aware of and check for:" msgstr "" -#: howto/pyporting.rst:148 +#: howto/pyporting.rst:149 msgid "Division" msgstr "" -#: howto/pyporting.rst:150 +#: howto/pyporting.rst:151 msgid "" "In Python 3, ``5 / 2 == 2.5`` and not ``2`` as it was in Python 2; all " "division between ``int`` values result in a ``float``. This change has " @@ -285,17 +286,17 @@ msgid "" "this then you will need to go through your code and do two things:" msgstr "" -#: howto/pyporting.rst:158 +#: howto/pyporting.rst:159 msgid "Add ``from __future__ import division`` to your files" msgstr "" -#: howto/pyporting.rst:159 +#: howto/pyporting.rst:160 msgid "" "Update any division operator as necessary to either use ``//`` to use floor " "division or continue using ``/`` and expect a float" msgstr "" -#: howto/pyporting.rst:162 +#: howto/pyporting.rst:163 msgid "" "The reason that ``/`` isn't simply translated to ``//`` automatically is " "that if an object defines a ``__truediv__`` method but not ``__floordiv__`` " @@ -303,11 +304,11 @@ msgid "" "`` to signify some operation but not ``//`` for the same thing or at all)." msgstr "" -#: howto/pyporting.rst:169 +#: howto/pyporting.rst:170 msgid "Text versus binary data" msgstr "" -#: howto/pyporting.rst:171 +#: howto/pyporting.rst:172 msgid "" "In Python 2 you could use the ``str`` type for both text and binary data. " "Unfortunately this confluence of two different concepts could lead to " @@ -319,7 +320,7 @@ msgid "" "``unicode`` when they claimed text data support." msgstr "" -#: howto/pyporting.rst:180 +#: howto/pyporting.rst:181 msgid "" "Python 3 made text and binary data distinct types that cannot simply be " "mixed together. For any code that deals only with text or only binary data, " @@ -328,7 +329,7 @@ msgid "" "compared to binary data, which is why this cannot be entirely automated." msgstr "" -#: howto/pyporting.rst:186 +#: howto/pyporting.rst:187 msgid "" "Decide which APIs take text and which take binary (it is **highly** " "recommended you don't design APIs that can take both due to the difficulty " @@ -343,7 +344,7 @@ msgid "" "Python 3)." msgstr "" -#: howto/pyporting.rst:197 +#: howto/pyporting.rst:198 msgid "" "The following table lists the **unique** methods of each data type across " "Python 2 and 3 (e.g., the ``decode()`` method is usable on the equivalent " @@ -353,39 +354,39 @@ msgid "" "``__mod__`` method was added to the bytes type." msgstr "" -#: howto/pyporting.rst:205 +#: howto/pyporting.rst:206 msgid "**Text data**" msgstr "" -#: howto/pyporting.rst:205 +#: howto/pyporting.rst:206 msgid "**Binary data**" msgstr "" -#: howto/pyporting.rst:207 +#: howto/pyporting.rst:208 msgid "\\" msgstr "" -#: howto/pyporting.rst:207 +#: howto/pyporting.rst:208 msgid "decode" msgstr "" -#: howto/pyporting.rst:209 +#: howto/pyporting.rst:210 msgid "encode" msgstr "" -#: howto/pyporting.rst:211 +#: howto/pyporting.rst:212 msgid "format" msgstr "" -#: howto/pyporting.rst:213 +#: howto/pyporting.rst:214 msgid "isdecimal" msgstr "" -#: howto/pyporting.rst:215 +#: howto/pyporting.rst:216 msgid "isnumeric" msgstr "" -#: howto/pyporting.rst:218 +#: howto/pyporting.rst:219 msgid "" "Making the distinction easier to handle can be accomplished by encoding and " "decoding between binary data and text at the edge of your code. This means " @@ -395,7 +396,7 @@ msgid "" "eliminates having to keep track of what type of data you are working with." msgstr "" -#: howto/pyporting.rst:225 +#: howto/pyporting.rst:226 msgid "" "The next issue is making sure you know whether the string literals in your " "code represent text or binary data. You should add a ``b`` prefix to any " @@ -405,7 +406,7 @@ msgid "" "effective as adding a ``b`` or ``u`` prefix to all literals explicitly)" msgstr "" -#: howto/pyporting.rst:232 +#: howto/pyporting.rst:233 msgid "" "You also need to be careful about opening files. Possibly you have not " "always bothered to add the ``b`` mode when opening a binary file (e.g., " @@ -422,7 +423,7 @@ msgid "" "2.5." msgstr "" -#: howto/pyporting.rst:245 +#: howto/pyporting.rst:246 msgid "" "The constructors of both ``str`` and ``bytes`` have different semantics for " "the same arguments between Python 2 and 3. Passing an integer to ``bytes`` " @@ -435,7 +436,7 @@ msgid "" "representation of the bytes object: ``str(b'3') == \"b'3'\"``." msgstr "" -#: howto/pyporting.rst:255 +#: howto/pyporting.rst:256 msgid "" "Finally, the indexing of binary data requires careful handling (slicing does " "**not** require any special handling). In Python 2, ``b'123'[1] == b'2'`` " @@ -447,48 +448,48 @@ msgid "" "indexbytes(b'123', 1)``." msgstr "" -#: howto/pyporting.rst:264 +#: howto/pyporting.rst:265 msgid "To summarize:" msgstr "" -#: howto/pyporting.rst:266 +#: howto/pyporting.rst:267 msgid "Decide which of your APIs take text and which take binary data" msgstr "" -#: howto/pyporting.rst:267 +#: howto/pyporting.rst:268 msgid "" "Make sure that your code that works with text also works with ``unicode`` " "and code for binary data works with ``bytes`` in Python 2 (see the table " "above for what methods you cannot use for each type)" msgstr "" -#: howto/pyporting.rst:270 +#: howto/pyporting.rst:271 msgid "" "Mark all binary literals with a ``b`` prefix, textual literals with a ``u`` " "prefix" msgstr "" -#: howto/pyporting.rst:272 +#: howto/pyporting.rst:273 msgid "" "Decode binary data to text as soon as possible, encode text as binary data " "as late as possible" msgstr "" -#: howto/pyporting.rst:274 +#: howto/pyporting.rst:275 msgid "" "Open files using :func:`io.open` and make sure to specify the ``b`` mode " "when appropriate" msgstr "" -#: howto/pyporting.rst:276 +#: howto/pyporting.rst:277 msgid "Be careful when indexing into binary data" msgstr "" -#: howto/pyporting.rst:280 +#: howto/pyporting.rst:281 msgid "Use feature detection instead of version detection" msgstr "" -#: howto/pyporting.rst:282 +#: howto/pyporting.rst:283 msgid "" "Inevitably you will have code that has to choose what to do based on what " "version of Python is running. The best way to do this is with feature " @@ -498,7 +499,7 @@ msgid "" "let's look at an example." msgstr "" -#: howto/pyporting.rst:289 +#: howto/pyporting.rst:290 msgid "" "Let's pretend that you need access to a feature of :mod:`importlib` that is " "available in Python's standard library since Python 3.3 and available for " @@ -506,7 +507,7 @@ msgid "" "access e.g. the :mod:`importlib.abc` module by doing the following::" msgstr "" -#: howto/pyporting.rst:301 +#: howto/pyporting.rst:302 msgid "" "The problem with this code is what happens when Python 4 comes out? It would " "be better to treat Python 2 as the exceptional case instead of Python 3 and " @@ -514,18 +515,18 @@ msgid "" "than Python 2::" msgstr "" -#: howto/pyporting.rst:313 +#: howto/pyporting.rst:314 msgid "" "The best solution, though, is to do no version detection at all and instead " "rely on feature detection. That avoids any potential issues of getting the " "version detection wrong and helps keep you future-compatible::" msgstr "" -#: howto/pyporting.rst:324 +#: howto/pyporting.rst:325 msgid "Prevent compatibility regressions" msgstr "" -#: howto/pyporting.rst:326 +#: howto/pyporting.rst:327 msgid "" "Once you have fully translated your code to be compatible with Python 3, you " "will want to make sure your code doesn't regress and stop working under " @@ -533,13 +534,13 @@ msgid "" "you from actually running under Python 3 at the moment." msgstr "" -#: howto/pyporting.rst:331 +#: howto/pyporting.rst:332 msgid "" "To help with staying compatible, any new modules you create should have at " "least the following block of code at the top of it::" msgstr "" -#: howto/pyporting.rst:338 +#: howto/pyporting.rst:339 msgid "" "You can also run Python 2 with the ``-3`` flag to be warned about various " "compatibility issues your code triggers during execution. If you turn " @@ -547,7 +548,7 @@ msgid "" "accidentally miss a warning." msgstr "" -#: howto/pyporting.rst:343 +#: howto/pyporting.rst:344 msgid "" "You can also use the Pylint_ project and its ``--py3k`` flag to lint your " "code to receive warnings when your code begins to deviate from Python 3 " @@ -557,11 +558,11 @@ msgid "" "Pylint's minimum Python version support." msgstr "" -#: howto/pyporting.rst:352 +#: howto/pyporting.rst:353 msgid "Check which dependencies block your transition" msgstr "" -#: howto/pyporting.rst:354 +#: howto/pyporting.rst:355 msgid "" "**After** you have made your code compatible with Python 3 you should begin " "to care about whether your dependencies have also been ported. The " @@ -571,7 +572,7 @@ msgid "" "caniusepython3.com." msgstr "" -#: howto/pyporting.rst:361 +#: howto/pyporting.rst:362 msgid "" "The project also provides code which you can integrate into your test suite " "so that you will have a failing test when you no longer have dependencies " @@ -580,11 +581,11 @@ msgid "" "start running on Python 3." msgstr "" -#: howto/pyporting.rst:368 +#: howto/pyporting.rst:369 msgid "Update your ``setup.py`` file to denote Python 3 compatibility" msgstr "" -#: howto/pyporting.rst:370 +#: howto/pyporting.rst:371 msgid "" "Once your code works under Python 3, you should update the classifiers in " "your ``setup.py`` to contain ``Programming Language :: Python :: 3`` and to " @@ -593,11 +594,11 @@ msgid "" "classifiers for each major/minor version of Python you now support." msgstr "" -#: howto/pyporting.rst:378 +#: howto/pyporting.rst:379 msgid "Use continuous integration to stay compatible" msgstr "" -#: howto/pyporting.rst:380 +#: howto/pyporting.rst:381 msgid "" "Once you are able to fully run under Python 3 you will want to make sure " "your code always works under both Python 2 and 3. Probably the best tool for " @@ -606,7 +607,7 @@ msgid "" "accidentally break Python 2 or 3 support." msgstr "" -#: howto/pyporting.rst:386 +#: howto/pyporting.rst:387 msgid "" "You may also want to use the ``-bb`` flag with the Python 3 interpreter to " "trigger an exception when you are comparing bytes to strings or bytes to an " @@ -618,19 +619,19 @@ msgid "" "down." msgstr "" -#: howto/pyporting.rst:396 +#: howto/pyporting.rst:397 msgid "Consider using optional static type checking" msgstr "" -#: howto/pyporting.rst:398 +#: howto/pyporting.rst:399 msgid "" -"Another way to help port your code is to use a static type checker like " -"mypy_ or pytype_ on your code. These tools can be used to analyze your code " -"as if it's being run under Python 2, then you can run the tool a second time " -"as if your code is running under Python 3. By running a static type checker " -"twice like this you can discover if you're e.g. misusing binary data type in " -"one version of Python compared to another. If you add optional type hints to " -"your code you can also explicitly state whether your APIs use textual or " -"binary data, helping to make sure everything functions as expected in both " -"versions of Python." +"Another way to help port your code is to use a :term:`static type checker` " +"like mypy_ or pytype_ on your code. These tools can be used to analyze your " +"code as if it's being run under Python 2, then you can run the tool a second " +"time as if your code is running under Python 3. By running a static type " +"checker twice like this you can discover if you're e.g. misusing binary data " +"type in one version of Python compared to another. If you add optional type " +"hints to your code you can also explicitly state whether your APIs use " +"textual or binary data, helping to make sure everything functions as " +"expected in both versions of Python." msgstr "" diff --git a/library/asyncio-stream.po b/library/asyncio-stream.po index fceef36d2..d8c576f42 100644 --- a/library/asyncio-stream.po +++ b/library/asyncio-stream.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -93,7 +93,7 @@ msgid "Removed the *loop* parameter." msgstr "" #: library/asyncio-stream.rst:128 library/asyncio-stream.rst:190 -#: library/asyncio-stream.rst:368 +#: library/asyncio-stream.rst:372 msgid "Added the *ssl_shutdown_timeout* parameter." msgstr "" @@ -194,73 +194,77 @@ msgid "" msgstr "" #: library/asyncio-stream.rst:209 +msgid "Acknowledge the EOF." +msgstr "" + +#: library/asyncio-stream.rst:213 msgid "Read up to *n* bytes from the stream." msgstr "" -#: library/asyncio-stream.rst:211 +#: library/asyncio-stream.rst:215 msgid "" "If *n* is not provided or set to ``-1``, read until EOF, then return all " "read :class:`bytes`. If EOF was received and the internal buffer is empty, " "return an empty ``bytes`` object." msgstr "" -#: library/asyncio-stream.rst:216 +#: library/asyncio-stream.rst:220 msgid "If *n* is ``0``, return an empty ``bytes`` object immediately." msgstr "" -#: library/asyncio-stream.rst:218 +#: library/asyncio-stream.rst:222 msgid "" "If *n* is positive, return at most *n* available ``bytes`` as soon as at " "least 1 byte is available in the internal buffer. If EOF is received before " "any byte is read, return an empty ``bytes`` object." msgstr "" -#: library/asyncio-stream.rst:225 +#: library/asyncio-stream.rst:229 msgid "" "Read one line, where \"line\" is a sequence of bytes ending with ``\\n``." msgstr "" -#: library/asyncio-stream.rst:228 +#: library/asyncio-stream.rst:232 msgid "" "If EOF is received and ``\\n`` was not found, the method returns partially " "read data." msgstr "" -#: library/asyncio-stream.rst:231 +#: library/asyncio-stream.rst:235 msgid "" "If EOF is received and the internal buffer is empty, return an empty " "``bytes`` object." msgstr "" -#: library/asyncio-stream.rst:236 +#: library/asyncio-stream.rst:240 msgid "Read exactly *n* bytes." msgstr "" -#: library/asyncio-stream.rst:238 +#: library/asyncio-stream.rst:242 msgid "" "Raise an :exc:`IncompleteReadError` if EOF is reached before *n* can be " "read. Use the :attr:`IncompleteReadError.partial` attribute to get the " "partially read data." msgstr "" -#: library/asyncio-stream.rst:244 +#: library/asyncio-stream.rst:248 msgid "Read data from the stream until *separator* is found." msgstr "" -#: library/asyncio-stream.rst:246 +#: library/asyncio-stream.rst:250 msgid "" "On success, the data and separator will be removed from the internal buffer " "(consumed). Returned data will include the separator at the end." msgstr "" -#: library/asyncio-stream.rst:250 +#: library/asyncio-stream.rst:254 msgid "" "If the amount of data read exceeds the configured stream limit, a :exc:" "`LimitOverrunError` exception is raised, and the data is left in the " "internal buffer and can be read again." msgstr "" -#: library/asyncio-stream.rst:254 +#: library/asyncio-stream.rst:258 msgid "" "If EOF is reached before the complete separator is found, an :exc:" "`IncompleteReadError` exception is raised, and the internal buffer is " @@ -268,79 +272,79 @@ msgid "" "portion of the separator." msgstr "" -#: library/asyncio-stream.rst:263 +#: library/asyncio-stream.rst:267 msgid "Return ``True`` if the buffer is empty and :meth:`feed_eof` was called." msgstr "" -#: library/asyncio-stream.rst:268 +#: library/asyncio-stream.rst:272 msgid "StreamWriter" msgstr "" -#: library/asyncio-stream.rst:272 +#: library/asyncio-stream.rst:276 msgid "" "Represents a writer object that provides APIs to write data to the IO stream." msgstr "" -#: library/asyncio-stream.rst:275 +#: library/asyncio-stream.rst:279 msgid "" "It is not recommended to instantiate *StreamWriter* objects directly; use :" "func:`open_connection` and :func:`start_server` instead." msgstr "" -#: library/asyncio-stream.rst:281 +#: library/asyncio-stream.rst:285 msgid "" "The method attempts to write the *data* to the underlying socket " "immediately. If that fails, the data is queued in an internal write buffer " "until it can be sent." msgstr "" -#: library/asyncio-stream.rst:297 +#: library/asyncio-stream.rst:301 msgid "The method should be used along with the ``drain()`` method::" msgstr "" -#: library/asyncio-stream.rst:292 +#: library/asyncio-stream.rst:296 msgid "" "The method writes a list (or any iterable) of bytes to the underlying socket " "immediately. If that fails, the data is queued in an internal write buffer " "until it can be sent." msgstr "" -#: library/asyncio-stream.rst:304 +#: library/asyncio-stream.rst:308 msgid "The method closes the stream and the underlying socket." msgstr "" -#: library/asyncio-stream.rst:306 +#: library/asyncio-stream.rst:310 msgid "" "The method should be used, though not mandatory, along with the " "``wait_closed()`` method::" msgstr "" -#: library/asyncio-stream.rst:314 +#: library/asyncio-stream.rst:318 msgid "" "Return ``True`` if the underlying transport supports the :meth:`write_eof` " "method, ``False`` otherwise." msgstr "" -#: library/asyncio-stream.rst:319 +#: library/asyncio-stream.rst:323 msgid "" "Close the write end of the stream after the buffered write data is flushed." msgstr "" -#: library/asyncio-stream.rst:324 +#: library/asyncio-stream.rst:328 msgid "Return the underlying asyncio transport." msgstr "" -#: library/asyncio-stream.rst:328 +#: library/asyncio-stream.rst:332 msgid "" "Access optional transport information; see :meth:`BaseTransport." "get_extra_info` for details." msgstr "" -#: library/asyncio-stream.rst:333 +#: library/asyncio-stream.rst:337 msgid "Wait until it is appropriate to resume writing to the stream. Example::" msgstr "" -#: library/asyncio-stream.rst:339 +#: library/asyncio-stream.rst:343 msgid "" "This is a flow control method that interacts with the underlying IO write " "buffer. When the size of the buffer reaches the high watermark, *drain()* " @@ -349,123 +353,123 @@ msgid "" "`drain` returns immediately." msgstr "" -#: library/asyncio-stream.rst:349 +#: library/asyncio-stream.rst:353 msgid "Upgrade an existing stream-based connection to TLS." msgstr "" -#: library/asyncio-stream.rst:351 +#: library/asyncio-stream.rst:355 msgid "Parameters:" msgstr "" -#: library/asyncio-stream.rst:353 +#: library/asyncio-stream.rst:357 msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`." msgstr "" -#: library/asyncio-stream.rst:355 +#: library/asyncio-stream.rst:359 msgid "" "*server_hostname*: sets or overrides the host name that the target server's " "certificate will be matched against." msgstr "" -#: library/asyncio-stream.rst:358 +#: library/asyncio-stream.rst:362 msgid "" "*ssl_handshake_timeout* is the time in seconds to wait for the TLS handshake " "to complete before aborting the connection. ``60.0`` seconds if ``None`` " "(default)." msgstr "" -#: library/asyncio-stream.rst:362 +#: library/asyncio-stream.rst:366 msgid "" "*ssl_shutdown_timeout* is the time in seconds to wait for the SSL shutdown " "to complete before aborting the connection. ``30.0`` seconds if ``None`` " "(default)." msgstr "" -#: library/asyncio-stream.rst:374 +#: library/asyncio-stream.rst:378 msgid "" "Return ``True`` if the stream is closed or in the process of being closed." msgstr "" -#: library/asyncio-stream.rst:381 +#: library/asyncio-stream.rst:385 msgid "Wait until the stream is closed." msgstr "" -#: library/asyncio-stream.rst:383 +#: library/asyncio-stream.rst:387 msgid "" "Should be called after :meth:`close` to wait until the underlying connection " "is closed, ensuring that all data has been flushed before e.g. exiting the " "program." msgstr "" -#: library/asyncio-stream.rst:391 +#: library/asyncio-stream.rst:395 msgid "Examples" msgstr "" -#: library/asyncio-stream.rst:396 +#: library/asyncio-stream.rst:400 msgid "TCP echo client using streams" msgstr "" -#: library/asyncio-stream.rst:398 +#: library/asyncio-stream.rst:402 msgid "TCP echo client using the :func:`asyncio.open_connection` function::" msgstr "" -#: library/asyncio-stream.rst:422 +#: library/asyncio-stream.rst:426 msgid "" "The :ref:`TCP echo client protocol " "` example uses the low-level :meth:" "`loop.create_connection` method." msgstr "" -#: library/asyncio-stream.rst:429 +#: library/asyncio-stream.rst:433 msgid "TCP echo server using streams" msgstr "" -#: library/asyncio-stream.rst:431 +#: library/asyncio-stream.rst:435 msgid "TCP echo server using the :func:`asyncio.start_server` function::" msgstr "" -#: library/asyncio-stream.rst:465 +#: library/asyncio-stream.rst:469 msgid "" "The :ref:`TCP echo server protocol " "` example uses the :meth:`loop." "create_server` method." msgstr "" -#: library/asyncio-stream.rst:470 +#: library/asyncio-stream.rst:474 msgid "Get HTTP headers" msgstr "" -#: library/asyncio-stream.rst:472 +#: library/asyncio-stream.rst:476 msgid "" "Simple example querying HTTP headers of the URL passed on the command line::" msgstr "" -#: library/asyncio-stream.rst:511 +#: library/asyncio-stream.rst:515 msgid "Usage::" msgstr "" -#: library/asyncio-stream.rst:515 +#: library/asyncio-stream.rst:519 msgid "or with HTTPS::" msgstr "" -#: library/asyncio-stream.rst:523 +#: library/asyncio-stream.rst:527 msgid "Register an open socket to wait for data using streams" msgstr "" -#: library/asyncio-stream.rst:525 +#: library/asyncio-stream.rst:529 msgid "" "Coroutine waiting until a socket receives data using the :func:" "`open_connection` function::" msgstr "" -#: library/asyncio-stream.rst:560 +#: library/asyncio-stream.rst:564 msgid "" "The :ref:`register an open socket to wait for data using a protocol " "` example uses a low-level protocol and " "the :meth:`loop.create_connection` method." msgstr "" -#: library/asyncio-stream.rst:564 +#: library/asyncio-stream.rst:568 msgid "" "The :ref:`watch a file descriptor for read events " "` example uses the low-level :meth:`loop." diff --git a/library/cmdline.po b/library/cmdline.po index dcbcdcb2e..0b11f5494 100644 --- a/library/cmdline.po +++ b/library/cmdline.po @@ -8,10 +8,11 @@ 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: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" diff --git a/library/contextlib.po b/library/contextlib.po index 43ba5089b..1f8a1f4b1 100644 --- a/library/contextlib.po +++ b/library/contextlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -249,16 +249,16 @@ msgstr "" #: library/contextlib.rst:307 msgid "" -"If the code within the :keyword:`!with` block raises an :exc:" -"`ExceptionGroup`, suppressed exceptions are removed from the group. If any " -"exceptions in the group are not suppressed, a group containing them is re-" -"raised." +"If the code within the :keyword:`!with` block raises a :exc:" +"`BaseExceptionGroup`, suppressed exceptions are removed from the group. If " +"any exceptions in the group are not suppressed, a group containing them is " +"re-raised." msgstr "" #: library/contextlib.rst:313 msgid "" "``suppress`` now supports suppressing exceptions raised as part of an :exc:" -"`ExceptionGroup`." +"`BaseExceptionGroup`." msgstr "" #: library/contextlib.rst:319 diff --git a/library/datetime.po b/library/datetime.po index 4136a9341..288b7f1d7 100644 --- a/library/datetime.po +++ b/library/datetime.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-03-01 00:18+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: 2023-11-26 17:49-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -75,24 +75,26 @@ msgstr "" "Genişletilmiş saat dilimi ve ayrıştırma desteğine sahip üçüncü-parti " "kütüphane." -#: library/datetime.rst:41 +#: library/datetime.rst:42 msgid "Package `DateType `_" msgstr "Paket `DateType `_" #: library/datetime.rst:41 +#, fuzzy msgid "" -"Third-party library that introduces distinct static types to e.g. allow " -"static type checkers to differentiate between naive and aware datetimes." +"Third-party library that introduces distinct static types to e.g. allow :" +"term:`static type checkers ` to differentiate between " +"naive and aware datetimes." msgstr "" "Statik tür denetleyicilerinin bilinçli ve bilinçsiz tarih zamanları arasında " -"ayrım yapmasına izin vermek için farklı statik türler sunan üçüncü taraf " -"bir kütüphane." +"ayrım yapmasına izin vermek için farklı statik türler sunan üçüncü taraf bir " +"kütüphane." -#: library/datetime.rst:47 +#: library/datetime.rst:48 msgid "Aware and Naive Objects" msgstr "Bilinçli ve Bilinçsiz Nesneler" -#: library/datetime.rst:49 +#: library/datetime.rst:50 msgid "" "Date and time objects may be categorized as \"aware\" or \"naive\" depending " "on whether or not they include timezone information." @@ -100,7 +102,7 @@ msgstr "" "Tarih ve zaman nesneleri, zaman dilimi içerip içermediklerine göre " "\"bilinçli\" veya \"bilinçsiz\" olarak kategorize edilebilir." -#: library/datetime.rst:52 +#: library/datetime.rst:53 msgid "" "With sufficient knowledge of applicable algorithmic and political time " "adjustments, such as time zone and daylight saving time information, an " @@ -113,7 +115,7 @@ msgstr "" "kendisini diğer farkında nesnelere göre konumlandırabilir. Bilinçli bir " "nesne, zaman içinde yoruma açık olmayan belirli bir anı temsil eder. [#]_" -#: library/datetime.rst:58 +#: library/datetime.rst:59 msgid "" "A **naive** object does not contain enough information to unambiguously " "locate itself relative to other date/time objects. Whether a naive object " @@ -131,7 +133,7 @@ msgstr "" "programa bağlı olması gibi. Bilinçsiz nesnelerin anlaşılması ve üzerinde " "çalışılması, gerçekliğin bazı yönlerini göz ardı etme pahasına kolaydır." -#: library/datetime.rst:65 +#: library/datetime.rst:66 msgid "" "For applications requiring aware objects, :class:`.datetime` and :class:`." "time` objects have an optional time zone information attribute, :attr:`!" @@ -147,7 +149,7 @@ msgstr "" "saat dilimi adı ve yaz saati uygulamasının geçerli olup olmadığına ilişkin " "bilgileri yakalar." -#: library/datetime.rst:71 +#: library/datetime.rst:72 msgid "" "Only one concrete :class:`tzinfo` class, the :class:`timezone` class, is " "supplied by the :mod:`datetime` module. The :class:`timezone` class can " @@ -166,15 +168,15 @@ msgstr "" "politiktir, sık sık değişir ve UTC dışında her uygulama için uygun bir " "standart yoktur." -#: library/datetime.rst:80 +#: library/datetime.rst:81 msgid "Constants" msgstr "Sabitler" -#: library/datetime.rst:82 +#: library/datetime.rst:83 msgid "The :mod:`datetime` module exports the following constants:" msgstr ":mod:`datetime` modülü aşağıdaki sabitleri dışa aktarır:" -#: library/datetime.rst:86 +#: library/datetime.rst:87 msgid "" "The smallest year number allowed in a :class:`date` or :class:`.datetime` " "object. :const:`MINYEAR` is ``1``." @@ -182,7 +184,7 @@ msgstr "" "Bir :class:`date` veya :class:`.datetime` nesnesinde izin verilen en küçük " "yıl sayısı. :const:`MINYEAR`, ``1``'e eşittir." -#: library/datetime.rst:92 +#: library/datetime.rst:93 msgid "" "The largest year number allowed in a :class:`date` or :class:`.datetime` " "object. :const:`MAXYEAR` is ``9999``." @@ -190,26 +192,26 @@ msgstr "" "Bir :class:`date` veya :class:`.datetime` nesnesinde izin verilen en büyük " "yıl sayısı. :const:`MAXYEAR`, ``9999``'a eşittir." -#: library/datetime.rst:97 +#: library/datetime.rst:98 msgid "Alias for the UTC timezone singleton :attr:`datetime.timezone.utc`." msgstr "" "UTC zaman dilimi singleton :attr:`datetime.timezone.utc` için takma ad." -#: library/datetime.rst:102 +#: library/datetime.rst:103 msgid "Available Types" msgstr "Mevcut Türler" -#: library/datetime.rst:107 +#: library/datetime.rst:108 msgid "" "An idealized naive date, assuming the current Gregorian calendar always was, " "and always will be, in effect. Attributes: :attr:`year`, :attr:`month`, and :" "attr:`day`." msgstr "" "Geçerli Miladi takvimin her zaman yürürlükte olduğu ve her zaman yürürlükte " -"olacağı varsayılarak idealleştirilmiş bilinçsiz bir tarih. Öznitelikler: :attr:" -"`year`, :attr:`month`, ve :attr:`day`." +"olacağı varsayılarak idealleştirilmiş bilinçsiz bir tarih. Öznitelikler: :" +"attr:`year`, :attr:`month`, ve :attr:`day`." -#: library/datetime.rst:115 +#: library/datetime.rst:116 msgid "" "An idealized time, independent of any particular day, assuming that every " "day has exactly 24\\*60\\*60 seconds. (There is no notion of \"leap " @@ -221,7 +223,7 @@ msgstr "" "kavramı yoktur.) Öznitelikler: :attr:`hour`, :attr:`minute`, :attr:" "`second`, :attr:`microsecond`, ve :attr:`.tzinfo`." -#: library/datetime.rst:124 +#: library/datetime.rst:125 msgid "" "A combination of a date and a time. Attributes: :attr:`year`, :attr:" "`month`, :attr:`day`, :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:" @@ -231,7 +233,7 @@ msgstr "" "`month`, :attr:`day`, :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:" "`microsecond` ve :attr:`.tzinfo`." -#: library/datetime.rst:132 +#: library/datetime.rst:133 msgid "" "A duration expressing the difference between two :class:`date`, :class:`." "time`, or :class:`.datetime` instances to microsecond resolution." @@ -239,7 +241,7 @@ msgstr "" "İki :class:`date`, :class:`.time` veya :class:`.datetime` örneği arasındaki " "farkı mikrosaniye çözünürlüğünde ifade eden bir süre." -#: library/datetime.rst:139 +#: library/datetime.rst:140 msgid "" "An abstract base class for time zone information objects. These are used by " "the :class:`.datetime` and :class:`.time` classes to provide a customizable " @@ -251,7 +253,7 @@ msgstr "" "zaman ayarlaması sağlamak için kullanılır (örneğin, saat dilimini ve/veya " "yaz saati uygulamasını hesaba katmak için)." -#: library/datetime.rst:147 +#: library/datetime.rst:148 msgid "" "A class that implements the :class:`tzinfo` abstract base class as a fixed " "offset from the UTC." @@ -259,19 +261,19 @@ msgstr "" "UTC'den sabit bir ofset olarak :class:`tzinfo` soyut temel sınıfını " "uygulayan bir sınıf." -#: library/datetime.rst:170 +#: library/datetime.rst:171 msgid "Objects of these types are immutable." msgstr "Bu türdeki nesneler değiştirilemezdir." -#: library/datetime.rst:154 +#: library/datetime.rst:155 msgid "Subclass relationships::" msgstr "Alt sınıf ilişkileri::" -#: library/datetime.rst:165 +#: library/datetime.rst:166 msgid "Common Properties" msgstr "Ortak Özellikler" -#: library/datetime.rst:167 +#: library/datetime.rst:168 msgid "" "The :class:`date`, :class:`.datetime`, :class:`.time`, and :class:`timezone` " "types share these common features:" @@ -279,7 +281,7 @@ msgstr "" ":class:`date`, :class:`.datetime`, :class:`.time` ve :class:`timezone` " "türleri bu ortak özellikleri paylaşır:" -#: library/datetime.rst:171 +#: library/datetime.rst:172 msgid "" "Objects of these types are :term:`hashable`, meaning that they can be used " "as dictionary keys." @@ -287,7 +289,7 @@ msgstr "" "Bu türdeki nesneler :term:`hashable` 'dır, yani sözlük anahtarları olarak " "kullanılabilirler." -#: library/datetime.rst:173 +#: library/datetime.rst:174 msgid "" "Objects of these types support efficient pickling via the :mod:`pickle` " "module." @@ -295,123 +297,123 @@ msgstr "" "Bu tür nesneler :mod:`pickle` modülü aracılığıyla verimli pickling işlemini " "destekler." -#: library/datetime.rst:176 +#: library/datetime.rst:177 msgid "Determining if an Object is Aware or Naive" msgstr "Bir Nesnenin Bilinçli veya Bilinçsiz Olduğunu Belirleme" -#: library/datetime.rst:178 +#: library/datetime.rst:179 msgid "Objects of the :class:`date` type are always naive." msgstr ":class:`date` türündeki nesneler her zaman bilinçsizdir." -#: library/datetime.rst:180 +#: library/datetime.rst:181 msgid "" "An object of type :class:`.time` or :class:`.datetime` may be aware or naive." msgstr "" ":class:`.time` veya :class:`.datetime` türündeki bir nesne bilinçli veya " "bilinçsiz olabilir." -#: library/datetime.rst:182 +#: library/datetime.rst:183 msgid "A :class:`.datetime` object *d* is aware if both of the following hold:" msgstr "" -#: library/datetime.rst:184 +#: library/datetime.rst:185 msgid "``d.tzinfo`` is not ``None``" msgstr "" -#: library/datetime.rst:185 +#: library/datetime.rst:186 msgid "``d.tzinfo.utcoffset(d)`` does not return ``None``" msgstr "" -#: library/datetime.rst:187 +#: library/datetime.rst:188 msgid "Otherwise, *d* is naive." msgstr "" -#: library/datetime.rst:189 +#: library/datetime.rst:190 msgid "A :class:`.time` object *t* is aware if both of the following hold:" msgstr "" -#: library/datetime.rst:191 +#: library/datetime.rst:192 msgid "``t.tzinfo`` is not ``None``" msgstr "" -#: library/datetime.rst:192 +#: library/datetime.rst:193 msgid "``t.tzinfo.utcoffset(None)`` does not return ``None``." msgstr "" -#: library/datetime.rst:194 +#: library/datetime.rst:195 msgid "Otherwise, *t* is naive." msgstr "" -#: library/datetime.rst:196 +#: library/datetime.rst:197 msgid "" "The distinction between aware and naive doesn't apply to :class:`timedelta` " "objects." msgstr "" -#: library/datetime.rst:202 +#: library/datetime.rst:203 msgid ":class:`timedelta` Objects" msgstr "" -#: library/datetime.rst:204 +#: library/datetime.rst:205 msgid "" "A :class:`timedelta` object represents a duration, the difference between " "two dates or times." msgstr "" -#: library/datetime.rst:209 +#: library/datetime.rst:210 msgid "" "All arguments are optional and default to ``0``. Arguments may be integers " "or floats, and may be positive or negative." msgstr "" -#: library/datetime.rst:212 +#: library/datetime.rst:213 msgid "" "Only *days*, *seconds* and *microseconds* are stored internally. Arguments " "are converted to those units:" msgstr "" -#: library/datetime.rst:215 +#: library/datetime.rst:216 msgid "A millisecond is converted to 1000 microseconds." msgstr "" -#: library/datetime.rst:216 +#: library/datetime.rst:217 msgid "A minute is converted to 60 seconds." msgstr "" -#: library/datetime.rst:217 +#: library/datetime.rst:218 msgid "An hour is converted to 3600 seconds." msgstr "" -#: library/datetime.rst:218 +#: library/datetime.rst:219 msgid "A week is converted to 7 days." msgstr "" -#: library/datetime.rst:220 +#: library/datetime.rst:221 msgid "" "and days, seconds and microseconds are then normalized so that the " "representation is unique, with" msgstr "" -#: library/datetime.rst:223 +#: library/datetime.rst:224 msgid "``0 <= microseconds < 1000000``" msgstr "" -#: library/datetime.rst:224 +#: library/datetime.rst:225 msgid "``0 <= seconds < 3600*24`` (the number of seconds in one day)" msgstr "" -#: library/datetime.rst:225 +#: library/datetime.rst:226 msgid "``-999999999 <= days <= 999999999``" msgstr "" -#: library/datetime.rst:227 +#: library/datetime.rst:228 msgid "" "The following example illustrates how any arguments besides *days*, " "*seconds* and *microseconds* are \"merged\" and normalized into those three " "resulting attributes::" msgstr "" -#: library/datetime.rst:245 +#: library/datetime.rst:246 msgid "" "If any argument is a float and there are fractional microseconds, the " "fractional microseconds left over from all arguments are combined and their " @@ -420,274 +422,274 @@ msgid "" "processes are exact (no information is lost)." msgstr "" -#: library/datetime.rst:252 +#: library/datetime.rst:253 msgid "" "If the normalized value of days lies outside the indicated range, :exc:" "`OverflowError` is raised." msgstr "" -#: library/datetime.rst:255 +#: library/datetime.rst:256 msgid "" "Note that normalization of negative values may be surprising at first. For " "example::" msgstr "" -#: library/datetime.rst:560 library/datetime.rst:1692 library/datetime.rst:2294 +#: library/datetime.rst:561 library/datetime.rst:1693 library/datetime.rst:2295 msgid "Class attributes:" msgstr "" -#: library/datetime.rst:268 +#: library/datetime.rst:269 msgid "The most negative :class:`timedelta` object, ``timedelta(-999999999)``." msgstr "" -#: library/datetime.rst:273 +#: library/datetime.rst:274 msgid "" "The most positive :class:`timedelta` object, ``timedelta(days=999999999, " "hours=23, minutes=59, seconds=59, microseconds=999999)``." msgstr "" -#: library/datetime.rst:279 +#: library/datetime.rst:280 msgid "" "The smallest possible difference between non-equal :class:`timedelta` " "objects, ``timedelta(microseconds=1)``." msgstr "" -#: library/datetime.rst:282 +#: library/datetime.rst:283 msgid "" "Note that, because of normalization, ``timedelta.max`` > ``-timedelta.min``. " "``-timedelta.max`` is not representable as a :class:`timedelta` object." msgstr "" -#: library/datetime.rst:578 library/datetime.rst:1712 +#: library/datetime.rst:579 library/datetime.rst:1713 msgid "Instance attributes (read-only):" msgstr "" -#: library/datetime.rst:288 +#: library/datetime.rst:289 msgid "Attribute" msgstr "" -#: library/datetime.rst:288 +#: library/datetime.rst:289 msgid "Value" msgstr "" -#: library/datetime.rst:290 +#: library/datetime.rst:291 msgid "``days``" msgstr "" -#: library/datetime.rst:290 +#: library/datetime.rst:291 msgid "Between -999999999 and 999999999 inclusive" msgstr "" -#: library/datetime.rst:292 +#: library/datetime.rst:293 msgid "``seconds``" msgstr "" -#: library/datetime.rst:292 +#: library/datetime.rst:293 msgid "Between 0 and 86399 inclusive" msgstr "" -#: library/datetime.rst:294 +#: library/datetime.rst:295 msgid "``microseconds``" msgstr "" -#: library/datetime.rst:294 +#: library/datetime.rst:295 msgid "Between 0 and 999999 inclusive" msgstr "" -#: library/datetime.rst:595 library/datetime.rst:1146 +#: library/datetime.rst:596 library/datetime.rst:1147 msgid "Supported operations:" msgstr "" -#: library/datetime.rst:598 library/datetime.rst:1149 +#: library/datetime.rst:599 library/datetime.rst:1150 msgid "Operation" msgstr "" -#: library/datetime.rst:598 library/datetime.rst:1149 +#: library/datetime.rst:599 library/datetime.rst:1150 msgid "Result" msgstr "" -#: library/datetime.rst:304 +#: library/datetime.rst:305 msgid "``t1 = t2 + t3``" msgstr "" -#: library/datetime.rst:304 +#: library/datetime.rst:305 msgid "" "Sum of *t2* and *t3*. Afterwards *t1*-*t2* == *t3* and *t1*-*t3* == *t2* are " "true. (1)" msgstr "" -#: library/datetime.rst:307 +#: library/datetime.rst:308 msgid "``t1 = t2 - t3``" msgstr "" -#: library/datetime.rst:307 +#: library/datetime.rst:308 msgid "" "Difference of *t2* and *t3*. Afterwards *t1* == *t2* - *t3* and *t2* == *t1* " "+ *t3* are true. (1)(6)" msgstr "" -#: library/datetime.rst:311 +#: library/datetime.rst:312 msgid "``t1 = t2 * i or t1 = i * t2``" msgstr "" -#: library/datetime.rst:311 +#: library/datetime.rst:312 msgid "" "Delta multiplied by an integer. Afterwards *t1* // i == *t2* is true, " "provided ``i != 0``." msgstr "" -#: library/datetime.rst:315 +#: library/datetime.rst:316 msgid "In general, *t1* \\* i == *t1* \\* (i-1) + *t1* is true. (1)" msgstr "" -#: library/datetime.rst:318 +#: library/datetime.rst:319 msgid "``t1 = t2 * f or t1 = f * t2``" msgstr "" -#: library/datetime.rst:318 +#: library/datetime.rst:319 msgid "" "Delta multiplied by a float. The result is rounded to the nearest multiple " "of timedelta.resolution using round-half-to-even." msgstr "" -#: library/datetime.rst:322 +#: library/datetime.rst:323 msgid "``f = t2 / t3``" msgstr "" -#: library/datetime.rst:322 +#: library/datetime.rst:323 msgid "" "Division (3) of overall duration *t2* by interval unit *t3*. Returns a :" "class:`float` object." msgstr "" -#: library/datetime.rst:326 +#: library/datetime.rst:327 msgid "``t1 = t2 / f or t1 = t2 / i``" msgstr "" -#: library/datetime.rst:326 +#: library/datetime.rst:327 msgid "" "Delta divided by a float or an int. The result is rounded to the nearest " "multiple of timedelta.resolution using round-half-to-even." msgstr "" -#: library/datetime.rst:330 +#: library/datetime.rst:331 msgid "``t1 = t2 // i`` or ``t1 = t2 // t3``" msgstr "" -#: library/datetime.rst:330 +#: library/datetime.rst:331 msgid "" "The floor is computed and the remainder (if any) is thrown away. In the " "second case, an integer is returned. (3)" msgstr "" -#: library/datetime.rst:334 +#: library/datetime.rst:335 msgid "``t1 = t2 % t3``" msgstr "" -#: library/datetime.rst:334 +#: library/datetime.rst:335 msgid "The remainder is computed as a :class:`timedelta` object. (3)" msgstr "" -#: library/datetime.rst:337 +#: library/datetime.rst:338 msgid "``q, r = divmod(t1, t2)``" msgstr "" -#: library/datetime.rst:337 +#: library/datetime.rst:338 msgid "" "Computes the quotient and the remainder: ``q = t1 // t2`` (3) and ``r = t1 % " "t2``. q is an integer and r is a :class:`timedelta` object." msgstr "" -#: library/datetime.rst:342 +#: library/datetime.rst:343 msgid "``+t1``" msgstr "" -#: library/datetime.rst:342 +#: library/datetime.rst:343 msgid "Returns a :class:`timedelta` object with the same value. (2)" msgstr "" -#: library/datetime.rst:345 +#: library/datetime.rst:346 msgid "``-t1``" msgstr "" -#: library/datetime.rst:345 +#: library/datetime.rst:346 msgid "" "equivalent to :class:`timedelta`\\ (-*t1.days*, -*t1.seconds*, -*t1." "microseconds*), and to *t1*\\* -1. (1)(4)" msgstr "" -#: library/datetime.rst:350 +#: library/datetime.rst:351 msgid "``abs(t)``" msgstr "" -#: library/datetime.rst:350 +#: library/datetime.rst:351 msgid "" "equivalent to +\\ *t* when ``t.days >= 0``, and to -*t* when ``t.days < 0``. " "(2)" msgstr "" -#: library/datetime.rst:353 +#: library/datetime.rst:354 msgid "``str(t)``" msgstr "" -#: library/datetime.rst:353 +#: library/datetime.rst:354 msgid "" "Returns a string in the form ``[D day[s], ][H]H:MM:SS[.UUUUUU]``, where D is " "negative for negative ``t``. (5)" msgstr "" -#: library/datetime.rst:357 +#: library/datetime.rst:358 msgid "``repr(t)``" msgstr "" -#: library/datetime.rst:357 +#: library/datetime.rst:358 msgid "" "Returns a string representation of the :class:`timedelta` object as a " "constructor call with canonical attribute values." msgstr "" -#: library/datetime.rst:612 library/datetime.rst:2525 +#: library/datetime.rst:613 library/datetime.rst:2526 msgid "Notes:" msgstr "" -#: library/datetime.rst:366 +#: library/datetime.rst:367 msgid "This is exact but may overflow." msgstr "" -#: library/datetime.rst:369 +#: library/datetime.rst:370 msgid "This is exact and cannot overflow." msgstr "" -#: library/datetime.rst:372 +#: library/datetime.rst:373 msgid "Division by 0 raises :exc:`ZeroDivisionError`." msgstr "" -#: library/datetime.rst:375 +#: library/datetime.rst:376 msgid "-*timedelta.max* is not representable as a :class:`timedelta` object." msgstr "" -#: library/datetime.rst:378 +#: library/datetime.rst:379 msgid "" "String representations of :class:`timedelta` objects are normalized " "similarly to their internal representation. This leads to somewhat unusual " "results for negative timedeltas. For example::" msgstr "" -#: library/datetime.rst:388 +#: library/datetime.rst:389 msgid "" "The expression ``t2 - t3`` will always be equal to the expression ``t2 + (-" "t3)`` except when t3 is equal to ``timedelta.max``; in that case the former " "will produce a result while the latter will overflow." msgstr "" -#: library/datetime.rst:392 +#: library/datetime.rst:393 msgid "" "In addition to the operations listed above, :class:`timedelta` objects " "support certain additions and subtractions with :class:`date` and :class:`." "datetime` objects (see below)." msgstr "" -#: library/datetime.rst:396 +#: library/datetime.rst:397 msgid "" "Floor division and true division of a :class:`timedelta` object by another :" "class:`timedelta` object are now supported, as are remainder operations and " @@ -695,118 +697,118 @@ msgid "" "`timedelta` object by a :class:`float` object are now supported." msgstr "" -#: library/datetime.rst:403 +#: library/datetime.rst:404 msgid "" "Comparisons of :class:`timedelta` objects are supported, with some caveats." msgstr "" -#: library/datetime.rst:405 +#: library/datetime.rst:406 msgid "" "The comparisons ``==`` or ``!=`` *always* return a :class:`bool`, no matter " "the type of the compared object::" msgstr "" -#: library/datetime.rst:416 +#: library/datetime.rst:417 msgid "" "For all other comparisons (such as ``<`` and ``>``), when a :class:" "`timedelta` object is compared to an object of a different type, :exc:" "`TypeError` is raised::" msgstr "" -#: library/datetime.rst:427 +#: library/datetime.rst:428 msgid "" "In Boolean contexts, a :class:`timedelta` object is considered to be true if " "and only if it isn't equal to ``timedelta(0)``." msgstr "" -#: library/datetime.rst:641 library/datetime.rst:1820 +#: library/datetime.rst:642 library/datetime.rst:1821 msgid "Instance methods:" msgstr "" -#: library/datetime.rst:434 +#: library/datetime.rst:435 msgid "" "Return the total number of seconds contained in the duration. Equivalent to " "``td / timedelta(seconds=1)``. For interval units other than seconds, use " "the division form directly (e.g. ``td / timedelta(microseconds=1)``)." msgstr "" -#: library/datetime.rst:438 +#: library/datetime.rst:439 msgid "" "Note that for very large time intervals (greater than 270 years on most " "platforms) this method will lose microsecond accuracy." msgstr "" -#: library/datetime.rst:444 +#: library/datetime.rst:445 msgid "Examples of usage: :class:`timedelta`" msgstr "" -#: library/datetime.rst:446 +#: library/datetime.rst:447 msgid "An additional example of normalization::" msgstr "" -#: library/datetime.rst:458 +#: library/datetime.rst:459 msgid "Examples of :class:`timedelta` arithmetic::" msgstr "" -#: library/datetime.rst:477 +#: library/datetime.rst:478 msgid ":class:`date` Objects" msgstr "" -#: library/datetime.rst:479 +#: library/datetime.rst:480 msgid "" "A :class:`date` object represents a date (year, month and day) in an " "idealized calendar, the current Gregorian calendar indefinitely extended in " "both directions." msgstr "" -#: library/datetime.rst:483 +#: library/datetime.rst:484 msgid "" "January 1 of year 1 is called day number 1, January 2 of year 1 is called " "day number 2, and so on. [#]_" msgstr "" -#: library/datetime.rst:488 +#: library/datetime.rst:489 msgid "" "All arguments are required. Arguments must be integers, in the following " "ranges:" msgstr "" -#: library/datetime.rst:491 +#: library/datetime.rst:492 msgid "``MINYEAR <= year <= MAXYEAR``" msgstr "" -#: library/datetime.rst:492 +#: library/datetime.rst:493 msgid "``1 <= month <= 12``" msgstr "" -#: library/datetime.rst:493 +#: library/datetime.rst:494 msgid "``1 <= day <= number of days in the given month and year``" msgstr "" -#: library/datetime.rst:856 +#: library/datetime.rst:857 msgid "" "If an argument outside those ranges is given, :exc:`ValueError` is raised." msgstr "" -#: library/datetime.rst:861 +#: library/datetime.rst:862 msgid "Other constructors, all class methods:" msgstr "" -#: library/datetime.rst:502 +#: library/datetime.rst:503 msgid "Return the current local date." msgstr "" -#: library/datetime.rst:504 +#: library/datetime.rst:505 msgid "This is equivalent to ``date.fromtimestamp(time.time())``." msgstr "" -#: library/datetime.rst:508 +#: library/datetime.rst:509 msgid "" "Return the local date corresponding to the POSIX timestamp, such as is " "returned by :func:`time.time`." msgstr "" -#: library/datetime.rst:511 +#: library/datetime.rst:512 msgid "" "This may raise :exc:`OverflowError`, if the timestamp is out of the range of " "values supported by the platform C :c:func:`localtime` function, and :exc:" @@ -816,7 +818,7 @@ msgid "" "ignored by :meth:`fromtimestamp`." msgstr "" -#: library/datetime.rst:518 +#: library/datetime.rst:519 msgid "" "Raise :exc:`OverflowError` instead of :exc:`ValueError` if the timestamp is " "out of the range of values supported by the platform C :c:func:`localtime` " @@ -824,96 +826,96 @@ msgid "" "`localtime` failure." msgstr "" -#: library/datetime.rst:527 +#: library/datetime.rst:528 msgid "" "Return the date corresponding to the proleptic Gregorian ordinal, where " "January 1 of year 1 has ordinal 1." msgstr "" -#: library/datetime.rst:530 +#: library/datetime.rst:531 msgid "" ":exc:`ValueError` is raised unless ``1 <= ordinal <= date.max.toordinal()``. " "For any date *d*, ``date.fromordinal(d.toordinal()) == d``." msgstr "" -#: library/datetime.rst:537 +#: library/datetime.rst:538 msgid "" "Return a :class:`date` corresponding to a *date_string* given in any valid " "ISO 8601 format, except ordinal dates (e.g. ``YYYY-DDD``)::" msgstr "" -#: library/datetime.rst:549 +#: library/datetime.rst:550 msgid "Previously, this method only supported the format ``YYYY-MM-DD``." msgstr "" -#: library/datetime.rst:554 +#: library/datetime.rst:555 msgid "" "Return a :class:`date` corresponding to the ISO calendar date specified by " "year, week and day. This is the inverse of the function :meth:`date." "isocalendar`." msgstr "" -#: library/datetime.rst:564 +#: library/datetime.rst:565 msgid "The earliest representable date, ``date(MINYEAR, 1, 1)``." msgstr "" -#: library/datetime.rst:569 +#: library/datetime.rst:570 msgid "The latest representable date, ``date(MAXYEAR, 12, 31)``." msgstr "" -#: library/datetime.rst:574 +#: library/datetime.rst:575 msgid "" "The smallest possible difference between non-equal date objects, " "``timedelta(days=1)``." msgstr "" -#: library/datetime.rst:1097 +#: library/datetime.rst:1098 msgid "Between :const:`MINYEAR` and :const:`MAXYEAR` inclusive." msgstr "" -#: library/datetime.rst:1102 +#: library/datetime.rst:1103 msgid "Between 1 and 12 inclusive." msgstr "" -#: library/datetime.rst:1107 +#: library/datetime.rst:1108 msgid "Between 1 and the number of days in the given month of the given year." msgstr "" -#: library/datetime.rst:600 +#: library/datetime.rst:601 msgid "``date2 = date1 + timedelta``" msgstr "" -#: library/datetime.rst:600 +#: library/datetime.rst:601 msgid "*date2* will be ``timedelta.days`` days after *date1*. (1)" msgstr "" -#: library/datetime.rst:603 +#: library/datetime.rst:604 msgid "``date2 = date1 - timedelta``" msgstr "" -#: library/datetime.rst:603 +#: library/datetime.rst:604 msgid "Computes *date2* such that ``date2 + timedelta == date1``. (2)" msgstr "" -#: library/datetime.rst:606 +#: library/datetime.rst:607 msgid "``timedelta = date1 - date2``" msgstr "" -#: library/datetime.rst:1155 +#: library/datetime.rst:1156 msgid "\\(3)" msgstr "" -#: library/datetime.rst:608 +#: library/datetime.rst:609 msgid "``date1 < date2``" msgstr "" -#: library/datetime.rst:608 +#: library/datetime.rst:609 msgid "" "*date1* is considered less than *date2* when *date1* precedes *date2* in " "time. (4)" msgstr "" -#: library/datetime.rst:615 +#: library/datetime.rst:616 msgid "" "*date2* is moved forward in time if ``timedelta.days > 0``, or backward if " "``timedelta.days < 0``. Afterward ``date2 - date1 == timedelta.days``. " @@ -922,17 +924,17 @@ msgid "" "`MINYEAR` or larger than :const:`MAXYEAR`." msgstr "" -#: library/datetime.rst:622 +#: library/datetime.rst:623 msgid "``timedelta.seconds`` and ``timedelta.microseconds`` are ignored." msgstr "" -#: library/datetime.rst:625 +#: library/datetime.rst:626 msgid "" "This is exact, and cannot overflow. timedelta.seconds and timedelta." "microseconds are 0, and date2 + timedelta == date1 after." msgstr "" -#: library/datetime.rst:629 +#: library/datetime.rst:630 msgid "" "In other words, ``date1 < date2`` if and only if ``date1.toordinal() < date2." "toordinal()``. Date comparison raises :exc:`TypeError` if the other " @@ -945,74 +947,74 @@ msgid "" "`True`, respectively." msgstr "" -#: library/datetime.rst:639 +#: library/datetime.rst:640 msgid "" "In Boolean contexts, all :class:`date` objects are considered to be true." msgstr "" -#: library/datetime.rst:645 +#: library/datetime.rst:646 msgid "" "Return a date with the same value, except for those parameters given new " "values by whichever keyword arguments are specified." msgstr "" -#: library/datetime.rst:1863 +#: library/datetime.rst:1864 msgid "Example::" msgstr "" -#: library/datetime.rst:1333 +#: library/datetime.rst:1334 msgid "" "Return a :class:`time.struct_time` such as returned by :func:`time." "localtime`." msgstr "" -#: library/datetime.rst:660 +#: library/datetime.rst:661 msgid "The hours, minutes and seconds are 0, and the DST flag is -1." msgstr "" -#: library/datetime.rst:1335 +#: library/datetime.rst:1336 msgid "``d.timetuple()`` is equivalent to::" msgstr "" -#: library/datetime.rst:666 +#: library/datetime.rst:667 msgid "" "where ``yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1`` is the " "day number within the current year starting with ``1`` for January 1st." msgstr "" -#: library/datetime.rst:672 +#: library/datetime.rst:673 msgid "" "Return the proleptic Gregorian ordinal of the date, where January 1 of year " "1 has ordinal 1. For any :class:`date` object *d*, ``date.fromordinal(d." "toordinal()) == d``." msgstr "" -#: library/datetime.rst:679 +#: library/datetime.rst:680 msgid "" "Return the day of the week as an integer, where Monday is 0 and Sunday is 6. " "For example, ``date(2002, 12, 4).weekday() == 2``, a Wednesday. See also :" "meth:`isoweekday`." msgstr "" -#: library/datetime.rst:686 +#: library/datetime.rst:687 msgid "" "Return the day of the week as an integer, where Monday is 1 and Sunday is 7. " "For example, ``date(2002, 12, 4).isoweekday() == 3``, a Wednesday. See also :" "meth:`weekday`, :meth:`isocalendar`." msgstr "" -#: library/datetime.rst:693 +#: library/datetime.rst:694 msgid "" "Return a :term:`named tuple` object with three components: ``year``, " "``week`` and ``weekday``." msgstr "" -#: library/datetime.rst:696 +#: library/datetime.rst:697 msgid "" "The ISO calendar is a widely used variant of the Gregorian calendar. [#]_" msgstr "" -#: library/datetime.rst:698 +#: library/datetime.rst:699 msgid "" "The ISO year consists of 52 or 53 full weeks, and where a week starts on a " "Monday and ends on a Sunday. The first week of an ISO year is the first " @@ -1021,41 +1023,41 @@ msgid "" "Gregorian year." msgstr "" -#: library/datetime.rst:703 +#: library/datetime.rst:704 msgid "" "For example, 2004 begins on a Thursday, so the first week of ISO year 2004 " "begins on Monday, 29 Dec 2003 and ends on Sunday, 4 Jan 2004::" msgstr "" -#: library/datetime.rst:712 +#: library/datetime.rst:713 msgid "Result changed from a tuple to a :term:`named tuple`." msgstr "" -#: library/datetime.rst:717 +#: library/datetime.rst:718 msgid "" "Return a string representing the date in ISO 8601 format, ``YYYY-MM-DD``::" msgstr "" -#: library/datetime.rst:725 +#: library/datetime.rst:726 msgid "For a date *d*, ``str(d)`` is equivalent to ``d.isoformat()``." msgstr "" -#: library/datetime.rst:730 +#: library/datetime.rst:731 msgid "Return a string representing the date::" msgstr "" -#: library/datetime.rst:1519 +#: library/datetime.rst:1520 msgid "``d.ctime()`` is equivalent to::" msgstr "" -#: library/datetime.rst:740 +#: library/datetime.rst:741 msgid "" "on platforms where the native C :c:func:`ctime` function (which :func:`time." "ctime` invokes, but which :meth:`date.ctime` does not invoke) conforms to " "the C standard." msgstr "" -#: library/datetime.rst:747 +#: library/datetime.rst:748 msgid "" "Return a string representing the date, controlled by an explicit format " "string. Format codes referring to hours, minutes or seconds will see 0 " @@ -1063,7 +1065,7 @@ msgid "" "isoformat`." msgstr "" -#: library/datetime.rst:754 +#: library/datetime.rst:755 msgid "" "Same as :meth:`.date.strftime`. This makes it possible to specify a format " "string for a :class:`.date` object in :ref:`formatted string literals 0, or backward if ``timedelta.days`` < 0. " @@ -1476,7 +1478,7 @@ msgid "" "the input is an aware object." msgstr "" -#: library/datetime.rst:1171 +#: library/datetime.rst:1172 msgid "" "Computes the datetime2 such that datetime2 + timedelta == datetime1. As for " "addition, the result has the same :attr:`~.datetime.tzinfo` attribute as the " @@ -1484,14 +1486,14 @@ msgid "" "aware." msgstr "" -#: library/datetime.rst:1176 +#: library/datetime.rst:1177 msgid "" "Subtraction of a :class:`.datetime` from a :class:`.datetime` is defined " "only if both operands are naive, or if both are aware. If one is aware and " "the other is naive, :exc:`TypeError` is raised." msgstr "" -#: library/datetime.rst:1180 +#: library/datetime.rst:1181 msgid "" "If both are naive, or both are aware and have the same :attr:`~.datetime." "tzinfo` attribute, the :attr:`~.datetime.tzinfo` attributes are ignored, and " @@ -1499,7 +1501,7 @@ msgid "" "datetime1``. No time zone adjustments are done in this case." msgstr "" -#: library/datetime.rst:1185 +#: library/datetime.rst:1186 msgid "" "If both are aware and have different :attr:`~.datetime.tzinfo` attributes, " "``a-b`` acts as if *a* and *b* were first converted to naive UTC datetimes " @@ -1508,20 +1510,20 @@ msgid "" "overflows." msgstr "" -#: library/datetime.rst:1191 +#: library/datetime.rst:1192 msgid "" "*datetime1* is considered less than *datetime2* when *datetime1* precedes " "*datetime2* in time." msgstr "" -#: library/datetime.rst:1194 +#: library/datetime.rst:1195 msgid "" "If one comparand is naive and the other is aware, :exc:`TypeError` is raised " "if an order comparison is attempted. For equality comparisons, naive " "instances are never equal to aware instances." msgstr "" -#: library/datetime.rst:1198 +#: library/datetime.rst:1199 msgid "" "If both comparands are aware, and have the same :attr:`~.datetime.tzinfo` " "attribute, the common :attr:`~.datetime.tzinfo` attribute is ignored and the " @@ -1531,13 +1533,13 @@ msgid "" "utcoffset()``)." msgstr "" -#: library/datetime.rst:1204 +#: library/datetime.rst:1205 msgid "" "Equality comparisons between aware and naive :class:`.datetime` instances " "don't raise :exc:`TypeError`." msgstr "" -#: library/datetime.rst:1210 +#: library/datetime.rst:1211 msgid "" "In order to stop comparison from falling back to the default scheme of " "comparing object addresses, datetime comparison normally raises :exc:" @@ -1550,27 +1552,27 @@ msgid "" "cases return :const:`False` or :const:`True`, respectively." msgstr "" -#: library/datetime.rst:1224 +#: library/datetime.rst:1225 msgid "Return :class:`date` object with same year, month and day." msgstr "" -#: library/datetime.rst:1229 +#: library/datetime.rst:1230 msgid "" "Return :class:`.time` object with same hour, minute, second, microsecond and " "fold. :attr:`.tzinfo` is ``None``. See also method :meth:`timetz`." msgstr "" -#: library/datetime.rst:1241 +#: library/datetime.rst:1242 msgid "The fold value is copied to the returned :class:`.time` object." msgstr "" -#: library/datetime.rst:1238 +#: library/datetime.rst:1239 msgid "" "Return :class:`.time` object with same hour, minute, second, microsecond, " "fold, and tzinfo attributes. See also method :meth:`time`." msgstr "" -#: library/datetime.rst:1249 +#: library/datetime.rst:1250 msgid "" "Return a datetime with the same attributes, except for those attributes " "given new values by whichever keyword arguments are specified. Note that " @@ -1578,21 +1580,21 @@ msgid "" "datetime with no conversion of date and time data." msgstr "" -#: library/datetime.rst:1260 +#: library/datetime.rst:1261 msgid "" "Return a :class:`.datetime` object with new :attr:`.tzinfo` attribute *tz*, " "adjusting the date and time data so the result is the same UTC time as " "*self*, but in *tz*'s local time." msgstr "" -#: library/datetime.rst:1264 +#: library/datetime.rst:1265 msgid "" "If provided, *tz* must be an instance of a :class:`tzinfo` subclass, and " "its :meth:`utcoffset` and :meth:`dst` methods must not return ``None``. If " "*self* is naive, it is presumed to represent time in the system timezone." msgstr "" -#: library/datetime.rst:1268 +#: library/datetime.rst:1269 msgid "" "If called without arguments (or with ``tz=None``) the system local timezone " "is assumed for the target timezone. The ``.tzinfo`` attribute of the " @@ -1600,7 +1602,7 @@ msgid "" "with the zone name and offset obtained from the OS." msgstr "" -#: library/datetime.rst:1273 +#: library/datetime.rst:1274 msgid "" "If ``self.tzinfo`` is *tz*, ``self.astimezone(tz)`` is equal to *self*: no " "adjustment of date or time data is performed. Else the result is local time " @@ -1609,7 +1611,7 @@ msgid "" "date and time data as ``dt - dt.utcoffset()``." msgstr "" -#: library/datetime.rst:1279 +#: library/datetime.rst:1280 msgid "" "If you merely want to attach a time zone object *tz* to a datetime *dt* " "without adjustment of date and time data, use ``dt.replace(tzinfo=tz)``. If " @@ -1617,54 +1619,54 @@ msgid "" "without conversion of date and time data, use ``dt.replace(tzinfo=None)``." msgstr "" -#: library/datetime.rst:1284 +#: library/datetime.rst:1285 msgid "" "Note that the default :meth:`tzinfo.fromutc` method can be overridden in a :" "class:`tzinfo` subclass to affect the result returned by :meth:`astimezone`. " "Ignoring error cases, :meth:`astimezone` acts like::" msgstr "" -#: library/datetime.rst:1296 +#: library/datetime.rst:1297 msgid "*tz* now can be omitted." msgstr "" -#: library/datetime.rst:1299 +#: library/datetime.rst:1300 msgid "" "The :meth:`astimezone` method can now be called on naive instances that are " "presumed to represent system local time." msgstr "" -#: library/datetime.rst:1306 +#: library/datetime.rst:1307 msgid "" "If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "utcoffset(self)``, and raises an exception if the latter doesn't return " "``None`` or a :class:`timedelta` object with magnitude less than one day." msgstr "" -#: library/datetime.rst:1903 library/datetime.rst:2254 -#: library/datetime.rst:2578 +#: library/datetime.rst:1904 library/datetime.rst:2255 +#: library/datetime.rst:2579 msgid "The UTC offset is not restricted to a whole number of minutes." msgstr "" -#: library/datetime.rst:1316 +#: library/datetime.rst:1317 msgid "" "If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "dst(self)``, and raises an exception if the latter doesn't return ``None`` " "or a :class:`timedelta` object with magnitude less than one day." msgstr "" -#: library/datetime.rst:1913 library/datetime.rst:2063 +#: library/datetime.rst:1914 library/datetime.rst:2064 msgid "The DST offset is not restricted to a whole number of minutes." msgstr "" -#: library/datetime.rst:1326 +#: library/datetime.rst:1327 msgid "" "If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "tzname(self)``, raises an exception if the latter doesn't return ``None`` or " "a string object," msgstr "" -#: library/datetime.rst:1341 +#: library/datetime.rst:1342 msgid "" "where ``yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1`` is the " "day number within the current year starting with ``1`` for January 1st. The :" @@ -1674,14 +1676,14 @@ msgid "" "attr:`tm_isdst` is set to ``1``; else :attr:`tm_isdst` is set to ``0``." msgstr "" -#: library/datetime.rst:1352 +#: library/datetime.rst:1353 msgid "" "If :class:`.datetime` instance *d* is naive, this is the same as ``d." "timetuple()`` except that :attr:`tm_isdst` is forced to 0 regardless of what " "``d.dst()`` returns. DST is never in effect for a UTC time." msgstr "" -#: library/datetime.rst:1356 +#: library/datetime.rst:1357 msgid "" "If *d* is aware, *d* is normalized to UTC time, by subtracting ``d." "utcoffset()``, and a :class:`time.struct_time` for the normalized time is " @@ -1690,7 +1692,7 @@ msgid "" "spills over a year boundary." msgstr "" -#: library/datetime.rst:1365 +#: library/datetime.rst:1366 msgid "" "Because naive ``datetime`` objects are treated by many ``datetime`` methods " "as local times, it is preferred to use aware datetimes to represent times in " @@ -1700,20 +1702,20 @@ msgid "" "meth:`.datetime.timetuple`." msgstr "" -#: library/datetime.rst:1374 +#: library/datetime.rst:1375 msgid "" "Return the proleptic Gregorian ordinal of the date. The same as ``self." "date().toordinal()``." msgstr "" -#: library/datetime.rst:1379 +#: library/datetime.rst:1380 msgid "" "Return POSIX timestamp corresponding to the :class:`.datetime` instance. The " "return value is a :class:`float` similar to that returned by :func:`time." "time`." msgstr "" -#: library/datetime.rst:1383 +#: library/datetime.rst:1384 msgid "" "Naive :class:`.datetime` instances are assumed to represent local time and " "this method relies on the platform C :c:func:`mktime` function to perform " @@ -1723,18 +1725,18 @@ msgid "" "future." msgstr "" -#: library/datetime.rst:1390 +#: library/datetime.rst:1391 msgid "" "For aware :class:`.datetime` instances, the return value is computed as::" msgstr "" -#: library/datetime.rst:1397 +#: library/datetime.rst:1398 msgid "" "The :meth:`timestamp` method uses the :attr:`.fold` attribute to " "disambiguate the times during a repeated interval." msgstr "" -#: library/datetime.rst:1403 +#: library/datetime.rst:1404 msgid "" "There is no method to obtain the POSIX timestamp directly from a naive :" "class:`.datetime` instance representing UTC time. If your application uses " @@ -1742,145 +1744,145 @@ msgid "" "the POSIX timestamp by supplying ``tzinfo=timezone.utc``::" msgstr "" -#: library/datetime.rst:1411 +#: library/datetime.rst:1412 msgid "or by calculating the timestamp directly::" msgstr "" -#: library/datetime.rst:1417 +#: library/datetime.rst:1418 msgid "" "Return the day of the week as an integer, where Monday is 0 and Sunday is 6. " "The same as ``self.date().weekday()``. See also :meth:`isoweekday`." msgstr "" -#: library/datetime.rst:1423 +#: library/datetime.rst:1424 msgid "" "Return the day of the week as an integer, where Monday is 1 and Sunday is 7. " "The same as ``self.date().isoweekday()``. See also :meth:`weekday`, :meth:" "`isocalendar`." msgstr "" -#: library/datetime.rst:1430 +#: library/datetime.rst:1431 msgid "" "Return a :term:`named tuple` with three components: ``year``, ``week`` and " "``weekday``. The same as ``self.date().isocalendar()``." msgstr "" -#: library/datetime.rst:1436 +#: library/datetime.rst:1437 msgid "Return a string representing the date and time in ISO 8601 format:" msgstr "" -#: library/datetime.rst:1438 +#: library/datetime.rst:1439 msgid "``YYYY-MM-DDTHH:MM:SS.ffffff``, if :attr:`microsecond` is not 0" msgstr "" -#: library/datetime.rst:1439 +#: library/datetime.rst:1440 msgid "``YYYY-MM-DDTHH:MM:SS``, if :attr:`microsecond` is 0" msgstr "" -#: library/datetime.rst:1441 +#: library/datetime.rst:1442 msgid "" "If :meth:`utcoffset` does not return ``None``, a string is appended, giving " "the UTC offset:" msgstr "" -#: library/datetime.rst:1444 +#: library/datetime.rst:1445 msgid "" "``YYYY-MM-DDTHH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]``, if :attr:`microsecond` " "is not 0" msgstr "" -#: library/datetime.rst:1446 +#: library/datetime.rst:1447 msgid "" "``YYYY-MM-DDTHH:MM:SS+HH:MM[:SS[.ffffff]]``, if :attr:`microsecond` is 0" msgstr "" -#: library/datetime.rst:1456 +#: library/datetime.rst:1457 msgid "" "The optional argument *sep* (default ``'T'``) is a one-character separator, " "placed between the date and time portions of the result. For example::" msgstr "" -#: library/datetime.rst:1843 +#: library/datetime.rst:1844 msgid "" "The optional argument *timespec* specifies the number of additional " "components of the time to include (the default is ``'auto'``). It can be one " "of the following:" msgstr "" -#: library/datetime.rst:1847 +#: library/datetime.rst:1848 msgid "" "``'auto'``: Same as ``'seconds'`` if :attr:`microsecond` is 0, same as " "``'microseconds'`` otherwise." msgstr "" -#: library/datetime.rst:1849 +#: library/datetime.rst:1850 msgid "``'hours'``: Include the :attr:`hour` in the two-digit ``HH`` format." msgstr "" -#: library/datetime.rst:1850 +#: library/datetime.rst:1851 msgid "" "``'minutes'``: Include :attr:`hour` and :attr:`minute` in ``HH:MM`` format." msgstr "" -#: library/datetime.rst:1851 +#: library/datetime.rst:1852 msgid "" "``'seconds'``: Include :attr:`hour`, :attr:`minute`, and :attr:`second` in " "``HH:MM:SS`` format." msgstr "" -#: library/datetime.rst:1853 +#: library/datetime.rst:1854 msgid "" "``'milliseconds'``: Include full time, but truncate fractional second part " "to milliseconds. ``HH:MM:SS.sss`` format." msgstr "" -#: library/datetime.rst:1855 +#: library/datetime.rst:1856 msgid "``'microseconds'``: Include full time in ``HH:MM:SS.ffffff`` format." msgstr "" -#: library/datetime.rst:1859 +#: library/datetime.rst:1860 msgid "Excluded time components are truncated, not rounded." msgstr "" -#: library/datetime.rst:1488 +#: library/datetime.rst:1489 msgid ":exc:`ValueError` will be raised on an invalid *timespec* argument::" msgstr "" -#: library/datetime.rst:1874 +#: library/datetime.rst:1875 msgid "Added the *timespec* argument." msgstr "" -#: library/datetime.rst:1504 +#: library/datetime.rst:1505 msgid "" "For a :class:`.datetime` instance *d*, ``str(d)`` is equivalent to ``d." "isoformat(' ')``." msgstr "" -#: library/datetime.rst:1510 +#: library/datetime.rst:1511 msgid "Return a string representing the date and time::" msgstr "" -#: library/datetime.rst:1516 +#: library/datetime.rst:1517 msgid "" "The output string will *not* include time zone information, regardless of " "whether the input is aware or naive." msgstr "" -#: library/datetime.rst:1523 +#: library/datetime.rst:1524 msgid "" "on platforms where the native C :c:func:`ctime` function (which :func:`time." "ctime` invokes, but which :meth:`datetime.ctime` does not invoke) conforms " "to the C standard." msgstr "" -#: library/datetime.rst:1530 +#: library/datetime.rst:1531 msgid "" "Return a string representing the date and time, controlled by an explicit " "format string. See also :ref:`strftime-strptime-behavior` and :meth:" "`datetime.isoformat`." msgstr "" -#: library/datetime.rst:1537 +#: library/datetime.rst:1538 msgid "" "Same as :meth:`.datetime.strftime`. This makes it possible to specify a " "format string for a :class:`.datetime` object in :ref:`formatted string " @@ -1888,70 +1890,70 @@ msgid "" "`strftime-strptime-behavior` and :meth:`datetime.isoformat`." msgstr "" -#: library/datetime.rst:1544 +#: library/datetime.rst:1545 msgid "Examples of Usage: :class:`.datetime`" msgstr "" -#: library/datetime.rst:1546 +#: library/datetime.rst:1547 msgid "Examples of working with :class:`~datetime.datetime` objects:" msgstr "" -#: library/datetime.rst:1599 +#: library/datetime.rst:1600 msgid "" "The example below defines a :class:`tzinfo` subclass capturing time zone " "information for Kabul, Afghanistan, which used +4 UTC until 1945 and then " "+4:30 UTC thereafter::" msgstr "" -#: library/datetime.rst:1646 +#: library/datetime.rst:1647 msgid "Usage of ``KabulTz`` from above::" msgstr "" -#: library/datetime.rst:1672 +#: library/datetime.rst:1673 msgid ":class:`.time` Objects" msgstr "" -#: library/datetime.rst:1674 +#: library/datetime.rst:1675 msgid "" "A :class:`time` object represents a (local) time of day, independent of any " "particular day, and subject to adjustment via a :class:`tzinfo` object." msgstr "" -#: library/datetime.rst:1679 +#: library/datetime.rst:1680 msgid "" "All arguments are optional. *tzinfo* may be ``None``, or an instance of a :" "class:`tzinfo` subclass. The remaining arguments must be integers in the " "following ranges:" msgstr "" -#: library/datetime.rst:1689 +#: library/datetime.rst:1690 msgid "" "If an argument outside those ranges is given, :exc:`ValueError` is raised. " "All default to ``0`` except *tzinfo*, which defaults to :const:`None`." msgstr "" -#: library/datetime.rst:1697 +#: library/datetime.rst:1698 msgid "The earliest representable :class:`.time`, ``time(0, 0, 0, 0)``." msgstr "" -#: library/datetime.rst:1702 +#: library/datetime.rst:1703 msgid "The latest representable :class:`.time`, ``time(23, 59, 59, 999999)``." msgstr "" -#: library/datetime.rst:1707 +#: library/datetime.rst:1708 msgid "" "The smallest possible difference between non-equal :class:`.time` objects, " "``timedelta(microseconds=1)``, although note that arithmetic on :class:`." "time` objects is not supported." msgstr "" -#: library/datetime.rst:1736 +#: library/datetime.rst:1737 msgid "" "The object passed as the tzinfo argument to the :class:`.time` constructor, " "or ``None`` if none was passed." msgstr "" -#: library/datetime.rst:1750 +#: library/datetime.rst:1751 msgid "" ":class:`.time` objects support comparison of :class:`.time` to :class:`." "time`, where *a* is considered less than *b* when *a* precedes *b* in time. " @@ -1960,7 +1962,7 @@ msgid "" "instances are never equal to aware instances." msgstr "" -#: library/datetime.rst:1756 +#: library/datetime.rst:1757 msgid "" "If both comparands are aware, and have the same :attr:`~time.tzinfo` " "attribute, the common :attr:`~time.tzinfo` attribute is ignored and the base " @@ -1974,18 +1976,18 @@ msgid "" "respectively." msgstr "" -#: library/datetime.rst:1766 +#: library/datetime.rst:1767 msgid "" "Equality comparisons between aware and naive :class:`~datetime.time` " "instances don't raise :exc:`TypeError`." msgstr "" -#: library/datetime.rst:1770 +#: library/datetime.rst:1771 msgid "" "In Boolean contexts, a :class:`.time` object is always considered to be true." msgstr "" -#: library/datetime.rst:1772 +#: library/datetime.rst:1773 msgid "" "Before Python 3.5, a :class:`.time` object was considered to be false if it " "represented midnight in UTC. This behavior was considered obscure and error-" @@ -1993,35 +1995,35 @@ msgid "" "details." msgstr "" -#: library/datetime.rst:1779 +#: library/datetime.rst:1780 msgid "Other constructor:" msgstr "" -#: library/datetime.rst:1783 +#: library/datetime.rst:1784 msgid "" "Return a :class:`.time` corresponding to a *time_string* in any valid ISO " "8601 format, with the following exceptions:" msgstr "" -#: library/datetime.rst:1787 +#: library/datetime.rst:1788 msgid "" "The leading ``T``, normally required in cases where there may be ambiguity " "between a date and a time, is not required." msgstr "" -#: library/datetime.rst:1789 +#: library/datetime.rst:1790 msgid "" "Fractional seconds may have any number of digits (anything beyond 6 will be " "truncated)." msgstr "" -#: library/datetime.rst:1815 +#: library/datetime.rst:1816 msgid "" "Previously, this method only supported formats that could be emitted by :" "meth:`time.isoformat()`." msgstr "" -#: library/datetime.rst:1825 +#: library/datetime.rst:1826 msgid "" "Return a :class:`.time` with the same value, except for those attributes " "given new values by whichever keyword arguments are specified. Note that " @@ -2029,46 +2031,46 @@ msgid "" "aware :class:`.time`, without conversion of the time data." msgstr "" -#: library/datetime.rst:1836 +#: library/datetime.rst:1837 msgid "Return a string representing the time in ISO 8601 format, one of:" msgstr "" -#: library/datetime.rst:1838 +#: library/datetime.rst:1839 msgid "``HH:MM:SS.ffffff``, if :attr:`microsecond` is not 0" msgstr "" -#: library/datetime.rst:1839 +#: library/datetime.rst:1840 msgid "``HH:MM:SS``, if :attr:`microsecond` is 0" msgstr "" -#: library/datetime.rst:1840 +#: library/datetime.rst:1841 msgid "" "``HH:MM:SS.ffffff+HH:MM[:SS[.ffffff]]``, if :meth:`utcoffset` does not " "return ``None``" msgstr "" -#: library/datetime.rst:1841 +#: library/datetime.rst:1842 msgid "" "``HH:MM:SS+HH:MM[:SS[.ffffff]]``, if :attr:`microsecond` is 0 and :meth:" "`utcoffset` does not return ``None``" msgstr "" -#: library/datetime.rst:1861 +#: library/datetime.rst:1862 msgid ":exc:`ValueError` will be raised on an invalid *timespec* argument." msgstr "" -#: library/datetime.rst:1880 +#: library/datetime.rst:1881 msgid "For a time *t*, ``str(t)`` is equivalent to ``t.isoformat()``." msgstr "" -#: library/datetime.rst:1885 +#: library/datetime.rst:1886 msgid "" "Return a string representing the time, controlled by an explicit format " "string. See also :ref:`strftime-strptime-behavior` and :meth:`time." "isoformat`." msgstr "" -#: library/datetime.rst:1891 +#: library/datetime.rst:1892 msgid "" "Same as :meth:`.time.strftime`. This makes it possible to specify a format " "string for a :class:`.time` object in :ref:`formatted string literals ` file there are some examples of :class:`tzinfo` classes:" msgstr "" -#: library/datetime.rst:2146 +#: library/datetime.rst:2147 msgid "" "Note that there are unavoidable subtleties twice per year in a :class:" "`tzinfo` subclass accounting for both standard and daylight time, at the DST " @@ -2335,7 +2337,7 @@ msgid "" "ends the minute after 1:59 (EDT) on the first Sunday in November::" msgstr "" -#: library/datetime.rst:2160 +#: library/datetime.rst:2161 msgid "" "When DST starts (the \"start\" line), the local wall clock leaps from 1:59 " "to 3:00. A wall time of the form 2:MM doesn't really make sense on that day, " @@ -2344,7 +2346,7 @@ msgid "" "get::" msgstr "" -#: library/datetime.rst:2179 +#: library/datetime.rst:2180 msgid "" "When DST ends (the \"end\" line), there's a potentially worse problem: " "there's an hour that can't be spelled unambiguously in local wall time: the " @@ -2359,13 +2361,13 @@ msgid "" "transition of 2016, we get::" msgstr "" -#: library/datetime.rst:2201 +#: library/datetime.rst:2202 msgid "" "Note that the :class:`.datetime` instances that differ only by the value of " "the :attr:`~datetime.fold` attribute are considered equal in comparisons." msgstr "" -#: library/datetime.rst:2204 +#: library/datetime.rst:2205 msgid "" "Applications that can't bear wall-time ambiguities should explicitly check " "the value of the :attr:`~datetime.fold` attribute or avoid using hybrid :" @@ -2375,28 +2377,28 @@ msgid "" "offset -4 hours))." msgstr "" -#: library/datetime.rst:2218 +#: library/datetime.rst:2219 msgid ":mod:`zoneinfo`" msgstr "" -#: library/datetime.rst:2213 +#: library/datetime.rst:2214 msgid "" "The :mod:`datetime` module has a basic :class:`timezone` class (for handling " "arbitrary fixed offsets from UTC) and its :attr:`timezone.utc` attribute (a " "UTC timezone instance)." msgstr "" -#: library/datetime.rst:2217 +#: library/datetime.rst:2218 msgid "" "``zoneinfo`` brings the *IANA timezone database* (also known as the Olson " "database) to Python, and its usage is recommended." msgstr "" -#: library/datetime.rst:2224 +#: library/datetime.rst:2225 msgid "`IANA timezone database `_" msgstr "" -#: library/datetime.rst:2221 +#: library/datetime.rst:2222 msgid "" "The Time Zone Database (often called tz, tzdata or zoneinfo) contains code " "and data that represent the history of local time for many representative " @@ -2405,24 +2407,24 @@ msgid "" "saving rules." msgstr "" -#: library/datetime.rst:2231 +#: library/datetime.rst:2232 msgid ":class:`timezone` Objects" msgstr "" -#: library/datetime.rst:2233 +#: library/datetime.rst:2234 msgid "" "The :class:`timezone` class is a subclass of :class:`tzinfo`, each instance " "of which represents a timezone defined by a fixed offset from UTC." msgstr "" -#: library/datetime.rst:2237 +#: library/datetime.rst:2238 msgid "" "Objects of this class cannot be used to represent timezone information in " "the locations where different offsets are used in different days of the year " "or where historical changes have been made to civil time." msgstr "" -#: library/datetime.rst:2244 +#: library/datetime.rst:2245 msgid "" "The *offset* argument must be specified as a :class:`timedelta` object " "representing the difference between the local time and UTC. It must be " @@ -2430,25 +2432,25 @@ msgid "" "otherwise :exc:`ValueError` is raised." msgstr "" -#: library/datetime.rst:2249 +#: library/datetime.rst:2250 msgid "" "The *name* argument is optional. If specified it must be a string that will " "be used as the value returned by the :meth:`datetime.tzname` method." msgstr "" -#: library/datetime.rst:2271 +#: library/datetime.rst:2272 msgid "" "Return the fixed value specified when the :class:`timezone` instance is " "constructed." msgstr "" -#: library/datetime.rst:2263 +#: library/datetime.rst:2264 msgid "" "The *dt* argument is ignored. The return value is a :class:`timedelta` " "instance equal to the difference between the local time and UTC." msgstr "" -#: library/datetime.rst:2274 +#: library/datetime.rst:2275 msgid "" "If *name* is not provided in the constructor, the name returned by " "``tzname(dt)`` is generated from the value of the ``offset`` as follows. If " @@ -2457,144 +2459,144 @@ msgid "" "are two digits of ``offset.hours`` and ``offset.minutes`` respectively." msgstr "" -#: library/datetime.rst:2280 +#: library/datetime.rst:2281 msgid "" "Name generated from ``offset=timedelta(0)`` is now plain ``'UTC'``, not " "``'UTC+00:00'``." msgstr "" -#: library/datetime.rst:2287 +#: library/datetime.rst:2288 msgid "Always returns ``None``." msgstr "" -#: library/datetime.rst:2291 +#: library/datetime.rst:2292 msgid "" "Return ``dt + offset``. The *dt* argument must be an aware :class:`." "datetime` instance, with ``tzinfo`` set to ``self``." msgstr "" -#: library/datetime.rst:2298 +#: library/datetime.rst:2299 msgid "The UTC timezone, ``timezone(timedelta(0))``." msgstr "" -#: library/datetime.rst:2307 +#: library/datetime.rst:2308 msgid ":meth:`strftime` and :meth:`strptime` Behavior" msgstr "" -#: library/datetime.rst:2309 +#: library/datetime.rst:2310 msgid "" ":class:`date`, :class:`.datetime`, and :class:`.time` objects all support a " "``strftime(format)`` method, to create a string representing the time under " "the control of an explicit format string." msgstr "" -#: library/datetime.rst:2313 +#: library/datetime.rst:2314 msgid "" "Conversely, the :meth:`datetime.strptime` class method creates a :class:`." "datetime` object from a string representing a date and time and a " "corresponding format string." msgstr "" -#: library/datetime.rst:2317 +#: library/datetime.rst:2318 msgid "" "The table below provides a high-level comparison of :meth:`strftime` versus :" "meth:`strptime`:" msgstr "" -#: library/datetime.rst:2321 +#: library/datetime.rst:2322 msgid "``strftime``" msgstr "" -#: library/datetime.rst:2321 +#: library/datetime.rst:2322 msgid "``strptime``" msgstr "" -#: library/datetime.rst:2323 +#: library/datetime.rst:2324 msgid "Usage" msgstr "" -#: library/datetime.rst:2323 +#: library/datetime.rst:2324 msgid "Convert object to a string according to a given format" msgstr "" -#: library/datetime.rst:2323 +#: library/datetime.rst:2324 msgid "" "Parse a string into a :class:`.datetime` object given a corresponding format" msgstr "" -#: library/datetime.rst:2325 +#: library/datetime.rst:2326 msgid "Type of method" msgstr "" -#: library/datetime.rst:2325 +#: library/datetime.rst:2326 msgid "Instance method" msgstr "" -#: library/datetime.rst:2325 +#: library/datetime.rst:2326 msgid "Class method" msgstr "" -#: library/datetime.rst:2327 +#: library/datetime.rst:2328 msgid "Method of" msgstr "" -#: library/datetime.rst:2327 +#: library/datetime.rst:2328 msgid ":class:`date`; :class:`.datetime`; :class:`.time`" msgstr "" -#: library/datetime.rst:2327 +#: library/datetime.rst:2328 msgid ":class:`.datetime`" msgstr "" -#: library/datetime.rst:2329 +#: library/datetime.rst:2330 msgid "Signature" msgstr "" -#: library/datetime.rst:2329 +#: library/datetime.rst:2330 msgid "``strftime(format)``" msgstr "" -#: library/datetime.rst:2329 +#: library/datetime.rst:2330 msgid "``strptime(date_string, format)``" msgstr "" -#: library/datetime.rst:2336 +#: library/datetime.rst:2337 msgid ":meth:`strftime` and :meth:`strptime` Format Codes" msgstr "" -#: library/datetime.rst:2338 +#: library/datetime.rst:2339 msgid "" "These methods accept format codes that can be used to parse and format " "dates::" msgstr "" -#: library/datetime.rst:2346 +#: library/datetime.rst:2347 msgid "" "The following is a list of all the format codes that the 1989 C standard " "requires, and these work on all platforms with a standard C implementation." msgstr "" -#: library/datetime.rst:2453 +#: library/datetime.rst:2454 msgid "Directive" msgstr "" -#: library/datetime.rst:2453 +#: library/datetime.rst:2454 msgid "Meaning" msgstr "" -#: library/datetime.rst:2453 +#: library/datetime.rst:2454 msgid "Example" msgstr "" -#: library/datetime.rst:2453 +#: library/datetime.rst:2454 msgid "Notes" msgstr "" -#: library/datetime.rst:2352 +#: library/datetime.rst:2353 msgid "``%a``" msgstr "" -#: library/datetime.rst:2352 +#: library/datetime.rst:2353 msgid "Weekday as locale's abbreviated name." msgstr "" @@ -2606,11 +2608,11 @@ msgstr "" msgid "So, Mo, ..., Sa (de_DE)" msgstr "" -#: library/datetime.rst:2357 +#: library/datetime.rst:2358 msgid "``%A``" msgstr "" -#: library/datetime.rst:2357 +#: library/datetime.rst:2358 msgid "Weekday as locale's full name." msgstr "" @@ -2622,40 +2624,40 @@ msgstr "" msgid "Sonntag, Montag, ..., Samstag (de_DE)" msgstr "" -#: library/datetime.rst:2362 +#: library/datetime.rst:2363 msgid "``%w``" msgstr "" -#: library/datetime.rst:2362 +#: library/datetime.rst:2363 msgid "Weekday as a decimal number, where 0 is Sunday and 6 is Saturday." msgstr "" -#: library/datetime.rst:2362 +#: library/datetime.rst:2363 msgid "0, 1, ..., 6" msgstr "" -#: library/datetime.rst:2366 +#: library/datetime.rst:2367 msgid "``%d``" msgstr "" -#: library/datetime.rst:2366 +#: library/datetime.rst:2367 msgid "Day of the month as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2366 +#: library/datetime.rst:2367 msgid "01, 02, ..., 31" msgstr "" -#: library/datetime.rst:2379 library/datetime.rst:2388 -#: library/datetime.rst:2397 library/datetime.rst:2415 +#: library/datetime.rst:2380 library/datetime.rst:2389 +#: library/datetime.rst:2398 library/datetime.rst:2416 msgid "\\(9)" msgstr "" -#: library/datetime.rst:2369 +#: library/datetime.rst:2370 msgid "``%b``" msgstr "" -#: library/datetime.rst:2369 +#: library/datetime.rst:2370 msgid "Month as locale's abbreviated name." msgstr "" @@ -2667,11 +2669,11 @@ msgstr "" msgid "Jan, Feb, ..., Dez (de_DE)" msgstr "" -#: library/datetime.rst:2374 +#: library/datetime.rst:2375 msgid "``%B``" msgstr "" -#: library/datetime.rst:2374 +#: library/datetime.rst:2375 msgid "Month as locale's full name." msgstr "" @@ -2683,67 +2685,67 @@ msgstr "" msgid "Januar, Februar, ..., Dezember (de_DE)" msgstr "" -#: library/datetime.rst:2379 +#: library/datetime.rst:2380 msgid "``%m``" msgstr "" -#: library/datetime.rst:2379 +#: library/datetime.rst:2380 msgid "Month as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2391 +#: library/datetime.rst:2392 msgid "01, 02, ..., 12" msgstr "" -#: library/datetime.rst:2382 +#: library/datetime.rst:2383 msgid "``%y``" msgstr "" -#: library/datetime.rst:2382 +#: library/datetime.rst:2383 msgid "Year without century as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2382 +#: library/datetime.rst:2383 msgid "00, 01, ..., 99" msgstr "" -#: library/datetime.rst:2385 +#: library/datetime.rst:2386 msgid "``%Y``" msgstr "" -#: library/datetime.rst:2385 +#: library/datetime.rst:2386 msgid "Year with century as a decimal number." msgstr "" -#: library/datetime.rst:2455 +#: library/datetime.rst:2456 msgid "0001, 0002, ..., 2013, 2014, ..., 9998, 9999" msgstr "" -#: library/datetime.rst:2388 +#: library/datetime.rst:2389 msgid "``%H``" msgstr "" -#: library/datetime.rst:2388 +#: library/datetime.rst:2389 msgid "Hour (24-hour clock) as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2388 +#: library/datetime.rst:2389 msgid "00, 01, ..., 23" msgstr "" -#: library/datetime.rst:2391 +#: library/datetime.rst:2392 msgid "``%I``" msgstr "" -#: library/datetime.rst:2391 +#: library/datetime.rst:2392 msgid "Hour (12-hour clock) as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2394 +#: library/datetime.rst:2395 msgid "``%p``" msgstr "" -#: library/datetime.rst:2394 +#: library/datetime.rst:2395 msgid "Locale's equivalent of either AM or PM." msgstr "" @@ -2755,127 +2757,127 @@ msgstr "" msgid "am, pm (de_DE)" msgstr "" -#: library/datetime.rst:2394 +#: library/datetime.rst:2395 msgid "\\(1), \\(3)" msgstr "" -#: library/datetime.rst:2397 +#: library/datetime.rst:2398 msgid "``%M``" msgstr "" -#: library/datetime.rst:2397 +#: library/datetime.rst:2398 msgid "Minute as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2400 +#: library/datetime.rst:2401 msgid "00, 01, ..., 59" msgstr "" -#: library/datetime.rst:2400 +#: library/datetime.rst:2401 msgid "``%S``" msgstr "" -#: library/datetime.rst:2400 +#: library/datetime.rst:2401 msgid "Second as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2400 +#: library/datetime.rst:2401 msgid "\\(4), \\(9)" msgstr "" -#: library/datetime.rst:2403 +#: library/datetime.rst:2404 msgid "``%f``" msgstr "" -#: library/datetime.rst:2403 +#: library/datetime.rst:2404 msgid "Microsecond as a decimal number, zero-padded to 6 digits." msgstr "" -#: library/datetime.rst:2403 +#: library/datetime.rst:2404 msgid "000000, 000001, ..., 999999" msgstr "" -#: library/datetime.rst:2403 +#: library/datetime.rst:2404 msgid "\\(5)" msgstr "" -#: library/datetime.rst:2576 +#: library/datetime.rst:2577 msgid "``%z``" msgstr "" -#: library/datetime.rst:2407 +#: library/datetime.rst:2408 msgid "" "UTC offset in the form ``±HHMM[SS[.ffffff]]`` (empty string if the object is " "naive)." msgstr "" -#: library/datetime.rst:2407 +#: library/datetime.rst:2408 msgid "(empty), +0000, -0400, +1030, +063415, -030712.345216" msgstr "" -#: library/datetime.rst:2412 library/datetime.rst:2469 +#: library/datetime.rst:2413 library/datetime.rst:2470 msgid "\\(6)" msgstr "" -#: library/datetime.rst:2604 +#: library/datetime.rst:2605 msgid "``%Z``" msgstr "" -#: library/datetime.rst:2412 +#: library/datetime.rst:2413 msgid "Time zone name (empty string if the object is naive)." msgstr "" -#: library/datetime.rst:2412 +#: library/datetime.rst:2413 msgid "(empty), UTC, GMT" msgstr "" -#: library/datetime.rst:2415 +#: library/datetime.rst:2416 msgid "``%j``" msgstr "" -#: library/datetime.rst:2415 +#: library/datetime.rst:2416 msgid "Day of the year as a zero-padded decimal number." msgstr "" -#: library/datetime.rst:2415 +#: library/datetime.rst:2416 msgid "001, 002, ..., 366" msgstr "" -#: library/datetime.rst:2418 +#: library/datetime.rst:2419 msgid "``%U``" msgstr "" -#: library/datetime.rst:2418 +#: library/datetime.rst:2419 msgid "" "Week number of the year (Sunday as the first day of the week) as a zero-" "padded decimal number. All days in a new year preceding the first Sunday are " "considered to be in week 0." msgstr "" -#: library/datetime.rst:2426 +#: library/datetime.rst:2427 msgid "00, 01, ..., 53" msgstr "" -#: library/datetime.rst:2426 +#: library/datetime.rst:2427 msgid "\\(7), \\(9)" msgstr "" -#: library/datetime.rst:2426 +#: library/datetime.rst:2427 msgid "``%W``" msgstr "" -#: library/datetime.rst:2426 +#: library/datetime.rst:2427 msgid "" "Week number of the year (Monday as the first day of the week) as a zero-" "padded decimal number. All days in a new year preceding the first Monday are " "considered to be in week 0." msgstr "" -#: library/datetime.rst:2434 +#: library/datetime.rst:2435 msgid "``%c``" msgstr "" -#: library/datetime.rst:2434 +#: library/datetime.rst:2435 msgid "Locale's appropriate date and time representation." msgstr "" @@ -2887,11 +2889,11 @@ msgstr "" msgid "Di 16 Aug 21:30:00 1988 (de_DE)" msgstr "" -#: library/datetime.rst:2439 +#: library/datetime.rst:2440 msgid "``%x``" msgstr "" -#: library/datetime.rst:2439 +#: library/datetime.rst:2440 msgid "Locale's appropriate date representation." msgstr "" @@ -2907,11 +2909,11 @@ msgstr "" msgid "16.08.1988 (de_DE)" msgstr "" -#: library/datetime.rst:2443 +#: library/datetime.rst:2444 msgid "``%X``" msgstr "" -#: library/datetime.rst:2443 +#: library/datetime.rst:2444 msgid "Locale's appropriate time representation." msgstr "" @@ -2923,83 +2925,83 @@ msgstr "" msgid "21:30:00 (de_DE)" msgstr "" -#: library/datetime.rst:2446 +#: library/datetime.rst:2447 msgid "``%%``" msgstr "" -#: library/datetime.rst:2446 +#: library/datetime.rst:2447 msgid "A literal ``'%'`` character." msgstr "" -#: library/datetime.rst:2446 +#: library/datetime.rst:2447 msgid "%" msgstr "" -#: library/datetime.rst:2449 +#: library/datetime.rst:2450 msgid "" "Several additional directives not required by the C89 standard are included " "for convenience. These parameters all correspond to ISO 8601 date values." msgstr "" -#: library/datetime.rst:2455 +#: library/datetime.rst:2456 msgid "``%G``" msgstr "" -#: library/datetime.rst:2455 +#: library/datetime.rst:2456 msgid "" "ISO 8601 year with century representing the year that contains the greater " "part of the ISO week (``%V``)." msgstr "" -#: library/datetime.rst:2455 +#: library/datetime.rst:2456 msgid "\\(8)" msgstr "" -#: library/datetime.rst:2460 +#: library/datetime.rst:2461 msgid "``%u``" msgstr "" -#: library/datetime.rst:2460 +#: library/datetime.rst:2461 msgid "ISO 8601 weekday as a decimal number where 1 is Monday." msgstr "" -#: library/datetime.rst:2460 +#: library/datetime.rst:2461 msgid "1, 2, ..., 7" msgstr "" -#: library/datetime.rst:2463 +#: library/datetime.rst:2464 msgid "``%V``" msgstr "" -#: library/datetime.rst:2463 +#: library/datetime.rst:2464 msgid "" "ISO 8601 week as a decimal number with Monday as the first day of the week. " "Week 01 is the week containing Jan 4." msgstr "" -#: library/datetime.rst:2463 +#: library/datetime.rst:2464 msgid "01, 02, ..., 53" msgstr "" -#: library/datetime.rst:2463 +#: library/datetime.rst:2464 msgid "\\(8), \\(9)" msgstr "" -#: library/datetime.rst:2590 +#: library/datetime.rst:2591 msgid "``%:z``" msgstr "" -#: library/datetime.rst:2469 +#: library/datetime.rst:2470 msgid "" "UTC offset in the form ``±HH:MM[:SS[.ffffff]]`` (empty string if the object " "is naive)." msgstr "" -#: library/datetime.rst:2469 +#: library/datetime.rst:2470 msgid "(empty), +00:00, -04:00, +10:30, +06:34:15, -03:07:12.345216" msgstr "" -#: library/datetime.rst:2475 +#: library/datetime.rst:2476 msgid "" "These may not be available on all platforms when used with the :meth:" "`strftime` method. The ISO 8601 year and ISO 8601 week directives are not " @@ -3008,7 +3010,7 @@ msgid "" "a :exc:`ValueError`." msgstr "" -#: library/datetime.rst:2480 +#: library/datetime.rst:2481 msgid "" "The full set of format codes supported varies across platforms, because " "Python calls the platform C library's :func:`strftime` function, and " @@ -3018,44 +3020,44 @@ msgid "" "unsupported format specifiers." msgstr "" -#: library/datetime.rst:2486 +#: library/datetime.rst:2487 msgid "``%G``, ``%u`` and ``%V`` were added." msgstr "" -#: library/datetime.rst:2489 +#: library/datetime.rst:2490 msgid "``%:z`` was added." msgstr "" -#: library/datetime.rst:2493 +#: library/datetime.rst:2494 msgid "Technical Detail" msgstr "" -#: library/datetime.rst:2495 +#: library/datetime.rst:2496 msgid "" "Broadly speaking, ``d.strftime(fmt)`` acts like the :mod:`time` module's " "``time.strftime(fmt, d.timetuple())`` although not all objects support a :" "meth:`timetuple` method." msgstr "" -#: library/datetime.rst:2499 +#: library/datetime.rst:2500 msgid "" "For the :meth:`datetime.strptime` class method, the default value is " "``1900-01-01T00:00:00.000``: any components not specified in the format " "string will be pulled from the default value. [#]_" msgstr "" -#: library/datetime.rst:2503 +#: library/datetime.rst:2504 msgid "Using ``datetime.strptime(date_string, format)`` is equivalent to::" msgstr "" -#: library/datetime.rst:2507 +#: library/datetime.rst:2508 msgid "" "except when the format includes sub-second components or timezone offset " "information, which are supported in ``datetime.strptime`` but are discarded " "by ``time.strptime``." msgstr "" -#: library/datetime.rst:2511 +#: library/datetime.rst:2512 msgid "" "For :class:`.time` objects, the format codes for year, month, and day should " "not be used, as :class:`time` objects have no such values. If they're used " @@ -3063,14 +3065,14 @@ msgid "" "day." msgstr "" -#: library/datetime.rst:2515 +#: library/datetime.rst:2516 msgid "" "For :class:`date` objects, the format codes for hours, minutes, seconds, and " "microseconds should not be used, as :class:`date` objects have no such " "values. If they're used anyway, ``0`` is substituted for them." msgstr "" -#: library/datetime.rst:2519 +#: library/datetime.rst:2520 msgid "" "For the same reason, handling of format strings containing Unicode code " "points that can't be represented in the charset of the current locale is " @@ -3079,7 +3081,7 @@ msgid "" "`UnicodeError` or return an empty string instead." msgstr "" -#: library/datetime.rst:2528 +#: library/datetime.rst:2529 msgid "" "Because the format depends on the current locale, care should be taken when " "making assumptions about the output value. Field orderings will vary (for " @@ -3087,37 +3089,37 @@ msgid "" "contain non-ASCII characters." msgstr "" -#: library/datetime.rst:2534 +#: library/datetime.rst:2535 msgid "" "The :meth:`strptime` method can parse years in the full [1, 9999] range, but " "years < 1000 must be zero-filled to 4-digit width." msgstr "" -#: library/datetime.rst:2537 +#: library/datetime.rst:2538 msgid "" "In previous versions, :meth:`strftime` method was restricted to years >= " "1900." msgstr "" -#: library/datetime.rst:2541 +#: library/datetime.rst:2542 msgid "" "In version 3.2, :meth:`strftime` method was restricted to years >= 1000." msgstr "" -#: library/datetime.rst:2546 +#: library/datetime.rst:2547 msgid "" "When used with the :meth:`strptime` method, the ``%p`` directive only " "affects the output hour field if the ``%I`` directive is used to parse the " "hour." msgstr "" -#: library/datetime.rst:2550 +#: library/datetime.rst:2551 msgid "" "Unlike the :mod:`time` module, the :mod:`datetime` module does not support " "leap seconds." msgstr "" -#: library/datetime.rst:2554 +#: library/datetime.rst:2555 msgid "" "When used with the :meth:`strptime` method, the ``%f`` directive accepts " "from one to six digits and zero pads on the right. ``%f`` is an extension to " @@ -3125,17 +3127,17 @@ msgid "" "in datetime objects, and therefore always available)." msgstr "" -#: library/datetime.rst:2561 +#: library/datetime.rst:2562 msgid "" "For a naive object, the ``%z``, ``%:z`` and ``%Z`` format codes are replaced " "by empty strings." msgstr "" -#: library/datetime.rst:2564 +#: library/datetime.rst:2565 msgid "For an aware object:" msgstr "" -#: library/datetime.rst:2567 +#: library/datetime.rst:2568 msgid "" ":meth:`utcoffset` is transformed into a string of the form ``±HHMM[SS[." "ffffff]]``, where ``HH`` is a 2-digit string giving the number of UTC offset " @@ -3149,7 +3151,7 @@ msgid "" "``'-0330'``." msgstr "" -#: library/datetime.rst:2581 +#: library/datetime.rst:2582 msgid "" "When the ``%z`` directive is provided to the :meth:`strptime` method, the " "UTC offsets can have a colon as a separator between hours, minutes and " @@ -3157,53 +3159,53 @@ msgid "" "hour. In addition, providing ``'Z'`` is identical to ``'+00:00'``." msgstr "" -#: library/datetime.rst:2589 +#: library/datetime.rst:2590 msgid "" "Behaves exactly as ``%z``, but has a colon separator added between hours, " "minutes and seconds." msgstr "" -#: library/datetime.rst:2593 +#: library/datetime.rst:2594 msgid "" "In :meth:`strftime`, ``%Z`` is replaced by an empty string if :meth:`tzname` " "returns ``None``; otherwise ``%Z`` is replaced by the returned value, which " "must be a string." msgstr "" -#: library/datetime.rst:2597 +#: library/datetime.rst:2598 msgid ":meth:`strptime` only accepts certain values for ``%Z``:" msgstr "" -#: library/datetime.rst:2599 +#: library/datetime.rst:2600 msgid "any value in ``time.tzname`` for your machine's locale" msgstr "" -#: library/datetime.rst:2600 +#: library/datetime.rst:2601 msgid "the hard-coded values ``UTC`` and ``GMT``" msgstr "" -#: library/datetime.rst:2602 +#: library/datetime.rst:2603 msgid "" "So someone living in Japan may have ``JST``, ``UTC``, and ``GMT`` as valid " "values, but probably not ``EST``. It will raise ``ValueError`` for invalid " "values." msgstr "" -#: library/datetime.rst:2606 +#: library/datetime.rst:2607 msgid "" "When the ``%z`` directive is provided to the :meth:`strptime` method, an " "aware :class:`.datetime` object will be produced. The ``tzinfo`` of the " "result will be set to a :class:`timezone` instance." msgstr "" -#: library/datetime.rst:2612 +#: library/datetime.rst:2613 msgid "" "When used with the :meth:`strptime` method, ``%U`` and ``%W`` are only used " "in calculations when the day of the week and the calendar year (``%Y``) are " "specified." msgstr "" -#: library/datetime.rst:2617 +#: library/datetime.rst:2618 msgid "" "Similar to ``%U`` and ``%W``, ``%V`` is only used in calculations when the " "day of the week and the ISO year (``%G``) are specified in a :meth:" @@ -3211,22 +3213,22 @@ msgid "" "interchangeable." msgstr "" -#: library/datetime.rst:2623 +#: library/datetime.rst:2624 msgid "" "When used with the :meth:`strptime` method, the leading zero is optional " "for formats ``%d``, ``%m``, ``%H``, ``%I``, ``%M``, ``%S``, ``%j``, ``%U``, " "``%W``, and ``%V``. Format ``%y`` does require a leading zero." msgstr "" -#: library/datetime.rst:2628 +#: library/datetime.rst:2629 msgid "Footnotes" msgstr "" -#: library/datetime.rst:2629 +#: library/datetime.rst:2630 msgid "If, that is, we ignore the effects of Relativity" msgstr "" -#: library/datetime.rst:2631 +#: library/datetime.rst:2632 msgid "" "This matches the definition of the \"proleptic Gregorian\" calendar in " "Dershowitz and Reingold's book *Calendrical Calculations*, where it's the " @@ -3235,23 +3237,23 @@ msgid "" "systems." msgstr "" -#: library/datetime.rst:2637 +#: library/datetime.rst:2638 msgid "" "See R. H. van Gent's `guide to the mathematics of the ISO 8601 calendar " "`_ for a good explanation." msgstr "" -#: library/datetime.rst:2641 +#: library/datetime.rst:2642 msgid "" "Passing ``datetime.strptime('Feb 29', '%b %d')`` will fail since ``1900`` is " "not a leap year." msgstr "" -#: library/datetime.rst:2301 +#: library/datetime.rst:2302 msgid "% (percent)" msgstr "" -#: library/datetime.rst:2301 +#: library/datetime.rst:2302 msgid "datetime format" msgstr "" diff --git a/library/doctest.po b/library/doctest.po index 14b34925b..67d7d55ee 100644 --- a/library/doctest.po +++ b/library/doctest.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -88,11 +88,11 @@ msgstr "" #: library/doctest.rst:145 msgid "" "The simplest way to start using doctest (but not necessarily the way you'll " -"continue to do it) is to end each module :mod:`M` with::" +"continue to do it) is to end each module :mod:`!M` with::" msgstr "" #: library/doctest.rst:152 -msgid ":mod:`doctest` then examines docstrings in module :mod:`M`." +msgid ":mod:`!doctest` then examines docstrings in module :mod:`!M`." msgstr "" #: library/doctest.rst:154 @@ -351,10 +351,10 @@ msgstr "" #: library/doctest.rst:405 msgid "" "By default, each time :mod:`doctest` finds a docstring to test, it uses a " -"*shallow copy* of :mod:`M`'s globals, so that running tests doesn't change " -"the module's real globals, and so that one test in :mod:`M` can't leave " +"*shallow copy* of :mod:`!M`'s globals, so that running tests doesn't change " +"the module's real globals, and so that one test in :mod:`!M` can't leave " "behind crumbs that accidentally allow another test to work. This means " -"examples can freely use any names defined at top-level in :mod:`M`, and " +"examples can freely use any names defined at top-level in :mod:`!M`, and " "names defined earlier in the docstring being run. Examples cannot see names " "defined in other docstrings." msgstr "" @@ -897,14 +897,14 @@ msgid "" "continue running examples." msgstr "" -#: library/doctest.rst:1070 +#: library/doctest.rst:1071 msgid "" "Optional argument *parser* specifies a :class:`DocTestParser` (or subclass) " "that should be used to extract tests from the files. It defaults to a " "normal parser (i.e., ``DocTestParser()``)." msgstr "" -#: library/doctest.rst:1074 +#: library/doctest.rst:1075 msgid "" "Optional argument *encoding* specifies an encoding that should be used to " "convert the file to unicode." @@ -951,44 +951,45 @@ msgid "" "Optional argument *exclude_empty* defaults to false. If true, objects for " "which no doctests are found are excluded from consideration. The default is " "a backward compatibility hack, so that code still using :meth:`doctest." -"master.summarize` in conjunction with :func:`testmod` continues to get " -"output for objects with no tests. The *exclude_empty* argument to the newer :" -"class:`DocTestFinder` constructor defaults to true." +"master.summarize ` in conjunction with :func:" +"`testmod` continues to get output for objects with no tests. The " +"*exclude_empty* argument to the newer :class:`DocTestFinder` constructor " +"defaults to true." msgstr "" -#: library/doctest.rst:966 +#: library/doctest.rst:967 msgid "" "Optional arguments *extraglobs*, *verbose*, *report*, *optionflags*, " "*raise_on_error*, and *globs* are the same as for function :func:`testfile` " "above, except that *globs* defaults to ``m.__dict__``." msgstr "" -#: library/doctest.rst:973 +#: library/doctest.rst:974 msgid "" "Test examples associated with object *f*; for example, *f* may be a string, " "a module, a function, or a class object." msgstr "" -#: library/doctest.rst:976 +#: library/doctest.rst:977 msgid "" "A shallow copy of dictionary argument *globs* is used for the execution " "context." msgstr "" -#: library/doctest.rst:978 +#: library/doctest.rst:979 msgid "" "Optional argument *name* is used in failure messages, and defaults to " "``\"NoName\"``." msgstr "" -#: library/doctest.rst:981 +#: library/doctest.rst:982 msgid "" "If optional argument *verbose* is true, output is generated even if there " "are no failures. By default, output is generated only in case of an example " "failure." msgstr "" -#: library/doctest.rst:984 +#: library/doctest.rst:985 msgid "" "Optional argument *compileflags* gives the set of flags that should be used " "by the Python compiler when running the examples. By default, or if " @@ -996,37 +997,38 @@ msgid "" "found in *globs*." msgstr "" -#: library/doctest.rst:988 +#: library/doctest.rst:989 msgid "" "Optional argument *optionflags* works as for function :func:`testfile` above." msgstr "" -#: library/doctest.rst:994 +#: library/doctest.rst:995 msgid "Unittest API" msgstr "" -#: library/doctest.rst:996 +#: library/doctest.rst:997 msgid "" "As your collection of doctest'ed modules grows, you'll want a way to run all " "their doctests systematically. :mod:`doctest` provides two functions that " "can be used to create :mod:`unittest` test suites from modules and text " "files containing doctests. To integrate with :mod:`unittest` test " -"discovery, include a :func:`load_tests` function in your test module::" +"discovery, include a :ref:`load_tests ` function in " +"your test module::" msgstr "" -#: library/doctest.rst:1010 +#: library/doctest.rst:1011 msgid "" "There are two main functions for creating :class:`unittest.TestSuite` " "instances from text files and modules with doctests:" msgstr "" -#: library/doctest.rst:1016 +#: library/doctest.rst:1017 msgid "" "Convert doctest tests from one or more text files to a :class:`unittest." "TestSuite`." msgstr "" -#: library/doctest.rst:1019 +#: library/doctest.rst:1020 msgid "" "The returned :class:`unittest.TestSuite` is to be run by the unittest " "framework and runs the interactive examples in each file. If an example in " @@ -1035,21 +1037,21 @@ msgid "" "containing the test and a (sometimes approximate) line number." msgstr "" -#: library/doctest.rst:1025 +#: library/doctest.rst:1026 msgid "Pass one or more paths (as strings) to text files to be examined." msgstr "" -#: library/doctest.rst:1027 +#: library/doctest.rst:1028 msgid "Options may be provided as keyword arguments:" msgstr "" -#: library/doctest.rst:1029 +#: library/doctest.rst:1030 msgid "" "Optional argument *module_relative* specifies how the filenames in *paths* " "should be interpreted:" msgstr "" -#: library/doctest.rst:1032 +#: library/doctest.rst:1033 msgid "" "If *module_relative* is ``True`` (the default), then each filename in " "*paths* specifies an OS-independent module-relative path. By default, this " @@ -1060,14 +1062,14 @@ msgid "" "``)." msgstr "" -#: library/doctest.rst:1040 +#: library/doctest.rst:1041 msgid "" "If *module_relative* is ``False``, then each filename in *paths* specifies " "an OS-specific path. The path may be absolute or relative; relative paths " "are resolved with respect to the current working directory." msgstr "" -#: library/doctest.rst:1044 +#: library/doctest.rst:1045 msgid "" "Optional argument *package* is a Python package or the name of a Python " "package whose directory should be used as the base directory for module-" @@ -1077,7 +1079,7 @@ msgid "" "``False``." msgstr "" -#: library/doctest.rst:1051 +#: library/doctest.rst:1052 msgid "" "Optional argument *setUp* specifies a set-up function for the test suite. " "This is called before running the tests in each file. The *setUp* function " @@ -1085,7 +1087,7 @@ msgid "" "test globals as the *globs* attribute of the test passed." msgstr "" -#: library/doctest.rst:1056 +#: library/doctest.rst:1057 msgid "" "Optional argument *tearDown* specifies a tear-down function for the test " "suite. This is called after running the tests in each file. The *tearDown* " @@ -1093,14 +1095,14 @@ msgid "" "access the test globals as the *globs* attribute of the test passed." msgstr "" -#: library/doctest.rst:1095 +#: library/doctest.rst:1096 msgid "" "Optional argument *globs* is a dictionary containing the initial global " "variables for the tests. A new copy of this dictionary is created for each " "test. By default, *globs* is a new empty dictionary." msgstr "" -#: library/doctest.rst:1065 +#: library/doctest.rst:1066 msgid "" "Optional argument *optionflags* specifies the default doctest options for " "the tests, created by or-ing together individual option flags. See section :" @@ -1108,17 +1110,17 @@ msgid "" "for a better way to set reporting options." msgstr "" -#: library/doctest.rst:1077 +#: library/doctest.rst:1078 msgid "" "The global ``__file__`` is added to the globals provided to doctests loaded " "from a text file using :func:`DocFileSuite`." msgstr "" -#: library/doctest.rst:1083 +#: library/doctest.rst:1084 msgid "Convert doctest tests for a module to a :class:`unittest.TestSuite`." msgstr "" -#: library/doctest.rst:1085 +#: library/doctest.rst:1086 msgid "" "The returned :class:`unittest.TestSuite` is to be run by the unittest " "framework and runs each doctest in the module. If any of the doctests fail, " @@ -1127,61 +1129,69 @@ msgid "" "(sometimes approximate) line number." msgstr "" -#: library/doctest.rst:1091 +#: library/doctest.rst:1092 msgid "" "Optional argument *module* provides the module to be tested. It can be a " "module object or a (possibly dotted) module name. If not specified, the " "module calling this function is used." msgstr "" -#: library/doctest.rst:1099 +#: library/doctest.rst:1100 msgid "" "Optional argument *extraglobs* specifies an extra set of global variables, " "which is merged into *globs*. By default, no extra globals are used." msgstr "" -#: library/doctest.rst:1102 +#: library/doctest.rst:1103 msgid "" "Optional argument *test_finder* is the :class:`DocTestFinder` object (or a " "drop-in replacement) that is used to extract doctests from the module." msgstr "" -#: library/doctest.rst:1105 +#: library/doctest.rst:1106 msgid "" "Optional arguments *setUp*, *tearDown*, and *optionflags* are the same as " "for function :func:`DocFileSuite` above." msgstr "" -#: library/doctest.rst:1108 +#: library/doctest.rst:1109 msgid "This function uses the same search technique as :func:`testmod`." msgstr "" -#: library/doctest.rst:1110 +#: library/doctest.rst:1111 msgid "" ":func:`DocTestSuite` returns an empty :class:`unittest.TestSuite` if " "*module* contains no docstrings instead of raising :exc:`ValueError`." msgstr "" -#: library/doctest.rst:1115 +#: library/doctest.rst:1117 +msgid "" +"When doctests which have been converted to unit tests by :func:" +"`DocFileSuite` or :func:`DocTestSuite` fail, this exception is raised " +"showing the name of the file containing the test and a (sometimes " +"approximate) line number." +msgstr "" + +#: library/doctest.rst:1121 msgid "" "Under the covers, :func:`DocTestSuite` creates a :class:`unittest.TestSuite` " -"out of :class:`doctest.DocTestCase` instances, and :class:`DocTestCase` is a " -"subclass of :class:`unittest.TestCase`. :class:`DocTestCase` isn't " +"out of :class:`!doctest.DocTestCase` instances, and :class:`!DocTestCase` is " +"a subclass of :class:`unittest.TestCase`. :class:`!DocTestCase` isn't " "documented here (it's an internal detail), but studying its code can answer " "questions about the exact details of :mod:`unittest` integration." msgstr "" -#: library/doctest.rst:1121 +#: library/doctest.rst:1127 msgid "" "Similarly, :func:`DocFileSuite` creates a :class:`unittest.TestSuite` out " -"of :class:`doctest.DocFileCase` instances, and :class:`DocFileCase` is a " -"subclass of :class:`DocTestCase`." +"of :class:`!doctest.DocFileCase` instances, and :class:`!DocFileCase` is a " +"subclass of :class:`!DocTestCase`." msgstr "" -#: library/doctest.rst:1125 +#: library/doctest.rst:1131 msgid "" "So both ways of creating a :class:`unittest.TestSuite` run instances of :" -"class:`DocTestCase`. This is important for a subtle reason: when you run :" +"class:`!DocTestCase`. This is important for a subtle reason: when you run :" "mod:`doctest` functions yourself, you can control the :mod:`doctest` options " "in use directly, by passing option flags to :mod:`doctest` functions. " "However, if you're writing a :mod:`unittest` framework, :mod:`unittest` " @@ -1191,47 +1201,47 @@ msgid "" "through :mod:`unittest` to :mod:`doctest` test runners." msgstr "" -#: library/doctest.rst:1135 +#: library/doctest.rst:1141 msgid "" "For this reason, :mod:`doctest` also supports a notion of :mod:`doctest` " "reporting flags specific to :mod:`unittest` support, via this function:" msgstr "" -#: library/doctest.rst:1141 +#: library/doctest.rst:1147 msgid "Set the :mod:`doctest` reporting flags to use." msgstr "" -#: library/doctest.rst:1143 +#: library/doctest.rst:1149 msgid "" "Argument *flags* takes the :ref:`bitwise OR ` of option flags. See " "section :ref:`doctest-options`. Only \"reporting flags\" can be used." msgstr "" -#: library/doctest.rst:1146 +#: library/doctest.rst:1152 msgid "" "This is a module-global setting, and affects all future doctests run by " -"module :mod:`unittest`: the :meth:`runTest` method of :class:`DocTestCase` " -"looks at the option flags specified for the test case when the :class:" -"`DocTestCase` instance was constructed. If no reporting flags were " -"specified (which is the typical and expected case), :mod:`doctest`'s :mod:" +"module :mod:`unittest`: the :meth:`!runTest` method of :class:`!" +"DocTestCase` looks at the option flags specified for the test case when the :" +"class:`!DocTestCase` instance was constructed. If no reporting flags were " +"specified (which is the typical and expected case), :mod:`!doctest`'s :mod:" "`unittest` reporting flags are :ref:`bitwise ORed ` into the option " "flags, and the option flags so augmented are passed to the :class:" "`DocTestRunner` instance created to run the doctest. If any reporting flags " -"were specified when the :class:`DocTestCase` instance was constructed, :mod:" -"`doctest`'s :mod:`unittest` reporting flags are ignored." +"were specified when the :class:`!DocTestCase` instance was constructed, :mod:" +"`!doctest`'s :mod:`unittest` reporting flags are ignored." msgstr "" -#: library/doctest.rst:1157 +#: library/doctest.rst:1163 msgid "" "The value of the :mod:`unittest` reporting flags in effect before the " "function was called is returned by the function." msgstr "" -#: library/doctest.rst:1164 +#: library/doctest.rst:1170 msgid "Advanced API" msgstr "" -#: library/doctest.rst:1166 +#: library/doctest.rst:1172 msgid "" "The basic API is a simple wrapper that's intended to make doctest easy to " "use. It is fairly flexible, and should meet most users' needs; however, if " @@ -1239,85 +1249,85 @@ msgid "" "doctest's capabilities, then you should use the advanced API." msgstr "" -#: library/doctest.rst:1171 +#: library/doctest.rst:1177 msgid "" "The advanced API revolves around two container classes, which are used to " "store the interactive examples extracted from doctest cases:" msgstr "" -#: library/doctest.rst:1174 +#: library/doctest.rst:1180 msgid "" ":class:`Example`: A single Python :term:`statement`, paired with its " "expected output." msgstr "" -#: library/doctest.rst:1177 +#: library/doctest.rst:1183 msgid "" ":class:`DocTest`: A collection of :class:`Example`\\ s, typically extracted " "from a single docstring or text file." msgstr "" -#: library/doctest.rst:1180 +#: library/doctest.rst:1186 msgid "" "Additional processing classes are defined to find, parse, and run, and check " "doctest examples:" msgstr "" -#: library/doctest.rst:1183 +#: library/doctest.rst:1189 msgid "" ":class:`DocTestFinder`: Finds all docstrings in a given module, and uses a :" "class:`DocTestParser` to create a :class:`DocTest` from every docstring that " "contains interactive examples." msgstr "" -#: library/doctest.rst:1187 +#: library/doctest.rst:1193 msgid "" ":class:`DocTestParser`: Creates a :class:`DocTest` object from a string " "(such as an object's docstring)." msgstr "" -#: library/doctest.rst:1190 +#: library/doctest.rst:1196 msgid "" ":class:`DocTestRunner`: Executes the examples in a :class:`DocTest`, and " "uses an :class:`OutputChecker` to verify their output." msgstr "" -#: library/doctest.rst:1193 +#: library/doctest.rst:1199 msgid "" ":class:`OutputChecker`: Compares the actual output from a doctest example " "with the expected output, and decides whether they match." msgstr "" -#: library/doctest.rst:1196 +#: library/doctest.rst:1202 msgid "" "The relationships among these processing classes are summarized in the " "following diagram::" msgstr "" -#: library/doctest.rst:1212 +#: library/doctest.rst:1218 msgid "DocTest Objects" msgstr "" -#: library/doctest.rst:1217 +#: library/doctest.rst:1223 msgid "" "A collection of doctest examples that should be run in a single namespace. " "The constructor arguments are used to initialize the attributes of the same " "names." msgstr "" -#: library/doctest.rst:1221 +#: library/doctest.rst:1227 msgid "" ":class:`DocTest` defines the following attributes. They are initialized by " "the constructor, and should not be modified directly." msgstr "" -#: library/doctest.rst:1227 +#: library/doctest.rst:1233 msgid "" "A list of :class:`Example` objects encoding the individual interactive " "Python examples that should be run by this test." msgstr "" -#: library/doctest.rst:1233 +#: library/doctest.rst:1239 msgid "" "The namespace (aka globals) that the examples should be run in. This is a " "dictionary mapping names to values. Any changes to the namespace made by " @@ -1325,57 +1335,57 @@ msgid "" "`globs` after the test is run." msgstr "" -#: library/doctest.rst:1241 +#: library/doctest.rst:1247 msgid "" "A string name identifying the :class:`DocTest`. Typically, this is the name " "of the object or file that the test was extracted from." msgstr "" -#: library/doctest.rst:1247 +#: library/doctest.rst:1253 msgid "" "The name of the file that this :class:`DocTest` was extracted from; or " "``None`` if the filename is unknown, or if the :class:`DocTest` was not " "extracted from a file." msgstr "" -#: library/doctest.rst:1254 +#: library/doctest.rst:1260 msgid "" "The line number within :attr:`filename` where this :class:`DocTest` begins, " "or ``None`` if the line number is unavailable. This line number is zero-" "based with respect to the beginning of the file." msgstr "" -#: library/doctest.rst:1261 +#: library/doctest.rst:1267 msgid "" "The string that the test was extracted from, or ``None`` if the string is " "unavailable, or if the test was not extracted from a string." msgstr "" -#: library/doctest.rst:1268 +#: library/doctest.rst:1274 msgid "Example Objects" msgstr "" -#: library/doctest.rst:1273 +#: library/doctest.rst:1279 msgid "" "A single interactive example, consisting of a Python statement and its " "expected output. The constructor arguments are used to initialize the " "attributes of the same names." msgstr "" -#: library/doctest.rst:1278 +#: library/doctest.rst:1284 msgid "" ":class:`Example` defines the following attributes. They are initialized by " "the constructor, and should not be modified directly." msgstr "" -#: library/doctest.rst:1284 +#: library/doctest.rst:1290 msgid "" "A string containing the example's source code. This source code consists of " "a single Python statement, and always ends with a newline; the constructor " "adds a newline when necessary." msgstr "" -#: library/doctest.rst:1291 +#: library/doctest.rst:1297 msgid "" "The expected output from running the example's source code (either from " "stdout, or a traceback in case of exception). :attr:`want` ends with a " @@ -1383,7 +1393,7 @@ msgid "" "The constructor adds a newline when necessary." msgstr "" -#: library/doctest.rst:1299 +#: library/doctest.rst:1305 msgid "" "The exception message generated by the example, if the example is expected " "to generate an exception; or ``None`` if it is not expected to generate an " @@ -1392,33 +1402,33 @@ msgid "" "unless it's ``None``. The constructor adds a newline if needed." msgstr "" -#: library/doctest.rst:1308 +#: library/doctest.rst:1314 msgid "" "The line number within the string containing this example where the example " "begins. This line number is zero-based with respect to the beginning of the " "containing string." msgstr "" -#: library/doctest.rst:1315 +#: library/doctest.rst:1321 msgid "" "The example's indentation in the containing string, i.e., the number of " "space characters that precede the example's first prompt." msgstr "" -#: library/doctest.rst:1321 +#: library/doctest.rst:1327 msgid "" "A dictionary mapping from option flags to ``True`` or ``False``, which is " "used to override default options for this example. Any option flags not " "contained in this dictionary are left at their default value (as specified " -"by the :class:`DocTestRunner`'s :attr:`optionflags`). By default, no options " -"are set." +"by the :class:`DocTestRunner`'s :ref:`optionflags `). By " +"default, no options are set." msgstr "" -#: library/doctest.rst:1330 +#: library/doctest.rst:1337 msgid "DocTestFinder objects" msgstr "" -#: library/doctest.rst:1335 +#: library/doctest.rst:1342 msgid "" "A processing class used to extract the :class:`DocTest`\\ s that are " "relevant to a given object, from its docstring and the docstrings of its " @@ -1426,48 +1436,48 @@ msgid "" "classes, functions, methods, staticmethods, classmethods, and properties." msgstr "" -#: library/doctest.rst:1340 +#: library/doctest.rst:1347 msgid "" "The optional argument *verbose* can be used to display the objects searched " "by the finder. It defaults to ``False`` (no output)." msgstr "" -#: library/doctest.rst:1343 +#: library/doctest.rst:1350 msgid "" "The optional argument *parser* specifies the :class:`DocTestParser` object " "(or a drop-in replacement) that is used to extract doctests from docstrings." msgstr "" -#: library/doctest.rst:1346 +#: library/doctest.rst:1353 msgid "" "If the optional argument *recurse* is false, then :meth:`DocTestFinder.find` " "will only examine the given object, and not any contained objects." msgstr "" -#: library/doctest.rst:1349 +#: library/doctest.rst:1356 msgid "" "If the optional argument *exclude_empty* is false, then :meth:`DocTestFinder." "find` will include tests for objects with empty docstrings." msgstr "" -#: library/doctest.rst:1353 +#: library/doctest.rst:1360 msgid ":class:`DocTestFinder` defines the following method:" msgstr "" -#: library/doctest.rst:1358 +#: library/doctest.rst:1365 msgid "" "Return a list of the :class:`DocTest`\\ s that are defined by *obj*'s " "docstring, or by any of its contained objects' docstrings." msgstr "" -#: library/doctest.rst:1361 +#: library/doctest.rst:1368 msgid "" "The optional argument *name* specifies the object's name; this name will be " "used to construct names for the returned :class:`DocTest`\\ s. If *name* is " "not specified, then ``obj.__name__`` is used." msgstr "" -#: library/doctest.rst:1365 +#: library/doctest.rst:1372 msgid "" "The optional parameter *module* is the module that contains the given " "object. If the module is not specified or is ``None``, then the test finder " @@ -1475,26 +1485,26 @@ msgid "" "module is used:" msgstr "" -#: library/doctest.rst:1369 +#: library/doctest.rst:1376 msgid "As a default namespace, if *globs* is not specified." msgstr "" -#: library/doctest.rst:1371 +#: library/doctest.rst:1378 msgid "" "To prevent the DocTestFinder from extracting DocTests from objects that are " "imported from other modules. (Contained objects with modules other than " "*module* are ignored.)" msgstr "" -#: library/doctest.rst:1375 +#: library/doctest.rst:1382 msgid "To find the name of the file containing the object." msgstr "" -#: library/doctest.rst:1377 +#: library/doctest.rst:1384 msgid "To help find the line number of the object within its file." msgstr "" -#: library/doctest.rst:1379 +#: library/doctest.rst:1386 msgid "" "If *module* is ``False``, no attempt to find the module will be made. This " "is obscure, of use mostly in testing doctest itself: if *module* is " @@ -1503,7 +1513,7 @@ msgid "" "contained objects will (recursively) be searched for doctests." msgstr "" -#: library/doctest.rst:1385 +#: library/doctest.rst:1392 msgid "" "The globals for each :class:`DocTest` is formed by combining *globs* and " "*extraglobs* (bindings in *extraglobs* override bindings in *globs*). A new " @@ -1513,34 +1523,34 @@ msgid "" "defaults to ``{}``." msgstr "" -#: library/doctest.rst:1396 +#: library/doctest.rst:1403 msgid "DocTestParser objects" msgstr "" -#: library/doctest.rst:1401 +#: library/doctest.rst:1408 msgid "" "A processing class used to extract interactive examples from a string, and " "use them to create a :class:`DocTest` object." msgstr "" -#: library/doctest.rst:1473 +#: library/doctest.rst:1480 msgid ":class:`DocTestParser` defines the following methods:" msgstr "" -#: library/doctest.rst:1410 +#: library/doctest.rst:1417 msgid "" "Extract all doctest examples from the given string, and collect them into a :" "class:`DocTest` object." msgstr "" -#: library/doctest.rst:1413 +#: library/doctest.rst:1420 msgid "" "*globs*, *name*, *filename*, and *lineno* are attributes for the new :class:" "`DocTest` object. See the documentation for :class:`DocTest` for more " "information." msgstr "" -#: library/doctest.rst:1420 +#: library/doctest.rst:1427 msgid "" "Extract all doctest examples from the given string, and return them as a " "list of :class:`Example` objects. Line numbers are 0-based. The optional " @@ -1548,7 +1558,7 @@ msgid "" "error messages." msgstr "" -#: library/doctest.rst:1427 +#: library/doctest.rst:1434 msgid "" "Divide the given string into examples and intervening text, and return them " "as a list of alternating :class:`Example`\\ s and strings. Line numbers for " @@ -1556,17 +1566,17 @@ msgid "" "name identifying this string, and is only used for error messages." msgstr "" -#: library/doctest.rst:1436 +#: library/doctest.rst:1443 msgid "DocTestRunner objects" msgstr "" -#: library/doctest.rst:1441 +#: library/doctest.rst:1448 msgid "" "A processing class used to execute and verify the interactive examples in a :" "class:`DocTest`." msgstr "" -#: library/doctest.rst:1444 +#: library/doctest.rst:1451 msgid "" "The comparison between expected outputs and actual outputs is done by an :" "class:`OutputChecker`. This comparison may be customized with a number of " @@ -1576,25 +1586,25 @@ msgid "" "constructor." msgstr "" -#: library/doctest.rst:1450 +#: library/doctest.rst:1457 msgid "" "The test runner's display output can be controlled in two ways. First, an " -"output function can be passed to :meth:`TestRunner.run`; this function will " -"be called with strings that should be displayed. It defaults to ``sys." -"stdout.write``. If capturing the output is not sufficient, then the display " -"output can be also customized by subclassing DocTestRunner, and overriding " -"the methods :meth:`report_start`, :meth:`report_success`, :meth:" +"output function can be passed to :meth:`run`; this function will be called " +"with strings that should be displayed. It defaults to ``sys.stdout." +"write``. If capturing the output is not sufficient, then the display output " +"can be also customized by subclassing DocTestRunner, and overriding the " +"methods :meth:`report_start`, :meth:`report_success`, :meth:" "`report_unexpected_exception`, and :meth:`report_failure`." msgstr "" -#: library/doctest.rst:1458 +#: library/doctest.rst:1465 msgid "" "The optional keyword argument *checker* specifies the :class:`OutputChecker` " "object (or drop-in replacement) that should be used to compare the expected " "outputs to the actual outputs of doctest examples." msgstr "" -#: library/doctest.rst:1462 +#: library/doctest.rst:1469 msgid "" "The optional keyword argument *verbose* controls the :class:" "`DocTestRunner`'s verbosity. If *verbose* is ``True``, then information is " @@ -1603,56 +1613,56 @@ msgid "" "verbose output is used iff the command-line switch ``-v`` is used." msgstr "" -#: library/doctest.rst:1468 +#: library/doctest.rst:1475 msgid "" "The optional keyword argument *optionflags* can be used to control how the " "test runner compares expected output to actual output, and how it displays " "failures. For more information, see section :ref:`doctest-options`." msgstr "" -#: library/doctest.rst:1478 +#: library/doctest.rst:1485 msgid "" "Report that the test runner is about to process the given example. This " "method is provided to allow subclasses of :class:`DocTestRunner` to " "customize their output; it should not be called directly." msgstr "" -#: library/doctest.rst:1482 +#: library/doctest.rst:1489 msgid "" "*example* is the example about to be processed. *test* is the test " "*containing example*. *out* is the output function that was passed to :meth:" "`DocTestRunner.run`." msgstr "" -#: library/doctest.rst:1489 +#: library/doctest.rst:1496 msgid "" "Report that the given example ran successfully. This method is provided to " "allow subclasses of :class:`DocTestRunner` to customize their output; it " "should not be called directly." msgstr "" -#: library/doctest.rst:1504 +#: library/doctest.rst:1511 msgid "" "*example* is the example about to be processed. *got* is the actual output " "from the example. *test* is the test containing *example*. *out* is the " "output function that was passed to :meth:`DocTestRunner.run`." msgstr "" -#: library/doctest.rst:1500 +#: library/doctest.rst:1507 msgid "" "Report that the given example failed. This method is provided to allow " "subclasses of :class:`DocTestRunner` to customize their output; it should " "not be called directly." msgstr "" -#: library/doctest.rst:1511 +#: library/doctest.rst:1518 msgid "" "Report that the given example raised an unexpected exception. This method is " "provided to allow subclasses of :class:`DocTestRunner` to customize their " "output; it should not be called directly." msgstr "" -#: library/doctest.rst:1515 +#: library/doctest.rst:1522 msgid "" "*example* is the example about to be processed. *exc_info* is a tuple " "containing information about the unexpected exception (as returned by :func:" @@ -1660,13 +1670,13 @@ msgid "" "output function that was passed to :meth:`DocTestRunner.run`." msgstr "" -#: library/doctest.rst:1523 +#: library/doctest.rst:1530 msgid "" "Run the examples in *test* (a :class:`DocTest` object), and display the " "results using the writer function *out*." msgstr "" -#: library/doctest.rst:1526 +#: library/doctest.rst:1533 msgid "" "The examples are run in the namespace ``test.globs``. If *clear_globs* is " "true (the default), then this namespace will be cleared after the test runs, " @@ -1674,39 +1684,39 @@ msgid "" "after the test completes, then use *clear_globs=False*." msgstr "" -#: library/doctest.rst:1531 +#: library/doctest.rst:1538 msgid "" "*compileflags* gives the set of flags that should be used by the Python " "compiler when running the examples. If not specified, then it will default " "to the set of future-import flags that apply to *globs*." msgstr "" -#: library/doctest.rst:1535 +#: library/doctest.rst:1542 msgid "" "The output of each example is checked using the :class:`DocTestRunner`'s " -"output checker, and the results are formatted by the :meth:`DocTestRunner." +"output checker, and the results are formatted by the :meth:`!DocTestRunner." "report_\\*` methods." msgstr "" -#: library/doctest.rst:1542 +#: library/doctest.rst:1549 msgid "" "Print a summary of all the test cases that have been run by this " "DocTestRunner, and return a :term:`named tuple` ``TestResults(failed, " "attempted)``." msgstr "" -#: library/doctest.rst:1545 +#: library/doctest.rst:1552 msgid "" "The optional *verbose* argument controls how detailed the summary is. If " "the verbosity is not specified, then the :class:`DocTestRunner`'s verbosity " "is used." msgstr "" -#: library/doctest.rst:1552 +#: library/doctest.rst:1559 msgid "OutputChecker objects" msgstr "" -#: library/doctest.rst:1557 +#: library/doctest.rst:1564 msgid "" "A class used to check the whether the actual output from a doctest example " "matches the expected output. :class:`OutputChecker` defines two methods: :" @@ -1715,11 +1725,11 @@ msgid "" "string describing the differences between two outputs." msgstr "" -#: library/doctest.rst:1564 +#: library/doctest.rst:1571 msgid ":class:`OutputChecker` defines the following methods:" msgstr "" -#: library/doctest.rst:1568 +#: library/doctest.rst:1575 msgid "" "Return ``True`` iff the actual output from an example (*got*) matches the " "expected output (*want*). These strings are always considered to match if " @@ -1728,28 +1738,28 @@ msgid "" "`doctest-options` for more information about option flags." msgstr "" -#: library/doctest.rst:1577 +#: library/doctest.rst:1584 msgid "" "Return a string describing the differences between the expected output for a " "given example (*example*) and the actual output (*got*). *optionflags* is " "the set of option flags used to compare *want* and *got*." msgstr "" -#: library/doctest.rst:1585 +#: library/doctest.rst:1592 msgid "Debugging" msgstr "" -#: library/doctest.rst:1587 +#: library/doctest.rst:1594 msgid "Doctest provides several mechanisms for debugging doctest examples:" msgstr "" -#: library/doctest.rst:1589 +#: library/doctest.rst:1596 msgid "" "Several functions convert doctests to executable Python programs, which can " "be run under the Python debugger, :mod:`pdb`." msgstr "" -#: library/doctest.rst:1592 +#: library/doctest.rst:1599 msgid "" "The :class:`DebugRunner` class is a subclass of :class:`DocTestRunner` that " "raises an exception for the first failing example, containing information " @@ -1757,13 +1767,13 @@ msgid "" "debugging on the example." msgstr "" -#: library/doctest.rst:1597 +#: library/doctest.rst:1604 msgid "" "The :mod:`unittest` cases generated by :func:`DocTestSuite` support the :" "meth:`debug` method defined by :class:`unittest.TestCase`." msgstr "" -#: library/doctest.rst:1600 +#: library/doctest.rst:1607 msgid "" "You can add a call to :func:`pdb.set_trace` in a doctest example, and you'll " "drop into the Python debugger when that line is executed. Then you can " @@ -1771,21 +1781,21 @@ msgid "" "`a.py` contains just this module docstring::" msgstr "" -#: library/doctest.rst:1615 +#: library/doctest.rst:1622 msgid "Then an interactive Python session may look like this::" msgstr "" -#: library/doctest.rst:1648 +#: library/doctest.rst:1655 msgid "" "Functions that convert doctests to Python code, and possibly run the " "synthesized code under the debugger:" msgstr "" -#: library/doctest.rst:1654 +#: library/doctest.rst:1661 msgid "Convert text with examples to a script." msgstr "" -#: library/doctest.rst:1656 +#: library/doctest.rst:1663 msgid "" "Argument *s* is a string containing doctest examples. The string is " "converted to a Python script, where doctest examples in *s* are converted to " @@ -1793,42 +1803,42 @@ msgid "" "generated script is returned as a string. For example, ::" msgstr "" -#: library/doctest.rst:1671 +#: library/doctest.rst:1678 msgid "displays::" msgstr "" -#: library/doctest.rst:1681 +#: library/doctest.rst:1688 msgid "" "This function is used internally by other functions (see below), but can " "also be useful when you want to transform an interactive Python session into " "a Python script." msgstr "" -#: library/doctest.rst:1688 +#: library/doctest.rst:1695 msgid "Convert the doctest for an object to a script." msgstr "" -#: library/doctest.rst:1690 +#: library/doctest.rst:1697 msgid "" "Argument *module* is a module object, or dotted name of a module, containing " "the object whose doctests are of interest. Argument *name* is the name " "(within the module) of the object with the doctests of interest. The result " "is a string, containing the object's docstring converted to a Python script, " "as described for :func:`script_from_examples` above. For example, if " -"module :file:`a.py` contains a top-level function :func:`f`, then ::" +"module :file:`a.py` contains a top-level function :func:`!f`, then ::" msgstr "" -#: library/doctest.rst:1700 +#: library/doctest.rst:1707 msgid "" -"prints a script version of function :func:`f`'s docstring, with doctests " +"prints a script version of function :func:`!f`'s docstring, with doctests " "converted to code, and the rest placed in comments." msgstr "" -#: library/doctest.rst:1706 +#: library/doctest.rst:1713 msgid "Debug the doctests for an object." msgstr "" -#: library/doctest.rst:1708 +#: library/doctest.rst:1715 msgid "" "The *module* and *name* arguments are the same as for function :func:" "`testsource` above. The synthesized Python script for the named object's " @@ -1836,13 +1846,13 @@ msgid "" "the control of the Python debugger, :mod:`pdb`." msgstr "" -#: library/doctest.rst:1713 +#: library/doctest.rst:1720 msgid "" "A shallow copy of ``module.__dict__`` is used for both local and global " "execution context." msgstr "" -#: library/doctest.rst:1716 +#: library/doctest.rst:1723 msgid "" "Optional argument *pm* controls whether post-mortem debugging is used. If " "*pm* has a true value, the script file is run directly, and the debugger " @@ -1854,30 +1864,30 @@ msgid "" "to :func:`pdb.run`." msgstr "" -#: library/doctest.rst:1727 +#: library/doctest.rst:1734 msgid "Debug the doctests in a string." msgstr "" -#: library/doctest.rst:1729 +#: library/doctest.rst:1736 msgid "" "This is like function :func:`debug` above, except that a string containing " "doctest examples is specified directly, via the *src* argument." msgstr "" -#: library/doctest.rst:1732 +#: library/doctest.rst:1739 msgid "" "Optional argument *pm* has the same meaning as in function :func:`debug` " "above." msgstr "" -#: library/doctest.rst:1734 +#: library/doctest.rst:1741 msgid "" "Optional argument *globs* gives a dictionary to use as both local and global " "execution context. If not specified, or ``None``, an empty dictionary is " "used. If specified, a shallow copy of the dictionary is used." msgstr "" -#: library/doctest.rst:1739 +#: library/doctest.rst:1746 msgid "" "The :class:`DebugRunner` class, and the special exceptions it may raise, are " "of most interest to testing framework authors, and will only be sketched " @@ -1885,7 +1895,7 @@ msgid "" "(which is a doctest!) for more details:" msgstr "" -#: library/doctest.rst:1747 +#: library/doctest.rst:1754 msgid "" "A subclass of :class:`DocTestRunner` that raises an exception as soon as a " "failure is encountered. If an unexpected exception occurs, an :exc:" @@ -1895,89 +1905,89 @@ msgid "" "the actual output." msgstr "" -#: library/doctest.rst:1754 +#: library/doctest.rst:1761 msgid "" "For information about the constructor parameters and methods, see the " "documentation for :class:`DocTestRunner` in section :ref:`doctest-advanced-" "api`." msgstr "" -#: library/doctest.rst:1757 +#: library/doctest.rst:1764 msgid "" "There are two exceptions that may be raised by :class:`DebugRunner` " "instances:" msgstr "" -#: library/doctest.rst:1762 +#: library/doctest.rst:1769 msgid "" "An exception raised by :class:`DocTestRunner` to signal that a doctest " "example's actual output did not match its expected output. The constructor " "arguments are used to initialize the attributes of the same names." msgstr "" -#: library/doctest.rst:1766 +#: library/doctest.rst:1773 msgid ":exc:`DocTestFailure` defines the following attributes:" msgstr "" -#: library/doctest.rst:1795 +#: library/doctest.rst:1802 msgid "The :class:`DocTest` object that was being run when the example failed." msgstr "" -#: library/doctest.rst:1800 +#: library/doctest.rst:1807 msgid "The :class:`Example` that failed." msgstr "" -#: library/doctest.rst:1781 +#: library/doctest.rst:1788 msgid "The example's actual output." msgstr "" -#: library/doctest.rst:1786 +#: library/doctest.rst:1793 msgid "" "An exception raised by :class:`DocTestRunner` to signal that a doctest " "example raised an unexpected exception. The constructor arguments are used " "to initialize the attributes of the same names." msgstr "" -#: library/doctest.rst:1790 +#: library/doctest.rst:1797 msgid ":exc:`UnexpectedException` defines the following attributes:" msgstr "" -#: library/doctest.rst:1805 +#: library/doctest.rst:1812 msgid "" "A tuple containing information about the unexpected exception, as returned " "by :func:`sys.exc_info`." msgstr "" -#: library/doctest.rst:1812 +#: library/doctest.rst:1819 msgid "Soapbox" msgstr "" -#: library/doctest.rst:1814 +#: library/doctest.rst:1821 msgid "" "As mentioned in the introduction, :mod:`doctest` has grown to have three " "primary uses:" msgstr "" -#: library/doctest.rst:1817 +#: library/doctest.rst:1824 msgid "Checking examples in docstrings." msgstr "" -#: library/doctest.rst:1819 +#: library/doctest.rst:1826 msgid "Regression testing." msgstr "" -#: library/doctest.rst:1821 +#: library/doctest.rst:1828 msgid "Executable documentation / literate testing." msgstr "" -#: library/doctest.rst:1823 +#: library/doctest.rst:1830 msgid "" "These uses have different requirements, and it is important to distinguish " "them. In particular, filling your docstrings with obscure test cases makes " "for bad documentation." msgstr "" -#: library/doctest.rst:1827 +#: library/doctest.rst:1834 msgid "" "When writing a docstring, choose docstring examples with care. There's an " "art to this that needs to be learned---it may not be natural at first. " @@ -1989,7 +1999,7 @@ msgid "" "\"harmless\" change." msgstr "" -#: library/doctest.rst:1835 +#: library/doctest.rst:1842 msgid "" "Doctest also makes an excellent tool for regression testing, especially if " "you don't skimp on explanatory text. By interleaving prose and examples, it " @@ -2010,13 +2020,13 @@ msgid "" "different results, blurring the distinction between testing and explaining." msgstr "" -#: library/doctest.rst:1853 +#: library/doctest.rst:1860 msgid "" "Regression testing is best confined to dedicated objects or files. There " "are several options for organizing tests:" msgstr "" -#: library/doctest.rst:1856 +#: library/doctest.rst:1863 msgid "" "Write text files containing test cases as interactive examples, and test the " "files using :func:`testfile` or :func:`DocFileSuite`. This is recommended, " @@ -2024,7 +2034,7 @@ msgid "" "doctest." msgstr "" -#: library/doctest.rst:1861 +#: library/doctest.rst:1868 msgid "" "Define functions named ``_regrtest_topic`` that consist of single " "docstrings, containing test cases for the named topics. These functions can " @@ -2032,13 +2042,13 @@ msgid "" "test file." msgstr "" -#: library/doctest.rst:1865 +#: library/doctest.rst:1872 msgid "" "Define a ``__test__`` dictionary mapping from regression test topics to " "docstrings containing test cases." msgstr "" -#: library/doctest.rst:1868 +#: library/doctest.rst:1875 msgid "" "When you have placed your tests in a module, the module can itself be the " "test runner. When a test fails, you can arrange for your test runner to re-" @@ -2046,11 +2056,11 @@ msgid "" "example of such a test runner::" msgstr "" -#: library/doctest.rst:1890 +#: library/doctest.rst:1897 msgid "Footnotes" msgstr "" -#: library/doctest.rst:1891 +#: library/doctest.rst:1898 msgid "" "Examples containing both expected output and an exception are not supported. " "Trying to guess where one ends and the other begins is too error-prone, and " diff --git a/library/email.errors.po b/library/email.errors.po index 8ba0fb7ef..b703d2fb6 100644 --- a/library/email.errors.po +++ b/library/email.errors.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: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -78,7 +78,19 @@ msgid "" "`~email.mime.image.MIMEImage`)." msgstr "" -#: library/email.errors.rst:62 +#: library/email.errors.rst:63 +msgid "" +"This is the base class for all defects found when parsing email messages. It " +"is derived from :exc:`ValueError`." +msgstr "" + +#: library/email.errors.rst:68 +msgid "" +"This is the base class for all defects found when parsing email headers. It " +"is derived from :exc:`MessageDefect`." +msgstr "" + +#: library/email.errors.rst:71 msgid "" "Here is the list of the defects that the :class:`~email.parser.FeedParser` " "can find while parsing messages. Note that the defects are added to the " @@ -88,59 +100,59 @@ msgid "" "not." msgstr "" -#: library/email.errors.rst:68 +#: library/email.errors.rst:77 msgid "" "All defect classes are subclassed from :class:`email.errors.MessageDefect`." msgstr "" -#: library/email.errors.rst:70 +#: library/email.errors.rst:79 msgid "" ":class:`NoBoundaryInMultipartDefect` -- A message claimed to be a multipart, " "but had no :mimetype:`boundary` parameter." msgstr "" -#: library/email.errors.rst:73 +#: library/email.errors.rst:82 msgid "" ":class:`StartBoundaryNotFoundDefect` -- The start boundary claimed in the :" "mailheader:`Content-Type` header was never found." msgstr "" -#: library/email.errors.rst:76 +#: library/email.errors.rst:85 msgid "" ":class:`CloseBoundaryNotFoundDefect` -- A start boundary was found, but no " "corresponding close boundary was ever found." msgstr "" -#: library/email.errors.rst:81 +#: library/email.errors.rst:90 msgid "" ":class:`FirstHeaderLineIsContinuationDefect` -- The message had a " "continuation line as its first header line." msgstr "" -#: library/email.errors.rst:84 +#: library/email.errors.rst:93 msgid "" ":class:`MisplacedEnvelopeHeaderDefect` - A \"Unix From\" header was found in " "the middle of a header block." msgstr "" -#: library/email.errors.rst:87 +#: library/email.errors.rst:96 msgid "" ":class:`MissingHeaderBodySeparatorDefect` - A line was found while parsing " "headers that had no leading white space but contained no ':'. Parsing " "continues assuming that the line represents the first line of the body." msgstr "" -#: library/email.errors.rst:93 +#: library/email.errors.rst:102 msgid "" ":class:`MalformedHeaderDefect` -- A header was found that was missing a " "colon, or was otherwise malformed." msgstr "" -#: library/email.errors.rst:96 +#: library/email.errors.rst:105 msgid "This defect has not been used for several Python versions." msgstr "" -#: library/email.errors.rst:99 +#: library/email.errors.rst:108 msgid "" ":class:`MultipartInvariantViolationDefect` -- A message claimed to be a :" "mimetype:`multipart`, but no subparts were found. Note that when a message " @@ -149,28 +161,28 @@ msgid "" "`multipart`." msgstr "" -#: library/email.errors.rst:104 +#: library/email.errors.rst:113 msgid "" ":class:`InvalidBase64PaddingDefect` -- When decoding a block of base64 " "encoded bytes, the padding was not correct. Enough padding is added to " "perform the decode, but the resulting decoded bytes may be invalid." msgstr "" -#: library/email.errors.rst:108 +#: library/email.errors.rst:117 msgid "" ":class:`InvalidBase64CharactersDefect` -- When decoding a block of base64 " "encoded bytes, characters outside the base64 alphabet were encountered. The " "characters are ignored, but the resulting decoded bytes may be invalid." msgstr "" -#: library/email.errors.rst:112 +#: library/email.errors.rst:121 msgid "" ":class:`InvalidBase64LengthDefect` -- When decoding a block of base64 " "encoded bytes, the number of non-padding base64 characters was invalid (1 " "more than a multiple of 4). The encoded block was kept as-is." msgstr "" -#: library/email.errors.rst:116 +#: library/email.errors.rst:125 msgid "" ":class:`InvalidDateDefect` -- When decoding an invalid or unparsable date " "field. The original value is kept as-is." diff --git a/library/functions.po b/library/functions.po index 33e8ab8e5..54490d7e9 100644 --- a/library/functions.po +++ b/library/functions.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: 2023-03-08 10:13-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2304,16 +2304,17 @@ msgstr "" "platformdan bağımsızdır." #: library/functions.rst:1222 +#, fuzzy msgid "" "*buffering* is an optional integer used to set the buffering policy. Pass 0 " "to switch buffering off (only allowed in binary mode), 1 to select line " -"buffering (only usable in text mode), and an integer > 1 to indicate the " -"size in bytes of a fixed-size chunk buffer. Note that specifying a buffer " -"size this way applies for binary buffered I/O, but ``TextIOWrapper`` (i.e., " -"files opened with ``mode='r+'``) would have another buffering. To disable " -"buffering in ``TextIOWrapper``, consider using the ``write_through`` flag " -"for :func:`io.TextIOWrapper.reconfigure`. When no *buffering* argument is " -"given, the default buffering policy works as follows:" +"buffering (only usable when writing in text mode), and an integer > 1 to " +"indicate the size in bytes of a fixed-size chunk buffer. Note that " +"specifying a buffer size this way applies for binary buffered I/O, but " +"``TextIOWrapper`` (i.e., files opened with ``mode='r+'``) would have another " +"buffering. To disable buffering in ``TextIOWrapper``, consider using the " +"``write_through`` flag for :func:`io.TextIOWrapper.reconfigure`. When no " +"*buffering* argument is given, the default buffering policy works as follows:" msgstr "" "*buffering*, arabelleğe alma ilkesini ayarlamak için kullanılan isteğe bağlı " "bir tamsayıdır. Arabelleğe almayı kapatmak için 0 (yalnızca ikili modda izin " diff --git a/library/gzip.po b/library/gzip.po index 51e2486a5..713eaa0a1 100644 --- a/library/gzip.po +++ b/library/gzip.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -174,7 +174,7 @@ msgstr "" #: library/gzip.rst:108 msgid "" -"Calling a :class:`GzipFile` object's :meth:`close` method does not close " +"Calling a :class:`GzipFile` object's :meth:`!close` method does not close " "*fileobj*, since you might wish to append more material after the compressed " "data. This also allows you to pass an :class:`io.BytesIO` object opened for " "writing as *fileobj*, and retrieve the resulting memory buffer using the :" diff --git a/library/importlib.resources.po b/library/importlib.resources.po index 069ebe039..1e0601e1a 100644 --- a/library/importlib.resources.po +++ b/library/importlib.resources.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: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -97,7 +97,7 @@ msgstr "" #: library/importlib.resources.rst:66 msgid "" -"*anchor* is an optional :data:`Anchor`. If the anchor is a package, " +"*anchor* is an optional :class:`Anchor`. If the anchor is a package, " "resources are resolved from that package. If a module, resources are " "resolved adjacent to that module (in the same package or the package root). " "If the anchor is omitted, the caller's module is used." @@ -105,10 +105,10 @@ msgstr "" #: library/importlib.resources.rst:74 msgid "" -"\"package\" parameter was renamed to \"anchor\". \"anchor\" can now be a non-" -"package module and if omitted will default to the caller's module. " -"\"package\" is still accepted for compatibility but will raise a " -"DeprecationWarning. Consider passing the anchor positionally or using " +"*package* parameter was renamed to *anchor*. *anchor* can now be a non-" +"package module and if omitted will default to the caller's module. *package* " +"is still accepted for compatibility but will raise a :exc:" +"`DeprecationWarning`. Consider passing the anchor positionally or using " "``importlib_resources >= 5.10`` for a compatible interface on older Pythons." msgstr "" @@ -133,7 +133,7 @@ msgid "" msgstr "" #: library/importlib.resources.rst:98 -msgid "Added support for ``traversable`` representing a directory." +msgid "Added support for *traversable* representing a directory." msgstr "" #: library/importlib.resources.rst:103 diff --git a/library/profile.po b/library/profile.po index 61aef31af..950188a6f 100644 --- a/library/profile.po +++ b/library/profile.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -99,9 +99,8 @@ msgstr "" msgid "" "The first line indicates that 214 calls were monitored. Of those calls, 207 " "were :dfn:`primitive`, meaning that the call was not induced via recursion. " -"The next line: ``Ordered by: cumulative time``, indicates that the text " -"string in the far right column was used to sort the output. The column " -"headings include:" +"The next line: ``Ordered by: cumulative time`` indicates the output is " +"sorted by the ``cumtime`` values. The column headings include:" msgstr "" #: library/profile.rst:89 diff --git a/library/socket.po b/library/socket.po index 1e08a4e95..79a6d5e52 100644 --- a/library/socket.po +++ b/library/socket.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -52,11 +52,11 @@ msgstr "" msgid "" "The Python interface is a straightforward transliteration of the Unix system " "call and library interface for sockets to Python's object-oriented style: " -"the :func:`.socket` function returns a :dfn:`socket object` whose methods " -"implement the various socket system calls. Parameter types are somewhat " -"higher-level than in the C interface: as with :meth:`read` and :meth:`write` " -"operations on Python files, buffer allocation on receive operations is " -"automatic, and buffer length is implicit on send operations." +"the :func:`~socket.socket` function returns a :dfn:`socket object` whose " +"methods implement the various socket system calls. Parameter types are " +"somewhat higher-level than in the C interface: as with :meth:`read` and :" +"meth:`write` operations on Python files, buffer allocation on receive " +"operations is automatic, and buffer length is implicit on send operations." msgstr "" #: library/socket.rst:36 @@ -109,7 +109,7 @@ msgid "" "Previously, :const:`AF_UNIX` socket paths were assumed to use UTF-8 encoding." msgstr "" -#: library/socket.rst:1149 library/socket.rst:1950 +#: library/socket.rst:1148 library/socket.rst:1949 msgid "Writable :term:`bytes-like object` is now accepted." msgstr "" @@ -283,7 +283,7 @@ msgstr "" msgid "*feat* and *mask* are unsigned 32bit integers." msgstr "" -#: library/socket.rst:590 library/socket.rst:1872 +#: library/socket.rst:589 library/socket.rst:1871 msgid ":ref:`Availability `: Linux >= 2.6.38." msgstr "" @@ -298,7 +298,7 @@ msgid "" "context ID or CID and port are integers." msgstr "" -#: library/socket.rst:663 +#: library/socket.rst:662 msgid ":ref:`Availability `: Linux >= 3.9" msgstr "" @@ -309,7 +309,7 @@ msgstr "" #: library/socket.rst:187 msgid "" ":const:`AF_PACKET` is a low-level interface directly to network devices. The " -"packets are represented by the tuple ``(ifname, proto[, pkttype[, hatype[, " +"addresses are represented by the tuple ``(ifname, proto[, pkttype[, hatype[, " "addr]]])`` where:" msgstr "" @@ -321,54 +321,53 @@ msgstr "" msgid "" "*proto* - The Ethernet protocol number. May be :data:`ETH_P_ALL` to capture " "all protocols, one of the :ref:`ETHERTYPE_* constants ` or any other Ethernet protocol number. Value must be in network-byte-" -"order." +"types>` or any other Ethernet protocol number." msgstr "" -#: library/socket.rst:197 +#: library/socket.rst:196 msgid "*pkttype* - Optional integer specifying the packet type:" msgstr "" -#: library/socket.rst:199 +#: library/socket.rst:198 msgid "``PACKET_HOST`` (the default) - Packet addressed to the local host." msgstr "" -#: library/socket.rst:200 +#: library/socket.rst:199 msgid "``PACKET_BROADCAST`` - Physical-layer broadcast packet." msgstr "" -#: library/socket.rst:201 +#: library/socket.rst:200 msgid "" "``PACKET_MULTICAST`` - Packet sent to a physical-layer multicast address." msgstr "" -#: library/socket.rst:202 +#: library/socket.rst:201 msgid "" "``PACKET_OTHERHOST`` - Packet to some other host that has been caught by a " "device driver in promiscuous mode." msgstr "" -#: library/socket.rst:204 +#: library/socket.rst:203 msgid "" "``PACKET_OUTGOING`` - Packet originating from the local host that is looped " "back to a packet socket." msgstr "" -#: library/socket.rst:206 +#: library/socket.rst:205 msgid "*hatype* - Optional integer specifying the ARP hardware address type." msgstr "" -#: library/socket.rst:207 +#: library/socket.rst:206 msgid "" "*addr* - Optional bytes-like object specifying the hardware physical " "address, whose interpretation depends on the device." msgstr "" -#: library/socket.rst:538 +#: library/socket.rst:537 msgid ":ref:`Availability `: Linux >= 2.2." msgstr "" -#: library/socket.rst:212 +#: library/socket.rst:211 msgid "" ":const:`AF_QIPCRTR` is a Linux-only socket based interface for communicating " "with services running on co-processors in Qualcomm platforms. The address " @@ -376,11 +375,11 @@ msgid "" "*port* are non-negative integers." msgstr "" -#: library/socket.rst:639 +#: library/socket.rst:638 msgid ":ref:`Availability `: Linux >= 4.7." msgstr "" -#: library/socket.rst:221 +#: library/socket.rst:220 msgid "" ":const:`IPPROTO_UDPLITE` is a variant of UDP which allows you to specify " "what portion of a packet is covered with the checksum. It adds two socket " @@ -391,18 +390,18 @@ msgid "" "of their data. In both cases ``length`` should be in ``range(8, 2**16, 8)``." msgstr "" -#: library/socket.rst:230 +#: library/socket.rst:229 msgid "" "Such a socket should be constructed with ``socket(AF_INET, SOCK_DGRAM, " "IPPROTO_UDPLITE)`` for IPv4 or ``socket(AF_INET6, SOCK_DGRAM, " "IPPROTO_UDPLITE)`` for IPv6." msgstr "" -#: library/socket.rst:234 +#: library/socket.rst:233 msgid ":ref:`Availability `: Linux >= 2.6.20, FreeBSD >= 10.1" msgstr "" -#: library/socket.rst:238 +#: library/socket.rst:237 msgid "" ":const:`AF_HYPERV` is a Windows-only socket based interface for " "communicating with Hyper-V hosts and guests. The address family is " @@ -410,49 +409,49 @@ msgid "" "``service_id`` are UUID strings." msgstr "" -#: library/socket.rst:243 +#: library/socket.rst:242 msgid "" "The ``vm_id`` is the virtual machine identifier or a set of known VMID " "values if the target is not a specific virtual machine. Known VMID constants " "defined on ``socket`` are:" msgstr "" -#: library/socket.rst:247 +#: library/socket.rst:246 msgid "``HV_GUID_ZERO``" msgstr "" -#: library/socket.rst:248 +#: library/socket.rst:247 msgid "``HV_GUID_BROADCAST``" msgstr "" -#: library/socket.rst:249 +#: library/socket.rst:248 msgid "" "``HV_GUID_WILDCARD`` - Used to bind on itself and accept connections from " "all partitions." msgstr "" -#: library/socket.rst:251 +#: library/socket.rst:250 msgid "" "``HV_GUID_CHILDREN`` - Used to bind on itself and accept connection from " "child partitions." msgstr "" -#: library/socket.rst:253 +#: library/socket.rst:252 msgid "``HV_GUID_LOOPBACK`` - Used as a target to itself." msgstr "" -#: library/socket.rst:254 +#: library/socket.rst:253 msgid "" "``HV_GUID_PARENT`` - When used as a bind accepts connection from the parent " "partition. When used as an address target it will connect to the parent " "partition." msgstr "" -#: library/socket.rst:257 +#: library/socket.rst:256 msgid "The ``service_id`` is the service identifier of the registered service." msgstr "" -#: library/socket.rst:261 +#: library/socket.rst:260 msgid "" "If you use a hostname in the *host* portion of IPv4/v6 socket address, the " "program may show a nondeterministic behavior, as Python uses the first " @@ -462,41 +461,41 @@ msgid "" "deterministic behavior use a numeric address in *host* portion." msgstr "" -#: library/socket.rst:268 +#: library/socket.rst:267 msgid "" "All errors raise exceptions. The normal exceptions for invalid argument " "types and out-of-memory conditions can be raised. Errors related to socket " "or address semantics raise :exc:`OSError` or one of its subclasses." msgstr "" -#: library/socket.rst:273 +#: library/socket.rst:272 msgid "" "Non-blocking mode is supported through :meth:`~socket.setblocking`. A " "generalization of this based on timeouts is supported through :meth:`~socket." "settimeout`." msgstr "" -#: library/socket.rst:279 +#: library/socket.rst:278 msgid "Module contents" msgstr "" -#: library/socket.rst:281 +#: library/socket.rst:280 msgid "The module :mod:`socket` exports the following elements." msgstr "" -#: library/socket.rst:285 +#: library/socket.rst:284 msgid "Exceptions" msgstr "" -#: library/socket.rst:289 +#: library/socket.rst:288 msgid "A deprecated alias of :exc:`OSError`." msgstr "" -#: library/socket.rst:291 +#: library/socket.rst:290 msgid "Following :pep:`3151`, this class was made an alias of :exc:`OSError`." msgstr "" -#: library/socket.rst:297 +#: library/socket.rst:296 msgid "" "A subclass of :exc:`OSError`, this exception is raised for address-related " "errors, i.e. for functions that use *h_errno* in the POSIX C API, including :" @@ -506,11 +505,11 @@ msgid "" "description of *h_errno*, as returned by the :c:func:`hstrerror` C function." msgstr "" -#: library/socket.rst:318 library/socket.rst:331 +#: library/socket.rst:317 library/socket.rst:330 msgid "This class was made a subclass of :exc:`OSError`." msgstr "" -#: library/socket.rst:310 +#: library/socket.rst:309 msgid "" "A subclass of :exc:`OSError`, this exception is raised for address-related " "errors by :func:`getaddrinfo` and :func:`getnameinfo`. The accompanying " @@ -520,11 +519,11 @@ msgid "" "match one of the :const:`EAI_\\*` constants defined in this module." msgstr "" -#: library/socket.rst:323 +#: library/socket.rst:322 msgid "A deprecated alias of :exc:`TimeoutError`." msgstr "" -#: library/socket.rst:325 +#: library/socket.rst:324 msgid "" "A subclass of :exc:`OSError`, this exception is raised when a timeout occurs " "on a socket which has had timeouts enabled via a prior call to :meth:" @@ -533,105 +532,105 @@ msgid "" "currently always \"timed out\"." msgstr "" -#: library/socket.rst:334 +#: library/socket.rst:333 msgid "This class was made an alias of :exc:`TimeoutError`." msgstr "" -#: library/socket.rst:339 +#: library/socket.rst:338 msgid "Constants" msgstr "" -#: library/socket.rst:341 +#: library/socket.rst:340 msgid "" "The AF_* and SOCK_* constants are now :class:`AddressFamily` and :class:" "`SocketKind` :class:`.IntEnum` collections." msgstr "" -#: library/socket.rst:350 +#: library/socket.rst:349 msgid "" "These constants represent the address (and protocol) families, used for the " -"first argument to :func:`.socket`. If the :const:`AF_UNIX` constant is not " -"defined then this protocol is unsupported. More constants may be available " -"depending on the system." +"first argument to :func:`~socket.socket`. If the :const:`AF_UNIX` constant " +"is not defined then this protocol is unsupported. More constants may be " +"available depending on the system." msgstr "" -#: library/socket.rst:357 +#: library/socket.rst:356 msgid "" ":const:`AF_UNSPEC` means that :func:`getaddrinfo` should return socket " "addresses for any address family (either IPv4, IPv6, or any other) that can " "be used." msgstr "" -#: library/socket.rst:367 +#: library/socket.rst:366 msgid "" "These constants represent the socket types, used for the second argument to :" -"func:`.socket`. More constants may be available depending on the system. " -"(Only :const:`SOCK_STREAM` and :const:`SOCK_DGRAM` appear to be generally " -"useful.)" +"func:`~socket.socket`. More constants may be available depending on the " +"system. (Only :const:`SOCK_STREAM` and :const:`SOCK_DGRAM` appear to be " +"generally useful.)" msgstr "" -#: library/socket.rst:375 +#: library/socket.rst:374 msgid "" "These two constants, if defined, can be combined with the socket types and " "allow you to set some flags atomically (thus avoiding possible race " "conditions and the need for separate calls)." msgstr "" -#: library/socket.rst:381 +#: library/socket.rst:380 msgid "" "`Secure File Descriptor Handling `_ for a more thorough explanation." msgstr "" -#: library/socket.rst:384 +#: library/socket.rst:383 msgid ":ref:`Availability `: Linux >= 2.6.27." msgstr "" -#: library/socket.rst:405 +#: library/socket.rst:404 msgid "" "Many constants of these forms, documented in the Unix documentation on " "sockets and/or the IP protocol, are also defined in the socket module. They " -"are generally used in arguments to the :meth:`setsockopt` and :meth:" -"`getsockopt` methods of socket objects. In most cases, only those symbols " -"that are defined in the Unix header files are defined; for a few symbols, " -"default values are provided." +"are generally used in arguments to the :meth:`~socket.setsockopt` and :meth:" +"`~socket.getsockopt` methods of socket objects. In most cases, only those " +"symbols that are defined in the Unix header files are defined; for a few " +"symbols, default values are provided." msgstr "" -#: library/socket.rst:412 +#: library/socket.rst:411 msgid "" "``SO_DOMAIN``, ``SO_PROTOCOL``, ``SO_PEERSEC``, ``SO_PASSSEC``, " "``TCP_USER_TIMEOUT``, ``TCP_CONGESTION`` were added." msgstr "" -#: library/socket.rst:416 +#: library/socket.rst:415 msgid "" "On Windows, ``TCP_FASTOPEN``, ``TCP_KEEPCNT`` appear if run-time Windows " "supports." msgstr "" -#: library/socket.rst:420 +#: library/socket.rst:419 msgid "``TCP_NOTSENT_LOWAT`` was added." msgstr "" -#: library/socket.rst:423 +#: library/socket.rst:422 msgid "" "On Windows, ``TCP_KEEPIDLE``, ``TCP_KEEPINTVL`` appear if run-time Windows " "supports." msgstr "" -#: library/socket.rst:426 +#: library/socket.rst:425 msgid "" "``IP_RECVTOS`` was added. Added ``TCP_KEEPALIVE``. On MacOS this constant " "can be used in the same way that ``TCP_KEEPIDLE`` is used on Linux." msgstr "" -#: library/socket.rst:431 +#: library/socket.rst:430 msgid "" "Added ``TCP_CONNECTION_INFO``. On MacOS this constant can be used in the " "same way that ``TCP_INFO`` is used on Linux and BSD." msgstr "" -#: library/socket.rst:435 +#: library/socket.rst:434 msgid "" "Added ``SO_RTABLE`` and ``SO_USER_COOKIE``. On OpenBSD and FreeBSD " "respectively those constants can be used in the same way that ``SO_MARK`` is " @@ -647,165 +646,165 @@ msgid "" "``IP_DROP_SOURCE_MEMBERSHIP``." msgstr "" -#: library/socket.rst:535 library/socket.rst:559 +#: library/socket.rst:534 library/socket.rst:558 msgid "" "Many constants of these forms, documented in the Linux documentation, are " "also defined in the socket module." msgstr "" -#: library/socket.rst:457 +#: library/socket.rst:456 msgid ":ref:`Availability `: Linux >= 2.6.25, NetBSD >= 8." msgstr "" -#: library/socket.rst:461 +#: library/socket.rst:460 msgid "NetBSD support was added." msgstr "" -#: library/socket.rst:467 +#: library/socket.rst:466 msgid "" "CAN_BCM, in the CAN protocol family, is the broadcast manager (BCM) " "protocol. Broadcast manager constants, documented in the Linux " "documentation, are also defined in the socket module." msgstr "" -#: library/socket.rst:506 +#: library/socket.rst:505 msgid ":ref:`Availability `: Linux >= 2.6.25." msgstr "" -#: library/socket.rst:474 +#: library/socket.rst:473 msgid "" "The :data:`CAN_BCM_CAN_FD_FRAME` flag is only available on Linux >= 4.8." msgstr "" -#: library/socket.rst:480 +#: library/socket.rst:479 msgid "" "Enables CAN FD support in a CAN_RAW socket. This is disabled by default. " "This allows your application to send both CAN and CAN FD frames; however, " "you must accept both CAN and CAN FD frames when reading from the socket." msgstr "" -#: library/socket.rst:495 +#: library/socket.rst:494 msgid "This constant is documented in the Linux documentation." msgstr "" -#: library/socket.rst:486 +#: library/socket.rst:485 msgid ":ref:`Availability `: Linux >= 3.6." msgstr "" -#: library/socket.rst:492 +#: library/socket.rst:491 msgid "" "Joins the applied CAN filters such that only CAN frames that match all given " "CAN filters are passed to user space." msgstr "" -#: library/socket.rst:497 +#: library/socket.rst:496 msgid ":ref:`Availability `: Linux >= 4.1." msgstr "" -#: library/socket.rst:503 +#: library/socket.rst:502 msgid "" "CAN_ISOTP, in the CAN protocol family, is the ISO-TP (ISO 15765-2) protocol. " "ISO-TP constants, documented in the Linux documentation." msgstr "" -#: library/socket.rst:512 +#: library/socket.rst:511 msgid "" "CAN_J1939, in the CAN protocol family, is the SAE J1939 protocol. J1939 " "constants, documented in the Linux documentation." msgstr "" -#: library/socket.rst:515 +#: library/socket.rst:514 msgid ":ref:`Availability `: Linux >= 5.4." msgstr "" -#: library/socket.rst:523 +#: library/socket.rst:522 msgid "" "These two constants, documented in the FreeBSD divert(4) manual page, are " "also defined in the socket module." msgstr "" -#: library/socket.rst:526 +#: library/socket.rst:525 msgid ":ref:`Availability `: FreeBSD >= 14.0." msgstr "" -#: library/socket.rst:543 +#: library/socket.rst:542 msgid "" ":data:`!ETH_P_ALL` can be used in the :class:`~socket.socket` constructor as " "*proto* for the :const:`AF_PACKET` family in order to capture every packet, " "regardless of protocol." msgstr "" -#: library/socket.rst:547 +#: library/socket.rst:546 msgid "For more information, see the :manpage:`packet(7)` manpage." msgstr "" -#: library/socket.rst:549 +#: library/socket.rst:548 msgid ":ref:`Availability `: Linux." msgstr "" -#: library/socket.rst:562 +#: library/socket.rst:561 msgid ":ref:`Availability `: Linux >= 2.6.30." msgstr "" -#: library/socket.rst:572 +#: library/socket.rst:571 msgid "" "Constants for Windows' WSAIoctl(). The constants are used as arguments to " "the :meth:`~socket.socket.ioctl` method of socket objects." msgstr "" -#: library/socket.rst:1564 +#: library/socket.rst:1563 msgid "``SIO_LOOPBACK_FAST_PATH`` was added." msgstr "" -#: library/socket.rst:581 +#: library/socket.rst:580 msgid "" "TIPC related constants, matching the ones exported by the C socket API. See " "the TIPC documentation for more information." msgstr "" -#: library/socket.rst:588 +#: library/socket.rst:587 msgid "Constants for Linux Kernel cryptography." msgstr "" -#: library/socket.rst:600 +#: library/socket.rst:599 msgid "Constants for Linux host/guest communication." msgstr "" -#: library/socket.rst:602 +#: library/socket.rst:601 msgid ":ref:`Availability `: Linux >= 4.8." msgstr "" -#: library/socket.rst:608 +#: library/socket.rst:607 msgid ":ref:`Availability `: BSD, macOS." msgstr "" -#: library/socket.rst:614 +#: library/socket.rst:613 msgid "" "This constant contains a boolean value which indicates if IPv6 is supported " "on this platform." msgstr "" -#: library/socket.rst:620 +#: library/socket.rst:619 msgid "" "These are string constants containing Bluetooth addresses with special " "meanings. For example, :const:`BDADDR_ANY` can be used to indicate any " "address when specifying the binding socket with :const:`BTPROTO_RFCOMM`." msgstr "" -#: library/socket.rst:629 +#: library/socket.rst:628 msgid "" "For use with :const:`BTPROTO_HCI`. :const:`HCI_FILTER` is not available for " "NetBSD or DragonFlyBSD. :const:`HCI_TIME_STAMP` and :const:`HCI_DATA_DIR` " "are not available for FreeBSD, NetBSD, or DragonFlyBSD." msgstr "" -#: library/socket.rst:636 +#: library/socket.rst:635 msgid "" "Constant for Qualcomm's IPC router protocol, used to communicate with " "service providing remote processors." msgstr "" -#: library/socket.rst:645 +#: library/socket.rst:644 msgid "" "LOCAL_CREDS and LOCAL_CREDS_PERSISTENT can be used with SOCK_DGRAM, " "SOCK_STREAM sockets, equivalent to Linux/DragonFlyBSD SO_PASSCRED, while " @@ -814,48 +813,48 @@ msgid "" "message type." msgstr "" -#: library/socket.rst:654 +#: library/socket.rst:653 msgid ":ref:`Availability `: FreeBSD." msgstr "" -#: library/socket.rst:658 +#: library/socket.rst:657 msgid "" "Constant to optimize CPU locality, to be used in conjunction with :data:" "`SO_REUSEPORT`." msgstr "" -#: library/socket.rst:678 +#: library/socket.rst:677 msgid "Constants for Windows Hyper-V sockets for host/guest communications." msgstr "" -#: library/socket.rst:887 library/socket.rst:1978 +#: library/socket.rst:886 library/socket.rst:1977 msgid ":ref:`Availability `: Windows." msgstr "" -#: library/socket.rst:691 +#: library/socket.rst:690 msgid "" "`IEEE 802.3 protocol number `_. constants." msgstr "" -#: library/socket.rst:695 +#: library/socket.rst:694 msgid ":ref:`Availability `: Linux, FreeBSD, macOS." msgstr "" -#: library/socket.rst:701 +#: library/socket.rst:700 msgid "Functions" msgstr "" -#: library/socket.rst:704 +#: library/socket.rst:703 msgid "Creating sockets" msgstr "" -#: library/socket.rst:706 +#: library/socket.rst:705 msgid "" "The following functions all create :ref:`socket objects `." msgstr "" -#: library/socket.rst:711 +#: library/socket.rst:710 msgid "" "Create a new socket using the given address family, socket type and protocol " "number. The address family should be :const:`AF_INET` (the default), :const:" @@ -868,7 +867,7 @@ msgid "" "`CAN_J1939`." msgstr "" -#: library/socket.rst:721 +#: library/socket.rst:720 msgid "" "If *fileno* is specified, the values for *family*, *type*, and *proto* are " "auto-detected from the specified file descriptor. Auto-detection can be " @@ -879,81 +878,81 @@ msgid "" "This may help close a detached socket using :meth:`socket.close()`." msgstr "" -#: library/socket.rst:876 library/socket.rst:1477 +#: library/socket.rst:875 library/socket.rst:1476 msgid "The newly created socket is :ref:`non-inheritable `." msgstr "" -#: library/socket.rst:743 +#: library/socket.rst:742 msgid "" "Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " "``self``, ``family``, ``type``, ``protocol``." msgstr "" -#: library/socket.rst:734 +#: library/socket.rst:733 msgid "The AF_CAN family was added. The AF_RDS family was added." msgstr "" -#: library/socket.rst:738 +#: library/socket.rst:737 msgid "The CAN_BCM protocol was added." msgstr "" -#: library/socket.rst:878 +#: library/socket.rst:877 msgid "The returned socket is now non-inheritable." msgstr "" -#: library/socket.rst:744 +#: library/socket.rst:743 msgid "The CAN_ISOTP protocol was added." msgstr "" -#: library/socket.rst:747 +#: library/socket.rst:746 msgid "" "When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied " "to *type* they are cleared, and :attr:`socket.type` will not reflect them. " "They are still passed to the underlying system ``socket()`` call. Therefore," msgstr "" -#: library/socket.rst:759 +#: library/socket.rst:758 msgid "" "will still create a non-blocking socket on OSes that support " "``SOCK_NONBLOCK``, but ``sock.type`` will be set to ``socket.SOCK_STREAM``." msgstr "" -#: library/socket.rst:763 +#: library/socket.rst:762 msgid "The CAN_J1939 protocol was added." msgstr "" -#: library/socket.rst:766 +#: library/socket.rst:765 msgid "The IPPROTO_MPTCP protocol was added." msgstr "" -#: library/socket.rst:771 +#: library/socket.rst:770 msgid "" "Build a pair of connected socket objects using the given address family, " "socket type, and protocol number. Address family, socket type, and protocol " -"number are as for the :func:`.socket` function above. The default family is :" -"const:`AF_UNIX` if defined on the platform; otherwise, the default is :const:" -"`AF_INET`." +"number are as for the :func:`~socket.socket` function above. The default " +"family is :const:`AF_UNIX` if defined on the platform; otherwise, the " +"default is :const:`AF_INET`." msgstr "" -#: library/socket.rst:776 +#: library/socket.rst:775 msgid "The newly created sockets are :ref:`non-inheritable `." msgstr "" -#: library/socket.rst:778 +#: library/socket.rst:777 msgid "" "The returned socket objects now support the whole socket API, rather than a " "subset." msgstr "" -#: library/socket.rst:782 +#: library/socket.rst:781 msgid "The returned sockets are now non-inheritable." msgstr "" -#: library/socket.rst:785 +#: library/socket.rst:784 msgid "Windows support added." msgstr "" -#: library/socket.rst:791 +#: library/socket.rst:790 msgid "" "Connect to a TCP service listening on the internet *address* (a 2-tuple " "``(host, port)``), and return the socket object. This is a higher-level " @@ -964,21 +963,21 @@ msgid "" "IPv4 and IPv6." msgstr "" -#: library/socket.rst:799 +#: library/socket.rst:798 msgid "" "Passing the optional *timeout* parameter will set the timeout on the socket " "instance before attempting to connect. If no *timeout* is supplied, the " "global default timeout setting returned by :func:`getdefaulttimeout` is used." msgstr "" -#: library/socket.rst:804 +#: library/socket.rst:803 msgid "" "If supplied, *source_address* must be a 2-tuple ``(host, port)`` for the " "socket to bind to as its source address before connecting. If host or port " "are '' or 0 respectively the OS default behavior will be used." msgstr "" -#: library/socket.rst:808 +#: library/socket.rst:807 msgid "" "When a connection cannot be created, an exception is raised. By default, it " "is the exception from the last address in the list. If *all_errors* is " @@ -986,21 +985,21 @@ msgid "" "attempts." msgstr "" -#: library/socket.rst:813 +#: library/socket.rst:812 msgid "*source_address* was added." msgstr "" -#: library/socket.rst:816 +#: library/socket.rst:815 msgid "*all_errors* was added." msgstr "" -#: library/socket.rst:822 +#: library/socket.rst:821 msgid "" "Convenience function which creates a TCP socket bound to *address* (a 2-" "tuple ``(host, port)``) and returns the socket object." msgstr "" -#: library/socket.rst:825 +#: library/socket.rst:824 msgid "" "*family* should be either :data:`AF_INET` or :data:`AF_INET6`. *backlog* is " "the queue size passed to :meth:`socket.listen`; if not specified , a default " @@ -1008,7 +1007,7 @@ msgid "" "`SO_REUSEPORT` socket option." msgstr "" -#: library/socket.rst:830 +#: library/socket.rst:829 msgid "" "If *dualstack_ipv6* is true and the platform supports it the socket will be " "able to accept both IPv4 and IPv6 connections, else it will raise :exc:" @@ -1021,60 +1020,60 @@ msgid "" "func:`has_dualstack_ipv6`:" msgstr "" -#: library/socket.rst:852 +#: library/socket.rst:851 msgid "" "On POSIX platforms the :data:`SO_REUSEADDR` socket option is set in order to " "immediately reuse previous sockets which were bound on the same *address* " "and remained in TIME_WAIT state." msgstr "" -#: library/socket.rst:860 +#: library/socket.rst:859 msgid "" "Return ``True`` if the platform supports creating a TCP socket which can " "handle both IPv4 and IPv6 connections." msgstr "" -#: library/socket.rst:867 +#: library/socket.rst:866 msgid "" "Duplicate the file descriptor *fd* (an integer as returned by a file " "object's :meth:`~io.IOBase.fileno` method) and build a socket object from " "the result. Address family, socket type and protocol number are as for the :" -"func:`.socket` function above. The file descriptor should refer to a socket, " -"but this is not checked --- subsequent operations on the object may fail if " -"the file descriptor is invalid. This function is rarely needed, but can be " -"used to get or set socket options on a socket passed to a program as " +"func:`~socket.socket` function above. The file descriptor should refer to a " +"socket, but this is not checked --- subsequent operations on the object may " +"fail if the file descriptor is invalid. This function is rarely needed, but " +"can be used to get or set socket options on a socket passed to a program as " "standard input or output (such as a server started by the Unix inet " "daemon). The socket is assumed to be in blocking mode." msgstr "" -#: library/socket.rst:884 +#: library/socket.rst:883 msgid "" "Instantiate a socket from data obtained from the :meth:`socket.share` " "method. The socket is assumed to be in blocking mode." msgstr "" -#: library/socket.rst:894 +#: library/socket.rst:893 msgid "" "This is a Python type object that represents the socket object type. It is " "the same as ``type(socket(...))``." msgstr "" -#: library/socket.rst:899 +#: library/socket.rst:898 msgid "Other functions" msgstr "" -#: library/socket.rst:901 +#: library/socket.rst:900 msgid "The :mod:`socket` module also offers various network-related services:" msgstr "" -#: library/socket.rst:906 +#: library/socket.rst:905 msgid "" "Close a socket file descriptor. This is like :func:`os.close`, but for " "sockets. On some platforms (most noticeable Windows) :func:`os.close` does " "not work for socket file descriptors." msgstr "" -#: library/socket.rst:914 +#: library/socket.rst:913 msgid "" "Translate the *host*/*port* argument into a sequence of 5-tuples that " "contain all the necessary arguments for creating a socket connected to that " @@ -1084,7 +1083,7 @@ msgid "" "and *port*, you can pass ``NULL`` to the underlying C API." msgstr "" -#: library/socket.rst:921 +#: library/socket.rst:920 msgid "" "The *family*, *type* and *proto* arguments can be optionally specified in " "order to narrow the list of addresses returned. Passing zero as a value for " @@ -1095,50 +1094,50 @@ msgid "" "domain name." msgstr "" -#: library/socket.rst:929 +#: library/socket.rst:928 msgid "The function returns a list of 5-tuples with the following structure:" msgstr "" -#: library/socket.rst:931 +#: library/socket.rst:930 msgid "``(family, type, proto, canonname, sockaddr)``" msgstr "" -#: library/socket.rst:933 +#: library/socket.rst:932 msgid "" "In these tuples, *family*, *type*, *proto* are all integers and are meant to " -"be passed to the :func:`.socket` function. *canonname* will be a string " -"representing the canonical name of the *host* if :const:`AI_CANONNAME` is " -"part of the *flags* argument; else *canonname* will be empty. *sockaddr* is " -"a tuple describing a socket address, whose format depends on the returned " -"*family* (a ``(address, port)`` 2-tuple for :const:`AF_INET`, a ``(address, " -"port, flowinfo, scope_id)`` 4-tuple for :const:`AF_INET6`), and is meant to " -"be passed to the :meth:`socket.connect` method." +"be passed to the :func:`~socket.socket` function. *canonname* will be a " +"string representing the canonical name of the *host* if :const:" +"`AI_CANONNAME` is part of the *flags* argument; else *canonname* will be " +"empty. *sockaddr* is a tuple describing a socket address, whose format " +"depends on the returned *family* (a ``(address, port)`` 2-tuple for :const:" +"`AF_INET`, a ``(address, port, flowinfo, scope_id)`` 4-tuple for :const:" +"`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." msgstr "" -#: library/socket.rst:954 +#: library/socket.rst:953 msgid "" "Raises an :ref:`auditing event ` ``socket.getaddrinfo`` with " "arguments ``host``, ``port``, ``family``, ``type``, ``protocol``." msgstr "" -#: library/socket.rst:945 +#: library/socket.rst:944 msgid "" "The following example fetches address information for a hypothetical TCP " "connection to ``example.org`` on port 80 (results may differ on your system " "if IPv6 isn't enabled)::" msgstr "" -#: library/socket.rst:955 +#: library/socket.rst:954 msgid "parameters can now be passed using keyword arguments." msgstr "" -#: library/socket.rst:958 +#: library/socket.rst:957 msgid "" "for IPv6 multicast addresses, string representing an address will not " "contain ``%scope_id`` part." msgstr "" -#: library/socket.rst:964 +#: library/socket.rst:963 msgid "" "Return a fully qualified domain name for *name*. If *name* is omitted or " "empty, it is interpreted as the local host. To find the fully qualified " @@ -1149,7 +1148,7 @@ msgid "" "``'0.0.0.0'``, the hostname from :func:`gethostname` is returned." msgstr "" -#: library/socket.rst:975 +#: library/socket.rst:974 msgid "" "Translate a host name to IPv4 address format. The IPv4 address is returned " "as a string, such as ``'100.50.200.5'``. If the host name is an IPv4 " @@ -1159,19 +1158,19 @@ msgid "" "stack support." msgstr "" -#: library/socket.rst:1008 +#: library/socket.rst:1007 msgid "" "Raises an :ref:`auditing event ` ``socket.gethostbyname`` with " "argument ``hostname``." msgstr "" -#: library/socket.rst:999 library/socket.rst:1027 library/socket.rst:1055 -#: library/socket.rst:1077 library/socket.rst:1448 library/socket.rst:1482 -#: library/socket.rst:1574 library/socket.rst:1966 +#: library/socket.rst:998 library/socket.rst:1026 library/socket.rst:1054 +#: library/socket.rst:1076 library/socket.rst:1447 library/socket.rst:1481 +#: library/socket.rst:1573 library/socket.rst:1965 msgid ":ref:`Availability `: not WASI." msgstr "" -#: library/socket.rst:988 +#: library/socket.rst:987 msgid "" "Translate a host name to IPv4 address format, extended interface. Return a 3-" "tuple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the host's " @@ -1183,25 +1182,25 @@ msgid "" "stack support." msgstr "" -#: library/socket.rst:1004 +#: library/socket.rst:1003 msgid "" "Return a string containing the hostname of the machine where the Python " "interpreter is currently executing." msgstr "" -#: library/socket.rst:1018 +#: library/socket.rst:1017 msgid "" "Raises an :ref:`auditing event ` ``socket.gethostname`` with no " "arguments." msgstr "" -#: library/socket.rst:1009 +#: library/socket.rst:1008 msgid "" "Note: :func:`gethostname` doesn't always return the fully qualified domain " "name; use :func:`getfqdn` for that." msgstr "" -#: library/socket.rst:1017 +#: library/socket.rst:1016 msgid "" "Return a 3-tuple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is " "the primary host name responding to the given *ip_address*, *aliaslist* is a " @@ -1212,13 +1211,13 @@ msgid "" "`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" -#: library/socket.rst:1036 +#: library/socket.rst:1035 msgid "" "Raises an :ref:`auditing event ` ``socket.gethostbyaddr`` with " "argument ``ip_address``." msgstr "" -#: library/socket.rst:1032 +#: library/socket.rst:1031 msgid "" "Translate a socket address *sockaddr* into a 2-tuple ``(host, port)``. " "Depending on the settings of *flags*, the result can contain a fully " @@ -1226,92 +1225,92 @@ msgid "" "Similarly, *port* can contain a string port name or a numeric port number." msgstr "" -#: library/socket.rst:1037 +#: library/socket.rst:1036 msgid "" "For IPv6 addresses, ``%scope_id`` is appended to the host part if *sockaddr* " "contains meaningful *scope_id*. Usually this happens for multicast addresses." msgstr "" -#: library/socket.rst:1040 +#: library/socket.rst:1039 msgid "" "For more information about *flags* you can consult :manpage:`getnameinfo(3)`." msgstr "" -#: library/socket.rst:1053 +#: library/socket.rst:1052 msgid "" "Raises an :ref:`auditing event ` ``socket.getnameinfo`` with " "argument ``sockaddr``." msgstr "" -#: library/socket.rst:1049 +#: library/socket.rst:1048 msgid "" "Translate an internet protocol name (for example, ``'icmp'``) to a constant " -"suitable for passing as the (optional) third argument to the :func:`.socket` " -"function. This is usually only needed for sockets opened in \"raw\" mode (:" -"const:`SOCK_RAW`); for the normal socket modes, the correct protocol is " -"chosen automatically if the protocol is omitted or zero." +"suitable for passing as the (optional) third argument to the :func:`~socket." +"socket` function. This is usually only needed for sockets opened in \"raw\" " +"mode (:const:`SOCK_RAW`); for the normal socket modes, the correct protocol " +"is chosen automatically if the protocol is omitted or zero." msgstr "" -#: library/socket.rst:1060 +#: library/socket.rst:1059 msgid "" "Translate an internet service name and protocol name to a port number for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" -#: library/socket.rst:1075 +#: library/socket.rst:1074 msgid "" "Raises an :ref:`auditing event ` ``socket.getservbyname`` with " "arguments ``servicename``, ``protocolname``." msgstr "" -#: library/socket.rst:1071 +#: library/socket.rst:1070 msgid "" "Translate an internet port number and protocol name to a service name for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" -#: library/socket.rst:1086 +#: library/socket.rst:1085 msgid "" "Raises an :ref:`auditing event ` ``socket.getservbyport`` with " "arguments ``port``, ``protocolname``." msgstr "" -#: library/socket.rst:1082 +#: library/socket.rst:1081 msgid "" "Convert 32-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" -#: library/socket.rst:1089 +#: library/socket.rst:1088 msgid "" "Convert 16-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" -#: library/socket.rst:1111 +#: library/socket.rst:1110 msgid "" "Raises :exc:`OverflowError` if *x* does not fit in a 16-bit unsigned integer." msgstr "" -#: library/socket.rst:1100 +#: library/socket.rst:1099 msgid "" "Convert 32-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" -#: library/socket.rst:1107 +#: library/socket.rst:1106 msgid "" "Convert 16-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" -#: library/socket.rst:1118 +#: library/socket.rst:1117 msgid "" "Convert an IPv4 address from dotted-quad string format (for example, " "'123.45.67.89') to 32-bit packed binary format, as a bytes object four " @@ -1320,26 +1319,26 @@ msgid "" "which is the C type for the 32-bit packed binary this function returns." msgstr "" -#: library/socket.rst:1124 +#: library/socket.rst:1123 msgid "" ":func:`inet_aton` also accepts strings with less than three dots; see the " "Unix manual page :manpage:`inet(3)` for details." msgstr "" -#: library/socket.rst:1127 +#: library/socket.rst:1126 msgid "" "If the IPv4 address string passed to this function is invalid, :exc:" "`OSError` will be raised. Note that exactly what is valid depends on the " "underlying C implementation of :c:func:`inet_aton`." msgstr "" -#: library/socket.rst:1131 +#: library/socket.rst:1130 msgid "" ":func:`inet_aton` does not support IPv6, and :func:`inet_pton` should be " "used instead for IPv4/v6 dual stack support." msgstr "" -#: library/socket.rst:1137 +#: library/socket.rst:1136 msgid "" "Convert a 32-bit packed IPv4 address (a :term:`bytes-like object` four bytes " "in length) to its standard dotted-quad string representation (for example, " @@ -1349,7 +1348,7 @@ msgid "" "argument." msgstr "" -#: library/socket.rst:1144 +#: library/socket.rst:1143 msgid "" "If the byte sequence passed to this function is not exactly 4 bytes in " "length, :exc:`OSError` will be raised. :func:`inet_ntoa` does not support " @@ -1357,7 +1356,7 @@ msgid "" "support." msgstr "" -#: library/socket.rst:1155 +#: library/socket.rst:1154 msgid "" "Convert an IP address from its family-specific string format to a packed, " "binary format. :func:`inet_pton` is useful when a library or network " @@ -1365,7 +1364,7 @@ msgid "" "`inet_aton`) or :c:struct:`in6_addr`." msgstr "" -#: library/socket.rst:1160 +#: library/socket.rst:1159 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the IP address string *ip_string* is invalid, :exc:" @@ -1374,15 +1373,15 @@ msgid "" "`inet_pton`." msgstr "" -#: library/socket.rst:1186 +#: library/socket.rst:1185 msgid ":ref:`Availability `: Unix, Windows." msgstr "" -#: library/socket.rst:1188 +#: library/socket.rst:1187 msgid "Windows support added" msgstr "" -#: library/socket.rst:1174 +#: library/socket.rst:1173 msgid "" "Convert a packed IP address (a :term:`bytes-like object` of some number of " "bytes) to its standard, family-specific string representation (for example, " @@ -1391,7 +1390,7 @@ msgid "" "(similar to :func:`inet_ntoa`) or :c:struct:`in6_addr`." msgstr "" -#: library/socket.rst:1181 +#: library/socket.rst:1180 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the bytes object *packed_ip* is not the correct length " @@ -1399,7 +1398,7 @@ msgid "" "`OSError` is raised for errors from the call to :func:`inet_ntop`." msgstr "" -#: library/socket.rst:1203 +#: library/socket.rst:1202 msgid "" "Return the total length, without trailing padding, of an ancillary data item " "with associated data of the given *length*. This value can often be used as " @@ -1410,15 +1409,15 @@ msgid "" "the permissible range of values." msgstr "" -#: library/socket.rst:1235 +#: library/socket.rst:1234 msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." msgstr "" -#: library/socket.rst:1704 library/socket.rst:1856 +#: library/socket.rst:1703 library/socket.rst:1855 msgid "Most Unix platforms." msgstr "" -#: library/socket.rst:1221 +#: library/socket.rst:1220 msgid "" "Return the buffer size needed for :meth:`~socket.recvmsg` to receive an " "ancillary data item with associated data of the given *length*, along with " @@ -1428,7 +1427,7 @@ msgid "" "values." msgstr "" -#: library/socket.rst:1229 +#: library/socket.rst:1228 msgid "" "Note that some systems might support ancillary data without providing this " "function. Also note that setting the buffer size using the results of this " @@ -1436,140 +1435,140 @@ msgid "" "received, since additional data may be able to fit into the padding area." msgstr "" -#: library/socket.rst:1237 +#: library/socket.rst:1236 msgid "most Unix platforms." msgstr "" -#: library/socket.rst:1244 +#: library/socket.rst:1243 msgid "" "Return the default timeout in seconds (float) for new socket objects. A " "value of ``None`` indicates that new socket objects have no timeout. When " "the socket module is first imported, the default is ``None``." msgstr "" -#: library/socket.rst:1251 +#: library/socket.rst:1250 msgid "" "Set the default timeout in seconds (float) for new socket objects. When the " "socket module is first imported, the default is ``None``. See :meth:" "`~socket.settimeout` for possible values and their respective meanings." msgstr "" -#: library/socket.rst:1259 +#: library/socket.rst:1258 msgid "" "Set the machine's hostname to *name*. This will raise an :exc:`OSError` if " "you don't have enough rights." msgstr "" -#: library/socket.rst:1273 +#: library/socket.rst:1272 msgid "" "Raises an :ref:`auditing event ` ``socket.sethostname`` with " "argument ``name``." msgstr "" -#: library/socket.rst:1702 library/socket.rst:1746 +#: library/socket.rst:1701 library/socket.rst:1745 msgid ":ref:`Availability `: Unix." msgstr "" -#: library/socket.rst:1271 +#: library/socket.rst:1270 msgid "" "Return a list of network interface information (index int, name string) " "tuples. :exc:`OSError` if the system call fails." msgstr "" -#: library/socket.rst:1302 library/socket.rst:1336 library/socket.rst:1350 +#: library/socket.rst:1301 library/socket.rst:1335 library/socket.rst:1349 msgid "" ":ref:`Availability `: Unix, Windows, not Emscripten, not WASI." msgstr "" -#: library/socket.rst:1306 library/socket.rst:1323 +#: library/socket.rst:1305 library/socket.rst:1322 msgid "Windows support was added." msgstr "" -#: library/socket.rst:1284 +#: library/socket.rst:1283 msgid "" "On Windows network interfaces have different names in different contexts " "(all names are examples):" msgstr "" -#: library/socket.rst:1287 +#: library/socket.rst:1286 msgid "UUID: ``{FB605B73-AAC2-49A6-9A2F-25416AEA0573}``" msgstr "" -#: library/socket.rst:1288 +#: library/socket.rst:1287 msgid "name: ``ethernet_32770``" msgstr "" -#: library/socket.rst:1289 +#: library/socket.rst:1288 msgid "friendly name: ``vEthernet (nat)``" msgstr "" -#: library/socket.rst:1290 +#: library/socket.rst:1289 msgid "description: ``Hyper-V Virtual Ethernet Adapter``" msgstr "" -#: library/socket.rst:1292 +#: library/socket.rst:1291 msgid "" "This function returns names of the second form from the list, " "``ethernet_32770`` in this example case." msgstr "" -#: library/socket.rst:1298 +#: library/socket.rst:1297 msgid "" "Return a network interface index number corresponding to an interface name. :" "exc:`OSError` if no interface with the given name exists." msgstr "" -#: library/socket.rst:1327 +#: library/socket.rst:1326 msgid "\"Interface name\" is a name as documented in :func:`if_nameindex`." msgstr "" -#: library/socket.rst:1315 +#: library/socket.rst:1314 msgid "" "Return a network interface name corresponding to an interface index number. :" "exc:`OSError` if no interface with the given index exists." msgstr "" -#: library/socket.rst:1332 +#: library/socket.rst:1331 msgid "" "Send the list of file descriptors *fds* over an :const:`AF_UNIX` socket " "*sock*. The *fds* parameter is a sequence of file descriptors. Consult :meth:" -"`sendmsg` for the documentation of these parameters." +"`~socket.sendmsg` for the documentation of these parameters." msgstr "" -#: library/socket.rst:1352 +#: library/socket.rst:1351 msgid "" "Unix platforms supporting :meth:`~socket.sendmsg` and :const:`SCM_RIGHTS` " "mechanism." msgstr "" -#: library/socket.rst:1346 +#: library/socket.rst:1345 msgid "" "Receive up to *maxfds* file descriptors from an :const:`AF_UNIX` socket " -"*sock*. Return ``(msg, list(fds), flags, addr)``. Consult :meth:`recvmsg` " -"for the documentation of these parameters." +"*sock*. Return ``(msg, list(fds), flags, addr)``. Consult :meth:`~socket." +"recvmsg` for the documentation of these parameters." msgstr "" -#: library/socket.rst:1359 +#: library/socket.rst:1358 msgid "Any truncated integers at the end of the list of file descriptors." msgstr "" -#: library/socket.rst:1365 +#: library/socket.rst:1364 msgid "Socket Objects" msgstr "" -#: library/socket.rst:1367 +#: library/socket.rst:1366 msgid "" "Socket objects have the following methods. Except for :meth:`~socket." "makefile`, these correspond to Unix system calls applicable to sockets." msgstr "" -#: library/socket.rst:1371 +#: library/socket.rst:1370 msgid "" "Support for the :term:`context manager` protocol was added. Exiting the " "context manager is equivalent to calling :meth:`~socket.close`." msgstr "" -#: library/socket.rst:1378 +#: library/socket.rst:1377 msgid "" "Accept a connection. The socket must be bound to an address and listening " "for connections. The return value is a pair ``(conn, address)`` where *conn* " @@ -1578,31 +1577,31 @@ msgid "" "connection." msgstr "" -#: library/socket.rst:1479 +#: library/socket.rst:1478 msgid "The socket is now non-inheritable." msgstr "" -#: library/socket.rst:1617 library/socket.rst:1708 library/socket.rst:1800 -#: library/socket.rst:1862 +#: library/socket.rst:1616 library/socket.rst:1707 library/socket.rst:1799 +#: library/socket.rst:1861 msgid "" "If the system call is interrupted and the signal handler does not raise an " "exception, the method now retries the system call instead of raising an :exc:" "`InterruptedError` exception (see :pep:`475` for the rationale)." msgstr "" -#: library/socket.rst:1396 +#: library/socket.rst:1395 msgid "" "Bind the socket to *address*. The socket must not already be bound. (The " "format of *address* depends on the address family --- see above.)" msgstr "" -#: library/socket.rst:1410 +#: library/socket.rst:1409 msgid "" "Raises an :ref:`auditing event ` ``socket.bind`` with arguments " "``self``, ``address``." msgstr "" -#: library/socket.rst:1406 +#: library/socket.rst:1405 msgid "" "Mark the socket closed. The underlying system resource (e.g. a file " "descriptor) is also closed when all file objects from :meth:`makefile()` are " @@ -1611,20 +1610,20 @@ msgid "" "flushed)." msgstr "" -#: library/socket.rst:1412 +#: library/socket.rst:1411 msgid "" "Sockets are automatically closed when they are garbage-collected, but it is " "recommended to :meth:`close` them explicitly, or to use a :keyword:`with` " "statement around them." msgstr "" -#: library/socket.rst:1416 +#: library/socket.rst:1415 msgid "" ":exc:`OSError` is now raised if an error occurs when the underlying :c:func:" "`close` call is made." msgstr "" -#: library/socket.rst:1422 +#: library/socket.rst:1421 msgid "" ":meth:`close()` releases the resource associated with a connection but does " "not necessarily close the connection immediately. If you want to close the " @@ -1632,13 +1631,13 @@ msgid "" "`close()`." msgstr "" -#: library/socket.rst:1430 +#: library/socket.rst:1429 msgid "" "Connect to a remote socket at *address*. (The format of *address* depends on " "the address family --- see above.)" msgstr "" -#: library/socket.rst:1433 +#: library/socket.rst:1432 msgid "" "If the connection is interrupted by a signal, the method waits until the " "connection completes, or raise a :exc:`TimeoutError` on timeout, if the " @@ -1648,13 +1647,13 @@ msgid "" "(or the exception raised by the signal handler)." msgstr "" -#: library/socket.rst:1471 +#: library/socket.rst:1470 msgid "" "Raises an :ref:`auditing event ` ``socket.connect`` with arguments " "``self``, ``address``." msgstr "" -#: library/socket.rst:1442 +#: library/socket.rst:1441 msgid "" "The method now waits until the connection completes instead of raising an :" "exc:`InterruptedError` exception if the connection is interrupted by a " @@ -1662,7 +1661,7 @@ msgid "" "blocking or has a timeout (see the :pep:`475` for the rationale)." msgstr "" -#: library/socket.rst:1453 +#: library/socket.rst:1452 msgid "" "Like ``connect(address)``, but return an error indicator instead of raising " "an exception for errors returned by the C-level :c:func:`connect` call " @@ -1672,38 +1671,38 @@ msgid "" "asynchronous connects." msgstr "" -#: library/socket.rst:1466 +#: library/socket.rst:1465 msgid "" "Put the socket object into closed state without actually closing the " "underlying file descriptor. The file descriptor is returned, and can be " "reused for other purposes." msgstr "" -#: library/socket.rst:1475 +#: library/socket.rst:1474 msgid "Duplicate the socket." msgstr "" -#: library/socket.rst:1487 +#: library/socket.rst:1486 msgid "" "Return the socket's file descriptor (a small integer), or -1 on failure. " "This is useful with :func:`select.select`." msgstr "" -#: library/socket.rst:1490 +#: library/socket.rst:1489 msgid "" "Under Windows the small integer returned by this method cannot be used where " "a file descriptor can be used (such as :func:`os.fdopen`). Unix does not " "have this limitation." msgstr "" -#: library/socket.rst:1496 +#: library/socket.rst:1495 msgid "" "Get the :ref:`inheritable flag ` of the socket's file " "descriptor or socket's handle: ``True`` if the socket can be inherited in " "child processes, ``False`` if it cannot." msgstr "" -#: library/socket.rst:1505 +#: library/socket.rst:1504 msgid "" "Return the remote address to which the socket is connected. This is useful " "to find out the port number of a remote IPv4/v6 socket, for instance. (The " @@ -1711,14 +1710,14 @@ msgid "" "above.) On some systems this function is not supported." msgstr "" -#: library/socket.rst:1513 +#: library/socket.rst:1512 msgid "" "Return the socket's own address. This is useful to find out the port number " "of an IPv4/v6 socket, for instance. (The format of the address returned " "depends on the address family --- see above.)" msgstr "" -#: library/socket.rst:1520 +#: library/socket.rst:1519 msgid "" "Return the value of the given socket option (see the Unix man page :manpage:" "`getsockopt(2)`). The needed symbolic constants (:const:`SO_\\*` etc.) are " @@ -1730,16 +1729,16 @@ msgid "" "`struct` for a way to decode C structures encoded as byte strings)." msgstr "" -#: library/socket.rst:1534 +#: library/socket.rst:1533 msgid "" "Return ``True`` if socket is in blocking mode, ``False`` if in non-blocking." msgstr "" -#: library/socket.rst:1537 +#: library/socket.rst:1536 msgid "This is equivalent to checking ``socket.gettimeout() != 0``." msgstr "" -#: library/socket.rst:1544 +#: library/socket.rst:1543 msgid "" "Return the timeout in seconds (float) associated with socket operations, or " "``None`` if no timeout is set. This reflects the last call to :meth:" @@ -1750,30 +1749,30 @@ msgstr "" msgid "platform" msgstr "" -#: library/socket.rst:1551 +#: library/socket.rst:1550 msgid "Windows" msgstr "" -#: library/socket.rst:1553 +#: library/socket.rst:1552 msgid "" "The :meth:`ioctl` method is a limited interface to the WSAIoctl system " "interface. Please refer to the `Win32 documentation `_ for more information." msgstr "" -#: library/socket.rst:1558 +#: library/socket.rst:1557 msgid "" "On other platforms, the generic :func:`fcntl.fcntl` and :func:`fcntl.ioctl` " "functions may be used; they accept a socket object as their first argument." msgstr "" -#: library/socket.rst:1561 +#: library/socket.rst:1560 msgid "" "Currently only the following control codes are supported: ``SIO_RCVALL``, " "``SIO_KEEPALIVE_VALS``, and ``SIO_LOOPBACK_FAST_PATH``." msgstr "" -#: library/socket.rst:1569 +#: library/socket.rst:1568 msgid "" "Enable a server to accept connections. If *backlog* is specified, it must " "be at least 0 (if it is lower, it is set to 0); it specifies the number of " @@ -1781,11 +1780,11 @@ msgid "" "connections. If not specified, a default reasonable value is chosen." msgstr "" -#: library/socket.rst:1576 +#: library/socket.rst:1575 msgid "The *backlog* parameter is now optional." msgstr "" -#: library/socket.rst:1585 +#: library/socket.rst:1584 msgid "" "Return a :term:`file object` associated with the socket. The exact returned " "type depends on the arguments given to :meth:`makefile`. These arguments " @@ -1794,28 +1793,28 @@ msgid "" "``'b'``." msgstr "" -#: library/socket.rst:1590 +#: library/socket.rst:1589 msgid "" "The socket must be in blocking mode; it can have a timeout, but the file " "object's internal buffer may end up in an inconsistent state if a timeout " "occurs." msgstr "" -#: library/socket.rst:1594 +#: library/socket.rst:1593 msgid "" "Closing the file object returned by :meth:`makefile` won't close the " "original socket unless all other file objects have been closed and :meth:" "`socket.close` has been called on the socket object." msgstr "" -#: library/socket.rst:1600 +#: library/socket.rst:1599 msgid "" "On Windows, the file-like object created by :meth:`makefile` cannot be used " "where a file object with a file descriptor is expected, such as the stream " "arguments of :meth:`subprocess.Popen`." msgstr "" -#: library/socket.rst:1607 +#: library/socket.rst:1606 msgid "" "Receive data from the socket. The return value is a bytes object " "representing the data received. The maximum amount of data to be received " @@ -1824,13 +1823,13 @@ msgid "" "zero." msgstr "" -#: library/socket.rst:1614 +#: library/socket.rst:1613 msgid "" "For best match with hardware and network realities, the value of *bufsize* " "should be a relatively small power of 2, for example, 4096." msgstr "" -#: library/socket.rst:1625 +#: library/socket.rst:1624 msgid "" "Receive data from the socket. The return value is a pair ``(bytes, " "address)`` where *bytes* is a bytes object representing the data received " @@ -1840,14 +1839,14 @@ msgid "" "address family --- see above.)" msgstr "" -#: library/socket.rst:1636 +#: library/socket.rst:1635 msgid "" "For multicast IPv6 address, first item of *address* does not contain " "``%scope_id`` part anymore. In order to get full IPv6 address use :func:" "`getnameinfo`." msgstr "" -#: library/socket.rst:1643 +#: library/socket.rst:1642 msgid "" "Receive normal data (up to *bufsize* bytes) and ancillary data from the " "socket. The *ancbufsize* argument sets the size in bytes of the internal " @@ -1858,7 +1857,7 @@ msgid "" "*flags* argument defaults to 0 and has the same meaning as for :meth:`recv`." msgstr "" -#: library/socket.rst:1653 +#: library/socket.rst:1652 msgid "" "The return value is a 4-tuple: ``(data, ancdata, msg_flags, address)``. The " "*data* item is a :class:`bytes` object holding the non-ancillary data " @@ -1873,7 +1872,7 @@ msgid "" "socket, if available; otherwise, its value is unspecified." msgstr "" -#: library/socket.rst:1667 +#: library/socket.rst:1666 msgid "" "On some systems, :meth:`sendmsg` and :meth:`recvmsg` can be used to pass " "file descriptors between processes over an :const:`AF_UNIX` socket. When " @@ -1886,7 +1885,7 @@ msgid "" "descriptors received via this mechanism." msgstr "" -#: library/socket.rst:1678 +#: library/socket.rst:1677 msgid "" "Some systems do not indicate the truncated length of ancillary data items " "which have been only partially received. If an item appears to extend " @@ -1895,7 +1894,7 @@ msgid "" "provided it has not been truncated before the start of its associated data." msgstr "" -#: library/socket.rst:1685 +#: library/socket.rst:1684 msgid "" "On systems which support the :const:`SCM_RIGHTS` mechanism, the following " "function will receive up to *maxfds* file descriptors, returning the message " @@ -1904,7 +1903,7 @@ msgid "" "meth:`sendmsg`. ::" msgstr "" -#: library/socket.rst:1716 +#: library/socket.rst:1715 msgid "" "Receive normal data and ancillary data from the socket, behaving as :meth:" "`recvmsg` would, but scatter the non-ancillary data into a series of buffers " @@ -1917,7 +1916,7 @@ msgid "" "arguments have the same meaning as for :meth:`recvmsg`." msgstr "" -#: library/socket.rst:1727 +#: library/socket.rst:1726 msgid "" "The return value is a 4-tuple: ``(nbytes, ancdata, msg_flags, address)``, " "where *nbytes* is the total number of bytes of non-ancillary data written " @@ -1925,11 +1924,11 @@ msgid "" "for :meth:`recvmsg`." msgstr "" -#: library/socket.rst:1732 +#: library/socket.rst:1731 msgid "Example::" msgstr "" -#: library/socket.rst:1755 +#: library/socket.rst:1754 msgid "" "Receive data from the socket, writing it into *buffer* instead of creating a " "new bytestring. The return value is a pair ``(nbytes, address)`` where " @@ -1939,7 +1938,7 @@ msgid "" "format of *address* depends on the address family --- see above.)" msgstr "" -#: library/socket.rst:1765 +#: library/socket.rst:1764 msgid "" "Receive up to *nbytes* bytes from the socket, storing the data into a buffer " "rather than creating a new bytestring. If *nbytes* is not specified (or 0), " @@ -1948,7 +1947,7 @@ msgid "" "of the optional argument *flags*; it defaults to zero." msgstr "" -#: library/socket.rst:1774 +#: library/socket.rst:1773 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " @@ -1958,7 +1957,7 @@ msgid "" "data. For further information on this topic, consult the :ref:`socket-howto`." msgstr "" -#: library/socket.rst:1789 +#: library/socket.rst:1788 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " @@ -1968,13 +1967,13 @@ msgid "" "to determine how much data, if any, was successfully sent." msgstr "" -#: library/socket.rst:1796 +#: library/socket.rst:1795 msgid "" "The socket timeout is no longer reset each time data is sent successfully. " "The socket timeout is now the maximum total duration to send all data." msgstr "" -#: library/socket.rst:1809 +#: library/socket.rst:1808 msgid "" "Send data to the socket. The socket should not be connected to a remote " "socket, since the destination socket is specified by *address*. The " @@ -1983,13 +1982,13 @@ msgid "" "address family --- see above.)" msgstr "" -#: library/socket.rst:1826 +#: library/socket.rst:1825 msgid "" "Raises an :ref:`auditing event ` ``socket.sendto`` with arguments " "``self``, ``address``." msgstr "" -#: library/socket.rst:1825 +#: library/socket.rst:1824 msgid "" "Send normal and ancillary data to the socket, gathering the non-ancillary " "data from a series of buffers and concatenating it into a single message. " @@ -2009,31 +2008,31 @@ msgid "" "bytes of non-ancillary data sent." msgstr "" -#: library/socket.rst:1845 +#: library/socket.rst:1844 msgid "" "The following function sends the list of file descriptors *fds* over an :" "const:`AF_UNIX` socket, on systems which support the :const:`SCM_RIGHTS` " "mechanism. See also :meth:`recvmsg`. ::" msgstr "" -#: library/socket.rst:1854 +#: library/socket.rst:1853 msgid ":ref:`Availability `: Unix, not WASI." msgstr "" -#: library/socket.rst:1869 +#: library/socket.rst:1868 msgid "" "Raises an :ref:`auditing event ` ``socket.sendmsg`` with arguments " "``self``, ``address``." msgstr "" -#: library/socket.rst:1869 +#: library/socket.rst:1868 msgid "" "Specialized version of :meth:`~socket.sendmsg` for :const:`AF_ALG` socket. " "Set mode, IV, AEAD associated data length and flags for :const:`AF_ALG` " "socket." msgstr "" -#: library/socket.rst:1878 +#: library/socket.rst:1877 msgid "" "Send a file until EOF is reached by using high-performance :mod:`os." "sendfile` and return the total number of bytes which were sent. *file* must " @@ -2047,38 +2046,38 @@ msgid "" "be of :const:`SOCK_STREAM` type. Non-blocking sockets are not supported." msgstr "" -#: library/socket.rst:1894 +#: library/socket.rst:1893 msgid "" "Set the :ref:`inheritable flag ` of the socket's file " "descriptor or socket's handle." msgstr "" -#: library/socket.rst:1902 +#: library/socket.rst:1901 msgid "" "Set blocking or non-blocking mode of the socket: if *flag* is false, the " "socket is set to non-blocking, else to blocking mode." msgstr "" -#: library/socket.rst:1905 +#: library/socket.rst:1904 msgid "" "This method is a shorthand for certain :meth:`~socket.settimeout` calls:" msgstr "" -#: library/socket.rst:1907 +#: library/socket.rst:1906 msgid "``sock.setblocking(True)`` is equivalent to ``sock.settimeout(None)``" msgstr "" -#: library/socket.rst:1909 +#: library/socket.rst:1908 msgid "``sock.setblocking(False)`` is equivalent to ``sock.settimeout(0.0)``" msgstr "" -#: library/socket.rst:1911 +#: library/socket.rst:1910 msgid "" "The method no longer applies :const:`SOCK_NONBLOCK` flag on :attr:`socket." "type`." msgstr "" -#: library/socket.rst:1918 +#: library/socket.rst:1917 msgid "" "Set a timeout on blocking socket operations. The *value* argument can be a " "nonnegative floating point number expressing seconds, or ``None``. If a non-" @@ -2088,19 +2087,19 @@ msgid "" "blocking mode. If ``None`` is given, the socket is put in blocking mode." msgstr "" -#: library/socket.rst:1925 +#: library/socket.rst:1924 msgid "" "For further information, please consult the :ref:`notes on socket timeouts " "`." msgstr "" -#: library/socket.rst:1927 +#: library/socket.rst:1926 msgid "" "The method no longer toggles :const:`SOCK_NONBLOCK` flag on :attr:`socket." "type`." msgstr "" -#: library/socket.rst:1940 +#: library/socket.rst:1939 msgid "" "Set the value of the given socket option (see the Unix manual page :manpage:" "`setsockopt(2)`). The needed symbolic constants are defined in the :mod:" @@ -2113,11 +2112,11 @@ msgid "" "C function with ``optval=NULL`` and ``optlen=optlen``." msgstr "" -#: library/socket.rst:1953 +#: library/socket.rst:1952 msgid "setsockopt(level, optname, None, optlen: int) form added." msgstr "" -#: library/socket.rst:1961 +#: library/socket.rst:1960 msgid "" "Shut down one or both halves of the connection. If *how* is :const:" "`SHUT_RD`, further receives are disallowed. If *how* is :const:`SHUT_WR`, " @@ -2125,7 +2124,7 @@ msgid "" "and receives are disallowed." msgstr "" -#: library/socket.rst:1971 +#: library/socket.rst:1970 msgid "" "Duplicate a socket and prepare it for sharing with a target process. The " "target process must be provided with *process_id*. The resulting bytes " @@ -2136,48 +2135,48 @@ msgid "" "process." msgstr "" -#: library/socket.rst:1983 +#: library/socket.rst:1982 msgid "" "Note that there are no methods :meth:`read` or :meth:`write`; use :meth:" "`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." msgstr "" -#: library/socket.rst:1986 +#: library/socket.rst:1985 msgid "" "Socket objects also have these (read-only) attributes that correspond to the " "values given to the :class:`~socket.socket` constructor." msgstr "" -#: library/socket.rst:1992 +#: library/socket.rst:1991 msgid "The socket family." msgstr "" -#: library/socket.rst:1997 +#: library/socket.rst:1996 msgid "The socket type." msgstr "" -#: library/socket.rst:2002 +#: library/socket.rst:2001 msgid "The socket protocol." msgstr "" -#: library/socket.rst:2009 +#: library/socket.rst:2008 msgid "Notes on socket timeouts" msgstr "" -#: library/socket.rst:2011 +#: library/socket.rst:2010 msgid "" "A socket object can be in one of three modes: blocking, non-blocking, or " "timeout. Sockets are by default always created in blocking mode, but this " "can be changed by calling :func:`setdefaulttimeout`." msgstr "" -#: library/socket.rst:2015 +#: library/socket.rst:2014 msgid "" "In *blocking mode*, operations block until complete or the system returns an " "error (such as connection timed out)." msgstr "" -#: library/socket.rst:2018 +#: library/socket.rst:2017 msgid "" "In *non-blocking mode*, operations fail (with an error that is unfortunately " "system-dependent) if they cannot be completed immediately: functions from " @@ -2185,14 +2184,14 @@ msgid "" "available for reading or writing." msgstr "" -#: library/socket.rst:2023 +#: library/socket.rst:2022 msgid "" "In *timeout mode*, operations fail if they cannot be completed within the " "timeout specified for the socket (they raise a :exc:`timeout` exception) or " "if the system returns an error." msgstr "" -#: library/socket.rst:2028 +#: library/socket.rst:2027 msgid "" "At the operating system level, sockets in *timeout mode* are internally set " "in non-blocking mode. Also, the blocking and timeout modes are shared " @@ -2201,11 +2200,11 @@ msgid "" "you decide to use the :meth:`~socket.fileno()` of a socket." msgstr "" -#: library/socket.rst:2035 +#: library/socket.rst:2034 msgid "Timeouts and the ``connect`` method" msgstr "" -#: library/socket.rst:2037 +#: library/socket.rst:2036 msgid "" "The :meth:`~socket.connect` operation is also subject to the timeout " "setting, and in general it is recommended to call :meth:`~socket.settimeout` " @@ -2215,24 +2214,24 @@ msgid "" "setting." msgstr "" -#: library/socket.rst:2045 +#: library/socket.rst:2044 msgid "Timeouts and the ``accept`` method" msgstr "" -#: library/socket.rst:2047 +#: library/socket.rst:2046 msgid "" "If :func:`getdefaulttimeout` is not :const:`None`, sockets returned by the :" "meth:`~socket.accept` method inherit that timeout. Otherwise, the behaviour " "depends on settings of the listening socket:" msgstr "" -#: library/socket.rst:2051 +#: library/socket.rst:2050 msgid "" "if the listening socket is in *blocking mode* or in *timeout mode*, the " "socket returned by :meth:`~socket.accept` is in *blocking mode*;" msgstr "" -#: library/socket.rst:2054 +#: library/socket.rst:2053 msgid "" "if the listening socket is in *non-blocking mode*, whether the socket " "returned by :meth:`~socket.accept` is in blocking or non-blocking mode is " @@ -2240,28 +2239,28 @@ msgid "" "it is recommended you manually override this setting." msgstr "" -#: library/socket.rst:2063 +#: library/socket.rst:2062 msgid "Example" msgstr "" -#: library/socket.rst:2065 +#: library/socket.rst:2064 msgid "" "Here are four minimal example programs using the TCP/IP protocol: a server " "that echoes all data that it receives back (servicing only one client), and " -"a client using it. Note that a server must perform the sequence :func:`." -"socket`, :meth:`~socket.bind`, :meth:`~socket.listen`, :meth:`~socket." -"accept` (possibly repeating the :meth:`~socket.accept` to service more than " -"one client), while a client only needs the sequence :func:`.socket`, :meth:" -"`~socket.connect`. Also note that the server does not :meth:`~socket." -"sendall`/:meth:`~socket.recv` on the socket it is listening on but on the " -"new socket returned by :meth:`~socket.accept`." +"a client using it. Note that a server must perform the sequence :func:" +"`~socket.socket`, :meth:`~socket.bind`, :meth:`~socket.listen`, :meth:" +"`~socket.accept` (possibly repeating the :meth:`~socket.accept` to service " +"more than one client), while a client only needs the sequence :func:`~socket." +"socket`, :meth:`~socket.connect`. Also note that the server does not :meth:" +"`~socket.sendall`/:meth:`~socket.recv` on the socket it is listening on but " +"on the new socket returned by :meth:`~socket.accept`." msgstr "" -#: library/socket.rst:2075 +#: library/socket.rst:2074 msgid "The first two examples support IPv4 only. ::" msgstr "" -#: library/socket.rst:2106 +#: library/socket.rst:2105 msgid "" "The next two examples are identical to the above two, but support both IPv4 " "and IPv6. The server side will listen to the first address family available " @@ -2271,73 +2270,73 @@ msgid "" "resolution, and sends traffic to the first one connected successfully. ::" msgstr "" -#: library/socket.rst:2178 +#: library/socket.rst:2177 msgid "" "The next example shows how to write a very simple network sniffer with raw " "sockets on Windows. The example requires administrator privileges to modify " "the interface::" msgstr "" -#: library/socket.rst:2203 +#: library/socket.rst:2202 msgid "" "The next example shows how to use the socket interface to communicate to a " "CAN network using the raw socket protocol. To use CAN with the broadcast " "manager protocol instead, open a socket with::" msgstr "" -#: library/socket.rst:2209 +#: library/socket.rst:2208 msgid "" "After binding (:const:`CAN_RAW`) or connecting (:const:`CAN_BCM`) the " "socket, you can use the :meth:`socket.send` and :meth:`socket.recv` " "operations (and their counterparts) on the socket object as usual." msgstr "" -#: library/socket.rst:2213 +#: library/socket.rst:2212 msgid "This last example might require special privileges::" msgstr "" -#: library/socket.rst:2253 +#: library/socket.rst:2252 msgid "" "Running an example several times with too small delay between executions, " "could lead to this error::" msgstr "" -#: library/socket.rst:2258 +#: library/socket.rst:2257 msgid "" "This is because the previous execution has left the socket in a " "``TIME_WAIT`` state, and can't be immediately reused." msgstr "" -#: library/socket.rst:2261 +#: library/socket.rst:2260 msgid "" "There is a :mod:`socket` flag to set, in order to prevent this, :const:" "`socket.SO_REUSEADDR`::" msgstr "" -#: library/socket.rst:2268 +#: library/socket.rst:2267 msgid "" "the :data:`SO_REUSEADDR` flag tells the kernel to reuse a local socket in " "``TIME_WAIT`` state, without waiting for its natural timeout to expire." msgstr "" -#: library/socket.rst:2274 +#: library/socket.rst:2273 msgid "" "For an introduction to socket programming (in C), see the following papers:" msgstr "" -#: library/socket.rst:2276 +#: library/socket.rst:2275 msgid "" "*An Introductory 4.3BSD Interprocess Communication Tutorial*, by Stuart " "Sechrest" msgstr "" -#: library/socket.rst:2278 +#: library/socket.rst:2277 msgid "" "*An Advanced 4.3BSD Interprocess Communication Tutorial*, by Samuel J. " "Leffler et al," msgstr "" -#: library/socket.rst:2281 +#: library/socket.rst:2280 msgid "" "both in the UNIX Programmer's Manual, Supplementary Documents 1 (sections " "PS1:7 and PS1:8). The platform-specific reference material for the various " @@ -2356,18 +2355,18 @@ msgstr "" msgid "socket" msgstr "" -#: library/socket.rst:1583 +#: library/socket.rst:1582 msgid "I/O control" msgstr "" -#: library/socket.rst:1583 +#: library/socket.rst:1582 msgid "buffering" msgstr "" -#: library/socket.rst:1938 +#: library/socket.rst:1937 msgid "module" msgstr "" -#: library/socket.rst:1938 +#: library/socket.rst:1937 msgid "struct" msgstr "" diff --git a/library/sqlite3.po b/library/sqlite3.po index e9168e1a7..4eef9ca09 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1410,8 +1410,8 @@ msgstr "" #: library/sqlite3.rst:1474 msgid "" -"Execute SQL a single SQL statement, optionally binding Python values using :" -"ref:`placeholders `." +"Execute a single SQL statement, optionally binding Python values using :ref:" +"`placeholders `." msgstr "" #: library/sqlite3.rst:1478 diff --git a/library/stdtypes.po b/library/stdtypes.po index 9f5e0c4ac..8ea16ec81 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: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: 2023-02-01 18:55-0500\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -5884,26 +5884,27 @@ msgstr "" #: library/stdtypes.rst:4755 msgid "" -"Keys views are set-like since their entries are unique and :term:" -"`hashable`. If all values are hashable, so that ``(key, value)`` pairs are " -"unique and hashable, then the items view is also set-like. (Values views " -"are not treated as set-like since the entries are generally not unique.) " -"For set-like views, all of the operations defined for the abstract base " -"class :class:`collections.abc.Set` are available (for example, ``==``, " -"``<``, or ``^``). While using set operators, set-like views accept any " -"iterable as the other operand, unlike sets which only accept sets as the " +"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 " +"unique and the keys are hashable. If all values in an items view are " +"hashable as well, then the items view can interoperate with other sets. " +"(Values views are not treated as set-like since the entries are generally " +"not unique.) For set-like views, all of the operations defined for the " +"abstract base class :class:`collections.abc.Set` are available (for example, " +"``==``, ``<``, or ``^``). While using set operators, set-like views accept " +"any iterable as the other operand, unlike sets which only accept sets as the " "input." msgstr "" -#: library/stdtypes.rst:4764 +#: library/stdtypes.rst:4767 msgid "An example of dictionary view usage::" msgstr "" -#: library/stdtypes.rst:4808 +#: library/stdtypes.rst:4811 msgid "Context Manager Types" msgstr "Bağlam Yöneticisi Türleri" -#: library/stdtypes.rst:4815 +#: library/stdtypes.rst:4818 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 " @@ -5911,7 +5912,7 @@ msgid "" "before the statement body is executed and exited when the statement ends:" msgstr "" -#: library/stdtypes.rst:4823 +#: library/stdtypes.rst:4826 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 " @@ -5919,14 +5920,14 @@ msgid "" "using this context manager." msgstr "" -#: library/stdtypes.rst:4828 +#: library/stdtypes.rst:4831 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:4832 +#: library/stdtypes.rst:4835 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 " @@ -5936,7 +5937,7 @@ msgid "" "the :keyword:`!with` statement." msgstr "" -#: library/stdtypes.rst:4842 +#: library/stdtypes.rst:4845 msgid "" "Exit the runtime context and return a Boolean flag indicating if any " "exception that occurred should be suppressed. If an exception occurred while " @@ -5945,7 +5946,7 @@ msgid "" "arguments are ``None``." msgstr "" -#: library/stdtypes.rst:4847 +#: library/stdtypes.rst:4850 msgid "" "Returning a true value from this method will cause the :keyword:`with` " "statement to suppress the exception and continue execution with the " @@ -5956,7 +5957,7 @@ msgid "" "statement." msgstr "" -#: library/stdtypes.rst:4854 +#: library/stdtypes.rst:4857 msgid "" "The exception passed in should never be reraised explicitly - instead, this " "method should return a false value to indicate that the method completed " @@ -5965,7 +5966,7 @@ msgid "" "__exit__` method has actually failed." msgstr "" -#: library/stdtypes.rst:4860 +#: library/stdtypes.rst:4863 msgid "" "Python defines several context managers to support easy thread " "synchronisation, prompt closure of files or other objects, and simpler " @@ -5974,7 +5975,7 @@ msgid "" "management protocol. See the :mod:`contextlib` module for some examples." msgstr "" -#: library/stdtypes.rst:4866 +#: library/stdtypes.rst:4869 msgid "" "Python's :term:`generator`\\s and the :class:`contextlib.contextmanager` " "decorator provide a convenient way to implement these protocols. If a " @@ -5984,7 +5985,7 @@ msgid "" "rather than the iterator produced by an undecorated generator function." msgstr "" -#: library/stdtypes.rst:4873 +#: library/stdtypes.rst:4876 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 " @@ -5993,23 +5994,23 @@ msgid "" "a single class dictionary lookup is negligible." msgstr "" -#: library/stdtypes.rst:4881 +#: library/stdtypes.rst:4884 msgid "" "Type Annotation Types --- :ref:`Generic Alias `, :ref:" "`Union `" msgstr "" -#: library/stdtypes.rst:4886 +#: library/stdtypes.rst:4889 msgid "" "The core built-in types for :term:`type annotations ` are :ref:" "`Generic Alias ` and :ref:`Union `." msgstr "" -#: library/stdtypes.rst:4893 +#: library/stdtypes.rst:4896 msgid "Generic Alias Type" msgstr "Genel Takma Ad Türü" -#: library/stdtypes.rst:4899 +#: library/stdtypes.rst:4902 msgid "" "``GenericAlias`` objects are generally created by :ref:`subscripting " "` a class. They are most often used with :ref:`container " @@ -6019,13 +6020,13 @@ msgid "" "are intended primarily for use with :term:`type annotations `." msgstr "" -#: library/stdtypes.rst:4909 +#: library/stdtypes.rst:4912 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:4912 +#: library/stdtypes.rst:4915 msgid "" "A ``GenericAlias`` object acts as a proxy for a :term:`generic type`, " "implementing *parameterized generics*." @@ -6033,7 +6034,7 @@ msgstr "" "Bir ``GenericAlias`` nesnesi, :term:`generic type` için bir vekil olarak " "hareket eder ve *parameterized generics* uygular." -#: library/stdtypes.rst:4915 +#: library/stdtypes.rst:4918 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 " @@ -6042,7 +6043,7 @@ msgid "" "`bytes`." msgstr "" -#: library/stdtypes.rst:4921 +#: library/stdtypes.rst:4924 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 " @@ -6051,7 +6052,7 @@ msgid "" "the :class:`str` data type and the :class:`bytes` data type:" msgstr "" -#: library/stdtypes.rst:4927 +#: library/stdtypes.rst:4930 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 " @@ -6059,7 +6060,7 @@ msgid "" "annotations with the ``GenericAlias`` ``re.Match[str]``." msgstr "" -#: library/stdtypes.rst:4933 +#: library/stdtypes.rst:4936 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." @@ -6068,7 +6069,7 @@ msgid "" "objects>` objects with ``re.Match[bytes]``." msgstr "" -#: library/stdtypes.rst:4939 +#: library/stdtypes.rst:4942 msgid "" "``GenericAlias`` objects are instances of the class :class:`types." "GenericAlias`, which can also be used to create ``GenericAlias`` objects " @@ -6077,7 +6078,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:4945 +#: library/stdtypes.rst:4948 msgid "" "Creates a ``GenericAlias`` representing a type ``T`` parameterized by types " "*X*, *Y*, and more depending on the ``T`` used. For example, a function " @@ -6088,7 +6089,7 @@ msgstr "" "Örneğin, :class:`float` elemanları içeren bir :class:`list` bekleyen bir " "fonksiyon::" -#: library/stdtypes.rst:4953 +#: library/stdtypes.rst:4956 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 " @@ -6100,7 +6101,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:4961 +#: library/stdtypes.rst:4964 msgid "" "The builtin functions :func:`isinstance` and :func:`issubclass` do not " "accept ``GenericAlias`` types for their second argument::" @@ -6108,7 +6109,7 @@ msgstr "" "Yerleşik :func:`isinstance` ve :func:`issubclass` işlevleri ikinci " "argümanları için ``GenericAlias`` türlerini kabul etmez::" -#: library/stdtypes.rst:4969 +#: library/stdtypes.rst:4972 msgid "" "The Python runtime does not enforce :term:`type annotations `. " "This extends to generic types and their type parameters. When creating a " @@ -6122,7 +6123,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:4979 +#: library/stdtypes.rst:4982 msgid "" "Furthermore, parameterized generics erase type parameters during object " "creation::" @@ -6130,7 +6131,7 @@ msgstr "" "Ayrıca, parametrelendirilmiş jenerikler nesne oluşturma sırasında tip " "parametrelerini siler::" -#: library/stdtypes.rst:4990 +#: library/stdtypes.rst:4993 msgid "" "Calling :func:`repr` or :func:`str` on a generic shows the parameterized " "type::" @@ -6138,7 +6139,7 @@ msgstr "" "Bir jenerik üzerinde :func:`repr` veya :func:`str` çağrısı " "parametrelendirilmiş türü gösterir::" -#: library/stdtypes.rst:4998 +#: library/stdtypes.rst:5001 msgid "" "The :meth:`~object.__getitem__` method of generic containers will raise an " "exception to disallow mistakes like ``dict[str][str]``::" @@ -6146,7 +6147,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:5006 +#: library/stdtypes.rst:5009 msgid "" "However, such expressions are valid when :ref:`type variables ` " "are used. The index must have as many elements as there are type variable " @@ -6156,11 +6157,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:5017 +#: library/stdtypes.rst:5020 msgid "Standard Generic Classes" msgstr "Standart Jenerik Sınıflar" -#: library/stdtypes.rst:5019 +#: library/stdtypes.rst:5022 msgid "" "The following standard library classes support parameterized generics. This " "list is non-exhaustive." @@ -6168,235 +6169,235 @@ msgstr "" "Bu standart kütüphane sınıfları parametrelendirilmiş jenerikleri destekler. " "Bu liste kapsamlı değildir." -#: library/stdtypes.rst:5022 +#: library/stdtypes.rst:5025 msgid ":class:`tuple`" msgstr ":class:`tuple`" -#: library/stdtypes.rst:5023 +#: library/stdtypes.rst:5026 msgid ":class:`list`" msgstr ":class:`list`" -#: library/stdtypes.rst:5024 +#: library/stdtypes.rst:5027 msgid ":class:`dict`" msgstr ":class:`dict`" -#: library/stdtypes.rst:5025 +#: library/stdtypes.rst:5028 msgid ":class:`set`" msgstr ":class:`set`" -#: library/stdtypes.rst:5026 +#: library/stdtypes.rst:5029 msgid ":class:`frozenset`" msgstr ":class:`frozenset`" -#: library/stdtypes.rst:5027 +#: library/stdtypes.rst:5030 msgid ":class:`type`" msgstr ":class:`type`" -#: library/stdtypes.rst:5028 +#: library/stdtypes.rst:5031 msgid ":class:`collections.deque`" msgstr ":class:`collections.deque`" -#: library/stdtypes.rst:5029 +#: library/stdtypes.rst:5032 msgid ":class:`collections.defaultdict`" msgstr ":class:`collections.defaultdict`" -#: library/stdtypes.rst:5030 +#: library/stdtypes.rst:5033 msgid ":class:`collections.OrderedDict`" msgstr ":class:`collections.OrderedDict`" -#: library/stdtypes.rst:5031 +#: library/stdtypes.rst:5034 msgid ":class:`collections.Counter`" msgstr ":class:`collections.Counter`" -#: library/stdtypes.rst:5032 +#: library/stdtypes.rst:5035 msgid ":class:`collections.ChainMap`" msgstr ":class:`collections.ChainMap`" -#: library/stdtypes.rst:5033 +#: library/stdtypes.rst:5036 msgid ":class:`collections.abc.Awaitable`" msgstr ":class:`collections.abc.Awaitable`" -#: library/stdtypes.rst:5034 +#: library/stdtypes.rst:5037 msgid ":class:`collections.abc.Coroutine`" msgstr ":class:`collections.abc.Coroutine`" -#: library/stdtypes.rst:5035 +#: library/stdtypes.rst:5038 msgid ":class:`collections.abc.AsyncIterable`" msgstr ":class:`collections.abc.AsyncIterable`" -#: library/stdtypes.rst:5036 +#: library/stdtypes.rst:5039 msgid ":class:`collections.abc.AsyncIterator`" msgstr ":class:`collections.abc.AsyncIterator`" -#: library/stdtypes.rst:5037 +#: library/stdtypes.rst:5040 msgid ":class:`collections.abc.AsyncGenerator`" msgstr ":class:`collections.abc.AsyncGenerator`" -#: library/stdtypes.rst:5038 +#: library/stdtypes.rst:5041 msgid ":class:`collections.abc.Iterable`" msgstr ":class:`collections.abc.Iterable`" -#: library/stdtypes.rst:5039 +#: library/stdtypes.rst:5042 msgid ":class:`collections.abc.Iterator`" msgstr ":class:`collections.abc.Iterator`" -#: library/stdtypes.rst:5040 +#: library/stdtypes.rst:5043 msgid ":class:`collections.abc.Generator`" msgstr ":class:`collections.abc.Generator`" -#: library/stdtypes.rst:5041 +#: library/stdtypes.rst:5044 msgid ":class:`collections.abc.Reversible`" msgstr ":class:`collections.abc.Reversible`" -#: library/stdtypes.rst:5042 +#: library/stdtypes.rst:5045 msgid ":class:`collections.abc.Container`" msgstr ":class:`collections.abc.Container`" -#: library/stdtypes.rst:5043 +#: library/stdtypes.rst:5046 msgid ":class:`collections.abc.Collection`" msgstr ":class:`collections.abc.Collection`" -#: library/stdtypes.rst:5044 +#: library/stdtypes.rst:5047 msgid ":class:`collections.abc.Callable`" msgstr ":class:`collections.abc.Callable`" -#: library/stdtypes.rst:5045 +#: library/stdtypes.rst:5048 msgid ":class:`collections.abc.Set`" msgstr ":class:`collections.abc.Set`" -#: library/stdtypes.rst:5046 +#: library/stdtypes.rst:5049 msgid ":class:`collections.abc.MutableSet`" msgstr ":class:`collections.abc.MutableSet`" -#: library/stdtypes.rst:5047 +#: library/stdtypes.rst:5050 msgid ":class:`collections.abc.Mapping`" msgstr ":class:`collections.abc.Mapping`" -#: library/stdtypes.rst:5048 +#: library/stdtypes.rst:5051 msgid ":class:`collections.abc.MutableMapping`" msgstr ":class:`collections.abc.MutableMapping`" -#: library/stdtypes.rst:5049 +#: library/stdtypes.rst:5052 msgid ":class:`collections.abc.Sequence`" msgstr ":class:`collections.abc.Sequence`" -#: library/stdtypes.rst:5050 +#: library/stdtypes.rst:5053 msgid ":class:`collections.abc.MutableSequence`" msgstr ":class:`collections.abc.MutableSequence`" -#: library/stdtypes.rst:5051 +#: library/stdtypes.rst:5054 msgid ":class:`collections.abc.ByteString`" msgstr ":class:`collections.abc.ByteString`" -#: library/stdtypes.rst:5052 +#: library/stdtypes.rst:5055 msgid ":class:`collections.abc.MappingView`" msgstr ":class:`collections.abc.MappingView`" -#: library/stdtypes.rst:5053 +#: library/stdtypes.rst:5056 msgid ":class:`collections.abc.KeysView`" msgstr ":class:`collections.abc.KeysView`" -#: library/stdtypes.rst:5054 +#: library/stdtypes.rst:5057 msgid ":class:`collections.abc.ItemsView`" msgstr ":class:`collections.abc.ItemsView`" -#: library/stdtypes.rst:5055 +#: library/stdtypes.rst:5058 msgid ":class:`collections.abc.ValuesView`" msgstr ":class:`collections.abc.ValuesView`" -#: library/stdtypes.rst:5056 +#: library/stdtypes.rst:5059 msgid ":class:`contextlib.AbstractContextManager`" msgstr ":class:`contextlib.AbstractContextManager`" -#: library/stdtypes.rst:5057 +#: library/stdtypes.rst:5060 msgid ":class:`contextlib.AbstractAsyncContextManager`" msgstr ":class:`contextlib.AbstractAsyncContextManager`" -#: library/stdtypes.rst:5058 +#: library/stdtypes.rst:5061 msgid ":class:`dataclasses.Field`" msgstr ":class:`dataclasses.Field`" -#: library/stdtypes.rst:5059 +#: library/stdtypes.rst:5062 msgid ":class:`functools.cached_property`" msgstr ":class:`functools.cached_property`" -#: library/stdtypes.rst:5060 +#: library/stdtypes.rst:5063 msgid ":class:`functools.partialmethod`" msgstr "" -#: library/stdtypes.rst:5061 +#: library/stdtypes.rst:5064 msgid ":class:`os.PathLike`" msgstr ":class:`os.PathLike`" -#: library/stdtypes.rst:5062 +#: library/stdtypes.rst:5065 msgid ":class:`queue.LifoQueue`" msgstr ":class:`queue.LifoQueue`" -#: library/stdtypes.rst:5063 +#: library/stdtypes.rst:5066 msgid ":class:`queue.Queue`" msgstr ":class:`queue.Queue`" -#: library/stdtypes.rst:5064 +#: library/stdtypes.rst:5067 msgid ":class:`queue.PriorityQueue`" msgstr ":class:`queue.PriorityQueue`" -#: library/stdtypes.rst:5065 +#: library/stdtypes.rst:5068 msgid ":class:`queue.SimpleQueue`" msgstr ":class:`tuple`" -#: library/stdtypes.rst:5066 +#: library/stdtypes.rst:5069 msgid ":ref:`re.Pattern `" msgstr ":ref:`re.Pattern `" -#: library/stdtypes.rst:5067 +#: library/stdtypes.rst:5070 msgid ":ref:`re.Match `" msgstr ":ref:`re.Match `" -#: library/stdtypes.rst:5068 +#: library/stdtypes.rst:5071 msgid ":class:`shelve.BsdDbShelf`" msgstr ":class:`shelve.BsdDbShelf`" -#: library/stdtypes.rst:5069 +#: library/stdtypes.rst:5072 msgid ":class:`shelve.DbfilenameShelf`" msgstr ":class:`shelve.DbfilenameShelf`" -#: library/stdtypes.rst:5070 +#: library/stdtypes.rst:5073 msgid ":class:`shelve.Shelf`" msgstr ":class:`shelve.Shelf`" -#: library/stdtypes.rst:5071 +#: library/stdtypes.rst:5074 msgid ":class:`types.MappingProxyType`" msgstr ":class:`types.MappingProxyType`" -#: library/stdtypes.rst:5072 +#: library/stdtypes.rst:5075 msgid ":class:`weakref.WeakKeyDictionary`" msgstr "" -#: library/stdtypes.rst:5073 +#: library/stdtypes.rst:5076 msgid ":class:`weakref.WeakMethod`" msgstr "" -#: library/stdtypes.rst:5074 +#: library/stdtypes.rst:5077 msgid ":class:`weakref.WeakSet`" msgstr ":class:`weakref.WeakSet`" -#: library/stdtypes.rst:5075 +#: library/stdtypes.rst:5078 msgid ":class:`weakref.WeakValueDictionary`" msgstr "" -#: library/stdtypes.rst:5080 +#: library/stdtypes.rst:5083 msgid "Special Attributes of ``GenericAlias`` objects" msgstr "``GenericAlias`` objesinin Özel Öznitelikleri" -#: library/stdtypes.rst:5082 +#: library/stdtypes.rst:5085 msgid "All parameterized generics implement special read-only attributes." msgstr "Tüm parametreli jenerikler özel salt okunur öznitelikler uygular." -#: library/stdtypes.rst:5086 +#: library/stdtypes.rst:5089 msgid "This attribute points at the non-parameterized generic class::" msgstr "Bu öznitelik, parametrelendirilmemiş genel sınıfa işaret eder::" -#: library/stdtypes.rst:5094 +#: library/stdtypes.rst:5097 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 " @@ -6406,7 +6407,7 @@ msgstr "" "öğesine iletilen jenerik tiplerinden bir :class:`tuple` 'dır (muhtemelen 1 " "uzunluğunda)::" -#: library/stdtypes.rst:5104 +#: library/stdtypes.rst:5107 msgid "" "This attribute is a lazily computed tuple (possibly empty) of unique type " "variables found in ``__args__``::" @@ -6414,7 +6415,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:5115 +#: library/stdtypes.rst:5118 msgid "" "A ``GenericAlias`` object with :class:`typing.ParamSpec` parameters may not " "have correct ``__parameters__`` after substitution because :class:`typing." @@ -6424,49 +6425,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:5122 +#: library/stdtypes.rst:5125 msgid "" "A boolean that is true if the alias has been unpacked using the ``*`` " "operator (see :data:`~typing.TypeVarTuple`)." msgstr "" -#: library/stdtypes.rst:5131 +#: library/stdtypes.rst:5134 msgid ":pep:`484` - Type Hints" msgstr "" -#: library/stdtypes.rst:5131 +#: library/stdtypes.rst:5134 msgid "Introducing Python's framework for type annotations." msgstr "" -#: library/stdtypes.rst:5136 +#: library/stdtypes.rst:5139 msgid ":pep:`585` - Type Hinting Generics In Standard Collections" msgstr "" ":pep:`585` - Standart Koleksiyonlarda Tip İma Etme (Type Hinting) Jenerikleri" -#: library/stdtypes.rst:5134 +#: library/stdtypes.rst:5137 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:5139 +#: library/stdtypes.rst:5142 msgid "" ":ref:`Generics`, :ref:`user-defined generics ` and :" "class:`typing.Generic`" msgstr "" -#: library/stdtypes.rst:5139 +#: library/stdtypes.rst:5142 msgid "" "Documentation on how to implement generic classes that can be parameterized " "at runtime and understood by static type-checkers." msgstr "" -#: library/stdtypes.rst:5148 +#: library/stdtypes.rst:5151 msgid "Union Type" msgstr "Sendika Türü" -#: library/stdtypes.rst:5154 +#: library/stdtypes.rst:5157 msgid "" "A union object holds the value of the ``|`` (bitwise or) operation on " "multiple :ref:`type objects `. These types are intended " @@ -6480,7 +6481,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:5161 +#: library/stdtypes.rst:5164 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 " @@ -6491,7 +6492,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:5171 +#: library/stdtypes.rst:5174 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 " @@ -6500,34 +6501,34 @@ msgid "" "a string, e.g. ``\"int | Foo\"``." msgstr "" -#: library/stdtypes.rst:5179 +#: library/stdtypes.rst:5182 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:5181 +#: library/stdtypes.rst:5184 msgid "Unions of unions are flattened::" msgstr "Birliklerin birlikleri düzleştirimiştir::" -#: library/stdtypes.rst:5185 +#: library/stdtypes.rst:5188 msgid "Redundant types are removed::" msgstr "Gereksiz türler kaldırılır::" -#: library/stdtypes.rst:5189 +#: library/stdtypes.rst:5192 msgid "When comparing unions, the order is ignored::" msgstr "Birlikleri karşılaştırırken, sipariş göz ardı edilir::" -#: library/stdtypes.rst:5193 +#: library/stdtypes.rst:5196 msgid "It is compatible with :data:`typing.Union`::" msgstr ":data:`typing.Union`:: ile uyumludur:" -#: library/stdtypes.rst:5197 +#: library/stdtypes.rst:5200 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:5204 +#: library/stdtypes.rst:5207 msgid "" "Calls to :func:`isinstance` and :func:`issubclass` are also supported with a " "union object::" @@ -6535,14 +6536,14 @@ msgstr "" ":func:`isinstance` ve :func:`issubclass` çağrıları da bir birlik nesnesiyle " "desteklenir::" -#: library/stdtypes.rst:5210 +#: library/stdtypes.rst:5213 #, 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:5220 +#: library/stdtypes.rst:5223 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 " @@ -6552,7 +6553,7 @@ msgstr "" "erişilebilir ve :func:`isinstance` kontrolleri için kullanılabilir. Bir " "nesne şu türden örneklenemez::" -#: library/stdtypes.rst:5233 +#: library/stdtypes.rst:5236 msgid "" "The :meth:`__or__` method for type objects was added to support the syntax " "``X | Y``. If a metaclass implements :meth:`__or__`, the Union may override " @@ -6562,15 +6563,15 @@ msgstr "" "için eklendi. Eğer bir metaclass :meth:`__or__` metodunu uygularsa, Union " "bunu geçersiz kılabilir::" -#: library/stdtypes.rst:5251 +#: library/stdtypes.rst:5254 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:5259 +#: library/stdtypes.rst:5262 msgid "Other Built-in Types" msgstr "Diğer Yerleşik Tipler" -#: library/stdtypes.rst:5261 +#: library/stdtypes.rst:5264 msgid "" "The interpreter supports several other kinds of objects. Most of these " "support only one or two operations." @@ -6578,11 +6579,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:5268 +#: library/stdtypes.rst:5271 msgid "Modules" msgstr "Modüller" -#: library/stdtypes.rst:5270 +#: library/stdtypes.rst:5273 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 " @@ -6600,7 +6601,7 @@ msgstr "" "bunun yerine bir yerlerde *foo* adında bir modül için (harici) bir " "*tanımlama* gerektirir)" -#: library/stdtypes.rst:5277 +#: library/stdtypes.rst:5280 msgid "" "A special attribute of every module is :attr:`~object.__dict__`. This is the " "dictionary containing the module's symbol table. Modifying this dictionary " @@ -6618,7 +6619,7 @@ msgstr "" "`` yazamazsınız). :attr:`~object.__dict__` öğesinin doğrudan değiştirilmesi " "önerilmez." -#: library/stdtypes.rst:5285 +#: library/stdtypes.rst:5288 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:5293 +#: library/stdtypes.rst:5296 msgid "Classes and Class Instances" msgstr "Sınıflar ve Sınıf Örnekleri" -#: library/stdtypes.rst:5295 +#: library/stdtypes.rst:5298 msgid "See :ref:`objects` and :ref:`class` for these." msgstr "Bunlar için :ref:`class` ve :ref:`objects` bakın." -#: library/stdtypes.rst:5301 +#: library/stdtypes.rst:5304 msgid "Functions" msgstr "Fonksiyonlar" -#: library/stdtypes.rst:5303 +#: library/stdtypes.rst:5306 msgid "" "Function objects are created by function definitions. The only operation on " "a function object is to call it: ``func(argument-list)``." @@ -6649,7 +6650,7 @@ msgstr "" "fonksiyon nesnesi üzerindeki tek işlem onu çağırmaktır: ``func(argument-" "list)``." -#: library/stdtypes.rst:5306 +#: library/stdtypes.rst:5309 msgid "" "There are really two flavors of function objects: built-in functions and " "user-defined functions. Both support the same operation (to call the " @@ -6661,15 +6662,15 @@ msgstr "" "çağırmak için), ancak uygulama farklıdır, dolayısıyla farklı nesne türleri " "vardır." -#: library/stdtypes.rst:5310 +#: library/stdtypes.rst:5313 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:5316 +#: library/stdtypes.rst:5319 msgid "Methods" msgstr "Yöntemler" -#: library/stdtypes.rst:5320 +#: library/stdtypes.rst:5323 msgid "" "Methods are functions that are called using the attribute notation. There " "are two flavors: built-in methods (such as :meth:`append` on lists) and " @@ -6681,7 +6682,7 @@ msgstr "" "yöntemleri. Yerleşik yöntemler, onları destekleyen türlerle birlikte " "tanımlanır." -#: library/stdtypes.rst:5325 +#: library/stdtypes.rst:5328 msgid "" "If you access a method (a function defined in a class namespace) through an " "instance, you get a special object: a :dfn:`bound method` (also called :dfn:" @@ -6701,7 +6702,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:5334 +#: library/stdtypes.rst:5337 msgid "" "Like function objects, bound method objects support getting arbitrary " "attributes. However, since method attributes are actually stored on the " @@ -6718,15 +6719,15 @@ msgstr "" "ayarlamak için, bunu temel işlev nesnesi üzerinde açıkça ayarlamanız " "gerekir::" -#: library/stdtypes.rst:5385 +#: library/stdtypes.rst:5388 msgid "See :ref:`types` for more information." msgstr "Daha fazla bilgi için :ref:`types` sayfasına bakın." -#: library/stdtypes.rst:5362 +#: library/stdtypes.rst:5365 msgid "Code Objects" msgstr "Kod Nesneleri" -#: library/stdtypes.rst:5368 +#: library/stdtypes.rst:5371 msgid "" "Code objects are used by the implementation to represent \"pseudo-compiled\" " "executable Python code such as a function body. They differ from function " @@ -6742,7 +6743,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:5375 +#: library/stdtypes.rst:5378 msgid "" "Accessing ``__code__`` raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"__code__\"``." @@ -6750,7 +6751,7 @@ msgstr "" "``__code__`` 'e erişmek,``obj`` ve ``\"__code__\"`` argümanlarıyla :ref:" "`denetim etkinliği ` ``object.__getattr__`` oluşturur." -#: library/stdtypes.rst:5382 +#: library/stdtypes.rst:5385 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." @@ -6758,11 +6759,11 @@ 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:5391 +#: library/stdtypes.rst:5394 msgid "Type Objects" msgstr "Type Objects" -#: library/stdtypes.rst:5397 +#: library/stdtypes.rst:5400 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 " @@ -6774,15 +6775,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:5402 +#: library/stdtypes.rst:5405 msgid "Types are written like this: ````." msgstr "Türler şu şekilde yazılır: ````." -#: library/stdtypes.rst:5408 +#: library/stdtypes.rst:5411 msgid "The Null Object" msgstr "Null Nesne" -#: library/stdtypes.rst:5410 +#: library/stdtypes.rst:5413 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 " @@ -6792,15 +6793,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:5414 +#: library/stdtypes.rst:5417 msgid "It is written as ``None``." msgstr "''Yok'' olarak yazılmıştır." -#: library/stdtypes.rst:5421 +#: library/stdtypes.rst:5424 msgid "The Ellipsis Object" msgstr "Üç Nokta Nesnesi" -#: library/stdtypes.rst:5423 +#: library/stdtypes.rst:5426 msgid "" "This object is commonly used by slicing (see :ref:`slicings`). It supports " "no special operations. There is exactly one ellipsis object, named :const:" @@ -6812,15 +6813,15 @@ msgstr "" "ad) adında bir elips nesnesi vardır. ``type(Ellipsis)()``, :const:" "`Ellipsis` singletonunu üretir." -#: library/stdtypes.rst:5428 +#: library/stdtypes.rst:5431 msgid "It is written as ``Ellipsis`` or ``...``." msgstr "``Ellipsis`` veya ``...`` olarak yazılmıştır." -#: library/stdtypes.rst:5434 +#: library/stdtypes.rst:5437 msgid "The NotImplemented Object" msgstr "NotImplemented Nesnesi" -#: library/stdtypes.rst:5436 +#: library/stdtypes.rst:5439 msgid "" "This object is returned from comparisons and binary operations when they are " "asked to operate on types they don't support. See :ref:`comparisons` for " @@ -6832,15 +6833,15 @@ msgstr "" "ref:`comparisons` sayfasına bakın. Tam olarak bir ``NotImplemented`` " "nesnesi vardır. ``type(NotImplemented)()``, singleton örneğini üretir." -#: library/stdtypes.rst:5441 +#: library/stdtypes.rst:5444 msgid "It is written as ``NotImplemented``." msgstr "''NotImplemented'' olarak yazılmıştır." -#: library/stdtypes.rst:5447 +#: library/stdtypes.rst:5450 msgid "Internal Objects" msgstr "İç Nesneler" -#: library/stdtypes.rst:5449 +#: library/stdtypes.rst:5452 msgid "" "See :ref:`types` for this information. It describes stack frame objects, " "traceback objects, and slice objects." @@ -6848,11 +6849,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:5456 +#: library/stdtypes.rst:5459 msgid "Special Attributes" msgstr "Özel Özellikler" -#: library/stdtypes.rst:5458 +#: library/stdtypes.rst:5461 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:" @@ -6862,7 +6863,7 @@ msgstr "" "öznitelik ekler. Bunlardan bazıları :func:`dir` yerleşik işlevi tarafından " "bildirilmez." -#: library/stdtypes.rst:5465 +#: library/stdtypes.rst:5468 msgid "" "A dictionary or other mapping object used to store an object's (writable) " "attributes." @@ -6870,20 +6871,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:5471 +#: library/stdtypes.rst:5474 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:5476 +#: library/stdtypes.rst:5479 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:5481 +#: library/stdtypes.rst:5484 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:5487 +#: library/stdtypes.rst:5490 msgid "" "The :term:`qualified name` of the class, function, method, descriptor, or " "generator instance." @@ -6891,13 +6892,13 @@ msgstr "" "Sınıf, fonksiyon, yöntem, tanımlayıcı veya üretici örneğinin :term:" "`qualified name`." -#: library/stdtypes.rst:5495 +#: library/stdtypes.rst:5498 msgid "" "The :ref:`type parameters ` of generic classes, functions, and :" "ref:`type aliases `." msgstr "" -#: library/stdtypes.rst:5503 +#: library/stdtypes.rst:5506 msgid "" "This attribute is a tuple of classes that are considered when looking for " "base classes during method resolution." @@ -6905,7 +6906,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:5509 +#: library/stdtypes.rst:5512 msgid "" "This method can be overridden by a metaclass to customize the method " "resolution order for its instances. It is called at class instantiation, " @@ -6915,7 +6916,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:5516 +#: library/stdtypes.rst:5519 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 " @@ -6925,11 +6926,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:5527 +#: library/stdtypes.rst:5530 msgid "Integer string conversion length limitation" msgstr "" -#: library/stdtypes.rst:5529 +#: library/stdtypes.rst:5532 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 " @@ -6937,7 +6938,7 @@ msgid "" "binary conversions are unlimited. The limit can be configured." msgstr "" -#: library/stdtypes.rst:5534 +#: library/stdtypes.rst:5537 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 " @@ -6947,25 +6948,25 @@ msgid "" "value such as ``int('1' * 500_000)`` can take over a second on a fast CPU." msgstr "" -#: library/stdtypes.rst:5541 +#: library/stdtypes.rst:5544 msgid "" "Limiting conversion size offers a practical way to avoid `CVE-2020-10735 " "`_." msgstr "" -#: library/stdtypes.rst:5544 +#: library/stdtypes.rst:5547 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:5548 +#: library/stdtypes.rst:5551 msgid "" "When an operation would exceed the limit, a :exc:`ValueError` is raised:" msgstr "" -#: library/stdtypes.rst:5570 +#: library/stdtypes.rst:5573 msgid "" "The default limit is 4300 digits as provided in :data:`sys.int_info." "default_max_str_digits `. The lowest limit that can be " @@ -6973,95 +6974,95 @@ msgid "" "str_digits_check_threshold `." msgstr "" -#: library/stdtypes.rst:5575 +#: library/stdtypes.rst:5578 msgid "Verification:" msgstr "Doğrulama" -#: library/stdtypes.rst:5590 +#: library/stdtypes.rst:5593 msgid "Affected APIs" msgstr "" -#: library/stdtypes.rst:5592 +#: library/stdtypes.rst:5595 msgid "" "The limitation only applies to potentially slow conversions between :class:" "`int` and :class:`str` or :class:`bytes`:" msgstr "" -#: library/stdtypes.rst:5595 +#: library/stdtypes.rst:5598 msgid "``int(string)`` with default base 10." msgstr "" -#: library/stdtypes.rst:5596 +#: library/stdtypes.rst:5599 msgid "``int(string, base)`` for all bases that are not a power of 2." msgstr "" -#: library/stdtypes.rst:5597 +#: library/stdtypes.rst:5600 msgid "``str(integer)``." msgstr "" -#: library/stdtypes.rst:5598 +#: library/stdtypes.rst:5601 msgid "``repr(integer)``." msgstr "" -#: library/stdtypes.rst:5599 +#: library/stdtypes.rst:5602 msgid "" "any other string conversion to base 10, for example ``f\"{integer}\"``, " "``\"{}\".format(integer)``, or ``b\"%d\" % integer``." msgstr "" -#: library/stdtypes.rst:5602 +#: library/stdtypes.rst:5605 msgid "The limitations do not apply to functions with a linear algorithm:" msgstr "" -#: library/stdtypes.rst:5604 +#: library/stdtypes.rst:5607 msgid "``int(string, base)`` with base 2, 4, 8, 16, or 32." msgstr "" -#: library/stdtypes.rst:5605 +#: library/stdtypes.rst:5608 msgid ":func:`int.from_bytes` and :func:`int.to_bytes`." msgstr "" -#: library/stdtypes.rst:5606 +#: library/stdtypes.rst:5609 msgid ":func:`hex`, :func:`oct`, :func:`bin`." msgstr "" -#: library/stdtypes.rst:5607 +#: library/stdtypes.rst:5610 msgid ":ref:`formatspec` for hex, octal, and binary numbers." msgstr "" -#: library/stdtypes.rst:5608 +#: library/stdtypes.rst:5611 #, fuzzy msgid ":class:`str` to :class:`float`." msgstr ":class:`str` 'den :class:`float` 'a." -#: library/stdtypes.rst:5609 +#: library/stdtypes.rst:5612 msgid ":class:`str` to :class:`decimal.Decimal`." msgstr "" -#: library/stdtypes.rst:5612 +#: library/stdtypes.rst:5615 msgid "Configuring the limit" msgstr "" -#: library/stdtypes.rst:5614 +#: library/stdtypes.rst:5617 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:5617 +#: library/stdtypes.rst:5620 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:5620 +#: library/stdtypes.rst:5623 msgid "" ":option:`-X int_max_str_digits <-X>`, e.g. ``python3 -X " "int_max_str_digits=640``" msgstr "" -#: library/stdtypes.rst:5622 +#: library/stdtypes.rst:5625 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 " @@ -7070,38 +7071,38 @@ msgid "" "int_info.default_max_str_digits` was used during initialization." msgstr "" -#: library/stdtypes.rst:5628 +#: library/stdtypes.rst:5631 msgid "" "From code, you can inspect the current limit and set a new one using these :" "mod:`sys` APIs:" msgstr "" -#: library/stdtypes.rst:5631 +#: library/stdtypes.rst:5634 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:5635 +#: library/stdtypes.rst:5638 msgid "" "Information about the default and minimum can be found in :data:`sys." "int_info`:" msgstr "" -#: library/stdtypes.rst:5637 +#: library/stdtypes.rst:5640 msgid "" ":data:`sys.int_info.default_max_str_digits ` is the compiled-" "in default limit." msgstr "" -#: library/stdtypes.rst:5639 +#: library/stdtypes.rst:5642 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:5646 +#: library/stdtypes.rst:5649 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 " @@ -7113,7 +7114,7 @@ msgid "" "constants is to convert them to ``0x`` hexadecimal form as it has no limit." msgstr "" -#: library/stdtypes.rst:5655 +#: library/stdtypes.rst:5658 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 " @@ -7121,11 +7122,11 @@ msgid "" "to precompile ``.py`` sources to ``.pyc`` files." msgstr "" -#: library/stdtypes.rst:5661 +#: library/stdtypes.rst:5664 msgid "Recommended configuration" msgstr "" -#: library/stdtypes.rst:5663 +#: library/stdtypes.rst:5666 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 " @@ -7133,19 +7134,19 @@ msgid "" "as these APIs were added in security patch releases in versions before 3.12." msgstr "" -#: library/stdtypes.rst:5668 +#: library/stdtypes.rst:5671 msgid "Example::" msgstr "Örnek::" -#: library/stdtypes.rst:5680 +#: library/stdtypes.rst:5683 msgid "If you need to disable it entirely, set it to ``0``." msgstr "" -#: library/stdtypes.rst:5684 +#: library/stdtypes.rst:5687 msgid "Footnotes" msgstr "Dipnotlar" -#: library/stdtypes.rst:5685 +#: library/stdtypes.rst:5688 msgid "" "Additional information on these special methods may be found in the Python " "Reference Manual (:ref:`customization`)." @@ -7153,7 +7154,7 @@ msgstr "" "Bu özel yöntemler hakkında daha fazla bilgi Python Referans El Kitabında (:" "ref:`customization`) bulunabilir." -#: library/stdtypes.rst:5688 +#: library/stdtypes.rst:5691 msgid "" "As a consequence, the list ``[1, 2]`` is considered equal to ``[1.0, 2.0]``, " "and similarly for tuples." @@ -7161,12 +7162,12 @@ msgstr "" "Sonuç olarak, ``[1, 2]`` listesi ``[1.0, 2.0]`` ve benzer şekilde demetler " "için eşit kabul edilir." -#: library/stdtypes.rst:5691 +#: library/stdtypes.rst:5694 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:5693 +#: library/stdtypes.rst:5696 msgid "" "Cased characters are those with general category property being one of " "\"Lu\" (Letter, uppercase), \"Ll\" (Letter, lowercase), or \"Lt\" (Letter, " @@ -7176,7 +7177,7 @@ msgstr "" "\"Ll\" (Harf, küçük harf) veya \"Lt\" (Harf, başlık) karakterlerinden biri " "olan karakterlerdir." -#: library/stdtypes.rst:5696 +#: library/stdtypes.rst:5699 msgid "" "To format only a tuple you should therefore provide a singleton tuple whose " "only element is the tuple to be formatted." @@ -7190,7 +7191,7 @@ msgid "built-in" msgstr "Gömülü Türler" #: library/stdtypes.rst:315 library/stdtypes.rst:949 library/stdtypes.rst:1138 -#: library/stdtypes.rst:4420 library/stdtypes.rst:5393 +#: library/stdtypes.rst:4420 library/stdtypes.rst:5396 msgid "types" msgstr "" @@ -7317,8 +7318,8 @@ msgstr "``is not``" #: library/stdtypes.rst:207 library/stdtypes.rst:1116 library/stdtypes.rst:1258 #: library/stdtypes.rst:1381 library/stdtypes.rst:1539 #: library/stdtypes.rst:2532 library/stdtypes.rst:4219 -#: library/stdtypes.rst:4895 library/stdtypes.rst:5318 -#: library/stdtypes.rst:5357 +#: library/stdtypes.rst:4898 library/stdtypes.rst:5321 +#: library/stdtypes.rst:5360 #, fuzzy msgid "object" msgstr "Kod Nesneleri" @@ -7411,8 +7412,8 @@ msgstr "" msgid "arithmetic" msgstr "" -#: library/stdtypes.rst:949 library/stdtypes.rst:4420 library/stdtypes.rst:5378 -#: library/stdtypes.rst:5393 +#: library/stdtypes.rst:949 library/stdtypes.rst:4420 library/stdtypes.rst:5381 +#: library/stdtypes.rst:5396 msgid "built-in function" msgstr "" @@ -7477,7 +7478,7 @@ msgstr "İşlem" msgid "conjugate() (complex number method)" msgstr "*c* karmaşık sayısının eşleniği" -#: library/stdtypes.rst:1605 library/stdtypes.rst:5393 +#: library/stdtypes.rst:1605 library/stdtypes.rst:5396 #, fuzzy msgid "module" msgstr "Modüller" @@ -7546,7 +7547,7 @@ msgstr "" msgid "iterator protocol" msgstr "" -#: library/stdtypes.rst:4810 +#: library/stdtypes.rst:4813 msgid "protocol" msgstr "" @@ -7660,7 +7661,7 @@ msgstr "" msgid "bytearray" msgstr "" -#: library/stdtypes.rst:4420 library/stdtypes.rst:5393 +#: library/stdtypes.rst:4420 library/stdtypes.rst:5396 msgid "type" msgstr "" @@ -7855,85 +7856,85 @@ msgstr "" msgid "__missing__()" msgstr "" -#: library/stdtypes.rst:4810 +#: library/stdtypes.rst:4813 #, fuzzy msgid "context manager" msgstr "Bağlam Yöneticisi Türleri" -#: library/stdtypes.rst:4810 +#: library/stdtypes.rst:4813 msgid "context management protocol" msgstr "" -#: library/stdtypes.rst:4810 +#: library/stdtypes.rst:4813 #, fuzzy msgid "context management" msgstr "Bağlam Yöneticisi Türleri" -#: library/stdtypes.rst:4883 +#: library/stdtypes.rst:4886 msgid "annotation" msgstr "" -#: library/stdtypes.rst:4883 +#: library/stdtypes.rst:4886 msgid "type annotation; type hint" msgstr "" -#: library/stdtypes.rst:4895 +#: library/stdtypes.rst:4898 #, fuzzy msgid "GenericAlias" msgstr "Genel Takma Ad Türü" -#: library/stdtypes.rst:4895 +#: library/stdtypes.rst:4898 msgid "Generic" msgstr "" -#: library/stdtypes.rst:4895 +#: library/stdtypes.rst:4898 msgid "Alias" msgstr "" -#: library/stdtypes.rst:5150 +#: library/stdtypes.rst:5153 #, fuzzy msgid "Union" msgstr "Sendika Türü" -#: library/stdtypes.rst:5150 +#: library/stdtypes.rst:5153 msgid "union" msgstr "" -#: library/stdtypes.rst:5318 +#: library/stdtypes.rst:5321 #, fuzzy msgid "method" msgstr "Yöntemler" -#: library/stdtypes.rst:5357 +#: library/stdtypes.rst:5360 msgid "code" msgstr "" -#: library/stdtypes.rst:5357 +#: library/stdtypes.rst:5360 #, fuzzy msgid "code object" msgstr "Kod Nesneleri" -#: library/stdtypes.rst:5364 +#: library/stdtypes.rst:5367 msgid "compile" msgstr "" -#: library/stdtypes.rst:5364 +#: library/stdtypes.rst:5367 msgid "__code__ (function object attribute)" msgstr "" -#: library/stdtypes.rst:5378 +#: library/stdtypes.rst:5381 msgid "exec" msgstr "" -#: library/stdtypes.rst:5378 +#: library/stdtypes.rst:5381 msgid "eval" msgstr "" -#: library/stdtypes.rst:5417 +#: library/stdtypes.rst:5420 msgid "..." msgstr "" -#: library/stdtypes.rst:5417 +#: library/stdtypes.rst:5420 msgid "ellipsis literal" msgstr "" diff --git a/library/sys.monitoring.po b/library/sys.monitoring.po index a7cc68c32..fd1efb5cb 100644 --- a/library/sys.monitoring.po +++ b/library/sys.monitoring.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: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -91,124 +91,132 @@ msgstr "" #: library/sys.monitoring.rst:59 msgid "" +":func:`free_tool_id` will not disable global or local events associated with " +"*tool_id*, nor will it unregister any callback functions. This function is " +"only intended to be used to notify the VM that the particular *tool_id* is " +"no longer in use." +msgstr "" + +#: library/sys.monitoring.rst:66 +msgid "" "Returns the name of the tool if *tool_id* is in use, otherwise it returns " "``None``. *tool_id* must be in the range 0 to 5 inclusive." msgstr "" -#: library/sys.monitoring.rst:63 +#: library/sys.monitoring.rst:70 msgid "" "All IDs are treated the same by the VM with regard to events, but the " "following IDs are pre-defined to make co-operation of tools easier::" msgstr "" -#: library/sys.monitoring.rst:71 +#: library/sys.monitoring.rst:78 msgid "" "There is no obligation to set an ID, nor is there anything preventing a tool " "from using an ID even it is already in use. However, tools are encouraged to " "use a unique ID and respect other tools." msgstr "" -#: library/sys.monitoring.rst:76 +#: library/sys.monitoring.rst:83 msgid "Events" msgstr "" -#: library/sys.monitoring.rst:78 +#: library/sys.monitoring.rst:85 msgid "The following events are supported:" msgstr "" -#: library/sys.monitoring.rst:82 +#: library/sys.monitoring.rst:89 msgid "A conditional branch is taken (or not)." msgstr "" -#: library/sys.monitoring.rst:86 +#: library/sys.monitoring.rst:93 msgid "A call in Python code (event occurs before the call)." msgstr "" -#: library/sys.monitoring.rst:90 +#: library/sys.monitoring.rst:97 msgid "" "An exception raised from any callable, except for Python functions (event " "occurs after the exit)." msgstr "" -#: library/sys.monitoring.rst:94 +#: library/sys.monitoring.rst:101 msgid "" "Return from any callable, except for Python functions (event occurs after " "the return)." msgstr "" -#: library/sys.monitoring.rst:98 +#: library/sys.monitoring.rst:105 msgid "An exception is handled." msgstr "" -#: library/sys.monitoring.rst:102 +#: library/sys.monitoring.rst:109 msgid "A VM instruction is about to be executed." msgstr "" -#: library/sys.monitoring.rst:106 +#: library/sys.monitoring.rst:113 msgid "An unconditional jump in the control flow graph is made." msgstr "" -#: library/sys.monitoring.rst:110 +#: library/sys.monitoring.rst:117 msgid "" "An instruction is about to be executed that has a different line number from " "the preceding instruction." msgstr "" -#: library/sys.monitoring.rst:114 +#: library/sys.monitoring.rst:121 msgid "" "Resumption of a Python function (for generator and coroutine functions), " "except for ``throw()`` calls." msgstr "" -#: library/sys.monitoring.rst:118 +#: library/sys.monitoring.rst:125 msgid "" "Return from a Python function (occurs immediately before the return, the " "callee's frame will be on the stack)." msgstr "" -#: library/sys.monitoring.rst:122 +#: library/sys.monitoring.rst:129 msgid "" "Start of a Python function (occurs immediately after the call, the callee's " "frame will be on the stack)" msgstr "" -#: library/sys.monitoring.rst:126 +#: library/sys.monitoring.rst:133 msgid "A Python function is resumed by a ``throw()`` call." msgstr "" -#: library/sys.monitoring.rst:130 +#: library/sys.monitoring.rst:137 msgid "Exit from a Python function during exception unwinding." msgstr "" -#: library/sys.monitoring.rst:134 +#: library/sys.monitoring.rst:141 msgid "" "Yield from a Python function (occurs immediately before the yield, the " "callee's frame will be on the stack)." msgstr "" -#: library/sys.monitoring.rst:138 +#: library/sys.monitoring.rst:145 msgid "" "An exception is raised, except those that cause a :monitoring-event:" "`STOP_ITERATION` event." msgstr "" -#: library/sys.monitoring.rst:142 +#: library/sys.monitoring.rst:149 msgid "" "An exception is re-raised, for example at the end of a :keyword:`finally` " "block." msgstr "" -#: library/sys.monitoring.rst:146 +#: library/sys.monitoring.rst:153 msgid "" "An artificial :exc:`StopIteration` is raised; see `the STOP_ITERATION " "event`_." msgstr "" -#: library/sys.monitoring.rst:149 +#: library/sys.monitoring.rst:156 msgid "More events may be added in the future." msgstr "" -#: library/sys.monitoring.rst:151 +#: library/sys.monitoring.rst:158 msgid "" "These events are attributes of the :mod:`!sys.monitoring.events` namespace. " "Each event is represented as a power-of-2 integer constant. To define a set " @@ -217,84 +225,84 @@ msgid "" "events, use the expression ``PY_RETURN | PY_START``." msgstr "" -#: library/sys.monitoring.rst:159 +#: library/sys.monitoring.rst:166 msgid "An alias for ``0`` so users can do explict comparisions like::" msgstr "" -#: library/sys.monitoring.rst:164 +#: library/sys.monitoring.rst:171 msgid "Events are divided into three groups:" msgstr "" -#: library/sys.monitoring.rst:167 +#: library/sys.monitoring.rst:174 msgid "Local events" msgstr "" -#: library/sys.monitoring.rst:169 +#: library/sys.monitoring.rst:176 msgid "" "Local events are associated with normal execution of the program and happen " "at clearly defined locations. All local events can be disabled. The local " "events are:" msgstr "" -#: library/sys.monitoring.rst:173 +#: library/sys.monitoring.rst:180 msgid ":monitoring-event:`PY_START`" msgstr "" -#: library/sys.monitoring.rst:174 +#: library/sys.monitoring.rst:181 msgid ":monitoring-event:`PY_RESUME`" msgstr "" -#: library/sys.monitoring.rst:175 +#: library/sys.monitoring.rst:182 msgid ":monitoring-event:`PY_RETURN`" msgstr "" -#: library/sys.monitoring.rst:176 +#: library/sys.monitoring.rst:183 msgid ":monitoring-event:`PY_YIELD`" msgstr "" -#: library/sys.monitoring.rst:177 +#: library/sys.monitoring.rst:184 msgid ":monitoring-event:`CALL`" msgstr "" -#: library/sys.monitoring.rst:178 +#: library/sys.monitoring.rst:185 msgid ":monitoring-event:`LINE`" msgstr "" -#: library/sys.monitoring.rst:179 +#: library/sys.monitoring.rst:186 msgid ":monitoring-event:`INSTRUCTION`" msgstr "" -#: library/sys.monitoring.rst:180 +#: library/sys.monitoring.rst:187 msgid ":monitoring-event:`JUMP`" msgstr "" -#: library/sys.monitoring.rst:181 +#: library/sys.monitoring.rst:188 msgid ":monitoring-event:`BRANCH`" msgstr "" -#: library/sys.monitoring.rst:182 +#: library/sys.monitoring.rst:189 msgid ":monitoring-event:`STOP_ITERATION`" msgstr "" -#: library/sys.monitoring.rst:185 +#: library/sys.monitoring.rst:192 msgid "Ancillary events" msgstr "" -#: library/sys.monitoring.rst:187 +#: library/sys.monitoring.rst:194 msgid "" "Ancillary events can be monitored like other events, but are controlled by " "another event:" msgstr "" -#: library/sys.monitoring.rst:190 +#: library/sys.monitoring.rst:197 msgid ":monitoring-event:`C_RAISE`" msgstr "" -#: library/sys.monitoring.rst:191 +#: library/sys.monitoring.rst:198 msgid ":monitoring-event:`C_RETURN`" msgstr "" -#: library/sys.monitoring.rst:193 +#: library/sys.monitoring.rst:200 msgid "" "The :monitoring-event:`C_RETURN` and :monitoring-event:`C_RAISE` events are " "controlled by the :monitoring-event:`CALL` event. :monitoring-event:" @@ -302,41 +310,41 @@ msgid "" "corresponding :monitoring-event:`CALL` event is being monitored." msgstr "" -#: library/sys.monitoring.rst:199 +#: library/sys.monitoring.rst:206 msgid "Other events" msgstr "" -#: library/sys.monitoring.rst:201 +#: library/sys.monitoring.rst:208 msgid "" "Other events are not necessarily tied to a specific location in the program " "and cannot be individually disabled." msgstr "" -#: library/sys.monitoring.rst:204 +#: library/sys.monitoring.rst:211 msgid "The other events that can be monitored are:" msgstr "" -#: library/sys.monitoring.rst:206 +#: library/sys.monitoring.rst:213 msgid ":monitoring-event:`PY_THROW`" msgstr "" -#: library/sys.monitoring.rst:207 +#: library/sys.monitoring.rst:214 msgid ":monitoring-event:`PY_UNWIND`" msgstr "" -#: library/sys.monitoring.rst:208 +#: library/sys.monitoring.rst:215 msgid ":monitoring-event:`RAISE`" msgstr "" -#: library/sys.monitoring.rst:209 +#: library/sys.monitoring.rst:216 msgid ":monitoring-event:`EXCEPTION_HANDLED`" msgstr "" -#: library/sys.monitoring.rst:213 +#: library/sys.monitoring.rst:220 msgid "The STOP_ITERATION event" msgstr "" -#: library/sys.monitoring.rst:215 +#: library/sys.monitoring.rst:222 msgid "" ":pep:`PEP 380 <380#use-of-stopiteration-to-return-values>` specifies that a :" "exc:`StopIteration` exception is raised when returning a value from a " @@ -345,7 +353,7 @@ msgid "" "an exception unless it would be visible to other code." msgstr "" -#: library/sys.monitoring.rst:221 +#: library/sys.monitoring.rst:228 msgid "" "To allow tools to monitor for real exceptions without slowing down " "generators and coroutines, the :monitoring-event:`STOP_ITERATION` event is " @@ -353,83 +361,83 @@ msgid "" "unlike :monitoring-event:`RAISE`." msgstr "" -#: library/sys.monitoring.rst:227 +#: library/sys.monitoring.rst:234 msgid "Turning events on and off" msgstr "" -#: library/sys.monitoring.rst:229 +#: library/sys.monitoring.rst:236 msgid "" "In order to monitor an event, it must be turned on and a corresponding " "callback must be registered. Events can be turned on or off by setting the " "events either globally or for a particular code object." msgstr "" -#: library/sys.monitoring.rst:236 +#: library/sys.monitoring.rst:243 msgid "Setting events globally" msgstr "" -#: library/sys.monitoring.rst:238 +#: library/sys.monitoring.rst:245 msgid "" "Events can be controlled globally by modifying the set of events being " "monitored." msgstr "" -#: library/sys.monitoring.rst:242 +#: library/sys.monitoring.rst:249 msgid "Returns the ``int`` representing all the active events." msgstr "" -#: library/sys.monitoring.rst:246 +#: library/sys.monitoring.rst:253 msgid "" "Activates all events which are set in *event_set*. Raises a :exc:" "`ValueError` if *tool_id* is not in use." msgstr "" -#: library/sys.monitoring.rst:249 +#: library/sys.monitoring.rst:256 msgid "No events are active by default." msgstr "" -#: library/sys.monitoring.rst:252 +#: library/sys.monitoring.rst:259 msgid "Per code object events" msgstr "" -#: library/sys.monitoring.rst:254 +#: library/sys.monitoring.rst:261 msgid "Events can also be controlled on a per code object basis." msgstr "" -#: library/sys.monitoring.rst:258 +#: library/sys.monitoring.rst:265 msgid "Returns all the local events for *code*" msgstr "" -#: library/sys.monitoring.rst:262 +#: library/sys.monitoring.rst:269 msgid "" "Activates all the local events for *code* which are set in *event_set*. " "Raises a :exc:`ValueError` if *tool_id* is not in use." msgstr "" -#: library/sys.monitoring.rst:265 +#: library/sys.monitoring.rst:272 msgid "" "Local events add to global events, but do not mask them. In other words, all " "global events will trigger for a code object, regardless of the local events." msgstr "" -#: library/sys.monitoring.rst:271 +#: library/sys.monitoring.rst:278 msgid "Disabling events" msgstr "" -#: library/sys.monitoring.rst:275 +#: library/sys.monitoring.rst:282 msgid "" "A special value that can be returned from a callback function to disable " "events for the current code location." msgstr "" -#: library/sys.monitoring.rst:278 +#: library/sys.monitoring.rst:285 msgid "" "Local events can be disabled for a specific code location by returning :data:" "`sys.monitoring.DISABLE` from a callback function. This does not change " "which events are set, or any other code locations for the same event." msgstr "" -#: library/sys.monitoring.rst:282 +#: library/sys.monitoring.rst:289 msgid "" "Disabling events for specific locations is very important for high " "performance monitoring. For example, a program can be run under a debugger " @@ -437,105 +445,105 @@ msgid "" "breakpoints." msgstr "" -#: library/sys.monitoring.rst:289 +#: library/sys.monitoring.rst:296 msgid "" "Enable all the events that were disabled by :data:`sys.monitoring.DISABLE` " "for all tools." msgstr "" -#: library/sys.monitoring.rst:296 +#: library/sys.monitoring.rst:303 msgid "Registering callback functions" msgstr "" -#: library/sys.monitoring.rst:298 +#: library/sys.monitoring.rst:305 msgid "To register a callable for events call" msgstr "" -#: library/sys.monitoring.rst:302 +#: library/sys.monitoring.rst:309 msgid "Registers the callable *func* for the *event* with the given *tool_id*" msgstr "" -#: library/sys.monitoring.rst:304 +#: library/sys.monitoring.rst:311 msgid "" "If another callback was registered for the given *tool_id* and *event*, it " "is unregistered and returned. Otherwise :func:`register_callback` returns " "``None``." msgstr "" -#: library/sys.monitoring.rst:309 +#: library/sys.monitoring.rst:316 msgid "" "Functions can be unregistered by calling ``sys.monitoring." "register_callback(tool_id, event, None)``." msgstr "" -#: library/sys.monitoring.rst:312 +#: library/sys.monitoring.rst:319 msgid "Callback functions can be registered and unregistered at any time." msgstr "" -#: library/sys.monitoring.rst:314 +#: library/sys.monitoring.rst:321 msgid "" "Registering or unregistering a callback function will generate a :func:`sys." "audit` event." msgstr "" -#: library/sys.monitoring.rst:318 +#: library/sys.monitoring.rst:325 msgid "Callback function arguments" msgstr "" -#: library/sys.monitoring.rst:322 +#: library/sys.monitoring.rst:329 msgid "" "A special value that is passed to a callback function to indicate that there " "are no arguments to the call." msgstr "" -#: library/sys.monitoring.rst:325 +#: library/sys.monitoring.rst:332 msgid "" "When an active event occurs, the registered callback function is called. " "Different events will provide the callback function with different " "arguments, as follows:" msgstr "" -#: library/sys.monitoring.rst:328 +#: library/sys.monitoring.rst:335 msgid ":monitoring-event:`PY_START` and :monitoring-event:`PY_RESUME`::" msgstr "" -#: library/sys.monitoring.rst:332 +#: library/sys.monitoring.rst:339 msgid ":monitoring-event:`PY_RETURN` and :monitoring-event:`PY_YIELD`::" msgstr "" -#: library/sys.monitoring.rst:336 +#: library/sys.monitoring.rst:343 msgid "" ":monitoring-event:`CALL`, :monitoring-event:`C_RAISE` and :monitoring-event:" "`C_RETURN`::" msgstr "" -#: library/sys.monitoring.rst:340 +#: library/sys.monitoring.rst:347 msgid "" "If there are no arguments, *arg0* is set to :data:`sys.monitoring.MISSING`." msgstr "" -#: library/sys.monitoring.rst:342 +#: library/sys.monitoring.rst:349 msgid "" ":monitoring-event:`RAISE`, :monitoring-event:`RERAISE`, :monitoring-event:" "`EXCEPTION_HANDLED`, :monitoring-event:`PY_UNWIND`, :monitoring-event:" "`PY_THROW` and :monitoring-event:`STOP_ITERATION`::" msgstr "" -#: library/sys.monitoring.rst:347 +#: library/sys.monitoring.rst:354 msgid ":monitoring-event:`LINE`::" msgstr "" -#: library/sys.monitoring.rst:351 +#: library/sys.monitoring.rst:358 msgid ":monitoring-event:`BRANCH` and :monitoring-event:`JUMP`::" msgstr "" -#: library/sys.monitoring.rst:355 +#: library/sys.monitoring.rst:362 msgid "" "Note that the *destination_offset* is where the code will next execute. For " "an untaken branch this will be the offset of the instruction following the " "branch." msgstr "" -#: library/sys.monitoring.rst:359 +#: library/sys.monitoring.rst:366 msgid ":monitoring-event:`INSTRUCTION`::" msgstr "" diff --git a/library/test.po b/library/test.po index d488ebcfe..554c07414 100644 --- a/library/test.po +++ b/library/test.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -178,7 +178,7 @@ msgstr "" msgid "Running tests using the command-line interface" msgstr "" -#: library/test.rst:162 +#: library/test.rst:165 msgid "" "The :mod:`test` package can be run as a script to drive Python's regression " "test suite, thanks to the :option:`-m` option: :program:`python -m test`. " @@ -194,7 +194,7 @@ msgid "" "print whether the test passed or failed." msgstr "" -#: library/test.rst:175 +#: library/test.rst:178 msgid "" "Running :mod:`test` directly allows what resources are available for tests " "to use to be set. You do this by using the ``-u`` command-line option. " @@ -207,7 +207,7 @@ msgid "" "more command-line options, run :program:`python -m test -h`." msgstr "" -#: library/test.rst:186 +#: library/test.rst:189 msgid "" "Some other ways to execute the regression tests depend on what platform the " "tests are being executed on. On Unix, you can run :program:`make test` at " @@ -216,142 +216,142 @@ msgid "" "tests." msgstr "" -#: library/test.rst:194 +#: library/test.rst:197 msgid ":mod:`test.support` --- Utilities for the Python test suite" msgstr "" -#: library/test.rst:200 +#: library/test.rst:203 msgid "" "The :mod:`test.support` module provides support for Python's regression test " "suite." msgstr "" -#: library/test.rst:205 +#: library/test.rst:208 msgid "" ":mod:`test.support` is not a public module. It is documented here to help " "Python developers write tests. The API of this module is subject to change " "without backwards compatibility concerns between releases." msgstr "" -#: library/test.rst:210 +#: library/test.rst:213 msgid "This module defines the following exceptions:" msgstr "" -#: library/test.rst:214 +#: library/test.rst:217 msgid "" "Exception to be raised when a test fails. This is deprecated in favor of :" "mod:`unittest`\\ -based tests and :class:`unittest.TestCase`'s assertion " "methods." msgstr "" -#: library/test.rst:221 +#: library/test.rst:224 msgid "" "Subclass of :exc:`unittest.SkipTest`. Raised when a resource (such as a " "network connection) is not available. Raised by the :func:`requires` " "function." msgstr "" -#: library/test.rst:226 +#: library/test.rst:229 msgid "The :mod:`test.support` module defines the following constants:" msgstr "" -#: library/test.rst:230 +#: library/test.rst:233 msgid "" "``True`` when verbose output is enabled. Should be checked when more " "detailed information is desired about a running test. *verbose* is set by :" "mod:`test.regrtest`." msgstr "" -#: library/test.rst:237 +#: library/test.rst:240 msgid "``True`` if the running interpreter is Jython." msgstr "" -#: library/test.rst:242 +#: library/test.rst:245 msgid "``True`` if the system is Android." msgstr "" -#: library/test.rst:247 +#: library/test.rst:250 msgid "Path for shell if not on Windows; otherwise ``None``." msgstr "" -#: library/test.rst:252 +#: library/test.rst:255 msgid "" "Timeout in seconds for tests using a network server listening on the network " "local loopback interface like ``127.0.0.1``." msgstr "" -#: library/test.rst:255 +#: library/test.rst:258 msgid "" "The timeout is long enough to prevent test failure: it takes into account " "that the client and the server can run in different threads or even " "different processes." msgstr "" -#: library/test.rst:259 +#: library/test.rst:262 msgid "" "The timeout should be long enough for :meth:`~socket.socket.connect`, :meth:" "`~socket.socket.recv` and :meth:`~socket.socket.send` methods of :class:" "`socket.socket`." msgstr "" -#: library/test.rst:263 +#: library/test.rst:266 msgid "Its default value is 5 seconds." msgstr "" -#: library/test.rst:265 +#: library/test.rst:268 msgid "See also :data:`INTERNET_TIMEOUT`." msgstr "" -#: library/test.rst:270 +#: library/test.rst:273 msgid "Timeout in seconds for network requests going to the internet." msgstr "" -#: library/test.rst:272 +#: library/test.rst:275 msgid "" "The timeout is short enough to prevent a test to wait for too long if the " "internet request is blocked for whatever reason." msgstr "" -#: library/test.rst:275 +#: library/test.rst:278 msgid "" "Usually, a timeout using :data:`INTERNET_TIMEOUT` should not mark a test as " "failed, but skip the test instead: see :func:`~test.support.socket_helper." "transient_internet`." msgstr "" -#: library/test.rst:279 +#: library/test.rst:282 msgid "Its default value is 1 minute." msgstr "" -#: library/test.rst:281 +#: library/test.rst:284 msgid "See also :data:`LOOPBACK_TIMEOUT`." msgstr "" -#: library/test.rst:286 +#: library/test.rst:289 msgid "" "Timeout in seconds to mark a test as failed if the test takes \"too long\"." msgstr "" -#: library/test.rst:288 +#: library/test.rst:291 msgid "" "The timeout value depends on the regrtest ``--timeout`` command line option." msgstr "" -#: library/test.rst:290 +#: library/test.rst:293 msgid "" "If a test using :data:`SHORT_TIMEOUT` starts to fail randomly on slow " "buildbots, use :data:`LONG_TIMEOUT` instead." msgstr "" -#: library/test.rst:293 +#: library/test.rst:296 msgid "Its default value is 30 seconds." msgstr "" -#: library/test.rst:298 +#: library/test.rst:301 msgid "Timeout in seconds to detect when a test hangs." msgstr "" -#: library/test.rst:300 +#: library/test.rst:303 msgid "" "It is long enough to reduce the risk of test failure on the slowest Python " "buildbots. It should not be used to mark a test as failed if the test takes " @@ -359,172 +359,172 @@ msgid "" "command line option." msgstr "" -#: library/test.rst:305 +#: library/test.rst:308 msgid "Its default value is 5 minutes." msgstr "" -#: library/test.rst:307 +#: library/test.rst:310 msgid "" "See also :data:`LOOPBACK_TIMEOUT`, :data:`INTERNET_TIMEOUT` and :data:" "`SHORT_TIMEOUT`." msgstr "" -#: library/test.rst:313 +#: library/test.rst:316 msgid "Set when tests can be skipped when they are not useful for PGO." msgstr "" -#: library/test.rst:318 +#: library/test.rst:321 msgid "" "A constant that is likely larger than the underlying OS pipe buffer size, to " "make writes blocking." msgstr "" -#: library/test.rst:324 +#: library/test.rst:327 msgid "" "True if Python is built with the :c:macro:`Py_DEBUG` macro defined: if " "Python is :ref:`built in debug mode ` (:option:`./configure --" "with-pydebug <--with-pydebug>`)." msgstr "" -#: library/test.rst:333 +#: library/test.rst:336 msgid "" "A constant that is likely larger than the underlying OS socket buffer size, " "to make writes blocking." msgstr "" -#: library/test.rst:339 +#: library/test.rst:342 msgid "Set to the top level directory that contains :mod:`test.support`." msgstr "" -#: library/test.rst:344 +#: library/test.rst:347 msgid "Set to the top level directory for the test package." msgstr "" -#: library/test.rst:349 +#: library/test.rst:352 msgid "Set to the ``data`` directory within the test package." msgstr "" -#: library/test.rst:354 +#: library/test.rst:357 msgid "Set to :data:`sys.maxsize` for big memory tests." msgstr "" -#: library/test.rst:359 +#: library/test.rst:362 msgid "" "Set by :func:`set_memlimit` as the memory limit for big memory tests. " "Limited by :data:`MAX_Py_ssize_t`." msgstr "" -#: library/test.rst:365 +#: library/test.rst:368 msgid "" "Set by :func:`set_memlimit` as the memory limit for big memory tests. Not " "limited by :data:`MAX_Py_ssize_t`." msgstr "" -#: library/test.rst:371 +#: library/test.rst:374 msgid "" "Set to ``True`` if Python is built without docstrings (the :c:macro:" "`WITH_DOC_STRINGS` macro is not defined). See the :option:`configure --" "without-doc-strings <--without-doc-strings>` option." msgstr "" -#: library/test.rst:375 +#: library/test.rst:378 msgid "See also the :data:`HAVE_DOCSTRINGS` variable." msgstr "" -#: library/test.rst:380 +#: library/test.rst:383 msgid "" "Set to ``True`` if function docstrings are available. See the :option:" "`python -OO <-O>` option, which strips docstrings of functions implemented " "in Python." msgstr "" -#: library/test.rst:383 +#: library/test.rst:386 msgid "See also the :data:`MISSING_C_DOCSTRINGS` variable." msgstr "" -#: library/test.rst:388 +#: library/test.rst:391 msgid "Define the URL of a dedicated HTTP server for the network tests." msgstr "" -#: library/test.rst:393 +#: library/test.rst:396 msgid "Object that is equal to anything. Used to test mixed type comparison." msgstr "" -#: library/test.rst:398 +#: library/test.rst:401 msgid "" "Object that is not equal to anything (even to :data:`ALWAYS_EQ`). Used to " "test mixed type comparison." msgstr "" -#: library/test.rst:404 +#: library/test.rst:407 msgid "" "Object that is greater than anything (except itself). Used to test mixed " "type comparison." msgstr "" -#: library/test.rst:410 +#: library/test.rst:413 msgid "" "Object that is less than anything (except itself). Used to test mixed type " "comparison." msgstr "" -#: library/test.rst:414 +#: library/test.rst:417 msgid "The :mod:`test.support` module defines the following functions:" msgstr "" -#: library/test.rst:418 +#: library/test.rst:421 msgid "Run the loop body until ``break`` stops the loop." msgstr "" -#: library/test.rst:420 +#: library/test.rst:423 msgid "" "After *timeout* seconds, raise an :exc:`AssertionError` if *error* is true, " "or just stop the loop if *error* is false." msgstr "" -#: library/test.rst:423 +#: library/test.rst:426 msgid "Example::" msgstr "" -#: library/test.rst:453 +#: library/test.rst:456 msgid "Example of error=False usage::" msgstr "" -#: library/test.rst:439 +#: library/test.rst:442 msgid "Wait strategy that applies exponential backoff." msgstr "" -#: library/test.rst:441 +#: library/test.rst:444 msgid "" "Run the loop body until ``break`` stops the loop. Sleep at each loop " "iteration, but not at the first iteration. The sleep delay is doubled at " "each iteration (up to *max_delay* seconds)." msgstr "" -#: library/test.rst:445 +#: library/test.rst:448 msgid "See :func:`busy_retry` documentation for the parameters usage." msgstr "" -#: library/test.rst:447 +#: library/test.rst:450 msgid "Example raising an exception after SHORT_TIMEOUT seconds::" msgstr "" -#: library/test.rst:463 +#: library/test.rst:466 msgid "" "Return ``True`` if *resource* is enabled and available. The list of " "available resources is only set when :mod:`test.regrtest` is executing the " "tests." msgstr "" -#: library/test.rst:470 +#: library/test.rst:473 msgid "Return ``True`` if Python was not built with ``-O0`` or ``-Og``." msgstr "" -#: library/test.rst:475 +#: library/test.rst:478 msgid "Return :const:`_testcapi.WITH_PYMALLOC`." msgstr "" -#: library/test.rst:480 +#: library/test.rst:483 msgid "" "Raise :exc:`ResourceDenied` if *resource* is not available. *msg* is the " "argument to :exc:`ResourceDenied` if it is raised. Always returns ``True`` " @@ -532,89 +532,89 @@ msgid "" "tests are executed by :mod:`test.regrtest`." msgstr "" -#: library/test.rst:488 +#: library/test.rst:491 msgid "Return a repr of *dict* with keys sorted." msgstr "" -#: library/test.rst:493 +#: library/test.rst:496 msgid "" "Return the path to the file named *filename*. If no match is found " "*filename* is returned. This does not equal a failure since it could be the " "path to the file." msgstr "" -#: library/test.rst:497 +#: library/test.rst:500 msgid "" "Setting *subdir* indicates a relative path to use to find the file rather " "than looking directly in the path directories." msgstr "" -#: library/test.rst:503 +#: library/test.rst:506 msgid "Get size of a page in bytes." msgstr "" -#: library/test.rst:510 +#: library/test.rst:513 msgid "" "Set the :func:`sys.setswitchinterval` to the given *interval*. Defines a " "minimum interval for Android systems to prevent the system from hanging." msgstr "" -#: library/test.rst:516 +#: library/test.rst:519 msgid "" "Use this check to guard CPython's implementation-specific tests or to run " "them only on the implementations guarded by the arguments. This function " "returns ``True`` or ``False`` depending on the host platform. Example usage::" msgstr "" -#: library/test.rst:528 +#: library/test.rst:531 msgid "" "Set the values for :data:`max_memuse` and :data:`real_max_memuse` for big " "memory tests." msgstr "" -#: library/test.rst:534 +#: library/test.rst:537 msgid "" "Store the value from *stdout*. It is meant to hold the stdout at the time " "the regrtest began." msgstr "" -#: library/test.rst:540 +#: library/test.rst:543 msgid "" "Return the original stdout set by :func:`record_original_stdout` or ``sys." "stdout`` if it's not set." msgstr "" -#: library/test.rst:546 +#: library/test.rst:549 msgid "" "Return a list of command line arguments reproducing the current settings in " "``sys.flags`` and ``sys.warnoptions``." msgstr "" -#: library/test.rst:552 +#: library/test.rst:555 msgid "" "Return a list of command line arguments reproducing the current optimization " "settings in ``sys.flags``." msgstr "" -#: library/test.rst:560 +#: library/test.rst:563 msgid "" "A context managers that temporarily replaces the named stream with :class:" "`io.StringIO` object." msgstr "" -#: library/test.rst:563 +#: library/test.rst:566 msgid "Example use with output streams::" msgstr "" -#: library/test.rst:571 +#: library/test.rst:574 msgid "Example use with input stream::" msgstr "" -#: library/test.rst:583 +#: library/test.rst:586 msgid "A context manager that temporary disables :mod:`faulthandler`." msgstr "" -#: library/test.rst:588 +#: library/test.rst:591 msgid "" "Force as many objects as possible to be collected. This is needed because " "timely deallocation is not guaranteed by the garbage collector. This means " @@ -622,111 +622,111 @@ msgid "" "remain alive for longer than expected." msgstr "" -#: library/test.rst:596 +#: library/test.rst:599 msgid "" "A context manager that disables the garbage collector on entry. On exit, the " "garbage collector is restored to its prior state." msgstr "" -#: library/test.rst:602 +#: library/test.rst:605 msgid "Context manager to swap out an attribute with a new object." msgstr "" -#: library/test.rst:622 library/test.rst:1323 +#: library/test.rst:625 library/test.rst:1326 msgid "Usage::" msgstr "" -#: library/test.rst:609 +#: library/test.rst:612 msgid "" "This will set ``obj.attr`` to 5 for the duration of the ``with`` block, " "restoring the old value at the end of the block. If ``attr`` doesn't exist " "on ``obj``, it will be created and then deleted at the end of the block." msgstr "" -#: library/test.rst:632 +#: library/test.rst:635 msgid "" "The old value (or ``None`` if it doesn't exist) will be assigned to the " "target of the \"as\" clause, if there is one." msgstr "" -#: library/test.rst:620 +#: library/test.rst:623 msgid "Context manager to swap out an item with a new object." msgstr "" -#: library/test.rst:627 +#: library/test.rst:630 msgid "" "This will set ``obj[\"item\"]`` to 5 for the duration of the ``with`` block, " "restoring the old value at the end of the block. If ``item`` doesn't exist " "on ``obj``, it will be created and then deleted at the end of the block." msgstr "" -#: library/test.rst:638 +#: library/test.rst:641 msgid "" "Call the ``flush()`` method on :data:`sys.stdout` and then on :data:`sys." "stderr`. It can be used to make sure that the logs order is consistent " "before writing into stderr." msgstr "" -#: library/test.rst:647 +#: library/test.rst:650 msgid "" "Print a warning into :data:`sys.__stderr__`. Format the message as: " "``f\"Warning -- {msg}\"``. If *msg* is made of multiple lines, add " "``\"Warning -- \"`` prefix to each line." msgstr "" -#: library/test.rst:656 +#: library/test.rst:659 msgid "" "Wait until process *pid* completes and check that the process exit code is " "*exitcode*." msgstr "" -#: library/test.rst:659 +#: library/test.rst:662 msgid "" "Raise an :exc:`AssertionError` if the process exit code is not equal to " "*exitcode*." msgstr "" -#: library/test.rst:662 +#: library/test.rst:665 msgid "" "If the process runs longer than *timeout* seconds (:data:`SHORT_TIMEOUT` by " "default), kill the process and raise an :exc:`AssertionError`. The timeout " "feature is not available on Windows." msgstr "" -#: library/test.rst:671 +#: library/test.rst:674 msgid "" "Return the size of the :c:type:`PyObject` whose structure members are " "defined by *fmt*. The returned value includes the size of the Python object " "header and alignment." msgstr "" -#: library/test.rst:677 +#: library/test.rst:680 msgid "" "Return the size of the :c:type:`PyVarObject` whose structure members are " "defined by *fmt*. The returned value includes the size of the Python object " "header and alignment." msgstr "" -#: library/test.rst:683 +#: library/test.rst:686 msgid "" "For testcase *test*, assert that the ``sys.getsizeof`` for *o* plus the GC " "header size equals *size*." msgstr "" -#: library/test.rst:689 +#: library/test.rst:692 msgid "" "A decorator to conditionally mark tests with :func:`unittest." "expectedFailure`. Any use of this decorator should have an associated " "comment identifying the relevant tracker issue." msgstr "" -#: library/test.rst:696 +#: library/test.rst:699 msgid "" "A decorator that skips the decorated test on TLS certification validation " "failures." msgstr "" -#: library/test.rst:701 +#: library/test.rst:704 msgid "" "A decorator for running a function in a different locale, correctly " "resetting it after it has finished. *catstr* is the locale category as a " @@ -734,79 +734,79 @@ msgid "" "sequentially, and the first valid locale will be used." msgstr "" -#: library/test.rst:709 +#: library/test.rst:712 msgid "" "A decorator for running a function in a specific timezone, correctly " "resetting it after it has finished." msgstr "" -#: library/test.rst:715 +#: library/test.rst:718 msgid "" "Decorator for the minimum version when running test on FreeBSD. If the " "FreeBSD version is less than the minimum, the test is skipped." msgstr "" -#: library/test.rst:721 +#: library/test.rst:724 msgid "" "Decorator for the minimum version when running test on Linux. If the Linux " "version is less than the minimum, the test is skipped." msgstr "" -#: library/test.rst:727 +#: library/test.rst:730 msgid "" "Decorator for the minimum version when running test on macOS. If the macOS " "version is less than the minimum, the test is skipped." msgstr "" -#: library/test.rst:733 +#: library/test.rst:736 msgid "Decorator for skipping tests on non-IEEE 754 platforms." msgstr "" -#: library/test.rst:738 +#: library/test.rst:741 msgid "Decorator for skipping tests if :mod:`zlib` doesn't exist." msgstr "" -#: library/test.rst:743 +#: library/test.rst:746 msgid "Decorator for skipping tests if :mod:`gzip` doesn't exist." msgstr "" -#: library/test.rst:748 +#: library/test.rst:751 msgid "Decorator for skipping tests if :mod:`bz2` doesn't exist." msgstr "" -#: library/test.rst:753 +#: library/test.rst:756 msgid "Decorator for skipping tests if :mod:`lzma` doesn't exist." msgstr "" -#: library/test.rst:758 +#: library/test.rst:761 msgid "Decorator for skipping tests if *resource* is not available." msgstr "" -#: library/test.rst:763 +#: library/test.rst:766 msgid "Decorator for only running the test if :data:`HAVE_DOCSTRINGS`." msgstr "" -#: library/test.rst:768 +#: library/test.rst:771 msgid "" "Decorator for only running the test if :ref:`Limited C API ` " "is available." msgstr "" -#: library/test.rst:774 +#: library/test.rst:777 msgid "Decorator for tests only applicable to CPython." msgstr "" -#: library/test.rst:779 +#: library/test.rst:782 msgid "" "Decorator for invoking :func:`check_impl_detail` on *guards*. If that " "returns ``False``, then uses *msg* as the reason for skipping the test." msgstr "" -#: library/test.rst:785 +#: library/test.rst:788 msgid "Decorator to temporarily turn off tracing for the duration of the test." msgstr "" -#: library/test.rst:790 +#: library/test.rst:793 msgid "" "Decorator for tests which involve reference counting. The decorator does " "not run the test if it is not run by CPython. Any trace function is unset " @@ -814,11 +814,11 @@ msgid "" "trace function." msgstr "" -#: library/test.rst:798 +#: library/test.rst:801 msgid "Decorator for bigmem tests." msgstr "" -#: library/test.rst:800 +#: library/test.rst:803 msgid "" "*size* is a requested size for the test (in arbitrary, test-interpreted " "units.) *memuse* is the number of bytes per unit for the test, or a good " @@ -826,7 +826,7 @@ msgid "" "each, could be decorated with ``@bigmemtest(size=_4G, memuse=2)``." msgstr "" -#: library/test.rst:805 +#: library/test.rst:808 msgid "" "The *size* argument is normally passed to the decorated test method as an " "extra argument. If *dry_run* is ``True``, the value passed to the test " @@ -834,11 +834,11 @@ msgid "" "means the test doesn't support dummy runs when ``-M`` is not specified." msgstr "" -#: library/test.rst:813 +#: library/test.rst:816 msgid "Decorator for tests that fill the address space." msgstr "" -#: library/test.rst:818 +#: library/test.rst:821 msgid "" "Test for syntax errors in *statement* by attempting to compile *statement*. " "*testcase* is the :mod:`unittest` instance for the test. *errtext* is the " @@ -848,44 +848,44 @@ msgid "" "of the exception." msgstr "" -#: library/test.rst:828 +#: library/test.rst:831 msgid "Open *url*. If open fails, raises :exc:`TestFailed`." msgstr "" -#: library/test.rst:833 +#: library/test.rst:836 msgid "" "Use this at the end of ``test_main`` whenever sub-processes are started. " "This will help ensure that no extra children (zombies) stick around to hog " "resources and create problems when looking for refleaks." msgstr "" -#: library/test.rst:840 +#: library/test.rst:843 msgid "" "Get an attribute, raising :exc:`unittest.SkipTest` if :exc:`AttributeError` " "is raised." msgstr "" -#: library/test.rst:846 +#: library/test.rst:849 msgid "" "Context manager catching unraisable exception using :func:`sys." "unraisablehook`." msgstr "" -#: library/test.rst:849 +#: library/test.rst:852 msgid "" "Storing the exception value (``cm.unraisable.exc_value``) creates a " "reference cycle. The reference cycle is broken explicitly when the context " "manager exits." msgstr "" -#: library/test.rst:853 +#: library/test.rst:856 msgid "" "Storing the object (``cm.unraisable.object``) can resurrect it if it is set " "to an object which is being finalized. Exiting the context manager clears " "the stored object." msgstr "" -#: library/test.rst:874 +#: library/test.rst:877 msgid "" "Generic implementation of the :mod:`unittest` ``load_tests`` protocol for " "use in test packages. *pkg_dir* is the root directory of the package; " @@ -894,55 +894,55 @@ msgid "" "the following::" msgstr "" -#: library/test.rst:889 +#: library/test.rst:892 msgid "" "Returns the set of attributes, functions or methods of *ref_api* not found " "on *other_api*, except for a defined list of items to be ignored in this " "check specified in *ignore*." msgstr "" -#: library/test.rst:893 +#: library/test.rst:896 msgid "" "By default this skips private attributes beginning with '_' but includes all " "magic methods, i.e. those starting and ending in '__'." msgstr "" -#: library/test.rst:901 +#: library/test.rst:904 msgid "" "Override *object_to_patch.attr_name* with *new_value*. Also add cleanup " "procedure to *test_instance* to restore *object_to_patch* for *attr_name*. " "The *attr_name* should be a valid attribute for *object_to_patch*." msgstr "" -#: library/test.rst:909 +#: library/test.rst:912 msgid "" "Run *code* in subinterpreter. Raise :exc:`unittest.SkipTest` if :mod:" "`tracemalloc` is enabled." msgstr "" -#: library/test.rst:915 +#: library/test.rst:918 msgid "Assert instances of *cls* are deallocated after iterating." msgstr "" -#: library/test.rst:920 +#: library/test.rst:923 msgid "" "Check for the existence of the compiler executables whose names are listed " "in *cmd_names* or all the compiler executables when *cmd_names* is empty and " "return the first missing executable or ``None`` when none is found missing." msgstr "" -#: library/test.rst:928 +#: library/test.rst:931 msgid "" "Assert that the ``__all__`` variable of *module* contains all public names." msgstr "" -#: library/test.rst:930 +#: library/test.rst:933 msgid "" "The module's public names (its API) are detected automatically based on " "whether they match the public name convention and were defined in *module*." msgstr "" -#: library/test.rst:934 +#: library/test.rst:937 msgid "" "The *name_of_module* argument can specify (as a string or tuple thereof) " "what module(s) an API could be defined in order to be detected as a public " @@ -950,7 +950,7 @@ msgid "" "other modules, possibly a C backend (like ``csv`` and its ``_csv``)." msgstr "" -#: library/test.rst:939 +#: library/test.rst:942 msgid "" "The *extra* argument can be a set of names that wouldn't otherwise be " "automatically detected as \"public\", like objects without a proper " @@ -958,28 +958,28 @@ msgid "" "detected ones." msgstr "" -#: library/test.rst:943 +#: library/test.rst:946 msgid "" "The *not_exported* argument can be a set of names that must not be treated " "as part of the public API even though their names indicate otherwise." msgstr "" -#: library/test.rst:1572 +#: library/test.rst:1575 msgid "Example use::" msgstr "" -#: library/test.rst:969 +#: library/test.rst:972 msgid "" "Skip tests if the :mod:`multiprocessing.synchronize` module is missing, if " "there is no available semaphore implementation, or if creating a lock raises " "an :exc:`OSError`." msgstr "" -#: library/test.rst:978 +#: library/test.rst:981 msgid "Assert that type *tp* cannot be instantiated using *args* and *kwds*." msgstr "" -#: library/test.rst:985 +#: library/test.rst:988 msgid "" "This function returns a context manager that will change the global :func:" "`sys.set_int_max_str_digits` setting for the duration of the context to " @@ -987,73 +987,73 @@ msgid "" "digits when converting between an integer and string." msgstr "" -#: library/test.rst:993 +#: library/test.rst:996 msgid "The :mod:`test.support` module defines the following classes:" msgstr "" -#: library/test.rst:998 +#: library/test.rst:1001 msgid "" "A context manager used to try to prevent crash dialog popups on tests that " "are expected to crash a subprocess." msgstr "" -#: library/test.rst:1001 +#: library/test.rst:1004 msgid "" "On Windows, it disables Windows Error Reporting dialogs using `SetErrorMode " "`_." msgstr "" -#: library/test.rst:1004 +#: library/test.rst:1007 msgid "" "On UNIX, :func:`resource.setrlimit` is used to set :const:`resource." "RLIMIT_CORE`'s soft limit to 0 to prevent coredump file creation." msgstr "" -#: library/test.rst:1008 +#: library/test.rst:1011 msgid "" "On both platforms, the old value is restored by :meth:`~object.__exit__`." msgstr "" -#: library/test.rst:1013 +#: library/test.rst:1016 msgid "" "Class to save and restore signal handlers registered by the Python signal " "handler." msgstr "" -#: library/test.rst:1018 +#: library/test.rst:1021 msgid "" "Save the signal handlers to a dictionary mapping signal numbers to the " "current signal handler." msgstr "" -#: library/test.rst:1023 +#: library/test.rst:1026 msgid "" "Set the signal numbers from the :meth:`save` dictionary to the saved handler." msgstr "" -#: library/test.rst:1031 +#: library/test.rst:1034 msgid "Try to match a single dict with the supplied arguments." msgstr "" -#: library/test.rst:1036 +#: library/test.rst:1039 msgid "Try to match a single stored value (*dv*) with a supplied value (*v*)." msgstr "" -#: library/test.rst:1040 +#: library/test.rst:1043 msgid ":mod:`test.support.socket_helper` --- Utilities for socket tests" msgstr "" -#: library/test.rst:1046 +#: library/test.rst:1049 msgid "" "The :mod:`test.support.socket_helper` module provides support for socket " "tests." msgstr "" -#: library/test.rst:1053 +#: library/test.rst:1056 msgid "Set to ``True`` if IPv6 is enabled on this host, ``False`` otherwise." msgstr "" -#: library/test.rst:1058 +#: library/test.rst:1061 msgid "" "Returns an unused port that should be suitable for binding. This is " "achieved by creating a temporary socket with the same family and type as the " @@ -1064,7 +1064,7 @@ msgid "" "port is returned." msgstr "" -#: library/test.rst:1067 +#: library/test.rst:1070 msgid "" "Either this method or :func:`bind_port` should be used for any tests where a " "server socket needs to be bound to a particular port for the duration of the " @@ -1077,7 +1077,7 @@ msgid "" "simultaneously, which is a problem for buildbots." msgstr "" -#: library/test.rst:1081 +#: library/test.rst:1084 msgid "" "Bind the socket to a free port and return the port number. Relies on " "ephemeral ports in order to ensure we are using an unbound port. This is " @@ -1090,7 +1090,7 @@ msgid "" "testing multicasting via multiple UDP sockets." msgstr "" -#: library/test.rst:1092 +#: library/test.rst:1095 msgid "" "Additionally, if the :const:`~socket.SO_EXCLUSIVEADDRUSE` socket option is " "available (i.e. on Windows), it will be set on the socket. This will " @@ -1098,58 +1098,58 @@ msgid "" "test." msgstr "" -#: library/test.rst:1100 +#: library/test.rst:1103 msgid "" "Bind a Unix socket, raising :exc:`unittest.SkipTest` if :exc:" "`PermissionError` is raised." msgstr "" -#: library/test.rst:1106 +#: library/test.rst:1109 msgid "" "A decorator for running tests that require a functional ``bind()`` for Unix " "sockets." msgstr "" -#: library/test.rst:1112 +#: library/test.rst:1115 msgid "" "A context manager that raises :exc:`~test.support.ResourceDenied` when " "various issues with the internet connection manifest themselves as " "exceptions." msgstr "" -#: library/test.rst:1118 +#: library/test.rst:1121 msgid "" ":mod:`test.support.script_helper` --- Utilities for the Python execution " "tests" msgstr "" -#: library/test.rst:1124 +#: library/test.rst:1127 msgid "" "The :mod:`test.support.script_helper` module provides support for Python's " "script execution tests." msgstr "" -#: library/test.rst:1129 +#: library/test.rst:1132 msgid "" "Return ``True`` if ``sys.executable interpreter`` requires environment " "variables in order to be able to run at all." msgstr "" -#: library/test.rst:1132 +#: library/test.rst:1135 msgid "" "This is designed to be used with ``@unittest.skipIf()`` to annotate tests " "that need to use an ``assert_python*()`` function to launch an isolated mode " "(``-I``) or no environment mode (``-E``) sub-interpreter process." msgstr "" -#: library/test.rst:1136 +#: library/test.rst:1139 msgid "" "A normal build & test does not run into this situation but it can happen " "when trying to run the standard library test suite from an interpreter that " "doesn't have an obvious home with Python's current home finding logic." msgstr "" -#: library/test.rst:1140 +#: library/test.rst:1143 msgid "" "Setting :envvar:`PYTHONHOME` is one way to get most of the testsuite to run " "in that situation. :envvar:`PYTHONPATH` or :envvar:`PYTHONUSERSITE` are " @@ -1157,84 +1157,84 @@ msgid "" "interpreter can start." msgstr "" -#: library/test.rst:1148 +#: library/test.rst:1151 msgid "" "Set up the environment based on *env_vars* for running the interpreter in a " "subprocess. The values can include ``__isolated``, ``__cleanenv``, " "``__cwd``, and ``TERM``." msgstr "" -#: library/test.rst:1168 library/test.rst:1180 +#: library/test.rst:1171 library/test.rst:1183 msgid "The function no longer strips whitespaces from *stderr*." msgstr "" -#: library/test.rst:1158 +#: library/test.rst:1161 msgid "" "Assert that running the interpreter with *args* and optional environment " "variables *env_vars* succeeds (``rc == 0``) and return a ``(return code, " "stdout, stderr)`` tuple." msgstr "" -#: library/test.rst:1162 +#: library/test.rst:1165 msgid "" "If the *__cleanenv* keyword-only parameter is set, *env_vars* is used as a " "fresh environment." msgstr "" -#: library/test.rst:1165 +#: library/test.rst:1168 msgid "" "Python is started in isolated mode (command line option ``-I``), except if " "the *__isolated* keyword-only parameter is set to ``False``." msgstr "" -#: library/test.rst:1174 +#: library/test.rst:1177 msgid "" "Assert that running the interpreter with *args* and optional environment " "variables *env_vars* fails (``rc != 0``) and return a ``(return code, " "stdout, stderr)`` tuple." msgstr "" -#: library/test.rst:1178 +#: library/test.rst:1181 msgid "See :func:`assert_python_ok` for more options." msgstr "" -#: library/test.rst:1186 +#: library/test.rst:1189 msgid "Run a Python subprocess with the given arguments." msgstr "" -#: library/test.rst:1188 +#: library/test.rst:1191 msgid "" "*kw* is extra keyword args to pass to :func:`subprocess.Popen`. Returns a :" "class:`subprocess.Popen` object." msgstr "" -#: library/test.rst:1194 +#: library/test.rst:1197 msgid "" "Run the given :class:`subprocess.Popen` process until completion and return " "stdout." msgstr "" -#: library/test.rst:1200 +#: library/test.rst:1203 msgid "" "Create script containing *source* in path *script_dir* and " "*script_basename*. If *omit_suffix* is ``False``, append ``.py`` to the " "name. Return the full script path." msgstr "" -#: library/test.rst:1207 +#: library/test.rst:1210 msgid "" "Create zip file at *zip_dir* and *zip_basename* with extension ``zip`` which " "contains the files in *script_name*. *name_in_zip* is the archive name. " "Return a tuple containing ``(full path, full path of archive name)``." msgstr "" -#: library/test.rst:1214 +#: library/test.rst:1217 msgid "" "Create a directory named *pkg_dir* containing an ``__init__`` file with " "*init_source* as its contents." msgstr "" -#: library/test.rst:1221 +#: library/test.rst:1224 msgid "" "Create a zip package directory with a path of *zip_dir* and *zip_basename* " "containing an empty ``__init__`` file and a file *script_basename* " @@ -1243,60 +1243,60 @@ msgid "" "path and the archive name for the zip file." msgstr "" -#: library/test.rst:1229 +#: library/test.rst:1232 msgid "" ":mod:`test.support.bytecode_helper` --- Support tools for testing correct " "bytecode generation" msgstr "" -#: library/test.rst:1234 +#: library/test.rst:1237 msgid "" "The :mod:`test.support.bytecode_helper` module provides support for testing " "and inspecting bytecode generation." msgstr "" -#: library/test.rst:1239 +#: library/test.rst:1242 msgid "The module defines the following class:" msgstr "" -#: library/test.rst:1243 +#: library/test.rst:1246 msgid "This class has custom assertion methods for inspecting bytecode." msgstr "" -#: library/test.rst:1247 +#: library/test.rst:1250 msgid "Return the disassembly of *co* as string." msgstr "" -#: library/test.rst:1252 +#: library/test.rst:1255 msgid "" "Return instr if *opname* is found, otherwise throws :exc:`AssertionError`." msgstr "" -#: library/test.rst:1257 +#: library/test.rst:1260 msgid "Throws :exc:`AssertionError` if *opname* is found." msgstr "" -#: library/test.rst:1261 +#: library/test.rst:1264 msgid ":mod:`test.support.threading_helper` --- Utilities for threading tests" msgstr "" -#: library/test.rst:1266 +#: library/test.rst:1269 msgid "" "The :mod:`test.support.threading_helper` module provides support for " "threading tests." msgstr "" -#: library/test.rst:1273 +#: library/test.rst:1276 msgid "" "Join a *thread* within *timeout*. Raise an :exc:`AssertionError` if thread " "is still alive after *timeout* seconds." msgstr "" -#: library/test.rst:1279 +#: library/test.rst:1282 msgid "Decorator to ensure the threads are cleaned up even if the test fails." msgstr "" -#: library/test.rst:1284 +#: library/test.rst:1287 msgid "" "Context manager to start *threads*, which is a sequence of threads. *unlock* " "is a function called after the threads are started, even if an exception was " @@ -1304,79 +1304,79 @@ msgid "" "will attempt to join the started threads upon exit." msgstr "" -#: library/test.rst:1292 +#: library/test.rst:1295 msgid "" "Cleanup up threads not specified in *original_values*. Designed to emit a " "warning if a test leaves running threads in the background." msgstr "" -#: library/test.rst:1298 +#: library/test.rst:1301 msgid "Return current thread count and copy of dangling threads." msgstr "" -#: library/test.rst:1303 +#: library/test.rst:1306 msgid "" "Context manager to wait until all threads created in the ``with`` statement " "exit." msgstr "" -#: library/test.rst:1309 +#: library/test.rst:1312 msgid "" "Context manager catching :class:`threading.Thread` exception using :func:" "`threading.excepthook`." msgstr "" -#: library/test.rst:1312 +#: library/test.rst:1315 msgid "Attributes set when an exception is caught:" msgstr "" -#: library/test.rst:1314 +#: library/test.rst:1317 msgid "``exc_type``" msgstr "" -#: library/test.rst:1315 +#: library/test.rst:1318 msgid "``exc_value``" msgstr "" -#: library/test.rst:1316 +#: library/test.rst:1319 msgid "``exc_traceback``" msgstr "" -#: library/test.rst:1317 +#: library/test.rst:1320 msgid "``thread``" msgstr "" -#: library/test.rst:1319 +#: library/test.rst:1322 msgid "See :func:`threading.excepthook` documentation." msgstr "" -#: library/test.rst:1321 +#: library/test.rst:1324 msgid "These attributes are deleted at the context manager exit." msgstr "" -#: library/test.rst:1341 +#: library/test.rst:1344 msgid ":mod:`test.support.os_helper` --- Utilities for os tests" msgstr "" -#: library/test.rst:1346 +#: library/test.rst:1349 msgid "The :mod:`test.support.os_helper` module provides support for os tests." msgstr "" -#: library/test.rst:1353 +#: library/test.rst:1356 msgid "A non-ASCII character encodable by :func:`os.fsencode`." msgstr "" -#: library/test.rst:1358 +#: library/test.rst:1361 msgid "Set to :func:`os.getcwd`." msgstr "" -#: library/test.rst:1363 +#: library/test.rst:1366 msgid "" "Set to a name that is safe to use as the name of a temporary file. Any " "temporary file that is created should be closed and unlinked (removed)." msgstr "" -#: library/test.rst:1369 +#: library/test.rst:1372 msgid "" "Set to a filename containing the :data:`FS_NONASCII` character, if it " "exists. This guarantees that if the filename exists, it can be encoded and " @@ -1384,25 +1384,25 @@ msgid "" "a non-ASCII filename to be easily skipped on platforms where they can't work." msgstr "" -#: library/test.rst:1377 +#: library/test.rst:1380 msgid "" "Set to a filename (str type) that should not be able to be encoded by file " "system encoding in strict mode. It may be ``None`` if it's not possible to " "generate such a filename." msgstr "" -#: library/test.rst:1384 +#: library/test.rst:1387 msgid "" "Set to a filename (bytes type) that should not be able to be decoded by file " "system encoding in strict mode. It may be ``None`` if it's not possible to " "generate such a filename." msgstr "" -#: library/test.rst:1391 +#: library/test.rst:1394 msgid "Set to a non-ASCII name for a temporary file." msgstr "" -#: library/test.rst:1396 +#: library/test.rst:1399 msgid "" "Class used to temporarily set or unset environment variables. Instances can " "be used as a context manager and have a complete dictionary interface for " @@ -1411,75 +1411,75 @@ msgid "" "instance will be rolled back." msgstr "" -#: library/test.rst:1402 +#: library/test.rst:1405 msgid "Added dictionary interface." msgstr "" -#: library/test.rst:1408 +#: library/test.rst:1411 msgid "" "Simple :term:`path-like object`. It implements the :meth:`__fspath__` " "method which just returns the *path* argument. If *path* is an exception, " "it will be raised in :meth:`!__fspath__`." msgstr "" -#: library/test.rst:1415 +#: library/test.rst:1418 msgid "" "Temporarily set the environment variable ``envvar`` to the value of " "``value``." msgstr "" -#: library/test.rst:1421 +#: library/test.rst:1424 msgid "Temporarily unset the environment variable ``envvar``." msgstr "" -#: library/test.rst:1426 +#: library/test.rst:1429 msgid "Return ``True`` if the OS supports symbolic links, ``False`` otherwise." msgstr "" -#: library/test.rst:1432 +#: library/test.rst:1435 msgid "Return ``True`` if the OS supports xattr, ``False`` otherwise." msgstr "" -#: library/test.rst:1438 +#: library/test.rst:1441 msgid "" "A context manager that temporarily changes the current working directory to " "*path* and yields the directory." msgstr "" -#: library/test.rst:1441 +#: library/test.rst:1444 msgid "" "If *quiet* is ``False``, the context manager raises an exception on error. " "Otherwise, it issues only a warning and keeps the current working directory " "the same." msgstr "" -#: library/test.rst:1448 +#: library/test.rst:1451 msgid "" "Create an empty file with *filename*. If it already exists, truncate it." msgstr "" -#: library/test.rst:1453 +#: library/test.rst:1456 msgid "Count the number of open file descriptors." msgstr "" -#: library/test.rst:1458 +#: library/test.rst:1461 msgid "Return ``True`` if the file system for *directory* is case-insensitive." msgstr "" -#: library/test.rst:1463 +#: library/test.rst:1466 msgid "" "Create an invalid file descriptor by opening and closing a temporary file, " "and returning its descriptor." msgstr "" -#: library/test.rst:1469 +#: library/test.rst:1472 msgid "" "Call :func:`os.rmdir` on *filename*. On Windows platforms, this is wrapped " "with a wait loop that checks for the existence of the file, which is needed " "due to antivirus programs that can hold files open and prevent deletion." msgstr "" -#: library/test.rst:1477 +#: library/test.rst:1480 msgid "" "Call :func:`shutil.rmtree` on *path* or call :func:`os.lstat` and :func:`os." "rmdir` to remove a path and its contents. As with :func:`rmdir`, on Windows " @@ -1487,21 +1487,21 @@ msgid "" "the files." msgstr "" -#: library/test.rst:1485 +#: library/test.rst:1488 msgid "A decorator for running tests that require support for symbolic links." msgstr "" -#: library/test.rst:1490 +#: library/test.rst:1493 msgid "A decorator for running tests that require support for xattr." msgstr "" -#: library/test.rst:1495 +#: library/test.rst:1498 msgid "" "A context manager that temporarily creates a new directory and changes the " "current working directory (CWD)." msgstr "" -#: library/test.rst:1498 +#: library/test.rst:1501 msgid "" "The context manager creates a temporary directory in the current directory " "with name *name* before temporarily changing the current working directory. " @@ -1509,20 +1509,20 @@ msgid "" "`tempfile.mkdtemp`." msgstr "" -#: library/test.rst:1503 +#: library/test.rst:1506 msgid "" "If *quiet* is ``False`` and it is not possible to create or change the CWD, " "an error is raised. Otherwise, only a warning is raised and the original " "CWD is used." msgstr "" -#: library/test.rst:1510 +#: library/test.rst:1513 msgid "" "A context manager that creates a temporary directory at *path* and yields " "the directory." msgstr "" -#: library/test.rst:1513 +#: library/test.rst:1516 msgid "" "If *path* is ``None``, the temporary directory is created using :func:" "`tempfile.mkdtemp`. If *quiet* is ``False``, the context manager raises an " @@ -1530,34 +1530,34 @@ msgid "" "created, only a warning is issued." msgstr "" -#: library/test.rst:1521 +#: library/test.rst:1524 msgid "A context manager that temporarily sets the process umask." msgstr "" -#: library/test.rst:1526 +#: library/test.rst:1529 msgid "" "Call :func:`os.unlink` on *filename*. As with :func:`rmdir`, on Windows " "platforms, this is wrapped with a wait loop that checks for the existence of " "the file." msgstr "" -#: library/test.rst:1532 +#: library/test.rst:1535 msgid ":mod:`test.support.import_helper` --- Utilities for import tests" msgstr "" -#: library/test.rst:1537 +#: library/test.rst:1540 msgid "" "The :mod:`test.support.import_helper` module provides support for import " "tests." msgstr "" -#: library/test.rst:1544 +#: library/test.rst:1547 msgid "" "Remove the module named *module_name* from ``sys.modules`` and delete any " "byte-compiled files of the module." msgstr "" -#: library/test.rst:1550 +#: library/test.rst:1553 msgid "" "This function imports and returns a fresh copy of the named Python module by " "removing the named module from ``sys.modules`` before doing the import. Note " @@ -1565,46 +1565,46 @@ msgid "" "operation." msgstr "" -#: library/test.rst:1555 +#: library/test.rst:1558 msgid "" "*fresh* is an iterable of additional module names that are also removed from " "the ``sys.modules`` cache before doing the import." msgstr "" -#: library/test.rst:1558 +#: library/test.rst:1561 msgid "" "*blocked* is an iterable of module names that are replaced with ``None`` in " "the module cache during the import to ensure that attempts to import them " "raise :exc:`ImportError`." msgstr "" -#: library/test.rst:1562 +#: library/test.rst:1565 msgid "" "The named module and any modules named in the *fresh* and *blocked* " "parameters are saved before starting the import and then reinserted into " "``sys.modules`` when the fresh import is complete." msgstr "" -#: library/test.rst:1566 +#: library/test.rst:1569 msgid "" "Module and package deprecation messages are suppressed during this import if " "*deprecated* is ``True``." msgstr "" -#: library/test.rst:1569 +#: library/test.rst:1572 msgid "" "This function will raise :exc:`ImportError` if the named module cannot be " "imported." msgstr "" -#: library/test.rst:1586 +#: library/test.rst:1589 msgid "" "This function imports and returns the named module. Unlike a normal import, " "this function raises :exc:`unittest.SkipTest` if the module cannot be " "imported." msgstr "" -#: library/test.rst:1590 +#: library/test.rst:1593 msgid "" "Module and package deprecation messages are suppressed during this import if " "*deprecated* is ``True``. If a module is required on a platform but " @@ -1612,21 +1612,21 @@ msgid "" "which will be compared against :data:`sys.platform`." msgstr "" -#: library/test.rst:1600 +#: library/test.rst:1603 msgid "Return a copy of :data:`sys.modules`." msgstr "" -#: library/test.rst:1605 +#: library/test.rst:1608 msgid "" "Remove modules except for *oldmodules* and ``encodings`` in order to " "preserve internal cache." msgstr "" -#: library/test.rst:1611 +#: library/test.rst:1614 msgid "Delete *name* from ``sys.modules``." msgstr "" -#: library/test.rst:1616 +#: library/test.rst:1619 msgid "" "Move a :pep:`3147`/:pep:`488` pyc file to its legacy pyc location and return " "the file system path to the legacy pyc file. The *source* value is the file " @@ -1634,42 +1634,42 @@ msgid "" "3147/488 pyc file must exist." msgstr "" -#: library/test.rst:1624 +#: library/test.rst:1627 msgid "" "A context manager to force import to return a new module reference. This is " "useful for testing module-level behaviors, such as the emission of a :exc:" "`DeprecationWarning` on import. Example usage::" msgstr "" -#: library/test.rst:1634 +#: library/test.rst:1637 msgid "A context manager to temporarily add directories to :data:`sys.path`." msgstr "" -#: library/test.rst:1636 +#: library/test.rst:1639 msgid "" "This makes a copy of :data:`sys.path`, appends any directories given as " "positional arguments, then reverts :data:`sys.path` to the copied settings " "when the context ends." msgstr "" -#: library/test.rst:1640 +#: library/test.rst:1643 msgid "" "Note that *all* :data:`sys.path` modifications in the body of the context " "manager, including replacement of the object, will be reverted at the end of " "the block." msgstr "" -#: library/test.rst:1646 +#: library/test.rst:1649 msgid ":mod:`test.support.warnings_helper` --- Utilities for warnings tests" msgstr "" -#: library/test.rst:1651 +#: library/test.rst:1654 msgid "" "The :mod:`test.support.warnings_helper` module provides support for warnings " "tests." msgstr "" -#: library/test.rst:1658 +#: library/test.rst:1661 msgid "" "Suppress warnings that are instances of *category*, which must be :exc:" "`Warning` or a subclass. Roughly equivalent to :func:`warnings." @@ -1677,14 +1677,14 @@ msgid "" "category=category) `. For example::" msgstr "" -#: library/test.rst:1673 +#: library/test.rst:1676 msgid "" "Context manager to check that no :exc:`ResourceWarning` was raised. You " "must remove the object which may emit :exc:`ResourceWarning` before the end " "of the context manager." msgstr "" -#: library/test.rst:1680 +#: library/test.rst:1683 msgid "" "Test for syntax warning in *statement* by attempting to compile *statement*. " "Test also that the :exc:`SyntaxWarning` is emitted only once, and that it " @@ -1696,7 +1696,7 @@ msgid "" "``None``, compares to the offset of the exception." msgstr "" -#: library/test.rst:1694 +#: library/test.rst:1697 msgid "" "A convenience wrapper for :func:`warnings.catch_warnings()` that makes it " "easier to test that a warning was correctly raised. It is approximately " @@ -1705,7 +1705,7 @@ msgid "" "automatically validate the results that are recorded." msgstr "" -#: library/test.rst:1700 +#: library/test.rst:1703 msgid "" "``check_warnings`` accepts 2-tuples of the form ``(\"message regexp\", " "WarningCategory)`` as positional arguments. If one or more *filters* are " @@ -1717,15 +1717,15 @@ msgid "" "*quiet* to ``True``." msgstr "" -#: library/test.rst:1709 +#: library/test.rst:1712 msgid "If no arguments are specified, it defaults to::" msgstr "" -#: library/test.rst:1713 +#: library/test.rst:1716 msgid "In this case all warnings are caught and no errors are raised." msgstr "" -#: library/test.rst:1715 +#: library/test.rst:1718 msgid "" "On entry to the context manager, a :class:`WarningRecorder` instance is " "returned. The underlying warnings list from :func:`~warnings.catch_warnings` " @@ -1737,39 +1737,39 @@ msgid "" "return ``None``." msgstr "" -#: library/test.rst:1724 +#: library/test.rst:1727 msgid "" "The recorder object also has a :meth:`reset` method, which clears the " "warnings list." msgstr "" -#: library/test.rst:1727 +#: library/test.rst:1730 msgid "The context manager is designed to be used like this::" msgstr "" -#: library/test.rst:1734 +#: library/test.rst:1737 msgid "" "In this case if either warning was not raised, or some other warning was " "raised, :func:`check_warnings` would raise an error." msgstr "" -#: library/test.rst:1737 +#: library/test.rst:1740 msgid "" "When a test needs to look more deeply into the warnings, rather than just " "checking whether or not they occurred, code like this can be used::" msgstr "" -#: library/test.rst:1751 +#: library/test.rst:1754 msgid "" "Here all warnings will be caught, and the test code tests the captured " "warnings directly." msgstr "" -#: library/test.rst:1754 +#: library/test.rst:1757 msgid "New optional arguments *filters* and *quiet*." msgstr "" -#: library/test.rst:1760 +#: library/test.rst:1763 msgid "" "Class used to record warnings for unit tests. See documentation of :func:" "`check_warnings` above for more details." diff --git a/library/tkinter.po b/library/tkinter.po index 8da13bf4b..fe761e4eb 100644 --- a/library/tkinter.po +++ b/library/tkinter.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: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -123,12 +123,12 @@ msgstr "" #: library/tkinter.rst:62 msgid "" -"`Python and Tkinter Programming `_" +"`Python GUI programming with Tkinter `_" msgstr "" #: library/tkinter.rst:62 -msgid "By Alan Moore. (ISBN 978-1788835886)" +msgid "By Alan D. Moore. (ISBN 978-1788835886)" msgstr "" #: library/tkinter.rst:65 @@ -181,7 +181,7 @@ msgid "" "difference (see `Threading model`_ for details)." msgstr "" -#: library/tkinter.rst:908 +#: library/tkinter.rst:911 msgid "Tk" msgstr "" @@ -441,11 +441,11 @@ msgstr "" msgid "Additional modules:" msgstr "" -#: library/tkinter.rst:240 +#: library/tkinter.rst:243 msgid ":mod:`_tkinter`" msgstr "" -#: library/tkinter.rst:236 +#: library/tkinter.rst:239 msgid "" "A binary module that contains the low-level interface to Tcl/Tk. It is " "automatically imported by the main :mod:`tkinter` module, and should never " @@ -454,60 +454,60 @@ msgid "" "interpreter." msgstr "" -#: library/tkinter.rst:244 +#: library/tkinter.rst:247 msgid ":mod:`idlelib`" msgstr "" -#: library/tkinter.rst:243 +#: library/tkinter.rst:246 msgid "" "Python's Integrated Development and Learning Environment (IDLE). Based on :" "mod:`tkinter`." msgstr "" -#: library/tkinter.rst:249 +#: library/tkinter.rst:252 msgid ":mod:`tkinter.constants`" msgstr "" -#: library/tkinter.rst:247 +#: library/tkinter.rst:250 msgid "" "Symbolic constants that can be used in place of strings when passing various " "parameters to Tkinter calls. Automatically imported by the main :mod:" "`tkinter` module." msgstr "" -#: library/tkinter.rst:253 +#: library/tkinter.rst:256 msgid ":mod:`tkinter.dnd`" msgstr "" -#: library/tkinter.rst:252 +#: library/tkinter.rst:255 msgid "" "(experimental) Drag-and-drop support for :mod:`tkinter`. This will become " "deprecated when it is replaced with the Tk DND." msgstr "" -#: library/tkinter.rst:257 +#: library/tkinter.rst:260 msgid ":mod:`tkinter.tix`" msgstr "" -#: library/tkinter.rst:256 +#: library/tkinter.rst:259 msgid "" "(deprecated) An older third-party Tcl/Tk package that adds several new " "widgets. Better alternatives for most can be found in :mod:`tkinter.ttk`." msgstr "" -#: library/tkinter.rst:261 +#: library/tkinter.rst:264 msgid ":mod:`turtle`" msgstr "" -#: library/tkinter.rst:260 +#: library/tkinter.rst:263 msgid "Turtle graphics in a Tk window." msgstr "" -#: library/tkinter.rst:264 +#: library/tkinter.rst:267 msgid "Tkinter Life Preserver" msgstr "" -#: library/tkinter.rst:266 +#: library/tkinter.rst:269 msgid "" "This section is not designed to be an exhaustive tutorial on either Tk or " "Tkinter. For that, refer to one of the external resources noted earlier. " @@ -516,7 +516,7 @@ msgid "" "how the Tkinter wrapper is structured." msgstr "" -#: library/tkinter.rst:272 +#: library/tkinter.rst:275 msgid "" "The remainder of this section will help you to identify the classes, " "methods, and options you'll need in your Tkinter application, and where to " @@ -524,18 +524,18 @@ msgid "" "reference manual." msgstr "" -#: library/tkinter.rst:279 +#: library/tkinter.rst:282 msgid "A Hello World Program" msgstr "" -#: library/tkinter.rst:281 +#: library/tkinter.rst:284 msgid "" "We'll start by walking through a \"Hello World\" application in Tkinter. " "This isn't the smallest one we could write, but has enough to illustrate " "some key concepts you'll need to know." msgstr "" -#: library/tkinter.rst:297 +#: library/tkinter.rst:300 msgid "" "After the imports, the next line creates an instance of the :class:`Tk` " "class, which initializes Tk and creates its associated Tcl interpreter. It " @@ -543,56 +543,56 @@ msgid "" "the main window of the application." msgstr "" -#: library/tkinter.rst:302 +#: library/tkinter.rst:305 msgid "" "The following line creates a frame widget, which in this case will contain a " "label and a button we'll create next. The frame is fit inside the root " "window." msgstr "" -#: library/tkinter.rst:306 +#: library/tkinter.rst:309 msgid "" "The next line creates a label widget holding a static text string. The :meth:" "`grid` method is used to specify the relative layout (position) of the label " "within its containing frame widget, similar to how tables in HTML work." msgstr "" -#: library/tkinter.rst:310 +#: library/tkinter.rst:313 msgid "" "A button widget is then created, and placed to the right of the label. When " "pressed, it will call the :meth:`destroy` method of the root window." msgstr "" -#: library/tkinter.rst:313 +#: library/tkinter.rst:316 msgid "" "Finally, the :meth:`mainloop` method puts everything on the display, and " "responds to user input until the program terminates." msgstr "" -#: library/tkinter.rst:319 +#: library/tkinter.rst:322 msgid "Important Tk Concepts" msgstr "" -#: library/tkinter.rst:321 +#: library/tkinter.rst:324 msgid "Even this simple program illustrates the following key Tk concepts:" msgstr "" -#: library/tkinter.rst:326 +#: library/tkinter.rst:329 msgid "widgets" msgstr "" -#: library/tkinter.rst:324 +#: library/tkinter.rst:327 msgid "" "A Tkinter user interface is made up of individual *widgets*. Each widget is " "represented as a Python object, instantiated from classes like :class:`ttk." "Frame`, :class:`ttk.Label`, and :class:`ttk.Button`." msgstr "" -#: library/tkinter.rst:332 +#: library/tkinter.rst:335 msgid "widget hierarchy" msgstr "" -#: library/tkinter.rst:329 +#: library/tkinter.rst:332 msgid "" "Widgets are arranged in a *hierarchy*. The label and button were contained " "within a frame, which in turn was contained within the root window. When " @@ -600,44 +600,44 @@ msgid "" "argument to the widget constructor." msgstr "" -#: library/tkinter.rst:337 +#: library/tkinter.rst:340 msgid "configuration options" msgstr "" -#: library/tkinter.rst:335 +#: library/tkinter.rst:338 msgid "" "Widgets have *configuration options*, which modify their appearance and " "behavior, such as the text to display in a label or button. Different " "classes of widgets will have different sets of options." msgstr "" -#: library/tkinter.rst:342 +#: library/tkinter.rst:345 msgid "geometry management" msgstr "" -#: library/tkinter.rst:340 +#: library/tkinter.rst:343 msgid "" "Widgets aren't automatically added to the user interface when they are " "created. A *geometry manager* like ``grid`` controls where in the user " "interface they are placed." msgstr "" -#: library/tkinter.rst:348 +#: library/tkinter.rst:351 msgid "event loop" msgstr "" -#: library/tkinter.rst:345 +#: library/tkinter.rst:348 msgid "" "Tkinter reacts to user input, changes from your program, and even refreshes " "the display only when actively running an *event loop*. If your program " "isn't running the event loop, your user interface won't update." msgstr "" -#: library/tkinter.rst:351 +#: library/tkinter.rst:354 msgid "Understanding How Tkinter Wraps Tcl/Tk" msgstr "" -#: library/tkinter.rst:353 +#: library/tkinter.rst:356 msgid "" "When your application uses Tkinter's classes and methods, internally Tkinter " "is assembling strings representing Tcl/Tk commands, and executing those " @@ -645,7 +645,7 @@ msgid "" "instance." msgstr "" -#: library/tkinter.rst:358 +#: library/tkinter.rst:361 msgid "" "Whether it's trying to navigate reference documentation, trying to find the " "right method or option, adapting some existing code, or debugging your " @@ -653,13 +653,13 @@ msgid "" "what those underlying Tcl/Tk commands look like." msgstr "" -#: library/tkinter.rst:363 +#: library/tkinter.rst:366 msgid "" "To illustrate, here is the Tcl/Tk equivalent of the main part of the Tkinter " "script above." msgstr "" -#: library/tkinter.rst:374 +#: library/tkinter.rst:377 msgid "" "Tcl's syntax is similar to many shell languages, where the first word is the " "command to be executed, with arguments to that command following it, " @@ -667,25 +667,25 @@ msgid "" "following:" msgstr "" -#: library/tkinter.rst:378 +#: library/tkinter.rst:381 msgid "" "The commands used to create widgets (like ``ttk::frame``) correspond to " "widget classes in Tkinter." msgstr "" -#: library/tkinter.rst:381 +#: library/tkinter.rst:384 msgid "" "Tcl widget options (like ``-text``) correspond to keyword arguments in " "Tkinter." msgstr "" -#: library/tkinter.rst:384 +#: library/tkinter.rst:387 msgid "" "Widgets are referred to by a *pathname* in Tcl (like ``.frm.btn``), whereas " "Tkinter doesn't use names but object references." msgstr "" -#: library/tkinter.rst:387 +#: library/tkinter.rst:390 msgid "" "A widget's place in the widget hierarchy is encoded in its (hierarchical) " "pathname, which uses a ``.`` (dot) as a path separator. The pathname for the " @@ -693,7 +693,7 @@ msgid "" "pathname but by specifying the parent widget when creating each child widget." msgstr "" -#: library/tkinter.rst:393 +#: library/tkinter.rst:396 msgid "" "Operations which are implemented as separate *commands* in Tcl (like " "``grid`` or ``destroy``) are represented as *methods* on Tkinter widget " @@ -702,18 +702,18 @@ msgid "" "in Tkinter." msgstr "" -#: library/tkinter.rst:401 +#: library/tkinter.rst:404 msgid "How do I...? What option does...?" msgstr "" -#: library/tkinter.rst:403 +#: library/tkinter.rst:406 msgid "" "If you're not sure how to do something in Tkinter, and you can't immediately " "find it in the tutorial or reference documentation you're using, there are a " "few strategies that can be helpful." msgstr "" -#: library/tkinter.rst:407 +#: library/tkinter.rst:410 msgid "" "First, remember that the details of how individual widgets work may vary " "across different versions of both Tkinter and Tcl/Tk. If you're searching " @@ -721,7 +721,7 @@ msgid "" "installed on your system." msgstr "" -#: library/tkinter.rst:412 +#: library/tkinter.rst:415 msgid "" "When searching for how to use an API, it helps to know the exact name of the " "class, option, or method that you're using. Introspection, either in an " @@ -729,7 +729,7 @@ msgid "" "you need." msgstr "" -#: library/tkinter.rst:417 +#: library/tkinter.rst:420 msgid "" "To find out what configuration options are available on any widget, call " "its :meth:`configure` method, which returns a dictionary containing a " @@ -737,7 +737,7 @@ msgid "" "values. Use :meth:`keys` to get just the names of each option." msgstr "" -#: library/tkinter.rst:427 +#: library/tkinter.rst:430 msgid "" "As most widgets have many configuration options in common, it can be useful " "to find out which are specific to a particular widget class. Comparing the " @@ -745,7 +745,7 @@ msgid "" "that." msgstr "" -#: library/tkinter.rst:436 +#: library/tkinter.rst:439 msgid "" "Similarly, you can find the available methods for a widget object using the " "standard :func:`dir` function. If you try it, you'll see there are over 200 " @@ -753,11 +753,11 @@ msgid "" "is helpful." msgstr "" -#: library/tkinter.rst:448 +#: library/tkinter.rst:451 msgid "Navigating the Tcl/Tk Reference Manual" msgstr "" -#: library/tkinter.rst:450 +#: library/tkinter.rst:453 msgid "" "As noted, the official `Tk commands `_ reference manual (man pages) is often the most accurate " @@ -766,7 +766,7 @@ msgid "" "places to look." msgstr "" -#: library/tkinter.rst:455 +#: library/tkinter.rst:458 msgid "" "While all operations in Tkinter are implemented as method calls on widget " "objects, you've seen that many Tcl/Tk operations appear as commands that " @@ -774,7 +774,7 @@ msgid "" "parameters, e.g." msgstr "" -#: library/tkinter.rst:465 +#: library/tkinter.rst:468 msgid "" "Others, however, look more like methods called on a widget object (in fact, " "when you create a widget in Tcl/Tk, it creates a Tcl command with the name " @@ -782,7 +782,7 @@ msgid "" "name of a method to call)." msgstr "" -#: library/tkinter.rst:476 +#: library/tkinter.rst:479 msgid "" "In the official Tcl/Tk reference documentation, you'll find most operations " "that look like method calls on the man page for a specific widget (e.g., " @@ -792,7 +792,7 @@ msgid "" "www.tcl.tk/man/tcl8.6/TkCmd/grid.htm>`_)." msgstr "" -#: library/tkinter.rst:484 +#: library/tkinter.rst:487 msgid "" "You'll find many common options and methods in the `options `_ or `ttk::widget `_ man page." msgstr "" -#: library/tkinter.rst:495 +#: library/tkinter.rst:498 msgid "" "Somewhat confusingly, there are also methods on all Tkinter widgets that " "don't actually operate on the widget, but operate at a global scope, " @@ -817,17 +817,17 @@ msgid "" "class:`Widget` class that all Tkinter widgets inherit from)." msgstr "" -#: library/tkinter.rst:504 +#: library/tkinter.rst:507 msgid "Threading model" msgstr "" -#: library/tkinter.rst:506 +#: library/tkinter.rst:509 msgid "" "Python and Tcl/Tk have very different threading models, which :mod:`tkinter` " "tries to bridge. If you use threads, you may need to be aware of this." msgstr "" -#: library/tkinter.rst:509 +#: library/tkinter.rst:512 msgid "" "A Python interpreter may have many threads associated with it. In Tcl, " "multiple threads can be created, but each thread has a separate Tcl " @@ -836,7 +836,7 @@ msgid "" "by the one thread that created it." msgstr "" -#: library/tkinter.rst:514 +#: library/tkinter.rst:517 msgid "" "Each :class:`Tk` object created by :mod:`tkinter` contains a Tcl " "interpreter. It also keeps track of which thread created that interpreter. " @@ -846,7 +846,7 @@ msgid "" "executed, the result is returned to the calling Python thread." msgstr "" -#: library/tkinter.rst:521 +#: library/tkinter.rst:524 msgid "" "Tcl/Tk applications are normally event-driven, meaning that after " "initialization, the interpreter runs an event loop (i.e. :func:`Tk." @@ -859,18 +859,18 @@ msgid "" "event handlers." msgstr "" -#: library/tkinter.rst:530 +#: library/tkinter.rst:533 msgid "" "If the Tcl interpreter is not running the event loop and processing events, " "any :mod:`tkinter` calls made from threads other than the one running the " "Tcl interpreter will fail." msgstr "" -#: library/tkinter.rst:534 +#: library/tkinter.rst:537 msgid "A number of special cases exist:" msgstr "" -#: library/tkinter.rst:536 +#: library/tkinter.rst:539 msgid "" "Tcl/Tk libraries can be built so they are not thread-aware. In this case, :" "mod:`tkinter` calls the library from the originating Python thread, even if " @@ -878,7 +878,7 @@ msgid "" "lock ensures only one call occurs at a time." msgstr "" -#: library/tkinter.rst:541 +#: library/tkinter.rst:544 msgid "" "While :mod:`tkinter` allows you to create more than one instance of a :class:" "`Tk` object (with its own interpreter), all interpreters that are part of " @@ -888,7 +888,7 @@ msgid "" "running a thread-aware Tcl/Tk build." msgstr "" -#: library/tkinter.rst:547 +#: library/tkinter.rst:550 msgid "" "Blocking event handlers are not the only way to prevent the Tcl interpreter " "from reentering the event loop. It is even possible to run multiple nested " @@ -896,47 +896,47 @@ msgid "" "tricky when it comes to events or threads, be aware of these possibilities." msgstr "" -#: library/tkinter.rst:552 +#: library/tkinter.rst:555 msgid "" "There are a few select :mod:`tkinter` functions that presently work only " "when called from the thread that created the Tcl interpreter." msgstr "" -#: library/tkinter.rst:557 +#: library/tkinter.rst:560 msgid "Handy Reference" msgstr "" -#: library/tkinter.rst:563 +#: library/tkinter.rst:566 msgid "Setting Options" msgstr "" -#: library/tkinter.rst:565 +#: library/tkinter.rst:568 msgid "" "Options control things like the color and border width of a widget. Options " "can be set in three ways:" msgstr "" -#: library/tkinter.rst:571 +#: library/tkinter.rst:574 msgid "At object creation time, using keyword arguments" msgstr "" -#: library/tkinter.rst:577 +#: library/tkinter.rst:580 msgid "After object creation, treating the option name like a dictionary index" msgstr "" -#: library/tkinter.rst:582 +#: library/tkinter.rst:585 msgid "" "Use the config() method to update multiple attrs subsequent to object " "creation" msgstr "" -#: library/tkinter.rst:584 +#: library/tkinter.rst:587 msgid "" "For a complete explanation of a given option and its behavior, see the Tk " "man pages for the widget in question." msgstr "" -#: library/tkinter.rst:587 +#: library/tkinter.rst:590 msgid "" "Note that the man pages list \"STANDARD OPTIONS\" and \"WIDGET SPECIFIC " "OPTIONS\" for each widget. The former is a list of options that are common " @@ -945,7 +945,7 @@ msgid "" "`options(3)` man page." msgstr "" -#: library/tkinter.rst:593 +#: library/tkinter.rst:596 msgid "" "No distinction between standard and widget-specific options is made in this " "document. Some options don't apply to some kinds of widgets. Whether a " @@ -953,7 +953,7 @@ msgid "" "widget; buttons have a ``command`` option, labels do not." msgstr "" -#: library/tkinter.rst:598 +#: library/tkinter.rst:601 msgid "" "The options supported by a given widget are listed in that widget's man " "page, or can be queried at runtime by calling the :meth:`config` method " @@ -962,7 +962,7 @@ msgid "" "option as a string (for example, ``'relief'``) and whose values are 5-tuples." msgstr "" -#: library/tkinter.rst:604 +#: library/tkinter.rst:607 msgid "" "Some options, like ``bg`` are synonyms for common options with long names " "(``bg`` is shorthand for \"background\"). Passing the ``config()`` method " @@ -971,89 +971,89 @@ msgid "" "option (such as ``('bg', 'background')``)." msgstr "" -#: library/tkinter.rst:611 +#: library/tkinter.rst:614 msgid "Index" msgstr "" -#: library/tkinter.rst:611 +#: library/tkinter.rst:614 msgid "Meaning" msgstr "" -#: library/tkinter.rst:611 +#: library/tkinter.rst:614 msgid "Example" msgstr "" -#: library/tkinter.rst:613 +#: library/tkinter.rst:616 msgid "0" msgstr "" -#: library/tkinter.rst:613 +#: library/tkinter.rst:616 msgid "option name" msgstr "" -#: library/tkinter.rst:615 +#: library/tkinter.rst:618 msgid "``'relief'``" msgstr "" -#: library/tkinter.rst:615 +#: library/tkinter.rst:618 msgid "1" msgstr "" -#: library/tkinter.rst:615 +#: library/tkinter.rst:618 msgid "option name for database lookup" msgstr "" -#: library/tkinter.rst:617 +#: library/tkinter.rst:620 msgid "2" msgstr "" -#: library/tkinter.rst:617 +#: library/tkinter.rst:620 msgid "option class for database lookup" msgstr "" -#: library/tkinter.rst:617 +#: library/tkinter.rst:620 msgid "``'Relief'``" msgstr "" -#: library/tkinter.rst:620 +#: library/tkinter.rst:623 msgid "3" msgstr "" -#: library/tkinter.rst:620 +#: library/tkinter.rst:623 msgid "default value" msgstr "" -#: library/tkinter.rst:620 +#: library/tkinter.rst:623 msgid "``'raised'``" msgstr "" -#: library/tkinter.rst:622 +#: library/tkinter.rst:625 msgid "4" msgstr "" -#: library/tkinter.rst:622 +#: library/tkinter.rst:625 msgid "current value" msgstr "" -#: library/tkinter.rst:622 +#: library/tkinter.rst:625 msgid "``'groove'``" msgstr "" -#: library/tkinter.rst:625 +#: library/tkinter.rst:628 msgid "Example::" msgstr "" -#: library/tkinter.rst:630 +#: library/tkinter.rst:633 msgid "" "Of course, the dictionary printed will include all the options available and " "their values. This is meant only as an example." msgstr "" -#: library/tkinter.rst:635 +#: library/tkinter.rst:638 msgid "The Packer" msgstr "" -#: library/tkinter.rst:639 +#: library/tkinter.rst:642 msgid "" "The packer is one of Tk's geometry-management mechanisms. Geometry " "managers are used to specify the relative positioning of widgets within " @@ -1064,7 +1064,7 @@ msgid "" "coordinates for you." msgstr "" -#: library/tkinter.rst:646 +#: library/tkinter.rst:649 msgid "" "The size of any *master* widget is determined by the size of the \"slave " "widgets\" inside. The packer is used to control where slave widgets appear " @@ -1074,7 +1074,7 @@ msgid "" "accommodate incremental changes to the configuration, once it is packed." msgstr "" -#: library/tkinter.rst:653 +#: library/tkinter.rst:656 msgid "" "Note that widgets do not appear until they have had their geometry specified " "with a geometry manager. It's a common early mistake to leave out the " @@ -1083,79 +1083,79 @@ msgid "" "the packer's :meth:`pack` method applied to it." msgstr "" -#: library/tkinter.rst:659 +#: library/tkinter.rst:662 msgid "" "The pack() method can be called with keyword-option/value pairs that control " "where the widget is to appear within its container, and how it is to behave " "when the main application window is resized. Here are some examples::" msgstr "" -#: library/tkinter.rst:669 +#: library/tkinter.rst:672 msgid "Packer Options" msgstr "" -#: library/tkinter.rst:671 +#: library/tkinter.rst:674 msgid "" "For more extensive information on the packer and the options that it can " "take, see the man pages and page 183 of John Ousterhout's book." msgstr "" -#: library/tkinter.rst:795 +#: library/tkinter.rst:798 msgid "anchor" msgstr "" -#: library/tkinter.rst:675 +#: library/tkinter.rst:678 msgid "" "Anchor type. Denotes where the packer is to place each slave in its parcel." msgstr "" -#: library/tkinter.rst:678 +#: library/tkinter.rst:681 msgid "expand" msgstr "" -#: library/tkinter.rst:678 +#: library/tkinter.rst:681 msgid "Boolean, ``0`` or ``1``." msgstr "" -#: library/tkinter.rst:681 +#: library/tkinter.rst:684 msgid "fill" msgstr "" -#: library/tkinter.rst:681 +#: library/tkinter.rst:684 msgid "Legal values: ``'x'``, ``'y'``, ``'both'``, ``'none'``." msgstr "" -#: library/tkinter.rst:684 +#: library/tkinter.rst:687 msgid "ipadx and ipady" msgstr "" -#: library/tkinter.rst:684 +#: library/tkinter.rst:687 msgid "" "A distance - designating internal padding on each side of the slave widget." msgstr "" -#: library/tkinter.rst:687 +#: library/tkinter.rst:690 msgid "padx and pady" msgstr "" -#: library/tkinter.rst:687 +#: library/tkinter.rst:690 msgid "" "A distance - designating external padding on each side of the slave widget." msgstr "" -#: library/tkinter.rst:691 +#: library/tkinter.rst:694 msgid "side" msgstr "" -#: library/tkinter.rst:690 +#: library/tkinter.rst:693 msgid "Legal values are: ``'left'``, ``'right'``, ``'top'``, ``'bottom'``." msgstr "" -#: library/tkinter.rst:694 +#: library/tkinter.rst:697 msgid "Coupling Widget Variables" msgstr "" -#: library/tkinter.rst:696 +#: library/tkinter.rst:699 msgid "" "The current-value setting of some widgets (like text entry widgets) can be " "connected directly to application variables by using special options. These " @@ -1165,7 +1165,7 @@ msgid "" "value." msgstr "" -#: library/tkinter.rst:702 +#: library/tkinter.rst:705 msgid "" "Unfortunately, in the current implementation of :mod:`tkinter` it is not " "possible to hand over an arbitrary Python variable to a widget through a " @@ -1174,7 +1174,7 @@ msgid "" "Variable, defined in :mod:`tkinter`." msgstr "" -#: library/tkinter.rst:708 +#: library/tkinter.rst:711 msgid "" "There are many useful subclasses of Variable already defined: :class:" "`StringVar`, :class:`IntVar`, :class:`DoubleVar`, and :class:`BooleanVar`. " @@ -1184,15 +1184,15 @@ msgid "" "no further intervention on your part." msgstr "" -#: library/tkinter.rst:895 +#: library/tkinter.rst:898 msgid "For example::" msgstr "" -#: library/tkinter.rst:748 +#: library/tkinter.rst:751 msgid "The Window Manager" msgstr "" -#: library/tkinter.rst:752 +#: library/tkinter.rst:755 msgid "" "In Tk, there is a utility command, ``wm``, for interacting with the window " "manager. Options to the ``wm`` command allow you to control things like " @@ -1202,7 +1202,7 @@ msgid "" "the :class:`Wm` methods directly." msgstr "" -#: library/tkinter.rst:759 +#: library/tkinter.rst:762 msgid "" "To get at the toplevel window that contains a given widget, you can often " "just refer to the widget's master. Of course if the widget has been packed " @@ -1213,26 +1213,26 @@ msgid "" "to Tk functionality." msgstr "" -#: library/tkinter.rst:766 +#: library/tkinter.rst:769 msgid "Here are some examples of typical usage::" msgstr "" -#: library/tkinter.rst:791 +#: library/tkinter.rst:794 msgid "Tk Option Data Types" msgstr "" -#: library/tkinter.rst:794 +#: library/tkinter.rst:797 msgid "" "Legal values are points of the compass: ``\"n\"``, ``\"ne\"``, ``\"e\"``, " "``\"se\"``, ``\"s\"``, ``\"sw\"``, ``\"w\"``, ``\"nw\"``, and also " "``\"center\"``." msgstr "" -#: library/tkinter.rst:801 +#: library/tkinter.rst:804 msgid "bitmap" msgstr "" -#: library/tkinter.rst:798 +#: library/tkinter.rst:801 msgid "" "There are eight built-in, named bitmaps: ``'error'``, ``'gray25'``, " "``'gray50'``, ``'hourglass'``, ``'info'``, ``'questhead'``, ``'question'``, " @@ -1240,27 +1240,27 @@ msgid "" "file, preceded with an ``@``, as in ``\"@/usr/contrib/bitmap/gumby.bit\"``." msgstr "" -#: library/tkinter.rst:804 +#: library/tkinter.rst:807 msgid "boolean" msgstr "" -#: library/tkinter.rst:804 +#: library/tkinter.rst:807 msgid "You can pass integers 0 or 1 or the strings ``\"yes\"`` or ``\"no\"``." msgstr "" -#: library/tkinter.rst:811 +#: library/tkinter.rst:814 msgid "callback" msgstr "" -#: library/tkinter.rst:807 +#: library/tkinter.rst:810 msgid "This is any Python function that takes no arguments. For example::" msgstr "" -#: library/tkinter.rst:817 +#: library/tkinter.rst:820 msgid "color" msgstr "" -#: library/tkinter.rst:814 +#: library/tkinter.rst:817 msgid "" "Colors can be given as the names of X colors in the rgb.txt file, or as " "strings representing RGB values in 4 bit: ``\"#RGB\"``, 8 bit: " @@ -1269,11 +1269,11 @@ msgid "" "digit. See page 160 of Ousterhout's book for details." msgstr "" -#: library/tkinter.rst:823 +#: library/tkinter.rst:826 msgid "cursor" msgstr "" -#: library/tkinter.rst:820 +#: library/tkinter.rst:823 msgid "" "The standard X cursor names from :file:`cursorfont.h` can be used, without " "the ``XC_`` prefix. For example to get a hand cursor (:const:`XC_hand2`), " @@ -1281,11 +1281,11 @@ msgid "" "of your own. See page 179 of Ousterhout's book." msgstr "" -#: library/tkinter.rst:830 +#: library/tkinter.rst:833 msgid "distance" msgstr "" -#: library/tkinter.rst:826 +#: library/tkinter.rst:829 msgid "" "Screen distances can be specified in either pixels or absolute distances. " "Pixels are given as numbers and absolute distances as strings, with the " @@ -1294,120 +1294,120 @@ msgid "" "is expressed as ``\"3.5i\"``." msgstr "" -#: library/tkinter.rst:835 +#: library/tkinter.rst:838 msgid "font" msgstr "" -#: library/tkinter.rst:833 +#: library/tkinter.rst:836 msgid "" "Tk uses a list font name format, such as ``{courier 10 bold}``. Font sizes " "with positive numbers are measured in points; sizes with negative numbers " "are measured in pixels." msgstr "" -#: library/tkinter.rst:840 +#: library/tkinter.rst:843 msgid "geometry" msgstr "" -#: library/tkinter.rst:838 +#: library/tkinter.rst:841 msgid "" "This is a string of the form ``widthxheight``, where width and height are " "measured in pixels for most widgets (in characters for widgets displaying " "text). For example: ``fred[\"geometry\"] = \"200x100\"``." msgstr "" -#: library/tkinter.rst:844 +#: library/tkinter.rst:847 msgid "justify" msgstr "" -#: library/tkinter.rst:843 +#: library/tkinter.rst:846 msgid "" "Legal values are the strings: ``\"left\"``, ``\"center\"``, ``\"right\"``, " "and ``\"fill\"``." msgstr "" -#: library/tkinter.rst:849 +#: library/tkinter.rst:852 msgid "region" msgstr "" -#: library/tkinter.rst:847 +#: library/tkinter.rst:850 msgid "" "This is a string with four space-delimited elements, each of which is a " "legal distance (see above). For example: ``\"2 3 4 5\"`` and ``\"3i 2i 4.5i " "2i\"`` and ``\"3c 2c 4c 10.43c\"`` are all legal regions." msgstr "" -#: library/tkinter.rst:853 +#: library/tkinter.rst:856 msgid "relief" msgstr "" -#: library/tkinter.rst:852 +#: library/tkinter.rst:855 msgid "" "Determines what the border style of a widget will be. Legal values are: " "``\"raised\"``, ``\"sunken\"``, ``\"flat\"``, ``\"groove\"``, and " "``\"ridge\"``." msgstr "" -#: library/tkinter.rst:857 +#: library/tkinter.rst:860 msgid "scrollcommand" msgstr "" -#: library/tkinter.rst:856 +#: library/tkinter.rst:859 msgid "" "This is almost always the :meth:`!set` method of some scrollbar widget, but " "can be any widget method that takes a single argument." msgstr "" -#: library/tkinter.rst:860 +#: library/tkinter.rst:863 msgid "wrap" msgstr "" -#: library/tkinter.rst:860 +#: library/tkinter.rst:863 msgid "Must be one of: ``\"none\"``, ``\"char\"``, or ``\"word\"``." msgstr "" -#: library/tkinter.rst:865 +#: library/tkinter.rst:868 msgid "Bindings and Events" msgstr "" -#: library/tkinter.rst:871 +#: library/tkinter.rst:874 msgid "" "The bind method from the widget command allows you to watch for certain " "events and to have a callback function trigger when that event type occurs. " "The form of the bind method is::" msgstr "" -#: library/tkinter.rst:877 +#: library/tkinter.rst:880 msgid "where:" msgstr "" -#: library/tkinter.rst:882 +#: library/tkinter.rst:885 msgid "sequence" msgstr "" -#: library/tkinter.rst:880 +#: library/tkinter.rst:883 msgid "" "is a string that denotes the target kind of event. (See the :manpage:" "`bind(3tk)` man page, and page 201 of John Ousterhout's book, :title-" "reference:`Tcl and the Tk Toolkit (2nd edition)`, for details)." msgstr "" -#: library/tkinter.rst:887 +#: library/tkinter.rst:890 msgid "func" msgstr "" -#: library/tkinter.rst:885 +#: library/tkinter.rst:888 msgid "" "is a Python function, taking one argument, to be invoked when the event " "occurs. An Event instance will be passed as the argument. (Functions " "deployed this way are commonly known as *callbacks*.)" msgstr "" -#: library/tkinter.rst:893 +#: library/tkinter.rst:896 msgid "add" msgstr "" -#: library/tkinter.rst:890 +#: library/tkinter.rst:893 msgid "" "is optional, either ``''`` or ``'+'``. Passing an empty string denotes that " "this binding is to replace any other bindings that this event is associated " @@ -1415,7 +1415,7 @@ msgid "" "of functions bound to this event type." msgstr "" -#: library/tkinter.rst:902 +#: library/tkinter.rst:905 msgid "" "Notice how the widget field of the event is being accessed in the " "``turn_red()`` callback. This field contains the widget that caught the X " @@ -1424,209 +1424,209 @@ msgid "" "pages." msgstr "" -#: library/tkinter.rst:908 +#: library/tkinter.rst:911 msgid "Tkinter Event Field" msgstr "" -#: library/tkinter.rst:910 +#: library/tkinter.rst:913 msgid "%f" msgstr "" -#: library/tkinter.rst:910 +#: library/tkinter.rst:913 msgid "focus" msgstr "" -#: library/tkinter.rst:910 +#: library/tkinter.rst:913 msgid "%A" msgstr "" -#: library/tkinter.rst:910 +#: library/tkinter.rst:913 msgid "char" msgstr "" -#: library/tkinter.rst:912 +#: library/tkinter.rst:915 msgid "%h" msgstr "" -#: library/tkinter.rst:912 +#: library/tkinter.rst:915 msgid "height" msgstr "" -#: library/tkinter.rst:912 +#: library/tkinter.rst:915 msgid "%E" msgstr "" -#: library/tkinter.rst:912 +#: library/tkinter.rst:915 msgid "send_event" msgstr "" -#: library/tkinter.rst:914 +#: library/tkinter.rst:917 msgid "%k" msgstr "" -#: library/tkinter.rst:914 +#: library/tkinter.rst:917 msgid "keycode" msgstr "" -#: library/tkinter.rst:914 +#: library/tkinter.rst:917 msgid "%K" msgstr "" -#: library/tkinter.rst:914 +#: library/tkinter.rst:917 msgid "keysym" msgstr "" -#: library/tkinter.rst:916 +#: library/tkinter.rst:919 msgid "%s" msgstr "" -#: library/tkinter.rst:916 +#: library/tkinter.rst:919 msgid "state" msgstr "" -#: library/tkinter.rst:916 +#: library/tkinter.rst:919 msgid "%N" msgstr "" -#: library/tkinter.rst:916 +#: library/tkinter.rst:919 msgid "keysym_num" msgstr "" -#: library/tkinter.rst:918 +#: library/tkinter.rst:921 msgid "%t" msgstr "" -#: library/tkinter.rst:918 +#: library/tkinter.rst:921 msgid "time" msgstr "" -#: library/tkinter.rst:918 +#: library/tkinter.rst:921 msgid "%T" msgstr "" -#: library/tkinter.rst:918 +#: library/tkinter.rst:921 msgid "type" msgstr "" -#: library/tkinter.rst:920 +#: library/tkinter.rst:923 msgid "%w" msgstr "" -#: library/tkinter.rst:920 +#: library/tkinter.rst:923 msgid "width" msgstr "" -#: library/tkinter.rst:920 +#: library/tkinter.rst:923 msgid "%W" msgstr "" -#: library/tkinter.rst:920 +#: library/tkinter.rst:923 msgid "widget" msgstr "" -#: library/tkinter.rst:922 +#: library/tkinter.rst:925 msgid "%x" msgstr "" -#: library/tkinter.rst:922 +#: library/tkinter.rst:925 msgid "x" msgstr "" -#: library/tkinter.rst:922 +#: library/tkinter.rst:925 msgid "%X" msgstr "" -#: library/tkinter.rst:922 +#: library/tkinter.rst:925 msgid "x_root" msgstr "" -#: library/tkinter.rst:924 +#: library/tkinter.rst:927 msgid "%y" msgstr "" -#: library/tkinter.rst:924 +#: library/tkinter.rst:927 msgid "y" msgstr "" -#: library/tkinter.rst:924 +#: library/tkinter.rst:927 msgid "%Y" msgstr "" -#: library/tkinter.rst:924 +#: library/tkinter.rst:927 msgid "y_root" msgstr "" -#: library/tkinter.rst:929 +#: library/tkinter.rst:932 msgid "The index Parameter" msgstr "" -#: library/tkinter.rst:931 +#: library/tkinter.rst:934 msgid "" "A number of widgets require \"index\" parameters to be passed. These are " "used to point at a specific place in a Text widget, or to particular " "characters in an Entry widget, or to particular menu items in a Menu widget." msgstr "" -#: library/tkinter.rst:938 +#: library/tkinter.rst:941 msgid "Entry widget indexes (index, view index, etc.)" msgstr "" -#: library/tkinter.rst:936 +#: library/tkinter.rst:939 msgid "" "Entry widgets have options that refer to character positions in the text " "being displayed. You can use these :mod:`tkinter` functions to access these " "special points in text widgets:" msgstr "" -#: library/tkinter.rst:942 +#: library/tkinter.rst:945 msgid "Text widget indexes" msgstr "" -#: library/tkinter.rst:941 +#: library/tkinter.rst:944 msgid "" "The index notation for Text widgets is very rich and is best described in " "the Tk man pages." msgstr "" -#: library/tkinter.rst:967 +#: library/tkinter.rst:970 msgid "Menu indexes (menu.invoke(), menu.entryconfig(), etc.)" msgstr "" -#: library/tkinter.rst:945 +#: library/tkinter.rst:948 msgid "" "Some options and methods for menus manipulate specific menu entries. Anytime " "a menu index is needed for an option or a parameter, you may pass in:" msgstr "" -#: library/tkinter.rst:948 +#: library/tkinter.rst:951 msgid "" "an integer which refers to the numeric position of the entry in the widget, " "counted from the top, starting with 0;" msgstr "" -#: library/tkinter.rst:951 +#: library/tkinter.rst:954 msgid "" "the string ``\"active\"``, which refers to the menu position that is " "currently under the cursor;" msgstr "" -#: library/tkinter.rst:954 +#: library/tkinter.rst:957 msgid "the string ``\"last\"`` which refers to the last menu item;" msgstr "" -#: library/tkinter.rst:956 +#: library/tkinter.rst:959 msgid "" "An integer preceded by ``@``, as in ``@6``, where the integer is interpreted " "as a y pixel coordinate in the menu's coordinate system;" msgstr "" -#: library/tkinter.rst:959 +#: library/tkinter.rst:962 msgid "" "the string ``\"none\"``, which indicates no menu entry at all, most often " "used with menu.activate() to deactivate all entries, and finally," msgstr "" -#: library/tkinter.rst:962 +#: library/tkinter.rst:965 msgid "" "a text string that is pattern matched against the label of the menu entry, " "as scanned from the top of the menu to the bottom. Note that this index " @@ -1635,33 +1635,33 @@ msgid "" "above literals, instead." msgstr "" -#: library/tkinter.rst:970 +#: library/tkinter.rst:973 msgid "Images" msgstr "" -#: library/tkinter.rst:972 +#: library/tkinter.rst:975 msgid "" "Images of different formats can be created through the corresponding " "subclass of :class:`tkinter.Image`:" msgstr "" -#: library/tkinter.rst:975 +#: library/tkinter.rst:978 msgid ":class:`BitmapImage` for images in XBM format." msgstr "" -#: library/tkinter.rst:977 +#: library/tkinter.rst:980 msgid "" ":class:`PhotoImage` for images in PGM, PPM, GIF and PNG formats. The latter " "is supported starting with Tk 8.6." msgstr "" -#: library/tkinter.rst:980 +#: library/tkinter.rst:983 msgid "" "Either type of image is created through either the ``file`` or the ``data`` " "option (other options are available as well)." msgstr "" -#: library/tkinter.rst:983 +#: library/tkinter.rst:986 msgid "" "The image object can then be used wherever an ``image`` option is supported " "by some widget (e.g. labels, buttons, menus). In these cases, Tk will not " @@ -1670,28 +1670,28 @@ msgid "" "empty box wherever the image was used." msgstr "" -#: library/tkinter.rst:991 +#: library/tkinter.rst:994 msgid "" "The `Pillow `_ package adds support for formats " "such as BMP, JPEG, TIFF, and WebP, among others." msgstr "" -#: library/tkinter.rst:997 +#: library/tkinter.rst:1000 msgid "File Handlers" msgstr "" -#: library/tkinter.rst:999 +#: library/tkinter.rst:1002 msgid "" "Tk allows you to register and unregister a callback function which will be " "called from the Tk mainloop when I/O is possible on a file descriptor. Only " "one handler may be registered per file descriptor. Example code::" msgstr "" -#: library/tkinter.rst:1010 +#: library/tkinter.rst:1013 msgid "This feature is not available on Windows." msgstr "" -#: library/tkinter.rst:1012 +#: library/tkinter.rst:1015 msgid "" "Since you don't know how many bytes are available for reading, you may not " "want to use the :class:`~io.BufferedIOBase` or :class:`~io.TextIOBase` :meth:" @@ -1702,7 +1702,7 @@ msgid "" "maxbytecount)``." msgstr "" -#: library/tkinter.rst:1023 +#: library/tkinter.rst:1026 msgid "" "Registers the file handler callback function *func*. The *file* argument may " "either be an object with a :meth:`~io.IOBase.fileno` method (such as a file " @@ -1711,26 +1711,26 @@ msgid "" "as follows::" msgstr "" -#: library/tkinter.rst:1034 +#: library/tkinter.rst:1037 msgid "Unregisters a file handler." msgstr "" -#: library/tkinter.rst:1041 +#: library/tkinter.rst:1044 msgid "Constants used in the *mask* arguments." msgstr "" -#: library/tkinter.rst:637 +#: library/tkinter.rst:640 msgid "packing (widgets)" msgstr "" -#: library/tkinter.rst:750 +#: library/tkinter.rst:753 msgid "window manager (widgets)" msgstr "" -#: library/tkinter.rst:867 +#: library/tkinter.rst:870 msgid "bind (widgets)" msgstr "" -#: library/tkinter.rst:867 +#: library/tkinter.rst:870 msgid "events (widgets)" msgstr "" diff --git a/library/tkinter.ttk.po b/library/tkinter.ttk.po index 4f1ea2999..bebd26660 100644 --- a/library/tkinter.ttk.po +++ b/library/tkinter.ttk.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -1957,68 +1957,71 @@ msgstr "" #: library/tkinter.ttk.rst:1393 msgid "" "Create a new element in the current theme, of the given *etype* which is " -"expected to be either \"image\", \"from\" or \"vsapi\". The latter is only " -"available in Tk 8.6a for Windows XP and Vista and is not described here." +"expected to be either \"image\" or \"from\"." msgstr "" -#: library/tkinter.ttk.rst:1397 +#: library/tkinter.ttk.rst:1396 msgid "" "If \"image\" is used, *args* should contain the default image name followed " "by statespec/value pairs (this is the imagespec), and *kw* may have the " "following options:" msgstr "" -#: library/tkinter.ttk.rst:1403 +#: library/tkinter.ttk.rst:1402 msgid "border=padding" msgstr "" -#: library/tkinter.ttk.rst:1402 +#: library/tkinter.ttk.rst:1401 msgid "" "padding is a list of up to four integers, specifying the left, top, right, " "and bottom borders, respectively." msgstr "" -#: library/tkinter.ttk.rst:1407 +#: library/tkinter.ttk.rst:1406 msgid "height=height" msgstr "" -#: library/tkinter.ttk.rst:1406 +#: library/tkinter.ttk.rst:1405 msgid "" "Specifies a minimum height for the element. If less than zero, the base " "image's height is used as a default." msgstr "" -#: library/tkinter.ttk.rst:1411 +#: library/tkinter.ttk.rst:1410 msgid "padding=padding" msgstr "" -#: library/tkinter.ttk.rst:1410 +#: library/tkinter.ttk.rst:1409 msgid "" "Specifies the element's interior padding. Defaults to border's value if not " "specified." msgstr "" -#: library/tkinter.ttk.rst:1415 +#: library/tkinter.ttk.rst:1414 msgid "sticky=spec" msgstr "" -#: library/tkinter.ttk.rst:1414 +#: library/tkinter.ttk.rst:1413 msgid "" "Specifies how the image is placed within the final parcel. spec contains " "zero or more characters \"n\", \"s\", \"w\", or \"e\"." msgstr "" -#: library/tkinter.ttk.rst:1419 +#: library/tkinter.ttk.rst:1418 msgid "width=width" msgstr "" -#: library/tkinter.ttk.rst:1418 +#: library/tkinter.ttk.rst:1417 msgid "" "Specifies a minimum width for the element. If less than zero, the base " "image's width is used as a default." msgstr "" -#: library/tkinter.ttk.rst:1421 +#: library/tkinter.ttk.rst:1437 +msgid "Example::" +msgstr "" + +#: library/tkinter.ttk.rst:1430 msgid "" "If \"from\" is used as the value of *etype*, :meth:`element_create` will " "clone an existing element. *args* is expected to contain a themename, from " @@ -2027,19 +2030,19 @@ msgid "" "used. *kw* is discarded." msgstr "" -#: library/tkinter.ttk.rst:1431 +#: library/tkinter.ttk.rst:1445 msgid "Returns the list of elements defined in the current theme." msgstr "" -#: library/tkinter.ttk.rst:1436 +#: library/tkinter.ttk.rst:1450 msgid "Returns the list of *elementname*'s options." msgstr "" -#: library/tkinter.ttk.rst:1441 +#: library/tkinter.ttk.rst:1455 msgid "Create a new theme." msgstr "" -#: library/tkinter.ttk.rst:1443 +#: library/tkinter.ttk.rst:1457 msgid "" "It is an error if *themename* already exists. If *parent* is specified, the " "new theme will inherit styles, elements and layouts from the parent theme. " @@ -2047,13 +2050,13 @@ msgid "" "for :meth:`theme_settings`." msgstr "" -#: library/tkinter.ttk.rst:1451 +#: library/tkinter.ttk.rst:1465 msgid "" "Temporarily sets the current theme to *themename*, apply specified " "*settings* and then restore the previous theme." msgstr "" -#: library/tkinter.ttk.rst:1454 +#: library/tkinter.ttk.rst:1468 msgid "" "Each key in *settings* is a style and each value may contain the keys " "'configure', 'map', 'layout' and 'element create' and they are expected to " @@ -2062,26 +2065,26 @@ msgid "" "respectively." msgstr "" -#: library/tkinter.ttk.rst:1460 +#: library/tkinter.ttk.rst:1474 msgid "As an example, let's change the Combobox for the default theme a bit::" msgstr "" -#: library/tkinter.ttk.rst:1488 +#: library/tkinter.ttk.rst:1502 msgid "Returns a list of all known themes." msgstr "" -#: library/tkinter.ttk.rst:1493 +#: library/tkinter.ttk.rst:1507 msgid "" "If *themename* is not given, returns the theme in use. Otherwise, sets the " "current theme to *themename*, refreshes all widgets and emits a " "<> event." msgstr "" -#: library/tkinter.ttk.rst:1499 +#: library/tkinter.ttk.rst:1513 msgid "Layouts" msgstr "" -#: library/tkinter.ttk.rst:1501 +#: library/tkinter.ttk.rst:1515 msgid "" "A layout can be just ``None``, if it takes no options, or a dict of options " "specifying how to arrange the element. The layout mechanism uses a " @@ -2089,40 +2092,40 @@ msgid "" "each element is allocated a parcel. Valid options/values are:" msgstr "" -#: library/tkinter.ttk.rst:1510 +#: library/tkinter.ttk.rst:1524 msgid "side: whichside" msgstr "" -#: library/tkinter.ttk.rst:1508 +#: library/tkinter.ttk.rst:1522 msgid "" "Specifies which side of the cavity to place the element; one of top, right, " "bottom or left. If omitted, the element occupies the entire cavity." msgstr "" -#: library/tkinter.ttk.rst:1513 +#: library/tkinter.ttk.rst:1527 msgid "sticky: nswe" msgstr "" -#: library/tkinter.ttk.rst:1513 +#: library/tkinter.ttk.rst:1527 msgid "Specifies where the element is placed inside its allocated parcel." msgstr "" -#: library/tkinter.ttk.rst:1518 +#: library/tkinter.ttk.rst:1532 msgid "unit: 0 or 1" msgstr "" -#: library/tkinter.ttk.rst:1516 +#: library/tkinter.ttk.rst:1530 msgid "" "If set to 1, causes the element and all of its descendants to be treated as " "a single element for the purposes of :meth:`Widget.identify` et al. It's " "used for things like scrollbar thumbs with grips." msgstr "" -#: library/tkinter.ttk.rst:1523 +#: library/tkinter.ttk.rst:1537 msgid "children: [sublayout... ]" msgstr "" -#: library/tkinter.ttk.rst:1521 +#: library/tkinter.ttk.rst:1535 msgid "" "Specifies a list of elements to place inside the element. Each element is a " "tuple (or other sequence type) where the first item is the layout name, and " diff --git a/library/typing.po b/library/typing.po index 48b405254..28c2e7117 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: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -27,8 +27,8 @@ msgstr "" #: library/typing.rst:20 msgid "" "The Python runtime does not enforce function and variable type annotations. " -"They can be used by third party tools such as type checkers, IDEs, linters, " -"etc." +"They can be used by third party tools such as :term:`type checkers `, IDEs, linters, etc." msgstr "" #: library/typing.rst:26 @@ -403,7 +403,7 @@ msgid "" "of type :class:`int` and returns a :class:`str`." msgstr "" -#: library/typing.rst:2894 library/typing.rst:3036 +#: library/typing.rst:2891 library/typing.rst:3033 msgid "For example:" msgstr "" @@ -441,7 +441,7 @@ msgid "" "ReturnType]`` respectively." msgstr "" -#: library/typing.rst:3565 +#: library/typing.rst:3562 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:1237 -#: library/typing.rst:2834 +#: library/typing.rst:934 library/typing.rst:1011 library/typing.rst:1234 +#: library/typing.rst:2831 msgid "For example::" msgstr "" @@ -844,7 +844,7 @@ msgid "" "``LiteralString``." msgstr "" -#: library/typing.rst:1961 +#: library/typing.rst:1958 msgid "Example:" msgstr "" @@ -1072,38 +1072,38 @@ msgid "" "passed in::" msgstr "" -#: library/typing.rst:1929 +#: library/typing.rst:1926 msgid "" ":pep:`612` -- Parameter Specification Variables (the PEP which introduced " "``ParamSpec`` and ``Concatenate``)" msgstr "" -#: library/typing.rst:1169 +#: library/typing.rst:1166 msgid ":class:`ParamSpec`" msgstr "" -#: library/typing.rst:1932 +#: library/typing.rst:1929 msgid ":ref:`annotating-callables`" msgstr "" -#: library/typing.rst:1174 +#: library/typing.rst:1171 msgid "Special typing form to define \"literal types\"." msgstr "" -#: library/typing.rst:1176 +#: library/typing.rst:1173 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:1192 +#: library/typing.rst:1189 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:1198 +#: library/typing.rst:1195 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:1206 +#: library/typing.rst:1203 msgid "Special type construct to mark class variables." msgstr "" -#: library/typing.rst:1208 +#: library/typing.rst:1205 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:1216 +#: library/typing.rst:1213 msgid ":data:`ClassVar` accepts only types and cannot be further subscribed." msgstr "" -#: library/typing.rst:1218 +#: library/typing.rst:1215 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:1232 +#: library/typing.rst:1229 msgid "Special typing construct to indicate final names to type checkers." msgstr "" -#: library/typing.rst:1234 +#: library/typing.rst:1231 msgid "" "Final names cannot be reassigned in any scope. Final names declared in class " "scopes cannot be overridden in subclasses." msgstr "" -#: library/typing.rst:2850 +#: library/typing.rst:2847 msgid "" "There is no runtime checking of these properties. See :pep:`591` for more " "details." msgstr "" -#: library/typing.rst:1255 +#: library/typing.rst:1252 msgid "Special typing construct to mark a :class:`TypedDict` key as required." msgstr "" -#: library/typing.rst:1257 +#: library/typing.rst:1254 msgid "" "This is mainly useful for ``total=False`` TypedDicts. See :class:`TypedDict` " "and :pep:`655` for more details." msgstr "" -#: library/typing.rst:1264 +#: library/typing.rst:1261 msgid "" "Special typing construct to mark a :class:`TypedDict` key as potentially " "missing." msgstr "" -#: library/typing.rst:1267 +#: library/typing.rst:1264 msgid "See :class:`TypedDict` and :pep:`655` for more details." msgstr "" -#: library/typing.rst:1273 +#: library/typing.rst:1270 msgid "Special typing form to add context-specific metadata to an annotation." msgstr "" -#: library/typing.rst:1275 +#: library/typing.rst:1272 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:1280 +#: library/typing.rst:1277 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:1286 +#: library/typing.rst:1283 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:1293 +#: library/typing.rst:1290 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:1301 +#: library/typing.rst:1298 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:1314 +#: library/typing.rst:1311 msgid "Details of the syntax:" msgstr "" -#: library/typing.rst:1316 +#: library/typing.rst:1313 msgid "The first argument to ``Annotated`` must be a valid type" msgstr "" -#: library/typing.rst:1318 +#: library/typing.rst:1315 msgid "" "Multiple metadata elements can be supplied (``Annotated`` supports variadic " "arguments)::" msgstr "" -#: library/typing.rst:1327 +#: library/typing.rst:1324 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:1331 +#: library/typing.rst:1328 msgid "" "``Annotated`` must be subscripted with at least two arguments " "( ``Annotated[int]`` is not valid)" msgstr "" -#: library/typing.rst:1334 +#: library/typing.rst:1331 msgid "" "The order of the metadata elements is preserved and matters for equality " "checks::" msgstr "" -#: library/typing.rst:1341 +#: library/typing.rst:1338 msgid "" "Nested ``Annotated`` types are flattened. The order of the metadata elements " "starts with the innermost annotation::" msgstr "" -#: library/typing.rst:1348 +#: library/typing.rst:1345 msgid "Duplicated metadata elements are not removed::" msgstr "" -#: library/typing.rst:1354 +#: library/typing.rst:1351 msgid "``Annotated`` can be used with nested and generic aliases:" msgstr "" -#: library/typing.rst:1368 +#: library/typing.rst:1365 msgid "``Annotated`` cannot be used with an unpacked :class:`TypeVarTuple`::" msgstr "" -#: library/typing.rst:1372 +#: library/typing.rst:1369 msgid "This would be equivalent to::" msgstr "" -#: library/typing.rst:1376 +#: library/typing.rst:1373 msgid "" "where ``T1``, ``T2``, etc. are :class:`TypeVars `. This would be " "invalid: only one type should be passed to Annotated." msgstr "" -#: library/typing.rst:1379 +#: library/typing.rst:1376 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:1392 +#: library/typing.rst:1389 msgid "" "At runtime, the metadata associated with an ``Annotated`` type can be " "retrieved via the :attr:`!__metadata__` attribute:" msgstr "" -#: library/typing.rst:1406 +#: library/typing.rst:1403 msgid ":pep:`593` - Flexible function and variable annotations" msgstr "" -#: library/typing.rst:1407 +#: library/typing.rst:1404 msgid "The PEP introducing ``Annotated`` to the standard library." msgstr "" -#: library/typing.rst:1414 +#: library/typing.rst:1411 msgid "Special typing construct for marking user-defined type guard functions." msgstr "" -#: library/typing.rst:1416 +#: library/typing.rst:1413 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:1420 +#: library/typing.rst:1417 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:1435 +#: library/typing.rst:1432 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:1439 +#: library/typing.rst:1436 msgid "" "Using ``-> TypeGuard`` tells the static type checker that for a given " "function:" msgstr "" -#: library/typing.rst:1442 +#: library/typing.rst:1439 msgid "The return value is a boolean." msgstr "" -#: library/typing.rst:1443 +#: library/typing.rst:1440 msgid "" "If the return value is ``True``, the type of its argument is the type inside " "``TypeGuard``." msgstr "" -#: library/typing.rst:1460 +#: library/typing.rst:1457 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:1464 +#: library/typing.rst:1461 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:1470 +#: library/typing.rst:1467 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:1476 +#: library/typing.rst:1473 msgid "" "``TypeGuard`` also works with type variables. See :pep:`647` for more " "details." msgstr "" -#: library/typing.rst:1483 +#: library/typing.rst:1480 msgid "Typing operator to conceptually mark an object as having been unpacked." msgstr "" -#: library/typing.rst:1485 +#: library/typing.rst:1482 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:1494 +#: library/typing.rst:1491 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:1508 +#: library/typing.rst:1505 msgid "" "``Unpack`` can also be used along with :class:`typing.TypedDict` for typing " "``**kwargs`` in a function signature::" msgstr "" -#: library/typing.rst:1521 +#: library/typing.rst:1518 msgid "" "See :pep:`692` for more details on using ``Unpack`` for ``**kwargs`` typing." msgstr "" -#: library/typing.rst:1526 +#: library/typing.rst:1523 msgid "Building generic types and type aliases" msgstr "" -#: library/typing.rst:1528 +#: library/typing.rst:1525 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:1532 +#: library/typing.rst:1529 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:1539 +#: library/typing.rst:1536 msgid "Abstract base class for generic types." msgstr "" -#: library/typing.rst:1541 +#: library/typing.rst:1538 msgid "" "A generic type is typically declared by adding a list of type parameters " "after the class name::" msgstr "" -#: library/typing.rst:1549 +#: library/typing.rst:1546 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:1553 +#: library/typing.rst:1550 msgid "This class can then be used as follows::" msgstr "" -#: library/typing.rst:1561 +#: library/typing.rst:1558 msgid "" "Here the brackets after the function name indicate a :ref:`generic function " "`." msgstr "" -#: library/typing.rst:1564 +#: library/typing.rst:1561 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:1581 +#: library/typing.rst:1578 msgid "Type variable." msgstr "" -#: library/typing.rst:1583 +#: library/typing.rst:1580 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:1591 +#: library/typing.rst:1588 msgid "" "This syntax can also be used to create bound and constrained type variables::" msgstr "" -#: library/typing.rst:1601 +#: library/typing.rst:1598 msgid "" "However, if desired, reusable type variables can also be constructed " "manually, like so::" msgstr "" -#: library/typing.rst:1607 +#: library/typing.rst:1604 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:1628 +#: library/typing.rst:1625 msgid "" "Note that type variables can be *bound*, *constrained*, or neither, but " "cannot be both bound *and* constrained." msgstr "" -#: library/typing.rst:1631 +#: library/typing.rst:1628 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:1639 +#: library/typing.rst:1636 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:1654 +#: library/typing.rst:1651 msgid "" "Type variables can be bound to concrete types, abstract types (ABCs or " "protocols), and even unions of types::" msgstr "" -#: library/typing.rst:1666 +#: library/typing.rst:1663 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:1677 +#: library/typing.rst:1674 msgid "At runtime, ``isinstance(x, T)`` will raise :exc:`TypeError`." msgstr "" -#: library/typing.rst:1681 +#: library/typing.rst:1678 msgid "The name of the type variable." msgstr "" -#: library/typing.rst:1685 +#: library/typing.rst:1682 msgid "Whether the type var has been explicitly marked as covariant." msgstr "" -#: library/typing.rst:1689 +#: library/typing.rst:1686 msgid "Whether the type var has been explicitly marked as contravariant." msgstr "" -#: library/typing.rst:1693 +#: library/typing.rst:1690 msgid "" "Whether the type variable's variance should be inferred by type checkers." msgstr "" -#: library/typing.rst:1699 +#: library/typing.rst:1696 msgid "The bound of the type variable, if any." msgstr "" -#: library/typing.rst:1703 +#: library/typing.rst:1700 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:1709 +#: library/typing.rst:1706 msgid "A tuple containing the constraints of the type variable, if any." msgstr "" -#: library/typing.rst:1713 +#: library/typing.rst:1710 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:1719 +#: library/typing.rst:1716 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:1727 +#: library/typing.rst:1724 msgid "" "Type variable tuple. A specialized form of :ref:`type variable ` " "that enables *variadic* generics." msgstr "" -#: library/typing.rst:1730 +#: library/typing.rst:1727 msgid "" "Type variable tuples can be declared in :ref:`type parameter lists ` using a single asterisk (``*``) before the name::" msgstr "" -#: library/typing.rst:1736 +#: library/typing.rst:1733 msgid "Or by explicitly invoking the ``TypeVarTuple`` constructor::" msgstr "" -#: library/typing.rst:1744 +#: library/typing.rst:1741 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:1766 +#: library/typing.rst:1763 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:1774 +#: library/typing.rst:1771 msgid "" "Type variable tuples must *always* be unpacked. This helps distinguish type " "variable tuples from normal type variables::" msgstr "" -#: library/typing.rst:1781 +#: library/typing.rst:1778 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:1789 +#: library/typing.rst:1786 msgid "" "Type variable tuples can be happily combined with normal type variables:" msgstr "" -#: library/typing.rst:1805 +#: library/typing.rst:1802 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:1812 +#: library/typing.rst:1809 msgid "" "Finally, an unpacked type variable tuple can be used as the type annotation " "of ``*args``::" msgstr "" -#: library/typing.rst:1822 +#: library/typing.rst:1819 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:1829 +#: library/typing.rst:1826 msgid "See :pep:`646` for more details on type variable tuples." msgstr "" -#: library/typing.rst:1833 +#: library/typing.rst:1830 msgid "The name of the type variable tuple." msgstr "" -#: library/typing.rst:1839 +#: library/typing.rst:1836 msgid "" "Type variable tuples can now be declared using the :ref:`type parameter " "` syntax introduced by :pep:`695`." msgstr "" -#: library/typing.rst:1844 +#: library/typing.rst:1841 msgid "" "Parameter specification variable. A specialized version of :ref:`type " "variables `." msgstr "" -#: library/typing.rst:1847 +#: library/typing.rst:1844 msgid "" "In :ref:`type parameter lists `, parameter specifications can " "be declared with two asterisks (``**``)::" msgstr "" -#: library/typing.rst:1852 +#: library/typing.rst:1849 msgid "" "For compatibility with Python 3.11 and earlier, ``ParamSpec`` objects can " "also be created as follows::" msgstr "" -#: library/typing.rst:1857 +#: library/typing.rst:1854 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:1864 +#: library/typing.rst:1861 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:1884 +#: library/typing.rst:1881 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:1888 +#: library/typing.rst:1885 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:1890 +#: library/typing.rst:1887 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:1897 +#: library/typing.rst:1894 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:1909 +#: library/typing.rst:1906 msgid "The name of the parameter specification." msgstr "" -#: library/typing.rst:1911 +#: library/typing.rst:1908 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:1921 +#: library/typing.rst:1918 msgid "" "Parameter specifications can now be declared using the :ref:`type parameter " "` syntax introduced by :pep:`695`." msgstr "" -#: library/typing.rst:1925 +#: library/typing.rst:1922 msgid "" "Only parameter specification variables defined in global scope can be " "pickled." msgstr "" -#: library/typing.rst:1931 +#: library/typing.rst:1928 msgid ":data:`Concatenate`" msgstr "" -#: library/typing.rst:1937 +#: library/typing.rst:1934 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:1942 +#: library/typing.rst:1939 msgid "" "Calling :func:`get_origin` on either of these objects will return the " "original ``ParamSpec``:" msgstr "" -#: library/typing.rst:1959 +#: library/typing.rst:1956 msgid "The type of type aliases created through the :keyword:`type` statement." msgstr "" -#: library/typing.rst:1973 +#: library/typing.rst:1970 msgid "The name of the type alias:" msgstr "" -#: library/typing.rst:1983 +#: library/typing.rst:1980 msgid "The module in which the type alias was defined::" msgstr "" -#: library/typing.rst:1991 +#: library/typing.rst:1988 msgid "" "The type parameters of the type alias, or an empty tuple if the alias is not " "generic:" msgstr "" -#: library/typing.rst:2005 +#: library/typing.rst:2002 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:2023 +#: library/typing.rst:2020 msgid "Other special directives" msgstr "" -#: library/typing.rst:2025 +#: library/typing.rst:2022 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:2031 +#: library/typing.rst:2028 msgid "Typed version of :func:`collections.namedtuple`." msgstr "" -#: library/typing.rst:2110 library/typing.rst:3076 +#: library/typing.rst:2107 library/typing.rst:3073 msgid "Usage::" msgstr "" -#: library/typing.rst:2039 +#: library/typing.rst:2036 msgid "This is equivalent to::" msgstr "" -#: library/typing.rst:2043 +#: library/typing.rst:2040 msgid "" "To give a field a default value, you can assign to it in the class body::" msgstr "" -#: library/typing.rst:2052 +#: library/typing.rst:2049 msgid "" "Fields with a default value must come after any fields without a default." msgstr "" -#: library/typing.rst:2054 +#: library/typing.rst:2051 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:2060 +#: library/typing.rst:2057 msgid "``NamedTuple`` subclasses can also have docstrings and methods::" msgstr "" -#: library/typing.rst:2070 +#: library/typing.rst:2067 msgid "``NamedTuple`` subclasses can be generic::" msgstr "" -#: library/typing.rst:2076 +#: library/typing.rst:2073 msgid "Backward-compatible usage::" msgstr "" -#: library/typing.rst:2086 +#: library/typing.rst:2083 msgid "Added support for :pep:`526` variable annotation syntax." msgstr "" -#: library/typing.rst:2089 +#: library/typing.rst:2086 msgid "Added support for default values, methods, and docstrings." msgstr "" -#: library/typing.rst:2092 +#: library/typing.rst:2089 msgid "" "The ``_field_types`` and ``__annotations__`` attributes are now regular " "dictionaries instead of instances of ``OrderedDict``." msgstr "" -#: library/typing.rst:2096 +#: library/typing.rst:2093 msgid "" "Removed the ``_field_types`` attribute in favor of the more standard " "``__annotations__`` attribute which has the same information." msgstr "" -#: library/typing.rst:2100 +#: library/typing.rst:2097 msgid "Added support for generic namedtuples." msgstr "" -#: library/typing.rst:2105 +#: library/typing.rst:2102 msgid "Helper class to create low-overhead :ref:`distinct types `." msgstr "" -#: library/typing.rst:2107 +#: library/typing.rst:2104 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:2117 +#: library/typing.rst:2114 msgid "The module in which the new type is defined." msgstr "" -#: library/typing.rst:2121 +#: library/typing.rst:2118 msgid "The name of the new type." msgstr "" -#: library/typing.rst:2125 +#: library/typing.rst:2122 msgid "The type that the new type is based on." msgstr "" -#: library/typing.rst:2129 +#: library/typing.rst:2126 msgid "``NewType`` is now a class rather than a function." msgstr "" -#: library/typing.rst:2134 +#: library/typing.rst:2131 msgid "Base class for protocol classes." msgstr "" -#: library/typing.rst:2136 +#: library/typing.rst:2133 msgid "Protocol classes are defined like this::" msgstr "" -#: library/typing.rst:2142 +#: library/typing.rst:2139 msgid "" "Such classes are primarily used with static type checkers that recognize " "structural subtyping (static duck-typing), for example::" msgstr "" -#: library/typing.rst:2154 +#: library/typing.rst:2151 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:2159 +#: library/typing.rst:2156 msgid "Protocol classes can be generic, for example::" msgstr "" -#: library/typing.rst:2165 +#: library/typing.rst:2162 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:2178 +#: library/typing.rst:2175 msgid "Mark a protocol class as a runtime protocol." msgstr "" -#: library/typing.rst:2180 +#: library/typing.rst:2177 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:2200 +#: library/typing.rst:2197 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:2211 +#: library/typing.rst:2208 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:2219 +#: library/typing.rst:2216 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:2228 +#: library/typing.rst:2225 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:2239 +#: library/typing.rst:2236 msgid "" "Special construct to add type hints to a dictionary. At runtime it is a " "plain :class:`dict`." msgstr "" -#: library/typing.rst:2242 +#: library/typing.rst:2239 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:2258 +#: library/typing.rst:2255 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:2262 +#: library/typing.rst:2259 msgid "Using a literal :class:`dict` as the second argument::" msgstr "" -#: library/typing.rst:2266 +#: library/typing.rst:2263 msgid "Using keyword arguments::" msgstr "" -#: library/typing.rst:2273 +#: library/typing.rst:2270 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:2274 +#: library/typing.rst:2271 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:2286 +#: library/typing.rst:2283 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:2297 +#: library/typing.rst:2294 msgid "" "This means that a ``Point2D`` ``TypedDict`` can have the ``label`` key " "omitted." msgstr "" -#: library/typing.rst:2300 +#: library/typing.rst:2297 msgid "" "It is also possible to mark all keys as non-required by default by " "specifying a totality of ``False``::" msgstr "" -#: library/typing.rst:2310 +#: library/typing.rst:2307 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:2315 +#: library/typing.rst:2312 msgid "" "Individual keys of a ``total=False`` ``TypedDict`` can be marked as required " "using :data:`Required`::" msgstr "" -#: library/typing.rst:2330 +#: library/typing.rst:2327 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:2337 +#: library/typing.rst:2334 msgid "" "``Point3D`` has three items: ``x``, ``y`` and ``z``. It is equivalent to " "this definition::" msgstr "" -#: library/typing.rst:2345 +#: library/typing.rst:2342 msgid "" "A ``TypedDict`` cannot inherit from a non-\\ ``TypedDict`` class, except " "for :class:`Generic`. For example::" msgstr "" -#: library/typing.rst:2360 +#: library/typing.rst:2357 msgid "A ``TypedDict`` can be generic::" msgstr "" -#: library/typing.rst:2366 +#: library/typing.rst:2363 msgid "" "To create a generic ``TypedDict`` that is compatible with Python 3.11 or " "lower, inherit from :class:`Generic` explicitly:" msgstr "" -#: library/typing.rst:2377 +#: library/typing.rst:2374 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:2383 +#: library/typing.rst:2380 msgid "" "``Point2D.__total__`` gives the value of the ``total`` argument. Example:" msgstr "" -#: library/typing.rst:2399 +#: library/typing.rst:2396 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:2412 +#: library/typing.rst:2409 msgid "" "``Point2D.__required_keys__`` and ``Point2D.__optional_keys__`` return :" "class:`frozenset` objects containing required and non-required keys, " "respectively." msgstr "" -#: library/typing.rst:2415 +#: library/typing.rst:2412 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:2418 +#: library/typing.rst:2415 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:2443 +#: library/typing.rst:2440 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:2449 +#: library/typing.rst:2446 msgid "" "See :pep:`589` for more examples and detailed rules of using ``TypedDict``." msgstr "" -#: library/typing.rst:2453 +#: library/typing.rst:2450 msgid "" "Added support for marking individual keys as :data:`Required` or :data:" "`NotRequired`. See :pep:`655`." msgstr "" -#: library/typing.rst:2457 +#: library/typing.rst:2454 msgid "Added support for generic ``TypedDict``\\ s." msgstr "" -#: library/typing.rst:2461 +#: library/typing.rst:2458 msgid "Protocols" msgstr "" -#: library/typing.rst:2463 +#: library/typing.rst:2460 msgid "" "The following protocols are provided by the typing module. All are decorated " "with :func:`@runtime_checkable `." msgstr "" -#: library/typing.rst:2468 +#: library/typing.rst:2465 msgid "" "An ABC with one abstract method ``__abs__`` that is covariant in its return " "type." msgstr "" -#: library/typing.rst:2473 +#: library/typing.rst:2470 msgid "An ABC with one abstract method ``__bytes__``." msgstr "" -#: library/typing.rst:2477 +#: library/typing.rst:2474 msgid "An ABC with one abstract method ``__complex__``." msgstr "" -#: library/typing.rst:2481 +#: library/typing.rst:2478 msgid "An ABC with one abstract method ``__float__``." msgstr "" -#: library/typing.rst:2485 +#: library/typing.rst:2482 msgid "An ABC with one abstract method ``__index__``." msgstr "" -#: library/typing.rst:2491 +#: library/typing.rst:2488 msgid "An ABC with one abstract method ``__int__``." msgstr "" -#: library/typing.rst:2495 +#: library/typing.rst:2492 msgid "" "An ABC with one abstract method ``__round__`` that is covariant in its " "return type." msgstr "" -#: library/typing.rst:2499 +#: library/typing.rst:2496 msgid "ABCs for working with IO" msgstr "" -#: library/typing.rst:2505 +#: library/typing.rst:2502 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:2511 +#: library/typing.rst:2508 msgid "Functions and decorators" msgstr "" -#: library/typing.rst:2515 +#: library/typing.rst:2512 msgid "Cast a value to a type." msgstr "" -#: library/typing.rst:2517 +#: library/typing.rst:2514 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:2524 +#: library/typing.rst:2521 msgid "" "Ask a static type checker to confirm that *val* has an inferred type of " "*typ*." msgstr "" -#: library/typing.rst:2526 +#: library/typing.rst:2523 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:2529 +#: library/typing.rst:2526 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:2536 +#: library/typing.rst:2533 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:2550 +#: library/typing.rst:2547 msgid "" "Ask a static type checker to confirm that a line of code is unreachable." msgstr "" -#: library/typing.rst:2552 +#: library/typing.rst:2549 msgid "Example::" msgstr "" -#: library/typing.rst:2563 +#: library/typing.rst:2560 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:2568 +#: library/typing.rst:2565 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,59 +2265,59 @@ msgid "" "passed in must be the bottom type, :data:`Never`, and nothing else." msgstr "" -#: library/typing.rst:2576 +#: library/typing.rst:2573 msgid "At runtime, this throws an exception when called." msgstr "" -#: library/typing.rst:2579 +#: library/typing.rst:2576 msgid "" "`Unreachable Code and Exhaustiveness Checking `__ has more information about " "exhaustiveness checking with static typing." msgstr "" -#: library/typing.rst:2587 +#: library/typing.rst:2584 msgid "Reveal the inferred static type of an expression." msgstr "" -#: library/typing.rst:2589 +#: library/typing.rst:2586 msgid "" "When a static type checker encounters a call to this function, it emits a " "diagnostic with the type of the argument. For example::" msgstr "" -#: library/typing.rst:2595 +#: library/typing.rst:2592 msgid "" "This can be useful when you want to debug how your type checker handles a " "particular piece of code." msgstr "" -#: library/typing.rst:2598 +#: library/typing.rst:2595 msgid "" "The function returns its argument unchanged, which allows using it within an " "expression::" msgstr "" -#: library/typing.rst:2603 +#: library/typing.rst:2600 msgid "" "Most type checkers support ``reveal_type()`` anywhere, even if the name is " "not imported from ``typing``. Importing the name from ``typing`` allows your " "code to run without runtime errors and communicates intent more clearly." msgstr "" -#: library/typing.rst:2608 +#: library/typing.rst:2605 msgid "" "At runtime, this function prints the runtime type of its argument to stderr " "and returns it unchanged::" msgstr "" -#: library/typing.rst:2620 +#: library/typing.rst:2617 msgid "" "Decorator to mark an object as providing :func:`dataclass `-like behavior." msgstr "" -#: library/typing.rst:2623 +#: library/typing.rst:2620 msgid "" "``dataclass_transform`` may be used to decorate a class, metaclass, or a " "function that is itself a decorator. The presence of " @@ -2326,19 +2326,19 @@ msgid "" "to :func:`@dataclasses.dataclass `." msgstr "" -#: library/typing.rst:2630 +#: library/typing.rst:2627 msgid "Example usage with a decorator function:" msgstr "" -#: library/typing.rst:2644 +#: library/typing.rst:2641 msgid "On a base class::" msgstr "" -#: library/typing.rst:2653 +#: library/typing.rst:2650 msgid "On a metaclass::" msgstr "" -#: library/typing.rst:2664 +#: library/typing.rst:2661 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:2804 +#: library/typing.rst:2801 msgid "" "*func* is the function object for the implementation of the overloaded " "function. For example, given the definition of ``process`` in the " @@ -2556,32 +2556,32 @@ msgid "" "returns an empty sequence." msgstr "" -#: library/typing.rst:2811 +#: library/typing.rst:2808 msgid "" "``get_overloads()`` can be used for introspecting an overloaded function at " "runtime." msgstr "" -#: library/typing.rst:2819 +#: library/typing.rst:2816 msgid "Clear all registered overloads in the internal registry." msgstr "" -#: library/typing.rst:2821 +#: library/typing.rst:2818 msgid "This can be used to reclaim the memory used by the registry." msgstr "" -#: library/typing.rst:2828 +#: library/typing.rst:2825 msgid "Decorator to indicate final methods and final classes." msgstr "" -#: library/typing.rst:2830 +#: library/typing.rst:2827 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:2855 +#: library/typing.rst:2852 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__\", " @@ -2591,11 +2591,11 @@ msgid "" "exception." msgstr "" -#: library/typing.rst:2866 +#: library/typing.rst:2863 msgid "Decorator to indicate that annotations are not type hints." msgstr "" -#: library/typing.rst:2868 +#: library/typing.rst:2865 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 " @@ -2603,38 +2603,38 @@ msgid "" "will ignore all annotations in a function or class with this decorator." msgstr "" -#: library/typing.rst:2874 +#: library/typing.rst:2871 msgid "``@no_type_check`` mutates the decorated object in place." msgstr "" -#: library/typing.rst:2878 +#: library/typing.rst:2875 msgid "Decorator to give another decorator the :func:`no_type_check` effect." msgstr "" -#: library/typing.rst:2880 +#: library/typing.rst:2877 msgid "" "This wraps the decorator with something that wraps the decorated function " "in :func:`no_type_check`." msgstr "" -#: library/typing.rst:2886 +#: library/typing.rst:2883 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:2889 +#: library/typing.rst:2886 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:2911 +#: library/typing.rst:2908 msgid "There is no runtime checking of this property." msgstr "" -#: library/typing.rst:2913 +#: library/typing.rst:2910 msgid "" "The decorator will attempt to set an ``__override__`` attribute to ``True`` " "on the decorated object. Thus, a check like ``if getattr(obj, " @@ -2644,38 +2644,38 @@ msgid "" "without raising an exception." msgstr "" -#: library/typing.rst:2920 +#: library/typing.rst:2917 msgid "See :pep:`698` for more details." msgstr "" -#: library/typing.rst:2927 +#: library/typing.rst:2924 msgid "Decorator to mark a class or function as unavailable at runtime." msgstr "" -#: library/typing.rst:2929 +#: library/typing.rst:2926 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:2940 +#: library/typing.rst:2937 msgid "" "Note that returning instances of private classes is not recommended. It is " "usually preferable to make such classes public." msgstr "" -#: library/typing.rst:2944 +#: library/typing.rst:2941 msgid "Introspection helpers" msgstr "" -#: library/typing.rst:2948 +#: library/typing.rst:2945 msgid "" "Return a dictionary containing type hints for a function, method, module or " "class object." msgstr "" -#: library/typing.rst:2951 +#: library/typing.rst:2948 msgid "" "This is often the same as ``obj.__annotations__``. In addition, forward " "references encoded as string literals are handled by evaluating them in " @@ -2684,40 +2684,40 @@ msgid "" "__mro__`` in reverse order." msgstr "" -#: library/typing.rst:2957 +#: library/typing.rst:2954 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:2974 +#: library/typing.rst:2971 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:2979 +#: library/typing.rst:2976 msgid "" "Added ``include_extras`` parameter as part of :pep:`593`. See the " "documentation on :data:`Annotated` for more information." msgstr "" -#: library/typing.rst:2983 +#: library/typing.rst:2980 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:2990 +#: library/typing.rst:2987 msgid "" "Get the unsubscripted version of a type: for a typing object of the form " "``X[Y, Z, ...]`` return ``X``." msgstr "" -#: library/typing.rst:2993 +#: library/typing.rst:2990 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 :" @@ -2725,17 +2725,17 @@ msgid "" "class:`ParamSpec`. Return ``None`` for unsupported objects." msgstr "" -#: library/typing.rst:3022 +#: library/typing.rst:3019 msgid "Examples:" msgstr "" -#: library/typing.rst:3014 +#: library/typing.rst:3011 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:3017 +#: library/typing.rst:3014 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 " @@ -2743,40 +2743,40 @@ msgid "" "objects." msgstr "" -#: library/typing.rst:3034 +#: library/typing.rst:3031 msgid "Check if a type is a :class:`TypedDict`." msgstr "" -#: library/typing.rst:3055 +#: library/typing.rst:3052 msgid "" "Class used for internal typing representation of string forward references." msgstr "" -#: library/typing.rst:3057 +#: library/typing.rst:3054 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:3062 +#: library/typing.rst:3059 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:3069 +#: library/typing.rst:3066 msgid "Constant" msgstr "" -#: library/typing.rst:3073 +#: library/typing.rst:3070 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:3084 +#: library/typing.rst:3081 msgid "" "The first type annotation must be enclosed in quotes, making it a \"forward " "reference\", to hide the ``expensive_mod`` reference from the interpreter " @@ -2784,7 +2784,7 @@ msgid "" "second annotation does not need to be enclosed in quotes." msgstr "" -#: library/typing.rst:3091 +#: library/typing.rst:3088 msgid "" "If ``from __future__ import annotations`` is used, annotations are not " "evaluated at function definition time. Instead, they are stored as strings " @@ -2792,11 +2792,11 @@ msgid "" "annotation (see :pep:`563`)." msgstr "" -#: library/typing.rst:3103 +#: library/typing.rst:3100 msgid "Deprecated aliases" msgstr "" -#: library/typing.rst:3105 +#: library/typing.rst:3102 msgid "" "This module defines several deprecated aliases to pre-existing standard " "library classes. These were originally included in the typing module in " @@ -2805,7 +2805,7 @@ msgid "" "existing classes were enhanced to support ``[]`` (see :pep:`585`)." msgstr "" -#: library/typing.rst:3112 +#: library/typing.rst:3109 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 " @@ -2813,7 +2813,7 @@ msgid "" "the interpreter for these aliases." msgstr "" -#: library/typing.rst:3117 +#: library/typing.rst:3114 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 " @@ -2821,188 +2821,188 @@ msgid "" "typing module without deprecation warnings until at least Python 3.14." msgstr "" -#: library/typing.rst:3122 +#: library/typing.rst:3119 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:3128 +#: library/typing.rst:3125 msgid "Aliases to built-in types" msgstr "" -#: library/typing.rst:3132 +#: library/typing.rst:3129 msgid "Deprecated alias to :class:`dict`." msgstr "" -#: library/typing.rst:3134 +#: library/typing.rst:3131 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:3380 +#: library/typing.rst:3377 msgid "This type can be used as follows::" msgstr "" -#: library/typing.rst:3143 +#: library/typing.rst:3140 msgid "" ":class:`builtins.dict ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3149 +#: library/typing.rst:3146 msgid "Deprecated alias to :class:`list`." msgstr "" -#: library/typing.rst:3151 +#: library/typing.rst:3148 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:3155 +#: library/typing.rst:3152 msgid "This type may be used as follows::" msgstr "" -#: library/typing.rst:3163 +#: library/typing.rst:3160 msgid "" ":class:`builtins.list ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3169 +#: library/typing.rst:3166 msgid "Deprecated alias to :class:`builtins.set `." msgstr "" -#: library/typing.rst:3171 +#: library/typing.rst:3168 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:3175 +#: library/typing.rst:3172 msgid "" ":class:`builtins.set ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3181 +#: library/typing.rst:3178 msgid "Deprecated alias to :class:`builtins.frozenset `." msgstr "" -#: library/typing.rst:3183 +#: library/typing.rst:3180 msgid "" ":class:`builtins.frozenset ` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3190 +#: library/typing.rst:3187 msgid "Deprecated alias for :class:`tuple`." msgstr "" -#: library/typing.rst:3192 +#: library/typing.rst:3189 msgid "" ":class:`tuple` and ``Tuple`` are special-cased in the type system; see :ref:" "`annotating-tuples` for more details." msgstr "" -#: library/typing.rst:3195 +#: library/typing.rst:3192 msgid "" ":class:`builtins.tuple ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3201 +#: library/typing.rst:3198 msgid "Deprecated alias to :class:`type`." msgstr "" -#: library/typing.rst:3203 +#: library/typing.rst:3200 msgid "" "See :ref:`type-of-class-objects` for details on using :class:`type` or " "``typing.Type`` in type annotations." msgstr "" -#: library/typing.rst:3208 +#: library/typing.rst:3205 msgid "" ":class:`builtins.type ` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3215 +#: library/typing.rst:3212 msgid "Aliases to types in :mod:`collections`" msgstr "" -#: library/typing.rst:3219 +#: library/typing.rst:3216 msgid "Deprecated alias to :class:`collections.defaultdict`." msgstr "" -#: library/typing.rst:3223 +#: library/typing.rst:3220 msgid "" ":class:`collections.defaultdict` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3229 +#: library/typing.rst:3226 msgid "Deprecated alias to :class:`collections.OrderedDict`." msgstr "" -#: library/typing.rst:3233 +#: library/typing.rst:3230 msgid "" ":class:`collections.OrderedDict` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3239 +#: library/typing.rst:3236 msgid "Deprecated alias to :class:`collections.ChainMap`." msgstr "" -#: library/typing.rst:3244 +#: library/typing.rst:3241 msgid "" ":class:`collections.ChainMap` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3250 +#: library/typing.rst:3247 msgid "Deprecated alias to :class:`collections.Counter`." msgstr "" -#: library/typing.rst:3255 +#: library/typing.rst:3252 msgid "" ":class:`collections.Counter` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3261 +#: library/typing.rst:3258 msgid "Deprecated alias to :class:`collections.deque`." msgstr "" -#: library/typing.rst:3266 +#: library/typing.rst:3263 msgid "" ":class:`collections.deque` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3273 +#: library/typing.rst:3270 msgid "Aliases to other concrete types" msgstr "" -#: library/typing.rst:3278 +#: library/typing.rst:3275 msgid "" "The ``typing.io`` namespace is deprecated and will be removed. These types " "should be directly imported from ``typing`` instead." msgstr "" -#: library/typing.rst:3282 +#: library/typing.rst:3279 msgid "" "Deprecated aliases corresponding to the return types from :func:`re.compile` " "and :func:`re.match`." msgstr "" -#: library/typing.rst:3285 +#: library/typing.rst:3282 msgid "" "These types (and the corresponding functions) are generic over :data:" "`AnyStr`. ``Pattern`` can be specialised as ``Pattern[str]`` or " @@ -3010,391 +3010,391 @@ msgid "" "``Match[bytes]``." msgstr "" -#: library/typing.rst:3293 +#: library/typing.rst:3290 msgid "" "The ``typing.re`` namespace is deprecated and will be removed. These types " "should be directly imported from ``typing`` instead." msgstr "" -#: library/typing.rst:3294 +#: library/typing.rst:3291 msgid "" "Classes ``Pattern`` and ``Match`` from :mod:`re` now support ``[]``. See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3300 +#: library/typing.rst:3297 msgid "Deprecated alias for :class:`str`." msgstr "" -#: library/typing.rst:3302 +#: library/typing.rst:3299 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:3306 +#: library/typing.rst:3303 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:3314 +#: library/typing.rst:3311 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:3324 +#: library/typing.rst:3321 msgid "Aliases to container ABCs in :mod:`collections.abc`" msgstr "" -#: library/typing.rst:3328 +#: library/typing.rst:3325 msgid "Deprecated alias to :class:`collections.abc.Set`." msgstr "" -#: library/typing.rst:3330 +#: library/typing.rst:3327 msgid "" ":class:`collections.abc.Set` now supports subscripting (``[]``). See :pep:" "`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3336 +#: library/typing.rst:3333 msgid "" "This type represents the types :class:`bytes`, :class:`bytearray`, and :" "class:`memoryview` of byte sequences." msgstr "" -#: library/typing.rst:3340 +#: library/typing.rst:3337 msgid "" "Prefer :class:`collections.abc.Buffer`, or a union like ``bytes | bytearray " "| memoryview``." msgstr "" -#: library/typing.rst:3344 +#: library/typing.rst:3341 msgid "Deprecated alias to :class:`collections.abc.Collection`." msgstr "" -#: library/typing.rst:3348 +#: library/typing.rst:3345 msgid "" ":class:`collections.abc.Collection` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3354 +#: library/typing.rst:3351 msgid "Deprecated alias to :class:`collections.abc.Container`." msgstr "" -#: library/typing.rst:3356 +#: library/typing.rst:3353 msgid "" ":class:`collections.abc.Container` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3362 +#: library/typing.rst:3359 msgid "Deprecated alias to :class:`collections.abc.ItemsView`." msgstr "" -#: library/typing.rst:3364 +#: library/typing.rst:3361 msgid "" ":class:`collections.abc.ItemsView` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3370 +#: library/typing.rst:3367 msgid "Deprecated alias to :class:`collections.abc.KeysView`." msgstr "" -#: library/typing.rst:3372 +#: library/typing.rst:3369 msgid "" ":class:`collections.abc.KeysView` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3378 +#: library/typing.rst:3375 msgid "Deprecated alias to :class:`collections.abc.Mapping`." msgstr "" -#: library/typing.rst:3385 +#: library/typing.rst:3382 msgid "" ":class:`collections.abc.Mapping` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3391 +#: library/typing.rst:3388 msgid "Deprecated alias to :class:`collections.abc.MappingView`." msgstr "" -#: library/typing.rst:3393 +#: library/typing.rst:3390 msgid "" ":class:`collections.abc.MappingView` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3399 +#: library/typing.rst:3396 msgid "Deprecated alias to :class:`collections.abc.MutableMapping`." msgstr "" -#: library/typing.rst:3401 +#: library/typing.rst:3398 msgid "" ":class:`collections.abc.MutableMapping` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3408 +#: library/typing.rst:3405 msgid "Deprecated alias to :class:`collections.abc.MutableSequence`." msgstr "" -#: library/typing.rst:3410 +#: library/typing.rst:3407 msgid "" ":class:`collections.abc.MutableSequence` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3417 +#: library/typing.rst:3414 msgid "Deprecated alias to :class:`collections.abc.MutableSet`." msgstr "" -#: library/typing.rst:3419 +#: library/typing.rst:3416 msgid "" ":class:`collections.abc.MutableSet` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3425 +#: library/typing.rst:3422 msgid "Deprecated alias to :class:`collections.abc.Sequence`." msgstr "" -#: library/typing.rst:3427 +#: library/typing.rst:3424 msgid "" ":class:`collections.abc.Sequence` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3433 +#: library/typing.rst:3430 msgid "Deprecated alias to :class:`collections.abc.ValuesView`." msgstr "" -#: library/typing.rst:3435 +#: library/typing.rst:3432 msgid "" ":class:`collections.abc.ValuesView` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3442 +#: library/typing.rst:3439 msgid "Aliases to asynchronous ABCs in :mod:`collections.abc`" msgstr "" -#: library/typing.rst:3446 +#: library/typing.rst:3443 msgid "Deprecated alias to :class:`collections.abc.Coroutine`." msgstr "" -#: library/typing.rst:3448 +#: library/typing.rst:3445 msgid "" "The variance and order of type variables correspond to those of :class:" "`Generator`, for example::" msgstr "" -#: library/typing.rst:3459 +#: library/typing.rst:3456 msgid "" ":class:`collections.abc.Coroutine` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3465 +#: library/typing.rst:3462 msgid "Deprecated alias to :class:`collections.abc.AsyncGenerator`." msgstr "" -#: library/typing.rst:3467 +#: library/typing.rst:3464 msgid "" "An async generator can be annotated by the generic type " "``AsyncGenerator[YieldType, SendType]``. For example::" msgstr "" -#: library/typing.rst:3476 +#: library/typing.rst:3473 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:3480 +#: library/typing.rst:3477 msgid "" "If your generator will only yield values, set the ``SendType`` to ``None``::" msgstr "" -#: library/typing.rst:3488 +#: library/typing.rst:3485 msgid "" "Alternatively, annotate your generator as having a return type of either " "``AsyncIterable[YieldType]`` or ``AsyncIterator[YieldType]``::" msgstr "" -#: library/typing.rst:3498 +#: library/typing.rst:3495 msgid "" ":class:`collections.abc.AsyncGenerator` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3505 +#: library/typing.rst:3502 msgid "Deprecated alias to :class:`collections.abc.AsyncIterable`." msgstr "" -#: library/typing.rst:3509 +#: library/typing.rst:3506 msgid "" ":class:`collections.abc.AsyncIterable` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3515 +#: library/typing.rst:3512 msgid "Deprecated alias to :class:`collections.abc.AsyncIterator`." msgstr "" -#: library/typing.rst:3519 +#: library/typing.rst:3516 msgid "" ":class:`collections.abc.AsyncIterator` now supports subscripting (``[]``). " "See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3525 +#: library/typing.rst:3522 msgid "Deprecated alias to :class:`collections.abc.Awaitable`." msgstr "" -#: library/typing.rst:3529 +#: library/typing.rst:3526 msgid "" ":class:`collections.abc.Awaitable` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3536 +#: library/typing.rst:3533 msgid "Aliases to other ABCs in :mod:`collections.abc`" msgstr "" -#: library/typing.rst:3540 +#: library/typing.rst:3537 msgid "Deprecated alias to :class:`collections.abc.Iterable`." msgstr "" -#: library/typing.rst:3542 +#: library/typing.rst:3539 msgid "" ":class:`collections.abc.Iterable` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3548 +#: library/typing.rst:3545 msgid "Deprecated alias to :class:`collections.abc.Iterator`." msgstr "" -#: library/typing.rst:3550 +#: library/typing.rst:3547 msgid "" ":class:`collections.abc.Iterator` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3556 +#: library/typing.rst:3553 msgid "Deprecated alias to :class:`collections.abc.Callable`." msgstr "" -#: library/typing.rst:3558 +#: library/typing.rst:3555 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:3561 +#: library/typing.rst:3558 msgid "" ":class:`collections.abc.Callable` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3571 +#: library/typing.rst:3568 msgid "Deprecated alias to :class:`collections.abc.Generator`." msgstr "" -#: library/typing.rst:3573 +#: library/typing.rst:3570 msgid "" "A generator can be annotated by the generic type ``Generator[YieldType, " "SendType, ReturnType]``. For example::" msgstr "" -#: library/typing.rst:3582 +#: library/typing.rst:3579 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:3586 +#: library/typing.rst:3583 msgid "" "If your generator will only yield values, set the ``SendType`` and " "``ReturnType`` to ``None``::" msgstr "" -#: library/typing.rst:3594 +#: library/typing.rst:3591 msgid "" "Alternatively, annotate your generator as having a return type of either " "``Iterable[YieldType]`` or ``Iterator[YieldType]``::" msgstr "" -#: library/typing.rst:3602 +#: library/typing.rst:3599 msgid "" ":class:`collections.abc.Generator` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3608 +#: library/typing.rst:3605 msgid "Deprecated alias to :class:`collections.abc.Hashable`." msgstr "" -#: library/typing.rst:3610 +#: library/typing.rst:3607 msgid "Use :class:`collections.abc.Hashable` directly instead." msgstr "" -#: library/typing.rst:3615 +#: library/typing.rst:3612 msgid "Deprecated alias to :class:`collections.abc.Reversible`." msgstr "" -#: library/typing.rst:3617 +#: library/typing.rst:3614 msgid "" ":class:`collections.abc.Reversible` now supports subscripting (``[]``). See :" "pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3623 +#: library/typing.rst:3620 msgid "Deprecated alias to :class:`collections.abc.Sized`." msgstr "" -#: library/typing.rst:3625 +#: library/typing.rst:3622 msgid "Use :class:`collections.abc.Sized` directly instead." msgstr "" -#: library/typing.rst:3631 +#: library/typing.rst:3628 msgid "Aliases to :mod:`contextlib` ABCs" msgstr "" -#: library/typing.rst:3635 +#: library/typing.rst:3632 msgid "Deprecated alias to :class:`contextlib.AbstractContextManager`." msgstr "" -#: library/typing.rst:3640 +#: library/typing.rst:3637 msgid "" ":class:`contextlib.AbstractContextManager` now supports subscripting " "(``[]``). See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3647 +#: library/typing.rst:3644 msgid "Deprecated alias to :class:`contextlib.AbstractAsyncContextManager`." msgstr "" -#: library/typing.rst:3652 +#: library/typing.rst:3649 msgid "" ":class:`contextlib.AbstractAsyncContextManager` now supports subscripting " "(``[]``). See :pep:`585` and :ref:`types-genericalias`." msgstr "" -#: library/typing.rst:3658 +#: library/typing.rst:3655 msgid "Deprecation Timeline of Major Features" msgstr "" -#: library/typing.rst:3660 +#: library/typing.rst:3657 msgid "" "Certain features in ``typing`` are deprecated and may be removed in a future " "version of Python. The following table summarizes major deprecations for " @@ -3402,98 +3402,98 @@ msgid "" "listed." msgstr "" -#: library/typing.rst:3667 +#: library/typing.rst:3664 msgid "Feature" msgstr "" -#: library/typing.rst:3668 +#: library/typing.rst:3665 msgid "Deprecated in" msgstr "" -#: library/typing.rst:3669 +#: library/typing.rst:3666 msgid "Projected removal" msgstr "" -#: library/typing.rst:3670 +#: library/typing.rst:3667 msgid "PEP/issue" msgstr "" -#: library/typing.rst:3671 +#: library/typing.rst:3668 msgid "``typing.io`` and ``typing.re`` submodules" msgstr "" -#: library/typing.rst:3672 +#: library/typing.rst:3669 msgid "3.8" msgstr "" -#: library/typing.rst:3673 +#: library/typing.rst:3670 msgid "3.13" msgstr "" -#: library/typing.rst:3674 +#: library/typing.rst:3671 msgid ":issue:`38291`" msgstr "" -#: library/typing.rst:3675 +#: library/typing.rst:3672 msgid "``typing`` versions of standard collections" msgstr "" -#: library/typing.rst:3680 +#: library/typing.rst:3677 msgid "3.9" msgstr "" -#: library/typing.rst:3677 +#: library/typing.rst:3674 msgid "Undecided (see :ref:`deprecated-aliases` for more information)" msgstr "" -#: library/typing.rst:3678 +#: library/typing.rst:3675 msgid ":pep:`585`" msgstr "" -#: library/typing.rst:3679 +#: library/typing.rst:3676 msgid ":class:`typing.ByteString`" msgstr "" -#: library/typing.rst:3681 +#: library/typing.rst:3678 msgid "3.14" msgstr "" -#: library/typing.rst:3682 +#: library/typing.rst:3679 msgid ":gh:`91896`" msgstr "" -#: library/typing.rst:3683 +#: library/typing.rst:3680 msgid ":data:`typing.Text`" msgstr "" -#: library/typing.rst:3684 +#: library/typing.rst:3681 msgid "3.11" msgstr "" -#: library/typing.rst:3689 library/typing.rst:3693 +#: library/typing.rst:3686 library/typing.rst:3690 msgid "Undecided" msgstr "" -#: library/typing.rst:3686 +#: library/typing.rst:3683 msgid ":gh:`92332`" msgstr "" -#: library/typing.rst:3687 +#: library/typing.rst:3684 msgid ":class:`typing.Hashable` and :class:`typing.Sized`" msgstr "" -#: library/typing.rst:3692 +#: library/typing.rst:3689 msgid "3.12" msgstr "" -#: library/typing.rst:3690 +#: library/typing.rst:3687 msgid ":gh:`94309`" msgstr "" -#: library/typing.rst:3691 +#: library/typing.rst:3688 msgid ":data:`typing.TypeAlias`" msgstr "" -#: library/typing.rst:3694 +#: library/typing.rst:3691 msgid ":pep:`695`" msgstr "" diff --git a/library/unittest.po b/library/unittest.po index 21b6d8415..13545a45e 100644 --- a/library/unittest.po +++ b/library/unittest.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 22:33+0300\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2660,34 +2660,34 @@ msgid "" "names." msgstr "" -#: library/unittest.rst:2322 +#: library/unittest.rst:2324 msgid "load_tests Protocol" msgstr "" -#: library/unittest.rst:2326 +#: library/unittest.rst:2328 msgid "" "Modules or packages can customize how tests are loaded from them during " "normal test runs or test discovery by implementing a function called " "``load_tests``." msgstr "" -#: library/unittest.rst:2329 +#: library/unittest.rst:2331 msgid "" "If a test module defines ``load_tests`` it will be called by :meth:" "`TestLoader.loadTestsFromModule` with the following arguments::" msgstr "" -#: library/unittest.rst:2334 +#: library/unittest.rst:2336 msgid "" "where *pattern* is passed straight through from ``loadTestsFromModule``. It " "defaults to ``None``." msgstr "" -#: library/unittest.rst:2337 +#: library/unittest.rst:2339 msgid "It should return a :class:`TestSuite`." msgstr "" -#: library/unittest.rst:2339 +#: library/unittest.rst:2341 msgid "" "*loader* is the instance of :class:`TestLoader` doing the loading. " "*standard_tests* are the tests that would be loaded by default from the " @@ -2696,13 +2696,13 @@ msgid "" "packages as part of test discovery." msgstr "" -#: library/unittest.rst:2345 +#: library/unittest.rst:2347 msgid "" "A typical ``load_tests`` function that loads tests from a specific set of :" "class:`TestCase` classes may look like::" msgstr "" -#: library/unittest.rst:2357 +#: library/unittest.rst:2359 msgid "" "If discovery is started in a directory containing a package, either from the " "command line or by calling :meth:`TestLoader.discover`, then the package :" @@ -2712,31 +2712,31 @@ msgid "" "left up to ``load_tests`` which is called with the following arguments::" msgstr "" -#: library/unittest.rst:2366 +#: library/unittest.rst:2368 msgid "" "This should return a :class:`TestSuite` representing all the tests from the " "package. (``standard_tests`` will only contain tests collected from :file:" "`__init__.py`.)" msgstr "" -#: library/unittest.rst:2370 +#: library/unittest.rst:2372 msgid "" "Because the pattern is passed into ``load_tests`` the package is free to " "continue (and potentially modify) test discovery. A 'do nothing' " "``load_tests`` function for a test package would look like::" msgstr "" -#: library/unittest.rst:2381 +#: library/unittest.rst:2383 msgid "" "Discovery no longer checks package names for matching *pattern* due to the " "impossibility of package names matching the default pattern." msgstr "" -#: library/unittest.rst:2388 +#: library/unittest.rst:2390 msgid "Class and Module Fixtures" msgstr "" -#: library/unittest.rst:2390 +#: library/unittest.rst:2392 msgid "" "Class and module level fixtures are implemented in :class:`TestSuite`. When " "the test suite encounters a test from a new class then :meth:`tearDownClass` " @@ -2744,27 +2744,27 @@ msgid "" "`setUpClass` from the new class." msgstr "" -#: library/unittest.rst:2395 +#: library/unittest.rst:2397 msgid "" "Similarly if a test is from a different module from the previous test then " "``tearDownModule`` from the previous module is run, followed by " "``setUpModule`` from the new module." msgstr "" -#: library/unittest.rst:2399 +#: library/unittest.rst:2401 msgid "" "After all the tests have run the final ``tearDownClass`` and " "``tearDownModule`` are run." msgstr "" -#: library/unittest.rst:2402 +#: library/unittest.rst:2404 msgid "" "Note that shared fixtures do not play well with [potential] features like " "test parallelization and they break test isolation. They should be used with " "care." msgstr "" -#: library/unittest.rst:2405 +#: library/unittest.rst:2407 msgid "" "The default ordering of tests created by the unittest test loaders is to " "group all tests from the same modules and classes together. This will lead " @@ -2774,14 +2774,14 @@ msgid "" "functions may be called multiple times in a single test run." msgstr "" -#: library/unittest.rst:2412 +#: library/unittest.rst:2414 msgid "" "Shared fixtures are not intended to work with suites with non-standard " "ordering. A ``BaseTestSuite`` still exists for frameworks that don't want to " "support shared fixtures." msgstr "" -#: library/unittest.rst:2416 +#: library/unittest.rst:2418 msgid "" "If there are any exceptions raised during one of the shared fixture " "functions the test is reported as an error. Because there is no " @@ -2791,22 +2791,22 @@ msgid "" "matter, but if you are a framework author it may be relevant." msgstr "" -#: library/unittest.rst:2425 +#: library/unittest.rst:2427 msgid "setUpClass and tearDownClass" msgstr "" -#: library/unittest.rst:2427 +#: library/unittest.rst:2429 msgid "These must be implemented as class methods::" msgstr "" -#: library/unittest.rst:2440 +#: library/unittest.rst:2442 msgid "" "If you want the ``setUpClass`` and ``tearDownClass`` on base classes called " "then you must call up to them yourself. The implementations in :class:" "`TestCase` are empty." msgstr "" -#: library/unittest.rst:2444 +#: library/unittest.rst:2446 msgid "" "If an exception is raised during a ``setUpClass`` then the tests in the " "class are not run and the ``tearDownClass`` is not run. Skipped classes will " @@ -2815,15 +2815,15 @@ msgid "" "instead of as an error." msgstr "" -#: library/unittest.rst:2452 +#: library/unittest.rst:2454 msgid "setUpModule and tearDownModule" msgstr "" -#: library/unittest.rst:2454 +#: library/unittest.rst:2456 msgid "These should be implemented as functions::" msgstr "" -#: library/unittest.rst:2462 +#: library/unittest.rst:2464 msgid "" "If an exception is raised in a ``setUpModule`` then none of the tests in the " "module will be run and the ``tearDownModule`` will not be run. If the " @@ -2831,13 +2831,13 @@ msgid "" "having been skipped instead of as an error." msgstr "" -#: library/unittest.rst:2467 +#: library/unittest.rst:2469 msgid "" "To add cleanup code that must be run even in the case of an exception, use " "``addModuleCleanup``:" msgstr "" -#: library/unittest.rst:2473 +#: library/unittest.rst:2475 msgid "" "Add a function to be called after :func:`tearDownModule` to cleanup " "resources used during the test class. Functions will be called in reverse " @@ -2846,13 +2846,13 @@ msgid "" "`addModuleCleanup` when they are added." msgstr "" -#: library/unittest.rst:2479 +#: library/unittest.rst:2481 msgid "" "If :meth:`setUpModule` fails, meaning that :func:`tearDownModule` is not " "called, then any cleanup functions added will still be called." msgstr "" -#: library/unittest.rst:2487 +#: library/unittest.rst:2489 msgid "" "Enter the supplied :term:`context manager`. If successful, also add its :" "meth:`~object.__exit__` method as a cleanup function by :func:" @@ -2860,30 +2860,30 @@ msgid "" "method." msgstr "" -#: library/unittest.rst:2497 +#: library/unittest.rst:2499 msgid "" "This function is called unconditionally after :func:`tearDownModule`, or " "after :func:`setUpModule` if :func:`setUpModule` raises an exception." msgstr "" -#: library/unittest.rst:2500 +#: library/unittest.rst:2502 msgid "" "It is responsible for calling all the cleanup functions added by :func:" "`addModuleCleanup`. If you need cleanup functions to be called *prior* to :" "func:`tearDownModule` then you can call :func:`doModuleCleanups` yourself." msgstr "" -#: library/unittest.rst:2505 +#: library/unittest.rst:2507 msgid "" ":func:`doModuleCleanups` pops methods off the stack of cleanup functions one " "at a time, so it can be called at any time." msgstr "" -#: library/unittest.rst:2512 +#: library/unittest.rst:2514 msgid "Signal Handling" msgstr "" -#: library/unittest.rst:2516 +#: library/unittest.rst:2518 msgid "" "The :option:`-c/--catch ` command-line option to unittest, " "along with the ``catchbreak`` parameter to :func:`unittest.main()`, provide " @@ -2893,7 +2893,7 @@ msgid "" "A second control-c will raise a :exc:`KeyboardInterrupt` in the usual way." msgstr "" -#: library/unittest.rst:2523 +#: library/unittest.rst:2525 msgid "" "The control-c handling signal handler attempts to remain compatible with " "code or tests that install their own :const:`signal.SIGINT` handler. If the " @@ -2905,41 +2905,41 @@ msgid "" "disabled the :func:`removeHandler` decorator can be used." msgstr "" -#: library/unittest.rst:2532 +#: library/unittest.rst:2534 msgid "" "There are a few utility functions for framework authors to enable control-c " "handling functionality within test frameworks." msgstr "" -#: library/unittest.rst:2537 +#: library/unittest.rst:2539 msgid "" "Install the control-c handler. When a :const:`signal.SIGINT` is received " "(usually in response to the user pressing control-c) all registered results " "have :meth:`~TestResult.stop` called." msgstr "" -#: library/unittest.rst:2544 +#: library/unittest.rst:2546 msgid "" "Register a :class:`TestResult` object for control-c handling. Registering a " "result stores a weak reference to it, so it doesn't prevent the result from " "being garbage collected." msgstr "" -#: library/unittest.rst:2548 +#: library/unittest.rst:2550 msgid "" "Registering a :class:`TestResult` object has no side-effects if control-c " "handling is not enabled, so test frameworks can unconditionally register all " "results they create independently of whether or not handling is enabled." msgstr "" -#: library/unittest.rst:2555 +#: library/unittest.rst:2557 msgid "" "Remove a registered result. Once a result has been removed then :meth:" "`~TestResult.stop` will no longer be called on that result object in " "response to a control-c." msgstr "" -#: library/unittest.rst:2562 +#: library/unittest.rst:2564 msgid "" "When called without arguments this function removes the control-c handler if " "it has been installed. This function can also be used as a test decorator to " diff --git a/library/xml.po b/library/xml.po index 525bd830c..3254ed2f4 100644 --- a/library/xml.po +++ b/library/xml.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-09-18 19:05+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -174,7 +174,7 @@ msgstr "" msgid "" "Expat 2.4.1 and newer is not vulnerable to the \"billion laughs\" and " "\"quadratic blowup\" vulnerabilities. Items still listed as vulnerable due " -"to potential reliance on system-provided libraries. Check :const:`pyexpat." +"to potential reliance on system-provided libraries. Check :const:`!pyexpat." "EXPAT_VERSION`." msgstr "" diff --git a/reference/expressions.po b/reference/expressions.po index 1382f450e..792e76ea7 100644 --- a/reference/expressions.po +++ b/reference/expressions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -856,18 +856,30 @@ msgstr "" msgid "" "The primary must evaluate to an object of a type that supports attribute " "references, which most objects do. This object is then asked to produce the " -"attribute whose name is the identifier. This production can be customized " -"by overriding the :meth:`__getattr__` method. If this attribute is not " -"available, the exception :exc:`AttributeError` is raised. Otherwise, the " -"type and value of the object produced is determined by the object. Multiple " -"evaluations of the same attribute reference may yield different objects." +"attribute whose name is the identifier. The type and value produced is " +"determined by the object. Multiple evaluations of the same attribute " +"reference may yield different objects." +msgstr "" + +#: reference/expressions.rst:823 +msgid "" +"This production can be customized by overriding the :meth:`~object." +"__getattribute__` method or the :meth:`~object.__getattr__` method. The :" +"meth:`!__getattribute__` method is called first and either returns a value " +"or raises :exc:`AttributeError` if the attribute is not available." msgstr "" #: reference/expressions.rst:829 +msgid "" +"If an :exc:`AttributeError` is raised and the object has a :meth:`!" +"__getattr__` method, that method is called as a fallback." +msgstr "" + +#: reference/expressions.rst:835 msgid "Subscriptions" msgstr "" -#: reference/expressions.rst:844 +#: reference/expressions.rst:850 msgid "" "The subscription of an instance of a :ref:`container class ` " "will generally select an element from the container. The subscription of a :" @@ -875,13 +887,13 @@ msgid "" "`GenericAlias ` object." msgstr "" -#: reference/expressions.rst:852 +#: reference/expressions.rst:858 msgid "" "When an object is subscripted, the interpreter will evaluate the primary and " "the expression list." msgstr "" -#: reference/expressions.rst:855 +#: reference/expressions.rst:861 msgid "" "The primary must evaluate to an object that supports subscription. An object " "may support subscription through defining one or both of :meth:`~object." @@ -891,20 +903,20 @@ msgid "" "called instead of ``__getitem__``, see :ref:`classgetitem-versus-getitem`." msgstr "" -#: reference/expressions.rst:862 +#: reference/expressions.rst:868 msgid "" "If the expression list contains at least one comma, it will evaluate to a :" "class:`tuple` containing the items of the expression list. Otherwise, the " "expression list will evaluate to the value of the list's sole member." msgstr "" -#: reference/expressions.rst:866 +#: reference/expressions.rst:872 msgid "" "For built-in objects, there are two types of objects that support " "subscription via :meth:`~object.__getitem__`:" msgstr "" -#: reference/expressions.rst:869 +#: reference/expressions.rst:875 msgid "" "Mappings. If the primary is a :term:`mapping`, the expression list must " "evaluate to an object whose value is one of the keys of the mapping, and the " @@ -912,7 +924,7 @@ msgid "" "An example of a builtin mapping class is the :class:`dict` class." msgstr "" -#: reference/expressions.rst:873 +#: reference/expressions.rst:879 msgid "" "Sequences. If the primary is a :term:`sequence`, the expression list must " "evaluate to an :class:`int` or a :class:`slice` (as discussed in the " @@ -920,7 +932,7 @@ msgid "" "`str`, :class:`list` and :class:`tuple` classes." msgstr "" -#: reference/expressions.rst:878 +#: reference/expressions.rst:884 msgid "" "The formal syntax makes no special provision for negative indices in :term:" "`sequences `. However, built-in sequences all provide a :meth:" @@ -934,25 +946,25 @@ msgid "" "explicitly add that support." msgstr "" -#: reference/expressions.rst:892 +#: reference/expressions.rst:898 msgid "" "A :class:`string ` is a special kind of sequence whose items are " "*characters*. A character is not a separate data type but a string of " "exactly one character." msgstr "" -#: reference/expressions.rst:900 +#: reference/expressions.rst:906 msgid "Slicings" msgstr "" -#: reference/expressions.rst:914 +#: reference/expressions.rst:920 msgid "" "A slicing selects a range of items in a sequence object (e.g., a string, " "tuple or list). Slicings may be used as expressions or as targets in " "assignment or :keyword:`del` statements. The syntax for a slicing:" msgstr "" -#: reference/expressions.rst:927 +#: reference/expressions.rst:933 msgid "" "There is ambiguity in the formal syntax here: anything that looks like an " "expression list also looks like a slice list, so any subscription can be " @@ -962,7 +974,7 @@ msgid "" "the case if the slice list contains no proper slice)." msgstr "" -#: reference/expressions.rst:939 +#: reference/expressions.rst:945 msgid "" "The semantics for a slicing are as follows. The primary is indexed (using " "the same :meth:`~object.__getitem__` method as normal subscription) with a " @@ -977,23 +989,23 @@ msgid "" "missing expressions." msgstr "" -#: reference/expressions.rst:963 +#: reference/expressions.rst:969 msgid "Calls" msgstr "" -#: reference/expressions.rst:965 +#: reference/expressions.rst:971 msgid "" "A call calls a callable object (e.g., a :term:`function`) with a possibly " "empty series of :term:`arguments `:" msgstr "" -#: reference/expressions.rst:982 +#: reference/expressions.rst:988 msgid "" "An optional trailing comma may be present after the positional and keyword " "arguments but does not affect the semantics." msgstr "" -#: reference/expressions.rst:988 +#: reference/expressions.rst:994 msgid "" "The primary must evaluate to a callable object (user-defined functions, " "built-in functions, methods of built-in objects, class objects, methods of " @@ -1003,7 +1015,7 @@ msgid "" "formal :term:`parameter` lists." msgstr "" -#: reference/expressions.rst:996 +#: reference/expressions.rst:1002 msgid "" "If keyword arguments are present, they are first converted to positional " "arguments, as follows. First, a list of unfilled slots is created for the " @@ -1024,7 +1036,7 @@ msgid "" "filled slots is used as the argument list for the call." msgstr "" -#: reference/expressions.rst:1016 +#: reference/expressions.rst:1022 msgid "" "An implementation may provide built-in functions whose positional parameters " "do not have names, even if they are 'named' for the purpose of " @@ -1033,7 +1045,7 @@ msgid "" "`PyArg_ParseTuple` to parse their arguments." msgstr "" -#: reference/expressions.rst:1022 +#: reference/expressions.rst:1028 msgid "" "If there are more positional arguments than there are formal parameter " "slots, a :exc:`TypeError` exception is raised, unless a formal parameter " @@ -1042,7 +1054,7 @@ msgid "" "empty tuple if there were no excess positional arguments)." msgstr "" -#: reference/expressions.rst:1028 +#: reference/expressions.rst:1034 msgid "" "If any keyword argument does not correspond to a formal parameter name, a :" "exc:`TypeError` exception is raised, unless a formal parameter using the " @@ -1052,7 +1064,7 @@ msgid "" "(new) empty dictionary if there were no excess keyword arguments." msgstr "" -#: reference/expressions.rst:1039 +#: reference/expressions.rst:1045 msgid "" "If the syntax ``*expression`` appears in the function call, ``expression`` " "must evaluate to an :term:`iterable`. Elements from these iterables are " @@ -1062,20 +1074,20 @@ msgid "" "*y1*, ..., *yM*, *x3*, *x4*." msgstr "" -#: reference/expressions.rst:1046 +#: reference/expressions.rst:1052 msgid "" "A consequence of this is that although the ``*expression`` syntax may appear " "*after* explicit keyword arguments, it is processed *before* the keyword " "arguments (and any ``**expression`` arguments -- see below). So::" msgstr "" -#: reference/expressions.rst:1062 +#: reference/expressions.rst:1068 msgid "" "It is unusual for both keyword arguments and the ``*expression`` syntax to " "be used in the same call, so in practice this confusion does not often arise." msgstr "" -#: reference/expressions.rst:1068 +#: reference/expressions.rst:1074 msgid "" "If the syntax ``**expression`` appears in the function call, ``expression`` " "must evaluate to a :term:`mapping`, the contents of which are treated as " @@ -1084,7 +1096,7 @@ msgid "" "a :exc:`TypeError` exception is raised." msgstr "" -#: reference/expressions.rst:1074 +#: reference/expressions.rst:1080 msgid "" "When ``**expression`` is used, each key in this mapping must be a string. " "Each value from the mapping is assigned to the first formal parameter " @@ -1096,35 +1108,35 @@ msgid "" "is raised." msgstr "" -#: reference/expressions.rst:1084 +#: reference/expressions.rst:1090 msgid "" "Formal parameters using the syntax ``*identifier`` or ``**identifier`` " "cannot be used as positional argument slots or as keyword argument names." msgstr "" -#: reference/expressions.rst:1087 +#: reference/expressions.rst:1093 msgid "" "Function calls accept any number of ``*`` and ``**`` unpackings, positional " "arguments may follow iterable unpackings (``*``), and keyword arguments may " "follow dictionary unpackings (``**``). Originally proposed by :pep:`448`." msgstr "" -#: reference/expressions.rst:1093 +#: reference/expressions.rst:1099 msgid "" "A call always returns some value, possibly ``None``, unless it raises an " "exception. How this value is computed depends on the type of the callable " "object." msgstr "" -#: reference/expressions.rst:1097 +#: reference/expressions.rst:1103 msgid "If it is---" msgstr "" -#: reference/expressions.rst:1110 +#: reference/expressions.rst:1116 msgid "a user-defined function:" msgstr "" -#: reference/expressions.rst:1106 +#: reference/expressions.rst:1112 msgid "" "The code block for the function is executed, passing it the argument list. " "The first thing the code block will do is bind the formal parameters to the " @@ -1133,73 +1145,73 @@ msgid "" "value of the function call." msgstr "" -#: reference/expressions.rst:1124 +#: reference/expressions.rst:1130 msgid "a built-in function or method:" msgstr "" -#: reference/expressions.rst:1123 +#: reference/expressions.rst:1129 msgid "" "The result is up to the interpreter; see :ref:`built-in-funcs` for the " "descriptions of built-in functions and methods." msgstr "" -#: reference/expressions.rst:1131 +#: reference/expressions.rst:1137 msgid "a class object:" msgstr "" -#: reference/expressions.rst:1131 +#: reference/expressions.rst:1137 msgid "A new instance of that class is returned." msgstr "" -#: reference/expressions.rst:1141 +#: reference/expressions.rst:1147 msgid "a class instance method:" msgstr "" -#: reference/expressions.rst:1139 +#: reference/expressions.rst:1145 msgid "" "The corresponding user-defined function is called, with an argument list " "that is one longer than the argument list of the call: the instance becomes " "the first argument." msgstr "" -#: reference/expressions.rst:1150 +#: reference/expressions.rst:1156 msgid "a class instance:" msgstr "" -#: reference/expressions.rst:1148 +#: reference/expressions.rst:1154 msgid "" "The class must define a :meth:`__call__` method; the effect is then the same " "as if that method was called." msgstr "" -#: reference/expressions.rst:1937 +#: reference/expressions.rst:1944 msgid "Await expression" msgstr "" -#: reference/expressions.rst:1158 +#: reference/expressions.rst:1164 msgid "" "Suspend the execution of :term:`coroutine` on an :term:`awaitable` object. " "Can only be used inside a :term:`coroutine function`." msgstr "" -#: reference/expressions.rst:1170 +#: reference/expressions.rst:1176 msgid "The power operator" msgstr "" -#: reference/expressions.rst:1176 +#: reference/expressions.rst:1182 msgid "" "The power operator binds more tightly than unary operators on its left; it " "binds less tightly than unary operators on its right. The syntax is:" msgstr "" -#: reference/expressions.rst:1182 +#: reference/expressions.rst:1188 msgid "" "Thus, in an unparenthesized sequence of power and unary operators, the " "operators are evaluated from right to left (this does not constrain the " "evaluation order for the operands): ``-1**2`` results in ``-1``." msgstr "" -#: reference/expressions.rst:1186 +#: reference/expressions.rst:1192 msgid "" "The power operator has the same semantics as the built-in :func:`pow` " "function, when called with two arguments: it yields its left argument raised " @@ -1207,7 +1219,7 @@ msgid "" "converted to a common type, and the result is of that type." msgstr "" -#: reference/expressions.rst:1191 +#: reference/expressions.rst:1197 msgid "" "For int operands, the result has the same type as the operands unless the " "second argument is negative; in that case, all arguments are converted to " @@ -1215,40 +1227,40 @@ msgid "" "``100``, but ``10**-2`` returns ``0.01``." msgstr "" -#: reference/expressions.rst:1196 +#: reference/expressions.rst:1202 msgid "" "Raising ``0.0`` to a negative power results in a :exc:`ZeroDivisionError`. " "Raising a negative number to a fractional power results in a :class:" "`complex` number. (In earlier versions it raised a :exc:`ValueError`.)" msgstr "" -#: reference/expressions.rst:1200 +#: reference/expressions.rst:1206 msgid "" "This operation can be customized using the special :meth:`__pow__` method." msgstr "" -#: reference/expressions.rst:1205 +#: reference/expressions.rst:1211 msgid "Unary arithmetic and bitwise operations" msgstr "" -#: reference/expressions.rst:1211 +#: reference/expressions.rst:1217 msgid "All unary arithmetic and bitwise operations have the same priority:" msgstr "" -#: reference/expressions.rst:1222 +#: reference/expressions.rst:1228 msgid "" "The unary ``-`` (minus) operator yields the negation of its numeric " "argument; the operation can be overridden with the :meth:`__neg__` special " "method." msgstr "" -#: reference/expressions.rst:1230 +#: reference/expressions.rst:1236 msgid "" "The unary ``+`` (plus) operator yields its numeric argument unchanged; the " "operation can be overridden with the :meth:`__pos__` special method." msgstr "" -#: reference/expressions.rst:1237 +#: reference/expressions.rst:1243 msgid "" "The unary ``~`` (invert) operator yields the bitwise inversion of its " "integer argument. The bitwise inversion of ``x`` is defined as ``-(x+1)``. " @@ -1256,17 +1268,17 @@ msgid "" "meth:`__invert__` special method." msgstr "" -#: reference/expressions.rst:1246 +#: reference/expressions.rst:1252 msgid "" "In all three cases, if the argument does not have the proper type, a :exc:" "`TypeError` exception is raised." msgstr "" -#: reference/expressions.rst:1253 +#: reference/expressions.rst:1259 msgid "Binary arithmetic operations" msgstr "" -#: reference/expressions.rst:1257 +#: reference/expressions.rst:1263 msgid "" "The binary arithmetic operations have the conventional priority levels. " "Note that some of these operations also apply to certain non-numeric types. " @@ -1274,7 +1286,7 @@ msgid "" "multiplicative operators and one for additive operators:" msgstr "" -#: reference/expressions.rst:1272 +#: reference/expressions.rst:1278 msgid "" "The ``*`` (multiplication) operator yields the product of its arguments. " "The arguments must either both be numbers, or one argument must be an " @@ -1284,19 +1296,19 @@ msgid "" "an empty sequence." msgstr "" -#: reference/expressions.rst:1278 +#: reference/expressions.rst:1284 msgid "" "This operation can be customized using the special :meth:`__mul__` and :meth:" "`__rmul__` methods." msgstr "" -#: reference/expressions.rst:1285 +#: reference/expressions.rst:1291 msgid "" "The ``@`` (at) operator is intended to be used for matrix multiplication. " "No builtin Python types implement this operator." msgstr "" -#: reference/expressions.rst:1296 +#: reference/expressions.rst:1302 msgid "" "The ``/`` (division) and ``//`` (floor division) operators yield the " "quotient of their arguments. The numeric arguments are first converted to a " @@ -1306,13 +1318,13 @@ msgid "" "the :exc:`ZeroDivisionError` exception." msgstr "" -#: reference/expressions.rst:1303 +#: reference/expressions.rst:1309 msgid "" "This operation can be customized using the special :meth:`__truediv__` and :" "meth:`__floordiv__` methods." msgstr "" -#: reference/expressions.rst:1310 +#: reference/expressions.rst:1316 msgid "" "The ``%`` (modulo) operator yields the remainder from the division of the " "first argument by the second. The numeric arguments are first converted to " @@ -1324,7 +1336,7 @@ msgid "" "absolute value of the second operand [#]_." msgstr "" -#: reference/expressions.rst:1319 +#: reference/expressions.rst:1325 msgid "" "The floor division and modulo operators are connected by the following " "identity: ``x == (x//y)*y + (x%y)``. Floor division and modulo are also " @@ -1332,7 +1344,7 @@ msgid "" "y, x%y)``. [#]_." msgstr "" -#: reference/expressions.rst:1324 +#: reference/expressions.rst:1330 msgid "" "In addition to performing the modulo operation on numbers, the ``%`` " "operator is also overloaded by string objects to perform old-style string " @@ -1341,20 +1353,20 @@ msgid "" "formatting`." msgstr "" -#: reference/expressions.rst:1329 +#: reference/expressions.rst:1335 msgid "" "The *modulo* operation can be customized using the special :meth:`__mod__` " "method." msgstr "" -#: reference/expressions.rst:1331 +#: reference/expressions.rst:1337 msgid "" "The floor division operator, the modulo operator, and the :func:`divmod` " "function are not defined for complex numbers. Instead, convert to a " "floating point number using the :func:`abs` function if appropriate." msgstr "" -#: reference/expressions.rst:1340 +#: reference/expressions.rst:1346 msgid "" "The ``+`` (addition) operator yields the sum of its arguments. The " "arguments must either both be numbers or both be sequences of the same " @@ -1362,84 +1374,84 @@ msgid "" "then added together. In the latter case, the sequences are concatenated." msgstr "" -#: reference/expressions.rst:1345 +#: reference/expressions.rst:1351 msgid "" "This operation can be customized using the special :meth:`__add__` and :meth:" "`__radd__` methods." msgstr "" -#: reference/expressions.rst:1353 +#: reference/expressions.rst:1359 msgid "" "The ``-`` (subtraction) operator yields the difference of its arguments. " "The numeric arguments are first converted to a common type." msgstr "" -#: reference/expressions.rst:1356 +#: reference/expressions.rst:1362 msgid "" "This operation can be customized using the special :meth:`__sub__` method." msgstr "" -#: reference/expressions.rst:1362 +#: reference/expressions.rst:1368 msgid "Shifting operations" msgstr "" -#: reference/expressions.rst:1369 +#: reference/expressions.rst:1375 msgid "" "The shifting operations have lower priority than the arithmetic operations:" msgstr "" -#: reference/expressions.rst:1374 +#: reference/expressions.rst:1380 msgid "" "These operators accept integers as arguments. They shift the first argument " "to the left or right by the number of bits given by the second argument." msgstr "" -#: reference/expressions.rst:1377 +#: reference/expressions.rst:1383 msgid "" "This operation can be customized using the special :meth:`__lshift__` and :" "meth:`__rshift__` methods." msgstr "" -#: reference/expressions.rst:1382 +#: reference/expressions.rst:1388 msgid "" "A right shift by *n* bits is defined as floor division by ``pow(2,n)``. A " "left shift by *n* bits is defined as multiplication with ``pow(2,n)``." msgstr "" -#: reference/expressions.rst:1389 +#: reference/expressions.rst:1395 msgid "Binary bitwise operations" msgstr "" -#: reference/expressions.rst:1393 +#: reference/expressions.rst:1399 msgid "Each of the three bitwise operations has a different priority level:" msgstr "" -#: reference/expressions.rst:1404 +#: reference/expressions.rst:1410 msgid "" "The ``&`` operator yields the bitwise AND of its arguments, which must be " "integers or one of them must be a custom object overriding :meth:`__and__` " "or :meth:`__rand__` special methods." msgstr "" -#: reference/expressions.rst:1413 +#: reference/expressions.rst:1419 msgid "" "The ``^`` operator yields the bitwise XOR (exclusive OR) of its arguments, " "which must be integers or one of them must be a custom object overriding :" "meth:`__xor__` or :meth:`__rxor__` special methods." msgstr "" -#: reference/expressions.rst:1422 +#: reference/expressions.rst:1428 msgid "" "The ``|`` operator yields the bitwise (inclusive) OR of its arguments, which " "must be integers or one of them must be a custom object overriding :meth:" "`__or__` or :meth:`__ror__` special methods." msgstr "" -#: reference/expressions.rst:1430 +#: reference/expressions.rst:1436 msgid "Comparisons" msgstr "" -#: reference/expressions.rst:1442 +#: reference/expressions.rst:1448 msgid "" "Unlike C, all comparison operations in Python have the same priority, which " "is lower than that of any arithmetic, shifting or bitwise operation. Also " @@ -1447,14 +1459,14 @@ msgid "" "conventional in mathematics:" msgstr "" -#: reference/expressions.rst:1452 +#: reference/expressions.rst:1458 msgid "" "Comparisons yield boolean values: ``True`` or ``False``. Custom :dfn:`rich " "comparison methods` may return non-boolean values. In this case Python will " "call :func:`bool` on such value in boolean contexts." msgstr "" -#: reference/expressions.rst:1458 +#: reference/expressions.rst:1464 msgid "" "Comparisons can be chained arbitrarily, e.g., ``x < y <= z`` is equivalent " "to ``x < y and y <= z``, except that ``y`` is evaluated only once (but in " @@ -1462,7 +1474,7 @@ msgid "" "false)." msgstr "" -#: reference/expressions.rst:1462 +#: reference/expressions.rst:1468 msgid "" "Formally, if *a*, *b*, *c*, ..., *y*, *z* are expressions and *op1*, " "*op2*, ..., *opN* are comparison operators, then ``a op1 b op2 c ... y opN " @@ -1470,24 +1482,24 @@ msgid "" "each expression is evaluated at most once." msgstr "" -#: reference/expressions.rst:1467 +#: reference/expressions.rst:1473 msgid "" "Note that ``a op1 b op2 c`` doesn't imply any kind of comparison between *a* " "and *c*, so that, e.g., ``x < y > z`` is perfectly legal (though perhaps not " "pretty)." msgstr "" -#: reference/expressions.rst:1474 +#: reference/expressions.rst:1480 msgid "Value comparisons" msgstr "" -#: reference/expressions.rst:1476 +#: reference/expressions.rst:1482 msgid "" "The operators ``<``, ``>``, ``==``, ``>=``, ``<=``, and ``!=`` compare the " "values of two objects. The objects do not need to have the same type." msgstr "" -#: reference/expressions.rst:1479 +#: reference/expressions.rst:1485 msgid "" "Chapter :ref:`objects` states that objects have a value (in addition to type " "and identity). The value of an object is a rather abstract notion in " @@ -1499,7 +1511,7 @@ msgid "" "indirectly, by means of their comparison implementation." msgstr "" -#: reference/expressions.rst:1488 +#: reference/expressions.rst:1494 msgid "" "Because all types are (direct or indirect) subtypes of :class:`object`, they " "inherit the default comparison behavior from :class:`object`. Types can " @@ -1507,7 +1519,7 @@ msgid "" "methods` like :meth:`__lt__`, described in :ref:`customization`." msgstr "" -#: reference/expressions.rst:1494 +#: reference/expressions.rst:1500 msgid "" "The default behavior for equality comparison (``==`` and ``!=``) is based on " "the identity of the objects. Hence, equality comparison of instances with " @@ -1517,14 +1529,14 @@ msgid "" "``x is y`` implies ``x == y``)." msgstr "" -#: reference/expressions.rst:1501 +#: reference/expressions.rst:1507 msgid "" "A default order comparison (``<``, ``>``, ``<=``, and ``>=``) is not " "provided; an attempt raises :exc:`TypeError`. A motivation for this default " "behavior is the lack of a similar invariant as for equality." msgstr "" -#: reference/expressions.rst:1505 +#: reference/expressions.rst:1511 msgid "" "The behavior of the default equality comparison, that instances with " "different identities are always unequal, may be in contrast to what types " @@ -1533,13 +1545,13 @@ msgid "" "in fact, a number of built-in types have done that." msgstr "" -#: reference/expressions.rst:1511 +#: reference/expressions.rst:1517 msgid "" "The following list describes the comparison behavior of the most important " "built-in types." msgstr "" -#: reference/expressions.rst:1514 +#: reference/expressions.rst:1520 msgid "" "Numbers of built-in numeric types (:ref:`typesnumeric`) and of the standard " "library types :class:`fractions.Fraction` and :class:`decimal.Decimal` can " @@ -1549,7 +1561,7 @@ msgid "" "of precision." msgstr "" -#: reference/expressions.rst:1521 +#: reference/expressions.rst:1527 msgid "" "The not-a-number values ``float('NaN')`` and ``decimal.Decimal('NaN')`` are " "special. Any ordered comparison of a number to a not-a-number value is " @@ -1559,32 +1571,32 @@ msgid "" "is compliant with IEEE 754." msgstr "" -#: reference/expressions.rst:1528 +#: reference/expressions.rst:1534 msgid "" "``None`` and ``NotImplemented`` are singletons. :PEP:`8` advises that " "comparisons for singletons should always be done with ``is`` or ``is not``, " "never the equality operators." msgstr "" -#: reference/expressions.rst:1532 +#: reference/expressions.rst:1538 msgid "" "Binary sequences (instances of :class:`bytes` or :class:`bytearray`) can be " "compared within and across their types. They compare lexicographically " "using the numeric values of their elements." msgstr "" -#: reference/expressions.rst:1536 +#: reference/expressions.rst:1542 msgid "" "Strings (instances of :class:`str`) compare lexicographically using the " "numerical Unicode code points (the result of the built-in function :func:" "`ord`) of their characters. [#]_" msgstr "" -#: reference/expressions.rst:1540 +#: reference/expressions.rst:1546 msgid "Strings and binary sequences cannot be directly compared." msgstr "" -#: reference/expressions.rst:1542 +#: reference/expressions.rst:1548 msgid "" "Sequences (instances of :class:`tuple`, :class:`list`, or :class:`range`) " "can be compared only within each of their types, with the restriction that " @@ -1593,7 +1605,7 @@ msgid "" "raises :exc:`TypeError`." msgstr "" -#: reference/expressions.rst:1548 +#: reference/expressions.rst:1554 msgid "" "Sequences compare lexicographically using comparison of corresponding " "elements. The built-in containers typically assume identical objects are " @@ -1601,19 +1613,19 @@ msgid "" "objects to improve performance and to maintain their internal invariants." msgstr "" -#: reference/expressions.rst:1553 +#: reference/expressions.rst:1559 msgid "" "Lexicographical comparison between built-in collections works as follows:" msgstr "" -#: reference/expressions.rst:1555 +#: reference/expressions.rst:1561 msgid "" "For two collections to compare equal, they must be of the same type, have " "the same length, and each pair of corresponding elements must compare equal " "(for example, ``[1,2] == (1,2)`` is false because the type is not the same)." msgstr "" -#: reference/expressions.rst:1560 +#: reference/expressions.rst:1566 msgid "" "Collections that support order comparison are ordered the same as their " "first unequal elements (for example, ``[1,2,x] <= [1,2,y]`` has the same " @@ -1622,25 +1634,25 @@ msgid "" "true)." msgstr "" -#: reference/expressions.rst:1566 +#: reference/expressions.rst:1572 msgid "" "Mappings (instances of :class:`dict`) compare equal if and only if they have " "equal ``(key, value)`` pairs. Equality comparison of the keys and values " "enforces reflexivity." msgstr "" -#: reference/expressions.rst:1570 +#: reference/expressions.rst:1576 msgid "" "Order comparisons (``<``, ``>``, ``<=``, and ``>=``) raise :exc:`TypeError`." msgstr "" -#: reference/expressions.rst:1572 +#: reference/expressions.rst:1578 msgid "" "Sets (instances of :class:`set` or :class:`frozenset`) can be compared " "within and across their types." msgstr "" -#: reference/expressions.rst:1575 +#: reference/expressions.rst:1581 msgid "" "They define order comparison operators to mean subset and superset tests. " "Those relations do not define total orderings (for example, the two sets " @@ -1651,110 +1663,110 @@ msgid "" "sets as inputs)." msgstr "" -#: reference/expressions.rst:1583 +#: reference/expressions.rst:1589 msgid "Comparison of sets enforces reflexivity of its elements." msgstr "" -#: reference/expressions.rst:1585 +#: reference/expressions.rst:1591 msgid "" "Most other built-in types have no comparison methods implemented, so they " "inherit the default comparison behavior." msgstr "" -#: reference/expressions.rst:1588 +#: reference/expressions.rst:1594 msgid "" "User-defined classes that customize their comparison behavior should follow " "some consistency rules, if possible:" msgstr "" -#: reference/expressions.rst:1591 +#: reference/expressions.rst:1597 msgid "" "Equality comparison should be reflexive. In other words, identical objects " "should compare equal:" msgstr "" -#: reference/expressions.rst:1594 +#: reference/expressions.rst:1600 msgid "``x is y`` implies ``x == y``" msgstr "" -#: reference/expressions.rst:1596 +#: reference/expressions.rst:1602 msgid "" "Comparison should be symmetric. In other words, the following expressions " "should have the same result:" msgstr "" -#: reference/expressions.rst:1599 +#: reference/expressions.rst:1605 msgid "``x == y`` and ``y == x``" msgstr "" -#: reference/expressions.rst:1601 +#: reference/expressions.rst:1607 msgid "``x != y`` and ``y != x``" msgstr "" -#: reference/expressions.rst:1603 +#: reference/expressions.rst:1609 msgid "``x < y`` and ``y > x``" msgstr "" -#: reference/expressions.rst:1605 +#: reference/expressions.rst:1611 msgid "``x <= y`` and ``y >= x``" msgstr "" -#: reference/expressions.rst:1607 +#: reference/expressions.rst:1613 msgid "" "Comparison should be transitive. The following (non-exhaustive) examples " "illustrate that:" msgstr "" -#: reference/expressions.rst:1610 +#: reference/expressions.rst:1616 msgid "``x > y and y > z`` implies ``x > z``" msgstr "" -#: reference/expressions.rst:1612 +#: reference/expressions.rst:1618 msgid "``x < y and y <= z`` implies ``x < z``" msgstr "" -#: reference/expressions.rst:1614 +#: reference/expressions.rst:1620 msgid "" "Inverse comparison should result in the boolean negation. In other words, " "the following expressions should have the same result:" msgstr "" -#: reference/expressions.rst:1617 +#: reference/expressions.rst:1623 msgid "``x == y`` and ``not x != y``" msgstr "" -#: reference/expressions.rst:1619 +#: reference/expressions.rst:1625 msgid "``x < y`` and ``not x >= y`` (for total ordering)" msgstr "" -#: reference/expressions.rst:1621 +#: reference/expressions.rst:1627 msgid "``x > y`` and ``not x <= y`` (for total ordering)" msgstr "" -#: reference/expressions.rst:1623 +#: reference/expressions.rst:1629 msgid "" "The last two expressions apply to totally ordered collections (e.g. to " "sequences, but not to sets or mappings). See also the :func:`~functools." "total_ordering` decorator." msgstr "" -#: reference/expressions.rst:1627 +#: reference/expressions.rst:1633 msgid "" "The :func:`hash` result should be consistent with equality. Objects that are " "equal should either have the same hash value, or be marked as unhashable." msgstr "" -#: reference/expressions.rst:1631 +#: reference/expressions.rst:1637 msgid "" "Python does not enforce these consistency rules. In fact, the not-a-number " "values are an example for not following these rules." msgstr "" -#: reference/expressions.rst:1640 +#: reference/expressions.rst:1646 msgid "Membership test operations" msgstr "" -#: reference/expressions.rst:1642 +#: reference/expressions.rst:1648 msgid "" "The operators :keyword:`in` and :keyword:`not in` test for membership. ``x " "in s`` evaluates to ``True`` if *x* is a member of *s*, and ``False`` " @@ -1765,7 +1777,7 @@ msgid "" "expression ``x in y`` is equivalent to ``any(x is e or x == e for e in y)``." msgstr "" -#: reference/expressions.rst:1650 +#: reference/expressions.rst:1656 msgid "" "For the string and bytes types, ``x in y`` is ``True`` if and only if *x* is " "a substring of *y*. An equivalent test is ``y.find(x) != -1``. Empty " @@ -1773,14 +1785,14 @@ msgid "" "``\"\" in \"abc\"`` will return ``True``." msgstr "" -#: reference/expressions.rst:1655 +#: reference/expressions.rst:1661 msgid "" "For user-defined classes which define the :meth:`__contains__` method, ``x " "in y`` returns ``True`` if ``y.__contains__(x)`` returns a true value, and " "``False`` otherwise." msgstr "" -#: reference/expressions.rst:1659 +#: reference/expressions.rst:1665 msgid "" "For user-defined classes which do not define :meth:`__contains__` but do " "define :meth:`__iter__`, ``x in y`` is ``True`` if some value ``z``, for " @@ -1789,7 +1801,7 @@ msgid "" "as if :keyword:`in` raised that exception." msgstr "" -#: reference/expressions.rst:1665 +#: reference/expressions.rst:1671 msgid "" "Lastly, the old-style iteration protocol is tried: if a class defines :meth:" "`~object.__getitem__`, ``x in y`` is ``True`` if and only if there is a non-" @@ -1798,17 +1810,17 @@ msgid "" "exception is raised, it is as if :keyword:`in` raised that exception)." msgstr "" -#: reference/expressions.rst:1677 +#: reference/expressions.rst:1683 msgid "" "The operator :keyword:`not in` is defined to have the inverse truth value " "of :keyword:`in`." msgstr "" -#: reference/expressions.rst:1690 +#: reference/expressions.rst:1696 msgid "Identity comparisons" msgstr "" -#: reference/expressions.rst:1692 +#: reference/expressions.rst:1698 msgid "" "The operators :keyword:`is` and :keyword:`is not` test for an object's " "identity: ``x is y`` is true if and only if *x* and *y* are the same " @@ -1816,11 +1828,11 @@ msgid "" "``x is not y`` yields the inverse truth value. [#]_" msgstr "" -#: reference/expressions.rst:1704 +#: reference/expressions.rst:1710 msgid "Boolean operations" msgstr "" -#: reference/expressions.rst:1715 +#: reference/expressions.rst:1721 msgid "" "In the context of Boolean operations, and also when expressions are used by " "control flow statements, the following values are interpreted as false: " @@ -1831,25 +1843,25 @@ msgid "" "__bool__` method." msgstr "" -#: reference/expressions.rst:1724 +#: reference/expressions.rst:1730 msgid "" "The operator :keyword:`not` yields ``True`` if its argument is false, " "``False`` otherwise." msgstr "" -#: reference/expressions.rst:1729 +#: reference/expressions.rst:1735 msgid "" "The expression ``x and y`` first evaluates *x*; if *x* is false, its value " "is returned; otherwise, *y* is evaluated and the resulting value is returned." msgstr "" -#: reference/expressions.rst:1734 +#: reference/expressions.rst:1740 msgid "" "The expression ``x or y`` first evaluates *x*; if *x* is true, its value is " "returned; otherwise, *y* is evaluated and the resulting value is returned." msgstr "" -#: reference/expressions.rst:1737 +#: reference/expressions.rst:1743 msgid "" "Note that neither :keyword:`and` nor :keyword:`or` restrict the value and " "type they return to ``False`` and ``True``, but rather return the last " @@ -1860,11 +1872,11 @@ msgid "" "argument (for example, ``not 'foo'`` produces ``False`` rather than ``''``.)" msgstr "" -#: reference/expressions.rst:1753 +#: reference/expressions.rst:1759 msgid "Assignment expressions" msgstr "" -#: reference/expressions.rst:1758 +#: reference/expressions.rst:1764 msgid "" "An assignment expression (sometimes also called a \"named expression\" or " "\"walrus\") assigns an :token:`~python-grammar:expression` to an :token:" @@ -1872,53 +1884,54 @@ msgid "" "`~python-grammar:expression`." msgstr "" -#: reference/expressions.rst:1763 +#: reference/expressions.rst:1769 msgid "One common use case is when handling matched regular expressions:" msgstr "" -#: reference/expressions.rst:1770 +#: reference/expressions.rst:1776 msgid "Or, when processing a file stream in chunks:" msgstr "" -#: reference/expressions.rst:1777 +#: reference/expressions.rst:1783 msgid "" -"Assignment expressions must be surrounded by parentheses when used as sub-" -"expressions in slicing, conditional, lambda, keyword-argument, and " -"comprehension-if expressions and in ``assert`` and ``with`` statements. In " -"all other places where they can be used, parentheses are not required, " -"including in ``if`` and ``while`` statements." +"Assignment expressions must be surrounded by parentheses when used as " +"expression statements and when used as sub-expressions in slicing, " +"conditional, lambda, keyword-argument, and comprehension-if expressions and " +"in ``assert``, ``with``, and ``assignment`` statements. In all other places " +"where they can be used, parentheses are not required, including in ``if`` " +"and ``while`` statements." msgstr "" -#: reference/expressions.rst:1784 +#: reference/expressions.rst:1791 msgid "See :pep:`572` for more details about assignment expressions." msgstr "" -#: reference/expressions.rst:1791 +#: reference/expressions.rst:1798 msgid "Conditional expressions" msgstr "" -#: reference/expressions.rst:1803 +#: reference/expressions.rst:1810 msgid "" "Conditional expressions (sometimes called a \"ternary operator\") have the " "lowest priority of all Python operations." msgstr "" -#: reference/expressions.rst:1806 +#: reference/expressions.rst:1813 msgid "" "The expression ``x if C else y`` first evaluates the condition, *C* rather " "than *x*. If *C* is true, *x* is evaluated and its value is returned; " "otherwise, *y* is evaluated and its value is returned." msgstr "" -#: reference/expressions.rst:1810 +#: reference/expressions.rst:1817 msgid "See :pep:`308` for more details about conditional expressions." msgstr "" -#: reference/expressions.rst:1817 +#: reference/expressions.rst:1824 msgid "Lambdas" msgstr "" -#: reference/expressions.rst:1828 +#: reference/expressions.rst:1835 msgid "" "Lambda expressions (sometimes called lambda forms) are used to create " "anonymous functions. The expression ``lambda parameters: expression`` yields " @@ -1926,25 +1939,25 @@ msgid "" "defined with:" msgstr "" -#: reference/expressions.rst:1837 +#: reference/expressions.rst:1844 msgid "" "See section :ref:`function` for the syntax of parameter lists. Note that " "functions created with lambda expressions cannot contain statements or " "annotations." msgstr "" -#: reference/expressions.rst:1845 +#: reference/expressions.rst:1852 msgid "Expression lists" msgstr "" -#: reference/expressions.rst:1859 +#: reference/expressions.rst:1866 msgid "" "Except when part of a list or set display, an expression list containing at " "least one comma yields a tuple. The length of the tuple is the number of " "expressions in the list. The expressions are evaluated from left to right." msgstr "" -#: reference/expressions.rst:1868 +#: reference/expressions.rst:1875 msgid "" "An asterisk ``*`` denotes :dfn:`iterable unpacking`. Its operand must be " "an :term:`iterable`. The iterable is expanded into a sequence of items, " @@ -1952,12 +1965,12 @@ msgid "" "unpacking." msgstr "" -#: reference/expressions.rst:1873 +#: reference/expressions.rst:1880 msgid "" "Iterable unpacking in expression lists, originally proposed by :pep:`448`." msgstr "" -#: reference/expressions.rst:1878 +#: reference/expressions.rst:1885 msgid "" "The trailing comma is required only to create a single tuple (a.k.a. a " "*singleton*); it is optional in all other cases. A single expression " @@ -1966,28 +1979,28 @@ msgid "" "parentheses: ``()``.)" msgstr "" -#: reference/expressions.rst:1888 +#: reference/expressions.rst:1895 msgid "Evaluation order" msgstr "" -#: reference/expressions.rst:1892 +#: reference/expressions.rst:1899 msgid "" "Python evaluates expressions from left to right. Notice that while " "evaluating an assignment, the right-hand side is evaluated before the left-" "hand side." msgstr "" -#: reference/expressions.rst:1895 +#: reference/expressions.rst:1902 msgid "" "In the following lines, expressions will be evaluated in the arithmetic " "order of their suffixes::" msgstr "" -#: reference/expressions.rst:1909 +#: reference/expressions.rst:1916 msgid "Operator precedence" msgstr "" -#: reference/expressions.rst:1914 +#: reference/expressions.rst:1921 msgid "" "The following table summarizes the operator precedence in Python, from " "highest precedence (most binding) to lowest precedence (least binding). " @@ -1997,176 +2010,176 @@ msgid "" "group from right to left)." msgstr "" -#: reference/expressions.rst:1920 +#: reference/expressions.rst:1927 msgid "" "Note that comparisons, membership tests, and identity tests, all have the " "same precedence and have a left-to-right chaining feature as described in " "the :ref:`comparisons` section." msgstr "" -#: reference/expressions.rst:1926 +#: reference/expressions.rst:1933 msgid "Operator" msgstr "" -#: reference/expressions.rst:1926 +#: reference/expressions.rst:1933 msgid "Description" msgstr "" -#: reference/expressions.rst:1928 +#: reference/expressions.rst:1935 msgid "``(expressions...)``," msgstr "" -#: reference/expressions.rst:1930 +#: reference/expressions.rst:1937 msgid "``[expressions...]``, ``{key: value...}``, ``{expressions...}``" msgstr "" -#: reference/expressions.rst:1928 +#: reference/expressions.rst:1935 msgid "" "Binding or parenthesized expression, list display, dictionary display, set " "display" msgstr "" -#: reference/expressions.rst:1934 +#: reference/expressions.rst:1941 msgid "``x[index]``, ``x[index:index]``, ``x(arguments...)``, ``x.attribute``" msgstr "" -#: reference/expressions.rst:1934 +#: reference/expressions.rst:1941 msgid "Subscription, slicing, call, attribute reference" msgstr "" -#: reference/expressions.rst:1937 +#: reference/expressions.rst:1944 msgid ":keyword:`await x `" msgstr "" -#: reference/expressions.rst:1939 +#: reference/expressions.rst:1946 msgid "``**``" msgstr "" -#: reference/expressions.rst:1939 +#: reference/expressions.rst:1946 msgid "Exponentiation [#]_" msgstr "" -#: reference/expressions.rst:1941 +#: reference/expressions.rst:1948 msgid "``+x``, ``-x``, ``~x``" msgstr "" -#: reference/expressions.rst:1941 +#: reference/expressions.rst:1948 msgid "Positive, negative, bitwise NOT" msgstr "" -#: reference/expressions.rst:1943 +#: reference/expressions.rst:1950 msgid "``*``, ``@``, ``/``, ``//``, ``%``" msgstr "" -#: reference/expressions.rst:1943 +#: reference/expressions.rst:1950 msgid "" "Multiplication, matrix multiplication, division, floor division, remainder " "[#]_" msgstr "" -#: reference/expressions.rst:1947 +#: reference/expressions.rst:1954 msgid "``+``, ``-``" msgstr "" -#: reference/expressions.rst:1947 +#: reference/expressions.rst:1954 msgid "Addition and subtraction" msgstr "" -#: reference/expressions.rst:1949 +#: reference/expressions.rst:1956 msgid "``<<``, ``>>``" msgstr "" -#: reference/expressions.rst:1949 +#: reference/expressions.rst:1956 msgid "Shifts" msgstr "" -#: reference/expressions.rst:1951 +#: reference/expressions.rst:1958 msgid "``&``" msgstr "" -#: reference/expressions.rst:1951 +#: reference/expressions.rst:1958 msgid "Bitwise AND" msgstr "" -#: reference/expressions.rst:1953 +#: reference/expressions.rst:1960 msgid "``^``" msgstr "" -#: reference/expressions.rst:1953 +#: reference/expressions.rst:1960 msgid "Bitwise XOR" msgstr "" -#: reference/expressions.rst:1955 +#: reference/expressions.rst:1962 msgid "``|``" msgstr "" -#: reference/expressions.rst:1955 +#: reference/expressions.rst:1962 msgid "Bitwise OR" msgstr "" -#: reference/expressions.rst:1957 +#: reference/expressions.rst:1964 msgid "" ":keyword:`in`, :keyword:`not in`, :keyword:`is`, :keyword:`is not`, ``<``, " "``<=``, ``>``, ``>=``, ``!=``, ``==``" msgstr "" -#: reference/expressions.rst:1957 +#: reference/expressions.rst:1964 msgid "Comparisons, including membership tests and identity tests" msgstr "" -#: reference/expressions.rst:1961 +#: reference/expressions.rst:1968 msgid ":keyword:`not x `" msgstr "" -#: reference/expressions.rst:1961 +#: reference/expressions.rst:1968 msgid "Boolean NOT" msgstr "" -#: reference/expressions.rst:1963 +#: reference/expressions.rst:1970 msgid ":keyword:`and`" msgstr "" -#: reference/expressions.rst:1963 +#: reference/expressions.rst:1970 msgid "Boolean AND" msgstr "" -#: reference/expressions.rst:1965 +#: reference/expressions.rst:1972 msgid ":keyword:`or`" msgstr "" -#: reference/expressions.rst:1965 +#: reference/expressions.rst:1972 msgid "Boolean OR" msgstr "" -#: reference/expressions.rst:1967 +#: reference/expressions.rst:1974 msgid ":keyword:`if ` -- :keyword:`!else`" msgstr "" -#: reference/expressions.rst:1967 +#: reference/expressions.rst:1974 msgid "Conditional expression" msgstr "" -#: reference/expressions.rst:1969 +#: reference/expressions.rst:1976 msgid ":keyword:`lambda`" msgstr "" -#: reference/expressions.rst:1969 +#: reference/expressions.rst:1976 msgid "Lambda expression" msgstr "" -#: reference/expressions.rst:1971 +#: reference/expressions.rst:1978 msgid "``:=``" msgstr "" -#: reference/expressions.rst:1971 +#: reference/expressions.rst:1978 msgid "Assignment expression" msgstr "" -#: reference/expressions.rst:1976 +#: reference/expressions.rst:1983 msgid "Footnotes" msgstr "" -#: reference/expressions.rst:1977 +#: reference/expressions.rst:1984 msgid "" "While ``abs(x%y) < abs(y)`` is true mathematically, for floats it may not be " "true numerically due to roundoff. For example, and assuming a platform on " @@ -2178,7 +2191,7 @@ msgid "" "approach is more appropriate depends on the application." msgstr "" -#: reference/expressions.rst:1986 +#: reference/expressions.rst:1993 msgid "" "If x is very close to an exact integer multiple of y, it's possible for ``x//" "y`` to be one larger than ``(x-x%y)//y`` due to rounding. In such cases, " @@ -2186,7 +2199,7 @@ msgid "" "* y + x % y`` be very close to ``x``." msgstr "" -#: reference/expressions.rst:1991 +#: reference/expressions.rst:1998 msgid "" "The Unicode standard distinguishes between :dfn:`code points` (e.g. U+0041) " "and :dfn:`abstract characters` (e.g. \"LATIN CAPITAL LETTER A\"). While most " @@ -2200,7 +2213,7 @@ msgid "" "(COMBINING CEDILLA)." msgstr "" -#: reference/expressions.rst:2002 +#: reference/expressions.rst:2009 msgid "" "The comparison operators on strings compare at the level of Unicode code " "points. This may be counter-intuitive to humans. For example, ``\"\\u00C7\" " @@ -2208,13 +2221,13 @@ msgid "" "same abstract character \"LATIN CAPITAL LETTER C WITH CEDILLA\"." msgstr "" -#: reference/expressions.rst:2007 +#: reference/expressions.rst:2014 msgid "" "To compare strings at the level of abstract characters (that is, in a way " "intuitive to humans), use :func:`unicodedata.normalize`." msgstr "" -#: reference/expressions.rst:2010 +#: reference/expressions.rst:2017 msgid "" "Due to automatic garbage-collection, free lists, and the dynamic nature of " "descriptors, you may notice seemingly unusual behaviour in certain uses of " @@ -2222,20 +2235,20 @@ msgid "" "instance methods, or constants. Check their documentation for more info." msgstr "" -#: reference/expressions.rst:2015 +#: reference/expressions.rst:2022 msgid "" "The power operator ``**`` binds less tightly than an arithmetic or bitwise " "unary operator on its right, that is, ``2**-1`` is ``0.5``." msgstr "" -#: reference/expressions.rst:2018 +#: reference/expressions.rst:2025 msgid "" "The ``%`` operator is also used for string formatting; the same precedence " "applies." msgstr "" -#: reference/expressions.rst:362 reference/expressions.rst:1706 -#: reference/expressions.rst:1819 reference/expressions.rst:1847 +#: reference/expressions.rst:362 reference/expressions.rst:1712 +#: reference/expressions.rst:1826 reference/expressions.rst:1854 msgid "expression" msgstr "" @@ -2243,7 +2256,7 @@ msgstr "" msgid "BNF" msgstr "" -#: reference/expressions.rst:1207 reference/expressions.rst:1255 +#: reference/expressions.rst:1213 reference/expressions.rst:1261 msgid "arithmetic" msgstr "" @@ -2264,8 +2277,8 @@ msgid "identifier" msgstr "" #: reference/expressions.rst:537 reference/expressions.rst:714 -#: reference/expressions.rst:812 reference/expressions.rst:1290 -#: reference/expressions.rst:1380 +#: reference/expressions.rst:812 reference/expressions.rst:1296 +#: reference/expressions.rst:1386 msgid "exception" msgstr "" @@ -2303,9 +2316,9 @@ msgstr "" #: reference/expressions.rst:244 reference/expressions.rst:298 #: reference/expressions.rst:362 reference/expressions.rst:704 -#: reference/expressions.rst:835 reference/expressions.rst:952 -#: reference/expressions.rst:1113 reference/expressions.rst:1134 -#: reference/expressions.rst:1857 +#: reference/expressions.rst:841 reference/expressions.rst:958 +#: reference/expressions.rst:1119 reference/expressions.rst:1140 +#: reference/expressions.rst:1864 msgid "object" msgstr "" @@ -2313,7 +2326,7 @@ msgstr "" msgid "parenthesized form" msgstr "" -#: reference/expressions.rst:362 reference/expressions.rst:952 +#: reference/expressions.rst:362 reference/expressions.rst:958 msgid "() (parentheses)" msgstr "" @@ -2325,16 +2338,16 @@ msgstr "" msgid "empty" msgstr "" -#: reference/expressions.rst:835 reference/expressions.rst:1857 +#: reference/expressions.rst:841 reference/expressions.rst:1864 msgid "tuple" msgstr "" -#: reference/expressions.rst:1876 +#: reference/expressions.rst:1883 msgid "comma" msgstr "" #: reference/expressions.rst:244 reference/expressions.rst:298 -#: reference/expressions.rst:952 reference/expressions.rst:1847 +#: reference/expressions.rst:958 reference/expressions.rst:1854 msgid ", (comma)" msgstr "" @@ -2350,7 +2363,7 @@ msgstr "" msgid "in comprehensions" msgstr "" -#: reference/expressions.rst:1793 +#: reference/expressions.rst:1800 msgid "if" msgstr "" @@ -2358,12 +2371,12 @@ msgstr "" msgid "async for" msgstr "" -#: reference/expressions.rst:1152 +#: reference/expressions.rst:1158 msgid "await" msgstr "" -#: reference/expressions.rst:812 reference/expressions.rst:908 -#: reference/expressions.rst:1847 +#: reference/expressions.rst:812 reference/expressions.rst:914 +#: reference/expressions.rst:1854 msgid "list" msgstr "" @@ -2371,7 +2384,7 @@ msgstr "" msgid "display" msgstr "" -#: reference/expressions.rst:831 +#: reference/expressions.rst:837 msgid "[] (square brackets)" msgstr "" @@ -2379,7 +2392,7 @@ msgstr "" msgid "list expression" msgstr "" -#: reference/expressions.rst:270 reference/expressions.rst:1847 +#: reference/expressions.rst:270 reference/expressions.rst:1854 msgid "expression list" msgstr "" @@ -2395,7 +2408,7 @@ msgstr "" msgid "set expression" msgstr "" -#: reference/expressions.rst:324 reference/expressions.rst:835 +#: reference/expressions.rst:324 reference/expressions.rst:841 msgid "dictionary" msgstr "" @@ -2415,7 +2428,7 @@ msgstr "" msgid "dictionary expression" msgstr "" -#: reference/expressions.rst:902 reference/expressions.rst:1819 +#: reference/expressions.rst:908 reference/expressions.rst:1826 msgid ": (colon)" msgstr "" @@ -2427,11 +2440,11 @@ msgstr "" msgid "in dictionary displays" msgstr "" -#: reference/expressions.rst:1035 reference/expressions.rst:1864 +#: reference/expressions.rst:1041 reference/expressions.rst:1871 msgid "unpacking" msgstr "" -#: reference/expressions.rst:1065 reference/expressions.rst:1172 +#: reference/expressions.rst:1071 reference/expressions.rst:1178 msgid "**" msgstr "" @@ -2447,7 +2460,7 @@ msgstr "" msgid "generator expression" msgstr "" -#: reference/expressions.rst:1152 +#: reference/expressions.rst:1158 msgid "keyword" msgstr "" @@ -2459,7 +2472,7 @@ msgstr "" msgid "from" msgstr "" -#: reference/expressions.rst:1100 reference/expressions.rst:1819 +#: reference/expressions.rst:1106 reference/expressions.rst:1826 msgid "function" msgstr "" @@ -2519,442 +2532,442 @@ msgstr "" msgid "module" msgstr "" -#: reference/expressions.rst:831 +#: reference/expressions.rst:837 msgid "subscription" msgstr "" -#: reference/expressions.rst:908 reference/expressions.rst:1671 +#: reference/expressions.rst:914 reference/expressions.rst:1677 msgid "sequence" msgstr "" -#: reference/expressions.rst:835 +#: reference/expressions.rst:841 msgid "mapping" msgstr "" -#: reference/expressions.rst:888 reference/expressions.rst:908 +#: reference/expressions.rst:894 reference/expressions.rst:914 msgid "string" msgstr "" -#: reference/expressions.rst:888 +#: reference/expressions.rst:894 msgid "item" msgstr "" -#: reference/expressions.rst:888 +#: reference/expressions.rst:894 msgid "character" msgstr "" -#: reference/expressions.rst:902 +#: reference/expressions.rst:908 msgid "slicing" msgstr "" -#: reference/expressions.rst:902 +#: reference/expressions.rst:908 msgid "slice" msgstr "" -#: reference/expressions.rst:934 +#: reference/expressions.rst:940 msgid "start (slice object attribute)" msgstr "" -#: reference/expressions.rst:934 +#: reference/expressions.rst:940 msgid "stop (slice object attribute)" msgstr "" -#: reference/expressions.rst:934 +#: reference/expressions.rst:940 msgid "step (slice object attribute)" msgstr "" -#: reference/expressions.rst:952 +#: reference/expressions.rst:958 msgid "callable" msgstr "" -#: reference/expressions.rst:1100 reference/expressions.rst:1127 -#: reference/expressions.rst:1144 +#: reference/expressions.rst:1106 reference/expressions.rst:1133 +#: reference/expressions.rst:1150 msgid "call" msgstr "" -#: reference/expressions.rst:952 +#: reference/expressions.rst:958 msgid "argument" msgstr "" -#: reference/expressions.rst:985 +#: reference/expressions.rst:991 msgid "call semantics" msgstr "" -#: reference/expressions.rst:952 +#: reference/expressions.rst:958 msgid "argument list" msgstr "" -#: reference/expressions.rst:952 +#: reference/expressions.rst:958 msgid "= (equals)" msgstr "" -#: reference/expressions.rst:1035 reference/expressions.rst:1065 +#: reference/expressions.rst:1041 reference/expressions.rst:1071 msgid "in function calls" msgstr "" -#: reference/expressions.rst:985 +#: reference/expressions.rst:991 msgid "parameter" msgstr "" -#: reference/expressions.rst:1268 reference/expressions.rst:1864 +#: reference/expressions.rst:1274 reference/expressions.rst:1871 msgid "* (asterisk)" msgstr "" -#: reference/expressions.rst:1100 +#: reference/expressions.rst:1106 msgid "user-defined" msgstr "" -#: reference/expressions.rst:1100 +#: reference/expressions.rst:1106 msgid "user-defined function" msgstr "" -#: reference/expressions.rst:1113 +#: reference/expressions.rst:1119 msgid "built-in function" msgstr "" -#: reference/expressions.rst:1113 +#: reference/expressions.rst:1119 msgid "method" msgstr "" -#: reference/expressions.rst:1113 +#: reference/expressions.rst:1119 msgid "built-in method" msgstr "" -#: reference/expressions.rst:1127 +#: reference/expressions.rst:1133 msgid "class" msgstr "" -#: reference/expressions.rst:1127 +#: reference/expressions.rst:1133 msgid "class object" msgstr "" -#: reference/expressions.rst:1134 +#: reference/expressions.rst:1140 msgid "class instance" msgstr "" -#: reference/expressions.rst:1144 +#: reference/expressions.rst:1150 msgid "instance" msgstr "" -#: reference/expressions.rst:1144 +#: reference/expressions.rst:1150 msgid "__call__() (object method)" msgstr "" -#: reference/expressions.rst:1172 +#: reference/expressions.rst:1178 msgid "power" msgstr "" -#: reference/expressions.rst:1207 reference/expressions.rst:1364 -#: reference/expressions.rst:1706 +#: reference/expressions.rst:1213 reference/expressions.rst:1370 +#: reference/expressions.rst:1712 msgid "operation" msgstr "" -#: reference/expressions.rst:1216 reference/expressions.rst:1233 -#: reference/expressions.rst:1281 reference/expressions.rst:1306 -#: reference/expressions.rst:1348 reference/expressions.rst:1400 -#: reference/expressions.rst:1417 reference/expressions.rst:1671 -#: reference/expressions.rst:1722 reference/expressions.rst:1732 -#: reference/expressions.rst:1911 +#: reference/expressions.rst:1222 reference/expressions.rst:1239 +#: reference/expressions.rst:1287 reference/expressions.rst:1312 +#: reference/expressions.rst:1354 reference/expressions.rst:1406 +#: reference/expressions.rst:1423 reference/expressions.rst:1677 +#: reference/expressions.rst:1728 reference/expressions.rst:1738 +#: reference/expressions.rst:1918 msgid "operator" msgstr "" -#: reference/expressions.rst:1207 +#: reference/expressions.rst:1213 msgid "unary" msgstr "" -#: reference/expressions.rst:1391 reference/expressions.rst:1408 -#: reference/expressions.rst:1417 +#: reference/expressions.rst:1397 reference/expressions.rst:1414 +#: reference/expressions.rst:1423 msgid "bitwise" msgstr "" -#: reference/expressions.rst:1216 +#: reference/expressions.rst:1222 msgid "negation" msgstr "" -#: reference/expressions.rst:1216 +#: reference/expressions.rst:1222 msgid "minus" msgstr "" -#: reference/expressions.rst:1348 +#: reference/expressions.rst:1354 msgid "- (minus)" msgstr "" -#: reference/expressions.rst:1225 +#: reference/expressions.rst:1231 msgid "unary operator" msgstr "" -#: reference/expressions.rst:1225 +#: reference/expressions.rst:1231 msgid "plus" msgstr "" -#: reference/expressions.rst:1335 +#: reference/expressions.rst:1341 msgid "+ (plus)" msgstr "" -#: reference/expressions.rst:1233 +#: reference/expressions.rst:1239 msgid "inversion" msgstr "" -#: reference/expressions.rst:1233 +#: reference/expressions.rst:1239 msgid "~ (tilde)" msgstr "" -#: reference/expressions.rst:1244 +#: reference/expressions.rst:1250 msgid "TypeError" msgstr "" -#: reference/expressions.rst:1391 +#: reference/expressions.rst:1397 msgid "binary" msgstr "" -#: reference/expressions.rst:1268 +#: reference/expressions.rst:1274 msgid "multiplication" msgstr "" -#: reference/expressions.rst:1281 +#: reference/expressions.rst:1287 msgid "matrix multiplication" msgstr "" -#: reference/expressions.rst:1281 +#: reference/expressions.rst:1287 msgid "@ (at)" msgstr "" -#: reference/expressions.rst:1290 +#: reference/expressions.rst:1296 msgid "ZeroDivisionError" msgstr "" -#: reference/expressions.rst:1290 +#: reference/expressions.rst:1296 msgid "division" msgstr "" -#: reference/expressions.rst:1290 +#: reference/expressions.rst:1296 msgid "/ (slash)" msgstr "" -#: reference/expressions.rst:1290 +#: reference/expressions.rst:1296 msgid "//" msgstr "" -#: reference/expressions.rst:1306 +#: reference/expressions.rst:1312 msgid "modulo" msgstr "" -#: reference/expressions.rst:1306 +#: reference/expressions.rst:1312 msgid "% (percent)" msgstr "" -#: reference/expressions.rst:1335 +#: reference/expressions.rst:1341 msgid "addition" msgstr "" -#: reference/expressions.rst:1348 +#: reference/expressions.rst:1354 msgid "binary operator" msgstr "" -#: reference/expressions.rst:1348 +#: reference/expressions.rst:1354 msgid "subtraction" msgstr "" -#: reference/expressions.rst:1364 +#: reference/expressions.rst:1370 msgid "shifting" msgstr "" -#: reference/expressions.rst:1364 +#: reference/expressions.rst:1370 msgid "<<" msgstr "" -#: reference/expressions.rst:1364 +#: reference/expressions.rst:1370 msgid ">>" msgstr "" -#: reference/expressions.rst:1380 +#: reference/expressions.rst:1386 msgid "ValueError" msgstr "" -#: reference/expressions.rst:1727 +#: reference/expressions.rst:1733 msgid "and" msgstr "" -#: reference/expressions.rst:1400 +#: reference/expressions.rst:1406 msgid "& (ampersand)" msgstr "" -#: reference/expressions.rst:1408 +#: reference/expressions.rst:1414 msgid "xor" msgstr "" -#: reference/expressions.rst:1408 +#: reference/expressions.rst:1414 msgid "exclusive" msgstr "" -#: reference/expressions.rst:1417 reference/expressions.rst:1732 +#: reference/expressions.rst:1423 reference/expressions.rst:1738 msgid "or" msgstr "" -#: reference/expressions.rst:1408 +#: reference/expressions.rst:1414 msgid "^ (caret)" msgstr "" -#: reference/expressions.rst:1417 +#: reference/expressions.rst:1423 msgid "inclusive" msgstr "" -#: reference/expressions.rst:1417 +#: reference/expressions.rst:1423 msgid "| (vertical bar)" msgstr "" -#: reference/expressions.rst:1432 +#: reference/expressions.rst:1438 msgid "comparison" msgstr "" -#: reference/expressions.rst:1432 +#: reference/expressions.rst:1438 msgid "C" msgstr "" -#: reference/expressions.rst:1432 +#: reference/expressions.rst:1438 msgid "language" msgstr "" -#: reference/expressions.rst:1432 +#: reference/expressions.rst:1438 msgid "< (less)" msgstr "" -#: reference/expressions.rst:1432 +#: reference/expressions.rst:1438 msgid "> (greater)" msgstr "" -#: reference/expressions.rst:1432 +#: reference/expressions.rst:1438 msgid "<=" msgstr "" -#: reference/expressions.rst:1432 +#: reference/expressions.rst:1438 msgid ">=" msgstr "" -#: reference/expressions.rst:1432 +#: reference/expressions.rst:1438 msgid "==" msgstr "" -#: reference/expressions.rst:1432 +#: reference/expressions.rst:1438 msgid "!=" msgstr "" -#: reference/expressions.rst:1456 +#: reference/expressions.rst:1462 msgid "chaining" msgstr "" -#: reference/expressions.rst:1456 +#: reference/expressions.rst:1462 msgid "comparisons" msgstr "" -#: reference/expressions.rst:1671 +#: reference/expressions.rst:1677 msgid "in" msgstr "" -#: reference/expressions.rst:1671 +#: reference/expressions.rst:1677 msgid "not in" msgstr "" -#: reference/expressions.rst:1671 +#: reference/expressions.rst:1677 msgid "membership" msgstr "" -#: reference/expressions.rst:1680 +#: reference/expressions.rst:1686 msgid "test" msgstr "" -#: reference/expressions.rst:1680 +#: reference/expressions.rst:1686 msgid "is" msgstr "" -#: reference/expressions.rst:1680 +#: reference/expressions.rst:1686 msgid "is not" msgstr "" -#: reference/expressions.rst:1680 +#: reference/expressions.rst:1686 msgid "identity" msgstr "" -#: reference/expressions.rst:1706 +#: reference/expressions.rst:1712 msgid "Conditional" msgstr "" -#: reference/expressions.rst:1706 +#: reference/expressions.rst:1712 msgid "Boolean" msgstr "" -#: reference/expressions.rst:1722 +#: reference/expressions.rst:1728 msgid "not" msgstr "" -#: reference/expressions.rst:1746 +#: reference/expressions.rst:1752 msgid ":= (colon equals)" msgstr "" -#: reference/expressions.rst:1746 +#: reference/expressions.rst:1752 msgid "assignment expression" msgstr "" -#: reference/expressions.rst:1746 +#: reference/expressions.rst:1752 msgid "walrus operator" msgstr "" -#: reference/expressions.rst:1746 +#: reference/expressions.rst:1752 msgid "named expression" msgstr "" -#: reference/expressions.rst:1793 +#: reference/expressions.rst:1800 msgid "conditional" msgstr "" -#: reference/expressions.rst:1793 +#: reference/expressions.rst:1800 msgid "ternary" msgstr "" -#: reference/expressions.rst:1793 +#: reference/expressions.rst:1800 msgid "conditional expression" msgstr "" -#: reference/expressions.rst:1793 +#: reference/expressions.rst:1800 msgid "else" msgstr "" -#: reference/expressions.rst:1819 +#: reference/expressions.rst:1826 msgid "lambda" msgstr "" -#: reference/expressions.rst:1819 +#: reference/expressions.rst:1826 msgid "form" msgstr "" -#: reference/expressions.rst:1819 +#: reference/expressions.rst:1826 msgid "anonymous" msgstr "" -#: reference/expressions.rst:1819 +#: reference/expressions.rst:1826 msgid "lambda expression" msgstr "" -#: reference/expressions.rst:1864 +#: reference/expressions.rst:1871 msgid "iterable" msgstr "" -#: reference/expressions.rst:1864 +#: reference/expressions.rst:1871 msgid "in expression lists" msgstr "" -#: reference/expressions.rst:1876 +#: reference/expressions.rst:1883 msgid "trailing" msgstr "" -#: reference/expressions.rst:1890 +#: reference/expressions.rst:1897 msgid "evaluation" msgstr "" -#: reference/expressions.rst:1890 +#: reference/expressions.rst:1897 msgid "order" msgstr "" -#: reference/expressions.rst:1911 +#: reference/expressions.rst:1918 msgid "precedence" msgstr "" diff --git a/tutorial/errors.po b/tutorial/errors.po index 5d1ef6e96..459b16bc3 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-09-18 19:05+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: 2022-12-28 22:18+0300\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -178,18 +178,19 @@ msgstr "" "bloğundan sonra yürütme devam eder." #: tutorial/errors.rst:109 +#, fuzzy msgid "" "If an exception occurs which does not match the exception named in the " "*except clause*, it is passed on to outer :keyword:`try` statements; if no " -"handler is found, it is an *unhandled exception* and execution stops with a " -"message as shown above." +"handler is found, it is an *unhandled exception* and execution stops with an " +"error message." msgstr "" "*except yan tümcesinde* adı geçen özel durumla eşleşmeyen bir özel durum " "oluşursa, daha dışarıda olan :keyword:`try` ifadelerine geçirilir; işleyici " "bulunamazsa, bu bir *işlenmeyen özel durum* olur ve yürütme yukarıda " "gösterildiği gibi bir iletiyle durur." -#: tutorial/errors.rst:114 +#: tutorial/errors.rst:113 msgid "" "A :keyword:`try` statement may have more than one *except clause*, to " "specify handlers for different exceptions. At most one handler will be " @@ -205,7 +206,7 @@ msgstr "" "işleyicilerinde işlemez. *except yan tümcesi* birden çok özel durumu " "parantezli demet olarak adlandırabilir, örneğin::" -#: tutorial/errors.rst:123 +#: tutorial/errors.rst:122 msgid "" "A class in an :keyword:`except` clause is compatible with an exception if it " "is the same class or a base class thereof (but not the other way around --- " @@ -217,7 +218,7 @@ msgstr "" "temel sınıfla uyumlu olmadığından tersi olamaz). Örneğin, aşağıdaki kod B, " "C, D'yi bu sırada yazdırır::" -#: tutorial/errors.rst:147 +#: tutorial/errors.rst:146 msgid "" "Note that if the *except clauses* were reversed (with ``except B`` first), " "it would have printed B, B, B --- the first matching *except clause* is " @@ -227,7 +228,7 @@ msgstr "" "B, B şeklinde yazdırılacaktır --- ilk eşleşen *except yan tümcesi* " "tetiklenir." -#: tutorial/errors.rst:150 +#: tutorial/errors.rst:149 msgid "" "When an exception occurs, it may have associated values, also known as the " "exception's *arguments*. The presence and types of the arguments depend on " @@ -236,7 +237,7 @@ msgstr "" "Bir istisna oluştuğunda, istisnanın *argümanı* olarak da bilinen ilişkili " "bir değeri olabilir. Argümanın varlığı ve türü, istisna türüne bağlıdır." -#: tutorial/errors.rst:154 +#: tutorial/errors.rst:153 #, fuzzy msgid "" "The *except clause* may specify a variable after the exception name. The " @@ -251,7 +252,7 @@ msgstr "" "yerleşik istisna türleri :meth:`__str__`, ``.args`` öğesine açıkça erişmeden " "tüm argümanları yazdırmak için tanımlar. ::" -#: tutorial/errors.rst:177 +#: tutorial/errors.rst:176 #, fuzzy msgid "" "The exception's :meth:`~object.__str__` output is printed as the last part " @@ -260,7 +261,7 @@ msgstr "" "İstisnanın :meth:`__str__` çıktısı, işlenmeyen istisnalar için mesajın son " "kısmı ('ayrıntı') olarak yazdırılır." -#: tutorial/errors.rst:180 +#: tutorial/errors.rst:179 msgid "" ":exc:`BaseException` is the common base class of all exceptions. One of its " "subclasses, :exc:`Exception`, is the base class of all the non-fatal " @@ -278,7 +279,7 @@ msgstr "" "exc:`SystemExit` ve bir kullanıcı programı kesmek istediğinde ortaya çıkan :" "exc:`KeyboardInterrupt` içerir." -#: tutorial/errors.rst:188 +#: tutorial/errors.rst:187 msgid "" ":exc:`Exception` can be used as a wildcard that catches (almost) everything. " "However, it is good practice to be as specific as possible with the types of " @@ -290,7 +291,7 @@ msgstr "" "türleri konusunda mümkün olduğunca spesifik olmak ve beklenmeyen " "istisnaların yayılmasına izin vermek iyi bir uygulamadır." -#: tutorial/errors.rst:193 +#: tutorial/errors.rst:192 msgid "" "The most common pattern for handling :exc:`Exception` is to print or log the " "exception and then re-raise it (allowing a caller to handle the exception as " @@ -300,7 +301,7 @@ msgstr "" "log'a kaydetmek ve ardından yeniden yükseltmektir (arayanın istisnayı da " "işlemesine izin verir)::" -#: tutorial/errors.rst:211 +#: tutorial/errors.rst:210 msgid "" "The :keyword:`try` ... :keyword:`except` statement has an optional *else " "clause*, which, when present, must follow all *except clauses*. It is " @@ -312,7 +313,7 @@ msgstr "" "izlemelidir. *try yan tümcesi* bir özel durum oluşturmazsa yürütülmesi " "gereken kod için yararlıdır. Mesela::" -#: tutorial/errors.rst:225 +#: tutorial/errors.rst:224 msgid "" "The use of the :keyword:`!else` clause is better than adding additional code " "to the :keyword:`try` clause because it avoids accidentally catching an " @@ -324,7 +325,7 @@ msgstr "" "korunan kod tarafından oluşturulmamış bir istisnayı yakalamayı önler. ... :" "keyword:`!except` ifadesi." -#: tutorial/errors.rst:230 +#: tutorial/errors.rst:229 msgid "" "Exception handlers do not handle only exceptions that occur immediately in " "the *try clause*, but also those that occur inside functions that are called " @@ -334,11 +335,11 @@ msgstr "" "istisnaları değil, aynı zamanda *try yan tümcesinde* çağrılan (dolaylı " "olarak da olsa) işlevlerin içinde oluşan istisnaları da işler. Örneğin::" -#: tutorial/errors.rst:248 +#: tutorial/errors.rst:247 msgid "Raising Exceptions" msgstr "Hata Yükseltme" -#: tutorial/errors.rst:250 +#: tutorial/errors.rst:249 msgid "" "The :keyword:`raise` statement allows the programmer to force a specified " "exception to occur. For example::" @@ -346,7 +347,7 @@ msgstr "" ":keyword:`raise` ifadesi, programcının belirli bir istisnanın " "gerçekleşmesini zorlamasını sağlar. Örneğin::" -#: tutorial/errors.rst:258 +#: tutorial/errors.rst:257 msgid "" "The sole argument to :keyword:`raise` indicates the exception to be raised. " "This must be either an exception instance or an exception class (a class " @@ -360,7 +361,7 @@ msgstr "" "olmalıdır. Bir istisna sınıfı iletilirse, yapıcısını hiçbir argüman olmadan " "çağırarak dolaylı olarak başlatılır::" -#: tutorial/errors.rst:266 +#: tutorial/errors.rst:265 msgid "" "If you need to determine whether an exception was raised but don't intend to " "handle it, a simpler form of the :keyword:`raise` statement allows you to re-" @@ -370,11 +371,11 @@ msgstr "" "onu işlemeyi düşünmüyorsanız, :keyword:`raise` ifadesinin daha basit bir " "biçimi, istisnayı yeniden oluşturmanıza olanak tanır::" -#: tutorial/errors.rst:285 +#: tutorial/errors.rst:284 msgid "Exception Chaining" msgstr "İstisna Zincirleme" -#: tutorial/errors.rst:287 +#: tutorial/errors.rst:286 msgid "" "If an unhandled exception occurs inside an :keyword:`except` section, it " "will have the exception being handled attached to it and included in the " @@ -384,7 +385,7 @@ msgstr "" "istisnanın kendisine eklenmiş olarak işlenmesi ve şu hata mesajına dahil " "edilmesi gerekir::" -#: tutorial/errors.rst:306 +#: tutorial/errors.rst:305 msgid "" "To indicate that an exception is a direct consequence of another, the :" "keyword:`raise` statement allows an optional :keyword:`from` clause::" @@ -393,11 +394,11 @@ msgstr "" "sonucu olduğunu belirtmek için isteğe bağlı :keyword:`from` yan " "tümcesine izin verir::" -#: tutorial/errors.rst:312 +#: tutorial/errors.rst:311 msgid "This can be useful when you are transforming exceptions. For example::" msgstr "Bu, özel durumları dönüştürürken yararlı olabilir. Mesela::" -#: tutorial/errors.rst:333 +#: tutorial/errors.rst:332 msgid "" "It also allows disabling automatic exception chaining using the ``from " "None`` idiom::" @@ -405,18 +406,18 @@ msgstr "" "Ayrıca, ``from None`` deyimi kullanılarak otomatik istisna zincirlemenin " "devre dışı bırakılmasına izin verir::" -#: tutorial/errors.rst:345 +#: tutorial/errors.rst:344 msgid "" "For more information about chaining mechanics, see :ref:`bltin-exceptions`." msgstr "" "Zincirleme mekaniği hakkında daha fazla bilgi için bkz. :ref:`bltin-" "exceptions`." -#: tutorial/errors.rst:351 +#: tutorial/errors.rst:350 msgid "User-defined Exceptions" msgstr "Kullanıcı Tanımlı İstisnalar" -#: tutorial/errors.rst:353 +#: tutorial/errors.rst:352 msgid "" "Programs may name their own exceptions by creating a new exception class " "(see :ref:`tut-classes` for more about Python classes). Exceptions should " @@ -428,7 +429,7 @@ msgstr "" "`tut-classes` ). Özel durumlar genellikle doğrudan veya dolaylı olarak :exc:" "`Exception` sınıfından türetilmelidir." -#: tutorial/errors.rst:357 +#: tutorial/errors.rst:356 msgid "" "Exception classes can be defined which do anything any other class can do, " "but are usually kept simple, often only offering a number of attributes that " @@ -440,7 +441,7 @@ msgstr "" "istisna için işleyiciler tarafından hatayla ilgili bilgilerin çıkarılmasına " "izin veren bir dizi öznitelik sunar." -#: tutorial/errors.rst:361 +#: tutorial/errors.rst:360 msgid "" "Most exceptions are defined with names that end in \"Error\", similar to the " "naming of the standard exceptions." @@ -448,7 +449,7 @@ msgstr "" "Çoğu özel durum, standart özel durumların adlandırışına benzer şekilde " "\"Hata\" ile biten adlarla tanımlanır." -#: tutorial/errors.rst:364 +#: tutorial/errors.rst:363 msgid "" "Many standard modules define their own exceptions to report errors that may " "occur in functions they define." @@ -456,11 +457,11 @@ msgstr "" "Birçok standart modül, tanımladıkları işlevlerde oluşabilecek hataları " "raporlamak için kendi istisnalarını tanımlar." -#: tutorial/errors.rst:371 +#: tutorial/errors.rst:370 msgid "Defining Clean-up Actions" msgstr "Temizleme Eylemlerini Tanımlama" -#: tutorial/errors.rst:373 +#: tutorial/errors.rst:372 msgid "" "The :keyword:`try` statement has another optional clause which is intended " "to define clean-up actions that must be executed under all circumstances. " @@ -469,7 +470,7 @@ msgstr "" ":keyword:`try` deyimi, her koşulda yürütülmesi gereken temizleme eylemlerini " "tanımlamayı amaçlayan başka bir opsiyonel yan tümceye sahiptir. Mesela::" -#: tutorial/errors.rst:387 +#: tutorial/errors.rst:386 msgid "" "If a :keyword:`finally` clause is present, the :keyword:`!finally` clause " "will execute as the last task before the :keyword:`try` statement completes. " @@ -483,7 +484,7 @@ msgstr "" "oluşturup oluşturmadığından bağımsız çalışır. Aşağıdaki noktalarda, bir " "istisna oluştuğunda daha karmaşık durumlar anlatılmaktadır:" -#: tutorial/errors.rst:393 +#: tutorial/errors.rst:392 msgid "" "If an exception occurs during execution of the :keyword:`!try` clause, the " "exception may be handled by an :keyword:`except` clause. If the exception is " @@ -495,7 +496,7 @@ msgstr "" "bir :keyword:`!except` yan tümcesi tarafından ele alınmıyorsa, istisna :" "keyword:`!finally` yan tümcesi yürütüldükten sonra yeniden oluşturulur." -#: tutorial/errors.rst:399 +#: tutorial/errors.rst:398 msgid "" "An exception could occur during execution of an :keyword:`!except` or :" "keyword:`!else` clause. Again, the exception is re-raised after the :keyword:" @@ -505,7 +506,7 @@ msgstr "" "sırasında bir istisna oluşabilir. Yine, istisna, :keyword:`!finally` yan " "tümcesi yürütüldükten sonra yeniden oluşturulur." -#: tutorial/errors.rst:403 +#: tutorial/errors.rst:402 msgid "" "If the :keyword:`!finally` clause executes a :keyword:`break`, :keyword:" "`continue` or :keyword:`return` statement, exceptions are not re-raised." @@ -513,7 +514,7 @@ msgstr "" ":keyword:`!finally` yan tümcesi bir :keyword:`break`, :keyword:`continue` " "veya :keyword:`return` deyimini yürütürse, istisnalar yeniden oluşturulmaz." -#: tutorial/errors.rst:407 +#: tutorial/errors.rst:406 msgid "" "If the :keyword:`!try` statement reaches a :keyword:`break`, :keyword:" "`continue` or :keyword:`return` statement, the :keyword:`!finally` clause " @@ -525,7 +526,7 @@ msgstr "" "keyword:`!break`, :keyword:`!continue` veya :keyword:`!return` ifadesinin " "yürütülmesinin hemen öncesinde yürütülür." -#: tutorial/errors.rst:413 +#: tutorial/errors.rst:412 msgid "" "If a :keyword:`!finally` clause includes a :keyword:`!return` statement, the " "returned value will be the one from the :keyword:`!finally` clause's :" @@ -537,15 +538,15 @@ msgstr "" "return` ifadesindeki değer olacaktır, :keyword:`!try` yan tümcesinin :" "keyword:`!return` ifadesindeki değer değil." -#: tutorial/errors.rst:419 +#: tutorial/errors.rst:418 msgid "For example::" msgstr "Mesela::" -#: tutorial/errors.rst:430 +#: tutorial/errors.rst:429 msgid "A more complicated example::" msgstr "Daha karmaşık bir örnek::" -#: tutorial/errors.rst:455 +#: tutorial/errors.rst:454 msgid "" "As you can see, the :keyword:`finally` clause is executed in any event. " "The :exc:`TypeError` raised by dividing two strings is not handled by the :" @@ -557,7 +558,7 @@ msgstr "" "tarafından işlenmez ve bu nedenle :keyword:`!finally` yan tümcesi " "yürütüldikten sonra yeniden yükseltilir." -#: tutorial/errors.rst:460 +#: tutorial/errors.rst:459 msgid "" "In real world applications, the :keyword:`finally` clause is useful for " "releasing external resources (such as files or network connections), " @@ -567,11 +568,11 @@ msgstr "" "kullanımının başarılı olup olmadığına bakılmaksızın dış kaynakları (dosyalar " "veya ağ bağlantıları gibi) serbest bırakmak için yararlıdır." -#: tutorial/errors.rst:468 +#: tutorial/errors.rst:467 msgid "Predefined Clean-up Actions" msgstr "Önceden Tanımlanmış Temizleme Eylemleri" -#: tutorial/errors.rst:470 +#: tutorial/errors.rst:469 msgid "" "Some objects define standard clean-up actions to be undertaken when the " "object is no longer needed, regardless of whether or not the operation using " @@ -583,7 +584,7 @@ msgstr "" "standart temizleme eylemlerini tanımlar. Bir dosyayı açmaya ve içeriğini " "ekrana yazdırmaya çalışan aşağıdaki örneğe bakın. ::" -#: tutorial/errors.rst:478 +#: tutorial/errors.rst:477 msgid "" "The problem with this code is that it leaves the file open for an " "indeterminate amount of time after this part of the code has finished " @@ -598,7 +599,7 @@ msgstr "" "keyword:`with` ifadesi, dosyalar gibi nesnelerin her zaman hızlı ve doğru " "temizlenmesini sağlayacak şekilde kullanılmasına izin verir. ::" -#: tutorial/errors.rst:488 +#: tutorial/errors.rst:487 msgid "" "After the statement is executed, the file *f* is always closed, even if a " "problem was encountered while processing the lines. Objects which, like " @@ -609,11 +610,11 @@ msgstr "" "bile *f* dosyası her zaman kapatılır. Dosyalar gibi önceden tanımlanmış " "temizleme eylemleri sağlayan nesneler dokümantasyonlarında bunu gösterir." -#: tutorial/errors.rst:496 +#: tutorial/errors.rst:495 msgid "Raising and Handling Multiple Unrelated Exceptions" msgstr "Birden Fazla Alakasız İstisna Oluşturma ve İşleme" -#: tutorial/errors.rst:498 +#: tutorial/errors.rst:497 msgid "" "There are situations where it is necessary to report several exceptions that " "have occurred. This is often the case in concurrency frameworks, when " @@ -627,7 +628,7 @@ msgstr "" "yerine yürütmeye devam etmenin ve birden çok hata toplamanın istendiği başka " "kullanım durumları da vardır." -#: tutorial/errors.rst:504 +#: tutorial/errors.rst:503 msgid "" "The builtin :exc:`ExceptionGroup` wraps a list of exception instances so " "that they can be raised together. It is an exception itself, so it can be " @@ -637,7 +638,7 @@ msgstr "" "örneklerinin bir listesini sarar. Kendisi bir istisnadır, bu nedenle " "herhangi bir istisna gibi yakalanabilir. ::" -#: tutorial/errors.rst:530 +#: tutorial/errors.rst:529 msgid "" "By using ``except*`` instead of ``except``, we can selectively handle only " "the exceptions in the group that match a certain type. In the following " @@ -651,7 +652,7 @@ msgstr "" "tüm istisnaların diğer yan tümcelere yayılmasına ve sonunda yeniden ortaya " "çıkmasına izin verirken, belirli bir türdeki grup istisnalarını çıkarır. ::" -#: tutorial/errors.rst:573 +#: tutorial/errors.rst:572 msgid "" "Note that the exceptions nested in an exception group must be instances, not " "types. This is because in practice the exceptions would typically be ones " @@ -663,11 +664,11 @@ msgstr "" "olarak, aşağıdaki kalıp boyunca program tarafından önceden oluşturulmuş ve " "yakalanmış olanlar olmasıdır::" -#: tutorial/errors.rst:593 +#: tutorial/errors.rst:592 msgid "Enriching Exceptions with Notes" msgstr "İstisnaları Notlarla Zenginleştirme" -#: tutorial/errors.rst:595 +#: tutorial/errors.rst:594 msgid "" "When an exception is created in order to be raised, it is usually " "initialized with information that describes the error that has occurred. " @@ -684,7 +685,7 @@ msgstr "" "``add_note(note)`` metodu vardır. Standart geri işleme (traceback) " "oluşturma, tüm notları istisnadan sonra eklendikleri sırayla içerir. ::" -#: tutorial/errors.rst:616 +#: tutorial/errors.rst:615 msgid "" "For example, when collecting exceptions into an exception group, we may want " "to add context information for the individual errors. In the following each " diff --git a/using/configure.po b/using/configure.po index 31aa1a9cc..0b42d140e 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-10-01 00:18+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -100,72 +100,85 @@ msgid "" "tools used to regenerate them. Search for ``regen-*`` make targets." msgstr "" -#: using/configure.rst:60 +#: using/configure.rst:61 +msgid "configure script" +msgstr "" + +#: using/configure.rst:63 msgid "" -"The ``make regen-configure`` command runs `tiran/cpython_autoconf `_ container for reproducible build; see " -"container ``entry.sh`` script. The container is optional, the following " -"command can be run locally, the generated files depend on autoconf and " -"aclocal versions::" +"The ``make regen-configure`` command regenerates the ``aclocal.m4`` file and " +"the ``configure`` script using the ``Tools/build/regen-configure.sh`` shell " +"script which uses an Ubuntu container to get the same tools versions and " +"have a reproducible output." +msgstr "" + +#: using/configure.rst:68 +msgid "The container is optional, the following command can be run locally::" msgstr "" #: using/configure.rst:72 +msgid "" +"The generated files can change depending on the exact ``autoconf-archive``, " +"``aclocal`` and ``pkg-config`` versions." +msgstr "" + +#: using/configure.rst:79 msgid "Configure Options" msgstr "" -#: using/configure.rst:74 +#: using/configure.rst:81 msgid "List all ``./configure`` script options using::" msgstr "" -#: using/configure.rst:78 +#: using/configure.rst:85 msgid "" "See also the :file:`Misc/SpecialBuilds.txt` in the Python source " "distribution." msgstr "" -#: using/configure.rst:81 +#: using/configure.rst:88 msgid "General Options" msgstr "" -#: using/configure.rst:85 +#: using/configure.rst:92 msgid "" "Support loadable extensions in the :mod:`!_sqlite` extension module (default " "is no) of the :mod:`sqlite3` module." msgstr "" -#: using/configure.rst:88 +#: using/configure.rst:95 msgid "" "See the :meth:`sqlite3.Connection.enable_load_extension` method of the :mod:" "`sqlite3` module." msgstr "" -#: using/configure.rst:95 +#: using/configure.rst:102 msgid "" "Disable IPv6 support (enabled by default if supported), see the :mod:" "`socket` module." msgstr "" -#: using/configure.rst:100 +#: using/configure.rst:107 msgid "Define the size in bits of Python :class:`int` digits: 15 or 30 bits." msgstr "" -#: using/configure.rst:102 +#: using/configure.rst:109 msgid "By default, the digit size is 30." msgstr "" -#: using/configure.rst:104 +#: using/configure.rst:111 msgid "Define the ``PYLONG_BITS_IN_DIGIT`` to ``15`` or ``30``." msgstr "" -#: using/configure.rst:106 +#: using/configure.rst:113 msgid "See :data:`sys.int_info.bits_per_digit `." msgstr "" -#: using/configure.rst:110 +#: using/configure.rst:117 msgid "Set the Python executable suffix to *SUFFIX*." msgstr "" -#: using/configure.rst:112 +#: using/configure.rst:119 msgid "" "The default suffix is ``.exe`` on Windows and macOS (``python.exe`` " "executable), ``.js`` on Emscripten node, ``.html`` on Emscripten browser, ``." @@ -173,95 +186,95 @@ msgid "" "executable)." msgstr "" -#: using/configure.rst:117 +#: using/configure.rst:124 msgid "" "The default suffix on WASM platform is one of ``.js``, ``.html`` or ``." "wasm``." msgstr "" -#: using/configure.rst:123 +#: using/configure.rst:130 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:127 +#: using/configure.rst:134 msgid "" "Default: ``/usr/share/zoneinfo:/usr/lib/zoneinfo:/usr/share/lib/zoneinfo:/" "etc/zoneinfo``." msgstr "" -#: using/configure.rst:129 +#: using/configure.rst:136 msgid "See :data:`os.pathsep` path separator." msgstr "" -#: using/configure.rst:135 +#: using/configure.rst:142 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:138 +#: using/configure.rst:145 msgid "See :const:`decimal.HAVE_CONTEXTVAR` and the :mod:`contextvars` module." msgstr "" -#: using/configure.rst:144 +#: using/configure.rst:151 msgid "Override order to check db backends for the :mod:`dbm` module" msgstr "" -#: using/configure.rst:146 +#: using/configure.rst:153 msgid "" "A valid value is a colon (``:``) separated string with the backend names:" msgstr "" -#: using/configure.rst:148 +#: using/configure.rst:155 msgid "``ndbm``;" msgstr "" -#: using/configure.rst:149 +#: using/configure.rst:156 msgid "``gdbm``;" msgstr "" -#: using/configure.rst:150 +#: using/configure.rst:157 msgid "``bdb``." msgstr "" -#: using/configure.rst:154 +#: using/configure.rst:161 msgid "Disable C locale coercion to a UTF-8 based locale (enabled by default)." msgstr "" -#: using/configure.rst:156 +#: using/configure.rst:163 msgid "Don't define the ``PY_COERCE_C_LOCALE`` macro." msgstr "" -#: using/configure.rst:158 +#: using/configure.rst:165 msgid "See :envvar:`PYTHONCOERCECLOCALE` and the :pep:`538`." msgstr "" -#: using/configure.rst:162 +#: using/configure.rst:169 msgid "Disable all freelists except the empty tuple singleton." msgstr "" -#: using/configure.rst:168 +#: using/configure.rst:175 msgid "Python library directory name (default is ``lib``)." msgstr "" -#: using/configure.rst:170 +#: using/configure.rst:177 msgid "Fedora and SuSE use ``lib64`` on 64-bit platforms." msgstr "" -#: using/configure.rst:172 +#: using/configure.rst:179 msgid "See :data:`sys.platlibdir`." msgstr "" -#: using/configure.rst:178 +#: using/configure.rst:185 msgid "" "Directory of wheel packages used by the :mod:`ensurepip` module (none by " "default)." msgstr "" -#: using/configure.rst:181 +#: using/configure.rst:188 msgid "" "Some Linux distribution packaging policies recommend against bundling " "dependencies. For example, Fedora installs wheel packages in the ``/usr/" @@ -269,201 +282,201 @@ msgid "" "_bundled` package." msgstr "" -#: using/configure.rst:190 +#: using/configure.rst:197 msgid "" "Whether configure should use :program:`pkg-config` to detect build " "dependencies." msgstr "" -#: using/configure.rst:193 +#: using/configure.rst:200 msgid "``check`` (default): :program:`pkg-config` is optional" msgstr "" -#: using/configure.rst:194 +#: using/configure.rst:201 msgid "``yes``: :program:`pkg-config` is mandatory" msgstr "" -#: using/configure.rst:195 +#: using/configure.rst:202 msgid "``no``: configure does not use :program:`pkg-config` even when present" msgstr "" -#: using/configure.rst:201 +#: using/configure.rst:208 msgid "Turn on internal statistics gathering." msgstr "" -#: using/configure.rst:203 +#: using/configure.rst:210 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:207 +#: using/configure.rst:214 msgid "Use ``Tools/scripts/summarize_stats.py`` to read the stats." msgstr "" -#: using/configure.rst:212 +#: using/configure.rst:219 msgid "WebAssembly Options" msgstr "" -#: using/configure.rst:216 +#: using/configure.rst:223 msgid "Set build flavor for ``wasm32-emscripten``." msgstr "" -#: using/configure.rst:218 +#: using/configure.rst:225 msgid "``browser`` (default): preload minimal stdlib, default MEMFS." msgstr "" -#: using/configure.rst:219 +#: using/configure.rst:226 msgid "``node``: NODERAWFS and pthread support." msgstr "" -#: using/configure.rst:225 +#: using/configure.rst:232 msgid "Turn on dynamic linking support for WASM." msgstr "" -#: using/configure.rst:227 +#: using/configure.rst:234 msgid "" "Dynamic linking enables ``dlopen``. File size of the executable increases " "due to limited dead code elimination and additional features." msgstr "" -#: using/configure.rst:234 +#: using/configure.rst:241 msgid "Turn on pthreads support for WASM." msgstr "" -#: using/configure.rst:240 +#: using/configure.rst:247 msgid "Install Options" msgstr "" -#: using/configure.rst:244 +#: using/configure.rst:251 msgid "" "Install architecture-independent files in PREFIX. On Unix, it defaults to :" "file:`/usr/local`." msgstr "" -#: using/configure.rst:247 +#: using/configure.rst:254 msgid "This value can be retrieved at runtime using :data:`sys.prefix`." msgstr "" -#: using/configure.rst:249 +#: using/configure.rst:256 msgid "" "As an example, one can use ``--prefix=\"$HOME/.local/\"`` to install a " "Python in its home directory." msgstr "" -#: using/configure.rst:254 +#: using/configure.rst:261 msgid "" "Install architecture-dependent files in EPREFIX, defaults to :option:`--" "prefix`." msgstr "" -#: using/configure.rst:256 +#: using/configure.rst:263 msgid "This value can be retrieved at runtime using :data:`sys.exec_prefix`." msgstr "" -#: using/configure.rst:260 +#: using/configure.rst:267 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:267 +#: using/configure.rst:274 msgid "Select the :mod:`ensurepip` command run on Python installation:" msgstr "" -#: using/configure.rst:269 +#: using/configure.rst:276 msgid "" "``upgrade`` (default): run ``python -m ensurepip --altinstall --upgrade`` " "command." msgstr "" -#: using/configure.rst:271 +#: using/configure.rst:278 msgid "``install``: run ``python -m ensurepip --altinstall`` command;" msgstr "" -#: using/configure.rst:272 +#: using/configure.rst:279 msgid "``no``: don't run ensurepip;" msgstr "" -#: using/configure.rst:278 +#: using/configure.rst:285 msgid "Performance options" msgstr "" -#: using/configure.rst:280 +#: using/configure.rst:287 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:286 +#: using/configure.rst:293 msgid "" "Enable Profile Guided Optimization (PGO) using :envvar:`PROFILE_TASK` " "(disabled by default)." msgstr "" -#: using/configure.rst:289 +#: using/configure.rst:296 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:292 +#: using/configure.rst:299 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:298 +#: using/configure.rst:305 msgid "Use ``-fno-semantic-interposition`` on GCC." msgstr "" -#: using/configure.rst:303 +#: using/configure.rst:310 msgid "" "Environment variable used in the Makefile: Python command line arguments for " "the PGO generation task." msgstr "" -#: using/configure.rst:306 +#: using/configure.rst:313 msgid "Default: ``-m test --pgo --timeout=$(TESTTIMEOUT)``." msgstr "" -#: using/configure.rst:312 +#: using/configure.rst:319 msgid "Enable Link Time Optimization (LTO) in any build (disabled by default)." msgstr "" -#: using/configure.rst:314 +#: using/configure.rst:321 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:319 +#: using/configure.rst:326 msgid "To use ThinLTO feature, use ``--with-lto=thin`` on Clang." msgstr "" -#: using/configure.rst:322 +#: using/configure.rst:329 msgid "" "Use ThinLTO as the default optimization policy on Clang if the compiler " "accepts the flag." msgstr "" -#: using/configure.rst:327 +#: using/configure.rst:334 msgid "" "Enable usage of the `BOLT post-link binary optimizer `_ (disabled by default)." msgstr "" -#: using/configure.rst:331 +#: using/configure.rst:338 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:335 +#: using/configure.rst:342 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 " @@ -474,7 +487,7 @@ msgid "" "encouraged." msgstr "" -#: using/configure.rst:343 +#: using/configure.rst:350 msgid "" "The :envvar:`!BOLT_INSTRUMENT_FLAGS` and :envvar:`!BOLT_APPLY_FLAGS` :" "program:`configure` variables can be defined to override the default set of " @@ -482,101 +495,101 @@ msgid "" "binaries, respectively." msgstr "" -#: using/configure.rst:352 +#: using/configure.rst:359 msgid "" "Enable computed gotos in evaluation loop (enabled by default on supported " "compilers)." msgstr "" -#: using/configure.rst:357 +#: using/configure.rst:364 msgid "" "Disable the specialized Python memory allocator :ref:`pymalloc ` " "(enabled by default)." msgstr "" -#: using/configure.rst:360 +#: using/configure.rst:367 msgid "See also :envvar:`PYTHONMALLOC` environment variable." msgstr "" -#: using/configure.rst:364 +#: using/configure.rst:371 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:367 +#: using/configure.rst:374 msgid "Don't define the ``WITH_DOC_STRINGS`` macro." msgstr "" -#: using/configure.rst:369 +#: using/configure.rst:376 msgid "See the ``PyDoc_STRVAR()`` macro." msgstr "" -#: using/configure.rst:373 +#: using/configure.rst:380 msgid "Enable C-level code profiling with ``gprof`` (disabled by default)." msgstr "" -#: using/configure.rst:377 +#: using/configure.rst:384 msgid "" "Add ``-fstrict-overflow`` to the C compiler flags (by default we add ``-fno-" "strict-overflow`` instead)." msgstr "" -#: using/configure.rst:384 +#: using/configure.rst:391 msgid "Python Debug Build" msgstr "" -#: using/configure.rst:386 +#: using/configure.rst:393 msgid "" "A debug build is Python built with the :option:`--with-pydebug` configure " "option." msgstr "" -#: using/configure.rst:389 +#: using/configure.rst:396 msgid "Effects of a debug build:" msgstr "" -#: using/configure.rst:391 +#: using/configure.rst:398 msgid "" "Display all warnings by default: the list of default warning filters is " "empty in the :mod:`warnings` module." msgstr "" -#: using/configure.rst:393 +#: using/configure.rst:400 msgid "Add ``d`` to :data:`sys.abiflags`." msgstr "" -#: using/configure.rst:394 +#: using/configure.rst:401 msgid "Add :func:`!sys.gettotalrefcount` function." msgstr "" -#: using/configure.rst:395 +#: using/configure.rst:402 msgid "Add :option:`-X showrefcount <-X>` command line option." msgstr "" -#: using/configure.rst:396 +#: using/configure.rst:403 msgid "" "Add :option:`-d` command line option and :envvar:`PYTHONDEBUG` environment " "variable to debug the parser." msgstr "" -#: using/configure.rst:398 +#: using/configure.rst:405 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:400 +#: using/configure.rst:407 msgid "" "Install :ref:`debug hooks on memory allocators ` " "to detect buffer overflow and other memory errors." msgstr "" -#: using/configure.rst:402 +#: using/configure.rst:409 msgid "Define ``Py_DEBUG`` and ``Py_REF_DEBUG`` macros." msgstr "" -#: using/configure.rst:403 +#: using/configure.rst:410 msgid "" "Add runtime checks: code surrounded by ``#ifdef Py_DEBUG`` and ``#endif``. " "Enable ``assert(...)`` and ``_PyObject_ASSERT(...)`` assertions: don't set " @@ -584,45 +597,45 @@ msgid "" "option). Main runtime checks:" msgstr "" -#: using/configure.rst:408 +#: using/configure.rst:415 msgid "Add sanity checks on the function arguments." msgstr "" -#: using/configure.rst:409 +#: using/configure.rst:416 msgid "" "Unicode and int objects are created with their memory filled with a pattern " "to detect usage of uninitialized objects." msgstr "" -#: using/configure.rst:411 +#: using/configure.rst:418 msgid "" "Ensure that functions which can clear or replace the current exception are " "not called with an exception raised." msgstr "" -#: using/configure.rst:413 +#: using/configure.rst:420 msgid "Check that deallocator functions don't change the current exception." msgstr "" -#: using/configure.rst:414 +#: using/configure.rst:421 msgid "" "The garbage collector (:func:`gc.collect` function) runs some basic checks " "on objects consistency." msgstr "" -#: using/configure.rst:416 +#: using/configure.rst:423 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:419 +#: using/configure.rst:426 msgid "" "See also the :ref:`Python Development Mode ` and the :option:`--" "with-trace-refs` configure option." msgstr "" -#: using/configure.rst:422 +#: using/configure.rst:429 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 :" @@ -630,320 +643,320 @@ msgid "" "incompatibility." msgstr "" -#: using/configure.rst:430 +#: using/configure.rst:437 msgid "Debug options" msgstr "" -#: using/configure.rst:434 +#: using/configure.rst:441 msgid "" ":ref:`Build Python in debug mode `: define the ``Py_DEBUG`` " "macro (disabled by default)." msgstr "" -#: using/configure.rst:439 +#: using/configure.rst:446 msgid "Enable tracing references for debugging purpose (disabled by default)." msgstr "" -#: using/configure.rst:441 +#: using/configure.rst:448 msgid "Effects:" msgstr "" -#: using/configure.rst:443 +#: using/configure.rst:450 msgid "Define the ``Py_TRACE_REFS`` macro." msgstr "" -#: using/configure.rst:444 +#: using/configure.rst:451 msgid "Add :func:`!sys.getobjects` function." msgstr "" -#: using/configure.rst:445 +#: using/configure.rst:452 msgid "Add :envvar:`PYTHONDUMPREFS` environment variable." msgstr "" -#: using/configure.rst:447 +#: using/configure.rst:454 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:454 +#: using/configure.rst:461 msgid "" "Build with C assertions enabled (default is no): ``assert(...);`` and " "``_PyObject_ASSERT(...);``." msgstr "" -#: using/configure.rst:457 +#: using/configure.rst:464 msgid "" "If set, the ``NDEBUG`` macro is not defined in the :envvar:`OPT` compiler " "variable." msgstr "" -#: using/configure.rst:460 +#: using/configure.rst:467 msgid "" "See also the :option:`--with-pydebug` option (:ref:`debug build `) which also enables assertions." msgstr "" -#: using/configure.rst:467 +#: using/configure.rst:474 msgid "Enable Valgrind support (default is no)." msgstr "" -#: using/configure.rst:471 +#: using/configure.rst:478 msgid "Enable DTrace support (default is no)." msgstr "" -#: using/configure.rst:473 +#: using/configure.rst:480 msgid "" "See :ref:`Instrumenting CPython with DTrace and SystemTap `." msgstr "" -#: using/configure.rst:480 +#: using/configure.rst:487 msgid "" "Enable AddressSanitizer memory error detector, ``asan`` (default is no)." msgstr "" -#: using/configure.rst:486 +#: using/configure.rst:493 msgid "" "Enable MemorySanitizer allocation error detector, ``msan`` (default is no)." msgstr "" -#: using/configure.rst:492 +#: using/configure.rst:499 msgid "" "Enable UndefinedBehaviorSanitizer undefined behaviour detector, ``ubsan`` " "(default is no)." msgstr "" -#: using/configure.rst:499 +#: using/configure.rst:506 msgid "Linker options" msgstr "" -#: using/configure.rst:503 +#: using/configure.rst:510 msgid "Enable building a shared Python library: ``libpython`` (default is no)." msgstr "" -#: using/configure.rst:507 +#: using/configure.rst:514 msgid "" "Do not build ``libpythonMAJOR.MINOR.a`` and do not install ``python.o`` " "(built and enabled by default)." msgstr "" -#: using/configure.rst:514 +#: using/configure.rst:521 msgid "Libraries options" msgstr "" -#: using/configure.rst:518 +#: using/configure.rst:525 msgid "Link against additional libraries (default is no)." msgstr "" -#: using/configure.rst:522 +#: using/configure.rst:529 msgid "" "Build the :mod:`!pyexpat` module using an installed ``expat`` library " "(default is no)." msgstr "" -#: using/configure.rst:527 +#: using/configure.rst:534 msgid "" "Build the ``_decimal`` extension module using an installed ``mpdec`` " "library, see the :mod:`decimal` module (default is no)." msgstr "" -#: using/configure.rst:534 +#: using/configure.rst:541 msgid "Use ``editline`` library for backend of the :mod:`readline` module." msgstr "" -#: using/configure.rst:536 +#: using/configure.rst:543 msgid "Define the ``WITH_EDITLINE`` macro." msgstr "" -#: using/configure.rst:542 +#: using/configure.rst:549 msgid "Don't build the :mod:`readline` module (built by default)." msgstr "" -#: using/configure.rst:544 +#: using/configure.rst:551 msgid "Don't define the ``HAVE_LIBREADLINE`` macro." msgstr "" -#: using/configure.rst:550 +#: using/configure.rst:557 msgid "" "Override ``libm`` math library to *STRING* (default is system-dependent)." msgstr "" -#: using/configure.rst:554 +#: using/configure.rst:561 msgid "Override ``libc`` C library to *STRING* (default is system-dependent)." msgstr "" -#: using/configure.rst:558 +#: using/configure.rst:565 msgid "Root of the OpenSSL directory." msgstr "" -#: using/configure.rst:564 +#: using/configure.rst:571 msgid "Set runtime library directory (rpath) for OpenSSL libraries:" msgstr "" -#: using/configure.rst:566 +#: using/configure.rst:573 msgid "``no`` (default): don't set rpath;" msgstr "" -#: using/configure.rst:567 +#: using/configure.rst:574 msgid "" "``auto``: auto-detect rpath from :option:`--with-openssl` and ``pkg-config``;" msgstr "" -#: using/configure.rst:569 +#: using/configure.rst:576 msgid "*DIR*: set an explicit rpath." msgstr "" -#: using/configure.rst:575 +#: using/configure.rst:582 msgid "Security Options" msgstr "" -#: using/configure.rst:579 +#: using/configure.rst:586 msgid "Select hash algorithm for use in ``Python/pyhash.c``:" msgstr "" -#: using/configure.rst:581 +#: using/configure.rst:588 msgid "``siphash13`` (default);" msgstr "" -#: using/configure.rst:582 +#: using/configure.rst:589 msgid "``siphash24``;" msgstr "" -#: using/configure.rst:583 +#: using/configure.rst:590 msgid "``fnv``." msgstr "" -#: using/configure.rst:587 +#: using/configure.rst:594 msgid "``siphash13`` is added and it is the new default." msgstr "" -#: using/configure.rst:592 +#: using/configure.rst:599 msgid "Built-in hash modules:" msgstr "" -#: using/configure.rst:594 +#: using/configure.rst:601 msgid "``md5``;" msgstr "" -#: using/configure.rst:595 +#: using/configure.rst:602 msgid "``sha1``;" msgstr "" -#: using/configure.rst:596 +#: using/configure.rst:603 msgid "``sha256``;" msgstr "" -#: using/configure.rst:597 +#: using/configure.rst:604 msgid "``sha512``;" msgstr "" -#: using/configure.rst:598 +#: using/configure.rst:605 msgid "``sha3`` (with shake);" msgstr "" -#: using/configure.rst:599 +#: using/configure.rst:606 msgid "``blake2``." msgstr "" -#: using/configure.rst:605 +#: using/configure.rst:612 msgid "Override the OpenSSL default cipher suites string:" msgstr "" -#: using/configure.rst:607 +#: using/configure.rst:614 msgid "``python`` (default): use Python's preferred selection;" msgstr "" -#: using/configure.rst:608 +#: using/configure.rst:615 msgid "``openssl``: leave OpenSSL's defaults untouched;" msgstr "" -#: using/configure.rst:609 +#: using/configure.rst:616 msgid "*STRING*: use a custom string" msgstr "" -#: using/configure.rst:611 +#: using/configure.rst:618 msgid "See the :mod:`ssl` module." msgstr "" -#: using/configure.rst:617 +#: using/configure.rst:624 msgid "" "The settings ``python`` and *STRING* also set TLS 1.2 as minimum protocol " "version." msgstr "" -#: using/configure.rst:621 +#: using/configure.rst:628 msgid "macOS Options" msgstr "" -#: using/configure.rst:623 +#: using/configure.rst:630 msgid "See ``Mac/README.rst``." msgstr "" -#: using/configure.rst:628 +#: using/configure.rst:635 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:634 +#: using/configure.rst:641 msgid "" "Create a Python.framework rather than a traditional Unix install. Optional " "*INSTALLDIR* specifies the installation path (default is no)." msgstr "" -#: using/configure.rst:639 +#: using/configure.rst:646 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:642 +#: using/configure.rst:649 msgid "Options:" msgstr "" -#: using/configure.rst:644 +#: using/configure.rst:651 msgid "``universal2``;" msgstr "" -#: using/configure.rst:645 +#: using/configure.rst:652 msgid "``32-bit``;" msgstr "" -#: using/configure.rst:646 +#: using/configure.rst:653 msgid "``64-bit``;" msgstr "" -#: using/configure.rst:647 +#: using/configure.rst:654 msgid "``3-way``;" msgstr "" -#: using/configure.rst:648 +#: using/configure.rst:655 msgid "``intel``;" msgstr "" -#: using/configure.rst:649 +#: using/configure.rst:656 msgid "``intel-32``;" msgstr "" -#: using/configure.rst:650 +#: using/configure.rst:657 msgid "``intel-64``;" msgstr "" -#: using/configure.rst:651 +#: using/configure.rst:658 msgid "``all``." msgstr "" -#: using/configure.rst:655 +#: using/configure.rst:662 msgid "" "Specify the name for the python framework on macOS only valid when :option:" "`--enable-framework` is set (default: ``Python``)." msgstr "" -#: using/configure.rst:660 +#: using/configure.rst:667 msgid "Cross Compiling Options" msgstr "" -#: using/configure.rst:662 +#: using/configure.rst:669 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 " @@ -951,95 +964,95 @@ msgid "" "match the version of the cross compiled host Python." msgstr "" -#: using/configure.rst:669 +#: using/configure.rst:676 msgid "" "configure for building on BUILD, usually guessed by :program:`config.guess`." msgstr "" -#: using/configure.rst:673 +#: using/configure.rst:680 msgid "cross-compile to build programs to run on HOST (target platform)" msgstr "" -#: using/configure.rst:677 +#: using/configure.rst:684 msgid "path to build ``python`` binary for cross compiling" msgstr "" -#: using/configure.rst:683 +#: using/configure.rst:690 msgid "An environment variable that points to a file with configure overrides." msgstr "" -#: using/configure.rst:685 +#: using/configure.rst:692 msgid "Example *config.site* file::" msgstr "" -#: using/configure.rst:693 +#: using/configure.rst:700 msgid "Cross compiling example::" msgstr "" -#: using/configure.rst:702 +#: using/configure.rst:709 msgid "Python Build System" msgstr "" -#: using/configure.rst:705 +#: using/configure.rst:712 msgid "Main files of the build system" msgstr "" -#: using/configure.rst:707 +#: using/configure.rst:714 msgid ":file:`configure.ac` => :file:`configure`;" msgstr "" -#: using/configure.rst:708 +#: using/configure.rst:715 msgid "" ":file:`Makefile.pre.in` => :file:`Makefile` (created by :file:`configure`);" msgstr "" -#: using/configure.rst:709 +#: using/configure.rst:716 msgid ":file:`pyconfig.h` (created by :file:`configure`);" msgstr "" -#: using/configure.rst:710 +#: using/configure.rst:717 msgid "" ":file:`Modules/Setup`: C extensions built by the Makefile using :file:" "`Module/makesetup` shell script;" msgstr "" -#: using/configure.rst:714 +#: using/configure.rst:721 msgid "Main build steps" msgstr "" -#: using/configure.rst:716 +#: using/configure.rst:723 msgid "C files (``.c``) are built as object files (``.o``)." msgstr "" -#: using/configure.rst:717 +#: using/configure.rst:724 msgid "A static ``libpython`` library (``.a``) is created from objects files." msgstr "" -#: using/configure.rst:718 +#: using/configure.rst:725 msgid "" "``python.o`` and the static ``libpython`` library are linked into the final " "``python`` program." msgstr "" -#: using/configure.rst:720 +#: using/configure.rst:727 msgid "C extensions are built by the Makefile (see :file:`Modules/Setup`)." msgstr "" -#: using/configure.rst:723 +#: using/configure.rst:730 msgid "Main Makefile targets" msgstr "" -#: using/configure.rst:725 +#: using/configure.rst:732 msgid "``make``: Build Python with the standard library." msgstr "" -#: using/configure.rst:726 +#: using/configure.rst:733 msgid "" "``make platform:``: build the ``python`` program, but don't build the " "standard library extension modules." msgstr "" -#: using/configure.rst:728 +#: using/configure.rst:735 msgid "" "``make profile-opt``: build Python using Profile Guided Optimization (PGO). " "You can use the configure :option:`--enable-optimizations` option to make " @@ -1047,53 +1060,53 @@ msgid "" "``make``)." msgstr "" -#: using/configure.rst:732 +#: using/configure.rst:739 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:735 +#: using/configure.rst:742 msgid "``make install``: Build and install Python." msgstr "" -#: using/configure.rst:736 +#: using/configure.rst:743 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:739 +#: using/configure.rst:746 msgid "``make clean``: Remove built files." msgstr "" -#: using/configure.rst:740 +#: using/configure.rst:747 msgid "" "``make distclean``: Same than ``make clean``, but remove also files created " "by the configure script." msgstr "" -#: using/configure.rst:744 +#: using/configure.rst:751 msgid "C extensions" msgstr "" -#: using/configure.rst:746 +#: using/configure.rst:753 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::" msgstr "" -#: using/configure.rst:758 +#: using/configure.rst:765 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::" msgstr "" -#: using/configure.rst:768 +#: using/configure.rst:775 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-" @@ -1101,303 +1114,303 @@ msgid "" "dynamic libraries." msgstr "" -#: using/configure.rst:772 +#: using/configure.rst:779 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:776 +#: using/configure.rst:783 msgid "Use ``Py_EXPORTED_SYMBOL`` if the ``Py_BUILD_CORE_MODULE`` is defined" msgstr "" -#: using/configure.rst:777 +#: using/configure.rst:784 msgid "Use ``Py_IMPORTED_SYMBOL`` otherwise." msgstr "" -#: using/configure.rst:779 +#: using/configure.rst:786 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:785 +#: using/configure.rst:792 msgid "Compiler and linker flags" msgstr "" -#: using/configure.rst:787 +#: using/configure.rst:794 msgid "" "Options set by the ``./configure`` script and environment variables and used " "by ``Makefile``." msgstr "" -#: using/configure.rst:791 +#: using/configure.rst:798 msgid "Preprocessor flags" msgstr "" -#: using/configure.rst:795 +#: using/configure.rst:802 msgid "" "Value of :envvar:`CPPFLAGS` variable passed to the ``./configure`` script." msgstr "" -#: using/configure.rst:801 +#: using/configure.rst:808 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:994 +#: using/configure.rst:1001 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:814 +#: using/configure.rst:821 msgid "" "Extra preprocessor flags added for building the interpreter object files." msgstr "" -#: using/configure.rst:816 +#: using/configure.rst:823 msgid "" "Default: ``$(BASECPPFLAGS) -I. -I$(srcdir)/Include $(CONFIGURE_CPPFLAGS) " "$(CPPFLAGS)``." msgstr "" -#: using/configure.rst:821 +#: using/configure.rst:828 msgid "Compiler flags" msgstr "" -#: using/configure.rst:825 +#: using/configure.rst:832 msgid "C compiler command." msgstr "" -#: using/configure.rst:827 +#: using/configure.rst:834 msgid "Example: ``gcc -pthread``." msgstr "" -#: using/configure.rst:831 +#: using/configure.rst:838 msgid "C++ compiler command." msgstr "" -#: using/configure.rst:833 +#: using/configure.rst:840 msgid "Example: ``g++ -pthread``." msgstr "" -#: using/configure.rst:837 +#: using/configure.rst:844 msgid "C compiler flags." msgstr "" -#: using/configure.rst:841 +#: using/configure.rst:848 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:845 +#: using/configure.rst:852 msgid "In particular, :envvar:`CFLAGS` should not contain:" msgstr "" -#: using/configure.rst:847 +#: using/configure.rst:854 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:852 +#: using/configure.rst:859 msgid "" "hardening flags such as ``-Werror`` because distributions cannot control " "whether packages installed by users conform to such heightened standards." msgstr "" -#: using/configure.rst:860 +#: using/configure.rst:867 msgid "" "Options passed to the :mod:`compileall` command line when building PYC files " "in ``make install``. Default: ``-j0``." msgstr "" -#: using/configure.rst:867 +#: using/configure.rst:874 msgid "Extra C compiler flags." msgstr "" -#: using/configure.rst:871 +#: using/configure.rst:878 msgid "" "Value of :envvar:`CFLAGS` variable passed to the ``./configure`` script." msgstr "" -#: using/configure.rst:878 +#: using/configure.rst:885 msgid "" "Value of :envvar:`CFLAGS_NODIST` variable passed to the ``./configure`` " "script." msgstr "" -#: using/configure.rst:885 +#: using/configure.rst:892 msgid "Base compiler flags." msgstr "" -#: using/configure.rst:889 +#: using/configure.rst:896 msgid "Optimization flags." msgstr "" -#: using/configure.rst:893 +#: using/configure.rst:900 msgid "Strict or non-strict aliasing flags used to compile ``Python/dtoa.c``." msgstr "" -#: using/configure.rst:899 +#: using/configure.rst:906 msgid "Compiler flags used to build a shared library." msgstr "" -#: using/configure.rst:901 +#: using/configure.rst:908 msgid "For example, ``-fPIC`` is used on Linux and on BSD." msgstr "" -#: using/configure.rst:905 +#: using/configure.rst:912 msgid "Extra C flags added for building the interpreter object files." msgstr "" -#: using/configure.rst:907 +#: using/configure.rst:914 msgid "" "Default: ``$(CCSHARED)`` when :option:`--enable-shared` is used, or an empty " "string otherwise." msgstr "" -#: using/configure.rst:912 +#: using/configure.rst:919 msgid "" "Default: ``$(BASECFLAGS) $(OPT) $(CONFIGURE_CFLAGS) $(CFLAGS) " "$(EXTRA_CFLAGS)``." msgstr "" -#: using/configure.rst:916 +#: using/configure.rst:923 msgid "" "Default: ``$(CONFIGURE_CFLAGS_NODIST) $(CFLAGS_NODIST) -I$(srcdir)/Include/" "internal``." msgstr "" -#: using/configure.rst:922 +#: using/configure.rst:929 msgid "C flags used for building the interpreter object files." msgstr "" -#: using/configure.rst:924 +#: using/configure.rst:931 msgid "" "Default: ``$(PY_CFLAGS) $(PY_CFLAGS_NODIST) $(PY_CPPFLAGS) " "$(CFLAGSFORSHARED)``." msgstr "" -#: using/configure.rst:930 +#: using/configure.rst:937 msgid "Default: ``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE``." msgstr "" -#: using/configure.rst:936 +#: using/configure.rst:943 msgid "" "Compiler flags to build a standard library extension module as a built-in " "module, like the :mod:`posix` module." msgstr "" -#: using/configure.rst:939 +#: using/configure.rst:946 msgid "Default: ``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE_BUILTIN``." msgstr "" -#: using/configure.rst:945 +#: using/configure.rst:952 msgid "Purify command. Purify is a memory debugger program." msgstr "" -#: using/configure.rst:947 +#: using/configure.rst:954 msgid "Default: empty string (not used)." msgstr "" -#: using/configure.rst:951 +#: using/configure.rst:958 msgid "Linker flags" msgstr "" -#: using/configure.rst:955 +#: using/configure.rst:962 msgid "" "Linker command used to build programs like ``python`` and ``_testembed``." msgstr "" -#: using/configure.rst:957 +#: using/configure.rst:964 msgid "Default: ``$(PURIFY) $(CC)``." msgstr "" -#: using/configure.rst:961 +#: using/configure.rst:968 msgid "" "Value of :envvar:`LDFLAGS` variable passed to the ``./configure`` script." msgstr "" -#: using/configure.rst:963 +#: using/configure.rst:970 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:971 +#: using/configure.rst:978 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:975 +#: using/configure.rst:982 msgid "In particular, :envvar:`LDFLAGS` should not contain:" msgstr "" -#: using/configure.rst:977 +#: using/configure.rst:984 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:984 +#: using/configure.rst:991 msgid "" "Value of :envvar:`LDFLAGS_NODIST` variable passed to the ``./configure`` " "script." msgstr "" -#: using/configure.rst:991 +#: using/configure.rst:998 msgid "" "Linker flags, e.g. :samp:`-L{lib_dir}` if you have libraries in a " "nonstandard directory *lib_dir*." msgstr "" -#: using/configure.rst:1000 +#: using/configure.rst:1007 msgid "" "Linker flags to pass libraries to the linker when linking the Python " "executable." msgstr "" -#: using/configure.rst:1003 +#: using/configure.rst:1010 msgid "Example: ``-lrt``." msgstr "" -#: using/configure.rst:1007 +#: using/configure.rst:1014 msgid "Command to build a shared library." msgstr "" -#: using/configure.rst:1009 +#: using/configure.rst:1016 msgid "Default: ``@LDSHARED@ $(PY_LDFLAGS)``." msgstr "" -#: using/configure.rst:1013 +#: using/configure.rst:1020 msgid "Command to build ``libpython`` shared library." msgstr "" -#: using/configure.rst:1015 +#: using/configure.rst:1022 msgid "Default: ``@BLDSHARED@ $(PY_CORE_LDFLAGS)``." msgstr "" -#: using/configure.rst:1019 +#: using/configure.rst:1026 msgid "Default: ``$(CONFIGURE_LDFLAGS) $(LDFLAGS)``." msgstr "" -#: using/configure.rst:1023 +#: using/configure.rst:1030 msgid "Default: ``$(CONFIGURE_LDFLAGS_NODIST) $(LDFLAGS_NODIST)``." msgstr "" -#: using/configure.rst:1029 +#: using/configure.rst:1036 msgid "Linker flags used for building the interpreter object files." msgstr "" diff --git a/whatsnew/2.0.po b/whatsnew/2.0.po index 461ee7f91..1521de928 100644 --- a/whatsnew/2.0.po +++ b/whatsnew/2.0.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-10-01 00:18+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -829,16 +829,17 @@ msgstr "" #: whatsnew/2.0.rst:673 msgid "" "Some of the functions in the :mod:`socket` module are still forgiving in " -"this way. For example, :func:`socket.connect( ('hostname', 25) )` is the " -"correct form, passing a tuple representing an IP address, but :func:`socket." -"connect( 'hostname', 25 )` also works. :func:`socket.connect_ex` and :func:" -"`socket.bind` are similarly easy-going. 2.0alpha1 tightened these functions " -"up, but because the documentation actually used the erroneous multiple " -"argument form, many people wrote code which would break with the stricter " -"checking. GvR backed out the changes in the face of public reaction, so for " -"the :mod:`socket` module, the documentation was fixed and the multiple " -"argument form is simply marked as deprecated; it *will* be tightened up " -"again in a future Python version." +"this way. For example, ``socket.connect( ('hostname', 25) )`` is the " +"correct form, passing a tuple representing an IP address, but ``socket." +"connect('hostname', 25)`` also works. :meth:`socket.connect_ex ` and :meth:`socket.bind ` are " +"similarly easy-going. 2.0alpha1 tightened these functions up, but because " +"the documentation actually used the erroneous multiple argument form, many " +"people wrote code which would break with the stricter checking. GvR backed " +"out the changes in the face of public reaction, so for the :mod:`socket` " +"module, the documentation was fixed and the multiple argument form is simply " +"marked as deprecated; it *will* be tightened up again in a future Python " +"version." msgstr "" #: whatsnew/2.0.rst:684 diff --git a/whatsnew/2.7.po b/whatsnew/2.7.po index 3865f57f6..8f99c7472 100644 --- a/whatsnew/2.7.po +++ b/whatsnew/2.7.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -2795,10 +2795,10 @@ msgstr "" #: whatsnew/2.7.rst:2386 msgid "" -"FreeBSD 7.1's :const:`SO_SETFIB` constant, used with :func:`~socket." -"getsockopt`/:func:`~socket.setsockopt` to select an alternate routing table, " -"is now available in the :mod:`socket` module. (Added by Kyle VanderBeek; :" -"issue:`8235`.)" +"FreeBSD 7.1's :const:`SO_SETFIB` constant, used with the :func:`~socket." +"socket` methods :func:`~socket.socket.getsockopt`/:func:`~socket.socket." +"setsockopt` to select an alternate routing table, is now available in the :" +"mod:`socket` module. (Added by Kyle VanderBeek; :issue:`8235`.)" msgstr "" #: whatsnew/2.7.rst:2392 diff --git a/whatsnew/3.12.po b/whatsnew/3.12.po index ad7c07718..fdc40d6f5 100644 --- a/whatsnew/3.12.po +++ b/whatsnew/3.12.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.12\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-11-04 18:33+0000\n" +"POT-Creation-Date: 2023-12-01 00:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: \n" "Language-Team: TURKISH \n" @@ -255,7 +255,7 @@ msgid "" "`_." msgstr "" -#: whatsnew/3.12.rst:1931 +#: whatsnew/3.12.rst:1943 msgid "New Features" msgstr "" @@ -1118,7 +1118,7 @@ msgid "" "Windows. (Contributed by Charles Machalow in :gh:`103179`.)" msgstr "" -#: whatsnew/3.12.rst:1651 +#: whatsnew/3.12.rst:1655 msgid "sqlite3" msgstr "" @@ -1191,7 +1191,7 @@ msgid "" "Katriel in :gh:`102778`.)" msgstr "" -#: whatsnew/3.12.rst:1839 +#: whatsnew/3.12.rst:1851 msgid "" ":func:`sys._current_exceptions` now returns a mapping from thread-id to an " "exception instance, rather than to a ``(typ, exc, tb)`` tuple. (Contributed " @@ -1336,7 +1336,7 @@ msgid "" "Benjamin Peterson in :gh:`96734`)." msgstr "" -#: whatsnew/3.12.rst:1692 +#: whatsnew/3.12.rst:1696 msgid "unittest" msgstr "" @@ -1512,7 +1512,7 @@ msgid "" "demos>`_. (Contributed by Victor Stinner in :gh:`97669`.)" msgstr "" -#: whatsnew/3.12.rst:2233 +#: whatsnew/3.12.rst:2245 msgid "Deprecated" msgstr "" @@ -1531,23 +1531,23 @@ msgid "" "Python 3.14:" msgstr "" -#: whatsnew/3.12.rst:1386 +#: whatsnew/3.12.rst:1387 msgid ":class:`!ast.Num`" msgstr "" -#: whatsnew/3.12.rst:1387 +#: whatsnew/3.12.rst:1388 msgid ":class:`!ast.Str`" msgstr "" -#: whatsnew/3.12.rst:1388 +#: whatsnew/3.12.rst:1389 msgid ":class:`!ast.Bytes`" msgstr "" -#: whatsnew/3.12.rst:1389 +#: whatsnew/3.12.rst:1390 msgid ":class:`!ast.NameConstant`" msgstr "" -#: whatsnew/3.12.rst:1390 +#: whatsnew/3.12.rst:1391 msgid ":class:`!ast.Ellipsis`" msgstr "" @@ -1557,7 +1557,7 @@ msgid "" "`90953`.)" msgstr "" -#: whatsnew/3.12.rst:1392 +#: whatsnew/3.12.rst:1393 msgid ":mod:`asyncio`:" msgstr "" @@ -1622,15 +1622,15 @@ msgid "" "removal in Python 3.14:" msgstr "" -#: whatsnew/3.12.rst:1409 +#: whatsnew/3.12.rst:1410 msgid ":class:`!importlib.abc.ResourceReader`" msgstr "" -#: whatsnew/3.12.rst:1410 +#: whatsnew/3.12.rst:1411 msgid ":class:`!importlib.abc.Traversable`" msgstr "" -#: whatsnew/3.12.rst:1411 +#: whatsnew/3.12.rst:1412 msgid ":class:`!importlib.abc.TraversableResources`" msgstr "" @@ -1767,18 +1767,19 @@ msgstr "" #: whatsnew/3.12.rst:1292 msgid "" -":class:`typing.Hashable` and :class:`typing.Sized` aliases for :class:" -"`collections.abc.Hashable` and :class:`collections.abc.Sized`. (:gh:`94309`.)" +":class:`typing.Hashable` and :class:`typing.Sized`, aliases for :class:" +"`collections.abc.Hashable` and :class:`collections.abc.Sized` respectively, " +"are deprecated. (:gh:`94309`.)" msgstr "" -#: whatsnew/3.12.rst:1295 +#: whatsnew/3.12.rst:1296 msgid "" ":class:`typing.ByteString`, deprecated since Python 3.9, now causes a :exc:" "`DeprecationWarning` to be emitted when it is used. (Contributed by Alex " "Waygood in :gh:`91896`.)" msgstr "" -#: whatsnew/3.12.rst:1299 +#: whatsnew/3.12.rst:1300 msgid "" ":mod:`xml.etree.ElementTree`: The module now emits :exc:`DeprecationWarning` " "when testing the truth value of an :class:`xml.etree.ElementTree.Element`. " @@ -1786,7 +1787,7 @@ msgid "" "implementation emitted nothing. (Contributed by Jacob Walls in :gh:`83122`.)" msgstr "" -#: whatsnew/3.12.rst:1305 +#: whatsnew/3.12.rst:1306 msgid "" "The 3-arg signatures (type, value, traceback) of :meth:`coroutine throw() " "`, :meth:`generator throw() ` and :meth:" @@ -1795,21 +1796,21 @@ msgid "" "instead. (Contributed by Ofey Chan in :gh:`89874`.)" msgstr "" -#: whatsnew/3.12.rst:1311 +#: whatsnew/3.12.rst:1312 msgid "" ":exc:`DeprecationWarning` is now raised when ``__package__`` on a module " "differs from ``__spec__.parent`` (previously it was :exc:`ImportWarning`). " "(Contributed by Brett Cannon in :gh:`65961`.)" msgstr "" -#: whatsnew/3.12.rst:1316 +#: whatsnew/3.12.rst:1317 msgid "" "Setting ``__package__`` or ``__cached__`` on a module is deprecated, and " "will cease to be set or taken into consideration by the import system in " "Python 3.14. (Contributed by Brett Cannon in :gh:`65961`.)" msgstr "" -#: whatsnew/3.12.rst:1320 +#: whatsnew/3.12.rst:1321 msgid "" "The bitwise inversion operator (``~``) on bool is deprecated. It will throw " "an error in Python 3.14. Use ``not`` for logical negation of bools instead. " @@ -1818,7 +1819,7 @@ msgid "" "Tim Hoffmann in :gh:`103487`.)" msgstr "" -#: whatsnew/3.12.rst:1326 +#: whatsnew/3.12.rst:1327 msgid "" "Accessing ``co_lnotab`` on code objects was deprecated in Python 3.10 via :" "pep:`626`, but it only got a proper :exc:`DeprecationWarning` in 3.12, " @@ -1826,289 +1827,289 @@ msgid "" "`101866`.)" msgstr "" -#: whatsnew/3.12.rst:1332 +#: whatsnew/3.12.rst:1333 msgid "Pending Removal in Python 3.13" msgstr "" -#: whatsnew/3.12.rst:1334 +#: whatsnew/3.12.rst:1335 msgid "" "The following modules and APIs have been deprecated in earlier Python " "releases, and will be removed in Python 3.13." msgstr "" -#: whatsnew/3.12.rst:1337 +#: whatsnew/3.12.rst:1338 msgid "Modules (see :pep:`594`):" msgstr "" -#: whatsnew/3.12.rst:1339 +#: whatsnew/3.12.rst:1340 msgid ":mod:`aifc`" msgstr "" -#: whatsnew/3.12.rst:1340 +#: whatsnew/3.12.rst:1341 msgid ":mod:`audioop`" msgstr "" -#: whatsnew/3.12.rst:1341 +#: whatsnew/3.12.rst:1342 msgid ":mod:`cgi`" msgstr "" -#: whatsnew/3.12.rst:1342 +#: whatsnew/3.12.rst:1343 msgid ":mod:`cgitb`" msgstr "" -#: whatsnew/3.12.rst:1343 +#: whatsnew/3.12.rst:1344 msgid ":mod:`chunk`" msgstr "" -#: whatsnew/3.12.rst:1344 +#: whatsnew/3.12.rst:1345 msgid ":mod:`crypt`" msgstr "" -#: whatsnew/3.12.rst:1345 +#: whatsnew/3.12.rst:1346 msgid ":mod:`imghdr`" msgstr "" -#: whatsnew/3.12.rst:1346 +#: whatsnew/3.12.rst:1347 msgid ":mod:`mailcap`" msgstr "" -#: whatsnew/3.12.rst:1347 +#: whatsnew/3.12.rst:1348 msgid ":mod:`msilib`" msgstr "" -#: whatsnew/3.12.rst:1348 +#: whatsnew/3.12.rst:1349 msgid ":mod:`nis`" msgstr "" -#: whatsnew/3.12.rst:1349 +#: whatsnew/3.12.rst:1350 msgid ":mod:`nntplib`" msgstr "" -#: whatsnew/3.12.rst:1350 +#: whatsnew/3.12.rst:1351 msgid ":mod:`ossaudiodev`" msgstr "" -#: whatsnew/3.12.rst:1351 +#: whatsnew/3.12.rst:1352 msgid ":mod:`pipes`" msgstr "" -#: whatsnew/3.12.rst:1352 +#: whatsnew/3.12.rst:1353 msgid ":mod:`sndhdr`" msgstr "" -#: whatsnew/3.12.rst:1353 +#: whatsnew/3.12.rst:1354 msgid ":mod:`spwd`" msgstr "" -#: whatsnew/3.12.rst:1354 +#: whatsnew/3.12.rst:1355 msgid ":mod:`sunau`" msgstr "" -#: whatsnew/3.12.rst:1355 +#: whatsnew/3.12.rst:1356 msgid ":mod:`telnetlib`" msgstr "" -#: whatsnew/3.12.rst:1356 +#: whatsnew/3.12.rst:1357 msgid ":mod:`uu`" msgstr "" -#: whatsnew/3.12.rst:1357 +#: whatsnew/3.12.rst:1358 msgid ":mod:`xdrlib`" msgstr "" -#: whatsnew/3.12.rst:1359 +#: whatsnew/3.12.rst:1360 msgid "Other modules:" msgstr "" -#: whatsnew/3.12.rst:1361 +#: whatsnew/3.12.rst:1362 msgid ":mod:`!lib2to3`, and the :program:`2to3` program (:gh:`84540`)" msgstr "" -#: whatsnew/3.12.rst:1441 +#: whatsnew/3.12.rst:1442 msgid "APIs:" msgstr "" -#: whatsnew/3.12.rst:1365 +#: whatsnew/3.12.rst:1366 msgid ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" msgstr "" -#: whatsnew/3.12.rst:1366 +#: whatsnew/3.12.rst:1367 msgid "``locale.resetlocale()`` (:gh:`90817`)" msgstr "" -#: whatsnew/3.12.rst:1367 +#: whatsnew/3.12.rst:1368 msgid ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" msgstr "" -#: whatsnew/3.12.rst:1368 +#: whatsnew/3.12.rst:1369 msgid ":func:`!unittest.findTestCases` (:gh:`50096`)" msgstr "" -#: whatsnew/3.12.rst:1369 +#: whatsnew/3.12.rst:1370 msgid ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" msgstr "" -#: whatsnew/3.12.rst:1370 +#: whatsnew/3.12.rst:1371 msgid ":func:`!unittest.makeSuite` (:gh:`50096`)" msgstr "" -#: whatsnew/3.12.rst:1371 +#: whatsnew/3.12.rst:1372 msgid ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" msgstr "" -#: whatsnew/3.12.rst:1372 +#: whatsnew/3.12.rst:1373 msgid ":class:`!webbrowser.MacOSX` (:gh:`86421`)" msgstr "" -#: whatsnew/3.12.rst:1373 +#: whatsnew/3.12.rst:1374 msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" msgstr "" -#: whatsnew/3.12.rst:2320 +#: whatsnew/3.12.rst:2332 msgid "Pending Removal in Python 3.14" msgstr "" -#: whatsnew/3.12.rst:1378 +#: whatsnew/3.12.rst:1379 msgid "" "The following APIs have been deprecated and will be removed in Python 3.14." msgstr "" -#: whatsnew/3.12.rst:1381 +#: whatsnew/3.12.rst:1382 msgid "" ":mod:`argparse`: The *type*, *choices*, and *metavar* parameters of :class:`!" "argparse.BooleanOptionalAction`" msgstr "" -#: whatsnew/3.12.rst:1384 +#: whatsnew/3.12.rst:1385 msgid ":mod:`ast`:" msgstr "" -#: whatsnew/3.12.rst:1394 +#: whatsnew/3.12.rst:1395 msgid ":class:`!asyncio.MultiLoopChildWatcher`" msgstr "" -#: whatsnew/3.12.rst:1395 +#: whatsnew/3.12.rst:1396 msgid ":class:`!asyncio.FastChildWatcher`" msgstr "" -#: whatsnew/3.12.rst:1396 +#: whatsnew/3.12.rst:1397 msgid ":class:`!asyncio.AbstractChildWatcher`" msgstr "" -#: whatsnew/3.12.rst:1397 +#: whatsnew/3.12.rst:1398 msgid ":class:`!asyncio.SafeChildWatcher`" msgstr "" -#: whatsnew/3.12.rst:1398 +#: whatsnew/3.12.rst:1399 msgid ":func:`!asyncio.set_child_watcher`" msgstr "" -#: whatsnew/3.12.rst:1399 +#: whatsnew/3.12.rst:1400 msgid ":func:`!asyncio.get_child_watcher`," msgstr "" -#: whatsnew/3.12.rst:1400 +#: whatsnew/3.12.rst:1401 msgid ":meth:`!asyncio.AbstractEventLoopPolicy.set_child_watcher`" msgstr "" -#: whatsnew/3.12.rst:1401 +#: whatsnew/3.12.rst:1402 msgid ":meth:`!asyncio.AbstractEventLoopPolicy.get_child_watcher`" msgstr "" -#: whatsnew/3.12.rst:1403 +#: whatsnew/3.12.rst:1404 msgid ":mod:`collections.abc`: :class:`!collections.abc.ByteString`." msgstr "" -#: whatsnew/3.12.rst:1405 +#: whatsnew/3.12.rst:1406 msgid ":mod:`email`: the *isdst* parameter in :func:`email.utils.localtime`." msgstr "" -#: whatsnew/3.12.rst:1407 +#: whatsnew/3.12.rst:1408 msgid ":mod:`importlib.abc`:" msgstr "" -#: whatsnew/3.12.rst:1413 +#: whatsnew/3.12.rst:1414 msgid ":mod:`itertools`: Support for copy, deepcopy, and pickle operations." msgstr "" -#: whatsnew/3.12.rst:1415 +#: whatsnew/3.12.rst:1416 msgid ":mod:`pkgutil`:" msgstr "" -#: whatsnew/3.12.rst:1417 +#: whatsnew/3.12.rst:1418 msgid ":func:`!pkgutil.find_loader`" msgstr "" -#: whatsnew/3.12.rst:1418 +#: whatsnew/3.12.rst:1419 msgid ":func:`!pkgutil.get_loader`." msgstr "" -#: whatsnew/3.12.rst:1420 +#: whatsnew/3.12.rst:1421 msgid ":mod:`pty`:" msgstr "" -#: whatsnew/3.12.rst:1422 +#: whatsnew/3.12.rst:1423 msgid ":func:`!pty.master_open`" msgstr "" -#: whatsnew/3.12.rst:1423 +#: whatsnew/3.12.rst:1424 msgid ":func:`!pty.slave_open`" msgstr "" -#: whatsnew/3.12.rst:1425 +#: whatsnew/3.12.rst:1426 msgid ":mod:`shutil`: The *onerror* argument of :func:`shutil.rmtree`" msgstr "" -#: whatsnew/3.12.rst:1427 +#: whatsnew/3.12.rst:1428 msgid ":mod:`typing`: :class:`!typing.ByteString`" msgstr "" -#: whatsnew/3.12.rst:1429 +#: whatsnew/3.12.rst:1430 msgid "" ":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`xml." "etree.ElementTree.Element`." msgstr "" -#: whatsnew/3.12.rst:1431 +#: whatsnew/3.12.rst:1432 msgid "The ``__package__`` and ``__cached__`` attributes on module objects." msgstr "" -#: whatsnew/3.12.rst:1433 +#: whatsnew/3.12.rst:1434 msgid "The ``co_lnotab`` attribute of code objects." msgstr "" -#: whatsnew/3.12.rst:2357 +#: whatsnew/3.12.rst:2369 msgid "Pending Removal in Python 3.15" msgstr "" -#: whatsnew/3.12.rst:1438 +#: whatsnew/3.12.rst:1439 msgid "" "The following APIs have been deprecated and will be removed in Python 3.15." msgstr "" -#: whatsnew/3.12.rst:1443 +#: whatsnew/3.12.rst:1444 msgid ":func:`locale.getdefaultlocale` (:gh:`90817`)" msgstr "" -#: whatsnew/3.12.rst:2375 +#: whatsnew/3.12.rst:2387 msgid "Pending Removal in Future Versions" msgstr "" -#: whatsnew/3.12.rst:1449 +#: whatsnew/3.12.rst:1450 msgid "" "The following APIs were deprecated in earlier Python versions and will be " "removed, although there is currently no date scheduled for their removal." msgstr "" -#: whatsnew/3.12.rst:1452 +#: whatsnew/3.12.rst:1453 msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" msgstr "" -#: whatsnew/3.12.rst:1454 +#: whatsnew/3.12.rst:1455 msgid ":class:`typing.Text` (:gh:`92332`)" msgstr "" -#: whatsnew/3.12.rst:1456 +#: whatsnew/3.12.rst:1457 msgid "" "Currently Python accepts numeric literals immediately followed by keywords, " "for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " @@ -2120,54 +2121,54 @@ msgid "" "syntax error. (:gh:`87999`)" msgstr "" -#: whatsnew/3.12.rst:2407 +#: whatsnew/3.12.rst:2419 msgid "Removed" msgstr "" -#: whatsnew/3.12.rst:1470 +#: whatsnew/3.12.rst:1471 msgid "asynchat and asyncore" msgstr "" -#: whatsnew/3.12.rst:1472 +#: whatsnew/3.12.rst:1473 msgid "" "These two modules have been removed according to the schedule in :pep:`594`, " "having been deprecated in Python 3.6. Use :mod:`asyncio` instead. " "(Contributed by Nikita Sobolev in :gh:`96580`.)" msgstr "" -#: whatsnew/3.12.rst:1479 +#: whatsnew/3.12.rst:1480 msgid "configparser" msgstr "" -#: whatsnew/3.12.rst:1481 +#: whatsnew/3.12.rst:1482 msgid "" "Several names deprecated in the :mod:`configparser` way back in 3.2 have " "been removed per :gh:`89336`:" msgstr "" -#: whatsnew/3.12.rst:1484 +#: whatsnew/3.12.rst:1485 msgid "" ":class:`configparser.ParsingError` no longer has a ``filename`` attribute or " "argument. Use the ``source`` attribute and argument instead." msgstr "" -#: whatsnew/3.12.rst:1486 +#: whatsnew/3.12.rst:1487 msgid "" ":mod:`configparser` no longer has a ``SafeConfigParser`` class. Use the " "shorter :class:`~configparser.ConfigParser` name instead." msgstr "" -#: whatsnew/3.12.rst:1488 +#: whatsnew/3.12.rst:1489 msgid "" ":class:`configparser.ConfigParser` no longer has a ``readfp`` method. Use :" "meth:`~configparser.ConfigParser.read_file` instead." msgstr "" -#: whatsnew/3.12.rst:1492 +#: whatsnew/3.12.rst:1493 msgid "distutils" msgstr "" -#: whatsnew/3.12.rst:1494 +#: whatsnew/3.12.rst:1495 msgid "" "Remove the :py:mod:`!distutils` package. It was deprecated in Python 3.10 " "by :pep:`632` \"Deprecate distutils module\". For projects still using " @@ -2176,17 +2177,17 @@ msgid "" "Victor Stinner in :gh:`92584`.)" msgstr "" -#: whatsnew/3.12.rst:1501 +#: whatsnew/3.12.rst:1502 msgid "ensurepip" msgstr "" -#: whatsnew/3.12.rst:1503 +#: whatsnew/3.12.rst:1504 msgid "" "Remove the bundled setuptools wheel from :mod:`ensurepip`, and stop " "installing setuptools in environments created by :mod:`venv`." msgstr "" -#: whatsnew/3.12.rst:1506 +#: whatsnew/3.12.rst:1507 msgid "" "``pip (>= 22.1)`` does not require setuptools to be installed in the " "environment. ``setuptools``-based (and ``distutils``-based) packages can " @@ -2194,7 +2195,7 @@ msgid "" "the build environment it uses for building a package." msgstr "" -#: whatsnew/3.12.rst:1512 +#: whatsnew/3.12.rst:1513 msgid "" "``easy_install``, ``pkg_resources``, ``setuptools`` and ``distutils`` are no " "longer provided by default in environments created with ``venv`` or " @@ -2204,35 +2205,35 @@ msgid "" "(typically, using pip)." msgstr "" -#: whatsnew/3.12.rst:1519 +#: whatsnew/3.12.rst:1520 msgid "(Contributed by Pradyun Gedam in :gh:`95299`.)" msgstr "" -#: whatsnew/3.12.rst:1522 +#: whatsnew/3.12.rst:1523 msgid "enum" msgstr "" -#: whatsnew/3.12.rst:1524 +#: whatsnew/3.12.rst:1525 msgid "" "Remove :mod:`enum`'s ``EnumMeta.__getattr__``, which is no longer needed for " "enum attribute access. (Contributed by Ethan Furman in :gh:`95083`.)" msgstr "" -#: whatsnew/3.12.rst:1529 +#: whatsnew/3.12.rst:1530 msgid "ftplib" msgstr "" -#: whatsnew/3.12.rst:1531 +#: whatsnew/3.12.rst:1532 msgid "" "Remove :mod:`ftplib`'s ``FTP_TLS.ssl_version`` class attribute: use the " "*context* parameter instead. (Contributed by Victor Stinner in :gh:`94172`.)" msgstr "" -#: whatsnew/3.12.rst:1536 +#: whatsnew/3.12.rst:1537 msgid "gzip" msgstr "" -#: whatsnew/3.12.rst:1538 +#: whatsnew/3.12.rst:1539 msgid "" "Remove the ``filename`` attribute of :mod:`gzip`'s :class:`gzip.GzipFile`, " "deprecated since Python 2.6, use the :attr:`~gzip.GzipFile.name` attribute " @@ -2241,11 +2242,11 @@ msgid "" "`94196`.)" msgstr "" -#: whatsnew/3.12.rst:1545 +#: whatsnew/3.12.rst:1546 msgid "hashlib" msgstr "" -#: whatsnew/3.12.rst:1547 +#: whatsnew/3.12.rst:1548 msgid "" "Remove the pure Python implementation of :mod:`hashlib`'s :func:`hashlib." "pbkdf2_hmac()`, deprecated in Python 3.10. Python 3.10 and newer requires " @@ -2254,191 +2255,191 @@ msgid "" "Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1581 +#: whatsnew/3.12.rst:1582 msgid "importlib" msgstr "" -#: whatsnew/3.12.rst:1556 +#: whatsnew/3.12.rst:1557 msgid "" "Many previously deprecated cleanups in :mod:`importlib` have now been " "completed:" msgstr "" -#: whatsnew/3.12.rst:1559 +#: whatsnew/3.12.rst:1560 msgid "" "References to, and support for :meth:`!module_repr()` has been removed. " "(Contributed by Barry Warsaw in :gh:`97850`.)" msgstr "" -#: whatsnew/3.12.rst:1562 +#: whatsnew/3.12.rst:1563 msgid "" "``importlib.util.set_package``, ``importlib.util.set_loader`` and " "``importlib.util.module_for_loader`` have all been removed. (Contributed by " "Brett Cannon and Nikita Sobolev in :gh:`65961` and :gh:`97850`.)" msgstr "" -#: whatsnew/3.12.rst:1566 +#: whatsnew/3.12.rst:1567 msgid "" "Support for ``find_loader()`` and ``find_module()`` APIs have been removed. " "(Contributed by Barry Warsaw in :gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1569 +#: whatsnew/3.12.rst:1570 msgid "" "``importlib.abc.Finder``, ``pkgutil.ImpImporter``, and ``pkgutil.ImpLoader`` " "have been removed. (Contributed by Barry Warsaw in :gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1581 +#: whatsnew/3.12.rst:1582 msgid "imp" msgstr "" -#: whatsnew/3.12.rst:1575 +#: whatsnew/3.12.rst:1576 msgid "" "The :mod:`!imp` module has been removed. (Contributed by Barry Warsaw in :" "gh:`98040`.)" msgstr "" -#: whatsnew/3.12.rst:1578 +#: whatsnew/3.12.rst:1579 msgid "To migrate, consult the following correspondence table:" msgstr "" -#: whatsnew/3.12.rst:1583 +#: whatsnew/3.12.rst:1584 msgid "``imp.NullImporter``" msgstr "" -#: whatsnew/3.12.rst:1583 +#: whatsnew/3.12.rst:1584 msgid "Insert ``None`` into ``sys.path_importer_cache``" msgstr "" -#: whatsnew/3.12.rst:1584 +#: whatsnew/3.12.rst:1585 msgid "``imp.cache_from_source()``" msgstr "" -#: whatsnew/3.12.rst:1584 +#: whatsnew/3.12.rst:1585 msgid ":func:`importlib.util.cache_from_source`" msgstr "" -#: whatsnew/3.12.rst:1585 +#: whatsnew/3.12.rst:1586 msgid "``imp.find_module()``" msgstr "" -#: whatsnew/3.12.rst:1585 +#: whatsnew/3.12.rst:1586 msgid ":func:`importlib.util.find_spec`" msgstr "" -#: whatsnew/3.12.rst:1586 +#: whatsnew/3.12.rst:1587 msgid "``imp.get_magic()``" msgstr "" -#: whatsnew/3.12.rst:1586 +#: whatsnew/3.12.rst:1587 msgid ":attr:`importlib.util.MAGIC_NUMBER`" msgstr "" -#: whatsnew/3.12.rst:1587 +#: whatsnew/3.12.rst:1588 msgid "``imp.get_suffixes()``" msgstr "" -#: whatsnew/3.12.rst:1587 +#: whatsnew/3.12.rst:1588 msgid "" ":attr:`importlib.machinery.SOURCE_SUFFIXES`, :attr:`importlib.machinery." "EXTENSION_SUFFIXES`, and :attr:`importlib.machinery.BYTECODE_SUFFIXES`" msgstr "" -#: whatsnew/3.12.rst:1588 +#: whatsnew/3.12.rst:1589 msgid "``imp.get_tag()``" msgstr "" -#: whatsnew/3.12.rst:1588 +#: whatsnew/3.12.rst:1589 msgid ":attr:`sys.implementation.cache_tag `" msgstr "" -#: whatsnew/3.12.rst:1589 +#: whatsnew/3.12.rst:1590 msgid "``imp.load_module()``" msgstr "" -#: whatsnew/3.12.rst:1589 +#: whatsnew/3.12.rst:1590 msgid ":func:`importlib.import_module`" msgstr "" -#: whatsnew/3.12.rst:1590 +#: whatsnew/3.12.rst:1591 msgid "``imp.new_module(name)``" msgstr "" -#: whatsnew/3.12.rst:1590 +#: whatsnew/3.12.rst:1591 msgid "``types.ModuleType(name)``" msgstr "" -#: whatsnew/3.12.rst:1591 +#: whatsnew/3.12.rst:1592 msgid "``imp.reload()``" msgstr "" -#: whatsnew/3.12.rst:1591 +#: whatsnew/3.12.rst:1592 msgid ":func:`importlib.reload`" msgstr "" -#: whatsnew/3.12.rst:1592 +#: whatsnew/3.12.rst:1593 msgid "``imp.source_from_cache()``" msgstr "" -#: whatsnew/3.12.rst:1592 +#: whatsnew/3.12.rst:1593 msgid ":func:`importlib.util.source_from_cache`" msgstr "" -#: whatsnew/3.12.rst:1593 +#: whatsnew/3.12.rst:1594 msgid "``imp.load_source()``" msgstr "" -#: whatsnew/3.12.rst:1593 +#: whatsnew/3.12.rst:1594 msgid "*See below*" msgstr "" -#: whatsnew/3.12.rst:1596 +#: whatsnew/3.12.rst:1597 msgid "Replace ``imp.load_source()`` with::" msgstr "" -#: whatsnew/3.12.rst:1611 +#: whatsnew/3.12.rst:1612 msgid "Remove :mod:`!imp` functions and attributes with no replacements:" msgstr "" -#: whatsnew/3.12.rst:1613 +#: whatsnew/3.12.rst:1614 msgid "Undocumented functions:" msgstr "" -#: whatsnew/3.12.rst:1615 +#: whatsnew/3.12.rst:1616 msgid "``imp.init_builtin()``" msgstr "" -#: whatsnew/3.12.rst:1616 +#: whatsnew/3.12.rst:1617 msgid "``imp.load_compiled()``" msgstr "" -#: whatsnew/3.12.rst:1617 +#: whatsnew/3.12.rst:1618 msgid "``imp.load_dynamic()``" msgstr "" -#: whatsnew/3.12.rst:1618 +#: whatsnew/3.12.rst:1619 msgid "``imp.load_package()``" msgstr "" -#: whatsnew/3.12.rst:1620 +#: whatsnew/3.12.rst:1621 msgid "" "``imp.lock_held()``, ``imp.acquire_lock()``, ``imp.release_lock()``: the " "locking scheme has changed in Python 3.3 to per-module locks." msgstr "" -#: whatsnew/3.12.rst:1622 +#: whatsnew/3.12.rst:1623 msgid "" "``imp.find_module()`` constants: ``SEARCH_ERROR``, ``PY_SOURCE``, " "``PY_COMPILED``, ``C_EXTENSION``, ``PY_RESOURCE``, ``PKG_DIRECTORY``, " "``C_BUILTIN``, ``PY_FROZEN``, ``PY_CODERESOURCE``, ``IMP_HOOK``." msgstr "" -#: whatsnew/3.12.rst:1627 +#: whatsnew/3.12.rst:1628 msgid "io" msgstr "" -#: whatsnew/3.12.rst:1629 +#: whatsnew/3.12.rst:1630 msgid "" "Remove :mod:`io`'s ``io.OpenWrapper`` and ``_pyio.OpenWrapper``, deprecated " "in Python 3.10: just use :func:`open` instead. The :func:`open` (:func:`io." @@ -2447,46 +2448,50 @@ msgid "" "`94169`.)" msgstr "" -#: whatsnew/3.12.rst:1636 +#: whatsnew/3.12.rst:1637 msgid "locale" msgstr "" -#: whatsnew/3.12.rst:1638 +#: whatsnew/3.12.rst:1639 msgid "" "Remove :mod:`locale`'s :func:`!locale.format` function, deprecated in Python " "3.7: use :func:`locale.format_string` instead. (Contributed by Victor " "Stinner in :gh:`94226`.)" msgstr "" -#: whatsnew/3.12.rst:1642 +#: whatsnew/3.12.rst:1644 +msgid "smtpd" +msgstr "" + +#: whatsnew/3.12.rst:1646 msgid "" -"``smtpd``: The module has been removed according to the schedule in :pep:" +"The ``smtpd`` module has been removed according to the schedule in :pep:" "`594`, having been deprecated in Python 3.4.7 and 3.5.4. Use aiosmtpd_ PyPI " "module or any other :mod:`asyncio`-based server instead. (Contributed by " "Oleg Iarygin in :gh:`93243`.)" msgstr "" -#: whatsnew/3.12.rst:1653 +#: whatsnew/3.12.rst:1657 msgid "" "The following undocumented :mod:`sqlite3` features, deprecated in Python " "3.10, are now removed:" msgstr "" -#: whatsnew/3.12.rst:1656 +#: whatsnew/3.12.rst:1660 msgid "``sqlite3.enable_shared_cache()``" msgstr "" -#: whatsnew/3.12.rst:1657 +#: whatsnew/3.12.rst:1661 msgid "``sqlite3.OptimizedUnicode``" msgstr "" -#: whatsnew/3.12.rst:1659 +#: whatsnew/3.12.rst:1663 msgid "" "If a shared cache must be used, open the database in URI mode using the " "``cache=shared`` query parameter." msgstr "" -#: whatsnew/3.12.rst:1662 +#: whatsnew/3.12.rst:1666 msgid "" "The ``sqlite3.OptimizedUnicode`` text factory has been an alias for :class:" "`str` since Python 3.3. Code that previously set the text factory to " @@ -2494,22 +2499,22 @@ msgid "" "default value which is also ``str``." msgstr "" -#: whatsnew/3.12.rst:1667 +#: whatsnew/3.12.rst:1671 msgid "(Contributed by Erlend E. Aasland in :gh:`92548`.)" msgstr "" -#: whatsnew/3.12.rst:1670 +#: whatsnew/3.12.rst:1674 msgid "ssl" msgstr "" -#: whatsnew/3.12.rst:1672 +#: whatsnew/3.12.rst:1676 msgid "" "Remove :mod:`ssl`'s :func:`!ssl.RAND_pseudo_bytes` function, deprecated in " "Python 3.6: use :func:`os.urandom` or :func:`ssl.RAND_bytes` instead. " "(Contributed by Victor Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1676 +#: whatsnew/3.12.rst:1680 msgid "" "Remove the :func:`!ssl.match_hostname` function. It was deprecated in Python " "3.7. OpenSSL performs hostname matching since Python 3.7, Python no longer " @@ -2517,7 +2522,7 @@ msgid "" "Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1682 +#: whatsnew/3.12.rst:1686 msgid "" "Remove the :func:`!ssl.wrap_socket` function, deprecated in Python 3.7: " "instead, create a :class:`ssl.SSLContext` object and call its :class:`ssl." @@ -2528,185 +2533,185 @@ msgid "" "Validation. (Contributed by Victor Stinner in :gh:`94199`.)" msgstr "" -#: whatsnew/3.12.rst:1694 +#: whatsnew/3.12.rst:1698 msgid "Remove many long-deprecated :mod:`unittest` features:" msgstr "" -#: whatsnew/3.12.rst:1698 +#: whatsnew/3.12.rst:1702 msgid "A number of :class:`~unittest.TestCase` method aliases:" msgstr "" -#: whatsnew/3.12.rst:1701 +#: whatsnew/3.12.rst:1705 msgid "Deprecated alias" msgstr "" -#: whatsnew/3.12.rst:1701 +#: whatsnew/3.12.rst:1705 msgid "Method Name" msgstr "" -#: whatsnew/3.12.rst:1701 +#: whatsnew/3.12.rst:1705 msgid "Deprecated in" msgstr "" -#: whatsnew/3.12.rst:1703 +#: whatsnew/3.12.rst:1707 msgid "``failUnless``" msgstr "" -#: whatsnew/3.12.rst:1710 +#: whatsnew/3.12.rst:1714 msgid ":meth:`.assertTrue`" msgstr "" -#: whatsnew/3.12.rst:1704 whatsnew/3.12.rst:1706 whatsnew/3.12.rst:1708 -#: whatsnew/3.12.rst:1709 +#: whatsnew/3.12.rst:1708 whatsnew/3.12.rst:1710 whatsnew/3.12.rst:1712 +#: whatsnew/3.12.rst:1713 msgid "3.1" msgstr "" -#: whatsnew/3.12.rst:1704 +#: whatsnew/3.12.rst:1708 msgid "``failIf``" msgstr "" -#: whatsnew/3.12.rst:1704 +#: whatsnew/3.12.rst:1708 msgid ":meth:`.assertFalse`" msgstr "" -#: whatsnew/3.12.rst:1705 +#: whatsnew/3.12.rst:1709 msgid "``failUnlessEqual``" msgstr "" -#: whatsnew/3.12.rst:1711 +#: whatsnew/3.12.rst:1715 msgid ":meth:`.assertEqual`" msgstr "" -#: whatsnew/3.12.rst:1706 +#: whatsnew/3.12.rst:1710 msgid "``failIfEqual``" msgstr "" -#: whatsnew/3.12.rst:1712 +#: whatsnew/3.12.rst:1716 msgid ":meth:`.assertNotEqual`" msgstr "" -#: whatsnew/3.12.rst:1707 +#: whatsnew/3.12.rst:1711 msgid "``failUnlessAlmostEqual``" msgstr "" -#: whatsnew/3.12.rst:1713 +#: whatsnew/3.12.rst:1717 msgid ":meth:`.assertAlmostEqual`" msgstr "" -#: whatsnew/3.12.rst:1708 +#: whatsnew/3.12.rst:1712 msgid "``failIfAlmostEqual``" msgstr "" -#: whatsnew/3.12.rst:1714 +#: whatsnew/3.12.rst:1718 msgid ":meth:`.assertNotAlmostEqual`" msgstr "" -#: whatsnew/3.12.rst:1709 +#: whatsnew/3.12.rst:1713 msgid "``failUnlessRaises``" msgstr "" -#: whatsnew/3.12.rst:1709 +#: whatsnew/3.12.rst:1713 msgid ":meth:`.assertRaises`" msgstr "" -#: whatsnew/3.12.rst:1710 +#: whatsnew/3.12.rst:1714 msgid "``assert_``" msgstr "" -#: whatsnew/3.12.rst:1711 whatsnew/3.12.rst:1713 whatsnew/3.12.rst:1715 -#: whatsnew/3.12.rst:1716 +#: whatsnew/3.12.rst:1715 whatsnew/3.12.rst:1717 whatsnew/3.12.rst:1719 +#: whatsnew/3.12.rst:1720 msgid "3.2" msgstr "" -#: whatsnew/3.12.rst:1711 +#: whatsnew/3.12.rst:1715 msgid "``assertEquals``" msgstr "" -#: whatsnew/3.12.rst:1712 +#: whatsnew/3.12.rst:1716 msgid "``assertNotEquals``" msgstr "" -#: whatsnew/3.12.rst:1713 +#: whatsnew/3.12.rst:1717 msgid "``assertAlmostEquals``" msgstr "" -#: whatsnew/3.12.rst:1714 +#: whatsnew/3.12.rst:1718 msgid "``assertNotAlmostEquals``" msgstr "" -#: whatsnew/3.12.rst:1715 +#: whatsnew/3.12.rst:1719 msgid "``assertRegexpMatches``" msgstr "" -#: whatsnew/3.12.rst:1715 +#: whatsnew/3.12.rst:1719 msgid ":meth:`.assertRegex`" msgstr "" -#: whatsnew/3.12.rst:1716 +#: whatsnew/3.12.rst:1720 msgid "``assertRaisesRegexp``" msgstr "" -#: whatsnew/3.12.rst:1716 +#: whatsnew/3.12.rst:1720 msgid ":meth:`.assertRaisesRegex`" msgstr "" -#: whatsnew/3.12.rst:1717 +#: whatsnew/3.12.rst:1721 msgid "``assertNotRegexpMatches``" msgstr "" -#: whatsnew/3.12.rst:1717 +#: whatsnew/3.12.rst:1721 msgid ":meth:`.assertNotRegex`" msgstr "" -#: whatsnew/3.12.rst:1717 +#: whatsnew/3.12.rst:1721 msgid "3.5" msgstr "" -#: whatsnew/3.12.rst:1720 +#: whatsnew/3.12.rst:1724 msgid "" "You can use https://github.com/isidentical/teyit to automatically modernise " "your unit tests." msgstr "" -#: whatsnew/3.12.rst:1723 +#: whatsnew/3.12.rst:1727 msgid "" "Undocumented and broken :class:`~unittest.TestCase` method " "``assertDictContainsSubset`` (deprecated in Python 3.2)." msgstr "" -#: whatsnew/3.12.rst:1726 +#: whatsnew/3.12.rst:1730 msgid "" "Undocumented :meth:`TestLoader.loadTestsFromModule ` parameter *use_load_tests* (deprecated and ignored " "since Python 3.2)." msgstr "" -#: whatsnew/3.12.rst:1730 +#: whatsnew/3.12.rst:1734 msgid "" "An alias of the :class:`~unittest.TextTestResult` class: ``_TextTestResult`` " "(deprecated in Python 3.2)." msgstr "" -#: whatsnew/3.12.rst:1733 +#: whatsnew/3.12.rst:1737 msgid "(Contributed by Serhiy Storchaka in :gh:`89325`.)" msgstr "" -#: whatsnew/3.12.rst:1736 +#: whatsnew/3.12.rst:1740 msgid "webbrowser" msgstr "" -#: whatsnew/3.12.rst:1738 +#: whatsnew/3.12.rst:1742 msgid "" "Remove support for obsolete browsers from :mod:`webbrowser`. The removed " "browsers include: Grail, Mosaic, Netscape, Galeon, Skipstone, Iceape, " "Firebird, and Firefox versions 35 and below (:gh:`102871`)." msgstr "" -#: whatsnew/3.12.rst:1743 +#: whatsnew/3.12.rst:1747 msgid "xml.etree.ElementTree" msgstr "" -#: whatsnew/3.12.rst:1745 +#: whatsnew/3.12.rst:1749 msgid "" "Remove the ``ElementTree.Element.copy()`` method of the pure Python " "implementation, deprecated in Python 3.10, use the :func:`copy.copy` " @@ -2715,22 +2720,22 @@ msgid "" "Stinner in :gh:`94383`.)" msgstr "" -#: whatsnew/3.12.rst:1752 +#: whatsnew/3.12.rst:1756 msgid "zipimport" msgstr "" -#: whatsnew/3.12.rst:1754 +#: whatsnew/3.12.rst:1758 msgid "" "Remove :mod:`zipimport`'s ``find_loader()`` and ``find_module()`` methods, " "deprecated in Python 3.10: use the ``find_spec()`` method instead. See :pep:" "`451` for the rationale. (Contributed by Victor Stinner in :gh:`94379`.)" msgstr "" -#: whatsnew/3.12.rst:1760 +#: whatsnew/3.12.rst:1764 msgid "Others" msgstr "" -#: whatsnew/3.12.rst:1762 +#: whatsnew/3.12.rst:1766 msgid "" "Remove the ``suspicious`` rule from the documentation :file:`Makefile` and :" "file:`Doc/tools/rstlint.py`, both in favor of `sphinx-lint `, " "intended for low-level tools like debuggers and JIT compilers. This API may " @@ -2975,84 +2992,84 @@ msgid "" "contents are marked by the ``PyUnstable_`` prefix in names." msgstr "" -#: whatsnew/3.12.rst:1941 +#: whatsnew/3.12.rst:1953 msgid "Code object constructors:" msgstr "" -#: whatsnew/3.12.rst:1943 +#: whatsnew/3.12.rst:1955 msgid "``PyUnstable_Code_New()`` (renamed from ``PyCode_New``)" msgstr "" -#: whatsnew/3.12.rst:1944 +#: whatsnew/3.12.rst:1956 msgid "" "``PyUnstable_Code_NewWithPosOnlyArgs()`` (renamed from " "``PyCode_NewWithPosOnlyArgs``)" msgstr "" -#: whatsnew/3.12.rst:1946 +#: whatsnew/3.12.rst:1958 msgid "Extra storage for code objects (:pep:`523`):" msgstr "" -#: whatsnew/3.12.rst:1948 +#: whatsnew/3.12.rst:1960 msgid "" "``PyUnstable_Eval_RequestCodeExtraIndex()`` (renamed from " "``_PyEval_RequestCodeExtraIndex``)" msgstr "" -#: whatsnew/3.12.rst:1949 +#: whatsnew/3.12.rst:1961 msgid "``PyUnstable_Code_GetExtra()`` (renamed from ``_PyCode_GetExtra``)" msgstr "" -#: whatsnew/3.12.rst:1950 +#: whatsnew/3.12.rst:1962 msgid "``PyUnstable_Code_SetExtra()`` (renamed from ``_PyCode_SetExtra``)" msgstr "" -#: whatsnew/3.12.rst:1952 +#: whatsnew/3.12.rst:1964 msgid "" "The original names will continue to be available until the respective API " "changes." msgstr "" -#: whatsnew/3.12.rst:1955 +#: whatsnew/3.12.rst:1967 msgid "(Contributed by Petr Viktorin in :gh:`101101`.)" msgstr "" -#: whatsnew/3.12.rst:1957 +#: whatsnew/3.12.rst:1969 msgid "" ":pep:`697`: Add an API for extending types whose instance memory layout is " "opaque:" msgstr "" -#: whatsnew/3.12.rst:1960 +#: whatsnew/3.12.rst:1972 msgid "" ":c:member:`PyType_Spec.basicsize` can be zero or negative to specify " "inheriting or extending the base class size." msgstr "" -#: whatsnew/3.12.rst:1962 +#: whatsnew/3.12.rst:1974 msgid "" ":c:func:`PyObject_GetTypeData` and :c:func:`PyType_GetTypeDataSize` added to " "allow access to subclass-specific instance data." msgstr "" -#: whatsnew/3.12.rst:1964 +#: whatsnew/3.12.rst:1976 msgid "" ":c:macro:`Py_TPFLAGS_ITEMS_AT_END` and :c:func:`PyObject_GetItemData` added " "to allow safely extending certain variable-sized types, including :c:var:" "`PyType_Type`." msgstr "" -#: whatsnew/3.12.rst:1967 +#: whatsnew/3.12.rst:1979 msgid "" ":c:macro:`Py_RELATIVE_OFFSET` added to allow defining :c:type:`members " "` in terms of a subclass-specific struct." msgstr "" -#: whatsnew/3.12.rst:1970 +#: whatsnew/3.12.rst:1982 msgid "(Contributed by Petr Viktorin in :gh:`103509`.)" msgstr "" -#: whatsnew/3.12.rst:1972 +#: whatsnew/3.12.rst:1984 msgid "" "Add the new :ref:`limited C API ` function :c:func:" "`PyType_FromMetaclass`, which generalizes the existing :c:func:" @@ -3060,29 +3077,29 @@ msgid "" "(Contributed by Wenzel Jakob in :gh:`93012`.)" msgstr "" -#: whatsnew/3.12.rst:1977 +#: whatsnew/3.12.rst:1989 msgid "" "API for creating objects that can be called using :ref:`the vectorcall " "protocol ` was added to the :ref:`Limited API `:" msgstr "" -#: whatsnew/3.12.rst:1981 +#: whatsnew/3.12.rst:1993 msgid ":c:macro:`Py_TPFLAGS_HAVE_VECTORCALL`" msgstr "" -#: whatsnew/3.12.rst:1982 +#: whatsnew/3.12.rst:1994 msgid ":c:func:`PyVectorcall_NARGS`" msgstr "" -#: whatsnew/3.12.rst:1983 +#: whatsnew/3.12.rst:1995 msgid ":c:func:`PyVectorcall_Call`" msgstr "" -#: whatsnew/3.12.rst:1984 +#: whatsnew/3.12.rst:1996 msgid ":c:type:`vectorcallfunc`" msgstr "" -#: whatsnew/3.12.rst:1986 +#: whatsnew/3.12.rst:1998 msgid "" "The :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag is now removed from a class " "when the class's :py:meth:`~object.__call__` method is reassigned. This " @@ -3093,7 +3110,7 @@ msgid "" "`93274`.)" msgstr "" -#: whatsnew/3.12.rst:1994 +#: whatsnew/3.12.rst:2006 msgid "" "The :c:macro:`Py_TPFLAGS_MANAGED_DICT` and :c:macro:" "`Py_TPFLAGS_MANAGED_WEAKREF` flags have been added. This allows extensions " @@ -3101,32 +3118,32 @@ msgid "" "using less memory and with faster access." msgstr "" -#: whatsnew/3.12.rst:1999 +#: whatsnew/3.12.rst:2011 msgid "" "API for performing calls using :ref:`the vectorcall protocol ` " "was added to the :ref:`Limited API `:" msgstr "" -#: whatsnew/3.12.rst:2003 +#: whatsnew/3.12.rst:2015 msgid ":c:func:`PyObject_Vectorcall`" msgstr "" -#: whatsnew/3.12.rst:2004 +#: whatsnew/3.12.rst:2016 msgid ":c:func:`PyObject_VectorcallMethod`" msgstr "" -#: whatsnew/3.12.rst:2005 +#: whatsnew/3.12.rst:2017 msgid ":c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET`" msgstr "" -#: whatsnew/3.12.rst:2007 +#: whatsnew/3.12.rst:2019 msgid "" "This means that both the incoming and outgoing ends of the vector call " "protocol are now available in the :ref:`Limited API `. (Contributed " "by Wenzel Jakob in :gh:`98586`.)" msgstr "" -#: whatsnew/3.12.rst:2011 +#: whatsnew/3.12.rst:2023 msgid "" "Add two new public functions, :c:func:`PyEval_SetProfileAllThreads` and :c:" "func:`PyEval_SetTraceAllThreads`, that allow to set tracing and profiling " @@ -3134,14 +3151,14 @@ msgid "" "(Contributed by Pablo Galindo in :gh:`93503`.)" msgstr "" -#: whatsnew/3.12.rst:2017 +#: whatsnew/3.12.rst:2029 msgid "" "Add new function :c:func:`PyFunction_SetVectorcall` to the C API which sets " "the vectorcall field of a given :c:type:`PyFunctionObject`. (Contributed by " "Andrew Frost in :gh:`92257`.)" msgstr "" -#: whatsnew/3.12.rst:2021 +#: whatsnew/3.12.rst:2033 msgid "" "The C API now permits registering callbacks via :c:func:" "`PyDict_AddWatcher`, :c:func:`PyDict_Watch` and related APIs to be called " @@ -3150,28 +3167,28 @@ msgid "" "`91052`.)" msgstr "" -#: whatsnew/3.12.rst:2027 +#: whatsnew/3.12.rst:2039 msgid "" "Add :c:func:`PyType_AddWatcher` and :c:func:`PyType_Watch` API to register " "callbacks to receive notification on changes to a type. (Contributed by Carl " "Meyer in :gh:`91051`.)" msgstr "" -#: whatsnew/3.12.rst:2031 +#: whatsnew/3.12.rst:2043 msgid "" "Add :c:func:`PyCode_AddWatcher` and :c:func:`PyCode_ClearWatcher` APIs to " "register callbacks to receive notification on creation and destruction of " "code objects. (Contributed by Itamar Oren in :gh:`91054`.)" msgstr "" -#: whatsnew/3.12.rst:2036 +#: whatsnew/3.12.rst:2048 msgid "" "Add :c:func:`PyFrame_GetVar` and :c:func:`PyFrame_GetVarString` functions to " "get a frame variable by its name. (Contributed by Victor Stinner in :gh:" "`91248`.)" msgstr "" -#: whatsnew/3.12.rst:2040 +#: whatsnew/3.12.rst:2052 msgid "" "Add :c:func:`PyErr_GetRaisedException` and :c:func:" "`PyErr_SetRaisedException` for saving and restoring the current exception. " @@ -3181,14 +3198,14 @@ msgid "" "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2048 +#: whatsnew/3.12.rst:2060 msgid "" "Add ``_PyErr_ChainExceptions1``, which takes an exception instance, to " "replace the legacy-API ``_PyErr_ChainExceptions``, which is now deprecated. " "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2052 +#: whatsnew/3.12.rst:2064 msgid "" "Add :c:func:`PyException_GetArgs` and :c:func:`PyException_SetArgs` as " "convenience functions for retrieving and modifying the :attr:`~BaseException." @@ -3196,71 +3213,71 @@ msgid "" "in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2057 +#: whatsnew/3.12.rst:2069 msgid "" "Add :c:func:`PyErr_DisplayException`, which takes an exception instance, to " "replace the legacy-api :c:func:`!PyErr_Display`. (Contributed by Irit " "Katriel in :gh:`102755`)." msgstr "" -#: whatsnew/3.12.rst:2063 +#: whatsnew/3.12.rst:2075 msgid "" ":pep:`683`: Introduce *Immortal Objects*, which allows objects to bypass " "reference counts, and related changes to the C-API:" msgstr "" -#: whatsnew/3.12.rst:2066 +#: whatsnew/3.12.rst:2078 msgid "``_Py_IMMORTAL_REFCNT``: The reference count that defines an object" msgstr "" -#: whatsnew/3.12.rst:2067 +#: whatsnew/3.12.rst:2079 msgid "as immortal." msgstr "" -#: whatsnew/3.12.rst:2068 +#: whatsnew/3.12.rst:2080 msgid "" "``_Py_IsImmortal`` Checks if an object has the immortal reference count." msgstr "" -#: whatsnew/3.12.rst:2069 +#: whatsnew/3.12.rst:2081 msgid "``PyObject_HEAD_INIT`` This will now initialize reference count to" msgstr "" -#: whatsnew/3.12.rst:2070 +#: whatsnew/3.12.rst:2082 msgid "``_Py_IMMORTAL_REFCNT`` when used with ``Py_BUILD_CORE``." msgstr "" -#: whatsnew/3.12.rst:2071 +#: whatsnew/3.12.rst:2083 msgid "``SSTATE_INTERNED_IMMORTAL`` An identifier for interned unicode objects" msgstr "" -#: whatsnew/3.12.rst:2072 +#: whatsnew/3.12.rst:2084 msgid "that are immortal." msgstr "" -#: whatsnew/3.12.rst:2073 +#: whatsnew/3.12.rst:2085 msgid "``SSTATE_INTERNED_IMMORTAL_STATIC`` An identifier for interned unicode" msgstr "" -#: whatsnew/3.12.rst:2074 +#: whatsnew/3.12.rst:2086 msgid "objects that are immortal and static" msgstr "" -#: whatsnew/3.12.rst:2077 +#: whatsnew/3.12.rst:2089 msgid "``sys.getunicodeinternedsize`` This returns the total number of unicode" msgstr "" -#: whatsnew/3.12.rst:2076 +#: whatsnew/3.12.rst:2088 msgid "" "objects that have been interned. This is now needed for :file:`refleak.py` " "to correctly track reference counts and allocated blocks" msgstr "" -#: whatsnew/3.12.rst:2079 +#: whatsnew/3.12.rst:2091 msgid "(Contributed by Eddie Elizondo in :gh:`84436`.)" msgstr "" -#: whatsnew/3.12.rst:2081 +#: whatsnew/3.12.rst:2093 msgid "" ":pep:`684`: Add the new :c:func:`Py_NewInterpreterFromConfig` function and :" "c:type:`PyInterpreterConfig`, which may be used to create sub-interpreters " @@ -3268,27 +3285,27 @@ msgid "" "(Contributed by Eric Snow in :gh:`104110`.)" msgstr "" -#: whatsnew/3.12.rst:2087 +#: whatsnew/3.12.rst:2099 msgid "" "In the limited C API version 3.12, :c:func:`Py_INCREF` and :c:func:" "`Py_DECREF` functions are now implemented as opaque function calls to hide " "implementation details. (Contributed by Victor Stinner in :gh:`105387`.)" msgstr "" -#: whatsnew/3.12.rst:2095 +#: whatsnew/3.12.rst:2107 msgid "" "Legacy Unicode APIs based on ``Py_UNICODE*`` representation has been " "removed. Please migrate to APIs based on UTF-8 or ``wchar_t*``." msgstr "" -#: whatsnew/3.12.rst:2098 +#: whatsnew/3.12.rst:2110 msgid "" "Argument parsing functions like :c:func:`PyArg_ParseTuple` doesn't support " "``Py_UNICODE*`` based format (e.g. ``u``, ``Z``) anymore. Please migrate to " "other formats for Unicode like ``s``, ``z``, ``es``, and ``U``." msgstr "" -#: whatsnew/3.12.rst:2102 +#: whatsnew/3.12.rst:2114 msgid "" "``tp_weaklist`` for all static builtin types is always ``NULL``. This is an " "internal-only field on ``PyTypeObject`` but we're pointing out the change in " @@ -3297,7 +3314,7 @@ msgid "" "necessary, the (internal-only) ``_PyObject_GET_WEAKREFS_LISTPTR()`` macro." msgstr "" -#: whatsnew/3.12.rst:2109 +#: whatsnew/3.12.rst:2121 msgid "" "This internal-only :c:member:`PyTypeObject.tp_subclasses` may now not be a " "valid object pointer. Its type was changed to :c:expr:`void *` to reflect " @@ -3305,13 +3322,13 @@ msgid "" "only field directly." msgstr "" -#: whatsnew/3.12.rst:2114 +#: whatsnew/3.12.rst:2126 msgid "" "To get a list of subclasses, call the Python method :py:meth:`~class." "__subclasses__` (using :c:func:`PyObject_CallMethod`, for example)." msgstr "" -#: whatsnew/3.12.rst:2118 +#: whatsnew/3.12.rst:2130 msgid "" "Add support of more formatting options (left aligning, octals, uppercase " "hexadecimals, :c:type:`intmax_t`, :c:type:`ptrdiff_t`, :c:type:`wchar_t` C " @@ -3320,7 +3337,7 @@ msgid "" "`98836`.)" msgstr "" -#: whatsnew/3.12.rst:2124 +#: whatsnew/3.12.rst:2136 msgid "" "An unrecognized format character in :c:func:`PyUnicode_FromFormat` and :c:" "func:`PyUnicode_FromFormatV` now sets a :exc:`SystemError`. In previous " @@ -3329,13 +3346,13 @@ msgid "" "Storchaka in :gh:`95781`.)" msgstr "" -#: whatsnew/3.12.rst:2130 +#: whatsnew/3.12.rst:2142 msgid "" "Fix wrong sign placement in :c:func:`PyUnicode_FromFormat` and :c:func:" "`PyUnicode_FromFormatV`. (Contributed by Philip Georgi in :gh:`95504`.)" msgstr "" -#: whatsnew/3.12.rst:2134 +#: whatsnew/3.12.rst:2146 msgid "" "Extension classes wanting to add a ``__dict__`` or weak reference slot " "should use :c:macro:`Py_TPFLAGS_MANAGED_DICT` and :c:macro:" @@ -3349,7 +3366,7 @@ msgid "" "func:`PyObject_ClearWeakRefs`, as before." msgstr "" -#: whatsnew/3.12.rst:2146 +#: whatsnew/3.12.rst:2158 msgid "" "The :c:func:`PyUnicode_FSDecoder` function no longer accepts bytes-like " "paths, like :class:`bytearray` and :class:`memoryview` types: only the " @@ -3357,7 +3374,7 @@ msgid "" "Victor Stinner in :gh:`98393`.)" msgstr "" -#: whatsnew/3.12.rst:2151 +#: whatsnew/3.12.rst:2163 msgid "" "The :c:macro:`Py_CLEAR`, :c:macro:`Py_SETREF` and :c:macro:`Py_XSETREF` " "macros now only evaluate their arguments once. If an argument has side " @@ -3365,7 +3382,7 @@ msgid "" "Stinner in :gh:`98724`.)" msgstr "" -#: whatsnew/3.12.rst:2156 +#: whatsnew/3.12.rst:2168 msgid "" "The interpreter's error indicator is now always normalized. This means that :" "c:func:`PyErr_SetObject`, :c:func:`PyErr_SetString` and the other functions " @@ -3373,7 +3390,7 @@ msgid "" "(Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2161 +#: whatsnew/3.12.rst:2173 msgid "" "``_Py_RefTotal`` is no longer authoritative and only kept around for ABI " "compatibility. Note that it is an internal global and only available on " @@ -3381,25 +3398,25 @@ msgid "" "``_Py_GetGlobalRefTotal()``." msgstr "" -#: whatsnew/3.12.rst:2166 +#: whatsnew/3.12.rst:2178 msgid "" "The following functions now select an appropriate metaclass for the newly " "created type:" msgstr "" -#: whatsnew/3.12.rst:2169 +#: whatsnew/3.12.rst:2181 msgid ":c:func:`PyType_FromSpec`" msgstr "" -#: whatsnew/3.12.rst:2170 +#: whatsnew/3.12.rst:2182 msgid ":c:func:`PyType_FromSpecWithBases`" msgstr "" -#: whatsnew/3.12.rst:2171 +#: whatsnew/3.12.rst:2183 msgid ":c:func:`PyType_FromModuleAndSpec`" msgstr "" -#: whatsnew/3.12.rst:2173 +#: whatsnew/3.12.rst:2185 msgid "" "Creating classes whose metaclass overrides :c:member:`~PyTypeObject.tp_new` " "is deprecated, and in Python 3.14+ it will be disallowed. Note that these " @@ -3407,14 +3424,14 @@ msgid "" "initialization." msgstr "" -#: whatsnew/3.12.rst:2178 +#: whatsnew/3.12.rst:2190 msgid "" "Note that :c:func:`PyType_FromMetaclass` (added in Python 3.12) already " "disallows creating classes whose metaclass overrides ``tp_new`` (:meth:" "`~object.__new__` in Python)." msgstr "" -#: whatsnew/3.12.rst:2182 +#: whatsnew/3.12.rst:2194 msgid "" "Since ``tp_new`` overrides almost everything ``PyType_From*`` functions do, " "the two are incompatible with each other. The existing behavior -- ignoring " @@ -3423,17 +3440,17 @@ msgid "" "general workaround. One of the following may work for you:" msgstr "" -#: whatsnew/3.12.rst:2189 +#: whatsnew/3.12.rst:2201 msgid "If you control the metaclass, avoid using ``tp_new`` in it:" msgstr "" -#: whatsnew/3.12.rst:2191 +#: whatsnew/3.12.rst:2203 msgid "" "If initialization can be skipped, it can be done in :c:member:`~PyTypeObject." "tp_init` instead." msgstr "" -#: whatsnew/3.12.rst:2193 +#: whatsnew/3.12.rst:2205 msgid "" "If the metaclass doesn't need to be instantiated from Python, set its " "``tp_new`` to ``NULL`` using the :c:macro:" @@ -3441,20 +3458,20 @@ msgid "" "``PyType_From*`` functions." msgstr "" -#: whatsnew/3.12.rst:2198 +#: whatsnew/3.12.rst:2210 msgid "" "Avoid ``PyType_From*`` functions: if you don't need C-specific features " "(slots or setting the instance size), create types by :ref:`calling ` " "the metaclass." msgstr "" -#: whatsnew/3.12.rst:2202 +#: whatsnew/3.12.rst:2214 msgid "" "If you *know* the ``tp_new`` can be skipped safely, filter the deprecation " "warning out using :func:`warnings.catch_warnings` from Python." msgstr "" -#: whatsnew/3.12.rst:2205 +#: whatsnew/3.12.rst:2217 msgid "" ":c:var:`PyOS_InputHook` and :c:var:`PyOS_ReadlineFunctionPointer` are no " "longer called in :ref:`subinterpreters `. This is " @@ -3462,14 +3479,14 @@ msgid "" "callbacks have no way of recovering extension module state)." msgstr "" -#: whatsnew/3.12.rst:2210 +#: whatsnew/3.12.rst:2222 msgid "" "This also avoids situations where extensions may find themselves running in " "a subinterpreter that they don't support (or haven't yet been loaded in). " "See :gh:`104668` for more info." msgstr "" -#: whatsnew/3.12.rst:2214 +#: whatsnew/3.12.rst:2226 msgid "" ":c:struct:`PyLongObject` has had its internals changed for better " "performance. Although the internals of :c:struct:`PyLongObject` are private, " @@ -3480,15 +3497,15 @@ msgid "" "a single machine word:" msgstr "" -#: whatsnew/3.12.rst:2222 +#: whatsnew/3.12.rst:2234 msgid ":c:func:`PyUnstable_Long_IsCompact`" msgstr "" -#: whatsnew/3.12.rst:2223 +#: whatsnew/3.12.rst:2235 msgid ":c:func:`PyUnstable_Long_CompactValue`" msgstr "" -#: whatsnew/3.12.rst:2225 +#: whatsnew/3.12.rst:2237 msgid "" "Custom allocators, set via :c:func:`PyMem_SetAllocator`, are now required to " "be thread-safe, regardless of memory domain. Allocators that don't have " @@ -3497,7 +3514,7 @@ msgid "" "create a new GitHub issue and CC ``@ericsnowcurrently``." msgstr "" -#: whatsnew/3.12.rst:2235 +#: whatsnew/3.12.rst:2247 msgid "" "In accordance with :pep:`699`, the ``ma_version_tag`` field in :c:type:" "`PyDictObject` is deprecated for extension modules. Accessing this field " @@ -3506,457 +3523,445 @@ msgid "" "PEP by Ken Jin.)" msgstr "" -#: whatsnew/3.12.rst:2240 +#: whatsnew/3.12.rst:2252 msgid "Deprecate global configuration variable:" msgstr "" -#: whatsnew/3.12.rst:2327 +#: whatsnew/3.12.rst:2339 msgid ":c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug`" msgstr "" -#: whatsnew/3.12.rst:2328 +#: whatsnew/3.12.rst:2340 msgid ":c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose`" msgstr "" -#: whatsnew/3.12.rst:2329 +#: whatsnew/3.12.rst:2341 msgid ":c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet`" msgstr "" -#: whatsnew/3.12.rst:2330 +#: whatsnew/3.12.rst:2342 msgid ":c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive`" msgstr "" -#: whatsnew/3.12.rst:2331 +#: whatsnew/3.12.rst:2343 msgid ":c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect`" msgstr "" -#: whatsnew/3.12.rst:2332 +#: whatsnew/3.12.rst:2344 msgid ":c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level`" msgstr "" -#: whatsnew/3.12.rst:2333 +#: whatsnew/3.12.rst:2345 msgid ":c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import`" msgstr "" -#: whatsnew/3.12.rst:2334 +#: whatsnew/3.12.rst:2346 msgid ":c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning`" msgstr "" -#: whatsnew/3.12.rst:2335 +#: whatsnew/3.12.rst:2347 msgid ":c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings`" msgstr "" -#: whatsnew/3.12.rst:2336 +#: whatsnew/3.12.rst:2348 msgid "" ":c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment`" msgstr "" -#: whatsnew/3.12.rst:2337 +#: whatsnew/3.12.rst:2349 msgid "" ":c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode`" msgstr "" -#: whatsnew/3.12.rst:2338 +#: whatsnew/3.12.rst:2350 msgid "" ":c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig.user_site_directory`" msgstr "" -#: whatsnew/3.12.rst:2339 +#: whatsnew/3.12.rst:2351 msgid "" ":c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio`" msgstr "" -#: whatsnew/3.12.rst:2340 +#: whatsnew/3.12.rst:2352 msgid "" ":c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` " "and :c:member:`PyConfig.hash_seed`" msgstr "" -#: whatsnew/3.12.rst:2342 +#: whatsnew/3.12.rst:2354 msgid ":c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated`" msgstr "" -#: whatsnew/3.12.rst:2343 +#: whatsnew/3.12.rst:2355 msgid "" ":c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig." "legacy_windows_fs_encoding`" msgstr "" -#: whatsnew/3.12.rst:2344 +#: whatsnew/3.12.rst:2356 msgid "" ":c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig." "legacy_windows_stdio`" msgstr "" -#: whatsnew/3.12.rst:2345 +#: whatsnew/3.12.rst:2357 msgid "" ":c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" msgstr "" -#: whatsnew/3.12.rst:2346 +#: whatsnew/3.12.rst:2358 msgid "" ":c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig." "filesystem_encoding`" msgstr "" -#: whatsnew/3.12.rst:2347 +#: whatsnew/3.12.rst:2359 msgid "" ":c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig." "filesystem_errors`" msgstr "" -#: whatsnew/3.12.rst:2348 +#: whatsnew/3.12.rst:2360 msgid "" ":c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` (see :c:func:" "`Py_PreInitialize`)" msgstr "" -#: whatsnew/3.12.rst:2265 +#: whatsnew/3.12.rst:2277 msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead. (Contributed by Victor Stinner in :gh:`77782`.)" msgstr "" -#: whatsnew/3.12.rst:2269 +#: whatsnew/3.12.rst:2281 msgid "" "Creating :c:data:`immutable types ` with mutable " "bases is deprecated and will be disabled in Python 3.14. (:gh:`95388`)" msgstr "" -#: whatsnew/3.12.rst:2272 +#: whatsnew/3.12.rst:2284 msgid "" "The :file:`structmember.h` header is deprecated, though it continues to be " "available and there are no plans to remove it." msgstr "" -#: whatsnew/3.12.rst:2275 +#: whatsnew/3.12.rst:2287 msgid "" "Its contents are now available just by including :file:`Python.h`, with a " "``Py`` prefix added if it was missing:" msgstr "" -#: whatsnew/3.12.rst:2278 +#: whatsnew/3.12.rst:2290 msgid "" ":c:struct:`PyMemberDef`, :c:func:`PyMember_GetOne` and :c:func:" "`PyMember_SetOne`" msgstr "" -#: whatsnew/3.12.rst:2280 +#: whatsnew/3.12.rst:2292 msgid "" "Type macros like :c:macro:`Py_T_INT`, :c:macro:`Py_T_DOUBLE`, etc. " "(previously ``T_INT``, ``T_DOUBLE``, etc.)" msgstr "" -#: whatsnew/3.12.rst:2282 +#: whatsnew/3.12.rst:2294 msgid "" "The flags :c:macro:`Py_READONLY` (previously ``READONLY``) and :c:macro:" "`Py_AUDIT_READ` (previously all uppercase)" msgstr "" -#: whatsnew/3.12.rst:2285 +#: whatsnew/3.12.rst:2297 msgid "Several items are not exposed from :file:`Python.h`:" msgstr "" -#: whatsnew/3.12.rst:2287 +#: whatsnew/3.12.rst:2299 msgid ":c:macro:`T_OBJECT` (use :c:macro:`Py_T_OBJECT_EX`)" msgstr "" -#: whatsnew/3.12.rst:2288 +#: whatsnew/3.12.rst:2300 msgid ":c:macro:`T_NONE` (previously undocumented, and pretty quirky)" msgstr "" -#: whatsnew/3.12.rst:2289 +#: whatsnew/3.12.rst:2301 msgid "The macro ``WRITE_RESTRICTED`` which does nothing." msgstr "" -#: whatsnew/3.12.rst:2290 +#: whatsnew/3.12.rst:2302 msgid "" "The macros ``RESTRICTED`` and ``READ_RESTRICTED``, equivalents of :c:macro:" "`Py_AUDIT_READ`." msgstr "" -#: whatsnew/3.12.rst:2292 +#: whatsnew/3.12.rst:2304 msgid "" "In some configurations, ```` is not included from :file:`Python." "h`. It should be included manually when using ``offsetof()``." msgstr "" -#: whatsnew/3.12.rst:2295 +#: whatsnew/3.12.rst:2307 msgid "" "The deprecated header continues to provide its original contents under the " "original names. Your old code can stay unchanged, unless the extra include " "and non-namespaced macros bother you greatly." msgstr "" -#: whatsnew/3.12.rst:2300 +#: whatsnew/3.12.rst:2312 msgid "" "(Contributed in :gh:`47146` by Petr Viktorin, based on earlier work by " "Alexander Belopolsky and Matthias Braun.)" msgstr "" -#: whatsnew/3.12.rst:2303 +#: whatsnew/3.12.rst:2315 msgid "" ":c:func:`PyErr_Fetch` and :c:func:`PyErr_Restore` are deprecated. Use :c:" "func:`PyErr_GetRaisedException` and :c:func:`PyErr_SetRaisedException` " "instead. (Contributed by Mark Shannon in :gh:`101578`.)" msgstr "" -#: whatsnew/3.12.rst:2308 +#: whatsnew/3.12.rst:2320 msgid "" ":c:func:`!PyErr_Display` is deprecated. Use :c:func:`PyErr_DisplayException` " "instead. (Contributed by Irit Katriel in :gh:`102755`)." msgstr "" -#: whatsnew/3.12.rst:2311 +#: whatsnew/3.12.rst:2323 msgid "" "``_PyErr_ChainExceptions`` is deprecated. Use ``_PyErr_ChainExceptions1`` " "instead. (Contributed by Irit Katriel in :gh:`102192`.)" msgstr "" -#: whatsnew/3.12.rst:2314 +#: whatsnew/3.12.rst:2326 msgid "" "Using :c:func:`PyType_FromSpec`, :c:func:`PyType_FromSpecWithBases` or :c:" "func:`PyType_FromModuleAndSpec` to create a class whose metaclass overrides :" "c:member:`~PyTypeObject.tp_new` is deprecated. Call the metaclass instead." msgstr "" -#: whatsnew/3.12.rst:2322 +#: whatsnew/3.12.rst:2334 msgid "" "The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " "(:pep:`699`; :gh:`101193`)." msgstr "" -#: whatsnew/3.12.rst:2325 +#: whatsnew/3.12.rst:2337 msgid "Global configuration variables:" msgstr "" -#: whatsnew/3.12.rst:2350 +#: whatsnew/3.12.rst:2362 msgid "" "The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" "`PyConfig` instead." msgstr "" -#: whatsnew/3.12.rst:2353 +#: whatsnew/3.12.rst:2365 msgid "" "Creating :c:data:`immutable types ` with mutable " "bases (:gh:`95388`)." msgstr "" -#: whatsnew/3.12.rst:2359 +#: whatsnew/3.12.rst:2371 msgid "" ":c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule`" msgstr "" -#: whatsnew/3.12.rst:2360 +#: whatsnew/3.12.rst:2372 msgid ":c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t`" msgstr "" -#: whatsnew/3.12.rst:2361 +#: whatsnew/3.12.rst:2373 msgid ":c:type:`Py_UNICODE` type: use :c:type:`wchar_t`" msgstr "" -#: whatsnew/3.12.rst:2362 +#: whatsnew/3.12.rst:2374 msgid "Python initialization functions:" msgstr "" -#: whatsnew/3.12.rst:2364 +#: whatsnew/3.12.rst:2376 msgid "" ":c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and :data:`!" "warnings.filters`" msgstr "" -#: whatsnew/3.12.rst:2366 +#: whatsnew/3.12.rst:2378 msgid ":c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix`" msgstr "" -#: whatsnew/3.12.rst:2367 +#: whatsnew/3.12.rst:2379 msgid ":c:func:`Py_GetPath`: get :data:`sys.path`" msgstr "" -#: whatsnew/3.12.rst:2368 +#: whatsnew/3.12.rst:2380 msgid ":c:func:`Py_GetPrefix`: get :data:`sys.prefix`" msgstr "" -#: whatsnew/3.12.rst:2369 +#: whatsnew/3.12.rst:2381 msgid ":c:func:`Py_GetProgramFullPath`: get :data:`sys.executable`" msgstr "" -#: whatsnew/3.12.rst:2370 +#: whatsnew/3.12.rst:2382 msgid ":c:func:`Py_GetProgramName`: get :data:`sys.executable`" msgstr "" -#: whatsnew/3.12.rst:2371 +#: whatsnew/3.12.rst:2383 msgid "" ":c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or the :envvar:" "`PYTHONHOME` environment variable" msgstr "" -#: whatsnew/3.12.rst:2377 +#: whatsnew/3.12.rst:2389 msgid "" "The following APIs are deprecated and will be removed, although there is " "currently no date scheduled for their removal." msgstr "" -#: whatsnew/3.12.rst:2380 +#: whatsnew/3.12.rst:2392 msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8" msgstr "" -#: whatsnew/3.12.rst:2381 +#: whatsnew/3.12.rst:2393 msgid ":c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException`" msgstr "" -#: whatsnew/3.12.rst:2382 +#: whatsnew/3.12.rst:2394 msgid "" ":c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException`" msgstr "" -#: whatsnew/3.12.rst:2383 +#: whatsnew/3.12.rst:2395 msgid ":c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException`" msgstr "" -#: whatsnew/3.12.rst:2384 +#: whatsnew/3.12.rst:2396 msgid "" ":c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject`" msgstr "" -#: whatsnew/3.12.rst:2385 +#: whatsnew/3.12.rst:2397 msgid ":c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child`" msgstr "" -#: whatsnew/3.12.rst:2386 +#: whatsnew/3.12.rst:2398 msgid "" ":c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:" "`PySlice_AdjustIndices`" msgstr "" -#: whatsnew/3.12.rst:2387 +#: whatsnew/3.12.rst:2399 msgid ":c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode`" msgstr "" -#: whatsnew/3.12.rst:2388 +#: whatsnew/3.12.rst:2400 msgid ":c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode`" msgstr "" -#: whatsnew/3.12.rst:2389 +#: whatsnew/3.12.rst:2401 msgid ":c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode`" msgstr "" -#: whatsnew/3.12.rst:2390 +#: whatsnew/3.12.rst:2402 msgid ":c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode`" msgstr "" -#: whatsnew/3.12.rst:2391 +#: whatsnew/3.12.rst:2403 msgid ":c:func:`PyUnicode_READY`: unneeded since Python 3.12" msgstr "" -#: whatsnew/3.12.rst:2392 +#: whatsnew/3.12.rst:2404 msgid ":c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException`" msgstr "" -#: whatsnew/3.12.rst:2393 +#: whatsnew/3.12.rst:2405 msgid ":c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1``" msgstr "" -#: whatsnew/3.12.rst:2394 +#: whatsnew/3.12.rst:2406 msgid "" ":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " "instead" msgstr "" -#: whatsnew/3.12.rst:2396 +#: whatsnew/3.12.rst:2408 msgid ":c:member:`!PyDictObject.ma_version_tag` member" msgstr "" -#: whatsnew/3.12.rst:2397 +#: whatsnew/3.12.rst:2409 msgid "Thread Local Storage (TLS) API:" msgstr "" -#: whatsnew/3.12.rst:2399 +#: whatsnew/3.12.rst:2411 msgid ":c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc`" msgstr "" -#: whatsnew/3.12.rst:2400 +#: whatsnew/3.12.rst:2412 msgid ":c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free`" msgstr "" -#: whatsnew/3.12.rst:2401 +#: whatsnew/3.12.rst:2413 msgid ":c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set`" msgstr "" -#: whatsnew/3.12.rst:2402 +#: whatsnew/3.12.rst:2414 msgid ":c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get`" msgstr "" -#: whatsnew/3.12.rst:2403 +#: whatsnew/3.12.rst:2415 msgid ":c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete`" msgstr "" -#: whatsnew/3.12.rst:2404 +#: whatsnew/3.12.rst:2416 msgid ":c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7" msgstr "" -#: whatsnew/3.12.rst:2409 +#: whatsnew/3.12.rst:2421 msgid "" "Remove the :file:`token.h` header file. There was never any public tokenizer " "C API. The :file:`token.h` header file was only designed to be used by " "Python internals. (Contributed by Victor Stinner in :gh:`92651`.)" msgstr "" -#: whatsnew/3.12.rst:2414 +#: whatsnew/3.12.rst:2426 msgid "Legacy Unicode APIs have been removed. See :pep:`623` for detail." msgstr "" -#: whatsnew/3.12.rst:2416 +#: whatsnew/3.12.rst:2428 msgid ":c:macro:`!PyUnicode_WCHAR_KIND`" msgstr "" -#: whatsnew/3.12.rst:2417 +#: whatsnew/3.12.rst:2429 msgid ":c:func:`!PyUnicode_AS_UNICODE`" msgstr "" -#: whatsnew/3.12.rst:2418 +#: whatsnew/3.12.rst:2430 msgid ":c:func:`!PyUnicode_AsUnicode`" msgstr "" -#: whatsnew/3.12.rst:2419 +#: whatsnew/3.12.rst:2431 msgid ":c:func:`!PyUnicode_AsUnicodeAndSize`" msgstr "" -#: whatsnew/3.12.rst:2420 +#: whatsnew/3.12.rst:2432 msgid ":c:func:`!PyUnicode_AS_DATA`" msgstr "" -#: whatsnew/3.12.rst:2421 +#: whatsnew/3.12.rst:2433 msgid ":c:func:`!PyUnicode_FromUnicode`" msgstr "" -#: whatsnew/3.12.rst:2422 +#: whatsnew/3.12.rst:2434 msgid ":c:func:`!PyUnicode_GET_SIZE`" msgstr "" -#: whatsnew/3.12.rst:2423 +#: whatsnew/3.12.rst:2435 msgid ":c:func:`!PyUnicode_GetSize`" msgstr "" -#: whatsnew/3.12.rst:2424 +#: whatsnew/3.12.rst:2436 msgid ":c:func:`!PyUnicode_GET_DATA_SIZE`" msgstr "" -#: whatsnew/3.12.rst:2426 +#: whatsnew/3.12.rst:2438 msgid "" "Remove the ``PyUnicode_InternImmortal()`` function macro. (Contributed by " "Victor Stinner in :gh:`85858`.)" msgstr "" - -#: whatsnew/3.12.rst:2429 -msgid "" -"Remove ``Jython`` compatibility hacks from several stdlib modules and tests. " -"(Contributed by Nikita Sobolev in :gh:`99482`.)" -msgstr "" - -#: whatsnew/3.12.rst:2432 -msgid "" -"Remove ``_use_broken_old_ctypes_structure_semantics_`` flag from :mod:" -"`ctypes` module. (Contributed by Nikita Sobolev in :gh:`99285`.)" -msgstr ""