+
    &j:                        R t ^ RIHt ^ RIHtHt  ! R R]4      t ! R R]4      t ! R R]	4      t
 ! R	 R
]4      t ! R R]]4      t ! R R]]4      t ! R R]4      t ! R R]]4      t ! R R]4      t ! R R]4      t ! R R]4      t ! R R]4      t ! R R]4      t ! R R]4      t ! R R ]4      t ! R! R"]4      t ! R# R$]4      t ! R% R&]4      t ! R' R(]4      t ! R) R*]4      t ! R+ R,]4      t  ! R- R.]4      t! ! R/ R0]!4      t" ! R1 R2]4      t# ! R3 R4]4      t$ ! R5 R6]4      t% ! R7 R8]]%4      t& ! R9 R:]']%4      t( ! R; R<]]4      t) ! R= R>]4      t* ! R? R@]*4      t+ ! RA RB]*4      t, ! RC RD],4      t- ! RE RF]4      t. ! RG RH].4      t/ ! RI RJ].4      t0 ! RK RL].4      t1 ! RM RN]4      t2 ! RO RP]24      t3 ! RQ RR]24      t4 ! RS RT]4      t5 ! RU RV]4      t6 ! RW RX]4      t7 ! RY RZ]74      t8 ! R[ R\]74      t9R]# )^zContains all custom errors.)Path)	HTTPErrorResponsec                   N   a a ] tR t^t oRtV3R lV 3R lltV3R ltRtVtV ;t	# )CacheNotFoundz9Exception thrown when the Huggingface cache is not found.c                6   < V ^8  d   QhRS[ RS[ S[,          /# )   msg	cache_dirstrr   )format__classdict__s   "n/Users/jameslopez/projects/CWCArchive/cwc-podcast/.venv/lib/python3.14/site-packages/huggingface_hub/errors.py__annotate__CacheNotFound.__annotate__   s     # #C #C$J #    c                <   < \         SV `  ! V.VO5/ VB  W n        R # N)super__init__r
   )selfr	   r
   argskwargs	__class__s   &&&*,r   r   CacheNotFound.__init__   s    .t.v."r   c                6   < V ^8  d   Qh/ S[ S[,          ;R&   # )r   r
   r   )r   r   s   "r   r   r      s      Tz r   )r
   )
__name__
__module____qualname____firstlineno____doc__r   __annotate_func____static_attributes____classdictcell____classcell__r   r   s   @@r   r   r      s     C# #  r   r   c                       ] tR t^tRtRtR# )CorruptedCacheExceptionzGException 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                       ] tR t^tRtRtR# )LocalTokenNotFoundErrorz0Raised if local token is required but not found.r)   Nr*   r)   r   r   r,   r,          :r   r,   c                       ] tR t^#tRtRtR# )OfflineModeIsEnabledzTRaised 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                   ~   a a ] tR t^'t oRtRR/V3R lV 3R llltV3R lR lt]V3R lR	 l4       tR
 t	Rt
