
    Yiz              	       Z    S r SSKrSSKJr  SSKJr  \S4S\\\4   S\\   S\	SS4S	 jjr
g)
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)Union)PTBUserWarningmessagecategory
stacklevelreturnc                 4    [         R                  " XUS-   S9  g)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      C/app/.venv/lib/python3.13/site-packages/telegram/_utils/warnings.pyr   r   "   s    , MM'aH    )__doc__r   typingr   telegram.warningsr   strtypeWarningintr    r   r   <module>r      sY   &   ,
 -I3&'I7mI I 
	Ir   