+ j^ aRltz0tRt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI H t H t H t ^RIHt^RIHt^RIHt^RIHt^RIHt^RIHtHt^R IHtHt^RIt^R IH t ^R I!H"t"^R I#H$t$H%t%H&t&H't'H(t(H)t)H*t*H+t+H,t,^R I!H-t-^RI.H/t/^RI0H1t1H2t2]-Pf!]44t5]!RR7!RR44t6]Pn!R4t8]Pn!R4t9RRlt:RRlt;Rt]Pn!R]P~R7t@]Pn!R]P~R7tA]Pn!R 4tB]Pn!R!4tC]Pn!R"4tD0RmmtER#R$ltFR%R&ltGR'R(ltH]!R)R*R+7tI]^kR,R-ltJR.R/ltKR0R1ltLR2R3ltMR4R5ltNR6R7ltO] .]P3,tQ] .]P3,tS]P!4tU]NsV]^k]OsW]^kRsX]^kR8R9ltYR:R;ltZR<R=lt[R>R?lt\R@RAlt]]P!]]4]_!]RB4'd]P!]]RC7]P]P]P3td]^kRnte]^kRD^RE^RF^RG]dRH]eRIR*/RJRKlltfRD^RE^RF^RG]dRH]e/RLRMlltg]RD^RE^RF^RG]dRH]e/RNROll4th^tiRPR*/RQRRlltjRSRTltkRURVltlRoRWRXlltm]n!4toRYRZltp]!R[](R\7tqR]R^ltrRpts]sUUu.uF:p]PoR_V R`24Ra3]PoRbV Rc24Rd33FpVNK K< uppttReRfltuRgRhltv]Pn!Ri]P4txRjRkltyR#uuppi)qz>Contains utilities to handle HTTP requests in huggingface_hub.N)Callable GeneratorMapping)contextmanager) ContextVar) dataclasswraps)quote)AnyTypeVar)urljoinurlparse)OfflineModeIsEnabled) constants) BadRequestErrorBucketNotFoundErrorDisabledRepoErrorGatedRepoErrorHfHubHTTPErrorJobNotFoundErrorRemoteEntryNotFoundErrorRepositoryNotFoundErrorRevisionNotFoundError)logging) SliceFileObj) HTTP_METHOD_T CallableTT)frozenc8a]tRt^9toRtRtRtV3RltRtVt R#) RateLimitInfoa 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. Ncr<V^8dQh/S[;R&S[;R&S[;R&S[R,;R&S[R,;R&#) resource_type remainingreset_in_secondsNlimitwindow_secondsstrint)format __classdict__s"\/home/luca/screen-checking/.venv/lib/python3.14/site-packages/huggingface_hub/utils/_http.py __annotate__RateLimitInfo.__annotate__9sMN !" :#$$J%%) __name__ __module__ __qualname____firstlineno____doc__r&r'__annotate_func____static_attributes____classdictcell__)r,s@r-r r 9s E!%N%r0r zL\"(?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+)c`V^8dQhR\\\3,R\R,/#r"headersreturnN)rr)r )r+s"r-r.r.Us(88WS#X%68=4;O8r0c6RpRpVF5pVP4pVR8Xd W,pK$VR8XgK-W,pK7 V'gR#\PV4pV'gR#VPR4p\ VPR44p\ VPR44pRp Rp V'dR\ PV4p V 'd5\ V PR44p \ V PR44p \ VVVV V R 7#) 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-policyr#rtqw)r#r$r%r&r')lower_RATELIMIT_REGEXsearchgroupr*_RATELIMIT_POLICY_REGEXr ) r<r?policykey lower_keymatchr#r$r%r&r' policy_matchs & r-parse_ratelimit_headersrNUs*!IFIIK  # I , ,\F    # #I .E KK0MEKK$%I5;;s+,E!%N .55f=  **3/0E !3!3C!89N #)%  r0c`V^8dQhR\\\3,R\R,/#r;)rr)r*)r+s"r-r.r.s'S 1cDjr0cRpVF"pVP4R8XgKW,pM VfR#VP4pV'gR#VP4'd \V4#R#)aKParse the standard `Retry-After` HTTP header into a number of seconds to wait. The `Retry-After` header can be either a non-negative number of seconds (delay-seconds) or an HTTP-date after which to retry. We handle only the delay-seconds case. See https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Retry-After. Nz retry-after)rDstripisdigitr*)r<valuerJs& r-_parse_retry_afterrTs^E 99;- 'LE   } KKME  }}5z r0z x-request-idzX-Amzn-Trace-Idz x-amz-cf-ida  # staging or production endpoint ^https://[^/]+ ( # on /api/repo_type/repo_id /api/(models|datasets|spaces)/(.+) | # or /repo_id/resolve/revision/... /(.+)/resolve/(.+) ) )flagszz # staging or production endpoint ^https?://[^/]+ # on /api/buckets/... /api/buckets/ z:^https?://[^/]+/api/(?:scheduled-jobs|jobs)/[^/]+/([^/?]+)zA^https?://[^/]+/api/(models|datasets|spaces)/([^/]+)(?:/([^/]+))?z)^https?://[^/]+/api/buckets/([^/]+/[^/]+)cnV^8dQhR\R\\R,\R,3,/#r"urlr=N)r)tuple)r+s"r-r.r.s,35tS4Z1G+Hr0c"\PV4pV'gR#\PP VP ^44pVP ^4VP ^4rCV'dV\ 9d V RV 2pW%3#TpW%3#)aExtract (repo_type, repo_id) from an API URL. Returns canonical repo_type values: "model", "dataset", "space" (or None). Examples: >>> _parse_repo_info_from_url("https://huggingface.co/api/models/user/repo") ("model", "user/repo") >>> _parse_repo_info_from_url("https://huggingface.co/api/datasets/user/repo/resolve/main/data.csv") ("dataset", "user/repo") >>> _parse_repo_info_from_url("https://huggingface.co/api/models/bert-base-cased/resolve/main/config.json") ("model", "bert-base-cased") /NN)_REPO_ID_FROM_URL_REGEXrFrREPO_TYPES_MAPPINGgetrG_REPO_URL_SUBPATHS)rXrL repo_typefirstsecondrepo_ids& r-_parse_repo_info_from_urlres $ * *3 /E ,,00Q@IKKNEKKN6 & 22G1VH%    r0c>V^8dQhR\R\R,/#rWr))r+s"r-r.r.s--3-3:-r0cb\PV4pV'dVP^4#R#)z9Extract bucket_id (namespace/name) from a bucket API URL.N)_BUCKET_ID_FROM_URL_REGEXrFrGrXrLs& r-_parse_bucket_id_from_urlrks' % , ,S 1E"5;;q>,,r0c>V^8dQhR\R\R,/#rWrg)r+s"r-r.r.s---d -r0cb\PV4pV'dVP^4#R#)z>Extract the job_id from a (scheduled) job API URL, if present.N)_JOB_ID_FROM_URL_REGEXrFrGrjs& r-_parse_job_id_from_urlros' " ) )# .E"5;;q>,,r0_IS_DOWNLOAD_CALLF)defaultc0V^8dQhR\R\/#)r"fnr=)r)r+s"r-r.r.siIr0c0a\S4V3Rl4pV#)aDecorator to tag all HTTP calls made by `fn` with the `X-HF-Download-Counter` header. Applied on `hf_hub_download`, `snapshot_download`, etc. so that every call they make through [`get_session`] is flagged as part of a download, no matter how deep in the call stack it happens. c<\PR4pS!V/VB\PV4# \PT4i;i)T)rpsetreset)argskwargstokenrss*, r-_inner%flag_as_download_call.._innersC!%%d+ +t&v&  # #E *  # #E *s 5A r)rsr{sf r-flag_as_download_callr}s" 2Y++ Mr0c<V^8dQhR\PRR/#r"requestr=NhttpxRequest)r+s"r-r.r.s""5=="T"r0c \P!4'd\RVP R24h\P 4'dRVP \P&\VP 9dWVP P \4;'g\\P!44VP \&VP P \4p\PRVVPVPVP P R4RJ4\P 'd \PR\#V44V#)a 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 - Flag the request as part of a download, if applicable - 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.1z%Request %s: %s %s (authenticated: %s) authorizationNzSend: %s)ris_offline_moderrXrpr_r<X_HF_DOWNLOAD_COUNTERX_AMZN_TRACE_ID X_REQUEST_IDr)uuiduuid4loggerdebugmethodHF_DEBUG_curlify)r request_ids& r-hf_request_event_hookrs  """GKK=)J K  ;> 778goo-+2??+>+>|+L+a+aPSTXT^T^T`Pa($$_5J LL/ O,D8  Z'!23 r0c<V^8dQhR\PRR/#rr)r+s"r-r.r.6s**u}}**r0c "\V4#5i)z+ Async version of `hf_request_event_hook`. )r)rs&r-async_hf_request_event_hookr6s ! ))s c<V^8dQhR\PRR/#r"responser=NrResponse)r+s"r-r.r.=s ' ' 'D 'r0c"VPR8dTRVP9dA\VPR,4pTR8dTP 4GRjxL R#R#R#R# \dR#i;iL5i)zContent-lengthNi@B) status_coder<r* ValueErroraread)rlengths& r-async_hf_response_event_hookr=ss" x// / X--.>?@ !nn&&&" 0#   's4#A=A)A=A; A=) A84A=7A88A=c8V^8dQhR\P/#r"r=rClient)r+s"r-r.r.Ks r0cB\P!R\./RRR7#)zI Factory function to create a `httpx.Client` with the default transport. rTN event_hooksfollow_redirectstimeout)rrrr1r0r-default_client_factoryrKs' <<!6 78 r0c8V^8dQhR\P/#rr AsyncClient)r+s"r-r.r.Vse&7&7r0cP\P!R\.R\./RRR7#)zN Factory function to create a `httpx.AsyncClient` with the default transport. rrTNr)rrrrr1r0r-default_async_client_factoryrVs1   !< =zLhKij r0c(V^8dQhR\RR/#)r"client_factoryr=N)CLIENT_FACTORY_T)r+s"r-r.r.js00'70D0r0ct\;_uu_4\4VsRRR4R# +'giR#;i)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_session`] 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_session`] to get a correctly configured `httpx.Client`. N) _CLIENT_LOCK close_session_GLOBAL_CLIENT_FACTORY)rs&r-set_client_factoryrjs  !/ s & 7 c(V^8dQhR\RR/#)r"async_client_factoryr=N)ASYNC_CLIENT_FACTORY_T)r+s"r-r.r.{s 8 83I 8d 8r0c VsR#)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`. > [!WARNING] > 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. N_GLOBAL_ASYNC_CLIENT_FACTORY)rs&r-set_async_client_factoryr{s $8 r0c8V^8dQhR\P/#rr)r+s"r-r.r.s  U\\ r0c\f0\;_uu_4\f \4sRRR4\#\# +'gi\#;i)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)_GLOBAL_CLIENTrrr1r0r- get_sessionrs? \%!7!9 >\ s > A c8V^8dQhR\P/#rr)r+s"r-r.r.s * *5,, *r0c\4#)a Return a `httpx.AsyncClient` object, using the transport factory from the user. Use [`set_async_client_factory`] to customize the `httpx.AsyncClient`. > [!WARNING] > 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. rr1r0r-get_async_sessionrs  ( ))r0cV^8dQhRR/#)r"r=Nr1)r+s"r-r.r.s99t9r0c\pRsVeVP4R#R# \d$p\P RT 24Rp?R#Rp?ii;i)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: )rclose Exceptionrwarning)clientes r-rrsTFN 9 LLN 9 NN3A37 8 8 9s" AA  Aregister_at_fork)after_in_child max_retriesbase_wait_time max_wait_timeretry_on_exceptionsretry_on_status_codesstreamc@V^8dQhR\R\R\R\R\R\\ ,\ \\ ,R3,,R\\ \R3,,R \R \\PR R 3,/ #) r"rrXrrrr.rrr=N) rr)r*floattyperrYboolrrr)r+s"r-r.r.sd8d8 d8 d8 d8  d8  d8i5i#1E+FFd8sCx0d8 d8u~~tT)*d8r0c +aaaaaa"\V\4'dV3p\S\4'dS3o^oTp RoRp RV9dE\VR,\P\ 34'dVR,P 4p S^, oRo\4p V eVR,PV 4RVVVVVV3Rllp V'dGV P!RRSRS/VB;_uu_4p V !V 4'gV xRRR4R#RRR4M+V P!RRSRS/VBp V !V 4'gV xR#Se3\!S4^,p\PR V R S R S R 24M!T p\PRV RS R S R 24\"P$!V4\'WI^,4p EK< +'giL;i Td\p\PRT RS R S 24\T\P4'd \4SS8dThRp?LRp?ii;i5i)zfInternal implementation of HTTP backoff logic shared between `http_backoff` and `http_stream_backoff`.NdatacDV^8dQhR\PR\/#)r"rr=)rrr)r+s"r-r.(_http_backoff_base..__annotate__s   4 r0cn<VPS9dR#\PRVP RS RS 24SS8d\V4R#VPR8Xd9\ VP 4;pe VP ^8XdVPoR#\VP 4;peVoR#)zNHandle response and return True if should retry, False if should return/yield.Fz HTTP Error z thrown while requesting  T) rrrhf_raise_for_statusrNr<r$r%rT) rratelimit_info retry_afterrrnb_triesratelimit_resetrrXs & r- _should_retry)_http_backoff_base.._should_retrys''/DD X-A-A,BB[\b[ccdehdijkk)'1!((C/+B8CSCS+TTa&00A5&4&E&EO&88H8H%IIkV&1Or0rrX'z' thrown while requesting rzRate limited. Waiting zs before retry [Retry r[z].z Retrying in z s [Retry r1) isinstancerr*ioIOBasertellrseekrrrrr ConnectErrorrrtimesleepmin)rrXrrrrrrry sleep_timeio_obj_initial_posrrrerr actual_sleeprrsffd$$$d$, @@r-_http_backoff_basers,%t,,24'--!6 8HJ"&O  Jvf~ <7PQQ#F^002 A 4 "-v##$67  6]]D&DcDVDD(22&ED2ED ">>KKSKFK$X.."N/  & 1A5L NN3L>AWX`Waabcnbooqr s%L NN\,y !K=XZ[ \ < Q7 ;ED#  NNQse#=fXQseL M#u1122+% &  szBI%1GG5G  GIGI#GGBI G GIGH?$AH:5I:H??IcV^8dQhR\R\R\R\R\R\\ ,\ \\ ,R3,,R\\ \R3,,R \P/#) r"rrXrrrr.rr=) rr)r*rrrrYrr)r+s"r-r.r.2sMM M M M  M  Mi5i#1E+FFMsCx0M ^^Mr0c J\\R RVRVRVRVRVRVRVRR /VB4#) 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. Set to `0` to disable 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`, `httpx.NetworkError` and `httpx.RemoteProtocolError`. 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). rrXrrrrrrFr1)nextrrrXrrrrrrys&&$$$$$,r- http_backoffr2spB    $ * ( !4 #8     r0c4V^8dQhR\R\R\R\R\R\\ ,\ \\ ,R3,,R\\ \R3,,R \\PR R 3,/#) r"rrXrrrr.rr=N) rr)r*rrrrYrrr)r+s"r-r.r.sLL L L L  L  Li5i#1E+FFLsCx0Lu~~tT)*Lr0c+X"\R RVRVRVRVRVRVRVRR /VBR jxL R #L5i) 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. Set to `0` to disable 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`, `httpx.NetworkError` and `httpx.RemoteProtocolError`. 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() ``` > [!WARNING] > 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). rrXrrrrrrTNr1)rrs&&$$$$$,r-http_stream_backoffrspF"      &  $  0 4      s *(*retry_on_errorsc\V^8dQhR\R\R\R\P/#)r"rrXrr=)rr)rrr)r+s"r-r.r.s61b1b 1b #1b9=1b ^^1br0c bV'd/MRR RR /p\\4Flp\R RVRV/VBRR/BVBp\V4VP'gVu#\ WP R,4p\W4'gVu#TpKn \P!R\ R V R 24h) aPerform an HTTP request with backoff, following redirects that stay on the Hub. Used to fetch HEAD /resolve on repo or bucket files. Redirects to the same host or another Hub host are followed. Redirects to any other host (CDN, storage bucket) are not: the file metadata is on the redirect response itself and the auth header must not leave the Hub. A backoff mechanism retries the HTTP call on errors (429, 5xx, timeout, network errors). Args: method (`str`): HTTP method, such as 'GET' or 'HEAD'. url (`str`): The URL of the resource to fetch. retry_on_errors (`bool`, *optional*, defaults to `False`): Whether to retry on errors. If False, no retry is performed (fast fallback to local cache). If True, uses default retry behavior (429, 5xx, timeout, network errors). **httpx_kwargs (`dict`, *optional*): Params to pass to `httpx.request`. rrrrXrFLocationz Exceeded z redirects while resolving 'z'.r1) range_MAX_REDIRECTSrrhas_redirect_locationr r<_is_same_or_hub_hostrTooManyRedirects)rrXr httpx_kwargsno_retry_kwargs_rtargets&&$, r-(_httpx_follow_hub_redirects_with_backoffr s2$92?VXZ#[> "    #     H%---O..z:;#C00O'#*  9^,<>@ @ i iKS\SiSiDiir0cJV^8dQhR\R\R,R\/#)r"rXendpointNr=rg)r+s"r-r.r.s%   sTz c r0c"V'dVPR4M\PpV\P\P39dAVP \PV4pVP \PV4pV#)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)rXrs&&r-fix_hf_endpoint_in_urlrsf (0xs#Y5G5GH 66 8^8^__kk)88(Ckk)@@(K Jr0cVV^8dQhR\PR\R,RR/#)r"r endpoint_nameNr=)rrr))r+s"r-r.r.s/j?j?%..j?tj?W[j?r0c * \V4VP 4R# \d\PRRR7L7i;i \ P Ed5pTP^d,^8XdRp?R#TPPR4pTPPR4pTPe8TPPe \TPP4MRpT'd \T4MR:wrgTR8Xd?TP R2R ,R TP R 2,p\\YYgR 7ThTR 8Xd?TP R2R ,RTP R 2,p\\ YYgR 7ThTR8Xd?TP R2R ,RTP R 2,p\\"YYgR 7ThTR8XdKTP R2R ,RTP R 2,R,R,p\\$Y4ThTR8XdqTem\&P)T4eVTP R2R ,RTP R 2,R,R,p\\*Y\-T4R7ThTPR8XdYTeU\/T4;p eFTP R2R ,RTP R 2,R,p\\0YT R7ThTR8Xg4TPR8XdoTR8wdhTed\2P)T4eMTP R2R ,RTP R 2,R ,R!,p\\4YYgR 7ThTPR"8XdTeR#T R$2MR%p\\6Y4ThTPR&8XdAR TP R'T R 2R(TP R 2,R),p\\8Y4ThTPR*8Xd\;TP4p T eT P<^8XdR+T P> R,2pTR-T P@ R.2, pT PBeAT PDe3TR/T P< R0T PB R1T PD R22, pM TR , pTR3TP R 2, pMR4TP R 2p\\8Y4ThTPR58Xd[TPPPR64p T R7T R8TPPR94 R 2p\\8Y4Th\\8\T4T4ThRp?ii;i);ad 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_infoNz X-Error-CodeX-Error-MessageRevisionNotFoundz Client Error. zRevision Not Found for url: .)rard 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  RepoNotFoundzBucket Not Found for url: zG Please make sure you specified the correct bucket id (namespace/name).zg If the bucket is private, make sure you are authenticated and your token has the required permissions.) bucket_idizJob Not Found for url: zA Please make sure you specified the correct job ID and namespace.)job_idiz+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 and your token has the required permissions.zQ For more details, see https://huggingface.co/docs/huggingface_hub/authenticationrz 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 seconds (r[z requests remaining in current z s window).z Url: z! 429 Too Many Requests for url: iRangez. Requested range: z. Content-Range: z Content-Ranger\)#_warn_on_warning_headersrrrraise_for_statusrHTTPStatusErrorrr<r_rrXr)re_formatrrrrBUCKET_API_REGEXrFrrkrorREPO_API_REGEXrrrrNr$r#r%r&r') rrr error_code error_message request_urlrardmessager*r range_headers && r-rrsBG * C?!!# G 6 FG  A?   3 &! + %%)).9  ((,,->? *2)9)9)E(JZJZJ^J^JjC  $$ %pt HS6{CXd + +!--.n=FKghphthtguuvIwwG/iiop p ? *!--.n=FKdemeqeqdrrsIttG2GQZlrs s ; &''(7&@EfgogsgsfttuCvv .'ybhi i D D''(75hll^1EF9 9 +W?Q F . (' '' 4@''(7.x||nA>?]]} } #WB[\gBh   C ''1+>>K''(7+HLL>;<WW  *GfMST T > )  C '!NN'%%k2>''(728<<.BC`` g g 17PYkqr r  ! !S (DQD]&}oZ@cu /7=1 D  ! !S (x++,LqI0a@AGH  .'CA?s4 A"AAVV 8L>!N8>N8,L; L%"L>% L72L;3L>6L77L;;L>>AN50N54N5z("z"\s*:\s*")[^"]*(")z\1\2z(^|&)(z=)[^&]*z\1\2c0V^8dQhR\R\/#)r"bodyr=rg)r+s"r-r.r.\sr0cF\FwrVPW 4pK V#)zRRedact OAuth credential values from a JSON or form-urlencoded request body string.)_SENSITIVE_BODY_PATTERNSsub)rlpattern replacements& r-_redact_sensitive_bodyrr\s" 8{{;-!9 Kr0cDV^8dQhR\PR\/#)r"rr=)rrr))r+s"r-r.r.cs' ' emm' ' r0cRRVP3.p\VPP44F-wr#VP 4R8XdRpVRV RV 23., pK/ RpVP eEVP P RRR 7p\V4R 8d VR , R 2p\V4pTeTRTPRR43., pTRTP3., p.pTF]wr#T'd$TP\\T444T'gK:TP\\T444K_ RP!T4# \PdR pLi;i)zConvert a `httpx.Request` into a curl command (str). Used for debug purposes only. Implementation vendored from https://github.com/ofw/curlify/blob/master/curlify.py. MIT License Copyright (c) 2016 Egor. Nz-Xrzz-HrKzutf-8ignore)rLi:NiNz ... [truncated]zz-dr'rr)curlN)rsortedr<r^rDcontentdecodelenrrrRequestNotReadrrXrPr r)r[)rpartsrirjrl flat_partss& r-rrcsl  w~~$E w,,./ 779 'A 4A3b%&&0 D" ?? &??))'()CD4y4u+&67)$/D  4dB/011 tW[[! ""EJ   eCFm , 1   eCFm ,  88J    "!"s(AE&&F?Fz%^\s*bytes\s*=\s*(\d*)\s*-\s*(\d*)\s*$cXV^8dQhR\R,R\R\R,/#)r"original_rangeN resume_sizer=r()r+s"r-r.r.s*"!"!t"!#"!#PT*"!r0cV'gRV R2#RV9d\RV: R24h\PV4pV'g\RV: R24hVP 4wr4V'gIV'g\RV: R24h\ V4V, pRV 2pV^8:d\R V: R24hV#\ V4pW1,pV'd,\ V4pRV RV 2pWt8d\R V: R24hV#RV R2#) z: Adjust HTTP Range header to account for resume position. zbytes=-,zMultiple ranges detected - z, not supported yet.zInvalid range format - r$zbytes=-zEmpty new range - )r RANGE_REGEXrLrTgroupsr*)rrrLstartend 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  r0cV^8dQh/^\9d\\,;R&^\9d \;R&^\9d \;R&^\9d\ P R,;R&^\9d"\\\,R3,;R&^\9d\\R3,;R&#) r"rprrNr._DEFAULT_RETRY_ON_EXCEPTIONS_DEFAULT_RETRY_ON_STATUS_CODES) __conditional_annotations__rrrrrrrYrrr*)r+s"r-r.r.sDD\UT:d#T]En BA(Ao Ep TS4Sq Er +* t#*s Ej eDOS$89k Et QPc3hPu Er0> rawblobrefstreecommitresolverevisionsettings discussions)iriiii)N) subject_token access_token refresh_token client_secret device_code){rr6atexitrrQosre threadingrrcollections.abcrrr contextlibr contextvarsr dataclassesr functoolsr shlexr typingr r urllib.parser rrhuggingface_hub.errorsrrrrLrrrrrrrrrr_lfsr_typingrr get_loggerr2rr compilerErHrNrTrrr\VERBOSEr2r1rnr]rir`rerkrorpr}rrrrrrrrrLockrrrrrrrrrregisterhasattrrTimeoutException NetworkErrorRemoteProtocolErrorrrrrrrr rrrrvr=r-rBr0_SENSITIVE_BODY_KEYSrnrrr IGNORECASErrr.)rJrprs00@r-rs E  88%"!* 7   -   H % $&&&,::mn**%OP8v6 #   ** :: **$ab**%ijJJ'STq2- - '11De&TT$"J* 'B ,-!"e&7&7"78~~ +AA7SS&**0" 8  *9,  2!""}5   = 3QPd8 d8  d8  d8Jfd84Rd8d8NM M  M  MJfM4RM`L L  L  LJfL4RLL^1b@E1bhj j?Z(0-^DfTj$# r#01 24EF vcU'* +->?  #' VjjA2==Q "!sAM5