5.3. Creating Custom Metaclasses

You can define your own metaclass to control how classes are created.

A metaclass is typically a subclass of type:

class Meta(type):
    def __new__(cls, name, bases, dct):
        print(f"Creating class: {name}")
        dct['created_by'] = 'MetaClass'
        return super().__new__(cls, name, bases, dct)

In Python, a metaclass serves the purpose of customizing class creation. You can create your own metaclass by subclassing the built-in type. In this example, the Meta class overrides the __new__ method, which is responsible for creating new class objects. Inside this method, you can add attributes or perform actions before the class is fully constructed. Here, the __new__ method prints the name of the class being created and adds a new attribute called created_by to the class dictionary.

Think of a metaclass like the architect of a building. Just as an architect designs the layout and ensures that the construction meets specific requirements, a metaclass designs how a class should structure itself when it's created. If you want to include specific features or characteristics in every class (like specifying who created it), you can manage that through a metaclass.

You attach it to a class using the metaclass keyword:

class MyClass(metaclass=Meta):
    pass
print(MyClass.created_by)  # Output: MetaClass

To use the custom metaclass you defined, you specify it in the class definition with the metaclass keyword. In this case, MyClass is created using Meta as its metaclass. When you examine MyClass, you can see the new attribute created_by which was added by the metaclass, showing that the custom logic within Meta was executed during the class creation.

Returning to our architect analogy, using a metaclass is like hiring a specialized architect to design a unique type of building that always carries a particular signature. In this case, all buildings (classes) created by this architect (metaclass) will have the same signature or feature (the created_by attribute), which helps identify the source or standards of construction.

The new method:

• Receives the class name, its base classes, and its dictionary.
• Can modify or add to the class dictionary before the class is created.

The __new__ method is a critical part of metaclass functionality; it is called when a new instance of a class is created. This method receives three parameters: cls (the metaclass itself), name (the name of the new class), bases (any parent classes the new class inherits from), and dct (the dictionary containing class attributes and methods). You have the ability to modify the dct dictionary to include additional attributes or methods before the actual class is created.

Think of __new__ as the blueprint that the architect uses before the building is constructed. It can add extra rooms or features to the original design before the construction starts, ensuring that everything is aligned with the intended design.

--