@property

Syntax

@property\ndef attr(self):\n    return self._attr

Examples

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

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

c = Circle(5)
print(c.area)  # 78.53975 (called without parentheses, like an attribute)

class Product:
    def __init__(self, name, price):
        self.name = name
        self._price = price

    @property
    def price(self):
        return self._price

    @price.setter
    def price(self, value):
        if value < 0:
            raise ValueError("Price cannot be negative")
        self._price = value

item = Product("Mouse", 25)
item.price = 30       # calls the setter
print(item.price)     # 30

try:
    item.price = -10  # raises ValueError
except ValueError as e:
    print(e)

class Employee:
    def __init__(self, first, last):
        self.first = first
        self.last = last

    @property
    def full_name(self):
        return f"{self.first} {self.last}"

emp = Employee("Fola", "A")
print(emp.full_name)  # Fola A

# emp.full_name = "New Name"  # would raise AttributeError - no setter defined

Best practices

• Use @property for computed or derived values that should behave like attributes, not method calls with parentheses
• Add a @x.setter only when you need validation or side effects on assignment - a plain attribute is simpler when no logic is needed
• Store the underlying data in a conventionally "private" attribute (prefixed with an underscore) to avoid naming conflicts with the property itself
• Start a class with plain public attributes, and convert to a property later if you need to add logic - this keeps the external interface unchanged

At a glance

Purpose

Scripting and general-purpose applications

File extension

.py

Runs in

Python interpreter

Usually used with

Python standard library and packages

Specifications & further reading

• Python language reference

Related Python documentation