o  h@sddlZddlZddlmZddlmZddlZddlm Z ddlm Z m Z m Z e r/ddl Z Gdd d e Z  dd ed ed eededededeefddZdS)N)wraps)Optional) __version__) ExplicitEnumis_torch_availableis_torchdynamo_compilingc@seZdZdZdZdZdZdS)Actionnonenotify notify_alwaysraiseN)__name__ __module__ __qualname__NONENOTIFY NOTIFY_ALWAYSRAISErrr/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/transformers/utils/deprecation.pyr s r Fold_nameversionnew_name warn_if_greater_or_equal_version!raise_if_greater_or_equal_versionraise_if_both_namesadditional_messagec sXtj|}tjt}||krd|nd|fdd} | S)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 zand will be removed in version c sTt}t|j}d|vd|vt f dd}|S)Nselfclscsj}r|djjd|}n r|djd|}tj}d}|vrT|vrTr/tjntj}ddd|dd|dd|d }|n9|vrzdurz|vrztj}d d d |d d }||<n|vrtj}d d d |d }|durdur|d}rr|tjkrtj}n s|tjkrtj}|tjkrt||tjtjfvrt st j |t dd|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 ValueErrorr warningswarn FutureWarning)argskwargs func_nameminimum_actionmessage) rfuncis_class_methodis_greater_or_equal_versionis_instance_methodrrrrversion_messagerrr wrapped_funcxs<8  z6deprecate_kwarg..wrapper..wrapped_func)inspect signatureset parameterskeysr)r1sigfunction_named_argsr6rr3rrrrr5r)r1r2r4rwrapperqs "5z deprecate_kwarg..wrapper) packagingrparser) rrrrrrrdeprecated_versioncurrent_versionr?rr>rdeprecate_kwarg%s C   ?rD)NFFFN)r7r) functoolsrtypingrpackaging.versionr@rrrr torchr strboolrDrrrrs<