All 15 Metaclasses & Class Customization questions
More in Metaclasses & Class Customization
What is the difference between a class decorator and a metaclass for customizing class behavior? How does __set_name__ let a descriptor discover the attribute name it's assigned to within a class? What is the practical difference between isinstance(obj, cls) and type(obj) is cls, particularly regarding metaclasses and inheritance? How do you write a custom metaclass by subclassing type, and when would you do so? How do abstract base classes (ABCs) use a metaclass to enforce that subclasses implement required methods? Why can't you freely mix two classes with different, incompatible metaclasses in multiple inheritance? How can a metaclass be used to implement the Singleton design pattern more robustly than overriding __new__ alone? How does __instancecheck__ and __subclasscheck__ on a metaclass enable 'virtual subclassing' as used by collections.abc?
Advertisement
Python › Metaclasses & Class Customization

How does __class_getitem__ enable generic-looking syntax like MyClass[int]?

Advanced

Answer

__class_getitem__(cls, item) is called when you subscript a class itself (not an instance), like `list[int]` or a custom `Container[str]`. It's primarily used to support type-hint syntax for generic classes without requiring inheritance from typing.Generic, returning a types.GenericAlias or custom object representing the parameterized type.
class Container:
    def __class_getitem__(cls, item):
        return f'{cls.__name__}[{item.__name__}]'

print(Container[int])  # 'Container[int]'
print(list[int])       # list[int] -- built-in generics support this too
Real-world example A typed collections library implements __class_getitem__ so users can write `Stack[int]` for type hints and IDE autocompletion without needing to inherit from typing.Generic explicitly.

Common follow-ups: How does this differ from typing.Generic's __class_getitem__?;Why was this added in PEP 560?

Data Types & Structures;Magic Methods & Operator Overloading
All 15 Metaclasses & Class Customization questions