about this alternative if provided.
pending – bool, optional
If True, uses a PendingDeprecationWarning instead of a
DeprecationWarning. Cannot be used together with removal.
obj_type – str, optional
The object type being deprecated.
addendum – str, optional
Additional text appended directly to the final message.
removal – str, optional
The expected removal version. With the default (an empty
string), a removal version is automatically computed from
since. Set to other Falsy values to not schedule a removal
date. Cannot be used together with pending.
Examples
@deprecated('1.4.0')
def the_function_to_deprecate():
    pass