Conteúdo do curso Lição 54 de 250 · Python Orientado a Objetos
Python Orientado a Objetos

Atributos Computados com @property

Às vezes um valor deve parecer um atributo, mas na verdade deve ser calculado na hora, ou ser verificado antes de ser permitido mudar. O @property decorator transforma um método em algo que você lê sem parênteses, como um atributo normal.

A valor computado apenas para leitura

class Rectangle:
    def __init__(self, w, h):
        self.w = w
        self.h = h

    @property
    def area(self):
        return self.w * self.h

r = Rectangle(3, 4)
print(r.area)   # 12, note: no parentheses

Porque area é uma propriedade, você escreve r.area, não r.area(). Ele recalcula toda vez, então ele continua correto mesmo se w ou h mudarem.

Validando um valor com um setter

Você também pode proteger as gravações. Defina a propriedade, depois um @<name>.setter correspondente. Por convenção, os dados reais são armazenados em um atributo com aparência privada com um sublinhado inicial.

class Person:
    def __init__(self, age):
        self.age = age   # this goes through the setter below

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

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

p = Person(30)
print(p.age)   # 30
p.age = 31     # ok
# p.age = -5   # would raise ValueError

Por fora ainda parece um atributo comum, mas cada leitura e escrita executa o seu código.

Sua vez

Defina uma classe Circle cujo __init__ recebe radius e o atribui a self.radius (que passa por um setter). Adicione uma propriedade radius e um setter radius que levanta ValueError quando recebe um número negativo, armazenando o valor em self._radius. Adicione uma propriedade diameter somente leitura que retorna radius * 2.

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.