def deprecated(msg='<STR_LIT>'):
def wrapper(func):<EOL><INDENT>@functools.wraps(func)<EOL>def new_func(*args, **kwargs):<EOL><INDENT>warning_string = "<STR_LIT>" % func.__name__<EOL>warning_string = warning_string + '<STR_LIT:U+0020>' + msg<EOL>warnings.warn(<EOL>warning_string,<EOL>category=DeprecationWarning,<EOL>)<EOL>return func(*args, **kwargs)<EOL><DEDENT>return new_func<EOL><DEDENT>return wrapper<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.

    :param msg:

        Additional message added to the warning.