philiprehberger-deprecate
v0.2.0679 downloadsMIT
Decorator and utilities for deprecating functions, parameters, and classes with zero boilerplate
$
pip install philiprehberger-deprecateREADME
philiprehberger-deprecate
Decorator and utilities for deprecating functions, parameters, and classes with zero boilerplate.
Installation
pip install philiprehberger-deprecate
Usage
from philiprehberger_deprecate import (
deprecated,
deprecated_class,
deprecated_module,
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.
Deprecate a module
# in mypkg/legacy/__init__.py
from philiprehberger_deprecate import deprecated_module
deprecated_module(__name__, remove_in="2.0.0", alternative="mypkg.modern")
Importing mypkg.legacy emits:
DeprecationWarning: Module 'mypkg.legacy' is deprecated. Will be removed in 2.0.0. Use 'mypkg.modern' instead.
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 |
deprecated_module(name, *, remove_in, alternative, message) | Emits DeprecationWarning once when a deprecated module is imported |
Development
pip install -e .
python -m pytest tests/ -v
Support
If you find this project useful: