Try this: Python Property

The sample code is:

class C(object):
    def __init__(self):
        self._x = None

    @property
    def x(self):
        """I'm the 'x' property."""
        print("getter of x called")
        return self._x

    @x.setter
    def x(self, value):
        print("setter of x called")
        self._x = value

    @x.deleter
    def x(self):
        print("deleter of x called")
        del self._x


c = C()
c.x = 'foo'  # setter called
foo = c.x    # getter called
del c.x      # deleter called
Answer from Grissiom on Stack Overflow
๐ŸŒ
Real Python
realpython.com โ€บ python-getter-setter
Getters and Setters: Manage Attributes in Python โ€“ Real Python
January 20, 2025 - In this enhanced version of Employee, you turn .name and .birth_date into properties using the @property decorator. Now each attribute has a getter and a setter method named after the attribute itself. Note that the setter of .name turns the input name into uppercase letters.
Top answer
1 of 9
1159

Try this: Python Property

The sample code is:

class C(object):
    def __init__(self):
        self._x = None

    @property
    def x(self):
        """I'm the 'x' property."""
        print("getter of x called")
        return self._x

    @x.setter
    def x(self, value):
        print("setter of x called")
        self._x = value

    @x.deleter
    def x(self):
        print("deleter of x called")
        del self._x


c = C()
c.x = 'foo'  # setter called
foo = c.x    # getter called
del c.x      # deleter called
2 of 9
628

What's the pythonic way to use getters and setters?

The "Pythonic" way is not to use "getters" and "setters", but to use plain attributes, like the question demonstrates, and del for deleting (but the names are changed to protect the innocent... builtins):

value = 'something'

obj.attribute = value  
value = obj.attribute
del obj.attribute

If later, you want to modify the setting and getting, you can do so without having to alter user code, by using the property decorator:

class Obj:
    """property demo"""
    #
    @property            # first decorate the getter method
    def attribute(self): # This getter method name is *the* name
        return self._attribute
    #
    @attribute.setter    # the property decorates with `.setter` now
    def attribute(self, value):   # name, e.g. "attribute", is the same
        self._attribute = value   # the "value" name isn't special
    #
    @attribute.deleter     # decorate with `.deleter`
    def attribute(self):   # again, the method name is the same
        del self._attribute

(Each decorator usage copies and updates the prior property object, so note that you should use the same name for each set, get, and delete function/method.)

After defining the above, the original setting, getting, and deleting code is the same:

obj = Obj()
obj.attribute = value  
the_value = obj.attribute
del obj.attribute

You should avoid this:

def set_property(property,value):  
def get_property(property):  

Firstly, the above doesn't work, because you don't provide an argument for the instance that the property would be set to (usually self), which would be:

class Obj:

    def set_property(self, property, value): # don't do this
        ...
    def get_property(self, property):        # don't do this either
        ...

Secondly, this duplicates the purpose of two special methods, __setattr__ and __getattr__.

Thirdly, we also have the setattr and getattr builtin functions.

setattr(object, 'property_name', value)
getattr(object, 'property_name', default_value)  # default is optional

The @property decorator is for creating getters and setters.

For example, we could modify the setting behavior to place restrictions the value being set:

class Protective(object):

    @property
    def protected_value(self):
        return self._protected_value

    @protected_value.setter
    def protected_value(self, value):
        if acceptable(value): # e.g. type or range check
            self._protected_value = value

In general, we want to avoid using property and just use direct attributes.

This is what is expected by users of Python. Following the rule of least-surprise, you should try to give your users what they expect unless you have a very compelling reason to the contrary.

Demonstration

For example, say we needed our object's protected attribute to be an integer between 0 and 100 inclusive, and prevent its deletion, with appropriate messages to inform the user of its proper usage:

class Protective(object):
    """protected property demo"""
    #
    def __init__(self, start_protected_value=0):
        self.protected_value = start_protected_value
    # 
    @property
    def protected_value(self):
        return self._protected_value
    #
    @protected_value.setter
    def protected_value(self, value):
        if value != int(value):
            raise TypeError("protected_value must be an integer")
        if 0 <= value <= 100:
            self._protected_value = int(value)
        else:
            raise ValueError("protected_value must be " +
                             "between 0 and 100 inclusive")
    #
    @protected_value.deleter
    def protected_value(self):
        raise AttributeError("do not delete, protected_value can be set to 0")

(Note that __init__ refers to self.protected_value but the property methods refer to self._protected_value. This is so that __init__ uses the property through the public API, ensuring it is "protected".)

And usage:

>>> p1 = Protective(3)
>>> p1.protected_value
3
>>> p1 = Protective(5.0)
>>> p1.protected_value
5
>>> p2 = Protective(-5)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 3, in __init__
  File "<stdin>", line 15, in protected_value
