
    PiI                     :    d Z ddlZddlmZ ddlmZ dedefdZdS )zCContains utilities to flag a feature as "experimental" in datasets.    Nwraps)Callablefnreturnc                 <     t                      fd            }|S )al  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                  Z    t          j        dj         dt                      | i |S )N'zI' is experimental and might be subject to breaking changes in the future.)warningswarn__name__UserWarning)argskwargsr   s     o/home/jaya/work/projects/VOICE-AGENT/VIET/agent-env/lib/python3.11/site-packages/datasets/utils/experimental.py	_inner_fnzexperimental.<locals>._inner_fn#   sA    gggg	
 	
 	
 r4"6"""    r   )r   r   s   ` r   experimentalr      s6    6 2YY# # # # Y# r   )__doc__r   	functoolsr   typingr   r    r   r   <module>r      sd    I I             #X #( # # # # # #r   