Vt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 ^8  d   QhRS[ RS[RS[ R,          /# )r   messageresponser2   Nr   r   )r   r   s   "r   r   HfHubHTTPError.__annotate__E   s-     " "" 	"
 d
"r   c               ,  < VP                   P                  R 4      ;'       g?    VP                   P                  R4      ;'       g    VP                   P                  R4      V n        W0n        W n        VP
                  V n        \        SV `  V4       R# )zx-request-idzX-Amzn-Trace-Idzx-amz-cf-idN)headersget
request_idr2   r5   requestr   r   )r   r4   r5   r2   r   s   &&$$r   r   HfHubHTTPError.__init__E   s       0 3 3##$563 3##M2 	
 - ''!r   c                $   < V ^8  d   QhRS[ RR/# )r   additional_messagereturnNr   )r   r   s   "r   r   r7   V   s     I IC ID Ir   c                v    V P                   ^ ,          V,           3V P                   R,          ,           V n         R# )zFAppend additional information to the `HfHubHTTPError` initial message.:   NNN)r   )r   r?   s   &&r   append_to_message HfHubHTTPError.append_to_messageV   s'    YYq\$668499R=H	r   c                >   < V ^8  d   QhRS[ RS[RS[ R,          RR/# )r   r4   r5   r2   Nr@   r1   r6   )r   r   s   "r   r   r7   [   s7     N NN%-N?BTzN	Nr   c                    V ! WVR 7      # ))r5   r2   r)   )clsr4   r5   r2   s   &&&&r   _reconstruct_hf_hub_http_error-HfHubHTTPError._reconstruct_hf_hub_http_errorZ   s     7nMMr   c                r    V P                   P                  \        V 4      V P                  V P                  33# )zeFix pickling of Exception subclass with kwargs. We need to override __reduce_ex__ of the parent class)r   rI   r   r5   r2   )r   protocols   &&r   __reduce_ex__HfHubHTTPError.__reduce_ex__`   s-    ==D	4==Z^ZmZm?noor   )r   r<   r;   r5   r2   )r   r   r   r    r!   r   rD   classmethodrI   rM   r#   r$   r%   r&   s   @@r   r1   r1   '   sL     :"
 &*" ""I I N N
p pr   r1   c                       ] tR t^htRtRtR# )InferenceTimeoutErrorzBError raised when a model is unavailable or the request times out.r)   Nr*   r)   r   r   rQ   rQ   h   s    Lr   rQ   c                       ] tR t^otRtRtR# )InferenceEndpointErrorz8Generic exception when dealing with Inference Endpoints.r)   Nr*   r)   r   r   rS   rS   o   s    Br   rS   c                       ] tR t^stRtRtR# )InferenceEndpointTimeoutErrorz<Exception for timeouts while waiting for Inference Endpoint.r)   Nr*   r)   r   r   rU   rU   s   s    Fr   rU   c                       ] tR t^ztRtRtR# )SafetensorsParsingErrorzRaised when failing to parse a safetensors file metadata.

This can be the case if the file is not a safetensors file or does not respect the specification.
r)   Nr*   r)   r   r   rW   rW   z       r   rW   c                       ] tR t^tRtRtR# )NotASafetensorsRepoErrorzRaised when a repo is not a Safetensors repo i.e. doesn't have either a `model.safetensors` or a
`model.safetensors.index.json` file.
r)   Nr*   r)   r   r   rZ   rZ      s    r   rZ   c                       ] tR t^tRtRtR# )TextGenerationErrorz3Generic error raised if text-generation went wrong.r)   Nr*   r)   r   r   r\   r\          =r   r\   c                       ] tR t^tRtRtR# )ValidationErrorzServer-side validation error.r)   Nr*   r)   r   r   r_   r_      s    'r   r_   c                       ] tR t^tRtR# )GenerationErrorr)   Nr   r   r   r    r#   r)   r   r   ra   ra          r   ra   c                       ] tR t^tRtR# )OverloadedErrorr)   Nrb   r)   r   r   re   re      rc   r   re   c                       ] tR t^tRtR# )IncompleteGenerationErrorr)   Nrb   r)   r   r   rg   rg      rc   r   rg   c                       ] tR t^tRtR# )UnknownErrorr)   Nrb   r)   r   r   ri   ri      rc   r   ri   c                       ] tR t^tRtRtR# )HFValidationErrorzGeneric exception thrown by `huggingface_hub` validators.

Inherits from [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError).
r)   Nr*   r)   r   r   rk   rk      rX   r   rk   c                   B   a a ] tR t^t oRtV3R lV 3R lltRtVtV ;t# )
HfUriErrora$  Raised when an `hf://...` URI is malformed.

