pyiP@ v%SrSSKrSSKJrJr SSKJr SSKJr SSK J r J r SSK J r \RR5VVs0sHupX_M snnr\\\4\S '\R("S 5r\"\RR/55r\\\S '\"S S 9"SS55r\"S S 9"SS55rS\S\4SjrS\S\4SjrS\S\S\\\S-\S-44SjrS\S\S\\R@\44Sjr!S\S\R@S\S\4Sjr"S\S\R@S\S\4Sjr#gs snnf)a|Centralized 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://[/][@][/] ``` 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)unquote) constants) HfUriErrorHFValidationError)validate_repo_id_TYPE_TO_PREFIXz ^refs/(?:convert/[\w.-]+|pr/\d+)_VALID_URI_TYPEST)frozenc\rSrSr%Sr\R \S'\\S'Sr \S-\S'Sr \\S'\ "S S S SS 9r \S-\S 'SS jr \S \4Sj5r\S \4Sj5rS \4SjrSrg)HfUri=aParsed 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//z+Path must not contain empty segments (got 'z').) rrr rsortedrcountr rstrrr startswith)selfr es [/home/mande/repo/quber/.venv/lib/python3.13/site-packages/huggingface_hub/utils/_hf_uris.py __post_init__HfUri.__post_init__Ss`iio2 99, ,N499+EWX^_oXpWqqr*st tww$''--,1,NtwwiWY*Z[ [ 99  = ) == $T]]*QR R 99 T]]%>*RS S     ++C00DD/][@][/]:[: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_onlyFrrrcUR=(d SnURRS5(aURS:Xa[USURS3S9eg)Nrr"zEMount path must be a non-empty absolute path starting with '/', got 'r#r)rrSr(r)r)raws r+r,HfMount.__post_init__sZiio2))#..$//S2H[\`\k\k[llno 3Ir4cURR5SUR/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)rRrArSrTr>r?)r)r@s r+rAHfMount.to_urisM ##%sDOO< >> % LL$..e <wwu~r4rCrD)rErFrGrHrIrrKr'rTrMrrr,rArNrCr4r+rPrPsK" MO!Itd{!%eUDQD#*Qr4rPr rcxUR[R5(d/[US[RS[RS35eUnU[ [R5SnU(d[US[RS35e[ X!S9up4US:Xa [ XCUS9$[XCUS9$) arParse a Hugging Face Hub URI ('hf://...'). A HF URI is a URI-like string identifying a location on the Hugging Face Hub. The full grammar is: ``` hf://[/][@][/] ``` See 'docs/source/en/package_reference/hf_uris.md' for the full specification. Args: uri (`str`): The URI to parse. Must start with 'hf://'. Returns: [`HfUri`]: the parsed URI. Raises: [`HfUriError`]: If the URI is malformed (missing prefix, invalid type, missing id, 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') ``` Must start with 'z'. Expected format: z#[/][@][/]NEmpty body after 'r#rVr$)r(rr:rlen _split_type_parse_bucket_body_parse_repo_body)r rVbodytype_locations r+ parse_hf_urirhs> >>)// 0 0  5 567 ) 5 566Y [  C s9(()+ ,D  293H3H2ILMM!$0OE !(s;; H 55r4 mount_strcUR[R5(d[US[RS3S9eUnU[ [R5SnU(d[US[RS3S9e[ X!S9up4nUc [USS9e[RU-n[ U5n[XtXQS9$![an[XRS9UeSnAff=f) a[Parse a HF mount specification ('hf://...:[: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) ``` r^r#rNr_r`zKMissing mount path. Expected ':' (e.g. 'hf://org/model:/data').)rRrSrTr) r(rr:rra _split_mountrhr!rP) rirVrergrSrTuri_strrRr*s r+parse_hf_mountrms@    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'rerVc>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. rZTr[FNz:/zb':ro'/':rw' suffix is only valid when a mount path is provided (e.g. 'hf://...:/:ro').rr z#Missing location before mount path.)endswith removesuffixrfindr)rerVrTidxrgrSs r+rkrk"s  }}U 1 1% 84 u  !2!25!94  **T C by  x T4DSzHAgiJ S&KLL  **r4rgc 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"rozMissing identifier after 'z '. Expected 'z/'.rNz*Type prefix must be plural. Did you mean 'z/...'?modelr z!Type prefix must be plural, got 'z/'. Did you mean 'z/'?)findrHF_URI_TYPE_PREFIXESrr:r get)rgrV slash_idxsingular_pluralfirstrests r+rbrb@s-  c"IB y55 50 - H]H]G^_g^hhop  /228< [@][/]'.r"zMissing repository id.rr9roNr~z-Repository id must be 'namespace/name', got 'z'. rr rz!Missing repository id before '@'.r#zEmpty revision after '@'.r) rrrvrrar&r;matchgroup removeprefixrr) rgrfrVat_idxrr@repo_idr rev_and_pathrrys r+rdrdws~~c"H S&>??]]3 F |sA& u:>,YZbYccf*gh h1XJaaz*#&u:>uQxr 7F# - *MN N ==  ",YZaYbbd*ef f-22<@  {{}H'H 8EEcJL$))#.IB'! ' 3+MO< 8$*EF F   !   r4)$rIre dataclassesrr urllib.parserhuggingface_hubrhuggingface_hub.errorsrr _validatorsr rwitemsr dictr'rKcompiler; frozensetvaluesr rrPrhrmtuplerMrkrJrbrcrd)kvs00r+rs, ( %@) 5>4R4R4X4X4Z"[4ZDA144Z"[c3h[ "zz*MN$-Y-K-K-R-R-T#U)C.U $JJJZ $'''T/6c/6e/6d7Xc7Xg7Xt+s+C+E#sTz4$;2N,O+<#suY5H5H#5M/N>      066   6 6  6O #\sD5