
    HTh+                     l   S r SSKJr  SSKJrJr  SSKJrJr   " S S\	5      r
 " S S\	5      r " S	 S
\5      r " S S\5      r " S S\5      r " S S\\5      r " S S\	5      r " S S\\5      r " S S\	5      r " S S\	5      r " S S\5      r " S S\5      r " S S\5      r " S S \5      r " S! S"\5      r " S# S$\5      r " S% S&\5      r " S' S(\5      r  " S) S*\5      r! " S+ S,\!5      r" " S- S.\5      r# " S/ S0\5      r$ " S1 S2\5      r% " S3 S4\%\&\5      r' " S5 S6\\5      r( " S7 S8\	5      r) " S9 S:\)5      r* " S; S<\)5      r+ " S= S>\+5      r, " S? S@\	5      r- " SA SB\-5      r. " SC SD\-5      r/ " SE SF\-5      r0 " SG SH\	5      r1 " SI SJ\15      r2 " SK SL\15      r3 " SM SN\	5      r4gO)PzContains all custom errors.    )Path)OptionalUnion)	HTTPErrorResponsec                   X   ^  \ rS rSr% Sr\\\4   \S'   S\S\\\4   4U 4S jjr	Sr
U =r$ )CacheNotFound   z9Exception thrown when the Huggingface cache is not found.	cache_dirmsgc                 :   > [         TU ]  " U/UQ70 UD6  X l        g N)super__init__r   )selfr   r   argskwargs	__class__s        N/var/www/auris/envauris/lib/python3.13/site-packages/huggingface_hub/errors.pyr   CacheNotFound.__init__   s    .t.v."    )r   )__name__
__module____qualname____firstlineno____doc__r   strr   __annotations__r   __static_attributes____classcell__r   s   @r   r	   r	      s6    CS$Y#C #E#t),< # #r   r	   c                       \ rS rSrSrSrg)CorruptedCacheException   zGException for any unexpected structure in the Huggingface cache-system. Nr   r   r   r   r   r   r%   r   r   r#   r#      s    Qr   r#   c                       \ rS rSrSrSrg)LocalTokenNotFoundError   z0Raised if local token is required but not found.r%   Nr&   r%   r   r   r(   r(          :r   r(   c                       \ rS rSrSrSrg)OfflineModeIsEnabled$   zTRaised when a request is made but `HF_HUB_OFFLINE=1` is set as environment variable.r%   Nr&   r%   r   r   r,   r,   $   s    ^r   r,   c            	       f   ^  \ rS rSrSrSSS.S\S\\   S\\   4U 4S jjjjrS	\S
S4S jr	Sr
U =r$ )HfHubHTTPError(   a@  
    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responser1   c                   > Ub=  UR                   R                  S5      =(       d    UR                   R                  S5      OS U l        X0l        [        TU ]  UUUb  UR                  OS S9  g )Nzx-request-idzX-Amzn-Trace-Id)r3   request)headersget
request_idr1   r   r   r5   )r   r2   r3   r1   r   s       r   r   HfHubHTTPError.__init__F   ss     #   0[H4D4D4H4HIZ4[ 	
 -(0(<H$$$ 	 	
r   additional_messagereturnc                 T    U R                   S   U-   4U R                   SS -   U l         g)zFAppend additional information to the `HfHubHTTPError` initial message.r      N)r   )r   r:   s     r   append_to_message HfHubHTTPError.append_to_messageT   s)    YYq\$668499QR=H	r   )r   r8   r1   r   )r   r   r   r   r   r   r   r   r   r>   r   r    r!   s   @r   r/   r/   (   sW    :
mq 
 
x/A 
]efi]j 
 
IC ID I Ir   r/   c                       \ rS rSrSrSrg)InferenceTimeoutError\   zBError raised when a model is unavailable or the request times out.r%   Nr&   r%   r   r   rA   rA   \   s    Lr   rA   c                       \ rS rSrSrSrg)InferenceEndpointErrorc   z8Generic exception when dealing with Inference Endpoints.r%   Nr&   r%   r   r   rD   rD   c   s    Br   rD   c                       \ rS rSrSrSrg)InferenceEndpointTimeoutErrorg   z<Exception for timeouts while waiting for Inference Endpoint.r%   Nr&   r%   r   r   rG   rG   g   s    Fr   rG   c                       \ rS rSrSrSrg)SafetensorsParsingErrorn   zRaised 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.
r%   Nr&   r%   r   r   rJ   rJ   n       r   rJ   c                       \ rS rSrSrSrg)NotASafetensorsRepoErroru   zRaised when a repo is not a Safetensors repo i.e. doesn't have either a `model.safetensors` or a
`model.safetensors.index.json` file.
r%   Nr&   r%   r   r   rN   rN   u   s    r   rN   c                       \ rS rSrSrSrg)TextGenerationError~   z3Generic error raised if text-generation went wrong.r%   Nr&   r%   r   r   rQ   rQ   ~       =r   rQ   c                       \ rS rSrSrSrg)ValidationError   zServer-side validation error.r%   Nr&   r%   r   r   rU   rU      s    'r   rU   c                       \ rS rSrSrg)GenerationError   r%   Nr   r   r   r   r   r%   r   r   rX   rX          r   rX   c                       \ rS rSrSrg)OverloadedError   r%   NrZ   r%   r   r   r]   r]      r[   r   r]   c                       \ rS rSrSrg)IncompleteGenerationError   r%   NrZ   r%   r   r   r`   r`      r[   r   r`   c                       \ rS rSrSrg)UnknownError   r%   NrZ   r%   r   r   rc   rc      r[   r   rc   c                       \ rS rSrSrSrg)HFValidationError   zGeneric exception thrown by `huggingface_hub` validators.

