"Python Metaclasses Tutorial: When to Use Them (and Not)"
"This Python metaclasses tutorial goes beyond the 'classes that create classes' slogan: you'll write a working metaclass, build a plugin registry, learn the type.__new__ vs __init__ split — and learn why __init_subclass__ and class decorators should be your first choice 90% of the time."
Here's the most honest opening any Python metaclasses tutorial can give you: you probably don't need metaclasses. The simpler tools — __init_subclass__ and class decorators — handle roughly 90% of the jobs people reach for metaclasses to do, with a fraction of the confusion. So this guide has a contrarian mission: I'll show you how metaclasses work by writing real ones, and at every step I'll show you the simpler alternative, so that on the rare day you genuinely need a metaclass, you'll know exactly why nothing else would do. What you'll learn in this Python metaclasses tutorial What type really does when you write a class statement — and why classes are objects too How to write your first metaclass, and the critical __new__ vs __init__ split inside it The plugin registry pattern : the one metaclass-powered design you'll actually encounter in the wild How __call__ on a metaclass intercepts instance creation (the singleton trick) The three-way decision table: metaclass vs __init_subclass__ vs class decorator The common metaclass mistakes — conflicts, forgotten super() calls, shared state bugs — and their fixes When frameworks (Django, SQLAlchemy, abc , enum ) legitimately use metaclasses, and why your application code almost never should Everything is an object — even your classes In Python, everything is an object — including classes themselves. When you write a class statement, Python *calls* something to build the class object. By default, that something is type : # These two are equivalent: class Foo: x = 1 Foo = type("Foo", (), {"x": 1}) print(Foo.x) # 1 print(type(Foo)) # <class 'type'> print(type(type)) # <class 'type'> — type is its own metaclass type(name, bases, namespace) takes the class name, the parent…