ocrd_utils.deprecate

Complexity

Total Complexity

6

Size/Duplication

Total Lines	32
Duplicated Lines	0 %

Importance

Changes

0

3 Functions

Rating	Name	Duplication	Size	Complexity
A	deprecation_warning()	0	2	1
A	deprecated_alias()	0	11	1
A	rename_kwargs()	0	13	4

import functools
import warnings

def deprecation_warning(msg, stacklevel=2):
    warnings.warn(msg, DeprecationWarning, stacklevel)

def deprecated_alias(**aliases):
    """
    Deprecate a kwarg in favor of another kwarg
    """
    def deco(f):
        @functools.wraps(f)
        def wrapper(*args, **kwargs):
            rename_kwargs(f.__name__, kwargs, aliases)
            return f(*args, **kwargs)
        return wrapper
    return deco

def rename_kwargs(func_name, kwargs, aliases):
    """
    https://stackoverflow.com/questions/49802412/how-to-implement-deprecation-in-python-with-argument-alias
    by user2357112 supports Monica
    """
    for alias, new in aliases.items():
        if alias in kwargs:
            if new in kwargs:
                raise TypeError('{} received both {} and {}'.format(
                    func_name, alias, new))
            warnings.warn('{} is deprecated; use {}'.format(alias, new),
                          DeprecationWarning)
            kwargs[new] = kwargs.pop(alias)