3j c 4%SrSSKrSSKrSSKJrJr SSKJrJrJ r SSK J r SSK J r Jr SSKJr \ R"R%5VVs0sHupX_M snnr\\\4\S '\R."S 5r\"\ R"R555r\\\S '\"1S k5r\\\S '\"SS15r\\\S'\"SS9"SS55r\"SS9"SS55rS\S\ 4Sjr!\RDS\S\4Sj5r#S\S\ 4Sjr$S\S\4Sjr%S\S\4Sjr&S \S\4S!jr'S"\S#\S\(\\S-\ S-44S$jr)S%\S#\S\(\ RT\44S&jr+S%\S'\ RTS#\S\4S(jr,S%\S'\ RTS#\S\4S)jr-gs snnf)*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_id_TYPE_TO_PREFIXz ^refs/(?:convert/[\w.-]+|pr/\d+)_VALID_URI_TYPES>rawblobtreeblameresolve_URL_REPO_LOCATION_ACTIONSrr_URL_BUCKET_LOCATION_ACTIONST)frozenc\rSrSr%Sr\R \S'\\S'Sr \S-\S'Sr \\S'\ "S S S SS 9r \S-\S 'SS jr \S \4Sj5r\S \4Sj5rS \4SjrSS\S-S \4SjjrSrg)HfUriNaParsed 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. typeidNrevision path_in_repoFreprhashcomparedefault_rawreturnc  UR=(d SnUR[;a([USURS[ [5S3S9eUR (aUR R S5S:wa[USUR S 3S9eURS :wa[UR 5 URbUR(d [US S9eURS :XaURb [US S9eUR(aIURRS5(dS UR;a[USURS3S9egg![an[U[U5S9UeSnAff=f)NrzInvalid type 'z'. Must be one of .urimsg/r z"Id must be 'namespace/name', got ''.bucketz%Revision must not be an empty string.z&Bucket URIs do not support a revision.//z+Path must not contain empty segments (got 'z').) r$rrr sortedrcountr r strrr startswith)selfr)es X/home/wildlama/miniconda3/lib/python3.13/site-packages/huggingface_hub/utils/_hf_uris.py __post_init__HfUri.__post_init__ds`iio2 99, ,N499+EWX^_oXpWqqr*st tww$''--,1,NtwwiWY*Z[ [ 99  = ) == $T]]*QR R 99 T]]%>*RS S     ++C00DDc[R[URSUR/nUR bNUR nSU;a([ RU5cURSS5nURSU35 UR(aURSUR35 SRU5$)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_PROTOCOLr rrr_SPECIAL_REFS_REVISION_REGEX fullmatchreplaceappendrjoin)r3partsrs r5to_uri HfUri.to_uris &11?4993MsTXT[T[\ == $}}Hh#?#I#I(#S#[#++C7 LL1XJ (    LL1T../0 1wwu~r>endpointcTU=(d [RRS5n[URSS9nUR S:Xa"USUR 3nU(aUSU3- nU$UR S:XaUSUR 3O$US[UR SUR 3nURnUb.SU;a([RU5cURSS5nU(a$USU=(d [RSU3- nU$UbUSU3- nU$) 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/modelrCz/blob/) rENDPOINTrstriprrrrr rrFrGrHDEFAULT_REVISION)r3rNbasepathurlrs r5to_url HfUri.to_urls;0.I..66s;T&&S1 99 F)DGG9-Cv&J&*YY'%9ay!$qY]YbYbIcHddefjfmfmen?o==  C8O8T8^8^_g8h8p''U3H  VHB (B(BC1TFK KC  ! VH:& &C r>r%NN)__name__ __module__ __qualname____firstlineno____doc__r HfUriType__annotations__r1rrrr$r6propertyboolr;r@rLrX__static_attributes__rZr>r5rrNs     GHcDjL#%eUDQD#*Qt6%4%%%%%$.sTz.S..r>rc|\rSrSr%Sr\\S'\\S'Sr\ S-\S'\ "SSSSS9r \S-\S 'SS jr S \4S jr S rg)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. source mount_pathN read_onlyFrr$r%cUR=(d SnURRS5(aURS:Xa[USURS3S9eg)Nrr+zEMount path must be a non-empty absolute path starting with '/', got 'r,r()r$rkr2r )r3rs r5r6HfMount.__post_init__sZiio2))#..$//S2H[\`\k\k[llno 3Ir>cURR5SUR/nURb$UR UR(aSOS5 SR U5$)zaRender the mount as a canonical 'hf://' string. Example: 'hf://models/my-org/my-model:/data:ro' ::ro:rwr)rjrLrkrlrIrJ)r3rKs r5rLHfMount.to_urisM ##%sDOO< >> % LL$..e <wwu~r>rZr[)r]r^r_r`rarrcr1rlrerr$r6rLrfrZr>r5rhrhsK" MO!Itd{!%eUDQD#*Qr>rhr)r%c<[U5 g![a gf=f)zVCheck if a string is a valid HF URI ('hf://...') or a recognized Hugging Face web URL.TF) parse_hf_urir )r)s r5 is_hf_urirvs$S s  cUnUR[R5(aBU[[R5SnU(d[ US[RS35eOK[ U5(a [ U5nO/[ US[RS[RS35e[X!S9up4US:Xa [XCUS9$[XCUS9$) aParse 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/...'). 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,Must start with 'zQ' or be a Hugging Face URL (e.g. 'https://huggingface.co/...'). Expected format: z#[/][@][/]rr-) r2rrElenr _looks_like_hf_url_url_to_uri_body _split_type_parse_bucket_body_parse_repo_body)r)rbodytype_locations r5rurusN C ~~i++,,3y,,-/0S$6y7L7L6MR"PQ Q C $  5 567 ) 5 566Y [  "$0OE !(s;; H 55r>c^UR5mTRS5(ag[U4Sj[R55$)zNReturn True if 'uri' looks like a (possibly scheme-less) Hugging Face web URL.)zhttp://zhttps://Tc3d># UH%nTU:H=(d TRUS-5v M' g7f)r+N)r2).0hostlowereds r5 %_looks_like_hf_url..Bs.dMcTw$@'"4"4TCZ"@@Mcs-0)lowerr2anyr HF_URL_HOSTS)r)rs @r5r|r|<s:iikG122 dYMcMcd ddr>segmentc8[U5RSS5$)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+rC)rrH)rs r5_decode_url_path_segmentrEs 7  # #C //r>rWcUn[SU;aUOSU-5nUR=(d SR5nU[R;a[ USU=(d US3S9eUR RS5Vs/sH oD(dM UPM nnU(d[ USUS 3S9eS nUS [R;a US nUS S n[U5S :a[ USUS3S9eUS SUS 3nUS S nUS:XaVU(dSU3$UtpU [;a[ USUSU S3S9eSRSU 55n U (aSUSU 3$SU3$U(aUS3OSn U(dU U3$UtpU [;a[ USUSU S3S9eU (dU U3$SRSU 55n U USU 3$s snf)a^Normalize 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`]. z://r.rzUnrecognized host 'zC'. Expected a Hugging Face URL (e.g. 'https://huggingface.co/...').r(r+z0Missing repository or bucket identifier in URL 'r,Nrr zCannot parse URL 'z{': expected a '/' repository or bucket. User/organization pages and single-segment URLs are not supported.bucketszbuckets/zCannot parse bucket URL 'z': unsupported '/z /' route.c38# UHn[U5v M g7fr\rrrs r5r#_url_to_uri_body..~sNg099zl/' route. Only repository pages and file/folder viewer routes (blob, resolve, raw, tree, ...) can be parsed.c38# UHn[U5v M g7fr\rrs r5rrsMW/88rrD) rhostnamerrrr rVsplitHF_URI_TYPE_PREFIXESr{rrJr)rWrparsedrrsegments type_prefixrepo_idrestactiontailrVprefixdecodeds r5r}r}OsO C Uc\ctcz :F OO !r ( ( *D 9)))%dkc]2uv  (.{{'8'8'=I'=G'=HI S(XY\X]]_&`aa#K{i444qk AB< 8}q$SE*UU  ! Qx{m,G AB[: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) ``` ryr,r(NrxrzzKMissing mount path. Expected ':' (e.g. 'hf://org/model:/data').)rjrkrlr$) r2rrEr r{ _split_mountrur*rh) rrrrrkrluri_strrjr4s r5parse_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 C'C""C'rrc>URS5(aSURS5pO+URS5(aSURS5pOSnURS5nUS:XaUb [USS 9eUSS4$USUnXS -SnU(d [US S 9eXEU4$) zSplit the ':[:ro|:rw]' suffix from 'body'. Returns '(location, mount_path, read_only)' where 'mount_path' is 'None' if no mount segment is present. rqTrrFNz:/zb':ro'/':rw' suffix is only valid when a mount path is provided (e.g. 'hf://...:/:ro').r(r z#Missing location before mount path.)endswith removesuffixrfindr )rrrlidxrrks r5rrs  }}U 1 1% 84 u  !2!25!94  **T C by  x T4DSzHAgiJ S&KLL  **r>rc URS5nUS:XaoU[R;a![USUS[RUS3S9e[ R U5=nb[US[RUS 3S9eS U4$USUnXS -SnU[R;a[RUU4$[ R U5=nb[US US US3S9eS U4$)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+rzMissing identifier after 'z '. Expected 'z/'.r(Nz*Type prefix must be plural. Did you mean 'z/...'?rQr z!Type prefix must be plural, got 'z/'. Did you mean 'z/'?)findrrr rEr get)rr slash_idxsingular_pluralfirstrs r5r~r~s-  c"IB y55 50 - H]H]G^_g^hhop  /228< rc*URS5nURSS5n[U5S:dUS(a US(d[USUS3S9eUSSUS3nSU;a [US S9e[U5S :aUSOS n[ UUS UUS 9$)z8Parse the body of a bucket URI: 'namespace/name[/path]'.r+rrr z)Bucket id must be 'namespace/name', got 'r,r(rDz3Bucket URIs do not support a revision marker ('@').rNrrrrr$)striprr{r r)rrrrK bucket_idpath_in_buckets r5rrs~~c"H NN3 "E 5zA~U1XU1XS(QRZQ[[]&^__8*AeAhZ(I iS&[\\!$UqU1XbN   #   r>cURS5nU(d [USS9eURS5nUS:XdUSURS5S:aUSnUR SS5n[ U5S:a[US US 3S9eUS SUS3n[ U5S:aUSOS nOUSUnXS-SnU(d [US S9eURS5S:wa[US US3S9e[ RU5n U b.U R5nU[ U5SRS5nO(URS5n U S:XaUnS nO USU nXS-Sn[U5nU(d [USS9e[UUUUUS9$)z@Parse the body of a repo URI: '[@][/]'.r+zMissing repository id.r(rDrNr rz-Repository id must be 'namespace/name', got 'z'. rrz!Missing repository id before '@'.r,zEmpty revision after '@'.r) rr rr0rr{rFmatchgroup removeprefixrr) rrrat_idxrrKrr rev_and_pathrrs r5rr's~~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>).ra functoolsre dataclassesrr urllib.parserrrhuggingface_hubrhuggingface_hub.errorsr r _validatorsr ritemsr dictr1rccompilerF frozensetvaluesrrrrrhrerv lru_cacherur|rr}rtuplerrbr~rr)kvs00r5rsV: (11%@) 5>4R4R4X4X4Z"[4ZDA144Z"[c3h[ "zz*MN$-Y-K-K-R-R-T#U)C.U .77b-cIcNc09)V9L/MinM $zzzz $'''T34 86c86e8686veCeDe0c0c0F*#F*#F*R7Xc7Xg7Xt+s+C+E#sTz4$;2N,O+<#suY5H5H#5M/N>      088   8 8  8_#\sF