
    g<$                        d Z ddlmZ ddlmZmZ ddlmZmZ  G d de	          Z
 G d de	          Z G d	 d
e          Z G d de          Z G d de          Z G d dee          Z G d de	          Z G d dee          Z G d de	          Z G d de	          Z G d de          Z G d de          Z G d de          Z G d d e          Z G d! d"e          Z G d# d$e          Z G d% d&e          Z G d' d(e          Z  G d) d*e          Z! G d+ d,e!          Z" G d- d.e          Z# G d/ d0e          Z$ G d1 d2e          Z% G d3 d4e%e&e          Z' G d5 d6ee          Z(d7S )8zContains all custom errors.    )Path)OptionalUnion)	HTTPErrorResponsec                   X     e Zd ZU dZeeef         ed<   dedeeef         f fdZ xZ	S )CacheNotFoundz9Exception thrown when the Huggingface cache is not found.	cache_dirmsgc                 P     t                      j        |g|R i | || _        d S N)super__init__r
   )selfr   r
   argskwargs	__class__s        R/var/www/html/ai-engine/env/lib/python3.11/site-packages/huggingface_hub/errors.pyr   zCacheNotFound.__init__   s5    .t...v..."    )
__name__
__module____qualname____doc__r   strr   __annotations__r   __classcell__r   s   @r   r	   r	      sq         CCS$Y#C #E#t),< # # # # # # # # # #r   r	   c                       e Zd ZdZdS )CorruptedCacheExceptionzGException for any unexpected structure in the Huggingface cache-system.Nr   r   r   r    r   r   r   r      s        QQQQr   r   c                       e Zd ZdZdS )LocalTokenNotFoundErrorz0Raised if local token is required but not found.Nr    r!   r   r   r#   r#      s        ::::r   r#   c                       e Zd ZdZdS )OfflineModeIsEnabledzTRaised when a request is made but `HF_HUB_OFFLINE=1` is set as environment variable.Nr    r!   r   r   r%   r%   $   s        ^^^^r   r%   c            	       `     e Zd ZdZddddedee         dee         f fdZded	dfd
Z xZ	S )HfHubHTTPErrora@  
    HTTPError to inherit from for any custom HTTP Error raised in HF Hub.

    Any HTTPError is converted at least into a `HfHubHTTPError`. If some information is
    sent back by the server, it will be added to the error message.

    Added details:
    - Request id from "X-Request-Id" header if exists. If not, fallback to "X-Amzn-Trace-Id" header if exists.
    - Server error message from the header "X-Error-Message".
    - Server error message if we can found one in the response body.

    Example:
    ```py
        import requests
        from huggingface_hub.utils import get_session, hf_raise_for_status, HfHubHTTPError

        response = get_session().post(...)
        try:
            hf_raise_for_status(response)
        except HfHubHTTPError as e:
            print(str(e)) # formatted message
            e.request_id, e.server_message # details returned by server

            # Complete the error message with additional information once it's raised
            e.append_to_message("
`create_commit` expects the repository to exist.")
            raise
    ```
    N)server_messagemessageresponser(   c                    |4|j                             d          p|j                             d          nd | _        || _        t	                                          ||||j        nd            d S )Nzx-request-idzX-Amzn-Trace-Id)r*   request)headersget
request_idr(   r   r   r,   )r   r)   r*   r(   r   s       r   r   zHfHubHTTPError.__init__F   s     #   00[H4D4H4HIZ4[4[ 	
 -(0(<H$$$ 	 	
 	
 	
 	
 	
r   additional_messagereturnc                 R    | j         d         |z   f| j         dd         z   | _         dS )zFAppend additional information to the `HfHubHTTPError` initial message.r      N)r   )r   r0   s     r   append_to_messagez HfHubHTTPError.append_to_messageT   s+    Yq\$66849QRR=H			r   r   )
r   r   r   r   r   r   r   r   r4   r   r   s   @r   r'   r'   (   s         :
mq 
 
 
 
x/A 
]efi]j 
 
 
 
 
 
