^jGdZddlmZddlmZddlmZmZGddeZ GddeZ Gd d eZ Gd d e Z Gd deZGddeeZGddeZGddeZGddeeZGddeeZGddeZGddeeZGddeZGdd eZGd!d"eZGd#d$eZGd%d&eZGd'd(eZGd)d*eZ Gd+d,eZ!Gd-d.e"Z#Gd/d0e"Z$Gd1d2eZ%Gd3d4eZ&Gd5d6eZ'Gd7d8eZ(Gd9d:eZ)Gd;deZ+Gd?d@eZ,GdAdBeZ-GdCdDee-Z.GdEdFe/e-Z0GdGdHe0Z1GdIdJee"Z2GdKdLeZ3GdMdNe3Z4GdOdPe3Z5GdQdRe5Z6GdSdTeZ7GdUdVe7Z8GdWdXe7Z9GdYdZe7Z:Gd[d\eZ;Gd]d^eZ<Gd_d`eZ=Gdadbe=Z>Gdcdde=Z?GdedfeZ@Gdgdhe@ZAyi)jzContains all custom errors.)Enum)Path) HTTPErrorResponsecDeZdZUdZeezed<dedeezffd ZxZS) CacheNotFoundz9Exception thrown when the Huggingface cache is not found. cache_dirmsgc:t||g|i|||_yN)super__init__r )selfr r argskwargs __class__s a/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/huggingface_hub/errors.pyrzCacheNotFound.__init__s! .t.v.") __name__ __module__ __qualname____doc__strr__annotations__r __classcell__rs@rrr s,CTz#C#C$J##rrceZdZdZy)CorruptedCacheExceptionzGException for any unexpected structure in the Huggingface cache-system.NrrrrrrrrsQrrceZdZdZy)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`]. Nrr rrr"r"rr"ceZdZdZy)LocalTokenNotFoundErrorz0Raised if local token is required but not found.Nrr rrr%r%$:rr%ceZdZdZy) 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. Nrr rrr(r(+srr(c$eZdZdZdZdZdZdZdZy)OAuthErrorCodezUKnown OAuth `error` codes returned by the Hub's token endpoint (RFC 6749 / RFC 8628).authorization_pending slow_down expired_token access_denied invalid_grantN) rrrrAUTHORIZATION_PENDING SLOW_DOWN EXPIRED_TOKEN ACCESS_DENIED INVALID_GRANTr rrr*r*8s_3I#M#M#Mrr*c4eZdZdZddededzffd ZxZS)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. Nmessage error_codec2t||||_yr )r rr8)rr7r8rs rrzDeviceCodeError.__init__Ns !$rr rrrrrrrrs@rr6r6Bs$ %%t%%rr6ceZdZdZy)OfflineModeIsEnabledzTRaised when a request is made but `HF_HUB_OFFLINE=1` is set as environment variable.Nrr rrr<r<Vs^rr<c zeZdZdZdddedededzffdZded 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_messager7responser?c|jjdxs8|jjdxs|jjd|_||_||_|j |_t ||y)Nz x-request-idzX-Amzn-Trace-Idz x-amz-cf-id)headersget request_idr?r@requestr r)rr7r@r?rs rrzHfHubHTTPError.__init__xs~     0 3##$56 3##M2  -  ''  !radditional_messagereturncT|jd|zf|jddz|_y)zFAppend additional information to the `HfHubHTTPError` initial message.rN)r)rrFs rappend_to_messagez HfHubHTTPError.append_to_messages)YYq\$668499QR=H rc||||S)N)r@r?r )clsr7r@r?s r_reconstruct_hf_hub_http_errorz-HfHubHTTPError._reconstruct_hf_hub_http_errors7XnMMrcr|jjt||j|jffS)zeFix pickling of Exception subclass with kwargs. We need to override __reduce_ex__ of the parent class)rrMrr@r?)rprotocols r __reduce_ex__zHfHubHTTPError.__reduce_ex__s-==D 4==Z^ZmZm?noor) rrrrrrrrJ classmethodrMrPrrs@rr>r>ZsD&* "" " d ""ICIDINN%-N?BTzN NN prr>ceZdZdZy)InferenceTimeoutErrorzBError raised when a model is unavailable or the request times out.Nrr rrrSrSsLrrSceZdZdZy)InferenceEndpointErrorz8Generic exception when dealing with Inference Endpoints.Nrr rrrUrUsBrrUceZdZdZy)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)rrrrrwrrr rrrvrvs*!IsTz rrvceZdZUdZeed<y)JobNotFoundErrorz Raised when trying to access a Job that does not exist. Attributes: job_id (`str`): The job id that was not found. job_idN)rrrrrrr rrryrys Krryc:eZdZUdZdZedzed<dZedzed<y)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_typerrrrr}rrr~r rrr|r|-s%2GS4Z IsTz rr|ceZdZdZy)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. ``` Nrr rrrrKsrrceZdZdZy)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. ``` Nrr rrrrarrc:eZdZUdZdZedzed<dZedzed<y)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. ``` Nr}r~rr rrrrv%,GS4Z IsTz rrceZdZdZy)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 (...) ``` Nrr rrrrrrrc:eZdZUdZdZedzed<dZedzed<y)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. ``` Nr}r~rr rrrrrrrc(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. ``` r7c$t||yr )r r)rr7rs rrz LocalEntryNotFoundError.__init__s !rr:rs@rrrs """rrc,eZdZdZdedeffd ZxZS)IncompleteSnapshotErrora- 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. r7 snapshot_pathc2t||||_yr )r rr)rr7rrs rrz IncompleteSnapshotError.__init__s !*rr:rs@rrrs  ++C++rrceZdZdZy)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) ``` Nrr rrrrs rrceZdZdZy) DDUFErrorz5Base exception for errors related to the DDUF format.Nrr rrrrs?rrceZdZdZy)DDUFCorruptedFileErrorz1Exception thrown when the DDUF file is corrupted.Nrr rrrr;rrceZdZdZy)DDUFExportErrorz-Base exception for errors during DDUF export.Nrr rrrrs7rrceZdZdZy)DDUFInvalidEntryNameErrorz0Exception thrown when the entry name is invalid.Nrr rrrrr&rrceZdZdZy)StrictDataclassErrorz&Base exception for strict dataclasses.Nrr rrrrs0rrceZdZdZy)StrictDataclassDefinitionErrorz@Exception thrown when a strict dataclass is defined incorrectly.Nrr rrrr sJrrc,eZdZdZdedeffd ZxZS)#StrictDataclassFieldValidationErrorzLException thrown when a strict dataclass fails validation for a given field.fieldcausecnd|d}|d|jjd|z }t| |y)NzValidation error for field '': : rrr r)rrr error_messagers rrz,StrictDataclassFieldValidationError.__init__s@6ugR@ 6%//":":!;2eWEE  'rrrrrr Exceptionrrrs@rrrsV(c()((rrc,eZdZdZdedeffd ZxZS)#StrictDataclassClassValidationErrorzOException thrown when a strict dataclass fails validation on a class validator. validatorrcnd|d}|d|jjd|z }t| |y)Nz&Class validation error for validator 'rrrr)rrrrrs rrz,StrictDataclassClassValidationError.__init__s@@ 2N 6%//":":!;2eWEE  'rrrs@rrrsY(#(i((rrceZdZdZy)XetDownloadErrorz:Exception thrown when the download from Xet Storage fails.Nrr rrrr%sDrrceZdZdZy)FileDuplicationErrorz1Raised when duplicating files across repos fails.Nrr rrrr,rrrceZdZdZy)CLIErrorz7CLI error with clean message (no traceback by default).Nrr rrrr3sArrceZdZdZy)ConfirmationErrorzERaised when a confirmation prompt is declined (non-interactive mode).Nrr rrrr7sOrrceZdZdZy)CLIExtensionInstallErrorz(Error during CLI extension installation.Nrr rrrr;s2rrc<eZdZdZdddededzddffdZxZS) SandboxErroraBase 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. N) status_coder7rrGc2t||||_yr )r rr)rr7rrs rrzSandboxError.__init__Js !&r)rrrrrintrrrs@rrrBs2CG''S4Z'4''rrc$eZdZdZdfd ZxZS)SandboxCommandErrorzRaised 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||_||_|jr|jddnd}|jrd}n+|jd|j}nd|j }t |d|d|d|y) Nizz timed outzwas killed by signal zexited with code zCommand  z . stderr: )cmdresultstderr timed_outsignal exit_coder r)rrr stderr_tailreasonrs rrzSandboxCommandError.__init__Ws /5}}fmmEF+)    F ]] &,V]]O TimeoutErrorrSrUrWrYr[r]r_rarergri ValueErrorrkrmrrrtrvryr|rrrrrFileNotFoundErrorrrrrrrrrrrrrrrrrrrr rrrs!% #I#RiR);.; $S$$%i%(_?_;pY;pBMI|MCYCG$:LGiy>)> ()( )  )  3  &  ##(c'c!.!8 ~ !n!<,,*!N!8$!~/A!6"/1C"&+5+$ nj "@ @((*>(EyE<9<ByBPP3x3 '9 'N,Nr