+ ~jAaRt"0tRt^RIt^RIt^RIHtHt^RIHt^RI H t ^RI H t H t ^RIHt] P P#4UUu/uFwrWbK uppt]^k]P&!R4t]!] P P-44t]^k]!RR 7!R R 44t]!RR 7!R R 44tRRlt]P6RRl4tRRltRRltRRltRRlt RRlt!R#uuppi)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_idz ^refs/(?:convert/[\w.-]+|pr/\d+)T)frozenca]tRt^>toRtRtRt]!RRRRR7tV3RlRlt ] V3RlR l4t ] V3R lR l4t V3R lR lt V3RltRtVtR#)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"s/Users/mitch_tango/dev/rabbit-r1-livekit/agent/.venv/lib/python3.14/site-packages/huggingface_hub/utils/_hf_uris.py __annotate__HfUri.__annotate__Tsttttc 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)r zInvalid 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//z+Path must not contain empty segments (got 'z').) _rawtype_VALID_URI_TYPESrsortedidcountrrstrrevision path_in_repo startswith)selfr es& r __post_init__HfUri.__post_init__Tsiiioo2 99, ,N499+EWX^_oXpWqqr*st twww$''--,1,NtwwiWY*Z[ [ 99  = ) == $T]]]*QR R 99 T]]%>*RS S      ++C00DDsS   !" G#$Dj%&'( *Q)rr)__name__ __module__ __qualname____firstlineno____doc__r,r-rr%r1propertyr:r?rM__annotate_func____static_attributes____classdictcell__rs@rr r >sl   HL%eUDQDtt6%%%%wrr cpa]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. NFr c<V^8dQhRR/#rr)rrs"rrHfMount.__annotate__strcVP;'gRpVPPR4'dVPR8Xd\VRVP R2R7hR#)r r"zEMount path must be a non-empty absolute path starting with '/', got 'r#rN)r% mount_pathr.r)r/raws& rr1HfMount.__post_init__s\iioo2))#..$//S2H[\`\k\k[llno 3Irc <V^8dQhRS[/#r4rB)rrs"rrr^src 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 )sourcerMr` read_onlyrJrK)r/rLs& rrMHfMount.to_urisO ##%sDOO< >> % LL$...e <wwu~rcf<V^8dQh/S[;R&S[;R&S[R,;R&S[R,;R&#)rrhr`Nrir%)r r+r6)rrs"rrr^s?& M'(O)*d{!+, *Q-rr) rQrRrSrTrUrirr%r1rMrWrXrYrZs@rr\r\s=&"I%eUDQDArr\c0V^8dQhR\R\/#rr r)r+r6)rs"rrrs34rcB\V4R# \dR#i;i)z'Check if a string is a valid hf:// URI.TF) parse_hf_urir)r s&r is_hf_urirps$S s  c0V^8dQhR\R\/#rm)r+r )rs"rrrs/6/6c/6e/6rcVP\P4'g0\VR\P R\P R24hTpV\ \P4RpV'g\VR\P R24h\ W!R7wr4VR8Xd\ WCVR7#\WCVR7#) 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#rar$)r.rrErlen _split_type_parse_bucket_body_parse_repo_body)r rabodytype_locations& rroros@ >>)// 0 0  5 567 ) 5 566Y [  C s9(()+ ,D  293H3H2ILMM!$0OE !(s;; H 55rc0V^8dQhR\R\/#)r mount_strr)r+r\)rs"rrrs7X7Xc7Xg7XrcVP\P4'g \VR\P R2R7hTpV\ \P4RpV'g \VR\P R2R7h\ W!R7wr4pVf\VRR7h\PV,p\ V4p\YtYQR7# \dp\YPR7ThRp?ii;i) 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) ``` rsr#rNrtruzKMissing mount path. Expected ':' (e.g. 'hf://org/model:/data').)rhr`rir%) r.rrErrv _split_mountror!r\) r~rarzr|r`riuri_strrhr0s & 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,/#)rrzrarN)r+tupler6)rs"rrr-s5++s+C+E#sTz4$;2N,O+rc\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. rfTrgFNz:/zb':ro'/':rw' suffix is only valid when a mount path is provided (e.g. 'hf://...:/:ro').rz#Missing location before mount path.)endswith removesuffixrfindr)rzrariidxr|r`s&$ rrr-s  }}U 1 1% 84 u  !2!25!94  **T C by  x T4DSzHAgiJ S&KLL  **rcrV^8dQhR\R\R\\P\3,/#)rr|rar)r+rrrP)rs"rrrKs1#suY5H5H#5M/Nrc 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/'.rNz*Type prefix must be plural. Did you mean 'z/...'?modelz!Type prefix must be plural, got 'z/'. Did you mean 'z/'?r)findrHF_URI_TYPE_PREFIXESrrErFget)r|ra slash_idxsingular_pluralfirstrests&$ rrwrwKs-  c"IB y55 50 - H]H]G^_g^hhop  /228< [@][/]'.r"zMissing repository id.rrDNz-Repository id must be 'namespace/name', got 'z'. r z!Missing repository id before '@'.r#zEmpty revision after '@'.rr) rrrr*rrvrGmatchgroup removeprefixrr ) r|r{raat_idxr,rLrepo_idr- rev_and_pathrrs &&$ rryrys~~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   !   rcV^8dQh/^\9d\\\3,;R&^\9d\\,;R&#)rrFr')__conditional_annotations__dictr+ frozenset)rs"rrrsBF\[c3h[GZVU)C.U[r)#rrU functoolsre dataclassesrr urllib.parserhuggingface_hubrhuggingface_hub.errorsrr _validatorsrritemsrFcompilerGrvaluesr'r r\rp lru_cacherorrrwrxryr)kvrs00@rrs, ( %@) 5>4R4R4X4X4Z"[4ZDA144Z"[[ "zz*MN$-Y-K-K-R-R-T#UU $JJJZ $'''T /6/6d7Xt+<>08c #\s D