IC ID I I I I I I I Ir   r'   c                       e Zd ZdZdS )InferenceTimeoutErrorzBError raised when a model is unavailable or the request times out.Nr    r!   r   r   r6   r6   \   s        LLLLr   r6   c                       e Zd ZdZdS )InferenceEndpointErrorz8Generic exception when dealing with Inference Endpoints.Nr    r!   r   r   r8   r8   c   s        BBBBr   r8   c                       e Zd ZdZdS )InferenceEndpointTimeoutErrorz<Exception for timeouts while waiting for Inference Endpoint.Nr    r!   r   r   r:   r:   g   s        FFFFr   r:   c                       e Zd ZdZdS )SafetensorsParsingErrorzRaised when failing to parse a safetensors file metadata.

    This can be the case if the file is not a safetensors file or does not respect the specification.
    Nr    r!   r   r   r<   r<   n              r   r<   c                       e Zd ZdZdS )NotASafetensorsRepoErrorzRaised when a repo is not a Safetensors repo i.e. doesn't have either a `model.safetensors` or a
    `model.safetensors.index.json` file.
    Nr    r!   r   r   r?   r?   u   s           r   r?   c                       e Zd ZdZdS )TextGenerationErrorz3Generic error raised if text-generation went wrong.Nr    r!   r   r   rA   rA   ~   s        ====r   rA   c                       e Zd ZdZdS )ValidationErrorzServer-side validation error.Nr    r!   r   r   rC   rC      s        ''''r   rC   c                       e Zd ZdS )GenerationErrorNr   r   r   r!   r   r   rE   rE              Dr   rE   c                       e Zd ZdS )OverloadedErrorNrF   r!   r   r   rI   rI      rG   r   rI   c                       e Zd ZdS )IncompleteGenerationErrorNrF   r!   r   r   rK   rK      rG   r   rK   c                       e Zd ZdS )UnknownErrorNrF   r!   r   r   rM   rM      rG   r   rM   c                       e Zd ZdZdS )HFValidationErrorzGeneric exception thrown by `huggingface_hub` validators.

    Inherits from [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError).
    Nr    r!   r   r   rO   rO      r=   r   rO   c                       e Zd ZdZdS )FileMetadataErrorzError triggered when the metadata of a file on the Hub cannot be retrieved (missing ETag or commit_hash).

    Inherits from `OSError` for backward compatibility.
    Nr    r!   r   r   rQ   rQ      r=   r   rQ   c                       e Zd ZdZdS )RepositoryNotFoundErrora  
    Raised when trying to access a hf.co URL with an invalid repository name, or
    with a private repo name the user does not have access to.

    Example:

    ```py
    >>> from huggingface_hub import model_info
    >>> model_info("<non_existent_repository>")
    (...)
    huggingface_hub.utils._errors.RepositoryNotFoundError: 401 Client Error. (Request ID: PvMw_VjBMjVdMz53WKIzP)

    Repository Not Found for url: https://huggingface.co/api/models/%3Cnon_existent_repository%3E.
    Please make sure you specified the correct `repo_id` and `repo_type`.
    If the repo is private, make sure you are authenticated.
    Invalid username or password.
    ```
    Nr    r!   r   r   rS   rS      s           r   rS   c                       e Zd ZdZdS )GatedRepoErrora  
    Raised when trying to access a gated repository for which the user is not on the
    authorized list.

    Note: derives from `RepositoryNotFoundError` to ensure backward compatibility.

    Example:

    ```py
    >>> from huggingface_hub import model_info
    >>> model_info("<gated_repository>")
    (...)
    huggingface_hub.utils._errors.GatedRepoError: 403 Client Error. (Request ID: ViT1Bf7O_026LGSQuVqfa)

    Cannot access gated repo for url https://huggingface.co/api/models/ardent-figment/gated-model.
    Access to model ardent-figment/gated-model is restricted and you are not in the authorized list.
    Visit https://huggingface.co/ardent-figment/gated-model to ask for access.
    ```
    Nr    r!   r   r   rU   rU      s           r   rU   c                       e Zd ZdZdS )DisabledRepoErrora  
    Raised when trying to access a repository that has been disabled by its author.

    Example:

    ```py
    >>> from huggingface_hub import dataset_info
    >>> dataset_info("laion/laion-art")
    (...)
    huggingface_hub.utils._errors.DisabledRepoError: 403 Client Error. (Request ID: Root=1-659fc3fa-3031673e0f92c71a2260dbe2;bc6f4dfb-b30a-4862-af0a-5cfe827610d8)

    Cannot access repository for url https://huggingface.co/api/datasets/laion/laion-art.
    Access to this resource is disabled.
    ```
    Nr    r!   r   r   rW   rW                 r   rW   c                       e Zd ZdZdS )RevisionNotFoundErrora  
    Raised when trying to access a hf.co URL with a valid repository but an invalid
    revision.

    Example:

    ```py
    >>> from huggingface_hub import hf_hub_download
    >>> hf_hub_download('bert-base-cased', 'config.json', revision='<non-existent-revision>')
    (...)
    huggingface_hub.utils._errors.RevisionNotFoundError: 404 Client Error. (Request ID: Mwhe_c3Kt650GcdKEFomX)

    Revision Not Found for url: https://huggingface.co/bert-base-cased/resolve/%3Cnon-existent-revision%3E/config.json.
    ```
    Nr    r!   r   r   rZ   rZ      rX   r   rZ   c                       e Zd ZdZdS )EntryNotFoundErrora  
    Raised when trying to access a hf.co URL with a valid repository and revision
    but an invalid filename.

    Example:

    ```py
    >>> from huggingface_hub import hf_hub_download
    >>> hf_hub_download('bert-base-cased', '<non-existent-file>')
    (...)
    huggingface_hub.utils._errors.EntryNotFoundError: 404 Client Error. (Request ID: 53pNl6M0MxsnG5Sw8JA6x)

    Entry Not Found for url: https://huggingface.co/bert-base-cased/resolve/main/%3Cnon-existent-file%3E.
    ```
    Nr    r!   r   r   r\   r\     rX   r   r\   c                   (     e Zd ZdZdef fdZ xZS )LocalEntryNotFoundErrora  
    Raised when trying to access a file or snapshot that is not on the disk when network is
    disabled or unavailable (connection issue). The entry may exist on the Hub.

    Note: `ValueError` type is to ensure backward compatibility.
    Note: `LocalEntryNotFoundError` derives from `HTTPError` because of `EntryNotFoundError`
          even when it is not a network issue.

    Example:

    ```py
    >>> from huggingface_hub import hf_hub_download
    >>> hf_hub_download('bert-base-cased', '<non-cached-file>',  local_files_only=True)
    (...)
    huggingface_hub.utils._errors.LocalEntryNotFoundError: Cannot find the requested files in the disk cache and outgoing traffic has been disabled. To enable hf.co look-ups and downloads online, set 'local_files_only' to False.
    ```
    r)   c                 N    t                                          |d            d S )N)r*   )r   r   )r   r)   r   s     r   r   z LocalEntryNotFoundError.__init__&  s&    400000r   )r   r   r   r   r   r   r   r   s   @r   r^   r^     sN         $1 1 1 1 1 1 1 1 1 1 1r   r^   c                       e Zd ZdZdS )BadRequestErroraQ  
    Raised by `hf_raise_for_status` when the server returns a HTTP 400 error.

    Example:

    ```py
    >>> resp = requests.post("hf.co/api/check", ...)
    >>> hf_raise_for_status(resp, endpoint_name="check")
    huggingface_hub.utils._errors.BadRequestError: Bad request for check endpoint: {details} (Request ID: XXX)
    ```
    Nr    r!   r   r   ra   ra   +  s        
 
 
 
r   ra   N))r   pathlibr   typingr   r   requestsr   r   	Exceptionr	   r   EnvironmentErrorr#   ConnectionErrorr%   r'   TimeoutErrorr6   r8   r:   r<   r?   rA   rC   rE   rI   rK   rM   
ValueErrorrO   OSErrorrQ   rS   rU   rW   rZ   r\   FileNotFoundErrorr^   ra   r!   r   r   <module>rl      s   ! !       " " " " " " " " ( ( ( ( ( ( ( (# # # # #I # # #R R R R Ri R R R; ; ; ; ;. ; ; ;_ _ _ _ _? _ _ _.I .I .I .I .IY .I .I .IhM M M M MI| M M MC C C C CY C C CG G G G G$:L G G G    i       y   > > > > >) > > >
( ( ( ( () ( ( (	 	 	 	 	) 	 	 		 	 	 	 	) 	 	 		 	 	 	 	 3 	 	 		 	 	 	 	& 	 	 	    
              n   *    ,   ,       *    N   &       $1 1 1 1 102CZ 1 1 10    nj     r   