
    RX9i	                     F    S r SSKrSSKJr  SSKJr  SSKJr  S\S\4S	 jrg)
zJContains utilities to flag a feature as "experimental" in Huggingface Hub.    N)wraps)Callable   )	constantsfnreturnc                    ^ ^ T R                   R                  S5      (       a  T R                   S[        S5      *  OT R                   m[        T 5      U U4S j5       nU$ )a)  Decorator to flag a feature as experimental.

An experimental feature triggers a warning when used as it might be subject to breaking changes without prior notice
in the future.

Warnings can be disabled by setting `HF_HUB_DISABLE_EXPERIMENTAL_WARNING=1` as environment variable.

Args:
    fn (`Callable`):
        The function to flag as experimental.

Returns:
    `Callable`: The decorated function.

Example:

```python
>>> from huggingface_hub.utils import experimental

>>> @experimental
... def my_function():
...     print("Hello world!")

>>> my_function()
UserWarning: 'my_function' is experimental and might be subject to breaking changes in the future without prior
notice. You can disable this warning by setting `HF_HUB_DISABLE_EXPERIMENTAL_WARNING=1` as environment variable.
Hello world!
```
z.__new__Nc                  |   > [         R                  (       d  [        R                  " ST S3[        5        T" U 0 UD6$ )N'z' is experimental and might be subject to breaking changes in the future without prior notice. You can disable this warning by setting `HF_HUB_DISABLE_EXPERIMENTAL_WARNING=1` as environment variable.)r   #HF_HUB_DISABLE_EXPERIMENTAL_WARNINGwarningswarnUserWarning)argskwargsr   names     c/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/huggingface_hub/utils/_experimental.py	_inner_fnexperimental.<locals>._inner_fn9   s@    <<MMD6   	 4"6""    )__qualname__endswithlenr   )r   r   r   s   ` @r   experimentalr      sX    > 35//2J2J:2V2V2??-c*o-.\^\k\kD
2Y# # r   )	__doc__r   	functoolsr   typingr    r   r    r   r   <module>r       s*    Q    ,X ,( ,r   