Объекты для аннотирования типов

Предоставляются различные встроенные типы для аннотирования типов. В настоящее время существуют два типа — GenericAlias и Union. Только GenericAlias доступен в C.

PyObject *Py_GenericAlias(PyObject *origin, PyObject *args)

Входит в стабильный ABI начиная с версии 3.9.

Создаёт объект GenericAlias. Эквивалентно вызову класса Python types.GenericAlias. Аргументы origin и args задают соответственно атрибуты __origin__ и __args__ объекта GenericAlias. origin должен быть PyTypeObject*, а args может быть PyTupleObject* или любым PyObject*. Если переданный args не является кортежем, автоматически создаётся кортеж из одного элемента, а __args__ устанавливается в (args,). Проверка аргументов выполняется минимальная, поэтому функция успешно завершится, даже если origin не является типом. Атрибут __parameters__ объекта GenericAlias создаётся лениво на основе __args__. В случае ошибки возбуждается исключение и возвращается NULL.

Ниже приведён пример того, как сделать тип расширения обобщённым:

...
static PyMethodDef my_obj_methods[] = {
    // Other methods.
    ...
    {"__class_getitem__", Py_GenericAlias, METH_O|METH_CLASS, "my_obj is generic over its contained type"}
    ...
}

См. также

Метод модели данных __class_getitem__().

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

PyTypeObject Py_GenericAliasType

Входит в стабильный ABI начиная с версии 3.9.

Тип C объекта, возвращаемого Py_GenericAlias(). Эквивалентен types.GenericAlias в Python.

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