See [`parse_hf_uri`] and the
[HF URIs reference](https://huggingface.co/docs/huggingface_hub/main/en/package_reference/hf_uris)
for the canonical syntax.

Inherits from [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError).
c                &   < V ^8  d   QhRS[ RS[ /# )r   urir	   rA   )r   r   s   "r   r   HfUriError.__annotate__   s     # #C #c #r   c                h   < Wn         W n        V'       d	   R V RV 2MRV 2p\        SV `  V4       R# )zInvalid HF URI 'z'. zInvalid HF URI. N)ro   r	   r   r   )r   ro   r	   full_msgr   s   &&& r   r   HfUriError.__init__   s;    7:%cU#cU3BRSVRW@X"r   )r	   ro   	r   r   r   r    r!   r   r#   r$   r%   r&   s   @@r   rm   rm      s     # # #r   rm   c                       ] tR t^tRtRtR# )DryRunErrorzXError triggered when a dry run is requested but cannot be performed (e.g. invalid repo).r)   Nr*   r)   r   r   rv   rv          br   rv   c                       ] tR t^tRtRtR# )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)   r   r   ry   ry      rX   r   ry   c                   4   a  ] tR t^t o RtRtV 3R ltRtV tR# )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("<non_existent_bucket>")
(...)
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.
```
Nc                4   < V ^8  d   Qh/ S[ R,          ;R&   # )r   N	bucket_idrA   )r   r   s   "r   r    BucketNotFoundError.__annotate__   s     , Tz - r   r)   )	r   r   r   r    r!   r}   r"   r#   r$   r   s   @r   r{   r{      s     * !I-  r   r{   c                   8   a  ] tR t^t o RtRtRtV 3R ltRtV t	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.

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("<non_existent_repository>")
(...)
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.
```
Nc                N   < V ^8  d   Qh/ S[ R,          ;R&   S[ R,          ;R&   # r   Nrepo_id	repo_typerA   )r   r   s   "r   r   $RepositoryNotFoundError.__annotate__   s'     4 4Z5 6 Tz 7 r   r)   
r   r   r   r    r!   r   r   r"   r#   r$   r   s   @r   r   r      s     2 G I7  r   r   c                       ] tR tRtRtRtR# )GatedRepoErrori	  a  
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("<gated_repository>")
(...)
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)   r   r   r   r   	  s    r   r   c                       ] tR tRtRtRtR# )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)   r   r   r   r         r   r   c                   8   a  ] tR tRt o RtRtRtV 3R ltRtV t	R# )RevisionNotFoundErrori4  a  
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='<non-existent-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.
```
Nc                N   < V ^8  d   Qh/ S[ R,          ;R&   S[ R,          ;R&   # r   rA   )r   r   s   "r   r   "RevisionNotFoundError.__annotate__4  '     . 4Z/ 0 Tz 1 r   r)   r   r   s   @r   r   r   4       , G I1  r   r   c                       ] tR tRtRtRtR# )EntryNotFoundErroriP  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', '<non-existent-file>')
(...)
huggingface_hub.errors.RemoteEntryNotFoundError (...)
>>> hf_hub_download('bert-base-cased', '<non-existent-file>', local_files_only=True)
(...)
huggingface_hub.utils.errors.LocalEntryNotFoundError (...)
```
r)   Nr*   r)   r   r   r   r   P  r   r   r   c                   8   a  ] tR tRt o RtRtRtV 3R ltRtV t	R# )RemoteEntryNotFoundErrorib  a  
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', '<non-existent-file>')
(...)
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.
```
Nc                N   < V ^8  d   Qh/ S[ R,          ;R&   S[ R,          ;R&   # r   rA   )r   r   s   "r   r   %RemoteEntryNotFoundError.__annotate__b  r   r   r)   r   r   s   @r   r   r   b  r   r   r   c                   B   a a ] tR tRt oRtV3R lV 3R lltRtVtV ;t# )LocalEntryNotFoundErrori}  a  
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', '<non-cached-file>',  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 ^8  d   QhRS[ /# )r   r4   rA   )r   r   s   "r   r   $LocalEntryNotFoundError.__annotate__  s     " " "r   c                &   < \         SV `  V4       R # r   )r   r   )r   r4   r   s   &&r   r    LocalEntryNotFoundError.__init__  s    !r   r)   rt   r&   s   @@r   r   r   }  s     " " "r   r   c                       ] tR tRtRtRtR# )BadRequestErrori  a'  
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)   r   r   r   r     s    
r   r   c                       ] tR tRtRtRtR# )	DDUFErrori  z5Base exception for errors related to the DDUF format.r)   Nr*   r)   r   r   r   r     s    ?r   r   c                       ] tR tRtRtRtR# )DDUFCorruptedFileErrori  z1Exception thrown when the DDUF file is corrupted.r)   Nr*   r)   r   r   r   r         ;r   r   c                       ] tR tRtRtRtR# )DDUFExportErrori  z-Base exception for errors during DDUF export.r)   Nr*   r)   r   r   r   r     s    7r   r   c                       ] tR tRtRtRtR# )DDUFInvalidEntryNameErrori  z0Exception thrown when the entry name is invalid.r)   Nr*   r)   r   r   r   r     r-   r   r   c                       ] tR tRtRtRtR# )StrictDataclassErrori  z&Base exception for strict dataclasses.r)   Nr*   r)   r   r   r   r     s    0r   r   c                       ] tR tRtRtRtR# )StrictDataclassDefinitionErrori  z@Exception thrown when a strict dataclass is defined incorrectly.r)   Nr*   r)   r   r   r   r     s    Jr   r   c                   B   a a ] tR tRt oRtV3R lV 3R lltRtVtV ;t# )#StrictDataclassFieldValidationErrori  zLException thrown when a strict dataclass fails validation for a given field.c                &   < V ^8  d   QhRS[ RS[/# )r   fieldcauser   	Exception)r   r   s   "r   r   0StrictDataclassFieldValidationError.__annotate__  s     ( (c () (r   c                x   < R V R2pVRVP                   P                   RV 2,          p\        SV `  V4       R# )zValidation error for field '':
    : Nr   r   r   r   )r   r   r   error_messager   s   &&& r   r   ,StrictDataclassFieldValidationError.__init__  s@    6ugR@6%//":":!;2eWEE'r   r)   rt   r&   s   @@r   r   r     s     V( ( (r   r   c                   B   a a ] tR tRt oRtV3R lV 3R lltRtVtV ;t# )#StrictDataclassClassValidationErrori  zOException thrown when a strict dataclass fails validation on a class validator.c                &   < V ^8  d   QhRS[ RS[/# )r   	validatorr   r   )r   r   s   "r   r   0StrictDataclassClassValidationError.__annotate__  s     ( (# (i (r   c                x   < R V R2pVRVP                   P                   RV 2,          p\        SV `  V4       R# )z&Class validation error for validator 'r   r   r   Nr   )r   r   r   r   r   s   &&& r   r   ,StrictDataclassClassValidationError.__init__  s@    @2N6%//":":!;2eWEE'r   r)   rt   r&   s   @@r   r   r     s     Y( ( (r   r   c                       ] tR tRtRtRtR# )XetErrori  z1Base exception for errors related to Xet Storage.r)   Nr*   r)   r   r   r   r     r   r   r   c                       ] tR tRtRtRtR# )XetAuthorizationErrori  zXException thrown when the user does not have the right authorization to use Xet Storage.r)   Nr*   r)   r   r   r   r     rw   r   r   c                       ] tR tRtRtRtR# )XetRefreshTokenErrori  z3Exception thrown when the refresh token is invalid.r)   Nr*   r)   r   r   r   r     r]   r   r   c                       ] tR tRtRtRtR# )XetDownloadErrori  z:Exception thrown when the download from Xet Storage fails.r)   Nr*   r)   r   r   r   r     s    Dr   r   c                       ] tR tRtRtRtR# )FileDuplicationErrori  z1Raised when duplicating files across repos fails.r)   Nr*   r)   r   r   r   r     r   r   r   c                       ] tR tRtRtRtR# )CLIErrori  z7CLI error with clean message (no traceback by default).r)   Nr*   r)   r   r   r   r     s    Ar   r   c                       ] tR tRtRtRtR# )ConfirmationErrori  zERaised when a confirmation prompt is declined (non-interactive mode).r)   Nr*   r)   r   r   r   r     s    Or   r   c                       ] tR tRtRtRtR# )CLIExtensionInstallErrori  z(Error during CLI extension installation.r)   Nr*   r)   r   r   r   r     s    2r   r   N):r!   pathlibr   httpxr   r   r   r   r(   EnvironmentErrorr,   ConnectionErrorr/   OSErrorr1   TimeoutErrorrQ   rS   rU   rW   rZ   r\   r_   ra   re   rg   ri   
ValueErrorrk   rm   rv   ry   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   r   <module>r      s_   !  %#I #Ri R;. ;_? _;pY ;pBMI| MCY CG$:L Gi y >) >
() (	) 		) 		 3 		& 	
 # #(c' c !. !8!n !<, , *!N !8 $!~/A !6"/1C "(nj "@	 @<Y <8i 8; ;19 1K%9 K(*> ((*> (<y <cH c>8 >Ey E<9 <By BP P3x 3r   