Property ها در پایتون: مفاهیم متوسط

در پایتون، Property ها ابزاری قدرتمند برای کنترل دسترسی به ویژگی‌های یک کلاس هستند. آن‌ها به شما امکان می‌دهند تا رفتار خواندن، نوشتن و حذف یک ویژگی را سفارشی کنید، بدون اینکه نحوه دسترسی به آن را برای کاربرانی که از کلاس شما استفاده می‌کنند، تغییر دهید. این مقاله به بررسی عمیق Property ها، مزایا، نحوه پیاده‌سازی و کاربردهای آن‌ها می‌پردازد.

چرا از Property ها استفاده کنیم؟

استفاده از Property ها چندین مزیت کلیدی دارد:

• Encapsulation (کپسوله‌سازی): Property ها به شما کمک می‌کنند تا جزئیات پیاده‌سازی داخلی کلاس را پنهان کنید و از دسترسی مستقیم به ویژگی‌ها جلوگیری کنید. این امر باعث می‌شود که کلاس شما انعطاف‌پذیرتر و قابل نگهداری‌تر شود.
• Validation (اعتبارسنجی): می‌توانید از Property ها برای اعتبارسنجی داده‌هایی که در یک ویژگی تنظیم می‌شوند استفاده کنید. این امر به شما کمک می‌کند تا از ورود داده‌های نامعتبر به کلاس خود جلوگیری کنید.
• Computed Attributes (ویژگی‌های محاسبه‌شده): Property ها به شما امکان می‌دهند تا ویژگی‌هایی را تعریف کنید که مقدار آن‌ها بر اساس سایر ویژگی‌ها یا محاسبات پیچیده تعیین می‌شود.
• Backward Compatibility (سازگاری با نسخه‌های قبلی): اگر نیاز به تغییر نحوه پیاده‌سازی یک ویژگی دارید، می‌توانید از Property ها برای حفظ سازگاری با کدهای موجود استفاده کنید.

نحوه پیاده‌سازی Property ها

در پایتون، Property ها را می‌توان به دو روش اصلی پیاده‌سازی کرد:

1. استفاده از توابع getter، setter و deleter

این روش سنتی‌ترین راه برای پیاده‌سازی Property ها است. شما توابعی را تعریف می‌کنید که مسئول خواندن (getter)، نوشتن (setter) و حذف (deleter) مقدار یک ویژگی هستند. این توابع با استفاده از دکوراتور @property، @.setter و @.deleter به Property ها متصل می‌شوند.

class Circle:
    def __init__(self, radius):
        self._radius = radius

    @property
    def radius(self):
        """Getter for the radius attribute."""
        print("Getting radius...")
        return self._radius

    @radius.setter
    def radius(self, value):
        """Setter for the radius attribute."""
        print("Setting radius...")
        if value <= 0:
            raise ValueError("Radius must be positive.")
        self._radius = value

    @radius.deleter
    def radius(self):
        """Deleter for the radius attribute."""
        print("Deleting radius...")
        del self._radius

# Example usage
circle = Circle(5)
print(circle.radius)  # Output: Getting radius... 5
circle.radius = 10  # Output: Setting radius...
print(circle.radius)  # Output: Getting radius... 10
del circle.radius  # Output: Deleting radius...

در این مثال، _radius یک ویژگی خصوصی است که مقدار واقعی شعاع را ذخیره می‌کند. Property radius به عنوان واسطی برای دسترسی به این ویژگی عمل می‌کند. getter، setter و deleter به ترتیب مسئول خواندن، نوشتن و حذف مقدار _radius هستند. توجه داشته باشید که استفاده از پیشوند _ برای نام ویژگی‌ها در پایتون، نشان‌دهنده این است که این ویژگی‌ها به عنوان خصوصی در نظر گرفته می‌شوند و نباید مستقیماً از خارج کلاس دسترسی پیدا کرد.

2. استفاده از تابع property()

روش دوم استفاده از تابع داخلی property() است. این تابع یک Property را ایجاد می‌کند که به توابع getter، setter و deleter متصل می‌شود. این روش معمولاً برای Property های ساده‌تر استفاده می‌شود.

class Rectangle:
    def __init__(self, width, height):
        self._width = width
        self._height = height

    def get_width(self):
        print("Getting width...")
        return self._width

    def set_width(self, value):
        print("Setting width...")
        if value <= 0:
            raise ValueError("Width must be positive.")
        self._width = value

    def del_width(self):
        print("Deleting width...")
        del self._width

    width = property(get_width, set_width, del_width, "Width of the rectangle")

# Example usage
rectangle = Rectangle(4, 5)
print(rectangle.width)  # Output: Getting width... 4
rectangle.width = 8  # Output: Setting width...
print(rectangle.width)  # Output: Getting width... 8
del rectangle.width  # Output: Deleting width...

در این مثال، توابع get_width، set_width و del_width به ترتیب به عنوان getter، setter و deleter برای Property width استفاده می‌شوند. آرگومان چهارم تابع property() یک رشته مستند (docstring) است که برای Property تعریف می‌شود.

کاربردهای Property ها

Property ها در طیف گسترده‌ای از سناریوها کاربرد دارند. در اینجا چند مثال آورده شده است:

• محاسبه ویژگی‌ها: فرض کنید یک کلاس Person دارید که ویژگی‌های first_name و last_name را دارد. می‌توانید از یک Property برای محاسبه ویژگی full_name استفاده کنید که نام کامل شخص را برمی‌گرداند.
• تبدیل واحدها: فرض کنید یک کلاس Temperature دارید که دما را در درجه سانتیگراد ذخیره می‌کند. می‌توانید از Property ها برای ارائه دما در درجه فارنهایت یا کلوین استفاده کنید.
• کنترل دسترسی: فرض کنید یک کلاس BankAccount دارید که یک ویژگی balance دارد. می‌توانید از Property ها برای جلوگیری از برداشت بیش از حد از حساب یا واریز مبالغ منفی استفاده کنید.
• Logging (ثبت وقایع): می‌توانید از setter ها برای ثبت هر بار که یک ویژگی تغییر می‌کند استفاده کنید.

نکات مهم

• نام‌گذاری: به طور معمول، نام Property با نام ویژگی‌ای که کنترل می‌کند یکسان است.
• استفاده از ویژگی‌های خصوصی: همیشه از ویژگی‌های خصوصی (با پیشوند _) برای ذخیره داده‌های واقعی استفاده کنید و Property ها را به عنوان واسطی برای دسترسی به این داده‌ها ارائه دهید.
• Docstrings: همیشه برای Property ها و توابع getter، setter و deleter خود docstring های واضح و مختصر بنویسید.
• Performance (عملکرد): در حالی که Property ها ابزاری قدرتمند هستند، استفاده بیش از حد از آن‌ها می‌تواند منجر به کاهش عملکرد شود. فقط در مواردی که واقعاً به کنترل دسترسی یا اعتبارسنجی نیاز دارید، از آن‌ها استفاده کنید.

نتیجه‌گیری

Property ها یک ویژگی قدرتمند در پایتون هستند که به شما امکان می‌دهند تا رفتار ویژگی‌های یک کلاس را کنترل کنید و کدهای انعطاف‌پذیرتر، قابل نگهداری‌تر و امن‌تری ایجاد کنید. با درک نحوه پیاده‌سازی و استفاده از Property ها، می‌توانید از مزایای آن‌ها در پروژه‌های پایتون خود بهره‌مند شوید.