
    i\              	       N    d Z ddlZddlmZ edfdeez  dee         deddfdZdS )	aG  This 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)PTBUserWarningmessagecategory
stacklevelreturnc                 :    t          j        | ||dz              dS )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``.
       )r   r   N)warningswarn)r   r   r   s      X/Users/shanyulin/my-agent/.venv/lib/python3.11/site-packages/telegram/_utils/warnings.pyr   r   "   s%    , M'HaHHHHHH    )	__doc__r
   telegram.warningsr   strtypeWarningintr    r   r   <module>r      s   &   , , , , , ,
 -I I>!I7mI I 
	I I I I I Ir   