~jY7dZddlmZddlmZmZGddeZGddeZGdd e Z Gd d e Z Gd d ee ZGddeeZGddeZGddeeZGddeZGddeZGddeZGddeZGddeZGddeZGd d!eZGd"d#eZGd$d%eZGd&d'e ZGd(d)e ZGd*d+eZGd,d-eZ Gd.d/e Z!Gd0d1eZ"Gd2d3eZ#Gd4d5eZ$Gd6d7ee$Z%Gd8d9e&e$Z'Gd:d;eeZ(Gd<d=eZ)Gd>d?e)Z*Gd@dAe)Z+GdBdCe+Z,GdDdEeZ-GdFdGe-Z.GdHdIe-Z/GdJdKe-Z0GdLdMeZ1GdNdOe1Z2GdPdQe1Z3GdRdSeZ4GdTdUeZ5GdVdWe5Z6GdXdYe5Z7dZS)[zContains all custom errors.)Path) HTTPErrorResponsecDeZdZUdZeezed<dedeezffd ZxZS) CacheNotFoundz9Exception thrown when the Huggingface cache is not found. cache_dirmsgcPtj|g|Ri|||_dSN)super__init__r)selfr rargskwargs __class__s f/lsinfo/ai/hellotax_ai/data_center/backend/venv/lib/python3.11/site-packages/huggingface_hub/errors.pyr zCacheNotFound.__init__s5.t...v...") __name__ __module__ __qualname____doc__strr__annotations__r __classcell__rs@rrr sgCCTz#C#C$J##########rrceZdZdZdS)CorruptedCacheExceptionzGException for any unexpected structure in the Huggingface cache-system.NrrrrrrrrsQQQQrrceZdZdZdS)LocalTokenNotFoundErrorz0Raised if local token is required but not found.Nrrrrr!r!::::rr!ceZdZdZdS)OfflineModeIsEnabledzTRaised when a request is made but `HF_HUB_OFFLINE=1` is set as environment variable.Nrrrrr$r$#s^^^^rr$c eZdZdZdddedededzffdZded dfd Zededededzd dfd Z d Z xZ 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 sourced from headers in order of precedence: "X-Request-Id", "X-Amzn-Trace-Id", "X-Amz-Cf-Id". - Server error message from the header "X-Error-Message". - Server error message if we can found one in the response body. Example: ```py import httpx 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_messagemessageresponser'c$|jdp3|jdp|jd|_||_||_|j|_t |dS)Nz x-request-idzX-Amzn-Trace-Idz x-amz-cf-id)headersget request_idr'r)requestr r )rr(r)r'rs rr zHfHubHTTPError.__init__Es    0 0 3##$566 3##M22  -  '  !!!!!radditional_messagereturncR|jd|zf|jddz|_dS)zFAppend additional information to the `HfHubHTTPError` initial message.rN)r)rr/s rappend_to_messagez HfHubHTTPError.append_to_messageVs+Yq\$66849QRR=H rc||||S)N)r)r'r)clsr(r)r's r_reconstruct_hf_hub_http_errorz-HfHubHTTPError._reconstruct_hf_hub_http_errorZss7XnMMMMrcR|jjt||j|jffS)zeFix pickling of Exception subclass with kwargs. We need to override __reduce_ex__ of the parent class)rr6rr)r')rprotocols r __reduce_ex__zHfHubHTTPError.__reduce_ex__`s%=D 4=Z^Zm?noor) rrrrrrr r3 classmethodr6r9rrs@rr&r&'sD&* """" " d """""""ICIDIIIINN%-N?BTzN NNN[N ppppppprr&ceZdZdZdS)InferenceTimeoutErrorzBError raised when a model is unavailable or the request times out.Nrrrrr<r<hsLLLLrr<ceZdZdZdS)InferenceEndpointErrorz8Generic exception when dealing with Inference Endpoints.Nrrrrr>r>osBBBBrr>ceZdZdZdS)InferenceEndpointTimeoutErrorz>> from huggingface_hub import bucket_info >>> bucket_info("") (...) huggingface_hub.errors.BucketNotFoundError: 404 Client Error. (Request ID: XXX) Bucket Not Found for url: https://huggingface.co/api/buckets/namespace/name. Please make sure you specified the correct bucket id (namespace/name). If the bucket is private, make sure you are authenticated and your token has the required permissions. ``` N bucket_id)rrrrr^rrrrrr]r]s2*!IsTz     rr]c<eZdZUdZdZedzed<dZedzed<dS)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. Attributes: repo_id (`str` or `None`): The repo id that was not found, if it could be determined from the request URL. repo_type (`str` or `None`): The repo type ("model", "dataset", or "space"), if it could be determined from the request URL. Example: ```py >>> from huggingface_hub import model_info >>> model_info("") (...) huggingface_hub.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 and your token has the required permissions. Invalid username or password. ``` Nrepo_id repo_typerrrrrarrrbrrrr`r`sF2GS4Z IsTz     rr`ceZdZdZdS)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("") (...) huggingface_hub.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. ``` NrrrrreresrreceZdZdZdS)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.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. ``` Nrrrrrgrgrrgc<eZdZUdZdZedzed<dZedzed<dS)RevisionNotFoundErrora Raised when trying to access a hf.co URL with a valid repository but an invalid revision. Attributes: repo_id (`str` or `None`): The repo id, if it could be determined from the request URL. repo_type (`str` or `None`): The repo type ("model", "dataset", or "space"), if it could be determined from the request URL. Example: ```py >>> from huggingface_hub import hf_hub_download >>> hf_hub_download('bert-base-cased', 'config.json', revision='') (...) huggingface_hub.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. ``` Nrarbrcrrrrjrj#F,GS4Z IsTz     rrjceZdZdZdS)EntryNotFoundErrora Raised when entry not found, either locally or remotely. Example: ```py >>> from huggingface_hub import hf_hub_download >>> hf_hub_download('bert-base-cased', '') (...) huggingface_hub.errors.RemoteEntryNotFoundError (...) >>> hf_hub_download('bert-base-cased', '', local_files_only=True) (...) huggingface_hub.utils.errors.LocalEntryNotFoundError (...) ``` Nrrrrrmrm?rhrrmc<eZdZUdZdZedzed<dZedzed<dS)RemoteEntryNotFoundErrora Raised when trying to access a hf.co URL with a valid repository and revision but an invalid filename. Attributes: repo_id (`str` or `None`): The repo id, if it could be determined from the request URL. repo_type (`str` or `None`): The repo type ("model", "dataset", or "space"), if it could be determined from the request URL. Example: ```py >>> from huggingface_hub import hf_hub_download >>> hf_hub_download('bert-base-cased', '') (...) huggingface_hub.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. ``` NrarbrcrrrroroQrkrroc(eZdZdZdeffd ZxZS)LocalEntryNotFoundErroraF 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. Example: ```py >>> from huggingface_hub import hf_hub_download >>> hf_hub_download('bert-base-cased', '', local_files_only=True) (...) huggingface_hub.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(cJt|dSr )r r )rr(rs rr z LocalEntryNotFoundError.__init__{s! !!!!!r)rrrrrr rrs@rrqrqlsN  """""""""""rrqceZdZdZdS)BadRequestErroraG Raised by `hf_raise_for_status` when the server returns a HTTP 400 error. Example: ```py >>> resp = httpx.post("hf.co/api/check", ...) >>> hf_raise_for_status(resp, endpoint_name="check") huggingface_hub.errors.BadRequestError: Bad request for check endpoint: {details} (Request ID: XXX) ``` Nrrrrrtrts    rrtceZdZdZdS) DDUFErrorz5Base exception for errors related to the DDUF format.Nrrrrrvrvs????rrvceZdZdZdS)DDUFCorruptedFileErrorz1Exception thrown when the DDUF file is corrupted.Nrrrrrxrx;;;;rrxceZdZdZdS)DDUFExportErrorz-Base exception for errors during DDUF export.Nrrrrr{r{s7777rr{ceZdZdZdS)DDUFInvalidEntryNameErrorz0Exception thrown when the entry name is invalid.Nrrrrr}r}r"rr}ceZdZdZdS)StrictDataclassErrorz&Base exception for strict dataclasses.Nrrrrrrs0000rrceZdZdZdS)StrictDataclassDefinitionErrorz@Exception thrown when a strict dataclass is defined incorrectly.NrrrrrrsJJJJrrc,eZdZdZdedeffd ZxZS)#StrictDataclassFieldValidationErrorzLException thrown when a strict dataclass fails validation for a given field.fieldcausecd|d}|d|jjd|z }t|dS)NzValidation error for field '': : rrr r )rrr error_messagers rr z,StrictDataclassFieldValidationError.__init__sQ@u@@@ E%/":EEeEEE  '''''rrrrrr Exceptionr rrs@rrrsQVV(c()((((((((((rrc,eZdZdZdedeffd ZxZS)#StrictDataclassClassValidationErrorzOException thrown when a strict dataclass fails validation on a class validator. validatorrcd|d}|d|jjd|z }t|dS)Nz&Class validation error for validator 'rrrr)rrrrrs rr z,StrictDataclassClassValidationError.__init__sQNNNN E%/":EEeEEE  '''''rrrs@rrrsQYY(#(i((((((((((rrceZdZdZdS)XetErrorz1Base exception for errors related to Xet Storage.NrrrrrrryrrceZdZdZdS)XetAuthorizationErrorzXException thrown when the user does not have the right authorization to use Xet Storage.NrrrrrrrYrrceZdZdZdS)XetRefreshTokenErrorz3Exception thrown when the refresh token is invalid.NrrrrrrrHrrceZdZdZdS)XetDownloadErrorz:Exception thrown when the download from Xet Storage fails.NrrrrrrsDDDDrrceZdZdZdS)CLIErrorz7CLI error with clean message (no traceback by default).NrrrrrrsAAAArrceZdZdZdS)ConfirmationErrorzERaised when a confirmation prompt is declined (non-interactive mode).NrrrrrrsOOOOrrceZdZdZdS)CLIExtensionInstallErrorz(Error during CLI extension installation.Nrrrrrrs2222rrN)8rpathlibrhttpxrrrrrEnvironmentErrorr!ConnectionErrorr$OSErrorr& TimeoutErrorr<r>r@rBrErGrJrLrPrRrT ValueErrorrVrXr[r]r`rergrjrmroFileNotFoundErrorrqrtrvrxr{r}rrrrrrrrrrrrrrrs!!%%%%%%%% #####I###RRRRRiRRR;;;;;.;;;_____?___;p;p;p;p;pY;p;p;pBMMMMMI|MMMCCCCCYCCCGGGGG$:LGGGiy>>>>>)>>> ((((()(((     )        )        3        &    ccccc'ccc!!!!!.!!!8!!!!!n!!!<,,*!!!!!N!!!8$!!!!!~/A!!!6"""""/1C"""(     nj   "@@@@@ @@@<<<<((((((((*>(((<<<<>>>>8>>>EEEEEyEEEBBBBByBBBPPPPPPPP33333x33333r