+
    ÁFñj	  ã                   ón   € R t ^ RIHt ^ RIHt ^ RIHt ^ RIHtH	t	 R R lt
^]3R R lltRR	 R
 lltR# )zÞThis module contains functionality used for transition warnings issued by this library.

It was created to prevent circular imports that would be caused by creating the warnings
inside warnings.py.

.. versionadded:: 20.2
)ÚCallable)ÚAny)Úwarn)ÚPTBDeprecationWarningÚPTBUserWarningc          
      óT   € V ^8„  d   QhR\         R\         R\         R\         R\         /# )é   Údeprecated_nameÚnew_nameÚobject_typeÚbot_api_versionÚreturn)Ústr)Úformats   "ÚY/opt/hermes-site/venv/lib/python3.14/site-packages/telegram/_utils/warnings_transition.pyÚ__annotate__r   "   s:   € ÷ ñ Üðäðô ðô ð	ô
 	ñó    c                ó,   € RV RV  RV RV RV RV  R2# )z—Builds a warning message for the transition in API when an object is renamed/replaced.

Returns a warning message that can be used in `warn` function.
zThe z 'z' was replaced by 'z' in Bot API z. We recommend using 'z' instead of 'ú'.© ©r	   r
   r   r   s   &&&&r   Ú!build_deprecation_warning_messager   "   s?   € ð ˆ{ˆm˜2˜oÐ.Ð.AÀ(ÀÈ=ØÐ
Ð1°(°ð <ØÐ˜Bð	 ðr   c                óà   € V ^8„  d   QhR\         R\         R\        R\        R\        R\        R\        R\        \        \        ,          \
        \        ,          \        .R	3,          R
\         /	# )r   Údeprecated_argÚnew_argÚdeprecated_arg_nameÚnew_arg_namer   Úptb_versionÚ
stacklevelÚwarn_callbackNr   )r   r   Úintr   r   ÚtypeÚWarning)r   s   "r   r   r   5   s|   € ÷ *ñ *Üð*äð*ô ð*ô ð	*ô
 ð*ô ð*ô ð*ô œS¤>Õ1´4¼µ=Ä#ÐFÈÐLÕMð*ô 	ñ*r   c                óÖ   € V '       d2   V'       d*   W8w  d$   \        VVRVR7      p\        RV RV RV 24      hV '       d(   V! \        VRV RV RV R	24      V^,           R
7       V # V# )a’  A helper function for the transition in API when argument is renamed.

Checks the `deprecated_arg` and `new_arg` objects; warns if non-None `deprecated_arg` object
was passed. Returns `new_arg` object (either the one originally passed by the user or the one
that user passed as `deprecated_arg`).

Raises `ValueError` if both `deprecated_arg` and `new_arg` objects were passed, and they are
different.
Ú	parameterr   z"You passed different entities as 'z' and 'z'. úBot API z renamed the argument 'ú' to 'r   ©r   )r   Ú
ValueErrorr   )	r   r   r   r   r   r   r   r   Úbase_messages	   &&&&&&&& r   Ú(warn_about_deprecated_arg_return_new_argr*   5   s    € ÷& Ÿ' nÔ&?Ü8Ø/Ø!Ø#Ø+ô	
ˆô Ø0Ð1DÐ0EÀWÈ\ÈNÐZ]Øˆnðó
ð 	
÷
 ÙÜ!ØØ˜?Ð+Ð+BÐCVÐBWð XØ �> ð%óð
 " A•~õ	
ð Ðà€Nr   c                óX   € V ^8„  d   QhR\         R\         R\         R\         R\        RR/# )r   Údeprecated_attr_nameÚnew_attr_namer   r   r   r   N)r   r    )r   s   "r   r   r   b   sD   € ÷ ñ Üðäðô ðô ð	ô
 ðð 
ñr   c                óV   € \        \        VRV RV  RV R24      V^,           R7       R# )z¼A helper function for the transition in API when attribute is renamed. Call from properties.

The properties replace deprecated attributes in classes and issue these deprecation warnings.
r%   z renamed the attribute 'r&   r   r'   N)r   r   )r,   r-   r   r   r   s   &&&&&r   Ú&warn_about_deprecated_attr_in_propertyr/   b   sC   € ô 	ÜØØ�Ð'Ð'?Ð@TÐ?Uð VØˆ˜bð"ó	
ð
  •>÷r   N)r   )Ú__doc__Úcollections.abcr   Útypingr   Útelegram._utils.warningsr   Útelegram.warningsr   r   r   r*   r/   r   r   r   Ú<module>r5      s5   ðñ&õ %Ý å )ß Cõð4 ØPT÷*÷Zñ r   