ValueError: protectected_value must be between 0 and 100 inclusive
>>> p1.protected_value = 7.3
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 17, in protected_value
TypeError: protected_value must be an integer
>>> p1.protected_value = 101
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 15, in protected_value
ValueError: protectected_value must be between 0 and 100 inclusive
>>> del p1.protected_value
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 18, in protected_value
AttributeError: do not delete, protected_value can be set to 0

Do the names matter?

Yes they do. .setter and .deleter make copies of the original property. This allows subclasses to properly modify behavior without altering the behavior in the parent.

class Obj:
    """property demo"""
    #
    @property
    def get_only(self):
        return self._attribute
    #
    @get_only.setter
    def get_or_set(self, value):
        self._attribute = value
    #
    @get_or_set.deleter
    def get_set_or_delete(self):
        del self._attribute

Now for this to work, you have to use the respective names:

obj = Obj()
# obj.get_only = 'value' # would error
obj.get_or_set = 'value'  
obj.get_set_or_delete = 'new value'
the_value = obj.get_only
del obj.get_set_or_delete
# del obj.get_or_set # would error

I'm not sure where this would be useful, but the use-case is if you want a get, set, and/or delete-only property. Probably best to stick to semantically same property having the same name.

Conclusion

Start with simple attributes.

If you later need functionality around the setting, getting, and deleting, you can add it with the property decorator.

Avoid functions named set_... and get_... - that's what properties are for.

๐ŸŒ
Medium
aignishant.medium.com โ€บ understanding-python-property-decorators-getters-setters-57d6b535e5d2
Understanding Python Property Decorators: Getters, Setters | by Nishant Gupta | Medium
February 23, 2025 - The property decorator in Python is a powerful feature that allows you to define โ€œgetterโ€, โ€œsetterโ€ methods for class attributes without explicitly calling them as methods.
๐ŸŒ
Programiz
programiz.com โ€บ python-programming โ€บ property
Python @property Decorator (With Examples)
In this tutorial, you will learn about Python @property decorator; a pythonic way to use getters and setters in object-oriented programming.
๐ŸŒ
GeeksforGeeks
geeksforgeeks.org โ€บ python โ€บ getter-and-setter-in-python
Getter and Setter in Python - GeeksforGeeks
July 11, 2025 - In this approach, the @property decorator is used for the getter and the @<property_name>.setter decorator is used for the setter.
๐ŸŒ
freeCodeCamp
freecodecamp.org โ€บ news โ€บ python-property-decorator
The @property Decorator in Python: Its Use Cases, Advantages, and Syntax
December 19, 2019 - A getter - to access the value of the attribute. A setter - to set the value of the attribute. A deleter - to delete the instance attribute. Price is now "Protected" Please note that the price attribute is now considered "protected" because ...
๐ŸŒ
Tutorjoes
tutorjoes.in โ€บ python_programming_tutorial โ€บ property_decorator_getter_setter_in_python
Property Decorator Getter Setter in Python
# Property Decorators Getter Setter class student: def __init__(self, total): self._total = total def average(self): return self._total / 5.0 @property def total(self): return self._total @total.setter def total(self, t): if t < 0 or t > 500: print("Invalid Total and can't Change") else: self._total = t o = student(450) print("Total : ", o.total) print("Average : ", o.average()) o.total = 550 print("Total : ", o.total) print("Average : ", o.average()) To download raw file Click Here
Find elsewhere
๐ŸŒ
DEV Community
dev.to โ€บ the1kimk โ€บ function-decorators-in-python-understanding-property-getter-and-setter-methods-3a8e
Function Decorators in Python: Understanding @property, Getter, and Setter Methods - DEV Community
September 22, 2024 - In this example, the getter (get_price()) and setter (set_price()) provide a way to access and modify the _price attribute while enforcing certain rules (like ensuring the price is not negative). The @property Decorator Python offers a more elegant way to manage access to private attributes using the @property decorator.
๐ŸŒ
Analytics Vidhya
analyticsvidhya.com โ€บ home โ€บ getter and setter in python
Getter and Setter in Python - Analytics Vidhya
February 17, 2024 - The above example defines a `Person` class with a private attribute _name. We use the `@property` decorator to define a getter method `name` that returns the value of _name.
๐ŸŒ
Llego
llego.dev โ€บ home โ€บ blog โ€บ python getter and setter methods: a comprehensive guide
Python Getter and Setter Methods: A Comprehensive Guide - llego.dev
July 17, 2023 - Here are some best practices to follow when implementing getter and setter methods in Python: Give descriptive names like get_name() and set_name() following conventions. Use @property decorator for getter methods and @<attribute>.setter for setters.
๐ŸŒ
Python Course
python-course.eu โ€บ oop โ€บ properties-vs-getters-and-setters.php
3. Properties vs. Getters and Setters | OOP | python-course.eu
... class P: def __init__(self, x): self.x = x @property def x(self): return self.__x @x.setter def x(self, x): if x < 0: self.__x = 0 elif x > 1000: self.__x = 1000 else: self.__x = x ยท A method which is used for getting a value is decorated with "@property", i.e.
๐ŸŒ
YouTube
youtube.com โ€บ watch
Python OOP Tutorial 6: Property Decorators - Getters, Setters, and Deleters - YouTube
In this Python Object-Oriented Tutorial, we will be learning about the property decorator. The property decorator allows us to define Class methods that we c...
Published ย  August 19, 2016
๐ŸŒ
Python.org
discuss.python.org โ€บ python help
What is the purpose of a property's @getter decorator? - Python Help - Discussions on Python.org
February 6, 2025 - Can anyone explain the purpose of the @property.getter decorator? class Foo(object): # Create a property (with a getter) @property def answer(self): return 41 # Change the getter @answer.geโ€ฆ
๐ŸŒ
Python Forum
python-forum.io โ€บ thread-39888.html
Curious about decorator syntax
I'm curious as to the rationale behind the choice of decorator syntax for getters and setters. Take, for example: @property def prop(self): return self._prop @prop.setter def prop(self, value): if not isinstan...
Top answer
1 of 2
3

