> **Источник:** https://python-all.ru/3.14/library/abc.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# `abc` – Абстрактные базовые классы

**Исходный код:** [Lib/abc.py](https://python-all.ru/src/3.14/Lib/abc.py)

---

Этот модуль предоставляет инфраструктуру для определения [абстрактных базовых классов](https://python-all.ru/3.14/glossary.html#term-abstract-base-class) (ABC) в Python, как описано в [**PEP 3119**](https://python-all.ru/3.14/library/abc.html); см. PEP для информации о том, почему это было добавлено в Python. (См. также [**PEP 3141**](https://python-all.ru/3.14/library/abc.html) и модуль [`numbers`](https://python-all.ru/3.14/library/numbers.html#module-numbers) относительно иерархии типов для чисел на основе ABC.)

Модуль [`collections`](https://python-all.ru/3.14/library/collections.html#module-collections) содержит несколько конкретных классов, которые наследуются от ABC; их, конечно, можно наследовать дальше. Кроме того, подмодуль [`collections.abc`](https://python-all.ru/3.14/library/collections.abc.html#module-collections.abc) содержит несколько ABC, которые можно использовать для проверки, предоставляет ли класс или экземпляр определённый интерфейс, например, является ли он [хешируемым](https://python-all.ru/3.14/glossary.html#term-hashable) или является ли он [отображением](https://python-all.ru/3.14/glossary.html#term-mapping).

Этот модуль предоставляет метакласс [`ABCMeta`](https://python-all.ru/3.14/library/abc.html#abc.ABCMeta) для определения ABC и вспомогательный класс [`ABC`](https://python-all.ru/3.14/library/abc.html#abc.ABC) для альтернативного определения ABC через наследование:

#### `class abc.ABC`

Вспомогательный класс, который использует [`ABCMeta`](https://python-all.ru/3.14/library/abc.html#abc.ABCMeta) в качестве своего метакласса. С помощью этого класса абстрактный базовый класс можно создать, просто унаследовав от `ABC`, что позволяет избежать иногда запутанного использования метаклассов, например:

```python
from abc import ABC

class MyABC(ABC):
    pass
```

Обратите внимание, что типом `ABC` по-прежнему является [`ABCMeta`](https://python-all.ru/3.14/library/abc.html#abc.ABCMeta), поэтому наследование от `ABC` требует обычных мер предосторожности в отношении использования метаклассов, так как множественное наследование может привести к конфликтам метаклассов. Также можно определить абстрактный базовый класс, передав ключевое слово metaclass и используя напрямую `ABCMeta`, например:

```python
from abc import ABCMeta

class MyABC(metaclass=ABCMeta):
    pass
```

Добавлено в версии 3.4.

#### `class abc.ABCMeta`

Метакласс для определения абстрактных базовых классов (ABC).

Используйте этот метакласс для создания ABC. ABC может быть напрямую унаследован, а затем действует как примесь (mix-in). Также можно регистрировать несвязанные конкретные классы (даже встроенные классы) и несвязанные ABC как «виртуальные подклассы» – они и их потомки будут считаться подклассами регистрирующего ABC встроенной функцией [`issubclass()`](https://python-all.ru/3.14/library/functions.html#issubclass), но регистрирующий ABC не появится в их MRO (порядке разрешения методов), и реализации методов, определённые регистрирующим ABC, не будут вызываемыми (даже через [`super()`](https://python-all.ru/3.14/library/functions.html#super)). [\[1\]](https://python-all.ru/3.14/library/abc.html#id2)

Классы, созданные с метаклассом `ABCMeta`, имеют следующий метод:

#### `register(subclass)`

Регистрирует *подкласс* как «виртуальный подкласс» этого ABC. Например:

```python
from abc import ABC

class MyABC(ABC):
    pass

MyABC.register(tuple)

assert issubclass(tuple, MyABC)
assert isinstance((), MyABC)
```

Изменено в версии 3.3: Возвращает зарегистрированный подкласс, что позволяет использовать его в качестве декоратора класса.

Изменено в версии 3.4: Для обнаружения вызовов `register()` можно использовать функцию [`get_cache_token()`](https://python-all.ru/3.14/library/abc.html#abc.get_cache_token).

Также можно переопределить этот метод в абстрактном базовом классе:

#### `__subclasshook__(subclass)`

(Должен быть определён как метод класса.)

Проверяет, считается ли *подкласс* подклассом этого ABC. Это означает, что можно дополнительно настраивать поведение [`issubclass()`](https://python-all.ru/3.14/library/functions.html#issubclass) без необходимости вызывать [`register()`](https://python-all.ru/3.14/library/abc.html#abc.ABCMeta.register) для каждого класса, который требуется считать подклассом ABC. (Этот метод класса вызывается из метода [`__subclasscheck__()`](https://python-all.ru/3.14/reference/datamodel.html#type.__subclasscheck__) ABC.)

Этот метод должен возвращать `True`, `False` или [`NotImplemented`](https://python-all.ru/3.14/library/constants.html#NotImplemented). Если он возвращает `True`, то *подкласс* считается подклассом этого ABC. Если он возвращает `False`, то *подкласс* не считается подклассом этого ABC, даже если бы он обычно им был. Если он возвращает `NotImplemented`, проверка на подкласс продолжается обычным механизмом.

Для демонстрации этих концепций посмотрите на следующий пример определения ABC:

```python
class Foo:
    def __getitem__(self, index):
        ...
    def __len__(self):
        ...
    def get_iterator(self):
        return iter(self)

class MyIterable(ABC):

    @abstractmethod
    def __iter__(self):
        while False:
            yield None

    def get_iterator(self):
        return self.__iter__()

    @classmethod
    def __subclasshook__(cls, C):
        if cls is MyIterable:
            if any("__iter__" in B.__dict__ for B in C.__mro__):
                return True
        return NotImplemented

MyIterable.register(Foo)
```

ABC `MyIterable` определяет стандартный метод итерируемых объектов, [`__iter__()`](https://python-all.ru/3.14/reference/datamodel.html#object.__iter__), как абстрактный метод. Приведённую здесь реализацию всё ещё можно вызывать из подклассов. Метод `get_iterator()` также является частью абстрактного базового класса `MyIterable`, но его не обязательно переопределять в неабстрактных производных классах.

The [`__subclasshook__()`](https://python-all.ru/3.14/library/abc.html#abc.ABCMeta.__subclasshook__) class method defined here says that any class that has an [`__iter__()`](https://python-all.ru/3.14/reference/datamodel.html#object.__iter__) method in its [`__dict__`](https://python-all.ru/3.14/reference/datamodel.html#object.__dict__) (or in that of one of its base classes, accessed via the [`__mro__`](https://python-all.ru/3.14/reference/datamodel.html#type.__mro__) list) is considered a `MyIterable` too.

Наконец, последняя строка делает `Foo` виртуальным подклассом `MyIterable`, даже если он не определяет метод [`__iter__()`](https://python-all.ru/3.14/reference/datamodel.html#object.__iter__) (он использует старый протокол итерирования, определённый через [`__len__()`](https://python-all.ru/3.14/reference/datamodel.html#object.__len__) и [`__getitem__()`](https://python-all.ru/3.14/reference/datamodel.html#object.__getitem__)). Обратите внимание, что это не сделает `get_iterator` доступным в качестве метода `Foo`, поэтому он предоставляется отдельно.

Модуль `abc` также предоставляет следующий декоратор:

#### `@abc.abstractmethod`

Декоратор, указывающий на абстрактные методы.

Использование этого декоратора требует, чтобы метакласс класса был [`ABCMeta`](https://python-all.ru/3.14/library/abc.html#abc.ABCMeta) или производным от него. Класс, метакласс которого является производным от `ABCMeta`, не может быть инстанцирован, если все его абстрактные методы и свойства не переопределены. Абстрактные методы можно вызывать с помощью любого из обычных механизмов вызова super. `abstractmethod()` может использоваться для объявления абстрактных методов для свойств и дескрипторов.

Динамическое добавление абстрактных методов в класс или попытка изменить статус абстрактности метода или класса после его создания поддерживаются только с помощью функции [`update_abstractmethods()`](https://python-all.ru/3.14/library/abc.html#abc.update_abstractmethods). `abstractmethod()` влияет только на подклассы, полученные с помощью обычного наследования; «виртуальные подклассы», зарегистрированные методом [`register()`](https://python-all.ru/3.14/library/abc.html#abc.ABCMeta.register) ABC, не затрагиваются.

Когда `abstractmethod()` применяется в комбинации с другими дескрипторами методов, он должен применяться как самый внутренний декоратор, как показано в следующих примерах использования:

```python
class C(ABC):
    @abstractmethod
    def my_abstract_method(self, arg1):
        ...
    @classmethod
    @abstractmethod
    def my_abstract_classmethod(cls, arg2):
        ...
    @staticmethod
    @abstractmethod
    def my_abstract_staticmethod(arg3):
        ...

    @property
    @abstractmethod
    def my_abstract_property(self):
        ...
    @my_abstract_property.setter
    @abstractmethod
    def my_abstract_property(self, val):
        ...

    @abstractmethod
    def _get_x(self):
        ...
    @abstractmethod
    def _set_x(self, val):
        ...
    x = property(_get_x, _set_x)
```

Для корректной работы с механизмом абстрактных базовых классов дескриптор должен идентифицировать себя как абстрактный с помощью `__isabstractmethod__`. В общем случае этот атрибут должен быть `True`, если хотя бы один из методов, используемых для составления дескриптора, является абстрактным. Например, встроенный [`property`](https://python-all.ru/3.14/library/functions.html#property) языка Python делает следующее:

```python
class Descriptor:
    ...
    @property
    def __isabstractmethod__(self):
        return any(getattr(f, '__isabstractmethod__', False) for
                   f in (self._fget, self._fset, self._fdel))
```

> **Примечание**
>
> В отличие от абстрактных методов Java, эти абстрактные методы могут иметь реализацию. Эту реализацию можно вызвать через механизм [`super()`](https://python-all.ru/3.14/library/functions.html#super) из класса, который её переопределяет. Это может быть полезно как конечная точка для вызова super в среде, использующей кооперативное множественное наследование.

Модуль `abc` также поддерживает следующие устаревшие декораторы:

#### `@abc.abstractclassmethod`

Добавлено в версии 3.2.

Устарело с версии 3.3: Теперь можно использовать [`classmethod`](https://python-all.ru/3.14/library/functions.html#classmethod) с\\n[`abstractmethod()`](https://python-all.ru/3.14/library/abc.html#abc.abstractmethod), что делает этот декоратор избыточным.

Подкласс встроенного [`classmethod()`](https://python-all.ru/3.14/library/functions.html#classmethod), указывающий на абстрактный метод класса. В остальном аналогичен [`abstractmethod()`](https://python-all.ru/3.14/library/abc.html#abc.abstractmethod).

Этот частный случай устарел, так как декоратор [`classmethod()`](https://python-all.ru/3.14/library/functions.html#classmethod) теперь корректно определяется как абстрактный при применении к абстрактному методу:

```python
class C(ABC):
    @classmethod
    @abstractmethod
    def my_abstract_classmethod(cls, arg):
        ...
```

#### `@abc.abstractstaticmethod`

Добавлено в версии 3.2.

Устарело с версии 3.3: Теперь можно использовать [`staticmethod`](https://python-all.ru/3.14/library/functions.html#staticmethod) с\\n[`abstractmethod()`](https://python-all.ru/3.14/library/abc.html#abc.abstractmethod), что делает этот декоратор избыточным.

Подкласс встроенного [`staticmethod()`](https://python-all.ru/3.14/library/functions.html#staticmethod), указывающий на абстрактный статический метод. В остальном аналогичен [`abstractmethod()`](https://python-all.ru/3.14/library/abc.html#abc.abstractmethod).

Этот частный случай устарел, так как декоратор [`staticmethod()`](https://python-all.ru/3.14/library/functions.html#staticmethod) теперь корректно определяется как абстрактный при применении к абстрактному методу:

```python
class C(ABC):
    @staticmethod
    @abstractmethod
    def my_abstract_staticmethod(arg):
        ...
```

#### `@abc.abstractproperty`

Устарело с версии 3.3: Теперь можно использовать [`property`](https://python-all.ru/3.14/library/functions.html#property), [`property.getter()`](https://python-all.ru/3.14/library/functions.html#property.getter),\\n[`property.setter()`](https://python-all.ru/3.14/library/functions.html#property.setter) и [`property.deleter()`](https://python-all.ru/3.14/library/functions.html#property.deleter) с\\n[`abstractmethod()`](https://python-all.ru/3.14/library/abc.html#abc.abstractmethod), что делает этот декоратор избыточным.

Подкласс встроенного [`property()`](https://python-all.ru/3.14/library/functions.html#property), указывающий на абстрактное свойство.

Этот частный случай устарел, так как декоратор [`property()`](https://python-all.ru/3.14/library/functions.html#property) теперь корректно определяется как абстрактный при применении к абстрактному методу:

```python
class C(ABC):
    @property
    @abstractmethod
    def my_abstract_property(self):
        ...
```

В приведённом выше примере определяется свойство только для чтения; можно также определить абстрактное свойство для чтения и записи, пометив один или несколько базовых методов как абстрактные.

```python
class C(ABC):
    @property
    def x(self):
        ...

    @x.setter
    @abstractmethod
    def x(self, val):
        ...
```

Если абстрактны только некоторые компоненты, то для создания конкретного свойства в подклассе нужно обновить только эти компоненты.

```python
class D(C):
    @C.x.setter
    def x(self, val):
        ...
```

Модуль `abc` также предоставляет следующие функции:

#### `abc.get_cache_token()`

Возвращает текущий токен кэша абстрактных базовых классов.

Токен – это непрозрачный объект (поддерживающий проверку на равенство), идентифицирующий текущую версию кэша абстрактных базовых классов для виртуальных подклассов. Токен изменяется при каждом вызове [`ABCMeta.register()`](https://python-all.ru/3.14/library/abc.html#abc.ABCMeta.register) для любого ABC.

Добавлено в версии 3.4.

#### `abc.update_abstractmethods(cls)`

Функция для пересчёта статуса абстракции абстрактного класса. Эта функция должна вызываться, если абстрактные методы класса были реализованы или изменены после его создания. Обычно эта функция должна вызываться внутри декоратора класса.

Возвращает *cls*, чтобы обеспечить использование в качестве декоратора класса.

Если *cls* не является экземпляром [`ABCMeta`](https://python-all.ru/3.14/library/abc.html#abc.ABCMeta), ничего не делает.

> **Примечание**
>
> Эта функция предполагает, что суперклассы *cls* уже обновлены. Она не обновляет никакие подклассы.

Добавлено в версии 3.10.

Сноски

\[[1](https://python-all.ru/3.14/library/abc.html#id1)\]

Программистам на C++ следует отметить, что концепция виртуального базового класса в Python отличается от C++.