U g@sRdZddlZddlmZmZddlmZedfeeefeee ddddZ dS)aGThis module contains helper functions related to warnings issued by the library. .. versionadded:: 20.0 Warning: Contents of this module are intended to be used internally by the library and *not* by the user. Changes to this module are not considered breaking changes and may not be documented in the changelog. N)TypeUnion)PTBUserWarning)messagecategory stacklevelreturncCstj|||dddS)a Helper function used as a shortcut for warning with default values. .. versionadded:: 20.0 Args: message (:obj:`str` | :obj:`PTBUserWarning`): Specify the warnings message to pass to ``warnings.warn()``. .. versionchanged:: 21.2 Now also accepts a :obj:`PTBUserWarning` instance. category (:obj:`Type[Warning]`, optional): Specify the Warning class to pass to ``warnings.warn()``. Defaults to :class:`telegram.warnings.PTBUserWarning`. stacklevel (:obj:`int`, optional): Specify the stacklevel to pass to ``warnings.warn()``. Pass the same value as you'd pass directly to ``warnings.warn()``. Defaults to ``0``. )rrN)warningswarn)rrrr s