U h6-@sdZddlmZddlZddlZddlZddlmZddlm Z m Z ddl m Z ddl mZz(ddlmZmZdd lmZmZd ZWnek rd ZYnXeeZd d d ddZGdddZdS)zThis module provides mixin functionality for the Albumentations library. It includes utility functions and classes to enhance the core capabilities. ) annotationsN)Path)AnyCallable)load)save)HfApihf_hub_download)HfHubHTTPErrorSoftTemporaryDirectoryTFzCallable[..., Any])funcreturncs$tddddfdd }|S)Nr)argskwargsr cs tstdjd||S)Nz-You need to install `huggingface_hub` to use zJ. Run `pip install huggingface_hub`, or `pip install albumentations[hub]`.)is_huggingface_hub_available ImportError__name__)rrr A/tmp/pip-unpacked-wheel-e8onvpoz/albumentations/core/hub_mixin.pywrappers  z(require_huggingface_hub..wrapper) functoolswraps)r rrrrrequire_huggingface_hubsrc @seZdZdZdZddddddZeddd dd d Zd d dd dddddddddddZed d dddd dddddddddddd d ddZ e d d dd dddddddddddddd d!d"Z dS)#HubMixin)Ztrainevalzalbumentations_config_{}.jsonz str | Pathstrr)save_directoryfilenamer cCs0t|}|jddd||}t||dd|S)aJSave the transform to a specified directory. Args: save_directory (Union[str, Path]): Directory where the transform will be saved. filename (str): Name of the file to save the transform. Returns: Path: Path to the saved transform file. T)parentsexist_okjsonZ data_format)rmkdirsave_transform)selfrr save_pathrrr_save_pretrained,s zHubMixin._save_pretrainedobjectcCst||}t|ddS)aJLoad a transform from a specified directory. Args: save_directory (Union[str, Path]): Directory from where the transform will be loaded. filename (str): Name of the file to load the transform from. Returns: A.Compose: Loaded transform. r!r")rload_transform)clsrrr&rrr_from_pretrainedBs zHubMixin._from_pretrainedrFN)keyallow_custom_keysrepo_id push_to_hubboolz str | Noner)rr,r-r.r/push_to_hub_kwargsr c Ksv|s&||jkr&td|d|jd|j|}||||rr|}|dkr\t|j}|jf||d|SdS)a5Save the transform and optionally push it to the Huggingface Hub. Args: save_directory (`str` or `Path`): Path to directory in which the transform configuration will be saved. key (`str`, *optional*): Key to identify the configuration type, one of ["train", "eval"]. Defaults to "eval". allow_custom_keys (`bool`, *optional*): Allow custom keys for the configuration. Defaults to False. push_to_hub (`bool`, *optional*, defaults to `False`): Whether or not to push your transform to the Huggingface Hub after saving it. repo_id (`str`, *optional*): ID of your repository on the Hub. Used only if `push_to_hub=True`. Will default to the folder name if not provided. push_to_hub_kwargs: Additional key word arguments passed along to the [`push_to_hub`] method. Returns: `str` or `None`: url of the commit on the Hub if `push_to_hub=True`, `None` otherwise. Invalid key: ``. Please use key from zP keys for upload. If you want to use a custom key, set `allow_custom_keys=True`.N)r.r,) _CONFIG_KEYS ValueError_CONFIG_FILE_NAME_TEMPLATEformatr'copyrnamer/) r%rr,r-r.r/r1rrrrrsave_pretrainedRs   zHubMixin.save_pretrained)r,force_downloadproxiestoken cache_dirlocal_files_onlyrevisionzdict[str, str] | Nonezstr | bool | Nonezstr | Path | None) r*directory_or_repo_idr,r;r<r=r>r?r@r c Cs|j|} t|}d} |r~| t|kr>|j|| d} n@trbt | dt| dnt | dt| d| dk r| Sz>t || ||||||d} t| j t| j} } |j| | dWStk r} zt| d| W5d} ~ XYnXdS)aLoad a transform from the Huggingface Hub or a local directory. Args: directory_or_repo_id (`str`, `Path`): - Either the `repo_id` (string) of a repo with hosted transform on the Hub, e.g. `qubvel-hf/albu`. - Or a path to a `directory` containing transform config saved using [`~albumentations.Compose.save_pretrained`], e.g., `../path/to/my_directory/`. key (`str`, *optional*): Key to identify the configuration type, one of ["train", "eval"]. Defaults to "eval". revision (`str`, *optional*): Revision of the repo on the Hub. Can be a branch name, a git tag or any commit id. Defaults to the latest commit on `main` branch. force_download (`bool`, *optional*, defaults to `False`): Whether to force (re-)downloading the transform configuration files from the Hub, overriding the existing cache. proxies (`dict[str, str]`, *optional*): A dictionary of proxy servers to use by protocol or endpoint, e.g., `{'http': 'foo.bar:3128', 'http://hostname': 'foo.bar:4012'}`. The proxies are used on every request. token (`str` or `bool`, *optional*): The token to use as HTTP bearer authorization for remote files. By default, it will use the token cached when running `huggingface-cli login`. cache_dir (`str`, `Path`, *optional*): Path to the folder where cached files are stored. local_files_only (`bool`, *optional*, defaults to `False`): If `True`, avoid downloading the file and return the path to the local cached file if it exists. N)rrz not found in z, trying to load from the Hub.z8. Please install `huggingface_hub` to load from the Hub.)r.rr@r>r;r<r=r?z! not found on the HuggingFace Hub)r6r7ris_diroslistdirr+rlogginginforesolveFileNotFoundErrorr parentr9r )r*rAr,r;r<r=r>r?r@rZ transform config_file directoryerrrfrom_pretraineds<'  zHubMixin.from_pretrainedz%Push transform using huggingface_hub.)r,r-commit_messageprivater=branch create_prz bool | None) r.r,r-rNrOr=rPrQr c Cs|s&||jkr&td|d|jdt|d} | j||ddj}tJ} t| |} |j|} |j | | d} | j | | ||||dW5QRSQRXd S) aPush the transform to the Huggingface Hub. Use `allow_patterns` and `ignore_patterns` to precisely filter which files should be pushed to the hub. Use `delete_patterns` to delete existing remote files in the same commit. See [`upload_folder`] reference for more details. Args: repo_id (`str`): ID of the repository to push to (example: `"username/my-model"`). key (`str`, *optional*): Key to identify the configuration type, one of ["train", "eval"]. Defaults to "eval". allow_custom_keys (`bool`, *optional*): Allow custom keys for the configuration. Defaults to False. commit_message (`str`, *optional*): Message to commit while pushing. private (`bool`, *optional*, defaults to `False`): Whether the repository created should be private. token (`str`, *optional*): The token to use as HTTP bearer authorization for remote files. By default, it will use the token cached when running `huggingface-cli login`. branch (`str`, *optional*): The git branch on which to push the transform. This defaults to `"main"`. create_pr (`boolean`, *optional*): Whether or not to create a Pull Request from `branch` with that commit. Defaults to `False`. Returns: The url of the commit of your transform in the given repository. r2r3zV keys for upload. If you still want to use a custom key, set `allow_custom_keys=True`.)r=T)r.rOr )r)Zpath_or_fileobjZ path_in_repor.rNr@rQN) r4r5rZ create_repor.r rr6r7r'Z upload_file)r%r.r,r-rNrOr=rPrQapitmprrr&rrrr/s$)   zHubMixin.push_to_hub) r __module__ __qualname__r4r6r' classmethodr+r:rMrr/rrrrr(s80&Lr)__doc__ __future__rrrErCpathlibrtypingrrZ!albumentations.core.serializationrr)rr$Zhuggingface_hubrr Zhuggingface_hub.utilsr r rr getLoggerrloggerrrrrrrs"