O que é um decorador próprio e como criá-lo em Python?

Um decorador próprio em Python é uma função que aceita outra função e retorna uma nova função com comportamento expandido ou alterado.

Exemplo de criação de um decorador simples que exibe uma mensagem antes e depois da chamada da função:

def my_decorator(func):
    def wrapper(*args, **kwargs):
        print("A iniciar a execução da função")
        result = func(*args, **kwargs)
        print("A terminar a execução da função")
        return result
    return wrapper

@my_decorator
def say_hello(name):
    print(f"Olá, {name}!")

say_hello("Mundo")

Aqui, @my_decorator aplica o decorador à função say_hello, adicionando uma saída adicional.