+ jkaR(t+0tRt^RIt^RIt^RIHtHt^RIHtH t H t ^RI H t ^RI HtHt^RIHt] P$P'4UUu/uFwrWbK uppt]^k]P*!R4t]!] P$P144t]^k]!0R)m4t]^k]!RR 04t]^k]!R R 7!R R 44t]!R R 7!RR44tRRlt]P>R*RRll4t RRlt!RRlt"R*RRllt#RRlt$R*RRllt%RRlt&R R!lt'R"R#lt(R$R%lt)R&R'lt*R#uuppi)+aCentralized parser for Hugging Face Hub URIs ('hf://...') and mount specifications. A HF URI is a URI-like string that identifies a location on the Hugging Face Hub: a model/dataset/space/kernel repository, a bucket, optionally a revision, and optionally a path inside the repo or bucket. Canonical syntax: ``` hf://[/][@][/] ``` For convenience, [`parse_hf_uri`] also accepts Hugging Face **web URLs** (the ones you copy-paste from your browser), e.g. 'https://huggingface.co/datasets/my-org/my-dataset/blob/main/train.csv'. They are normalized to the canonical 'hf://' form before parsing. Only unambiguous URLs (repository / bucket pages and file/folder viewer routes) are accepted; any other route is rejected rather than guessed. A HF mount wraps a HF URI with a local mount path and an optional ':ro'/':rw' flag (used by Spaces and Jobs volumes): ``` hf://[/][@][/]:[:ro|:rw] ``` See 'docs/source/en/package_reference/hf_uris.md' for the full grammar and examples. N) dataclassfield)quoteunquoteurlsplit) constants) HfUriErrorHFValidationError)validate_repo_idz ^refs/(?:convert/[\w.-]+|pr/\d+)resolvetreeT)frozenca]tRt^NtoRtRtRt]!RRRRR7tV3RlRlt ] V3RlR l4t ] V3R lR l4t V3R lR lt RV3RlRlltV3RltRtVtR#)HfUriaParsed representation of a Hugging Face Hub URI ('hf://...'). Attributes: type (`str`): One of 'model', 'dataset', 'space', 'kernel' or 'bucket'. id (`str`): The repository id ('namespace/name', e.g. 'my-org/my-model') for repo URIs, or the bucket id ('namespace/name') for bucket URIs. revision (`str`, *optional*): The revision specified after '@' in the URI, URL-decoded. 'None' if no revision was specified, or for bucket URIs (which never carry a revision). Special refs like 'refs/pr/10' and 'refs/convert/parquet' are preserved as-is. path_in_repo (`str`): The path inside the repo or bucket. Empty string if the URI points at the root. NFreprhashcomparedefaultc<V^8dQhRR/#returnN)format __classdict__s"_/home/luca/screen-checking/.venv/lib/python3.14/site-packages/huggingface_hub/utils/_hf_uris.py __annotate__HfUri.__annotate__dsttttc bVP;'gRpVP\9d,\VRVP R\ \4 R2R7hVP 'd!VP P R4^8wd\VRVP R2R7hVPR8wd\VP 4VPe VP'g\VR R7hVPR8XdVPe\VR R7hVP'dPVPPR4'gR VP9d\VR VP R2R7hR #R # \dp\T\T4R7ThR p?ii;i)rzInvalid type 'z'. Must be one of .urimsg/z"Id must be 'namespace/name', got ''.bucketNz%Revision must not be an empty string.z&Bucket URIs do not support a revision.//z+Path must not contain empty segments (got 'z').) _rawtype_VALID_URI_TYPESrsortedidcountr r strrevision path_in_repo startswith)selfr$es& r __post_init__HfUri.__post_init__dsiiioo2 99, ,N499+EWX^_oXpWqqr*st twww$''--,1,NtwwiWY*Z[ [ 99  = ) == $T]]]*QR R 99 T]]%>*RS S      ++C00DDs&ris_repo HfUri.is_reporAr c <V^8dQhRS[/#r9r0)rrs"rrrsr c \P\VP,RVP.pVP eQVP pRV9d*\ PV4fVPRR4pVPRV 24VP'dVPRVP 24RPV4#)zRender the URI as a canonical 'hf://' string. The type prefix is always written explicitly (e.g. 'hf://models/my-org/my-model'). r&%2F@r) r HF_PROTOCOL_TYPE_TO_PREFIXr+r.r1_SPECIAL_REFS_REVISION_REGEX fullmatchreplaceappendr2join)r4partsr1s& rto_uri HfUri.to_uris &11?4993MsTXT[T[\ == $}}Hh#?#I#I(#S#[#++C7 LL1XJ (     LL1T../0 1wwu~r c4<V^8dQhRS[R,RS[/#rendpointNrrG)rrs"rrrs00sTz0S0r c vT;'g\PPR4p\VPRR7pVP R8Xd(V RVP 2pV'd VRV 2, pV#VP R8XdV RVP 2M(V R\VP , RVP 2pVPpVe%\PV4f\VRR7pV'd*TRT;'g\P RV 2, pV#Ve VRV 2, pV#) ayRender the URI as a Hugging Face **web URL** (the kind you open in a browser). This is the inverse of parsing a URL with [`parse_hf_uri`]. The returned URL points at: - the repository / bucket landing page when no path or revision is set; - the folder viewer ('/tree/') when only a revision is set; - the file viewer ('/blob//') for repository files (revision defaults to 'main'); - the tree route ('/tree/') for bucket files (buckets are not versioned). Args: endpoint (`str`, *optional*): Base endpoint to use. Defaults to 'constants.ENDPOINT' (i.e. 'https://huggingface.co'). Returns: `str`: the web URL. Example: ```py >>> from huggingface_hub import parse_hf_uri >>> parse_hf_uri("hf://datasets/my-org/my-dataset@v1/train.csv").to_url() 'https://huggingface.co/datasets/my-org/my-dataset/blob/v1/train.csv' ``` r&)safer(z /buckets/z/tree/modelrz/blob/) rENDPOINTrstriprr2r+r.rLr1rMrNDEFAULT_REVISION)r4rWbasepathurlr1s&& rto_url HfUri.to_urls40..I..66s;T&&S1 99 F)DGG9-Cv&J&*YY'%9ay!$qY]YbYbIcHddefjfmfmen?o==  $@$J$J8$T$\XB/H  VHBB (B(BC1TFK KC  ! VH:& &C r c<V^8dQh/S[P;R&S[;R&S[R,;R&S[;R&S[R,;R&#)rr+r.Nr1r2r*)r HfUriTyper0)rrs"rrrNsS   !" G#$Dj%&'( *Q)r rN)__name__ __module__ __qualname____firstlineno____doc__r1r2rr*r6propertyr?rDrSra__annotate_func____static_attributes____classdictcell__rs@rrrNsv   HL%eUDQDtt6%%%%$00[r rcpa]tRt^toRtRt]!RRRRR7tV3RlRltV3RlRlt V3R lt R t Vt R#) HfMountaA HF URI paired with a local mount path and optional read-only flag. Used by Spaces and Jobs to describe volume mounts. The full syntax is: ``` hf://[/][@][/]:[:ro|:rw] ``` Attributes: source ([`HfUri`]): The parsed HF URI identifying the Hub resource to mount. mount_path (`str`): The local mount path (always starts with '/'). read_only (`bool`, *optional*): True if the mount ends with ':ro', False if it ends with ':rw', 'None' if no flag was provided. NFrc<V^8dQhRR/#rr)rrs"rrHfMount.__annotate__str cVP;'gRpVPPR4'dVPR8Xd\VRVP R2R7hR#)rr&zEMount path must be a non-empty absolute path starting with '/', got 'r'r#N)r* mount_pathr3r)r4raws& rr6HfMount.__post_init__s\iioo2))#..$//S2H[\`\k\k[llno 3Ir c <V^8dQhRS[/#r9rG)rrs"rrrssr c VPP4RVP.pVPe&TP VP'dRMR4RP V4#)zaRender the mount as a canonical 'hf://' string. Example: 'hf://models/my-org/my-model:/data:ro' ::ro:rwr)sourcerSru read_onlyrPrQ)r4rRs& rrSHfMount.to_urisO ##%sDOO< >> % LL$...e <wwu~r cf<V^8dQh/S[;R&S[;R&S[R,;R&S[R,;R&#)rr}ruNr~r*)rr0r;)rrs"rrrss?& M'(O)*d{!+, *Q-r r) rfrgrhrirjr~rr*r6rSrlrmrnros@rrqrqs=&"I%eUDQDAr rqc0V^8dQhR\R\/#)rr$rr0r;)rs"rrrs34r cB\V4R# \dR#i;i)zVCheck if a string is a valid HF URI ('hf://...') or a recognized Hugging Face web URL.TF) parse_hf_urir)r$s&r is_hf_urirs$S s  cJV^8dQhR\R\R,R\/#rr$rWNr)r0r)rs"rrrs%<6<6c<6S4Z<65<6r cTpVP\P4'dDV\\P4RpV'g\ VR\P R24hMN\ WR7'd\ WR7pM/\ VR\P R\P R24h\W2R7wrEVR 8Xd\WTVR7#\WTVR7#) a7Parse a Hugging Face Hub URI ('hf://...') or a Hugging Face web URL. A HF URI is a URI-like string identifying a location on the Hugging Face Hub. The full grammar is: ``` hf://[/][@][/] ``` For convenience, Hugging Face **web URLs** (the ones you copy-paste from the website) are also accepted and normalized to the canonical 'hf://' form, e.g. 'https://huggingface.co/datasets/my-org/my-dataset/blob/main/train.csv'. Only unambiguous URLs (repository / bucket pages and file/folder viewer routes) are accepted; any other route is rejected. See 'docs/source/en/package_reference/hf_uris.md' for the full specification. Args: uri (`str`): The URI to parse. Must start with 'hf://', or be a Hugging Face URL (e.g. 'https://huggingface.co/...'). endpoint (`str`, *optional*): A custom Hub endpoint (e.g. a self-hosted or proxied Hub like 'https://hub.my-company.com' or 'http://localhost:8080/hf'). When provided, web URLs on that endpoint are recognized in addition to the default Hugging Face hosts. Has no effect on 'hf://' URIs. Returns: [`HfUri`]: the parsed URI. Raises: [`HfUriError`]: If the URI is malformed (missing prefix, invalid type, missing id, unsupported URL route, etc.). Examples: ```py >>> from huggingface_hub.utils import parse_hf_uri >>> parse_hf_uri("hf://my-org/my-model") HfUri(type='model', id='my-org/my-model', revision=None, path_in_repo='') >>> parse_hf_uri("hf://datasets/my-org/my-dataset@refs/pr/3/train.json") HfUri(type='dataset', id='my-org/my-dataset', revision='refs/pr/3', path_in_repo='train.json') >>> parse_hf_uri("https://huggingface.co/datasets/my-org/my-dataset/blob/main/train.csv") HfUri(type='dataset', id='my-org/my-dataset', revision='main', path_in_repo='train.csv') ``` NEmpty body after 'r')rWMust start with 'zQ' or be a Hugging Face URL (e.g. 'https://huggingface.co/...'). Expected format: z#[/][@][/]rvr() r3rrKlenr_looks_like_hf_url_url_to_uri_body _split_type_parse_bucket_body_parse_repo_body)r$rWrvbodytype_locations&& rrrsV C ~~i++,,3y,,-/0S$6y7L7L6MR"PQ Q C 3 37  5 567 ) 5 566Y [  "$0OE !(s;; H 55r cnV^8dQhR\R,R\\R,\3,/#rV)r0tuple)rs"rrrBs+ ( (cDj (U3:s?5K (r cVfR#\RV9dTMRV,4pVP'dVPP4MRpW!PP R43#)aReturn the lowercased host and stripped path prefix of a custom Hub 'endpoint'. E.g. 'https://hub.my-company.com' -> ('hub.my-company.com', '') and a self-hosted 'http://localhost:8080/hf' -> ('localhost', 'hf'). Returns '(None, "")' when 'endpoint' is None. N://r)r&)Nr)rhostnamelowerr_strip)rWparsedhosts& r_endpoint_host_and_pathrBsZ  %8"3h IF&,ooo6?? "4D ""3' ''r cTV^8dQhR\R,R\\,/#rV)r0 frozenset)rs"rrrPs&OOd Oy~Or c|\V4wrV'd\PV0,#\P#)z^The set of hosts whose web URLs can be parsed: the default Hugging Face hosts plus 'endpoint'.)rr HF_URL_HOSTS)rWr_s& r_recognized_hostsrPs.%h/GD.29 ! !TF *N 8N8NNr cJV^8dQhR\R\R,R\/#rr)rs"rrrVs*jjCj3:jjr caVP4oSPR4'dR#\;QJd(V3Rl\V44F 'gK R# R#!V3Rl\V444#)zNReturn True if 'uri' looks like a (possibly scheme-less) Hugging Face web URL.Tc3n<"TF*pSV8H;'gSPVR,4xK, R#5i)r&N)r3).0rlowereds& r %_looks_like_hf_url..\s1iMhTw$@@'"4"4TCZ"@@Mhs5!5F)zhttp://zhttps://)rr3anyr)r$rWrs&&@rrrVsZiikG122 3iM^_gMhi33i3i3iM^_gMhi iir c0V^8dQhR\R\/#)rsegmentrrG)rs"rrr_s00c0c0r c8\V4PRR4#)agPercent-decode a single URL path segment (e.g. 'file%20name.txt' -> 'file name.txt'). A decoded '/' is re-encoded as '%2F' so the segment stays atomic when the normalized body is re-split by the shared parser. This decodes ordinary path characters (spaces, '#', ...) that browsers encode, while keeping '%2F'-encoded revisions (e.g. 'feature%2Ffoo') intact. r&rI)rrO)rs&r_decode_url_path_segmentr_s 7  # #C //r cJV^8dQhR\R\R,R\/#)rr`rWNrrG)rs"rrris*O*O*#O*tO*sO*r cTp\RV9dTMRV,4pVP;'gRP4pV\V49d\ TRT;'gT R2R7hVP p\ V4wrgV'dBWF8Xd<RV,pWX8XgVPVR,4'dV\V4RpVPR4U u.uFq'gK V NK p p V 'g\ VR V R 2R7hRp V ^,\P9dV ^,p V R ,p \V 4^8d\ VR V R 2R7hV ^, RV ^, 2p V R,p V R8Xd]V 'gRV 2#V vrV\9d\ VRV RV R2R7hRPRV44pV'd RV RV 2#RV 2#V 'dV R2MRpV 'gV V 2#V vrV\9d\ VR V RV R2R7hV'gV V 2#RPRV44pV V RV 2#uup i)aNormalize a Hugging Face web URL into the body of a 'hf://' URI (everything after 'hf://'). The returned string is fed back into the regular URI parsing logic, so all validation (repo id, revision, empty path segments, ...) is shared with the canonical 'hf://' path. Only unambiguous URLs are accepted: any unrecognized route raises [`HfUriError`]. When 'endpoint' is provided, URLs on that custom Hub host are recognized too (and its path prefix is stripped). rr)rzUnrecognized host 'zC'. Expected a Hugging Face URL (e.g. 'https://huggingface.co/...').r#r&Nz0Missing repository or bucket identifier in URL 'r':NNzCannot parse URL 'z{': expected a '/' repository or bucket. User/organization pages and single-segment URLs are not supported.:rNNbucketszbuckets/zCannot parse bucket URL 'z': unsupported '/z /' route.c38"TFp\V4xK R#5irerrrs& rr#_url_to_uri_body..sNg099zl/' route. Only repository pages and file/folder viewer routes (blob, resolve, raw, tree, ...) can be parsed.c38"TFp\V4xK R#5irerrs& rrrsMW/88rrJ)rrrrrr_rr3rsplitrHF_URI_TYPE_PREFIXES_URL_BUCKET_LOCATION_ACTIONSrQ_URL_REPO_LOCATION_ACTIONS)r`rWrvrrr_ endpoint_host endpoint_pathprefixrsegments type_prefixrepo_idrestactiontaildecodeds&& rrris C Uc\ctcz :F OO ! !r ( ( *D $X..%dkkc]2uv  ;;D$;8#D M.}$ >T__Vc\::F &D'+zz#BG'HB S(XY\X]]_&`aa#K{i444qk B< 8}q$SE*UU  ! Qx{m,G B[:ro|:rw]'). A mount specification is a HF URI followed by a local mount path and an optional read-only/read-write flag. The full grammar is: ``` hf://[/][@][/]:[:ro|:rw] ``` See 'docs/source/en/package_reference/hf_uris.md' for the full specification. Args: mount_str (`str`): The mount string to parse. Must start with 'hf://' and contain a ':' segment. Returns: [`HfMount`]: the parsed mount. Raises: [`HfUriError`]: If the mount string is malformed (missing mount path, invalid URI, etc.). Examples: ```py >>> from huggingface_hub.utils import parse_hf_mount >>> parse_hf_mount("hf://my-org/my-model:/data:ro") HfMount(source=HfUri(type='model', id='my-org/my-model', revision=None, path_in_repo=''), mount_path='/data', read_only=True) >>> parse_hf_mount("hf://buckets/my-org/my-bucket/sub/dir:/mnt:rw") HfMount(source=HfUri(type='bucket', id='my-org/my-bucket', revision=None, path_in_repo='sub/dir'), mount_path='/mnt', read_only=False) ``` rr'r#NrrzKMissing mount path. Expected ':' (e.g. 'hf://org/model:/data').)r}rur~r*) r3rrKrr _split_mountrr%rq) rrvrrrur~uri_strr}r5s & rparse_hf_mountrs@    5 5 6 6#I$9$9#:"=  C S../1 2D S(:9;P;P:QQS&TUU&24&A#H)S&stt##h.G4g& &9 WW 4See,!34s C D%C<<Dc V^8dQhR\R\R\\\R,\R,3,/#)rrrvrN)r0rr;)rs"rrrs5++s+C+E#sTz4$;2N,O+r c\VPR4'dRVPR4rM,VPR4'dRVPR4rMRpVPR4pVR 8XdVe\VRR7hVRR3#VRVpW^,RpV'g\VR R7hWEV3#) zSplit the ':[:ro|:rw]' suffix from 'body'. Returns '(location, mount_path, read_only)' where 'mount_path' is 'None' if no mount segment is present. r{Tr|FNz:/zb':ro'/':rw' suffix is only valid when a mount path is provided (e.g. 'hf://...:/:ro').r#z#Missing location before mount path.)endswith removesuffixrfindr)rrvr~idxrrus&$ rrrs  }}U 1 1% 84 u  !2!25!94  **T C by  x T4DSzHAgiJ S&KLL  **r crV^8dQhR\R\R\\P\3,/#)rrrvr)r0rrrd)rs"rrrs1#suY5H5H#5M/Nr c VPR4pVR 8XdxV\P9d%\VRV R\P V R2R7h\ P V4;pe"\VR\P V R2R7hR V3#VRVpW^,RpV\P9d\PV,V3#\ P V4;pe\VR V R V R 2R7hR V3#)zDetect the (optional) type prefix and return '(type, remaining_location)'. A missing type prefix defaults to 'model'. Singular forms ('model/', 'dataset/', etc.) are explicitly rejected with a helpful error. r&zMissing identifier after 'z '. Expected 'z/'.r#Nz*Type prefix must be plural. Did you mean 'z/...'?rZz!Type prefix must be plural, got 'z/'. Did you mean 'z/'?r)findrrrrKrLget)rrv slash_idxsingular_pluralfirstrs&$ rrrs-  c"IB y55 50 - H]H]G^_g^hhop  /228< [@][/]'.r&zMissing repository id.r#rJNz-Repository id must be 'namespace/name', got 'z'. rz!Missing repository id before '@'.r'zEmpty revision after '@'.rr) rrrr/rrrMmatchgroup removeprefixrr) rrrvat_idxr1rRrr2 rev_and_pathrrs &&$ rrrJs~~c"H S&>?? ]]3 F|x(..s3a7sA& u:>,YZbYccf*gh h1XJaaz*#&u:>uQxr 7F# - *MN N ==  ",YZaYbbd*ef f-22<@  {{}H'H 8EEcJL$))#.IB'! ' 3+MO< 8$*EF F   !   r cV^8dQh/^\9d\\\3,;R&^\9d\\,;R&^\9d\\,;R&^\9d\\,;R&#)rrLr,rr)__conditional_annotations__dictr0r)rs"rrrstT\[c3h[UhVU)C.UitdcIcNcuzNMinM{r >rvblobr blamer re),rrj functoolsre dataclassesrr urllib.parserrrhuggingface_hubrhuggingface_hub.errorsrr _validatorsr ritemsrLcompilerMrvaluesr,rrrrqr lru_cacherrrrrrrrrrrr)kvrs00@rrsJ: (11%@) 5>4R4R4X4X4Z"[4ZDA144Z"[[ "zz*MN$-Y-K-K-R-R-T#UU .77b-cc09)V9L/MM $|||~ $'''T <6<6~ (O j0O*d7Xt+<>08e#\s E