9i.SrSSKJr SSKJrJr SSKJrJr "SS\ 5r "SS\ 5r "S S \ 5r "S S \5r"S S\\5r"SS\\5r"SS\ 5r"SS\\5r"SS\ 5r"SS\ 5r"SS\5r"SS\5r"SS\5r"SS \5r"S!S"\5r"S#S$\5r"S%S&\5r"S'S(\5r "S)S*\5r!"S+S,\5r""S-S.\"5r#"S/S0\5r$"S1S2\5r%"S3S4\ 5r&"S5S6\\&5r'"S7S8\(\&5r)"S9S:\\5r*"S;S<\ 5r+"S=S>\+5r,"S?S@\+5r-"SASB\-5r."SCSD\ 5r/"SESF\/5r0"SGSH\/5r1"SISJ\/5r2"SKSL\ 5r3"SMSN\35r4"SOSP\35r5"SQSR\ 5r6gS)TzContains all custom errors.)Path)OptionalUnion) HTTPErrorResponsecX^\rSrSr%Sr\\\4\S'S\S\\\44U4Sjjr Sr U=r $) CacheNotFound z9Exception thrown when the Huggingface cache is not found. cache_dirmsgc:>[TU]"U/UQ70UD6 X lgN)super__init__r )selfr r argskwargs __class__s V/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/huggingface_hub/errors.pyrCacheNotFound.__init__s .t.v.")r ) __name__ __module__ __qualname____firstlineno____doc__rstrr__annotations__r__static_attributes__ __classcell__rs@rr r s6CS$Y#C#E#t),<##rr c\rSrSrSrSrg)CorruptedCacheExceptionzGException for any unexpected structure in the Huggingface cache-system.Nrrrrrrr%rrr#r#sQrr#c\rSrSrSrSrg)LocalTokenNotFoundErrorz0Raised if local token is required but not found.r%Nr&r%rrr(r(:rr(c\rSrSrSrSrg)OfflineModeIsEnabled$zTRaised when a request is made but `HF_HUB_OFFLINE=1` is set as environment variable.r%Nr&r%rrr,r,$s^rr,c ^\rSrSrSrSS.S\S\S\\4U4SjjjrS \S S4S jr \ S\S\S\\S S4S j5r S r Sr 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 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_messagemessageresponser1c>URRS5=(d URRS5UlX0lX lUR Ul[ TU]U5 g)Nz x-request-idzX-Amzn-Trace-Id)headersget request_idr1r3requestrr)rr2r3r1rs rrHfHubHTTPError.__init__FsY#**..~>i(BRBRBVBVWhBi, ''  !radditional_messagereturncTURSU-4URSS-Ulg)zFAppend additional information to the `HfHubHTTPError` initial message.rN)r)rr:s rappend_to_message HfHubHTTPError.append_to_messageSs)YYq\$668499QR=H rcU"XUS9$)N)r3r1r%)clsr2r3r1s r_reconstruct_hf_hub_http_error-HfHubHTTPError._reconstruct_hf_hub_http_errorWs7nMMrcrURR[U5URUR44$)zeFix pickling of Exception subclass with kwargs. We need to override __reduce_ex__ of the parent class)rrBrr3r1)rprotocols r __reduce_ex__HfHubHTTPError.__reduce_ex__]s-==D 4==Z^ZmZm?noor)rr8r7r3r1)rrrrrrrrrr> classmethodrBrFrr r!s@rr/r/(sD)- " " " ! " "ICIDINN%-N?G}N NN pprr/c\rSrSrSrSrg)InferenceTimeoutErrorezBError raised when a model is unavailable or the request times out.r%Nr&r%rrrJrJesLrrJc\rSrSrSrSrg)InferenceEndpointErrorlz8Generic exception when dealing with Inference Endpoints.r%Nr&r%rrrMrMlsBrrMc\rSrSrSrSrg)InferenceEndpointTimeoutErrorpz>> 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. Invalid username or password. ``` r%Nr&r%rrryrysrryc\rSrSrSrSrg)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. ``` r%Nr&r%rrr|r|srr|c\rSrSrSrSrg)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. ``` r%Nr&r%rrrrrrc\rSrSrSrSrg)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='') (...) 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. ``` r%Nr&r%rrrrrrrc\rSrSrSrSrg)EntryNotFoundErroria 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 (...) ``` r%Nr&r%rrrrrrrc\rSrSrSrSrg)RemoteEntryNotFoundErrori 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', '') (...) 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. ``` r%Nr&r%rrrr rrrc4^\rSrSrSrS\4U4SjjrSrU=r$)LocalEntryNotFoundErrori2a 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. ``` r2c$>[TU]U5 gr)rr)rr2rs rr LocalEntryNotFoundError.__init__As !rr%) rrrrrrrrr r!s@rrr2s """rrc\rSrSrSrSrg)BadRequestErroriFa' 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) ``` r%Nr&r%rrrrFs rrc\rSrSrSrSrg) DDUFErroriWz5Base exception for errors related to the DDUF format.r%Nr&r%rrrrWs?rrc\rSrSrSrSrg)DDUFCorruptedFileErrori[z1Exception thrown when the DDUF file is corrupted.r%Nr&r%rrrr[;rrc\rSrSrSrSrg)DDUFExportErrori_z-Base exception for errors during DDUF export.r%Nr&r%rrrr_s7rrc\rSrSrSrSrg)DDUFInvalidEntryNameErroricz0Exception thrown when the entry name is invalid.r%Nr&r%rrrrcr*rrc\rSrSrSrSrg)StrictDataclassErrorijz&Base exception for strict dataclasses.r%Nr&r%rrrrjs0rrc\rSrSrSrSrg)StrictDataclassDefinitionErrorinz@Exception thrown when a strict dataclass is defined incorrectly.r%Nr&r%rrrrnsJrrc8^\rSrSrSrS\S\4U4SjjrSrU=r $)#StrictDataclassFieldValidationErrorirzLException thrown when a strict dataclass fails validation for a given field.fieldcausecn>SUS3nUSURRSU3- n[TU] U5 g)NzValidation error for field '': : rrrr)rrr error_messagers rr,StrictDataclassFieldValidationError.__init__us@6ugR@ 6%//":":!;2eWEE  'rr% rrrrrr Exceptionrrr r!s@rrrrsV(c()((rrc8^\rSrSrSrS\S\4U4SjjrSrU=r $)#StrictDataclassClassValidationErrori{zOException thrown when a strict dataclass fails validation on a class validator. validatorrcn>SUS3nUSURRSU3- n[TU] U5 g)Nz&Class validation error for validator 'rrrr)rrrrrs rr,StrictDataclassClassValidationError.__init__~s@@ 2N 6%//":":!;2eWEE  'rr%rr!s@rrr{sY(#(i((rrc\rSrSrSrSrg)XetErroriz1Base exception for errors related to Xet Storage.r%Nr&r%rrrrrrrc\rSrSrSrSrg)XetAuthorizationErrorizXException thrown when the user does not have the right authorization to use Xet Storage.r%Nr&r%rrrrrtrrc\rSrSrSrSrg)XetRefreshTokenErroriz3Exception thrown when the refresh token is invalid.r%Nr&r%rrrrr\rrc\rSrSrSrSrg)XetDownloadErroriz:Exception thrown when the download from Xet Storage fails.r%Nr&r%rrrrsDrrN)7rpathlibrtypingrrhttpxrrrr r#EnvironmentErrorr(ConnectionErrorr,OSErrorr/ TimeoutErrorrJrMrPrSrWrZr^rarfrirl ValueErrorrorrrvryr|rrrrFileNotFoundErrorrrrrrrrrrrrrrrr%rrrs!"% #I#RiR;.;_?_7pY7pzMI|MCYCG$:LGiy>)> ()( )  )  3  &  c'cn*,,*N&$~/A$"/1C"( nj "@ @((*>(8>EyEr