+ jIRt^RIHt^RIHt^RIHtHt!RR]4t !RR]4t !RR ]4t !R R ] 4t !R R ]4t!RR]]4t!RR]4t!RR]4t!RR]]4t!RR]]4t!RR]4t!RR]]4t!RR]4t!RR]4t!R R!]4t!R"R#]4t!R$R%]4t!R&R']4t!R(R)]4t !R*R+]4t!!R,R-]"4t#!R.R/]"4t$!R0R1]4t%!R2R3]4t&!R4R5]4t'!R6R7]4t(!R8R9]4t)!R:R;])4t*!R<R=]4t+!R>R?]4t,!R@RA]4t-!RBRC]4t.!RDRE]].4t/!RFRG]0].4t1!RHRI]14t2!RJRK]]"4t3!RLRM]4t4!RNRO]44t5!RPRQ]44t6!RRRS]64t7!RTRU]4t8!RVRW]84t9!RXRY]84t:!RZR[]84t;!R\R]]4t<!R^R_]4t=!R`Ra]4t>!RbRc]>4t?!RdRe]>4t@!RfRg]4tA!RhRi]A4tBRj#)kzContains all custom errors.)Enum)Path) HTTPErrorResponsecNaa]tRt^ toRtV3RlV3RlltV3RltRtVtV;t #) CacheNotFoundz9Exception thrown when the Huggingface cache is not found.c6<V^8dQhRS[RS[S[,/#)msg cache_dirstrr)format __classdict__s"W/home/luca/screen-checking/.venv/lib/python3.14/site-packages/huggingface_hub/errors.py __annotate__CacheNotFound.__annotate__s##C#C$J#c<<\SV`!V.VO5/VBW nR#N)super__init__r )selfr r argskwargs __class__s&&&*,rrCacheNotFound.__init__s .t.v."rc6<V^8dQh/S[S[,;R&#)r r r )rrs"rrr sTzr)r ) __name__ __module__ __qualname____firstlineno____doc__r__annotate_func____static_attributes____classdictcell__ __classcell__rrs@@rrr sC## rrc]tRt^tRtRtR#)CorruptedCacheExceptionzGException for any unexpected structure in the Huggingface cache-system.Nrrr r!r"r$r*rrr)r)sQrr)c]tRt^tRtRtR#)CachedRepoTreeNotFoundErrorzRaised by [`get_cached_repo_tree`] when no tree listing is cached for the requested revision. The tree listing is populated as a side effect of [`snapshot_download`]. r*Nr+r*rrr-r-rr-c]tRt^$tRtRtR#)LocalTokenNotFoundErrorz0Raised if local token is required but not found.r*Nr+r*rrr0r0$:rr0c]tRt^+tRtRtR#) OIDCErrora*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*rrr3r3+srr3c.]tRt^8tRtRtRtRtRtRt Rt R#) OAuthErrorCodezUKnown OAuth `error` codes returned by the Hub's token endpoint (RFC 6749 / RFC 8628).authorization_pending slow_down expired_token access_denied invalid_grantr*N) rrr r!r"AUTHORIZATION_PENDING SLOW_DOWN EXPIRED_TOKEN ACCESS_DENIED INVALID_GRANTr$r*rrr5r58s_3I#M#M#Mrr5cFaa]tRt^BtoRtRV3RlV3RllltRtVtV;t#)DeviceCodeErroraRaised when the Device Code OAuth login flow (RFC 8628) or an OAuth token refresh fails. Covers failures at any step: requesting the device code, polling for the token, authorization denied/expired, or unexpected server responses. Attributes: error_code (`str`, *optional*): The OAuth `error` code returned by the server, if any. Known values are listed in [`OAuthErrorCode`] but the server may return other codes. c4<V^8dQhRS[RS[R,/#)r message error_codeNr )rrs"rrDeviceCodeError.__annotate__Ns%%%t%rc2<\SV`V4W nR#r)rrrD)rrCrDrs&&&rrDeviceCodeError.__init__Ns !$r)rDr rrr r!r"rr$r%r&r's@@rrArABs %%%rrAc]tRt^VtRtRtR#)OfflineModeIsEnabledzTRaised when a request is made but `HF_HUB_OFFLINE=1` is set as environment variable.r*Nr+r*rrrKrKVs^rrKc~aa]tRt^ZtoRtRR/V3RlV3RllltV3RlRlt]V3RlR l4tR t R t Vt V;t #) 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 ``` server_messageNc:<V^8dQhRS[RS[RS[R,/#)r rCresponserNNr r)rrs"rrHfHubHTTPError.__annotate__xs-""" " d "rc,<VPPR4;'g?VPPR4;'gVPPR4VnW0nW nVP Vn\ SV`V4R#)z x-request-idzX-Amzn-Trace-Idz x-amz-cf-idN)headersget request_idrNrPrequestrr)rrCrPrNrs&&$$rrHfHubHTTPError.__init__xs     0 3 3##$56 3 3##M2  - ''  !rc$<V^8dQhRS[RR/#)r additional_messagereturnNrE)rrs"rrrRsIICIDIrc vVP^,V,3VPR,,VnR#)zFAppend additional information to the `HfHubHTTPError` initial message.:NNN)r)rrZs&&rappend_to_message HfHubHTTPError.append_to_messages'YYq\$668499R=H rc><V^8dQhRS[RS[RS[R,RR/#)r rCrPrNNr[rMrQ)rrs"rrrRs7NNN%-N?BTzN NrcV!WVR7#))rPrNr*)clsrCrPrNs&&&&r_reconstruct_hf_hub_http_error-HfHubHTTPError._reconstruct_hf_hub_http_errors7nMMrc rVPP\V4VPVP33#)zeFix pickling of Exception subclass with kwargs. We need to override __reduce_ex__ of the parent class)rrcr rPrN)rprotocols&&r __reduce_ex__HfHubHTTPError.__reduce_ex__s-==D 4==Z^ZmZm?noor)rrWrVrPrN) rrr r!r"rr^ classmethodrcrgr$r%r&r's@@rrMrMZsL:" &* """IINN pprrMc]tRt^tRtRtR#)InferenceTimeoutErrorzBError raised when a model is unavailable or the request times out.r*Nr+r*rrrkrksLrrkc]tRt^tRtRtR#)InferenceEndpointErrorz8Generic exception when dealing with Inference Endpoints.r*Nr+r*rrrmrmsBrrmc]tRt^tRtRtR#)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. ``` Nc4<V^8dQh/S[R,;R&#)r N bucket_idrE)rrs"rr BucketNotFoundError.__annotate__s,Tz -rr*) rrr r!r"rr#r$r%rs@rrrs*!I-rrc0a]tRtRtoRtV3RltRtVtR#)JobNotFoundErroriz Raised when trying to access a Job that does not exist. Attributes: job_id (`str`): The job id that was not found. c&<V^8dQh/S[;R&#)r job_idrE)rrs"rrJobNotFoundError.__annotate__s Krr*N)rrr r!r"r#r$r%rs@rrrsrrc8a]tRtRtoRtRtRtV3RltRtVt R#)RepositoryNotFoundErrori-a 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. ``` NcN<V^8dQh/S[R,;R&S[R,;R&#r Nrepo_id repo_typerE)rrs"rr$RepositoryNotFoundError.__annotate__-s'44Z56Tz 7rr* rrr r!r"rrr#r$r%rs@rrr-s2G I7rrc]tRtRtRtRtR#)GatedRepoErroriKa 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*rrrrKsrrc]tRtRtRtRtR#)DisabledRepoErroriaa 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*rrrrarrc8a]tRtRtoRtRtRtV3RltRtVt R#)RevisionNotFoundErroriva 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. ``` NcN<V^8dQh/S[R,;R&S[R,;R&#rrE)rrs"rr"RevisionNotFoundError.__annotate__v'.4Z/0Tz 1rr*rrs@rrrv,G I1rrc]tRtRtRtRtR#)RevisionResolutionErroriz Raised by [`HfApi.resolve_revision`] when a revision cannot be resolved to a commit hash: the Hub could not be reached (offline mode, connection error, timeout, Hub downtime, ...) and no matching entry was found in the local cache. r*Nr+r*rrrrsrrc]tRtRtRtRtR#)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*rrrrrrrc8a]tRtRtoRtRtRtV3RltRtVt R#)RemoteEntryNotFoundErroria 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. ``` NcN<V^8dQh/S[R,;R&S[R,;R&#rrE)rrs"rr%RemoteEntryNotFoundError.__annotate__rrr*rrs@rrrrrrcBaa]tRtRtoRtV3RlV3RlltRtVtV;t#)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. ``` c <V^8dQhRS[/#)r rCrE)rrs"rr$LocalEntryNotFoundError.__annotate__s"""rc&<\SV`V4R#r)rr)rrCrs&&rr LocalEntryNotFoundError.__init__s !rr*rIr's@@rrrs """rrcBaa]tRtRtoRtV3RlV3RlltRtVtV;t#)IncompleteSnapshotErroria Raised by [`snapshot_download`] when the Hub cannot be reached (offline, connection issue, or `local_files_only=True`) and the cached snapshot is known to be incomplete: some files listed in the repository's cached tree listing are missing from the local snapshot. This is a subclass of [`LocalEntryNotFoundError`] for backward compatibility. The `snapshot_path` attribute holds the path to the incomplete local snapshot, so a downstream library can locate the latest cached files even though they are known to be incomplete. c&<V^8dQhRS[RS[/#)r rC snapshot_pathrE)rrs"rr$IncompleteSnapshotError.__annotate__s+++C+rc2<\SV`V4W nR#r)rrr)rrCrrs&&&rr IncompleteSnapshotError.__init__s !*r)rrIr's@@rrrs +++rrc]tRtRtRtRtR#)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]tRtRtRtRtR#) DDUFErroriz5Base exception for errors related to the DDUF format.r*Nr+r*rrrrs?rrc]tRtRtRtRtR#)DDUFCorruptedFileErroriz1Exception thrown when the DDUF file is corrupted.r*Nr+r*rrrr;rrc]tRtRtRtRtR#)DDUFExportErroriz-Base exception for errors during DDUF export.r*Nr+r*rrrrs7rrc]tRtRtRtRtR#)DDUFInvalidEntryNameErrori z0Exception thrown when the entry name is invalid.r*Nr+r*rrrr r1rrc]tRtRtRtRtR#)StrictDataclassErroriz&Base exception for strict dataclasses.r*Nr+r*rrrrs0rrc]tRtRtRtRtR#)StrictDataclassDefinitionErroriz@Exception thrown when a strict dataclass is defined incorrectly.r*Nr+r*rrrrsJrrcBaa]tRtRtoRtV3RlV3RlltRtVtV;t#)#StrictDataclassFieldValidationErrorizLException thrown when a strict dataclass fails validation for a given field.c&<V^8dQhRS[RS[/#)r fieldcauser Exception)rrs"rr0StrictDataclassFieldValidationError.__annotate__s((c()(rcx<RV R2pVRVPP RV 2, p\SV` V4R#)zValidation error for field '': : Nrrrr)rrr error_messagers&&& rr,StrictDataclassFieldValidationError.__init__s@6ugR@ 6%//":":!;2eWEE  'rr*rIr's@@rrrsV(((rrcBaa]tRtRtoRtV3RlV3RlltRtVtV;t#)#StrictDataclassClassValidationErrori!zOException thrown when a strict dataclass fails validation on a class validator.c&<V^8dQhRS[RS[/#)r validatorrr)rrs"rr0StrictDataclassClassValidationError.__annotate__$s((#(i(rcx<RV R2pVRVPP RV 2, p\SV` V4R#)z&Class validation error for validator 'rrrNr)rrrrrs&&& rr,StrictDataclassClassValidationError.__init__$s@@ 2N 6%//":":!;2eWEE  'rr*rIr's@@rrr!sY(((rrc]tRtRtRtRtR#)XetDownloadErrori-z:Exception thrown when the download from Xet Storage fails.r*Nr+r*rrrr-sDrrc]tRtRtRtRtR#)FileDuplicationErrori4z1Raised when duplicating files across repos fails.r*Nr+r*rrrr4rrrc]tRtRtRtRtR#)CLIErrori;z7CLI error with clean message (no traceback by default).r*Nr+r*rrrr;sArrc]tRtRtRtRtR#)ConfirmationErrori?zERaised when a confirmation prompt is declined (non-interactive mode).r*Nr+r*rrrr?sOrrc]tRtRtRtRtR#)CLIExtensionInstallErroriCz(Error during CLI extension installation.r*Nr+r*rrrrCs2rrcJaa]tRtRtoRtRR/V3RlV3RllltRtVtV;t#) SandboxErroriJaBase exception for sandbox operations (see `huggingface_hub.Sandbox`). Attributes: status_code: The HTTP status returned by the in-sandbox server, if the error originated from an API response (e.g. `404` for a missing file). `None` otherwise. status_codeNc8<V^8dQhRS[RS[R,RR/#)r rCrNr[)r int)rrs"rrSandboxError.__annotate__Rs&'''S4Z'4'rc2<\SV`V4W nR#r)rrr)rrCrrs&&$rrSandboxError.__init__Rs !&r)rrIr's@@rrrJs '$'''rrcBaa]tRtRtoRtV3RlV3RlltRtVtV;t#)SandboxCommandErroriWzRaised when a command run in a sandbox exits with a non-zero code. Attributes: cmd: The command that failed. result: The full `SandboxCommandResult` (exit_code, stdout, stderr, ...). c<V^8dQhRR/#)r r[Nr*)rrs"rr SandboxCommandError.__annotate___s N Nt Nrc<WnW nVP'dVPR RMRpVP'dRpM-VPeRVP 2pMRVP 2p\ SV`RV: RV RV 24R#) iNzz timed outzwas killed by signal zexited with code zCommand  z . stderr: i)cmdresultstderr timed_outsignal exit_coderr)rrr stderr_tailreasonrs&&& rrSandboxCommandError.__init___s /5}}}fmmEF+)     F ]] &,V]]Ors!% #I#RiR);.; $S$$%i%(_?_;pY;pBMI|MCYCG$:LGiy>)> ()( )  )  3  &  ##(c'c!.!8 ~ !n!<,,*!N!6i$!~/A!6"/1C"&+5+$ nj "@ @((*>(EyE<9<ByBPP3x3 '9 'N,Nr