def deprecated(func):
@functools.wraps(func)<EOL>def decorated(*args, **kwargs):<EOL><INDENT>warnings.warn_explicit(<EOL>"<STR_LIT>".format(func.__name__),<EOL>category=DeprecationWarning,<EOL>filename=func.__code__.co_filename,<EOL>lineno=func.__code__.co_firstlineno + <NUM_LIT:1><EOL>)<EOL>return func(*args, **kwargs)<EOL><DEDENT>return decorated<EOL>
This is a decorator which can be used to mark functions
    as deprecated. It will result in a warning being emitted
    when the function is used.