Metaclass tự động đăng ký Plugin và kiểm tra Interface bắt buộc

Mục tiêu kiến thức

• Hiểu vòng đời tạo lớp với __new__ của Metaclass kế thừa từ type.
• Triển khai kiến trúc Plugin tự đăng ký (Self-registering Plugin Architecture).
• Kiểm tra tính hợp lệ của interface ngay tại thời điểm định nghĩa lớp (Class Definition Time) trước khi khởi tạo instance.

Mô tả bài toán

Viết một metaclass PluginMeta(type):

• Duy trì một từ điển tĩnh registry: dict[str, type] lưu danh sách các plugin đã đăng ký theo tên khóa là thuộc tính plugin_name.
• Khi một lớp con được định nghĩa:
• Nếu lớp đó là lớp cơ sở BasePlugin (chưa có plugin_name hoặc là lớp đầu tiên kế thừa từ metaclass=PluginMeta), bỏ qua kiểm tra interface.
• Với các lớp dẫn xuất (subclasses):
• Bắt buộc phải có thuộc tính lớp plugin_name: str. Nếu thiếu hoặc rỗng, raise TypeError(f"Lop '{name}' phai dinh nghia 'plugin_name'").
• Nếu plugin_name đã tồn tại trong registry, raise ValueError(f"Plugin '{plugin_name}' da duoc dang ky truoc do").
• Bắt buộc phải cài đặt hai phương thức: run(self, data: dict) -> dict và get_version(self) -> str. Nếu thiếu một trong hai, raise TypeError(f"Lop '{name}' thieu phuong thuc bat buoc").
• Tự động đăng ký lớp vào PluginMeta.registry[cls.plugin_name] = cls.
• Cung cấp phương thức lớp:
• PluginMeta.get_plugin(cls, name: str) -> type: Trả về lớp plugin đã đăng ký hoặc raise KeyError(f"Khong tim thay plugin '{name}'").
• PluginMeta.list_plugins(cls) -> list[str]: Trả về danh sách tên các plugin đã đăng ký sắp xếp theo thứ tự bảng chữ cái.
• PluginMeta.clear_registry(cls): Xóa sạch registry (hỗ trợ kiểm thử).

Ràng buộc

• Thời gian chạy tối đa: 1000ms.
• Giới hạn bộ nhớ: 256MB.
• Dữ liệu đầu vào tuân thủ đúng kiểu dữ liệu và miền giá trị được mô tả.