Metaclasses & __init_subclass__ in Python0%

Metaclasses & __init_subclass__ in Python

Advanced11 min read•Updated: 2026-10-23

🐍 Metaclasses & __init_subclass__

In Python, everything is an object—including classes themselves!

Just as an object is an instance of a class, a class is an instance of a Metaclass.

Understanding how classes are constructed in memory allows you to build powerful frameworks (like Django's ORM, SQLAlchemy, or Pydantic) that intercept class creation, validate attributes, and automatically register plugins.

🧬 1. The Default Metaclass: `type`

When you write class User: ..., Python doesn't just execute the block; it passes the class name, bases, and dictionary of attributes to the built-in metaclass type:

1# Creating a class dynamically using type(name, bases, dict):
2def speak(self):
3    return f"Hello, my name is {self.name}"
4 
5Student = type("Student", (), {"name": "Aarav", "speak": speak})
6 
7s = Student()
8print(type(Student)) # <class 'type'>
9print(s.speak())     # Hello, my name is Aarav

⚙️ 2. Writing a Custom Metaclass

A custom metaclass inherits from type. It intercepts the creation of a class before it enters the global namespace:

1class EnforceSnakeCaseMeta(type):
2    def __new__(cls, name, bases, dct):
3        # Inspect all defined methods:
4        for attr_name in dct:
5            if not attr_name.startswith("__") and callable(dct[attr_name]):
6                if any(c.isupper() for c in attr_name):
7                    raise TypeError(f"Method '{attr_name}' in class '{name}' must be snake_case!")
8        return super().__new__(cls, name, bases, dct)
9 
10# Using the metaclass:
11class ValidService(metaclass=EnforceSnakeCaseMeta):
12    def compute_fees(self): # ✅ Valid snake_case
13        pass
14 
15# ❌ TypeError: Method 'ComputeFees' in class 'InvalidService' must be snake_case!
16# class InvalidService(metaclass=EnforceSnakeCaseMeta):
17#     def ComputeFees(self):
18#         pass

🚀 3. The Modern Alternative: `__init_subclass__` (PEP 487)

Writing full metaclasses is complex and frequently leads to multiple-metaclass inheritance conflicts.

Python 3.6 introduced __init_subclass__ (PEP 487). It provides 95% of the power of metaclasses with zero metaclass boilerplate!

1class PluginBase:
2    registry: dict[str, type] = {}
3 
4    def __init_subclass__(cls, plugin_name: str, **kwargs):
5        super().__init_subclass__(**kwargs)
6        # Automatically register any child class that inherits from PluginBase:
7        cls.registry[plugin_name] = cls
8        print(f"Registered plugin: '{plugin_name}' -> {cls.__name__}")
9 
10# Subclasses simply declare custom kwargs in their inheritance header:
11class PDFExportPlugin(PluginBase, plugin_name="pdf"):
12    pass
13 
14class ExcelExportPlugin(PluginBase, plugin_name="excel"):
15    pass
16 
17print("Available Plugins in Registry:", list(PluginBase.registry.keys()))
18# ['pdf', 'excel']

Interactive Quiz• Knowledge Check

Practice Quiz

Question 1

In Python's object model, what is the default metaclass of all standard classes?

Question 2

Which method in a custom metaclass is responsible for allocating and creating the new class object?

Question 3

Which PEP introduced __init_subclass__ as a simpler alternative to custom metaclasses?

Question 4

When does the __init_subclass__ method execute?

Question 5

Why is __init_subclass__ preferred over full metaclasses for class registration?

🚀 What's Next?

In the next lesson, we will integrate our advanced OOP skills to build Project: Employee Management System (1: Advanced OOP Concepts).

👉 Continue to Next Lesson: Project: Employee Management System →

Next Lesson

Project: Employee Management System

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous Lesson	Next Lesson
Abstract Base Classes (abc.ABC) and Protocols for Structural Subtyping	Project: Employee Management System

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

Previous Next

PreviousPrevNext

MSK Institute • Shikohabad

Loading Page Content...

Preparing courses, live labs, and learning resources.सामग्री लोड हो रही है, कृपया प्रतीक्षा करें...

Connecting serverPlease wait...

💻 Practical Labs🚀 Free Demo📜 Verified Certificates

Project: Employee Management System

Metaclasses & __init_subclass__ in Python

Advanced11 min read•Updated: 2026-10-23

Study Materials Cheatsheet

🐍 Metaclasses & __init_subclass__

In Python, everything is an object—including classes themselves!

Just as an object is an instance of a class, a class is an instance of a Metaclass.

🧬 1. The Default Metaclass: `type`

When you write class User: ..., Python doesn't just execute the block; it passes the class name, bases, and dictionary of attributes to the built-in metaclass type:

1# Creating a class dynamically using type(name, bases, dict):
2def speak(self):
3    return f"Hello, my name is {self.name}"
4 
5Student = type("Student", (), {"name": "Aarav", "speak": speak})
6 
7s = Student()
8print(type(Student)) # <class 'type'>
9print(s.speak())     # Hello, my name is Aarav

⚙️ 2. Writing a Custom Metaclass

A custom metaclass inherits from type. It intercepts the creation of a class before it enters the global namespace:

1class EnforceSnakeCaseMeta(type):
2    def __new__(cls, name, bases, dct):
3        # Inspect all defined methods:
4        for attr_name in dct:
5            if not attr_name.startswith("__") and callable(dct[attr_name]):
6                if any(c.isupper() for c in attr_name):
7                    raise TypeError(f"Method '{attr_name}' in class '{name}' must be snake_case!")
8        return super().__new__(cls, name, bases, dct)
9 
10# Using the metaclass:
11class ValidService(metaclass=EnforceSnakeCaseMeta):
12    def compute_fees(self): # ✅ Valid snake_case
13        pass
14 
15# ❌ TypeError: Method 'ComputeFees' in class 'InvalidService' must be snake_case!
16# class InvalidService(metaclass=EnforceSnakeCaseMeta):
17#     def ComputeFees(self):
18#         pass

🚀 3. The Modern Alternative: `__init_subclass__` (PEP 487)

Writing full metaclasses is complex and frequently leads to multiple-metaclass inheritance conflicts.

Python 3.6 introduced __init_subclass__ (PEP 487). It provides 95% of the power of metaclasses with zero metaclass boilerplate!

1class PluginBase:
2    registry: dict[str, type] = {}
3 
4    def __init_subclass__(cls, plugin_name: str, **kwargs):
5        super().__init_subclass__(**kwargs)
6        # Automatically register any child class that inherits from PluginBase:
7        cls.registry[plugin_name] = cls
8        print(f"Registered plugin: '{plugin_name}' -> {cls.__name__}")
9 
10# Subclasses simply declare custom kwargs in their inheritance header:
11class PDFExportPlugin(PluginBase, plugin_name="pdf"):
12    pass
13 
14class ExcelExportPlugin(PluginBase, plugin_name="excel"):
15    pass
16 
17print("Available Plugins in Registry:", list(PluginBase.registry.keys()))
18# ['pdf', 'excel']

Interactive Quiz• Knowledge Check

Practice Quiz

Question 1

In Python's object model, what is the default metaclass of all standard classes?

Question 2

Which method in a custom metaclass is responsible for allocating and creating the new class object?

Question 3

Which PEP introduced __init_subclass__ as a simpler alternative to custom metaclasses?

Question 4

When does the __init_subclass__ method execute?

Question 5

Why is __init_subclass__ preferred over full metaclasses for class registration?

🚀 What's Next?

In the next lesson, we will integrate our advanced OOP skills to build Project: Employee Management System (1: Advanced OOP Concepts).

👉 Continue to Next Lesson: Project: Employee Management System →

Next Lesson

Project: Employee Management System

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous Lesson	Next Lesson
Abstract Base Classes (abc.ABC) and Protocols for Structural Subtyping	Project: Employee Management System

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

Previous Next

🐍 Metaclasses & __init_subclass__

🧬 1. The Default Metaclass: type

⚙️ 2. Writing a Custom Metaclass

🚀 3. The Modern Alternative: __init_subclass__ (PEP 487)

Practice Quiz

🚀 What's Next?

Project: Employee Management System

Related Lessons

Practice Quiz

Loading Page Content...

🐍 Metaclasses & __init_subclass__

🧬 1. The Default Metaclass: type

⚙️ 2. Writing a Custom Metaclass

🚀 3. The Modern Alternative: __init_subclass__ (PEP 487)

Practice Quiz

🚀 What's Next?

Project: Employee Management System

Related Lessons

Practice Quiz

🧬 1. The Default Metaclass: `type`

🚀 3. The Modern Alternative: `__init_subclass__` (PEP 487)

🧬 1. The Default Metaclass: `type`

🚀 3. The Modern Alternative: `__init_subclass__` (PEP 487)