Las funciones son valores: puedes pasar una a otra función y recibir una nueva. Un decorador es una función que recibe una función y devuelve una versión envuelta de ella. Escribir @log_calls encima de un def equivale a f = log_calls(f).
La función envolvente suele recibir *args, **kwargs para adaptarse a cualquier función, hace algo antes o después y devuelve el resultado de la función original. Olvidar ese return es el error clásico: la función decorada pasa a devolver None.
Añade @functools.wraps(func) a la función envolvente para que la función decorada conserve su nombre y su cadena de documentación; de lo contrario, todas las funciones decoradas se llaman wrapper.
Para dar opciones a un decorador, como en @retry(times=3), añade una capa más: una función que reciba las opciones y devuelva el decorador.
Ya has usado decoradores de la biblioteca estándar: @functools.lru_cache y @dataclass.
Salida: ('HELLO LENA', 'greet'). La función envolvente cambia el resultado; wraps conserva el nombre.