Как точно определить тип dict_itemiterator в Python

Показываем, как определить dict_itemiterator в Python без публичного имени: вычислить type(iter(dict.items())) и безопасно использовать isinstance. Примеры.

Как точно определить dict_itemiterator в Python: практическое руководство

Иногда сторонняя библиотека передаёт объект, который не относится к привычным публичным типам. Классический пример — dict_itemiterator: итератор по парам ключ/значение, который получается при вызове iter на dict.items(). Если в вашем конвейере обработка ветвится по конкретным видам итераторов, имеет смысл проверять именно этот тип, а не общий Iterable.

Пример задачи

Предположим, внешний API возвращает dict_itemiterator. Нужна точная проверка isinstance:

# входящий объект из сторонней библиотеки
opaque_obj = iter({}.items())

items_iter_cls = type(iter({}.items()))

if isinstance(opaque_obj, items_iter_cls):
    print('Do stuff here...')

Проверка через typing.Iterable здесь слишком общая, потому что нужно подтвердить «итератор пар ключ/значение, полученный из dict.items()», а не любой итерируемый объект:

from typing import Iterable

isinstance(opaque_obj, Iterable)

Можно подумать и про ItemsView, но это представление, которое возвращает dict.items() до вызова iter; итератор, который создаёт iter(...), — другой, более узкий внутренний тип. Поэтому проверка на ItemsView не совпадёт с самим итератором.

Что происходит на самом деле

Тип dict_itemiterator не экспортируется в Python под публичным именем. Нет способа импортировать его напрямую. Поэтому самый прямой способ получить объект типа — создать показательный экземпляр и взять его тип через type(iter({}.items())).

Это не хак: стандартная библиотека применяет тот же приём для встроенных типов, не имеющих публичных имён. Например, модуль types выводит GeneratorType, создавая небольшой генератор и беря от него type:

def _probe_gen():
    yield 1
GenKind = type(_probe_gen())

Решение

Надёжный подход — вычислить тип dict_itemiterator во время выполнения и сохранить устойчивый псевдоним для проверок через isinstance. Это отражает практику stdlib, где канонические имена для внутренних типов получают схожим образом.

# Получите конкретный тип один раз и переиспользуйте псевдоним
DICT_ITEMS_ITER_T = type(iter({}.items()))

# В месте вашего кода, где приходит объект
incoming_stream = iter({}.items())

if isinstance(incoming_stream, DICT_ITEMS_ITER_T):
    print('Do stuff here...')

Так вы получите точное соответствие итератору, который возвращает iter(dict.items()), без обращения к общим ABC и без преобразований, создающих лишние объекты.

Зачем это важно

В конвейерах, обходящих разнородные структуры, корректность часто держится на диспетчеризации по конкретной семантике итераторов. dict_itemiterator выдаёт пары и двигает внутреннее состояние; это не то же самое, что представление или абстрактный Iterable. Точная проверка типа позволяет выбрать правильную логику обхода и избежать лишних преобразований, расходующих CPU и память.

Выводы

Если сторонняя библиотека возвращает dict_itemiterator, не ищите публичное имя для импорта — его нет. Получите тип через type(iter({}.items())) и закешируйте его под понятным псевдонимом. Это устоявшийся приём, который отражён и в стандартной библиотеке при работе с неэкспортируемыми встроенными типами вроде GeneratorType. Используйте узконаправленные проверки, когда требуется конкретное поведение итератора, и оставляйте широкие ABC вроде Iterable для случаев, когда подойдёт любой итерируемый объект.