o 0jP@ @srUdZddlZddlmZmZddlmZddlmZddl m Z m Z ddl m Z d d ejDZeeefed <ed ZeejZeeed <eddGdddZeddGdddZdedefddZdedefddZdededeeedBedBffddZdededeej effd d!Z!ded"ej dedefd#d$Z"ded"ej dedefd%d&Z#dS)'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_idcCsi|]\}}||qSr ).0kvr r _/var/www/html/Deteccion_Ine/venv/lib/python3.10/site-packages/huggingface_hub/utils/_hf_uris.py 0sr_TYPE_TO_PREFIXz ^refs/(?:convert/[\w.-]+|pr/\d+)_VALID_URI_TYPEST)frozenc@seZdZUdZejed<eed<dZedBed<dZ eed<e ddddd Z edBed <dd d Z e d efddZe d efddZd efddZdS)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. typeidNrevision path_in_repoFreprhashcomparedefault_rawreturnc Cs|jpd}|jtvrt|d|jdttdd|jr%|jddkr0t|d|jd d|jd krRzt|jWntyQ}z t|t |d|d}~ww|j dur`|j s`t|d d|jd krp|j durpt|d d|j r|j ds~d |j vrt|d|j dddSdS)NrzInvalid type 'z'. Must be one of .urimsg/rz"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').) rrrrsortedrcountr rstrrr startswith)selfr"er r r __post_init__Ss*      zHfUri.__post_init__cCs |jdkS)z$True if this URI points at a bucket.r&rr+r r r is_bucketn zHfUri.is_bucketcCs |jdkS)zJTrue if this URI points at a repository (model, dataset, space or kernel).r&r.r/r r ris_reposr1z HfUri.is_repocCsztjt|jd|jg}|jdur,|j}d|vr$t|dur$|dd}| d||j r8| d|j d |S)zRender the URI as a canonical 'hf://' string. The type prefix is always written explicitly (e.g. 'hf://models/my-org/my-model'). r$Nz%2F@r) r HF_PROTOCOLrrrr_SPECIAL_REFS_REVISION_REGEX fullmatchreplaceappendrjoin)r+partsrr r rto_urixs   z HfUri.to_urirN)__name__ __module__ __qualname____doc__r HfUriType__annotations__r)rrrrr-propertyboolr0r2r;r r r rr=s    rc@sfeZdZUdZeed<eed<dZedBed<e dddddZ edBed<dd d Z d efd d Z dS)HfMountaFA 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_onlyFrrrcCs:|jpd}|jdr|jdkrt|d|jdddS)Nrr$zEMount path must be a non-empty absolute path starting with '/', got 'r%r!)rrGr*r)r+rawr r rr-s  zHfMount.__post_init__cCs:|jd|jg}|jdur||jrdndd|S)zqRender the mount as a canonical 'hf://' string. Example: 'hf://models/my-org/my-model:/data:ro' :N:ro:rwr)rFr;rGrHr8r9)r+r:r r rr;s  zHfMount.to_urir<) r=r>r?r@rrBr)rHrDrrr-r;r r r rrEs  rEr"rcCs|tjst|dtjdtjd|}|ttjd}|s+t|dtjdt||d\}}|dkr>t|||dSt|||dS) aParse 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%rIr&)r*rr4rlen _split_type_parse_bucket_body_parse_repo_body)r"rIbodytype_locationr r r parse_hf_uris  rW mount_strc Cs|tjst|dtjdd|}|ttjd}|s)t|dtjddt||d\}}}|dur[: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) ``` rMr%r!NrNrOzKMissing mount path. Expected ':' (e.g. 'hf://org/model:/data').)rFrGrHr) r*rr4rrP _split_mountrWr#rE) rXrIrTrVrGrHZuri_strrFr,r r rparse_hf_mounts(     rZrTrIcCs|drd|d}}n|drd|d}}nd}|d}|dkr6|dur1t|dd |ddfS|d|}||d d}|sLt|d d |||fS) zSplit the ':[:ro|:rw]' suffix from 'body'. Returns '(location, mount_path, read_only)' where 'mount_path' is 'None' if no mount segment is present. rKTrLFNz:/zb':ro'/':rw' suffix is only valid when a mount path is provided (e.g. 'hf://...:/:ro').r!rz#Missing location before mount path.)endswith removesuffixrfindr)rTrIrHidxrVrGr r rrY"s$       rYrVcCs|d}|dkr8|tjvrt|d|dtj|ddt|}dur4t|dtj|d dd |fS|d|}||d d}|tjvrRtj||fSt|}durht|d |d |ddd |fS)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$r[zMissing identifier after 'z '. Expected 'z/'.r!Nz*Type prefix must be plural. Did you mean 'z/...'?modelrz!Type prefix must be plural, got 'z/'. Did you mean 'z/'?)findrHF_URI_TYPE_PREFIXESrr4rget)rVrI slash_idxZsingular_pluralfirstrestr r rrQ@s,    rQrUcCsd|vr t|dd|d}|dd}t|dks#|dr#|ds-t|d|d d|dd|d}t|d krB|dnd }t||d ||d S)z8Parse the body of a bucket URI: 'namespace/name[/path]'.r3z3Bucket URIs do not support a revision marker ('@').r!r$rrz)Bucket id must be 'namespace/name', got 'r%rNrrrrr)rstripsplitrPr)rVrUrIr:Z bucket_idZpath_in_bucketr r rrR_s   rRc Csn|d}|s t|dd|d}|dkrFd}|dd}t|dkr.t|d|d d|d d|d }t|dkrC|dnd }nh|d|}||d d}|s\t|d d|dd krmt|d|ddt|} | dur| }|t|d d}n|d} | dkr|}d }n|d| }|| d d}t |}|st|ddt |||||dS)z@Parse the body of a repo URI: '[@][/]'.r$zMissing repository id.r!r3r[Nrgz-Repository id must be 'namespace/name', got 'z'. rrrz!Missing repository id before '@'.r%zEmpty revision after '@'.ri) rjrrarkrPr(r5matchgroup removeprefixrr) rVrUrIZat_idxrr:Zrepo_idrZ rev_and_pathrlrdr r rrSwsJ           rS)$r@re dataclassesrr urllib.parserZhuggingface_hubrZhuggingface_hub.errorsrrZ _validatorsr rbitemsrdictr)rBcompiler5 frozensetvaluesrrrErWrZtuplerDrYrArQrRrSr r r rsH    $ M*2(: