a decorater example

gistfile1.py

from __future__ import division, print_function

from functools import wraps
import time


def timed(f):
    """Return a timed version of function f.

    The returned function returns a tuple of (time, real return value)

    :param f: function to time
    """

    @wraps(f)
    def wrapper(*args, **kwds):
        time_start = time.time()
        return_ = f(*args, **kwds)
        time_end = time.time()
        time_delta = time_end - time_start
        return time_delta, return_

    return wrapper


@timed
def an_example():
   return "foo"


print(an_example())