Here's a more thorough example of why you would want to have a private attribute: data type validation (as pointed out by the other answers).

Let's say that you've been using the Dog class for a few weeks, and a new bug has come up that happens when the name attribute is (for whatever reason) set to a value that's not a string. You now need to change the code in order to enforce that a Dog's name is indeed a string, by raising an informative Exception. How do you do that?

Your first idea may be to simply check the name's data type after creating a new Dog (using the isinstance builtin function):

my_dog = Dog(name='Max', age=5)
if not isinstance(my_dog.name, str):
    raise ValueError("The Dog's name is not a string")

This works, but there's a clear issue here: you need to 1) change every line of code where a Dog is created, and 2) you need to tell anyone who ever uses your Dog class that, by the way, remember to check for the name's data type. This is clearly a lot of work, and not future-proof by any means - what if you or another user forgets to do this check? What if no one ever reads your documentation on the Dog class?

You may then think to perform this check in the __init__ method:

def class Dog:
    def __init__(self, name, age):
        if not isinstance(name, str):
            raise ValueError("The Dog's name is not a string")
        self.__name = name
        self.age = age

This cuts down on the work, but it doesn't stop someone from modifying the Dog's name after it was instantiated:

my_dog = Dog(name='Max', age=5)
my_dog.name = 10  # oops, wrong value!

What we want to do is to actually move this type-checking functionality to a method that runs every time the name attribute gets set - which is exactly what the setter method (the one decorated with the @name.setter decorator) does:

def class Dog:
    def __init__(self, name, age):
        self.__name = name
        self.age = age

    @property
    def name(self):
        return self.__name

    @name.setter
    def name(self, new_name)
        if not isinstance(new_name, str):
            raise ValueError("The Dog's name is not a string")
        self.__name = new_name

Now the name's data type is always checked for, both during instantiation (in the __init__ method) and afterwards.

Data type validation is simply an example. The point of using private attributes and their getters/setters is to combine attribute access with some custom functionality. If you desire no functionality whatsoever when accessing/modifying the attribute, you're correct in your observation that you don't need to bother making it private and writing the getter/setter methods in the first place.

2 of 2
5

The advantage of properties is that from the viewpoint of the user of your class, it's syntactically the same as plain attribute access. So you can add logic (validation etc.) at any time without changing the class's interface and breaking the code that uses it. You can even swap in different versions of the class (e.g. with properties that do logging during development, without properties for production) and the caller won't even notice.

Contrast this to a language like Java where best practice is to always write getter/setter methods even if you don't need them, because you might need them later, but can't add them later without changing the API and thereby breaking code that uses the class.

BTW, there are no truly private attributes in Python. The leading __ is intended to keep names from conflicting among subclasses of the base class, where that might be a problem.

๐ŸŒ
Codesarray
codesarray.com โ€บ view โ€บ Getters-and-Setters-in-Python
Getters and Setters in Python
Using Getters and Setters for Simple Attributes: For straightforward attributes without any special behavior, direct access is usually sufficient and preferred. Use @property Decorators: Leverage Pythonโ€™s @property decorator to create clean and Pythonic getters and setters.
๐ŸŒ
Studytonight
studytonight.com โ€บ python โ€บ property-in-python
Python @property decorator and property() function | Studytonight
@property is a built-in decorator in python language which is used to make functions like getters and setters in a class behave as class properties.