How does the @property decorator work in Python?

How does the @property decorator work in Python? Python allows attributes to be accessed directly, you can use the @property decorator, which is used to maintain control over class attributes. With the @property decorator, Python enthusiasts can transform ordinary methods into dynamic attributes, implement robust attribute validation, and enhance code readability.

1. Decorators in Python

Decorators in Python allow you to modify or extend the behavior of functions or methods without changing their source code. They are functions that wrap other functions or methods, adding extra functionality or behavior. Decorators are used in Python to implement cross-cutting concerns such as logging and authentication.

Decorators are functions that take another function as an argument and return a new function that usually extends or modifies the behavior of the original function. This is called “meta-programming” because decorators allow you to write code that can alter the behavior of other code.


# Creating a decorator for the add() function
def log_args(func):
    def wrapper(*args, **kwargs):
        result = func(*args, **kwargs)
        print(f"Args: {args}, result: {result}")
        return result
    return wrapper

@log_args
def add(a, b):
    return a + b


add(34,3)

# Output:
# Args: (34, 3), result: 37

2. The @property Decorator

The @property decorator is used to work with read-only attributes, also known as computed properties or getters. It allows you to define methods that act like attributes, enabling you to control access to class attributes, perform validation, and add custom logic whenever an attribute is accessed.

To understand how @property works, see the below example. Suppose we have a Person class with an attribute age, and we want to add some logic when accessing this attribute:


# A simple example of Property Decorator
class Person:
    def __init__(self, name, age):
        self._name = name
        self._age = age

    @property
    def age(self):
        return self._age

In the above example, we’ve defined a @property called age that acts as a getter method. When you access person.age, it returns the value of _age. The leading underscore (_age) is a convention to indicate that _age is intended to be a private attribute.

3. Getter and Setter Method with @property Decorator

One of the primary benefits of @property is the ability to define both a getter and a setter method for an attribute. In the below example we have enhanced our Person class to include a setter for the age attribute:


# Implementing getter and setter with @property decorator
class Person:
    def __init__(self, name, age):
        self._name = name
        self._age = age

    @property
    def age(self):
        return self._age

    @age.setter
    def age(self, new_age):
        if isinstance(new_age, int) and 0 <= new_age <= 120:
            self._age = new_age
        else:
            raise ValueError("Age must be an integer between 0 and 120.")

Now, you can not only get the age using person.age but also set it using person.age = new_age.

4. Encapsulation and Attribute Control

Encapsulation refers to the bundling of attributes and methods or functions that operate on that data into a single unit called a class. It enables data hiding and restricts direct access to an object’s internal state, promoting data integrity and code maintainability.

Python provides mechanisms for implementing encapsulation, and the @property decorator is a crucial part of this concept. See the below example how we have achieved encapsulation with the help of @property decorator.


# Achieving Encapsulation with @property Decorator
class TemperatureConverter:
    def __init__(self, celsius):
        self._celsius = celsius

    @property
    def celsius(self):
        return self._celsius

    @property
    def fahrenheit(self):
        return (self._celsius * 9/5) + 32

    @celsius.setter
    def celsius(self, value):
        if value < -273.15:
            raise ValueError(" cannot be below zero.")
        self._celsius = value

# Creating a temperature converter
converter = TemperatureConverter(25)

# Accessing temperature in Celsius and Fahrenheit
print(f"Celsius: {converter.celsius}°C")
print(f"Fahrenheit: {converter.fahrenheit}°F")

# Attempting to set an invalid temperature below zero
try:
    converter.celsius = -300
except ValueError as e:
    print(f"Error: {e}")

5. Computed Attributes with @property Decorator

Computed attributes allow you to dynamically calculate and provide values for attributes based on other attributes or internal logic. These attributes are not stored as data but are computed on-the-fly when accessed. They are often implemented using the @property decorator in Python,

They provide a way to expose values that are based on other attributes or require complex calculations without explicitly storing them.

See the below code example to understand how we can use it in computed attributes.


# The @property decorator for the Computed attributes
class Circle:
    def __init__(self, radius):
        self.radius = radius

    @property
    def diameter(self):
        return 2 * self.radius

    @property
    def area(self):
        return 3.14159 * self.radius**2

# Creating a circle
my_circle = Circle(5)

# Accessing computed attributes
print(f"Radius: {my_circle.radius}")
print(f"Diameter: {my_circle.diameter}")
print(f"Area: {my_circle.area}")

Computed attributes are particularly useful in scenarios where:

You want to maintain consistency and ensure that dependent attributes are always up-to-date.
Calculations involve complex or time-consuming operations.
You want to encapsulate the logic for attribute access.

6. Attribute Validation with @property Decorator

Attribute validation is a crucial aspect of maintaining data integrity and controlling the behavior of your classes. Python’s @property decorator plays a significant role in implementing attribute validation by allowing you to enforce constraints on attribute values.

The @property decorator enables you to create getter methods that not only compute attribute values but also validate them before returning. This validation ensures that the data held by an object remains consistent and adheres to the defined rules.


# Example of validating the attributes with @property
class Temperature:
    def __init__(self, celsius):
        self._celsius = celsius

    @property
    def celsius(self):
        return self._celsius

    @celsius.setter
    def celsius(self, value):
        if value < -273.15:
            raise ValueError(" cannot be below zero.")
        self._celsius = value

# Creating a Temperature instance
temp = Temperature(25)

# Attempting to set an invalid temperature
try:
    temp.celsius = -300
except ValueError as e:
    print(f"Error: {e}")

7. Summary and Conclusion

In this article, we have learned @property decorator in Python and its role in encapsulating attributes and controlling access to them. We discussed various use cases for @property, including computed attributes, and attribute validation. If you have any questions feel free to leave a comment.

Happy Coding!

Table of contents