gddlZddlZddlmZddlmZddlZddlm Z ddlm Z Gdd e Z dd e d e d ee de de de dee fdZdS)N)wraps)Optional) __version__) ExplicitEnumceZdZdZdZdZdZdS)Actionnonenotify notify_alwaysraiseN)__name__ __module__ __qualname__NONENOTIFY NOTIFY_ALWAYSRAISEZ/var/www/html/ai-engine/env/lib/python3.11/site-packages/transformers/utils/deprecation.pyr r s" D F#M EEErr Fold_nameversionnew_name warn_if_greater_or_equal_version!raise_if_greater_or_equal_versionraise_if_both_namesadditional_messagec tj|}tjt}||k rd| nd|   fd} | S)a Function or method decorator to notify users about deprecated keyword arguments, replacing them with a new name if specified. 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 zand will be removed in version c tj}t|j}d|vd|vt  f d}|S)NselfclscD j} r|djjd|}nr|djd|}tj}d} |vrX |vrT r tjn tj}d d d|d d| d d| d }| nZ |vr: 8 |vr4tj}d d d |d d }| | <n |vrtj}d d d |d }| |d}r= r|tjkr tj}ns|tjkr tj}|tjkrt||tjtjfvrtj |td|i|S)Nr.zBoth `z` and `z` are set for `z `. Using `=z` and ignoring deprecated `z`.`z` is deprecated z for `z`. Use `z ` instead. r) stacklevel) r __class__r rrrpopr ValueErrorwarningswarn FutureWarning)argskwargs func_nameminimum_actionmessagerfuncis_class_methodis_greater_or_equal_versionis_instance_methodrrrrversion_messagers r wrapped_funcz6deprecate_kwarg..wrapper..wrapped_funcrs I! >#Aw09GGIGG   >#Aw/==)== #[NG6!!h&&8&81D!^&J^z8zzHzzYzzbjzzmst|m}zz[czzflmufvzzz 8$$$$V##(<QWAWAW!'vhvvvvyvvbjvvv#)::h#7#7x  V##!'\h\\\\y\\\"'9'E$;;'9;;+ 1516;9V9V%+\NN:1nPVP]>]>]%+[N-- )))FM63G#HHH g}CCCC4((( (r)inspect signatureset parameterskeysr)r5sigfunction_named_argsr:r6r8rr7rrrrr9rs` @@rwrapperz deprecate_kwarg..wrapperks%%!#."5"5"7"788#'::#66 t2 )2 )2 )2 )2 )2 )2 )2 )2 )2 )2 )2 )2 )2 ) 2 )hr) packagingrparser) rrrrrrrdeprecated_versioncurrent_versionrBr7r9s ` ````` @@rdeprecate_kwargrG sD#*0099'--k::O"15G"G"FHwHHEGEE<<<<<<<<<<<<| Nr)NFFFN)r;r- functoolsrtypingrpackaging.versionrCrrr strboolrGrrrrNs#\#-2.3 %(,III IsmI'+ I (, I  I! IIIIIIr