3j/:SrSSKJr SSKJrJr "SS\5r"SS\5r"SS \ 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.S/\5r!"S0S1\5r""S2S3\"5r#"S4S5\5r$"S6S7\5r%"S8S9\5r&"S:S;\\&5r'"S<S=\(\&5r)"S>S?\\5r*"S@SA\5r+"SBSC\+5r,"SDSE\+5r-"SFSG\-5r."SHSI\5r/"SJSK\/5r0"SLSM\/5r1"SNSO\/5r2"SPSQ\5r3"SRSS\5r4"STSU\5r5"SVSW\55r6"SXSY\55r7gZ)[zContains all custom errors.)Path) HTTPErrorResponsecP^\rSrSr%Sr\\-\S'S\S\\-4U4SjjrSr 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 P/home/wildlama/miniconda3/lib/python3.13/site-packages/huggingface_hub/errors.pyrCacheNotFound.__init__s .t.v.")r ) __name__ __module__ __qualname____firstlineno____doc__strr__annotations__r__static_attributes__ __classcell__rs@rrr s,CTz#C#C$J##rrc\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) OIDCError#a*Raised when keyless CI/CD auth via OIDC token exchange ("Trusted Publishers") cannot proceed. Typically because `HF_OIDC_RESOURCE` is set but no id token is available: not running in a supported CI provider and `HF_OIDC_ID_TOKEN` is unset. See https://huggingface.co/docs/hub/trusted-publishers. r#Nr$r#rrr*r*#srr*c\rSrSrSrSrg)OfflineModeIsEnabled0zTRaised when a request is made but `HF_HUB_OFFLINE=1` is set as environment variable.r#Nr$r#rrr-r-0s^rr-c ^\rSrSrSrSS.S\S\S\S-4U4SjjjrS \S S4S jr\ S\S\S\S-S S4S j5r S r Sr U=r $)HfHubHTTPError4a> 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_messagemessageresponser2c&>URRS5=(d= URRS5=(d URRS5UlX0lX lUR Ul[ TU]U5 g)Nz x-request-idzX-Amzn-Trace-Idz x-amz-cf-id)headersget request_idr2r4requestr r)rr3r4r2rs rrHfHubHTTPError.__init__Rsz     0 3##$56 3##M2  - ''  !radditional_messagereturncTURSU-4URSS-Ulg)zFAppend additional information to the `HfHubHTTPError` initial message.rN)r)rr;s rappend_to_message HfHubHTTPError.append_to_messagecs)YYq\$668499QR=H rcU"XUS9$)N)r4r2r#)clsr3r4r2s r_reconstruct_hf_hub_http_error-HfHubHTTPError._reconstruct_hf_hub_http_errorgs7nMMrcrURR[U5URUR44$)zeFix pickling of Exception subclass with kwargs. We need to override __reduce_ex__ of the parent class)rrCrr4r2)rprotocols r __reduce_ex__HfHubHTTPError.__reduce_ex__ms-==D 4==Z^ZmZm?noor)rr9r8r4r2)rrrrrrrrr? classmethodrCrGrrrs@rr0r04sD&* "" " d """ICIDINN%-N?BTzN NN pprr0c\rSrSrSrSrg)InferenceTimeoutErroruzBError raised when a model is unavailable or the request times out.r#Nr$r#rrrKrKusLrrKc\rSrSrSrSrg)InferenceEndpointError|z8Generic exception when dealing with Inference Endpoints.r#Nr$r#rrrNrN|sBrrNc\rSrSrSrSrg)InferenceEndpointTimeoutErrorzXlX lU(aSUSU3OSU3n[TU] U5 g)NzInvalid HF URI 'z'. zInvalid HF URI. )rtr r r)rrtr full_msgrs rrHfUriError.__init__s;7:%cU#cU3BRSVRW@X "r)r rt rrrrrrrrrrs@rrrrrs #C#c##rrrc\rSrSrSrSrg) DryRunErrorzXError triggered when a dry run is requested but cannot be performed (e.g. invalid repo).r#Nr$r#rrrzrzsbrrzc\rSrSrSrSrg)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. r#Nr$r#rrr}r}rVrr}c.\rSrSr%SrSr\S-\S'Srg)BucketNotFoundErrora Raised when trying to access a bucket that does not exist. Attributes: bucket_id (`str` or `None`): The bucket id (namespace/name) that was not found, if it could be determined from the request URL. Example: ```py >>> 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_idr#) rrrrrrrrrr#rrrrs*!IsTz rrcB\rSrSr%SrSr\S-\S'Sr\S-\S'Sr g)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_typer# rrrrrrrrrrr#rrrrs%2GS4Z IsTz rrc\rSrSrSrSrg)GatedRepoErroria 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#rrrrsrrc\rSrSrSrSrg)DisabledRepoErrori,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.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#rrrr,rrcB\rSrSr%SrSr\S-\S'Sr\S-\S'Sr g)RevisionNotFoundErroriAa 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. ``` Nrrr#rr#rrrrA%,GS4Z IsTz rrc\rSrSrSrSrg)EntryNotFoundErrori]a 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#rrrr]rrrcB\rSrSr%SrSr\S-\S'Sr\S-\S'Sr g)RemoteEntryNotFoundErrorioa 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. ``` Nrrr#rr#rrrrorrrc4^\rSrSrSrS\4U4SjjrSrU=r$)LocalEntryNotFoundErroria 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. ``` r3c$>[TU]U5 gr )r r)rr3rs rr LocalEntryNotFoundError.__init__s !rr#rxrs@rrrs """rrc\rSrSrSrSrg)BadRequestErroria' 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#rrrrs rrc\rSrSrSrSrg) DDUFErroriz5Base exception for errors related to the DDUF format.r#Nr$r#rrrrs?rrc\rSrSrSrSrg)DDUFCorruptedFileErroriz1Exception thrown when the DDUF file is corrupted.r#Nr$r#rrrr;rrc\rSrSrSrSrg)DDUFExportErroriz-Base exception for errors during DDUF export.r#Nr$r#rrrrs7rrc\rSrSrSrSrg)DDUFInvalidEntryNameErroriz0Exception thrown when the entry name is invalid.r#Nr$r#rrrrr(rrc\rSrSrSrSrg)StrictDataclassErroriz&Base exception for strict dataclasses.r#Nr$r#rrrrs0rrc\rSrSrSrSrg)StrictDataclassDefinitionErroriz@Exception thrown when a strict dataclass is defined incorrectly.r#Nr$r#rrrrsJrrc8^\rSrSrSrS\S\4U4SjjrSrU=r $)#StrictDataclassFieldValidationErrorizLException thrown when a strict dataclass fails validation for a given field.fieldcausecn>SUS3nUSURRSU3- n[TU] U5 g)NzValidation error for field '': : rrr r)rrr error_messagers rr,StrictDataclassFieldValidationError.__init__s@6ugR@ 6%//":":!;2eWEE  'rr# rrrrrr Exceptionrrrrs@rrrsV(c()((rrc8^\rSrSrSrS\S\4U4SjjrSrU=r $)#StrictDataclassClassValidationErrorizOException 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#rrs@rrrsY(#(i((rrc\rSrSrSrSrg)XetDownloadErroriz:Exception thrown when the download from Xet Storage fails.r#Nr$r#rrrrsDrrc\rSrSrSrSrg)FileDuplicationErroriz1Raised when duplicating files across repos fails.r#Nr$r#rrrrrrrc\rSrSrSrSrg)CLIErroriz7CLI error with clean message (no traceback by default).r#Nr$r#rrrrsArrc\rSrSrSrSrg)ConfirmationErrorizERaised when a confirmation prompt is declined (non-interactive mode).r#Nr$r#rrrrsOrrc\rSrSrSrSrg)CLIExtensionInstallErroriz(Error during CLI extension installation.r#Nr$r#rrrrs2rrN)8rpathlibrhttpxrrrrr!EnvironmentErrorr&r*ConnectionErrorr-OSErrorr0 TimeoutErrorrKrNrQrTrXr[r^rarfrirl ValueErrorrorrrzr}rrrrrrrFileNotFoundErrorrrrrrrrrrrrrrrrr#rrrsE!% #I#RiR;.; _?_;pY;pBMI|MCYCG$:LGiy>)> ()( )  )  3  &  ##(c'c!.!8!n!<,,*!N!8$!~/A!6"/1C"( nj "@ @((*>(EyE<9<ByBPP3x3r