Descriptor Protocol kiểm tra kiểu dữ liệu và phạm vi giá trị

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

• Hiểu và triển khai giao thức Python Descriptor (__get__, __set__, __set_name__).
• Tách biệt logic xác thực (validation) khỏi logic nghiệp vụ của lớp dữ liệu.
• Lưu trữ giá trị an toàn trong instance.__dict__ tránh rò rỉ bộ nhớ hoặc xung đột tên thuộc tính.

Mô tả bài toán

Viết lớp descriptor TypedRangeField:

• __init__(self, expected_type: type, min_val=None, max_val=None):
• expected_type: kiểu dữ liệu bắt buộc (ví dụ int, float, str).
• min_val, max_val: giá trị tối thiểu / tối đa cho phép (nếu None tức không giới hạn).
• __set_name__(self, owner, name):
• Tự động bắt tên thuộc tính gán trong lớp chủ sở hữu (self.name = name).
• __get__(self, instance, owner=None):
• Nếu truy cập từ lớp (instance is None), trả về chính descriptor self.
• Nếu truy cập từ instance, trả về giá trị lưu trong instance.__dict__[self.name]. Nếu chưa được thiết lập, raise AttributeError(f"'{owner.__name__}' object has no attribute '{self.name}'").
• __set__(self, instance, value):
• Kiểm tra isinstance(value, self.expected_type). Nếu sai, raise TypeError(f"Truong '{self.name}' yeu cau kieu {self.expected_type.__name__}, nhan {type(value).__name__}").
• Nếu min_val is not None và value < min_val, raise ValueError(f"Gia tri {value} nho hon min {min_val}").
• Nếu max_val is not None và value > max_val, raise ValueError(f"Gia tri {value} lon hon max {max_val}").
• Nếu hợp lệ, lưu vào instance.__dict__[self.name] = value.

Đồng thời định nghĩa lớp Product:

class Product:
    name = TypedRangeField(str)
    price = TypedRangeField((int, float), min_val=0)
    stock = TypedRangeField(int, min_val=0, max_val=10000)

    def __init__(self, name: str, price: float, stock: int):
        self.name = name
        self.price = price
        self.stock = stock

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ả.