philiprehberger-deprecate 0.1.4

Decorator and utilities for deprecating functions, parameters, and classes with zero boilerplate

philiprehberger-deprecate

Decorator and utilities for deprecating functions, parameters, and classes with zero boilerplate.

Install

pip install philiprehberger-deprecate

Usage

from philiprehberger_deprecate import deprecated, deprecated_class, deprecated_param

Deprecate a function

@deprecated(remove_in="2.0.0", alternative="new_fetch")
def old_fetch(url: str) -> str:
    ...

Calling old_fetch() emits:

DeprecationWarning: Function 'old_fetch' is deprecated. Will be removed in 2.0.0. Use 'new_fetch' instead.

Deprecate a parameter

@deprecated_param("color", renamed_to="colour", remove_in="2.0.0")
def draw(shape: str, *, colour: str = "red") -> None:
    ...

draw(shape="circle", color="blue")  # warns and forwards color -> colour

Deprecate a class

@deprecated_class(remove_in="3.0.0", alternative="NewClient")
class OldClient:
    def __init__(self, host: str) -> None:
        self.host = host

Instantiating OldClient() emits a DeprecationWarning.

API

Function	Description
deprecated(remove_in, *, alternative, message)	Function decorator that emits DeprecationWarning on each call
deprecated_param(param, *, renamed_to, remove_in)	Function decorator that warns when a deprecated parameter is passed and optionally maps it to its replacement
deprecated_class(remove_in, *, alternative, message)	Class decorator that emits DeprecationWarning on instantiation

Development

pip install -e .
python -m pytest tests/ -v

License

MIT