+
    QV-j_  ã                   ó’   € ^ RI t ^ RIt^ RIHt ^ RIt^RIHt ^RIHtH	t	H
t
 ]	! 4       '       d   ^ RIt ! R R]4      tR	R R lltR# )
é    N)Úwraps)Ú__version__)ÚExplicitEnumÚis_torch_availableÚis_torchdynamo_compilingc                   ó&   € ] tR t^tRtRtRtRtRtR# )ÚActionÚnoneÚnotifyÚnotify_alwaysÚraise© N)	Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__ÚNONEÚNOTIFYÚNOTIFY_ALWAYSÚRAISEÚ__static_attributes__r   ó    Úo/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/transformers/utils/deprecation.pyr	   r	      s   † Ø€DØ€FØ#€MØ„Er   r	   c                óˆ   € V ^8„  d   QhR\         R\         R\         R,          R\        R\        R\        R\         R,          /# )	é   Úold_nameÚversionÚnew_nameNÚ warn_if_greater_or_equal_versionÚ!raise_if_greater_or_equal_versionÚraise_if_both_namesÚadditional_message)ÚstrÚbool)Úformats   "r   Ú__annotate__r&   $   s_   € ÷ Kñ KÜðKäðKô �D�jðKô '+ð	Kô
 (,ðKô ðKô ˜d�
ñKr   c                óâ   a aaaaaa
a€ \         P                  P                  V4      p\         P                  P                  \        4      pW‡8¬  o
S
'       d   RV 2oMRV 2oVV
VV VVVV3R lp	V	# )a«
  
Function or method decorator to notify users about deprecated keyword arguments, replacing them with a new name if specified.
Note that is decorator is `torch.compile`-safe, i.e. it will not cause graph breaks (but no warning will be displayed if compiling).

This decorator allows you to:
- Notify users when a keyword argument is deprecated.
- Automatically replace deprecated keyword arguments with new ones.
- Raise an error if deprecated arguments are used, depending on the specified conditions.

By default, the decorator notifies the user about the deprecated argument while the `transformers.__version__` < specified `version`
in the decorator. To keep notifications with any version `warn_if_greater_or_equal_version=True` can be set.

Parameters:
    old_name (`str`):
        Name of the deprecated keyword argument.
    version (`str`):
        The version in which the keyword argument was (or will be) deprecated.
    new_name (`Optional[str]`, *optional*):
        The new name for the deprecated keyword argument. If specified, the deprecated keyword argument will be replaced with this new name.
    warn_if_greater_or_equal_version (`bool`, *optional*, defaults to `False`):
        Whether to show warning if current `transformers` version is greater or equal to the deprecated version.
    raise_if_greater_or_equal_version (`bool`, *optional*, defaults to `False`):
        Whether to raise `ValueError` if current `transformers` version is greater or equal to the deprecated version.
    raise_if_both_names (`bool`, *optional*, defaults to `False`):
        Whether to raise `ValueError` if both deprecated and new keyword arguments are set.
    additional_message (`Optional[str]`, *optional*):
        An additional message to append to the default deprecation message.

Raises:
    ValueError:
        If raise_if_greater_or_equal_version is True and the current version is greater than or equal to the deprecated version, or if raise_if_both_names is True and both old and new keyword arguments are provided.

Returns:
    Callable:
        A wrapped function that handles the deprecated keyword arguments according to the specified parameters.

Example usage with renaming argument:

    ```python
    @deprecate_kwarg("reduce_labels", new_name="do_reduce_labels", version="6.0.0")
    def my_function(do_reduce_labels):
        print(do_reduce_labels)

    my_function(reduce_labels=True)  # Will show a deprecation warning and use do_reduce_labels=True
    ```

Example usage without renaming argument:

    ```python
    @deprecate_kwarg("max_size", version="6.0.0")
    def my_function(max_size):
        print(max_size)

    my_function(max_size=1333)  # Will show a deprecation warning
    ```

z"and removed starting from version zand will be removed in version c                 óÐ   <a aa€ \         P                  ! S 4      p\        VP                  P	                  4       4      pR V9   oRV9   o\        S 4      VV VVVVV	V
VVV3R l4       pV# )ÚselfÚclsc                  ó\  <€ SP                   pS	'       d$   V ^ ,          P                  P                    RV 2pM S'       d   V ^ ,          P                    RV 2p\        P                  pRpSV9   dh   S
V9   da   S'       d   \        P                  M\        P
                  pRS RS
 RV RS
 RVS
,           RS RVS,           R	2pVP                  S4       MiSV9   d@   S
e<   S
V9  d5   \        P                  pR
S RS RV RS
 R2	pVP                  S4      VS
&   M#SV9   d   \        P                  pR
S RS RV R	2pVe   Se   V RS 2pS'       d\   S'       d'   V\        P                  8w  d   \        P                  pM-S'       g&   V\        P                  8X  d   \        P                  pV\        P                  8X  d   \        V4      hV\        P                  \        P
                  39   d.   \        4       '       g   \        P                  ! V\        ^R7       S! V / VB # )r   Ú.NzBoth `z` and `z` are set for `z
`. Using `Ú=z` and ignoring deprecated `z`.Ú`z` is deprecated z for `z`. Use `z
` instead.Ú )Ú
stacklevel)r   Ú	__class__r	   r   r   r   Úpopr   Ú
ValueErrorr   ÚwarningsÚwarnÚFutureWarning)ÚargsÚkwargsÚ	func_nameÚminimum_actionÚmessager"   ÚfuncÚis_class_methodÚis_greater_or_equal_versionÚis_instance_methodr   r   r!   r    Úversion_messager   s   *,   €€€€€€€€€€€r   Úwrapped_funcÚ6deprecate_kwarg.<locals>.wrapper.<locals>.wrapped_funcw   s:  ø€ ð Ÿ™ˆIß!Ø# A�w×0Ñ0×9Ñ9Ð:¸!¸I¸;ÐG‘	ß Ø# A�w×/Ñ/Ð0°°)°Ð=�	ä#Ÿ[™[ˆNØˆGð ˜6Ô! h°&Ô&8ß1D¤§¢Ì&×J^ÑJ^�Ø" 8 *¨G°H°:¸_ÈYÈKÐWaÐbjÐakÐklÐmsÐt|Õm}Ðl~ð  Zð  [cð  Zdð  deð  flð  muõ  fvð  ewð  wyð  z�Ø—
‘
˜8Õ$ð ˜VÔ#¨Ò(<ÀÐQWÔAWÜ!'§¡�Ø˜h˜ZÐ'7¸Ð7HÈÈyÈkÐYaÐbjÐakÐkuÐv�Ø#)§:¡:¨hÓ#7��xÒ ð ˜VÔ#Ü!'§¡�Ø˜h˜ZÐ'7¸Ð7HÈÈyÈkÐY[Ð\�àÒ"Ð'9Ò'EØ$˜I QÐ'9Ð&:Ð;�÷ +÷ 5¸Ì6Ï;É;Ô9VÜ%+§\¡\‘N÷ :¸nÔPV×P]ÑP]Ô>]Ü%+§[¡[�Nð ¤§¡Ô-Ü  Ó)Ð)à¤F§M¡M´6×3GÑ3GÐ#HÔHÔQi×QkÒQkä—’˜g¤}ÀÕCá˜Ð( Ñ(Ð(r   )ÚinspectÚ	signatureÚsetÚ
parametersÚkeysr   )r<   ÚsigÚfunction_named_argsrA   r=   r?   r"   r>   r   r   r!   r    r@   r   s   f   @@€€€€€€€€r   ÚwrapperÚ deprecate_kwarg.<locals>.wrapperp   sf   û€ ä×Ò Ó%ˆÜ! #§.¡.×"5Ñ"5Ó"7Ó8ÐØ#Ð':Ñ:ÐØÐ#6Ñ6ˆä	ˆt‹÷3	)ö 3	)ó 
ð3	)ðj Ðr   )Ú	packagingr   Úparser   )r   r   r   r   r    r!   r"   Údeprecated_versionÚcurrent_versionrJ   r>   r@   s   f&fffff   @@r   Údeprecate_kwargrP   $   si   ÿ€ ôF #×*Ñ*×0Ñ0°Ó9ÐÜ×'Ñ'×-Ñ-¬kÓ:€OØ"1Ñ"GÐç"Ø>¸w¸iÐH‰à;¸G¸9ÐEˆ÷=ô =ð~ €Nr   )NFFFN)rC   r4   Ú	functoolsr   Úpackaging.versionrL   Ú r   r   r   r   Útorchr	   rP   r   r   r   Ú<module>rU      sB   ðó Û Ý ã å ß HÑ Hñ ×ÒÛôˆ\ô ÷Kñ Kr   