_iّd%SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK J r SSK J r SSK Jr SSKJrJrJrJrJrJr SSKrSSKJr SS KJr SS KJrJrJrJrJ r J!r!J"r" S S KJ#r# S S K$J%r% S SK&J'r' \#RP"\)5r*\ "SS9"SS55r+\RX"S5r-\RX"S5r.S\\/\/4S\\+4Sjr0Sr1Sr2\RX"S\RfS9r4S\RjSS4Sjr6S\RjSS4Sjr7S\RpSS4S jr9S\Rt4S!jr;S\Rx4S"jr=\/\Rt4r>\/\Rx4r?\R"5rA\;qB\>\CS#'\=qD\?\CS$'SqE\\Rt\CS%'S&\>SS4S'jrFS(\?SS4S)jrGS\Rt4S*jrHS\Rx4S+jrISPS,jrJ\R"\J5 \L"\S-5(a\R"\JS.9 \R\R4rP\Q\R\SS/4\CS0'S1rT\Q\US/4\CS2'S3S S4\P\TS5S6.S7\'S8\/S9\US:\VS;\VS<\\R\S\Q\R\SS/44S=\\U\Q\US/44S>\WS\\RpSS44S?jjrXS3S S4\P\TS@.S7\'S8\/S9\US:\VS;\VS<\\R\S\Q\R\SS/44S=\\U\Q\US/44S\Rp4SAjjrY\ S3S S4\P\TS@.S7\'S8\/S9\US:\VS;\VS<\\R\S\Q\R\SS/44S=\\U\Q\US/44S\\RpSS44SBjj5rZS8\/SC\\/S\/4SDjr[SQS\RpSE\\/SS4SFjjr\\]"5r^S\RpSS4SGjr_SH\R\SI\/S\RpS\4SJjr`S\RjS\/4SKjra\RX"SL\R5rcSM\\/SN\US\\/4SOjrdg)Rz>Contains utilities to handle HTTP requests in huggingface_hub.N)contextmanager) dataclass)quote)AnyCallable GeneratorMappingOptionalUnion)OfflineModeIsEnabled) constants)BadRequestErrorDisabledRepoErrorGatedRepoErrorHfHubHTTPErrorRemoteEntryNotFoundErrorRepositoryNotFoundErrorRevisionNotFoundError)logging) SliceFileObj) HTTP_METHOD_TT)frozenc`\rSrSr%Sr\\S'\\S'\\S'Sr\ \\S'Sr \ \\S'S r g) RateLimitInfo4a Parsed rate limit information from HTTP response headers. Attributes: resource_type (`str`): The type of resource being rate limited. remaining (`int`): The number of requests remaining in the current window. reset_in_seconds (`int`): The number of seconds until the rate limit resets. limit (`int`, *optional*): The maximum number of requests allowed in the current window. window_seconds (`int`, *optional*): The number of seconds in the current window. resource_type remainingreset_in_secondsNlimitwindow_seconds) __name__ __module__ __qualname____firstlineno____doc__str__annotations__intr!r r"__static_attributes__r#W/var/www/html/land-ocr/venv/lib/python3.13/site-packages/huggingface_hub/utils/_http.pyrr4s6 NE8C=$(NHSM(r-rzL\"(?P\w+)\"\s*;\s*r\s*=\s*(?P\d+)\s*;\s*t\s*=\s*(?P\d+)z'q\s*=\s*(?P\d+).*?w\s*=\s*(?P\d+)headersreturncSnSnUH+nUR5nUS:XaXnMUS:XdM'XnM- U(dg[RU5nU(dgURS5n[ URS55n[ URS55nSn Sn U(aP[ RU5n U (a4[ U RS55n [ U RS55n [ UUUU U S 9$) aParse rate limit information from HTTP response headers. Follows IETF draft: https://www.ietf.org/archive/id/draft-ietf-httpapi-ratelimit-headers-09.html Only a subset is implemented. Example: ```python >>> from huggingface_hub.utils import parse_ratelimit_headers >>> headers = { ... "ratelimit": '"api";r=0;t=55', ... "ratelimit-policy": '"fixed window";"api";q=500;w=300', ... } >>> info = parse_ratelimit_headers(headers) >>> info.remaining 0 >>> info.reset_in_seconds 55 ``` N ratelimitzratelimit-policyrrtqw)rrr r!r")lower_RATELIMIT_REGEXsearchgroupr+_RATELIMIT_POLICY_REGEXr) r/r2policykey lower_keymatchrrr r!r" policy_matchs r.parse_ratelimit_headersrAPs* $I FIIK  # I , ,\F    # #I .E KK0MEKK$%I5;;s+,E$(N .55f=  **3/0E !3!3C!89N #)%  r-zX-Amzn-Trace-Idz x-request-ida  # staging or production endpoint ^https://[^/]+ ( # on /api/repo_type/repo_id /api/(models|datasets|spaces)/(.+) | # or /repo_id/resolve/revision/... /(.+)/resolve/(.+) ) )flagsrequestc t[R"5(a[SURS35e[UR ;aUUR R [5=(d [[R"55UR ['UR R [5n[RSUURURUR R S5SL5 [R(a[RS[U55 U$)z Event hook that will be used to make HTTP requests to the Hugging Face Hub. What it does: - Block requests if offline mode is enabled - Add a request ID to the request headers - Log the request if debug mode is enabled z Cannot reach za: offline mode is enabled. To disable it, please unset the `HF_HUB_OFFLINE` environment variable.z%Request %s: %s %s (authenticated: %s) authorizationNzSend: %s)ris_offline_moder urlX_AMZN_TRACE_IDr/get X_REQUEST_IDr)uuiduuid4loggerdebugmethodHF_DEBUG_curlify)rC request_ids r.hf_request_event_hookrSs  """GKK=)J K  goo-+2??+>+>|+L+aPSTXT^T^T`Pa($$_5J LL/ O,D8  Z'!23 r-c # [U5$7f)z+ Async version of `hf_request_event_hook`. )rS)rCs r.async_hf_request_event_hookrUs ! ))s responsec# URS:aJSUR;a9[URS5nUS:aUR 5IShvN gggg![a gf=fN7f)NzContent-lengthi@B) status_coder/r+ ValueErroraread)rVlengths r.async_hf_response_event_hookr]ss" x// / X--.>?@ !nn&&&" 0#   's3!A0AA0A.A0 A+(A0*A++A0c ~[R"S[/0S[R"[R SS9S9$)zI Factory function to create a `httpx.Client` with the default transport. rCTN@write event_hooksfollow_redirectstimeout)httpxClientrSTimeoutrDEFAULT_REQUEST_TIMEOUTr#r-r.default_client_factoryrjs8 <<!6 78 i??tL r-c [R"[/[/S.S[R"[ R SS9S9$)zN Factory function to create a `httpx.AsyncClient` with the default transport. )rCrVTr_r`rb)rf AsyncClientrUr]rhrrir#r-r.default_async_client_factoryrms=   !< =LhKij i??tL r-_GLOBAL_CLIENT_FACTORY_GLOBAL_ASYNC_CLIENT_FACTORY_GLOBAL_CLIENTclient_factoryc\[ [5 UqSSS5 g!,(df  g=f)a Set the HTTP client factory to be used by `huggingface_hub`. The client factory is a method that returns a `httpx.Client` object. On the first call to [`get_client`] the client factory will be used to create a new `httpx.Client` object that will be shared between all calls made by `huggingface_hub`. This can be useful if you are running your scripts in a specific environment requiring custom configuration (e.g. custom proxy or certifications). Use [`get_client`] to get a correctly configured `httpx.Client`. N) _CLIENT_LOCK close_sessionrn)rqs r.set_client_factoryrus !/ s  +async_client_factorycUqg)a Set the HTTP async client factory to be used by `huggingface_hub`. The async client factory is a method that returns a `httpx.AsyncClient` object. This can be useful if you are running your scripts in a specific environment requiring custom configuration (e.g. custom proxy or certifications). Use [`get_async_client`] to get a correctly configured `httpx.AsyncClient`. Contrary to the `httpx.Client` that is shared between all calls made by `huggingface_hub`, the `httpx.AsyncClient` is not shared. It is recommended to use an async context manager to ensure the client is properly closed when the context is exited. Nro)rvs r.set_async_client_factoryrys $8 r-c[c[ [5qSSS5 [$[$!,(df  [$=f)z Get a `httpx.Client` object, using the transport factory from the user. This client is shared between all calls made by `huggingface_hub`. Therefore you should not close it manually. Use [`set_client_factory`] to customize the `httpx.Client`. N)rprsrnr#r-r. get_sessionr{s3 35N >\ s - Ac[5$)a Return a `httpx.AsyncClient` object, using the transport factory from the user. Use [`set_async_client_factory`] to customize the `httpx.AsyncClient`. Contrary to the `httpx.Client` that is shared between all calls made by `huggingface_hub`, the `httpx.AsyncClient` is not shared. It is recommended to use an async context manager to ensure the client is properly closed when the context is exited. rxr#r-r.get_async_sessionr})s  ( ))r-c[nSqUbUR5 gg![a"n[R SU35 SnAgSnAff=f)z Close the global `httpx.Client` used by `huggingface_hub`. If a Client is closed, it will be recreated on the next call to [`get_session`]. Can be useful if e.g. an SSL certificate has been updated. NzError closing client: )rpclose ExceptionrMwarning)clientes r.rtrt9sTFN 9 LLN 9 NN3A37 8 8 9s A AA register_at_fork)after_in_child._DEFAULT_RETRY_ON_EXCEPTIONS)iiii_DEFAULT_RETRY_ON_STATUS_CODESF) max_retriesbase_wait_time max_wait_timeretry_on_exceptionsretry_on_status_codesstreamrOrGrrrrrrc +N^^^^^^# [U[5(aU4n[T[5(aT4mSmUn SmSn SU;a;[US[R[ 45(aUSR 5n [5n TS- mSmU bUSRU 5 S[RS[4UUUUUU4Sjjn U(a;U R"STTS.UD6n U "U 5(dU v SSS5 gSSS5 O(U R"STTS.UD6n U "U 5(dU v gTb.[%T5S-n[RS US TSTS35 O!U n[RSUSTSTS35 [&R("U5 [+XIS-5n GM%!,(df  N=f!UaYn[RS US TS T35 [U[R 5(a [#5 TT:aUeSnANSnAff=f7f)zfInternal implementation of HTTP backoff logic shared between `http_backoff` and `http_stream_backoff`.rNdatarrVr0c>URT;ag[RSURSTST35 TT:a [U5 gURS:Xa$[ UR 5nUb UR mg)zNHandle response and return True if should retry, False if should return/yield.Fz HTTP Error z thrown while requesting  rT)rYrMrhf_raise_for_statusrAr/r )rVratelimit_inforrOnb_triesratelimit_resetrrGs r. _should_retry)_http_backoff_base.._should_retrys''/DD X-A-A,BB[\b[ccdehdijkk)'1!''3.%>KSKFK$X.."N/  & 1A5L NN3L>AWX`Waabcnbooqr s%L NN\,y !K=XZ[ \ < Q7  DED#  NNQse#=fXQseL M#u1122+% &  soB H%AG+F2>GH%GH%&G7A;H%2 G<G?H%GH" AHH%H""H%)rrrrrc <[[SUUUUUUUSS.UD65$)ax Wrapper around httpx to retry calls on an endpoint, with exponential backoff. Endpoint call is retried on exceptions (ex: connection timeout, proxy error,...) and/or on specific status codes (ex: service unavailable). If the call failed more than `max_retries`, the exception is thrown or `raise_for_status` is called on the response object. Re-implement mechanisms from the `backoff` library to avoid adding an external dependencies to `hugging_face_hub`. See https://github.com/litl/backoff. Args: method (`Literal["GET", "OPTIONS", "HEAD", "POST", "PUT", "PATCH", "DELETE"]`): HTTP method to perform. url (`str`): The URL of the resource to fetch. max_retries (`int`, *optional*, defaults to `5`): Maximum number of retries, defaults to 5 (no retries). base_wait_time (`float`, *optional*, defaults to `1`): Duration (in seconds) to wait before retrying the first time. Wait time between retries then grows exponentially, capped by `max_wait_time`. max_wait_time (`float`, *optional*, defaults to `8`): Maximum duration (in seconds) to wait before retrying. retry_on_exceptions (`type[Exception]` or `tuple[type[Exception]]`, *optional*): Define which exceptions must be caught to retry the request. Can be a single type or a tuple of types. By default, retry on `httpx.TimeoutException` and `httpx.NetworkError`. retry_on_status_codes (`int` or `tuple[int]`, *optional*, defaults to `(429, 500, 502, 503, 504)`): Define on which status codes the request must be retried. By default, retries on rate limit (429) and server errors (5xx). **kwargs (`dict`, *optional*): kwargs to pass to `httpx.request`. Example: ``` >>> from huggingface_hub.utils import http_backoff # Same usage as "httpx.request". >>> response = http_backoff("GET", "https://www.google.com") >>> response.raise_for_status() # If you expect a Gateway Timeout from time to time >>> http_backoff("PUT", upload_url, data=data, retry_on_status_codes=504) >>> response.raise_for_status() ``` > [!WARNING] > When using `requests` it is possible to stream data by passing an iterator to the > `data` argument. On http backoff this is a problem as the iterator is not reset > after a failed call. This issue is mitigated for file objects or any IO streams > by saving the initial position of the cursor (with `data.tell()`) and resetting the > cursor between each call (with `data.seek()`). For arbitrary iterators, http backoff > will fail. If this is a hard constraint for you, please let us know by opening an > issue on [Github](https://github.com/huggingface/huggingface_hub). FrOrGrrrrrrr#)nextrrOrGrrrrrrs r. http_backoffrsAB  #)' 3"7    r-c +H# [SUUUUUUUSS.UD6ShvN gN7f)a Wrapper around httpx to retry calls on an endpoint, with exponential backoff. Endpoint call is retried on exceptions (ex: connection timeout, proxy error,...) and/or on specific status codes (ex: service unavailable). If the call failed more than `max_retries`, the exception is thrown or `raise_for_status` is called on the response object. Re-implement mechanisms from the `backoff` library to avoid adding an external dependencies to `hugging_face_hub`. See https://github.com/litl/backoff. Args: method (`Literal["GET", "OPTIONS", "HEAD", "POST", "PUT", "PATCH", "DELETE"]`): HTTP method to perform. url (`str`): The URL of the resource to fetch. max_retries (`int`, *optional*, defaults to `5`): Maximum number of retries, defaults to 5 (no retries). base_wait_time (`float`, *optional*, defaults to `1`): Duration (in seconds) to wait before retrying the first time. Wait time between retries then grows exponentially, capped by `max_wait_time`. max_wait_time (`float`, *optional*, defaults to `8`): Maximum duration (in seconds) to wait before retrying. retry_on_exceptions (`type[Exception]` or `tuple[type[Exception]]`, *optional*): Define which exceptions must be caught to retry the request. Can be a single type or a tuple of types. By default, retry on `httpx.TimeoutException` and `httpx.NetworkError`. retry_on_status_codes (`int` or `tuple[int]`, *optional*, defaults to `(429, 500, 502, 503, 504)`): Define on which status codes the request must be retried. By default, retries on rate limit (429) and server errors (5xx). **kwargs (`dict`, *optional*): kwargs to pass to `httpx.request`. Example: ``` >>> from huggingface_hub.utils import http_stream_backoff # Same usage as "httpx.stream". >>> with http_stream_backoff("GET", "https://www.google.com") as response: ... for chunk in response.iter_bytes(): ... print(chunk) # If you expect a Gateway Timeout from time to time >>> with http_stream_backoff("PUT", upload_url, data=data, retry_on_status_codes=504) as response: ... response.raise_for_status() ``` When using `httpx` it is possible to stream data by passing an iterator to the `data` argument. On http backoff this is a problem as the iterator is not reset after a failed call. This issue is mitigated for file objects or any IO streams by saving the initial position of the cursor (with `data.tell()`) and resetting the cursor between each call (with `data.seek()`). For arbitrary iterators, http backoff will fail. If this is a hard constraint for you, please let us know by opening an issue on [Github](https://github.com/huggingface/huggingface_hub). TrNr#)rrs r.http_stream_backoffr sAL"  %#/3     s " "endpointcU(aURS5O[RnU[R[R4;a@UR [RU5nUR [RU5nU$)zReplace the default endpoint in a URL by a custom one. This is useful when using a proxy and the Hugging Face Hub returns a URL with the default endpoint. r)rstriprENDPOINT_HF_DEFAULT_ENDPOINT_HF_DEFAULT_STAGING_ENDPOINTreplace)rGrs r.fix_hf_endpoint_in_urlr\sf (0xs#Y5G5GH 66 8^8^__kk)88(Ckk)@@(K Jr- endpoint_namec [U5 UR 5 g![a [RSSS9 N2f=f![ R GanURS-S:XaSnAgURRS5nURRS5nUS :Xa4URS 3S -S URS 3-n[[XP5UeUS:Xa4URS 3S -SURS 3-n[[XP5UeUS:Xa4URS 3S -SURS 3-n[[XP5UeUS:Xa:URS 3S -SURS 3-S-S-n[[XP5UeUS:XdmURS:XaUS:waUR bUR Rbj["R%['UR R55b7URS 3S -SURS 3-S-n[[(XP5UeURS:XaUbSUS3OSn[[*XP5UeURS:Xa8S URSUS 3S URS 3-S!-n[[,XP5UeURS":Xa[/UR5nUbS#UR0S$3nUS%UR2S&3- nUR4b;UR6b.US'UR8S(UR4S)UR6S*3- nOUS - nUS+URS 3- nOS,URS 3n[[,XP5UeURS-:XaZUR RRS.5nUS/US0URRS15S 3n[[,XP5Ue[[,['U5U5UeSnAff=f)2ad Internal version of `response.raise_for_status()` that will refine a potential HTTPError. Raised exception will be an instance of [`~errors.HfHubHTTPError`]. This helper is meant to be the unique method to raise_for_status when making a call to the Hugging Face Hub. 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. > [!WARNING] > 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 found. > - [`~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. zFailed to parse warning headersT)exc_infodNz X-Error-CodeX-Error-MessageRevisionNotFoundz Client Error. zRevision Not Found for url: . EntryNotFoundzEntry Not Found for url: GatedRepoz!Cannot access gated repo for url z$Access to this resource is disabled.z!Cannot access repository for url  RepoNotFoundiz+Invalid credentials in Authorization headerzRepository 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. For more details, see https://huggingface.co/docs/huggingface_hub/authenticationrXz Bad request for z endpoint:z Bad request:iz Forbidden: z Cannot access content at: z2 Make sure your token has the correct permissions.rz0 429 Too Many Requests: you have reached your 'z ' rate limit.z Retry after z secondsz (rz requests remaining in current z s window).z Url: z! 429 Too Many Requests for url: iRangez. Requested range: z. Content-Range: z Content-Range)_warn_on_warning_headersrrMrNraise_for_statusrfHTTPStatusErrorrYr/rIrG_formatrrrrrCREPO_API_REGEXr9r)rrrrArr r!r"r)rVrr error_code error_messagemessager range_headers r.rrisBG * `?!!# G 6 FG  ^?   3 &! + %%)).9  ((,,->? + +!--.n=FKghphthtguuvIwwG/C J ? *!--.n=FKdemeqeqdrrsIttG2GFA M ; &''(7&@EfgogsgsfttuCvv .' )  C '!NN  ,  $$0%%c(*:*:*>*>&?@L''(728<<.BCNN 17E1 L  ! !S (DQD]&}oZ@cu /7=1 D  ! !S (x++,LqI0a@AGH  .'}^?s, AAAP P0NPP cFURRS5nUHnSU;aURSS5OSU4up4UR5nU[;dM=UR5nU(dMV[R U5 [ RU5 M g)a} Emit warnings if warning headers are present in the HTTP response. Expected header format: 'X-HF-Warning: topic; message' Only the first warning for each topic will be shown. Topic is optional and can be empty. Note that several warning headers can be present in a single response. Args: response (`httpx.Response`): The HTTP response to check for warning headers. z X-HF-Warning;rN)r/get_listsplitstrip_WARNED_TOPICSaddrMr)rVserver_warningsserver_warningtopicrs r.rrs&&//?O)9<9N--c15UWYgTh   &mmoGw""5)w'*r- error_typecustom_messagecZ/nURRS5nUbURU5 UR5nURS5nUb8[U[5(aURU5 OURU5 URS5nUb%UHnSU;dM URUS5 M! UV s/sH<n [U 5R5(dM#[U 5R5PM> nn [[ R#U55nSR%U5n Un U (a9U R5UR5;aS U;a U SU -- n OU S U -- n [URR[&S55n U (aS U S 3n O6[URR[(S55n U (aS U S 3n U (aLU R5U R5;a*SU ;aU R+S5nU SUW -XS-n OU W - n U"U R5X*=(d SS 9$![R a9 UR 5 UR5nGNU![a 0nGNef=ff=f![Ra` URRSS5nUR(a/SUR5;aURUR5 GN[f=fs sn f)Nrerrorerrorsrz Content-Typerhtmlrrz (Request ID: )z (Amzn Trace ID: )rVserver_message)r/rIappendjsonrfResponseNotReadread RuntimeErrorrlistextendJSONDecodeErrortextr7r)rdictfromkeysjoinrJrHindex)rrrV server_errors from_headersrrr content_typelinerfinal_error_messagerRrequest_id_message newline_indexs r.rrsM##''(9:L\*$0 ==?D!  %&&$$U+$$U+(#  %!((y)9: 4AV=4CIOODU&SY__&=MV}56MYY}-N)...08L8L8NN ^ # 4.#8 8  6N#: : X%%)),;z-Hz: Nzutf-8ignore)riz ... [truncated]zz-drrr)rOsortedr/itemsr7contentdecodelenrrrGrrr)r)rCpartskvbody flat_partss r.rQrQdsQ  w~~$E w,,./ 779 'A 4A3b%&&0 D"%%gh%? t9t 5Dk]"23D  #!  4dB/011 tW[[! ""EJ   eCFm , 1   eCFm ,  88J r-z%^\s*bytes\s*=\s*(\d*)\s*-\s*(\d*)\s*$original_range resume_sizecU(dSUS3$SU;a[SU<S35e[RU5nU(d[SU<S35eUR 5up4U(dBU(d[SU<S35e[ U5U- nSU3nUS ::a[S U<S35eU$[ U5nX1-nU(a*[ U5nSUSU3nXt:a[S U<S35eU$SUS3$) z: Adjust HTTP Range header to account for resume position. zbytes=-,zMultiple ranges detected - z, not supported yet.zInvalid range format - rzbytes=-rzEmpty new range - )rZ RANGE_REGEXr?rgroupsr+)r r r?startend new_suffix new_range new_starts r._adjust_range_headerrs!  }A&& n6~6HH\]^^   n -E 4^4FaHIIJE !88J!LM MX + j\* ?!3I=BC C JE#I #hYKq. ?!3I=BC C I;a  r-)r0N)N)er(atexitrrosre threadingrrK contextlibr dataclassesrshlexrtypingrrrr r r rfhuggingface_hub.errorsr rrrrrrrrrrr_lfsr_typingr get_loggerr$rMrcompiler8r;r)rArHrJVERBOSErRequestrSrUrr]rgrjrlrmCLIENT_FACTORY_TASYNC_CLIENT_FACTORY_TLockrsrnr*rorpruryr{r}rtregisterhasattrrTimeoutException NetworkErrorrtuplerrrr+rrrrrrrsetrrrrQ IGNORECASErrr#r-r.r0stE  %!EE 7"   H % $))),::mn**%OP8WS#X%688M;R8|$   **  5==TB*u}}** ' 'D ' e&7&7B ,-!"e&7&7"78~~ +A(A7S4S)-&-0'70D0"83I8d8& U\\  *5,, * 9,  2!""}5>C=S=SUZUgUg