Functools demo

test_functools.py

"""Showing the cool stuff which functools does"""
import functools

def print_shit(f):
        """Because Sam, you need to learn why decorators are sexy.

        Plus, functool.wraps() is a _very_ important tool, yo
        """
        @functools.wraps(f)
        def inner(*args, **kwargs):
                print "Hello Sam, do you like cats?"
                ret = f(*args, **kwargs)
                print "Good bye Sam"
                return ret
        return inner

def broken_shit(f):
        """Because Sam, you need to learn why decorators are sexy.

        Plus, functool.wraps() is a _very_ important tool, yo
        """
        def inner(*args, **kwargs):
                print "Hello Sam, do you like cats?"
                ret = f(*args, **kwargs)
                print "Good bye Sam"
                return ret
        return inner

@print_shit
def main():
        """A found docstring"""
        pass

@broken_shit
def broken_main():
        """A lost docstring."""
        pass

if __name__ == "__main__":
        main()
        broken_main()
        print ""
        print "Main: {}".format(main.__doc__)
        print "Broken Main: {}".format(broken_main.__doc__)