codekingpro/portable-devtools
114k
1�
2 ��j�9 � �� � S r SSKJr SSKJrJr " S S\5 r " S S\5 r " S S \ 5 r3 " S4 S \ 5 r " S S
\\
5 r " S S\\5 r " S S\5 r " S S\\5 r " S S\5 r " S S\5 r " S S\5 r " S S\5 r " S S \5 r " S S \5 r " S S!\5 r " S" S#\5 r " S$ S%\5 r " S& S'\5 r " S( S)\
5 r " S* S+\
5 r " S, S-\5 r " S. S/\5 r! " S0 S1\!5 r" " S2 S3\5 r# " S4 S5\5 r$ " S6 S7\5 r% " S8 S9\\%5 r& " S: S;\'\%5 r( " S< S=\\5 r) " S> S?\5 r* " S@ SA\*5 r+ " SB SC\*5 r, " SD SE\,5 r- " SF SG\5 r. " SH SI\.5 r/ " SJ SK\.5 r0 " SL SM\.5 r1 " SN SO\5 r2 " SP SQ\25 r3 " SR SS\25 r4 " ST SU\5 r5 " SV SW\5 r6 " SX SY\65 r7 " SZ S[\65 r8g\)]zContains all custom errors.� )�Path)� HTTPError�Responsec �P ^ � \ rS rSr% Sr\\- \S' S\S\\- 4U 4S jjrSr U =r5$ )�
CacheNotFound� z9Exception thrown when the Huggingface cache is not found.� cache_dir�msgc �: >� [ TU ] " U/UQ70 UD6 X l g �N)�super�__init__r )�selfr6 r �args�kwargs� __class__s ��\D:\code\apps\devtools\python\user_packages\Python313\site-packages\huggingface_hub/errors.pyr �CacheNotFound.__init__ s �� �
����.�t�.�v�.�"�� )r ) �__name__�7__module__� __qualname__�__firstlineno__�__doc__�strr �__annotations__r �__static_attributes__�
__classcell__�r s @r r r s, �� �C��T�z��#�C� #�C�$�J� #� #r r c � � \ rS rSrSrSrg)�CorruptedCacheException� zGException for any unexpected structure in the Huggingface cache-system.� N�r r r r r r r# r r r! r! s � �Qr r! c � � \ rS rSrSrSrg)�LocalTokenNotFoundError� z0Raised if local token is required but not found.r# Nr$ r# r r r& r& � � �:r r& c � � \ rS rSrSrSrg)�OfflineModeIsEnabled�# zTRaised when a request is made but `HF_HUB_OFFLINE=1` is set as environment variable.r# Nr$ r# r r r* r* # s � �^r r* c � ^ � \ rS rSrSrSS.S\S\S\S- 4U 4S jjjrS \S8S4S jr\ S\S\S\S- S9S 4S j5 r10S
r Sr U =r
$ )�HfHubHTTPError�' a> 11 HTTPError to inherit from for any custom HTTP Error raised in HF Hub.12 13 Any HTTPError is converted at least into a `HfHubHTTPError`. If some information is14 sent back by the server, it will be added to the error message.15 16 Added details:17 - Request ID sourced from headers in order of precedence: "X-Request-Id", "X-Amzn-Trace-Id", "X-Amz-Cf-Id".18 - Server error message from the header "X-Error-Message".19 - Server error message if we can found one in the response body.20 21 Example:22 ```py23 import httpx24 from huggingface_hub.utils import get_session, hf_raise_for_status, HfHubHTTPError25 26 response = get_session().post(...)27 try:28 hf_raise_for_status(response)29 except HfHubHTTPError as e:30 print(str(e)) # formatted message31 e.request_id, e.server_message # details returned by server32 33 # Complete the error message with additional information once it's raised34 e.append_to_message("35`create_commit` expects the repository to exist.")36 raise37 ```38 N)�server_message�message�responser/ c �& >� UR R S5 =( d= UR R S5 =( d UR R S5 U l X0l X l UR39 U l [ TU ] U5 g )Nz x-request-idzX-Amzn-Trace-Idz x-amz-cf-id)�headers�get�40request_idr/ r1 �requestr
r )r r0 r1 r/ r s �r r �HfHubHTTPError.__init__E sz �� �
� � � � � � 0�
3�� � �#�#�$5�6�
3�� � �#�#�M�2�
��41 -�� �
� �'�'�� �
����!r �additional_message�returnc �T � U R S U- 4U R SS - U l g)zFAppend additional information to the `HfHubHTTPError` initial message.r � N)r )r r8 s r �append_to_message� HfHubHTTPError.append_to_messageV s) � ��Y�Y�q�\�$6�6�8�4�9�9�Q�R�=�H�� r c � � U " XUS9$ )N)r1 r/ r# )�clsr0 r1 r/ s r � _reconstruct_hf_hub_http_error�-HfHubHTTPError._reconstruct_hf_hub_http_errorZ s � � �7�n�M�Mr c �r � U R R [ U 5 U R U R 44$ )zeFix pickling of Exception subclass with kwargs. We need to override __reduce_ex__ of the parent class)r r@ r r1 r/ )r �protocols r �
__reduce_ex__� HfHubHTTPError.__reduce_ex__` s- � ����=�=��D� �4�=�=�Z^�Zm�Zm�?n�o�or )r r6 r5 r1 r/ )r r r r r r r r r< � classmethodr@ rD r r r s @r r- r- ' s� �� ��D &*� "��"� � "�42 �d�43� "� "�"I�C� I�D� I� �N��N�%-�N�?B�T�z�N� �N� �N�44p� pr r- c � � \ rS rSrSrSrg)�InferenceTimeoutError�h zBError raised when a model is unavailable or the request times out.r# Nr$ r# r r rH rH h s � �Lr rH c � � \ rS rSrSrSrg)�InferenceEndpointError�o z8Generic exception when dealing with Inference Endpoints.r# Nr$ r# r r rK rK o s � �Br rK c � � \ rS rSrSrSrg)� InferenceEndpointTimeoutError�s z<Exception for timeouts while waiting for Inference Endpoint.r# Nr$ r# r r rN rN s s � �Fr rN c � � \ rS rSrSrSrg)�SafetensorsParsingError�z z�Raised when failing to parse a safetensors file metadata.45 46This can be the case if the file is not a safetensors file or does not respect the specification.47r# Nr$ r# r r rQ rQ z � � �r rQ c � � \ rS rSrSrSrg)�NotASafetensorsRepoError� z�Raised when a repo is not a Safetensors repo i.e. doesn't have either a `model.safetensors` or a48`model.safetensors.index.json` file.49r# Nr$ r# r r rU rU � s � �r rU c � � \ rS rSrSrSrg)�TextGenerationError� z3Generic error raised if text-generation went wrong.r# Nr$ r# r r rX rX � � � �=r rX c � � \ rS rSrSrSrg)�ValidationError� z Server-side validation error.r# Nr$ r# r r r\ r\ � s � �'r r\ c � � \ rS rSrSrg)�GenerationError� r# N�r r r r r r# r r r_ r_ � � � �r r_ c � � \ rS rSrSrg)�OverloadedError� r# Nra r# r r rd rd � rb r rd c � � \ rS rSrSrg)�IncompleteGenerationError� r# Nra r# r r rg rg � rb r rg c � � \ rS rSrSrg)� UnknownError� r# Nra r# r r rj rj � rb r rj c � � \ rS rSrSrSrg)�HFValidationError� z�Generic exception thrown by `huggingface_hub` validators.50 51Inherits from [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError).52r# Nr$ r# r r rm rm � rS r rm c �8 ^ � \ rS rSrSrS\S\4U 4S jjrSrU =r$ )�53HfUriError� a$ Raised when an `hf://...` URI is malformed.54 55See [`parse_hf_uri`] and the56[HF URIs reference](https://huggingface.co/docs/huggingface_hub/main/en/package_reference/hf_uris)57for the canonical syntax.58 59Inherits from [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError).60�urir61 c �d >� Xl X l U( a SU SU 3OSU 3n[ TU ]
U5 g )NzInvalid HF URI 'z'. zInvalid HF URI. )rr r62 r
r )r rr r63 �full_msgr s �r r �HfUriError.__init__� s; �� �����7:�%�c�U�#�c�U�3�BR�SV�RW�@X��
����"r )r64 rr � r r r r r r r r r r s @r rp rp � s �� ��#�C� #�c� #� #r rp c � � \ rS rSrSrSrg)� DryRunError�� zXError triggered when a dry run is requested but cannot be performed (e.g. invalid repo).r# Nr$ r# r r rx rx � � � �br rx c � � \ rS rSrSrSrg)�FileMetadataError�� z�Error triggered when the metadata of a file on the Hub cannot be retrieved (missing ETag or commit_hash).65 66Inherits from `OSError` for backward compatibility.67r# Nr$ r# r r r| r| � rS r r| c �. � \ rS rSr% SrSr\S- \S' Srg)�BucketNotFoundError�� a� 68Raised when trying to access a bucket that does not exist.69 70Attributes:71 bucket_id (`str` or `None`):72 The bucket id (namespace/name) that was not found, if it could be determined from the request URL.73 74Example:75 76```py77>>> from huggingface_hub import bucket_info78>>> bucket_info("<non_existent_bucket>")79(...)80huggingface_hub.errors.BucketNotFoundError: 404 Client Error. (Request ID: XXX)81 82Bucket Not Found for url: https://huggingface.co/api/buckets/namespace/name.83Please make sure you specified the correct bucket id (namespace/name).84If the bucket is private, make sure you are authenticated and your token has the required permissions.85```86N� bucket_idr# ) r r r r r r� r r r r# r r r r � s � ��* !�I�s�T�z� r r c �B � \ rS rSr% SrSr\S- \S' Sr\S- \S' Sr g)�RepositoryNotFoundError�� a� 87Raised when trying to access a hf.co URL with an invalid repository name, or88with a private repo name the user does not have access to.89 90Attributes:91 repo_id (`str` or `None`):92 The repo id that was not found, if it could be determined from the request URL.93 repo_type (`str` or `None`):94 The repo type ("model", "dataset", or "space"), if it could be determined from the request URL.95 96Example:97 98```py99>>> from huggingface_hub import model_info100>>> model_info("<non_existent_repository>")101(...)102huggingface_hub.errors.RepositoryNotFoundError: 401 Client Error. (Request ID: PvMw_VjBMjVdMz53WKIzP)103 104Repository Not Found for url: https://huggingface.co/api/models/%3Cnon_existent_repository%3E.105Please make sure you specified the correct `repo_id` and `repo_type`.106If the repo is private, make sure you are authenticated and your token has the required permissions.107Invalid username or password.108```109N�repo_id� repo_typer# �110r r r r r r� r r r� r r# r r r� r� � s% � ��2 �G�S�4�Z� � �I�s�T�z� r r� c � � \ rS rSrSrSrg)�GatedRepoErrori a� 111Raised when trying to access a gated repository for which the user is not on the112authorized list.113 114Note: derives from `RepositoryNotFoundError` to ensure backward compatibility.115 116Example:117 118```py119>>> from huggingface_hub import model_info120>>> model_info("<gated_repository>")121(...)122huggingface_hub.errors.GatedRepoError: 403 Client Error. (Request ID: ViT1Bf7O_026LGSQuVqfa)123 124Cannot access gated repo for url https://huggingface.co/api/models/ardent-figment/gated-model.125Access to model ardent-figment/gated-model is restricted and you are not in the authorized list.126Visit https://huggingface.co/ardent-figment/gated-model to ask for access.127```128r# Nr$ r# r r r� r� s � �r r� c � � \ rS rSrSrSrg)�DisabledRepoErrori a� 129Raised when trying to access a repository that has been disabled by its author.130 131Example:132 133```py134>>> from huggingface_hub import dataset_info135>>> dataset_info("laion/laion-art")136(...)137huggingface_hub.errors.DisabledRepoError: 403 Client Error. (Request ID: Root=1-659fc3fa-3031673e0f92c71a2260dbe2;bc6f4dfb-b30a-4862-af0a-5cfe827610d8)138 139Cannot access repository for url https://huggingface.co/api/datasets/laion/laion-art.140Access to this resource is disabled.141```142r# Nr$ r# r r r� r� � � �r r� c �B � \ rS rSr% SrSr\S- \S' Sr\S- \S' Sr g)�RevisionNotFoundErrori4 a� 143Raised when trying to access a hf.co URL with a valid repository but an invalid144revision.145 146Attributes:147 repo_id (`str` or `None`):148 The repo id, if it could be determined from the request URL.149 repo_type (`str` or `None`):150 The repo type ("model", "dataset", or "space"), if it could be determined from the request URL.151 152Example:153 154```py155>>> from huggingface_hub import hf_hub_download156>>> hf_hub_download('bert-base-cased', 'config.json', revision='<non-existent-revision>')157(...)158huggingface_hub.errors.RevisionNotFoundError: 404 Client Error. (Request ID: Mwhe_c3Kt650GcdKEFomX)159 160Revision Not Found for url: https://huggingface.co/bert-base-cased/resolve/%3Cnon-existent-revision%3E/config.json.161```162Nr� r� r# r� r# r r r� r� 4 �% � ��, �G�S�4�Z� � �I�s�T�z� r r� c � � \ rS rSrSrSrg)�EntryNotFoundErroriP a� 163Raised when entry not found, either locally or remotely.164 165Example:166 167```py168>>> from huggingface_hub import hf_hub_download169>>> hf_hub_download('bert-base-cased', '<non-existent-file>')170(...)171huggingface_hub.errors.RemoteEntryNotFoundError (...)172>>> hf_hub_download('bert-base-cased', '<non-existent-file>', local_files_only=True)173(...)174huggingface_hub.utils.errors.LocalEntryNotFoundError (...)175```176r# Nr$ r# r r r� r� P r� r r� c �B � \ rS rSr% SrSr\S- \S' Sr\S- \S' Sr g)�RemoteEntryNotFoundErrorib a� 177Raised when trying to access a hf.co URL with a valid repository and revision178but an invalid filename.179 180Attributes:181 repo_id (`str` or `None`):182 The repo id, if it could be determined from the request URL.183 repo_type (`str` or `None`):184 The repo type ("model", "dataset", or "space"), if it could be determined from the request URL.185 186Example:187 188```py189>>> from huggingface_hub import hf_hub_download190>>> hf_hub_download('bert-base-cased', '<non-existent-file>')191(...)192huggingface_hub.errors.EntryNotFoundError: 404 Client Error. (Request ID: 53pNl6M0MxsnG5Sw8JA6x)193 194Entry Not Found for url: https://huggingface.co/bert-base-cased/resolve/main/%3Cnon-existent-file%3E.195```196Nr� r� r# r� r# r r r� r� b r� r r� c �4 ^ � \ rS rSrSrS\4U 4S jjrSrU =r$ )�LocalEntryNotFoundErrori} a 197Raised when trying to access a file or snapshot that is not on the disk when network is198disabled or unavailable (connection issue). The entry may exist on the Hub.199 200Example:201 202```py203>>> from huggingface_hub import hf_hub_download204>>> hf_hub_download('bert-base-cased', '<non-cached-file>', local_files_only=True)205(...)206huggingface_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.207```208r0 c �$ >� [ TU ] U5 g r )r
r )r r0 r s �r r � LocalEntryNotFoundError.__init__� s �� �
����!r r# rv r s @r r� r� } s �� � � "�� "� "r r� c � � \ rS rSrSrSrg)�BadRequestErrori� a' 209Raised by `hf_raise_for_status` when the server returns a HTTP 400 error.210 211Example:212 213```py214>>> resp = httpx.post("hf.co/api/check", ...)215>>> hf_raise_for_status(resp, endpoint_name="check")216huggingface_hub.errors.BadRequestError: Bad request for check endpoint: {details} (Request ID: XXX)217```218r# Nr$ r# r r r� r� � s � �219r r� c � � \ rS rSrSrSrg)� DDUFErrori� z5Base exception for errors related to the DDUF format.r# Nr$ r# r r r� r� � s � �?r r� c � � \ rS rSrSrSrg)�DDUFCorruptedFileErrori� z1Exception thrown when the DDUF file is corrupted.r# Nr$ r# r r r� r� � � � �;r r� c � � \ rS rSrSrSrg)�DDUFExportErrori� z-Base exception for errors during DDUF export.r# Nr$ r# r r r� r� � s � �7r r� c � � \ rS rSrSrSrg)�DDUFInvalidEntryNameErrori� z0Exception thrown when the entry name is invalid.r# Nr$ r# r r r� r� � r( r r� c � � \ rS rSrSrSrg)�StrictDataclassErrori� z&Base exception for strict dataclasses.r# Nr$ r# r r r� r� � s � �0r r� c � � \ rS rSrSrSrg)� StrictDataclassDefinitionErrori� z@Exception thrown when a strict dataclass is defined incorrectly.r# Nr$ r# r r r� r� � s � �Jr r� c �8 ^ � \ rS rSrSrS\S\4U 4S jjrSrU =r $ )�#StrictDataclassFieldValidationErrori� zLException thrown when a strict dataclass fails validation for a given field.�field�causec �n >� SU S3nUSUR R SU 3-
n[ TU ]
U5 g )Nz Validation error for field '�':�220 �: �r r r
r )r r� r� �
error_messager s �r r �,StrictDataclassFieldValidationError.__init__� s@ �� �6�u�g�R�@�
��6�%�/�/�":�":�!;�2�e�W�E�E�
�
��� �'r r# �221r r r r r r � Exceptionr r r r s @r r� r� � s �� �V�(�c� (�)� (� (r r� c �8 ^ � \ rS rSrSrS\S\4U 4S jjrSrU =r $ )�#StrictDataclassClassValidationErrori� zOException thrown when a strict dataclass fails validation on a class validator.� validatorr� c �n >� SU S3nUSUR R SU 3-
n[ TU ]
U5 g )Nz&Class validation error for validator 'r� r� r� r� )r r� r� r� r s �r r �,StrictDataclassClassValidationError.__init__� s@ �� �@�� �2�N�
��6�%�/�/�":�":�!;�2�e�W�E�E�
�
��� �'r r# r� r s @r r� r� � s �� �Y�(�#� (�i� (� (r r� c � � \ rS rSrSrSrg)�XetErrori� z1Base exception for errors related to Xet Storage.r# Nr$ r# r r r� r� � r� r r� c � � \ rS rSrSrSrg)�XetAuthorizationErrori� zXException thrown when the user does not have the right authorization to use Xet Storage.r# Nr$ r# r r r� r� � rz r r� c � � \ rS rSrSrSrg)�XetRefreshTokenErrori� z3Exception thrown when the refresh token is invalid.r# Nr$ r# r r r� r� � rZ r r� c � � \ rS rSrSrSrg)�XetDownloadErrori� z:Exception thrown when the download from Xet Storage fails.r# Nr$ r# r r r� r� � s � �Dr r� c � � \ rS rSrSrSrg)�CLIErrori� z7CLI error with clean message (no traceback by default).r# Nr$ r# r r r� r� � s � �Ar r� c � � \ rS rSrSrSrg)�ConfirmationErrori� zERaised when a confirmation prompt is declined (non-interactive mode).r# Nr$ r# r r r� r� � s � �Or r� c � � \ rS rSrSrSrg)�CLIExtensionInstallErrori� z(Error during CLI extension installation.r# Nr$ r# r r r� r� � s � �2r r� N)9r �pathlibr �httpxr r r� r r! �EnvironmentErrorr& �ConnectionErrorr* �OSErrorr- � TimeoutErrorrH rK rN rQ rU rX r\ r_ rd rg rj �222ValueErrorrm rp rx r| r r� r� r� r� r� r� �FileNotFoundErrorr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r# r r �<module>r� sS �� !� � %� #�I� #�R�i� R�;� .� ;�_�?� _�;p�Y�� ;p�BM�I�|� M�C�Y� C�G�$:�L� G��i� ��y� �>�)� >�223(�)� (� �)� � �)� � � 3� � �&� ��224� �#�� #�(c�'� c��� �!�.� !�8!�n� !�<�,� �,�� �*!�N� !�8�� �$!�~�/A� !�6"� /�1C� "�( �n�j� �"@� � @�<�Y� <�8�i� 8�;�� ;�1�9� 1�K�%9� K�(�*>� (�(�*>� (�<�y� <�c�H� c�>�8� >�E�y� E�B�y� B�P�� P�3�x� 3r