Дескрипторы

Объектно-ориентированное программирование на Python: средний уровень

Jake Roach

Data Engineer

Изменение работы с атрибутами

class Student:
    def __init__(self, name, ssn):
        self.name = name
        self.ssn = ssn

# Create a student object, and access the "ssn" attribute
shaw = Student("Daniel Shaw", "193-80-1821")
print(shaw.ssn)

# What if the value is changed or deleted? How should this be handled?

193-80-1821

Создание дескрипторов с @property

Дескрипторы — объекты, управляющие получением, изменением и удалением атрибутов

Создание дескрипторов с@property

«getter», «setter», «deleter»
Имена методов == имя атрибута.

Дескрипторы можно также создать с помощью...

функции property()
__get__(), __set__(), __delete__()

class Student:
    def __init__(self, name, ssn):
        self.name = name
        self.ssn = ssn

    @property  
    def ssn(self):
        return "XXX-XX-" + self._ssn[-4:]

    @ssn.setter  
    def ssn(self, new_ssn):
        self._ssn = new_ssn 

    @ssn.deleter
    def ssn(self):
        raise AttributeError("Can't delete SSN")

@property

class Student:
    def __init__(self, name, ssn):
        self.name = name
        self.ssn = ssn  # Does not need to include an underscore

    @property  
    def ssn(self):  # This is the "getter" method
        return "XXX-XX-" + self._ssn[-4:]

Управляет получением ssn
Работает с self._ssn, а не с self.ssn

@ssn.setter

class Student:
    def __init__(self, name, ssn):
        self.name = name
        self.ssn = ssn
    ...

    @ssn.setter  
    def ssn(self, new_ssn):
        if len(new_ssn) == 11:
          # Add things such as data 
          # validation, operations on
          # other attributes, etc.
          self._ssn = new_ssn

@<attribute-name>.setter

Метод «setter» для ssn
Проверка качества данных
Операции с другими атрибутами

Не забывайте использовать self._ssn, а не self.ssn!

@ssn.deleter

class Student:
    def __init__(self, name, ssn):
        self.name = name
        self.ssn = ssn

    ...

    @ssn.deleter
    def ssn(self):
        # Can perform clean up, soft delete, raise exception
        raise AttributeError("Can't delete SSN")

Дескрипторы в действии

shaw = Student("Daniel Shaw", "193-80-1821")
print(shaw.ssn)  # Access the ssn attribute

XXX-XX-1821

shaw.ssn = "821-11-9380"  # Update Shaw's social security number
print(shaw.ssn)

XXX-XX-9380

del shaw.ssn  # Attempt to delete the ssn attribute

AttributeError: Can't delete SSN

Давайте потренируемся!

Объектно-ориентированное программирование на Python: средний уровень