
    'i\              	       F    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y)	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          y)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      b/home/obispo/Crisostomo_bridge/mision_env/lib/python3.12/site-packages/telegram/_utils/warnings.pyr   r   "   s    , MM'HaH    )	__doc__r
   telegram.warningsr   strtypeWarningintr    r   r   <module>r      sQ   &  ,
 -I>!I7mI I 
	Ir   