python-docs-tr/library/collections.abc.po at 3.11 · python/python-docs-tr

621 lines (502 loc) · 17.9 KB
# Python Documentation Turkish Translation
# Copyright (C) 2001-2023, Python Software Foundation
# This file is distributed under the same license as the Python package.
"Project-Id-Version: Python 3.11\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 00:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: \n"
"Language-Team: TURKISH <python.docs.tr@gmail.com>\n"
"Language: tr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: library/collections.abc.rst:2
msgid ":mod:`collections.abc` --- Abstract Base Classes for Containers"
#: library/collections.abc.rst:10
msgid "Formerly, this module was part of the :mod:`collections` module."
#: library/collections.abc.rst:13
msgid "**Source code:** :source:`Lib/_collections_abc.py`"
#: library/collections.abc.rst:23
"This module provides :term:`abstract base classes <abstract base class>` "
"that can be used to test whether a class provides a particular interface; "
"for example, whether it is :term:`hashable` or whether it is a mapping."
#: library/collections.abc.rst:27
"An :func:`issubclass` or :func:`isinstance` test for an interface works in "
"one of three ways."
#: library/collections.abc.rst:30
"1) A newly written class can inherit directly from one of the abstract base "
"classes.  The class must supply the required abstract methods.  The "
"remaining mixin methods come from inheritance and can be overridden if "
"desired.  Other methods may be added as needed:"
#: library/collections.abc.rst:50
"2) Existing classes and built-in classes can be registered as \"virtual "
"subclasses\" of the ABCs.  Those classes should define the full API "
"including all of the abstract methods and all of the mixin methods. This "
"lets users rely on :func:`issubclass` or :func:`isinstance` tests to "
"determine whether the full interface is supported.  The exception to this "
"rule is for methods that are automatically inferred from the rest of the API:"
#: library/collections.abc.rst:76
"In this example, class :class:`D` does not need to define ``__contains__``, "
"``__iter__``, and ``__reversed__`` because the :ref:`in-operator "
"<comparisons>`, the :term:`iteration <iterable>` logic, and the :func:"
"`reversed` function automatically fall back to using ``__getitem__`` and "
"``__len__``."
#: library/collections.abc.rst:82
"3) Some simple interfaces are directly recognizable by the presence of the "
"required methods (unless those methods have been set to :const:`None`):"
#: library/collections.abc.rst:99
"Complex interfaces do not support this last technique because an interface "
"is more than just the presence of method names.  Interfaces specify "
"semantics and relationships between methods that cannot be inferred solely "
"from the presence of specific method names.  For example, knowing that a "
"class supplies ``__getitem__``, ``__len__``, and ``__iter__`` is "
"insufficient for distinguishing a :class:`Sequence` from a :class:`Mapping`."
#: library/collections.abc.rst:107
"These abstract classes now support ``[]``. See :ref:`types-genericalias` "
"and :pep:`585`."
#: library/collections.abc.rst:114
msgid "Collections Abstract Base Classes"
#: library/collections.abc.rst:116
"The collections module offers the following :term:`ABCs <abstract base "
#: library/collections.abc.rst:121
msgid "ABC"
#: library/collections.abc.rst:121
msgid "Inherits from"
#: library/collections.abc.rst:121
msgid "Abstract Methods"
#: library/collections.abc.rst:121
msgid "Mixin Methods"
#: library/collections.abc.rst:123
msgid ":class:`Container` [1]_"
#: library/collections.abc.rst:123
msgid "``__contains__``"
#: library/collections.abc.rst:124
msgid ":class:`Hashable` [1]_"
#: library/collections.abc.rst:124
msgid "``__hash__``"
#: library/collections.abc.rst:125
msgid ":class:`Iterable` [1]_ [2]_"
#: library/collections.abc.rst:125 library/collections.abc.rst:126
msgid "``__iter__``"
#: library/collections.abc.rst:126
msgid ":class:`Iterator` [1]_"
#: library/collections.abc.rst:126 library/collections.abc.rst:127
msgid ":class:`Iterable`"
#: library/collections.abc.rst:126
msgid "``__next__``"
#: library/collections.abc.rst:127
msgid ":class:`Reversible` [1]_"
#: library/collections.abc.rst:127
msgid "``__reversed__``"
#: library/collections.abc.rst:128
msgid ":class:`Generator`  [1]_"
#: library/collections.abc.rst:128
msgid ":class:`Iterator`"
#: library/collections.abc.rst:128 library/collections.abc.rst:176
msgid "``send``, ``throw``"
#: library/collections.abc.rst:128
msgid "``close``, ``__iter__``, ``__next__``"
#: library/collections.abc.rst:129
msgid ":class:`Sized`  [1]_"
#: library/collections.abc.rst:129 library/collections.abc.rst:168
msgid "``__len__``"
#: library/collections.abc.rst:130
msgid ":class:`Callable`  [1]_"
#: library/collections.abc.rst:130
msgid "``__call__``"
#: library/collections.abc.rst:131
msgid ":class:`Collection`  [1]_"
#: library/collections.abc.rst:131
msgid ":class:`Sized`, :class:`Iterable`, :class:`Container`"
#: library/collections.abc.rst:131 library/collections.abc.rst:147
msgid "``__contains__``, ``__iter__``, ``__len__``"
#: library/collections.abc.rst:135 library/collections.abc.rst:138
#: library/collections.abc.rst:144
msgid ":class:`Sequence`"
#: library/collections.abc.rst:135
msgid ":class:`Reversible`, :class:`Collection`"
#: library/collections.abc.rst:135 library/collections.abc.rst:144
msgid "``__getitem__``, ``__len__``"
#: library/collections.abc.rst:135
"``__contains__``, ``__iter__``, ``__reversed__``, ``index``, and ``count``"
#: library/collections.abc.rst:138
msgid ":class:`MutableSequence`"
#: library/collections.abc.rst:138
"``__getitem__``, ``__setitem__``, ``__delitem__``, ``__len__``, ``insert``"
#: library/collections.abc.rst:138
"Inherited :class:`Sequence` methods and ``append``, ``reverse``, ``extend``, "
"``pop``, ``remove``, and ``__iadd__``"
#: library/collections.abc.rst:144
msgid ":class:`ByteString`"
#: library/collections.abc.rst:144
msgid "Inherited :class:`Sequence` methods"
#: library/collections.abc.rst:147 library/collections.abc.rst:151
msgid ":class:`Set`"
#: library/collections.abc.rst:147 library/collections.abc.rst:157
msgid ":class:`Collection`"
#: library/collections.abc.rst:147
"``__le__``, ``__lt__``, ``__eq__``, ``__ne__``, ``__gt__``, ``__ge__``, "
"``__and__``, ``__or__``, ``__sub__``, ``__xor__``, and ``isdisjoint``"
#: library/collections.abc.rst:151
msgid ":class:`MutableSet`"
#: library/collections.abc.rst:151
msgid "``__contains__``, ``__iter__``, ``__len__``, ``add``, ``discard``"
#: library/collections.abc.rst:151
"Inherited :class:`Set` methods and ``clear``, ``pop``, ``remove``, "
"``__ior__``, ``__iand__``, ``__ixor__``, and ``__isub__``"
#: library/collections.abc.rst:157 library/collections.abc.rst:161
msgid ":class:`Mapping`"
#: library/collections.abc.rst:157
msgid "``__getitem__``, ``__iter__``, ``__len__``"
#: library/collections.abc.rst:157
"``__contains__``, ``keys``, ``items``, ``values``, ``get``, ``__eq__``, and "
"``__ne__``"
#: library/collections.abc.rst:161
msgid ":class:`MutableMapping`"
#: library/collections.abc.rst:161
"``__getitem__``, ``__setitem__``, ``__delitem__``, ``__iter__``, ``__len__``"
#: library/collections.abc.rst:161
"Inherited :class:`Mapping` methods and ``pop``, ``popitem``, ``clear``, "
"``update``, and ``setdefault``"
#: library/collections.abc.rst:168
msgid ":class:`MappingView`"
#: library/collections.abc.rst:168
msgid ":class:`Sized`"
#: library/collections.abc.rst:169
msgid ":class:`ItemsView`"
#: library/collections.abc.rst:169 library/collections.abc.rst:171
msgid ":class:`MappingView`, :class:`Set`"
#: library/collections.abc.rst:169 library/collections.abc.rst:171
#: library/collections.abc.rst:173
msgid "``__contains__``, ``__iter__``"
#: library/collections.abc.rst:171
msgid ":class:`KeysView`"
#: library/collections.abc.rst:173
msgid ":class:`ValuesView`"
#: library/collections.abc.rst:173
msgid ":class:`MappingView`, :class:`Collection`"
#: library/collections.abc.rst:175
msgid ":class:`Awaitable` [1]_"
#: library/collections.abc.rst:175
msgid "``__await__``"
#: library/collections.abc.rst:176
msgid ":class:`Coroutine` [1]_"
#: library/collections.abc.rst:176
msgid ":class:`Awaitable`"
#: library/collections.abc.rst:176
msgid "``close``"
#: library/collections.abc.rst:177
msgid ":class:`AsyncIterable` [1]_"
#: library/collections.abc.rst:177 library/collections.abc.rst:178
msgid "``__aiter__``"
#: library/collections.abc.rst:178
msgid ":class:`AsyncIterator` [1]_"
#: library/collections.abc.rst:178
msgid ":class:`AsyncIterable`"
#: library/collections.abc.rst:178
msgid "``__anext__``"
#: library/collections.abc.rst:179
msgid ":class:`AsyncGenerator` [1]_"
#: library/collections.abc.rst:179
msgid ":class:`AsyncIterator`"
#: library/collections.abc.rst:179
msgid "``asend``, ``athrow``"
#: library/collections.abc.rst:179
msgid "``aclose``, ``__aiter__``, ``__anext__``"
#: library/collections.abc.rst:184
msgid "Footnotes"
#: library/collections.abc.rst:185
"These ABCs override :meth:`object.__subclasshook__` to support testing an "
"interface by verifying the required methods are present and have not been "
"set to :const:`None`.  This only works for simple interfaces.  More complex "
"interfaces require registration or direct subclassing."
#: library/collections.abc.rst:191
"Checking ``isinstance(obj, Iterable)`` detects classes that are registered "
"as :class:`Iterable` or that have an :meth:`__iter__` method, but it does "
"not detect classes that iterate with the :meth:`__getitem__` method.  The "
"only reliable way to determine whether an object is :term:`iterable` is to "
"call ``iter(obj)``."
#: library/collections.abc.rst:199
msgid "Collections Abstract Base Classes -- Detailed Descriptions"
#: library/collections.abc.rst:204
msgid "ABC for classes that provide the :meth:`__contains__` method."
#: library/collections.abc.rst:208
msgid "ABC for classes that provide the :meth:`__hash__` method."
#: library/collections.abc.rst:212
msgid "ABC for classes that provide the :meth:`__len__` method."
#: library/collections.abc.rst:216
msgid "ABC for classes that provide the :meth:`__call__` method."
#: library/collections.abc.rst:220
msgid "ABC for classes that provide the :meth:`__iter__` method."
#: library/collections.abc.rst:222
"Checking ``isinstance(obj, Iterable)`` detects classes that are registered "
"as :class:`Iterable` or that have an :meth:`__iter__` method, but it does "
"not detect classes that iterate with the :meth:`__getitem__` method. The "
"only reliable way to determine whether an object is :term:`iterable` is to "
"call ``iter(obj)``."
#: library/collections.abc.rst:230
msgid "ABC for sized iterable container classes."
#: library/collections.abc.rst:236
"ABC for classes that provide the :meth:`~iterator.__iter__` and :meth:"
"`~iterator.__next__` methods.  See also the definition of :term:`iterator`."
#: library/collections.abc.rst:242
"ABC for iterable classes that also provide the :meth:`__reversed__` method."
#: library/collections.abc.rst:249
"ABC for generator classes that implement the protocol defined in :pep:`342` "
"that extends iterators with the :meth:`~generator.send`, :meth:`~generator."
"throw` and :meth:`~generator.close` methods. See also the definition of :"
"term:`generator`."
#: library/collections.abc.rst:260
msgid "ABCs for read-only and mutable :term:`sequences <sequence>`."
#: library/collections.abc.rst:262
"Implementation note: Some of the mixin methods, such as :meth:`__iter__`, :"
"meth:`__reversed__` and :meth:`index`, make repeated calls to the "
"underlying :meth:`__getitem__` method. Consequently, if :meth:`__getitem__` "
"is implemented with constant access speed, the mixin methods will have "
"linear performance; however, if the underlying method is linear (as it would "
"be with a linked list), the mixins will have quadratic performance and will "
"likely need to be overridden."
#: library/collections.abc.rst:271
msgid "The index() method added support for *stop* and *start* arguments."
#: library/collections.abc.rst:278
msgid "ABCs for read-only and mutable sets."
#: library/collections.abc.rst:283
msgid "ABCs for read-only and mutable :term:`mappings <mapping>`."
#: library/collections.abc.rst:290
"ABCs for mapping, items, keys, and values :term:`views <dictionary view>`."
#: library/collections.abc.rst:294
"ABC for :term:`awaitable` objects, which can be used in :keyword:`await` "
"expressions.  Custom implementations must provide the :meth:`__await__` "
#: library/collections.abc.rst:298
":term:`Coroutine <coroutine>` objects and instances of the :class:"
"`~collections.abc.Coroutine` ABC are all instances of this ABC."
#: library/collections.abc.rst:302
"In CPython, generator-based coroutines (generators decorated with :func:"
"`types.coroutine`) are *awaitables*, even though they do not have an :meth:"
"`__await__` method. Using ``isinstance(gencoro, Awaitable)`` for them will "
"return ``False``. Use :func:`inspect.isawaitable` to detect them."
#: library/collections.abc.rst:312
"ABC for coroutine compatible classes.  These implement the following "
"methods, defined in :ref:`coroutine-objects`: :meth:`~coroutine.send`, :meth:"
"`~coroutine.throw`, and :meth:`~coroutine.close`.  Custom implementations "
"must also implement :meth:`__await__`.  All :class:`Coroutine` instances are "
"also instances of :class:`Awaitable`.  See also the definition of :term:"
"`coroutine`."
#: library/collections.abc.rst:320
"In CPython, generator-based coroutines (generators decorated with :func:"
"`types.coroutine`) are *awaitables*, even though they do not have an :meth:"
"`__await__` method. Using ``isinstance(gencoro, Coroutine)`` for them will "
"return ``False``. Use :func:`inspect.isawaitable` to detect them."
#: library/collections.abc.rst:330
"ABC for classes that provide ``__aiter__`` method.  See also the definition "
"of :term:`asynchronous iterable`."
#: library/collections.abc.rst:337
"ABC for classes that provide ``__aiter__`` and ``__anext__`` methods.  See "
"also the definition of :term:`asynchronous iterator`."
#: library/collections.abc.rst:344
"ABC for asynchronous generator classes that implement the protocol defined "
"in :pep:`525` and :pep:`492`."
#: library/collections.abc.rst:350
msgid "Examples and Recipes"
#: library/collections.abc.rst:352
"ABCs allow us to ask classes or instances if they provide particular "
"functionality, for example::"
#: library/collections.abc.rst:359
"Several of the ABCs are also useful as mixins that make it easier to develop "
"classes supporting container APIs.  For example, to write a class supporting "
"the full :class:`Set` API, it is only necessary to supply the three "
"underlying abstract methods: :meth:`__contains__`, :meth:`__iter__`, and :"
"meth:`__len__`. The ABC supplies the remaining methods such as :meth:"
"`__and__` and :meth:`isdisjoint`::"
#: library/collections.abc.rst:388
msgid "Notes on using :class:`Set` and :class:`MutableSet` as a mixin:"
#: library/collections.abc.rst:391
"Since some set operations create new sets, the default mixin methods need a "
"way to create new instances from an iterable. The class constructor is "
"assumed to have a signature in the form ``ClassName(iterable)``. That "
"assumption is factored-out to an internal classmethod called :meth:"
"`_from_iterable` which calls ``cls(iterable)`` to produce a new set. If the :"
"class:`Set` mixin is being used in a class with a different constructor "
"signature, you will need to override :meth:`_from_iterable` with a "
"classmethod or regular method that can construct new instances from an "
"iterable argument."
#: library/collections.abc.rst:402
"To override the comparisons (presumably for speed, as the semantics are "
"fixed), redefine :meth:`__le__` and :meth:`__ge__`, then the other "
"operations will automatically follow suit."
#: library/collections.abc.rst:407
"The :class:`Set` mixin provides a :meth:`_hash` method to compute a hash "
"value for the set; however, :meth:`__hash__` is not defined because not all "
"sets are :term:`hashable` or immutable.  To add set hashability using "
"mixins, inherit from both :meth:`Set` and :meth:`Hashable`, then define "
"``__hash__ = Set._hash``."
#: library/collections.abc.rst:415
"`OrderedSet recipe <https://code.activestate.com/recipes/576694/>`_ for an "
"example built on :class:`MutableSet`."
#: library/collections.abc.rst:418
msgid "For more about ABCs, see the :mod:`abc` module and :pep:`3119`."
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

collections.abc.po

Latest commit

History

collections.abc.po

File metadata and controls
