Decoradores property en Python para atributos con validación

Contenido del curso

Fundamentos de Clases y Objetos

Encapsulación y Comportamiento de Objetos

Implementar Protocolos con Métodos Especiales

Relaciones entre Clases y Polimorfismo

Diseño Avanzado y Patrones de Software

17
Loading JSON Data to Restore App State
11:43 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:006:22

Decoradores property en Python para atributos con validación

Curso de Python Orientado a Objetos

Clase 14 de 17

Clase 14 / 17

Recursos

Los decoradores @property en Python convierten métodos en atributos accesibles con la anotación de punto, logrando interfaces limpias, validación y cálculo automático detrás de escena. Con un getter convertido en propiedad y un setter controlado, tu clase gana encapsulación efectiva sin cambiar cómo lees o escribes valores.

¿Qué es property y por qué hace tu código más pythonico?

Usar property permite exponer datos como atributos, pero con la lógica de métodos. Así, el acceso es natural y no requiere paréntesis, mientras mantienes el control interno.

Convierte un método en atributo de solo lectura con @property.
Controla la escritura con @nombre.setter y valida entradas.
Accede con la anotación de punto, sin paréntesis.

¿Cómo convertir un getter en propiedad con @property?

Primero, elimina el método get_... y declara la propiedad. Luego úsala como un atributo.

class Libro:
    def __init__(self, titulo, autor, ISBN):
        self.titulo = titulo
        self.autor = autor
        self.ISBN = ISBN
        self._veces_prestado = 0  # parámetro interno

    @property
    def veces_prestado(self):
        return self._veces_prestado

En el flujo de impresión, en lugar de retornar solo el título desde libros_disponibles, retorna el objeto libro y accede así:

# en main
for libro in libros_disponibles():
    print(libro.titulo, libro.veces_prestado)  # sin paréntesis

¿Cómo controlar la escritura con setter y validación?

Con el setter defines cómo se asigna y validas valores. Si no cumple, genera un error claro.

class Libro:
    # ...
    @veces_prestado.setter
    def veces_prestado(self, valor):
        if valor > 0:
            self._veces_prestado = valor
        else:
            raise ValueError("El valor de veces prestado debe ser mayor a cero")

Prueba en main asignando un valor negativo y ejecuta:

python main.py

Verás un ValueError con el mensaje de validación. Esto ayuda a detectar un bug antes de que llegue a usuarios reales.

¿Cómo usar properties para computar y mostrar datos?

Además de exponer valores, puedes crear propiedades que computan resultados a partir del estado interno. Por ejemplo, una propiedad es_popular basada en datos internos se accede como atributo y no necesita setter.

Propiedades computadas como es_popular evitan estados inconsistentes.
No declaras setter si no quieres permitir escritura.

Para mostrar información compuesta, crea una propiedad que devuelva una cadena con título, autor e ISBN.

class Libro:
    # ...
    @property
    def descripcion_completa(self):
        return f"{self.titulo} por {self.autor} {self.ISBN}"

Úsala en la salida en main con la anotación de punto:

print(libro.descripcion_completa)

¿Cómo se integra en main y biblioteca?

La integración es directa si retornas objetos libro en lugar de cadenas.

Modifica libros_disponibles para retornar la lista de objetos Libro.
Itera y accede a libro.titulo, libro.veces_prestado y libro.descripcion_completa.
Evita paréntesis: las propiedades se leen como atributos.
Ejecuta con python main.py para validar resultados.

¿Qué reto práctico puedes implementar ahora?

Pon en práctica las propiedades para reforzar encapsulación y claridad.

Agrega una propiedad nombre completo a la clase usuario que combine nombre y cédula.
Crea una propiedad en biblioteca para libros disponibles que retorne la lista de todos los libros disponibles.
Comparte tu implementación y comenta cómo validaste las asignaciones.

¿Tienes otra idea de propiedad útil en tu modelo de dominio? Cuéntala en los comentarios y qué validaciones agregarías.

Sergio Daniel Flamenco

Hace 6 meses

Acá les comparto el reto:

libros.py

from typing import Protocol

class LibroProtocol(Protocol):

def prestar(self) -> str:

"""Método de prestar un libro"""

...

def devolver(self) -> str:

"""Método de devolver un libro"""

...

def calcular_duracion(self) -> str:

"""Calcula el tiempo de prestamo"""

...

class Libro:

def __init__(self, titulo, autor, isbn, disponible=True):

