Simple decorator example with functools.wraps

ham.py

#!/usr/bin/env python3

from functools import wraps

def add_sandwich(wrapped):
    ''' add_sandwich doc_string '''
    
# try commenting out the next line to see what happens
    @wraps(wrapped)
    def wrapper(*args, **kwargs):
        ''' wrapper doc_string'''
        return wrapped(*args, **kwargs) + ' sandwich'
    return wrapper

@add_sandwich
def ham():
    ''' Returns the string ham '''
    return 'ham'

retval = ham()
print(retval)