
    hI                     :    S r SSKrSSKJr  SSKJr  S\S\4S jrg)zCContains utilities to flag a feature as "experimental" in datasets.    Nwraps)Callablefnreturnc                 0   ^  [        T 5      U 4S j5       nU$ )a(  Decorator to flag a feature as experimental.

An experimental feature trigger a warning when used as it might be subject to breaking changes in the future.

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

Returns:
    `Callable`: The decorated function.

Example:

```python
>>> from datasets.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.
Hello world!
```
c                  f   > [         R                  " STR                   S3[        5        T" U 0 UD6$ )N'zI' is experimental and might be subject to breaking changes in the future.)warningswarn__name__UserWarning)argskwargsr   s     U/home/james-whalen/.local/lib/python3.13/site-packages/datasets/utils/experimental.py	_inner_fnexperimental.<locals>._inner_fn#   s5    fg	
 4"6""    r   )r   r   s   ` r   experimentalr      s#    6 2Y# # r   )__doc__r   	functoolsr   typingr   r    r   r   <module>r      s$    I   #X #( #r   