self.titulo = titulo

self.autor = autor

self.isbn = isbn

self.disponible = disponible

self.__veces_prestado = 0

def __str__(self):

return f"{self.titulo} por {self.autor} disponible: {self.disponible}"

def prestar(self):

if self.disponible:

self.disponible = False

self.__veces_prestado += 1

return f"'{self.titulo}' prestado exitosamente. Total préstamos: {self.__veces_prestado}"

return f"'{self.titulo}' no está disponible"

def devolver(self):

self.disponible = True

return f"'{self.titulo}' devuelto y disponible nuevamente"

@property

def es_popular(self):

return self.__veces_prestado > 5

@property

def veces_prestado(self):

return self.__veces_prestado

@veces_prestado.setter

def veces_prestado(self, veces_prestado):

if veces_prestado > 0:

self.__veces_prestado = veces_prestado

raise ValueError("El valor de veces_prestado debe ser mayor a cero")

@property

def descripcion_completa(self):

return f"{self.titulo} por {self.autor} (ISBN: {self.isbn})"

class LibroFisico(Libro):

def calcular_duracion(self):

return "7 días"

class LibroDigital(Libro):

def calcular_duracion(self):

return "14 días"

Sergio Daniel Flamenco

Hace 6 meses

main.py

from biblioteca import Biblioteca

from data import data_libros, data_estudiantes

from exceptions import LibroNoDisponibleError, UsuarioNoEncontradoError

from usuarios import Profesor

biblioteca = Biblioteca("Platzi Biblioteca")

profesor = Profesor("Felipe", "123123123")

biblioteca.usuarios = [profesor] + data_estudiantes

biblioteca.libros = data_libros

# Ejemplo de setter.

# libro_de_prueba = data_libros[0]

# libro_de_prueba.veces_prestado = -1

print("Bienvenido a Platzi Biblioteca")

print("Libros disponibles:")

for libro in biblioteca.libros_disponibles():

print(libro.descripcion_completa)

print()

cedula = input("Digite el numero cedula: ")

try:

usuario = biblioteca.buscar_usuario(cedula)

print(usuario.cedula, usuario.nombre)

except UsuarioNoEncontradoError as e:

print(e)

titulo = input("Digite el titulo del libro: ")

try:

libro = biblioteca.buscar_libro(titulo)

print(f"El libro que seleccionaste es: {libro}")

except LibroNoDisponibleError as e:

print(e)

resultado = usuario.solicitar_libro(libro.titulo)

print(f"\n{resultado}")

try:

resultado_prestar = libro.prestar()

print(f"\n{resultado_prestar}")

except LibroNoDisponibleError as e:

print(e)

Comentarios (11)11 comentarios

Alonso Cortes Resendiz

Hace un año

Luis Martinez

Profesor

Gabriel Obregón

Yeferson Lasso España

Hace 5 meses

DAVID ENRIQUE SÁNCHEZ SIERRA

César García Suárez

Diego Mauricio Zuluaga Rodríguez

Hace 8 meses

Oscar Eduardo Barrios Blanco

Hace 9 meses

Gamaliel Sandoval

Hace 9 meses•editado

Fundamentos de Clases y Objetos

OOP in Python: Modeling Real World Systems

Classes and Objects in Python Explained

Instance Methods That Make Python Objects Act

Private Attributes and Data Integrity in Python

Encapsulación y Comportamiento de Objetos

Herencia en Python para evitar duplicación de código

Simple Inheritance With Python Classes

Python Protocol for Flexible Polymorphism

Implementar Protocolos con Métodos Especiales

Composition Over Inheritance in Python

Organizing Python Projects Into Modules

Custom Exceptions That Make Python Errors Clear

Sistema de préstamos con identificación de usuarios en Python

Relaciones entre Clases y Polimorfismo

Book Search and Lending Flow in Python OOP

Clases abstractas en Python con ABC y @abstractmethod

Decoradores property en Python para atributos con validación

Decoradores @staticmethod y @classmethod en Python

Serialización de objetos Python a JSON para persistencia de datos

Diseño Avanzado y Patrones de Software

Loading JSON Data to Restore App State

Decoradores property en Python para atributos con validación

Progreso del curso

Fundamentos de Clases y Objetos

Encapsulación y Comportamiento de Objetos

Implementar Protocolos con Métodos Especiales

Relaciones entre Clases y Polimorfismo

Diseño Avanzado y Patrones de Software

Recursos

Recursos