deprecated decorator

deprecated.py

import warnings
    
    
def deprecated(msg=""):
    def inner(func):
        """
        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.
        
        This decorator must take 0 or 1 arguments, e.g. even if you don't want 
        to use a custom message, write the parenthesis:
        
        @deprecated("test_depr never worked")
        def test_depr():
            return 1
        
        or
        
        @deprecated()
        def test_depr():
            return 1
        
        """
        def new_func(*args, **kwargs):
            s = "Call to deprecated function {}".format(func.__name__)
            if str(msg).strip != "":
                s += ": {}.".format(msg)
            else:
                s += "."
            warnings.warn(s)
            return func(*args, **kwargs)

        new_func.__name__ = func.__name__
        new_func.__doc__ = func.__doc__
        new_func.__dict__.update(func.__dict__)

        return new_func
    return inner