Deprecation warning decorator in python!

deprecated_decorator.py

import warnings
import functools

def deprecated(function):
    """
    This decorator which can be used to mark functions
    as deprecated. It will result in a warning being emitted
    when the function is used.
    Args:
        function:       function:       Function to be overridden!
    Returns:
        [object]:       Whatever the "function" was supposed to return!
    """
    @functools.wraps(function)
    def new_function(*args, **kwargs):
        warnings.simplefilter('always', DeprecationWarning)
        warnings.warn(
            message='Call to deprecated function {}.'.format(function.__name__), 
            category=DeprecationWarning,
            stacklevel=2
        )
        warnings.simplefilter('default', DeprecationWarning)
        return function(*args, **kwargs)
    return new_function

Usage

@deprecated
def add(a: int, b: int) -> int:
    return a + b