`collections.abc.md`

302 строк · 35.5 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.12/library/collections.abc.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `collections.abc` – Абстрактные базовые классы для контейнеров89Добавлено в версии 3.3: Ранее этот модуль был частью модуля [`collections`](https://python-all.ru/3.12/library/collections.html#module-collections).1011**Исходный код:** [Lib/\_collections\_abc.py](https://python-all.ru/src/3.12/Lib/_collections_abc.py)1213---1415Этот модуль предоставляет [абстрактные базовые классы](https://python-all.ru/3.12/glossary.html#term-abstract-base-class), которые можно использовать для проверки, предоставляет ли класс определённый интерфейс; например, является ли он [хешируемым](https://python-all.ru/3.12/glossary.html#term-hashable) или [отображением](https://python-all.ru/3.12/glossary.html#term-mapping).1617Проверка [`issubclass()`](https://python-all.ru/3.12/library/functions.html#issubclass) или [`isinstance()`](https://python-all.ru/3.12/library/functions.html#isinstance) для интерфейса работает одним из трёх способов.18191. Новый класс может наследовать напрямую от одного из абстрактных базовых классов. Класс должен предоставлять требуемые абстрактные методы. Остальные методы-примеси наследуются и могут быть переопределены при необходимости. Другие методы могут быть добавлены по мере необходимости:2021   ```python22   class C(Sequence):                      # Прямое наследование23       def __init__(self): ...             # Дополнительный метод, не требуемый ABC24       def __getitem__(self, index):  ...  # Обязательный абстрактный метод25       def __len__(self):  ...             # Обязательный абстрактный метод26       def count(self, value): ...         # Необязательное переопределение метода-примеси27   ```2829   ```pycon30   >>> issubclass(C, Sequence)31   True32   >>> isinstance(C(), Sequence)33   True34   ```352. Существующие и встроенные классы могут быть зарегистрированы как «виртуальные подклассы» ABC. Эти классы должны определять полный API, включая все абстрактные методы и все методы-примеси. Это позволяет пользователям полагаться на проверки [`issubclass()`](https://python-all.ru/3.12/library/functions.html#issubclass) или [`isinstance()`](https://python-all.ru/3.12/library/functions.html#isinstance), чтобы определить, поддерживается ли полный интерфейс. Исключением из этого правила являются методы, которые автоматически выводятся из остального API:3637   ```python38   class D:                                 # Нет наследования39       def __init__(self): ...              # Дополнительный метод, не требуемый ABC40       def __getitem__(self, index):  ...   # Обязательный абстрактный метод41       def __len__(self):  ...              # Обязательный абстрактный метод42       def count(self, value): ...          # Метод-примесь43       def index(self, value): ...          # Метод-примесь4445   Sequence.register(D)                     # Регистрация вместо наследования46   ```4748   ```pycon49   >>> issubclass(D, Sequence)50   True51   >>> isinstance(D(), Sequence)52   True53   ```5455   В этом примере классу `D` не нужно определять `__contains__`, `__iter__` и `__reversed__`, потому что [оператор in](https://python-all.ru/3.12/reference/expressions.html#comparisons), логика [итерации](https://python-all.ru/3.12/glossary.html#term-iterable) и функция [`reversed()`](https://python-all.ru/3.12/library/functions.html#reversed) автоматически используют `__getitem__` и `__len__`.563. Некоторые простые интерфейсы напрямую распознаются по наличию требуемых методов (если только эти методы не были установлены в [`None`](https://python-all.ru/3.12/library/constants.html#None)):5758   ```python59   class E:60       def __iter__(self): ...61       def __next__(self): ...62   ```6364   ```pycon65   >>> issubclass(E, Iterable)66   True67   >>> isinstance(E(), Iterable)68   True69   ```7071   Сложные интерфейсы не поддерживают этот последний приём, потому что интерфейс – это не просто наличие имён методов. Интерфейсы определяют семантику и взаимосвязи между методами, которые невозможно вывести только по наличию конкретных имён методов. Например, знания того, что класс предоставляет `__getitem__`, `__len__` и `__iter__`, недостаточно, чтобы отличить [`Sequence`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Sequence) от [`Mapping`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Mapping).7273Добавлено в версии 3.9: Теперь эти абстрактные классы поддерживают `[]`. См. [Generic Alias Type](https://python-all.ru/3.12/library/stdtypes.html#types-genericalias) и [**PEP 585**](https://python-all.ru/3.12/library/collections.abc.html).7475## Абстрактные базовые классы коллекций7677Модуль collections предоставляет следующие [абстрактные базовые классы](https://python-all.ru/3.12/glossary.html#term-abstract-base-class):7879| ABC | Наследует от | Абстрактные методы | Методы-примеси |80| --- | --- | --- | --- |81| [`Container`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Container) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) |  | `__contains__` |  |82| [`Hashable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Hashable) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) |  | `__hash__` |  |83| [`Iterable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Iterable) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) [\[2\]](https://python-all.ru/3.12/library/collections.abc.html#id19) |  | `__iter__` |  |84| [`Iterator`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Iterator) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) | [`Iterable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Iterable) | `__next__` | `__iter__` |85| [`Reversible`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Reversible) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) | [`Iterable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Iterable) | `__reversed__` |  |86| [`Generator`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Generator) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) | [`Iterator`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Iterator) | `send`, `throw` | `close`, `__iter__`, `__next__` |87| [`Sized`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Sized) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) |  | `__len__` |  |88| [`Callable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Callable) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) |  | `__call__` |  |89| [`Collection`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Collection) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) | [`Sized`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Sized), [`Iterable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Iterable), [`Container`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Container) | `__contains__`, `__iter__`, `__len__` |  |90| [`Sequence`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Sequence) | [`Reversible`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Reversible), [`Collection`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Collection) | `__getitem__`, `__len__` | `__contains__`, `__iter__`, `__reversed__`, `index` и `count` |91| [`MutableSequence`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.MutableSequence) | [`Sequence`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Sequence) | `__getitem__`, `__setitem__`, `__delitem__`, `__len__`, `insert` | Унаследованные методы [`Sequence`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Sequence) и `append`, `clear`, `reverse`, `extend`, `pop`, `remove` и `__iadd__` |92| [`ByteString`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.ByteString) | [`Sequence`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Sequence) | `__getitem__`, `__len__` | Унаследованные методы [`Sequence`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Sequence) |93| [`Set`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Set) | [`Collection`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Collection) | `__contains__`, `__iter__`, `__len__` | `__le__`, `__lt__`, `__eq__`, `__ne__`, `__gt__`, `__ge__`, `__and__`, `__or__`, `__sub__`, `__rsub__`, `__xor__`, `__rxor__` и `isdisjoint` |94| [`MutableSet`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.MutableSet) | [`Set`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Set) | `__contains__`, `__iter__`, `__len__`, `add`, `discard` | Унаследованные методы [`Set`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Set) и `clear`, `pop`, `remove`, `__ior__`, `__iand__`, `__ixor__` и `__isub__` |95| [`Mapping`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Mapping) | [`Collection`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Collection) | `__getitem__`, `__iter__`, `__len__` | `__contains__`, `keys`, `items`, `values`, `get`, `__eq__` и `__ne__` |96| [`MutableMapping`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.MutableMapping) | [`Mapping`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Mapping) | `__getitem__`, `__setitem__`, `__delitem__`, `__iter__`, `__len__` | Унаследованные методы [`Mapping`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Mapping) и `pop`, `popitem`, `clear`, `update`, и `setdefault` |97| [`MappingView`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.MappingView) | [`Sized`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Sized) |  | `__init__`, `__len__` и `__repr__` |98| [`ItemsView`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.ItemsView) | [`MappingView`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.MappingView), [`Set`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Set) |  | `__contains__`, `__iter__` |99| [`KeysView`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.KeysView) | [`MappingView`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.MappingView), [`Set`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Set) |  | `__contains__`, `__iter__` |100| [`ValuesView`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.ValuesView) | [`MappingView`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.MappingView), [`Collection`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Collection) |  | `__contains__`, `__iter__` |101| [`Awaitable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Awaitable) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) |  | `__await__` |  |102| [`Coroutine`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Coroutine) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) | [`Awaitable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Awaitable) | `send`, `throw` | `close` |103| [`AsyncIterable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.AsyncIterable) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) |  | `__aiter__` |  |104| [`AsyncIterator`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.AsyncIterator) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) | [`AsyncIterable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.AsyncIterable) | `__anext__` | `__aiter__` |105| [`AsyncGenerator`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.AsyncGenerator) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) | [`AsyncIterator`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.AsyncIterator) | `asend`, `athrow` | `aclose`, `__aiter__`, `__anext__` |106| [`Buffer`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Buffer) [\[1\]](https://python-all.ru/3.12/library/collections.abc.html#id18) |  | `__buffer__` |  |107108Сноски109110\[1\]111112([1](https://python-all.ru/3.12/library/collections.abc.html#id2),[2](https://python-all.ru/3.12/library/collections.abc.html#id3),[3](https://python-all.ru/3.12/library/collections.abc.html#id4),[4](https://python-all.ru/3.12/library/collections.abc.html#id6),[5](https://python-all.ru/3.12/library/collections.abc.html#id7),[6](https://python-all.ru/3.12/library/collections.abc.html#id8),[7](https://python-all.ru/3.12/library/collections.abc.html#id9),[8](https://python-all.ru/3.12/library/collections.abc.html#id10),[9](https://python-all.ru/3.12/library/collections.abc.html#id11),[10](https://python-all.ru/3.12/library/collections.abc.html#id12),[11](https://python-all.ru/3.12/library/collections.abc.html#id13),[12](https://python-all.ru/3.12/library/collections.abc.html#id14),[13](https://python-all.ru/3.12/library/collections.abc.html#id15),[14](https://python-all.ru/3.12/library/collections.abc.html#id16),[15](https://python-all.ru/3.12/library/collections.abc.html#id17))113114Эти ABC переопределяют [`__subclasshook__()`](https://python-all.ru/3.12/library/abc.html#abc.ABCMeta.__subclasshook__) для поддержки проверки интерфейса путём проверки, что требуемые методы присутствуют и не были установлены в [`None`](https://python-all.ru/3.12/library/constants.html#None). Это работает только для простых интерфейсов. Более сложные интерфейсы требуют регистрации или прямого наследования.115116\[[2](https://python-all.ru/3.12/library/collections.abc.html#id5)\]117118Проверка `isinstance(obj, Iterable)` обнаруживает классы, которые зарегистрированы как [`Iterable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Iterable) или имеют метод [`__iter__()`](https://python-all.ru/3.12/library/stdtypes.html#container.__iter__), но не обнаруживает классы, которые выполняют итерацию с помощью метода [`__getitem__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__getitem__). Единственный надёжный способ определить, является ли объект [итерируемым](https://python-all.ru/3.12/glossary.html#term-iterable) – вызвать `iter(obj)`.119120## Абстрактные базовые классы коллекций – Подробные описания121122#### `class collections.abc.Container`123124ABC для классов, которые предоставляют метод [`__contains__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__contains__).125126#### `class collections.abc.Hashable`127128ABC для классов, которые предоставляют метод [`__hash__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__hash__).129130#### `class collections.abc.Sized`131132ABC для классов, которые предоставляют метод [`__len__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__len__).133134#### `class collections.abc.Callable`135136ABC для классов, которые предоставляют метод [`__call__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__call__).137138См. [Аннотирование вызываемых объектов](https://python-all.ru/3.12/library/typing.html#annotating-callables) для получения подробной информации о том, как использовать `Callable` в аннотациях типов.139140#### `class collections.abc.Iterable`141142ABC для классов, которые предоставляют метод [`__iter__()`](https://python-all.ru/3.12/library/stdtypes.html#container.__iter__).143144Проверка `isinstance(obj, Iterable)` обнаруживает классы, которые зарегистрированы как [`Iterable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Iterable) или имеют метод [`__iter__()`](https://python-all.ru/3.12/library/stdtypes.html#container.__iter__), но не обнаруживает классы, которые выполняют итерацию с помощью метода [`__getitem__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__getitem__). Единственный надёжный способ определить, является ли объект [итерируемым](https://python-all.ru/3.12/glossary.html#term-iterable), – это вызвать `iter(obj)`.145146#### `class collections.abc.Collection`147148ABC для классов-контейнеров, которые поддерживают итерирование и определение размера.149150Добавлено в версии 3.6.151152#### `class collections.abc.Iterator`153154ABC для классов, которые предоставляют методы [`__iter__()`](https://python-all.ru/3.12/library/stdtypes.html#iterator.__iter__) и [`__next__()`](https://python-all.ru/3.12/library/stdtypes.html#iterator.__next__). См. также определение [итератора](https://python-all.ru/3.12/glossary.html#term-iterator).155156#### `class collections.abc.Reversible`157158ABC для итерируемых классов, которые также предоставляют метод [`__reversed__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__reversed__).159160Добавлено в версии 3.6.161162#### `class collections.abc.Generator`163164ABC для классов [генераторов](https://python-all.ru/3.12/glossary.html#term-generator), реализующих протокол, определённый в [**PEP 342**](https://python-all.ru/3.12/library/collections.abc.html), который расширяет [итераторы](https://python-all.ru/3.12/glossary.html#term-iterator) методами [`send()`](https://python-all.ru/3.12/reference/expressions.html#generator.send), [`throw()`](https://python-all.ru/3.12/reference/expressions.html#generator.throw) и [`close()`](https://python-all.ru/3.12/reference/expressions.html#generator.close).165166См. [Аннотирование генераторов и корутин](https://python-all.ru/3.12/library/typing.html#annotating-generators-and-coroutines) для подробностей об использовании `Generator` в аннотациях типов.167168Добавлено в версии 3.5.169170#### `class collections.abc.Sequence`171172#### `class collections.abc.MutableSequence`173174#### `class collections.abc.ByteString`175176ABC для неизменяемых и изменяемых [последовательностей](https://python-all.ru/3.12/glossary.html#term-sequence).177178Примечание к реализации: некоторые методы-примеси, такие как [`__iter__()`](https://python-all.ru/3.12/library/stdtypes.html#container.__iter__), [`__reversed__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__reversed__) и `index()`, многократно вызывают базовый метод [`__getitem__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__getitem__). Следовательно, если метод [`__getitem__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__getitem__) реализован с постоянной скоростью доступа, методы-примеси будут иметь линейную производительность; однако, если базовый метод является линейным (как в случае со связным списком), производительность примесей станет квадратичной, и их, скорее всего, придётся переопределить.179180Изменено в версии 3.5: Метод index() получил поддержку *stop* и *start* аргументов.181182Устарело с версии 3.12, будет удалено в версии 3.14: Абстрактный базовый класс [`ByteString`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.ByteString) устарел. Для использования в typing предпочтительнее объединение, например `bytes | bytearray` или [`collections.abc.Buffer`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Buffer). Для использования в качестве ABC предпочтительнее [`Sequence`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Sequence) или [`collections.abc.Buffer`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Buffer).183184#### `class collections.abc.Set`185186#### `class collections.abc.MutableSet`187188ABC для неизменяемых и изменяемых [множеств](https://python-all.ru/3.12/library/stdtypes.html#types-set).189190#### `class collections.abc.Mapping`191192#### `class collections.abc.MutableMapping`193194ABC для неизменяемых и изменяемых [отображений](https://python-all.ru/3.12/glossary.html#term-mapping).195196#### `class collections.abc.MappingView`197198#### `class collections.abc.ItemsView`199200#### `class collections.abc.KeysView`201202#### `class collections.abc.ValuesView`203204ABC для [представлений](https://python-all.ru/3.12/glossary.html#term-dictionary-view) отображений, элементов, ключей и значений.205206#### `class collections.abc.Awaitable`207208ABC для [ожидаемых](https://python-all.ru/3.12/glossary.html#term-awaitable) объектов, которые можно использовать в выражениях [`await`](https://python-all.ru/3.12/reference/expressions.html#await). Пользовательские реализации должны предоставлять метод [`__await__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__await__).209210Объекты [Coroutine](https://python-all.ru/3.12/glossary.html#term-coroutine) и экземпляры ABC [`Coroutine`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Coroutine) являются экземплярами этого ABC.211212> **Примечание**213>214> В CPython корутины на основе генераторов ([генераторы](https://python-all.ru/3.12/glossary.html#term-generator), декорированные с помощью [`@types.coroutine`](https://python-all.ru/3.12/library/types.html#types.coroutine)) являются *ожидаемыми объектами*, даже если они не имеют метода [`__await__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__await__). Использование `isinstance(gencoro, Awaitable)` для них вернёт `False`. Для их обнаружения используется [`inspect.isawaitable()`](https://python-all.ru/3.12/library/inspect.html#inspect.isawaitable).215216Добавлено в версии 3.5.217218#### `class collections.abc.Coroutine`219220ABC для [классов, совместимых с корутинами](https://python-all.ru/3.12/glossary.html#term-coroutine). Они реализуют следующие методы, определённые в [Объекты корутины](https://python-all.ru/3.12/reference/datamodel.html#coroutine-objects): [`send()`](https://python-all.ru/3.12/reference/datamodel.html#coroutine.send), [`throw()`](https://python-all.ru/3.12/reference/datamodel.html#coroutine.throw) и [`close()`](https://python-all.ru/3.12/reference/datamodel.html#coroutine.close). Пользовательские реализации также должны реализовать [`__await__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__await__). Все экземпляры [`Coroutine`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Coroutine) также являются экземплярами [`Awaitable`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Awaitable).221222> **Примечание**223>224> В CPython корутины на основе генераторов ([генераторы](https://python-all.ru/3.12/glossary.html#term-generator), декорированные с помощью [`@types.coroutine`](https://python-all.ru/3.12/library/types.html#types.coroutine)) являются *ожидаемыми объектами*, даже если они не имеют метода [`__await__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__await__). Использование `isinstance(gencoro, Coroutine)` для них вернёт `False`. Для их обнаружения используется [`inspect.isawaitable()`](https://python-all.ru/3.12/library/inspect.html#inspect.isawaitable).225226См. [Аннотирование генераторов и корутин](https://python-all.ru/3.12/library/typing.html#annotating-generators-and-coroutines) для подробностей об использовании `Coroutine` в аннотациях типов. Вариантность и порядок параметров типа соответствуют таковым у [`Generator`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Generator).227228Добавлено в версии 3.5.229230#### `class collections.abc.AsyncIterable`231232ABC для классов, предоставляющих метод `__aiter__`. См. также определение [асинхронного итерируемого объекта](https://python-all.ru/3.12/glossary.html#term-asynchronous-iterable).233234Добавлено в версии 3.5.235236#### `class collections.abc.AsyncIterator`237238ABC для классов, предоставляющих методы `__aiter__` и `__anext__`. См. также определение [асинхронного итератора](https://python-all.ru/3.12/glossary.html#term-asynchronous-iterator).239240Добавлено в версии 3.5.241242#### `class collections.abc.AsyncGenerator`243244ABC для [асинхронных генераторов](https://python-all.ru/3.12/glossary.html#term-asynchronous-generator), которые реализуют протокол, определённый в [**PEP 525**](https://python-all.ru/3.12/library/collections.abc.html) и [**PEP 492**](https://python-all.ru/3.12/library/collections.abc.html).245246См. [Аннотирование генераторов и корутин](https://python-all.ru/3.12/library/typing.html#annotating-generators-and-coroutines) для подробностей об использовании `AsyncGenerator` в аннотациях типов.247248Добавлено в версии 3.6.249250#### `class collections.abc.Buffer`251252ABC для классов, предоставляющих метод [`__buffer__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__buffer__), реализующих [протокол буфера](https://python-all.ru/3.12/c-api/buffer.html#bufferobjects). См. [**PEP 688**](https://python-all.ru/3.12/library/collections.abc.html).253254Добавлено в версии 3.12.255256## Примеры и рецепты257258ABC позволяют проверить, предоставляют ли классы или их экземпляры определённую функциональность, например:259260```python261size = None262if isinstance(myvar, collections.abc.Sized):263    size = len(myvar)264```265266Некоторые ABC также полезны в качестве примесей (mixins), упрощающих разработку классов, поддерживающих API контейнеров. Например, чтобы написать класс, поддерживающий полный API [`Set`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Set), достаточно предоставить три основных абстрактных метода: [`__contains__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__contains__), [`__iter__()`](https://python-all.ru/3.12/library/stdtypes.html#container.__iter__) и [`__len__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__len__). ABC предоставляет остальные методы, такие как `__and__()` и [`isdisjoint()`](https://python-all.ru/3.12/library/stdtypes.html#frozenset.isdisjoint):267268```python269class ListBasedSet(collections.abc.Set):270    ''' Альтернативная реализация множества, ориентированная на экономию памяти, а не на скорость271        и не требующая, чтобы элементы множества были хэшируемыми. '''272    def __init__(self, iterable):273        self.elements = lst = []274        for value in iterable:275            if value not in lst:276                lst.append(value)277278    def __iter__(self):279        return iter(self.elements)280281    def __contains__(self, value):282        return value in self.elements283284    def __len__(self):285        return len(self.elements)286287s1 = ListBasedSet('abcdef')288s2 = ListBasedSet('defghi')289overlap = s1 & s2            # Метод __and__() поддерживается автоматически290```291292Замечания по использованию [`Set`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Set) и [`MutableSet`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.MutableSet) в качестве примеси:2932941. Поскольку некоторые операции над множествами создают новые множества, методы по умолчанию в миксинах должны уметь создавать новые экземпляры из [итерируемого объекта](https://python-all.ru/3.12/glossary.html#term-iterable). Предполагается, что конструктор класса имеет сигнатуру вида `ClassName(iterable)`. Это предположение вынесено во внутренний [`classmethod`](https://python-all.ru/3.12/library/functions.html#classmethod), называемый `_from_iterable()`, который вызывает `cls(iterable)` для создания нового множества. Если миксин [`Set`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Set) используется в классе с другой сигнатурой конструктора, потребуется переопределить `_from_iterable()` с помощью метода класса или обычного метода, который может создавать новые экземпляры из итерируемого аргумента.2952. Чтобы переопределить сравнения (предположительно для скорости, так как семантика фиксирована), переопределите [`__le__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__le__) и [`__ge__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__ge__); тогда остальные операции автоматически последуют их примеру.2963. Миксин [`Set`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Set) предоставляет метод `_hash()` для вычисления хеш-значения множества; однако [`__hash__()`](https://python-all.ru/3.12/reference/datamodel.html#object.__hash__) не определён, поскольку не все множества являются [хешируемыми](https://python-all.ru/3.12/glossary.html#term-hashable) или неизменяемыми. Чтобы добавить хешируемость множеству с помощью миксинов, наследуйтесь от обоих [`Set()`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Set) и [`Hashable()`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.Hashable), а затем определите `__hash__ = Set._hash`.297298> **См. также**299>300> - [Рецепт OrderedSet](https://python-all.ru/3.12/library/collections.abc.html) для примера, построенного на [`MutableSet`](https://python-all.ru/3.12/library/collections.abc.html#collections.abc.MutableSet).301> - Для получения дополнительной информации об ABC см. модуль [`abc`](https://python-all.ru/3.12/library/abc.html#module-abc) и .302