Add python-metaclasses materials for the Python Metaclasses tutorial

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: realpython-bot

python-metaclasses/README.md

@@ -0,0 +1,11 @@
+# Python Metaclasses
+
+This folder provides the code examples for the Real Python tutorial [Python Metaclasses](https://realpython.com/python-metaclasses/).
+
+The tutorial demonstrates its examples in the interactive interpreter, so each
+REPL sequence is collected here as a runnable script that prints the output the
+tutorial shows. Run any of them with Python 3.14:
+
+```sh
+$ python custom_metaclass.py
+```

python-metaclasses/class_decorator.py

@@ -0,0 +1,25 @@
+def decorator(cls):
+    class NewClass(cls):
+        attr = 100
+
+    return NewClass
+
+
+@decorator
+class X:
+    pass
+
+
+@decorator
+class Y:
+    pass
+
+
+@decorator
+class Z:
+    pass
+
+
+print(X.attr)
+print(Y.attr)
+print(Z.attr)

python-metaclasses/class_factory.py

@@ -0,0 +1,24 @@
+class Meta(type):
+    def __init__(cls, name, bases, dct):
+        cls.attr = 100
+
+
+class X(metaclass=Meta):
+    pass
+
+
+print(X.attr)
+
+
+class Y(metaclass=Meta):
+    pass
+
+
+print(Y.attr)
+
+
+class Z(metaclass=Meta):
+    pass
+
+
+print(Z.attr)

python-metaclasses/custom_metaclass.py

@@ -0,0 +1,23 @@
+class Meta(type):
+    def __new__(cls, name, bases, dct):
+        x = super().__new__(cls, name, bases, dct)
+        x.attr = 100
+        return x
+
+
+class Foo(metaclass=Meta):
+    pass
+
+
+print(Foo.attr)
+
+
+class Bar(metaclass=Meta):
+    pass
+
+
+class Qux(metaclass=Meta):
+    pass
+
+
+print((Bar.attr, Qux.attr))

python-metaclasses/custom_new_method.py

@@ -0,0 +1,17 @@
+class Foo:
+    pass
+
+
+def new(cls):
+    x = object.__new__(cls)
+    x.attr = 100
+    return x
+
+
+Foo.__new__ = new
+
+f = Foo()
+print(f.attr)
+
+g = Foo()
+print(g.attr)

python-metaclasses/dynamic_class_example_1.py

@@ -0,0 +1,14 @@
+# Defining the class dynamically with type()
+Foo = type("Foo", (), {})
+
+x = Foo()
+print(x)
+
+
+# The same class defined the usual way, with the class statement
+class Foo:
+    pass
+
+
+x = Foo()
+print(x)

python-metaclasses/dynamic_class_example_2.py

@@ -0,0 +1,21 @@
+# Foo comes from Example 1
+Foo = type("Foo", (), {})
+
+# Defining the class dynamically with type()
+Bar = type("Bar", (Foo,), dict(attr=100))
+
+x = Bar()
+print(x.attr)
+print(x.__class__)
+print(x.__class__.__bases__)
+
+
+# The same class defined the usual way, with the class statement
+class Bar(Foo):
+    attr = 100
+
+
+x = Bar()
+print(x.attr)
+print(x.__class__)
+print(x.__class__.__bases__)

python-metaclasses/dynamic_class_example_3.py

@@ -0,0 +1,19 @@
+# Defining the class dynamically with type()
+Foo = type("Foo", (), {"attr": 100, "attr_val": lambda x: x.attr})
+
+x = Foo()
+print(x.attr)
+print(x.attr_val())
+
+
+# The same class defined the usual way, with the class statement
+class Foo:
+    attr = 100
+
+    def attr_val(self):
+        return self.attr
+
+
+x = Foo()
+print(x.attr)
+print(x.attr_val())

python-metaclasses/dynamic_class_example_4.py

@@ -0,0 +1,21 @@
+def f(obj):
+    print("attr =", obj.attr)
+
+
+# Defining the class dynamically with type()
+Foo = type("Foo", (), {"attr": 100, "attr_val": f})
+
+x = Foo()
+print(x.attr)
+x.attr_val()
+
+
+# The same class defined the usual way, with the class statement
+class Foo:
+    attr = 100
+    attr_val = f
+
+
+x = Foo()
+print(x.attr)
+x.attr_val()

python-metaclasses/new_style_classes.py

@@ -0,0 +1,15 @@
+class Foo:
+    pass
+
+
+obj = Foo()
+print(obj.__class__)
+print(type(obj))
+print(obj.__class__ is type(obj))
+
+n = 5
+d = {"x": 1, "y": 2}
+x = Foo()
+
+for obj in (n, d, x):
+    print(type(obj) is obj.__class__)