class Circle:
    def __init__(self, radius: float):
        self.radius = radius  # 基礎(chǔ)屬性

    @property
    def area(self) -> float:
        """計(jì)算面積（只讀屬性），無需調(diào)用方法，直接訪問"""
        return 3.1415926 * self.radius **2

# 使用：像訪問普通屬性一樣調(diào)用，無需加 ()
c = Circle(5)
print(c.area)  # 輸出：78.539815
# 嘗試賦值會報(bào)錯(cuò)（只讀屬性）
# c.area = 100  # AttributeError: can't set attribute

class Person:
    def __init__(self, name: str, age: int):
        self.name = name
        self._age = age  # 下劃線前綴：約定俗成的「私有變量」（Python 無真正私有）

    @property
    def age(self) -> int:
        """getter：讀取年齡"""
        return self._age

    @age.setter
    def age(self, value: int):
        """setter：賦值時(shí)驗(yàn)證數(shù)據(jù)合法性"""
        # 類型校驗(yàn)
        if not isinstance(value, int):
            raise TypeError("年齡必須是整數(shù)")
        # 范圍校驗(yàn)
        if value < 0 or value > 150:
            raise ValueError("年齡必須在 0-150 之間")
        self._age = value

# 使用：賦值時(shí)自動觸發(fā) setter 校驗(yàn)
p = Person("Alice", 20)
print(p.age)  # 20（觸發(fā) getter）
p.age = 25    # 合法賦值（觸發(fā) setter）
# p.age = "30"  # 觸發(fā) TypeError
# p.age = 200   # 觸發(fā) ValueError

class Person:
    # （繼承上面的 __init__、age getter/setter）
    @age.deleter
    def age(self):
        """deleter：刪除屬性時(shí)執(zhí)行的邏輯"""
        print("刪除年齡屬性...")
        del self._age

# 使用：刪除屬性觸發(fā) deleter
p = Person("Bob", 30)
del p.age  # 輸出：刪除年齡屬性...
# 此時(shí)訪問 p.age 會報(bào)錯(cuò)（_age 已被刪除）
# print(p.age)  # AttributeError: 'Person' object has no attribute '_age'

class Student(Person):
    @property
    def age(self):
        """重寫 getter：添加學(xué)生年齡的額外提示"""
        print(f"學(xué)生 {self.name} 的年齡：")
        return super().age  # 調(diào)用父類的 getter

    @age.setter
    def age(self, value):
        """重寫 setter：添加學(xué)生年齡的特殊校驗(yàn)"""
        if value < 6 or value > 30:
            raise ValueError("學(xué)生年齡應(yīng)在 6-30 之間")
        super(Student, Student).age.fset(self, value)  # 調(diào)用父類的 setter

# 測試
s = Student("Charlie", 18)
print(s.age)  # 輸出：學(xué)生 Charlie 的年齡：18
s.age = 35    # 觸發(fā) ValueError

import functools

class DataProcessor:
    def __init__(self, raw_data: list[int]):
        self.raw_data = raw_data

    @property
    @functools.lru_cache(maxsize=None)  # 緩存方法結(jié)果
    def processed_data(self) -> list[int]:
        """模擬昂貴的計(jì)算：僅首次調(diào)用時(shí)計(jì)算，后續(xù)直接返回緩存"""
        print("執(zhí)行昂貴計(jì)算...")
        return [x * 2 + 1 for x in self.raw_data]

# 測試
dp = DataProcessor([1, 2, 3, 4])
print(dp.processed_data)  # 輸出：執(zhí)行昂貴計(jì)算... [3, 5, 7, 9]
print(dp.processed_data)  # 直接返回緩存，無打印

class Person:
    def __init__(self, age: int):
        self._age = age

    # 定義 getter/setter/deleter 方法
    def get_age(self):
        return self._age

    def set_age(self, value):
        if value < 0:
            raise ValueError("年齡不能為負(fù)")
        self._age = value

    def del_age(self):
        del self._age

    # 手動創(chuàng)建 property 對象：property(fget, fset, fdel, doc)
    age = property(get_age, set_age, del_age, "年齡屬性，支持校驗(yàn)")

# 使用方式與裝飾器一致
p = Person(20)
print(p.age)  # 20
p.age = 25    # 合法