o Zh%;@sddlZddlmZddlmZmZddlmZejdej dZ Gdd d e Z Gd d d eZ Gd d d e ZGdddeZGddde ZGddde ZGddde ZGdddeeeZGddde eZd$dedeeddfddZded eed!eedefd"d#ZdS)%N)Optional) HTTPErrorResponse)JSONDecodeErrora  # staging or production endpoint ^https://[^/]+ ( # on /api/repo_type/repo_id /api/(models|datasets|spaces)/(.+) | # or /repo_id/resolve/revision/... /(.+)/resolve/(.+) ) )flagsc@eZdZdZdS)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. N__name__ __module__ __qualname____doc__rrT/var/www/html/lang_env/lib/python3.10/site-packages/huggingface_hub/utils/_errors.pyr r csdeZdZUdZdZeeed<dZeeed<d dedee ffdd Z d ed dfd d Z Z 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 from "X-Request-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 requests 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 request_idserver_messagemessageresponsecs|durs|jd|_z|}Wn tyi}Ynw|jd}|d}ddd|dgD}d}|durB||d7}|durZt|trPd|}||vrZ||d7}|durh||vrh||d7}|}|dkrs||_ t j t ||j|j d ||dur|j ndd dS) Nz X-Request-IdX-Error-Messageerror css |] }d|vr|dVqdS)rNr).0rrrr Msz*HfHubHTTPError.__init__..errors)rr)rrequest)headersgetrjsonrjoin isinstanceliststriprsuper__init___format_error_messager)selfrrZ server_dataZserver_message_from_headersZserver_message_from_bodyZ"server_multiple_messages_from_bodyZ_server_message __class__rrr'AsF            zHfHubHTTPError.__init__additional_messagereturncCs$|jd|f|jdd|_dS)zFAppend additional information to the `HfHubHTTPError` initial message.rrN)args)r)r,rrrappend_to_messagems$z HfHubHTTPError.append_to_messageN) r r r rrrstr__annotations__rrr'r/ __classcell__rrr*rr s ,rc@r)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. Example: ```py >>> from huggingface_hub import model_info >>> model_info("") (...) huggingface_hub.utils._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. ``` Nr rrrrr4rrr4c@r)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.utils._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. ``` Nr rrrrr5rr5c@r)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.utils._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. ``` Nr rrrrr6rr6c@r)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.utils._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 rrrrr7rr7c@r)EntryNotFoundErrora 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.utils._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 rrrrr8rr8cs&eZdZdZdeffdd ZZS)LocalEntryNotFoundErrora 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. Note: `ValueError` type is to ensure backward compatibility. Note: `LocalEntryNotFoundError` derives from `HTTPError` because of `EntryNotFoundError` even when it is not a network issue. Example: ```py >>> from huggingface_hub import hf_hub_download >>> hf_hub_download('bert-base-cased', '', local_files_only=True) (...) huggingface_hub.utils._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. ``` rcstj|dddS)Nr)r&r')r)rr*rrr'sz LocalEntryNotFoundError.__init__)r r r rr1r'r3rrr*rr9sr9c@r)BadRequestErroraQ Raised by `hf_raise_for_status` when the server returns a HTTP 400 error. Example: ```py >>> resp = requests.post("hf.co/api/check", ...) >>> hf_raise_for_status(resp, endpoint_name="check") huggingface_hub.utils._errors.BadRequestError: Bad request for check endpoint: {details} (Request ID: XXX) ``` Nr rrrrr;rr;r endpoint_namer-c Csz|WdSty}z|jd}|jd}|dkr4|jddd|jd}t||||dkrM|jddd |jd}t||||d krf|jddd |jd}t||||d kr|jddd |jddd }t ||||dks|jdkr|j dur|j jdurt |j jdur|jddd|jdd}t ||||jdkr|durd|dnd}t||d||jdkrd|jd|dd|jddd}t||d|tt||d|d}~ww)a Internal version of `response.raise_for_status()` that will refine a potential HTTPError. Raised exception will be an instance of `HfHubHTTPError`. This helper is meant to be the unique method to raise_for_status when making a call to the Hugging Face Hub. Example: ```py import requests 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 ``` Args: response (`Response`): Response from the server. endpoint_name (`str`, *optional*): Name of the endpoint that has been called. If provided, the error message will be more complete. Raises when the request has failed: - [`~utils.RepositoryNotFoundError`] If the repository to download from cannot be found. This may be because it doesn't exist, because `repo_type` is not set correctly, or because the repo is `private` and you do not have access. - [`~utils.GatedRepoError`] If the repository exists but is gated and the user is not on the authorized list. - [`~utils.RevisionNotFoundError`] If the repository exists but the revision couldn't be find. - [`~utils.EntryNotFoundError`] If the repository exists but the entry (e.g. the requested file) couldn't be find. - [`~utils.BadRequestError`] If request failed with a HTTP 400 BadRequest error. - [`~utils.HfHubHTTPError`] If request failed for a reason not listed above. z X-Error-CoderZRevisionNotFoundz Client Error. zRevision Not Found for url: .Z EntryNotFoundzEntry Not Found for url: Z GatedRepoz!Cannot access gated repo for url z$Access to this resource is disabled.z!Cannot access repository for url rZ RepoNotFoundiNzRepository Not Found for url: z Please make sure you specified the correct `repo_id` and `repo_type`. If you are trying to access a private or gated repo, make sure you are authenticated.iz Bad request for z endpoint:z Bad request:r:iz Forbidden: z Cannot access content at: z/ If you are trying to create or update content,z1make sure you have a token with the `write` role.)raise_for_statusrrr status_codeurlr7r8r5r6rREPO_API_REGEXsearchr4r;rr1)rr<eZ error_code error_messagerrrrhf_raise_for_statusst7                 rFrrrcCs|dur#t|dkr#||vr#d|vr|d|7}n|d|7}|durTt||vrTd|d}d|vrP|d}|d||||d}|S||7}|S)z Format the `HfHubHTTPError` error message based on initial message and information returned by the server. Used when initializing `HfHubHTTPError`. Nrr=rz (Request ID: ))lenlowerr1index)rrrZrequest_id_messageZ newline_indexrrrr(vs$   r(r0)retypingrrequestsrrZ_fixesrcompileVERBOSErBOSErrorr rr4r5r6r7r8FileNotFoundError ValueErrorr9r;r1rFr(rrrrs&   R&~