decorator example..

sqr_decorator.py

# A decorator is a function that takes another function object as an argument
# and returns said function object as a return value..

def addone(func):
    """squares anything passed to it"""
    def modfunc(n):
        func(n)
        print '> and squared it is', n ** 2
    return modfunc

@addone
def printx(x):
    print '> the original value is', x

if __name__ == '__main__':
    printx(5)
    print addone.__doc__

multiline comments are hideous.. <3