Inherits from [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError).
r%   Nr&   r%   r   r   rf   rf      rL   r   rf   c                       \ rS rSrSrSrg)FileMetadataError   zError triggered when the metadata of a file on the Hub cannot be retrieved (missing ETag or commit_hash).

Inherits from `OSError` for backward compatibility.
r%   Nr&   r%   r   r   ri   ri      rL   r   ri   c                       \ rS rSrSrSrg)RepositoryNotFoundError   ae  
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.
```
r%   Nr&   r%   r   r   rl   rl      s    r   rl   c                       \ rS rSrSrSrg)GatedRepoError   a  
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.
```
r%   Nr&   r%   r   r   ro   ro      s    r   ro   c                       \ rS rSrSrSrg)DisabledRepoError   a  
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.
```
r%   Nr&   r%   r   r   rr   rr          r   rr   c                       \ rS rSrSrSrg)RevisionNotFoundError   a  
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.
```
r%   Nr&   r%   r   r   rv   rv      rt   r   rv   c                       \ rS rSrSrSrg)EntryNotFoundErrori  a  
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.
```
r%   Nr&   r%   r   r   ry   ry     rt   r   ry   c                   4   ^  \ rS rSrSrS\4U 4S jjrSrU =r$ )LocalEntryNotFoundErrori  a  
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.
```
r2   c                 "   > [         TU ]  US S9  g )N)r3   )r   r   )r   r2   r   s     r   r    LocalEntryNotFoundError.__init__&  s    40r   r%   )	r   r   r   r   r   r   r   r   r    r!   s   @r   r{   r{     s    $1 1 1r   r{   c                       \ rS rSrSrSrg)BadRequestErrori+  a1  
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)
```
r%   Nr&   r%   r   r   r   r   +  s    
r   r   c                       \ rS rSrSrSrg)	DDUFErrori<  z5Base exception for errors related to the DDUF format.r%   Nr&   r%   r   r   r   r   <  s    ?r   r   c                       \ rS rSrSrSrg)DDUFCorruptedFileErrori@  z1Exception thrown when the DDUF file is corrupted.r%   Nr&   r%   r   r   r   r   @      ;r   r   c                       \ rS rSrSrSrg)DDUFExportErroriD  z-Base exception for errors during DDUF export.r%   Nr&   r%   r   r   r   r   D  s    7r   r   c                       \ rS rSrSrSrg)DDUFInvalidEntryNameErroriH  z0Exception thrown when the entry name is invalid.r%   Nr&   r%   r   r   r   r   H  r*   r   r   c                       \ rS rSrSrSrg)StrictDataclassErroriO  z&Base exception for strict dataclasses.r%   Nr&   r%   r   r   r   r   O  s    0r   r   c                       \ rS rSrSrSrg)StrictDataclassDefinitionErroriS  z@Exception thrown when a strict dataclass is defined incorrectly.r%   Nr&   r%   r   r   r   r   S  s    Jr   r   c                   8   ^  \ rS rSrSrS\S\4U 4S jjrSrU =r	$ )#StrictDataclassFieldValidationErroriW  zLException thrown when a strict dataclass fails validation for a given field.fieldcausec                 n   > SU S3nUSUR                   R                   SU 3-  n[        TU ]  U5        g )NzValidation error for field '':
    : r   r   r   r   )r   r   r   error_messager   s       r   r   ,StrictDataclassFieldValidationError.__init__Z  s@    6ugR@6%//":":!;2eWEE'r   r%   
r   r   r   r   r   r   	Exceptionr   r   r    r!   s   @r   r   r   W  s    V(c () ( (r   r   c                   8   ^  \ rS rSrSrS\S\4U 4S jjrSrU =r	$ )#StrictDataclassClassValidationErrori`  zOException thrown when a strict dataclass fails validation on a class validator.	validatorr   c                 n   > SU S3nUSUR                   R                   SU 3-  n[        TU ]  U5        g )Nz&Class validation error for validator 'r   r   r   r   )r   r   r   r   r   s       r   r   ,StrictDataclassClassValidationError.__init__c  s@    @2N6%//":":!;2eWEE'r   r%   r   r!   s   @r   r   r   `  s    Y(# (i ( (r   r   c                       \ rS rSrSrSrg)XetErroril  z1Base exception for errors related to Xet Storage.r%   Nr&   r%   r   r   r   r   l  r   r   r   c                       \ rS rSrSrSrg)XetAuthorizationErrorip  zXException thrown when the user does not have the right authorization to use Xet Storage.r%   Nr&   r%   r   r   r   r   p  s    br   r   c                       \ rS rSrSrSrg)XetRefreshTokenErrorit  z3Exception thrown when the refresh token is invalid.r%   Nr&   r%   r   r   r   r   t  rS   r   r   c                       \ rS rSrSrSrg)XetDownloadErrorix  z:Exception thrown when the download from Xet Storage fails.r%   Nr&   r%   r   r   r   r   x  s    Dr   r   N)5r   pathlibr   typingr   r   requestsr   r   r   r	   r#   EnvironmentErrorr(   ConnectionErrorr,   r/   TimeoutErrorrA   rD   rG   rJ   rN   rQ   rU   rX   r]   r`   rc   
ValueErrorrf   OSErrorri   rl   ro   rr   rv   ry   FileNotFoundErrorr{   r   r   r   r   r   r   r   r   r   r   r   r   r   r%   r   r   <module>r      s   !  " (#I #Ri R;. ;_? _.IY .IhMI| MCY CG$:L Gi y >) >
() (	) 		) 		 3 		& 	
  n *, , *N & $102CZ 10nj "@	 @<Y <8i 8; ;19 1K%9 K(*> ((*> (<y <cH c>8 >Ey Er   