/j:ddlmZddlmZddlmZddlmZddlmZm Z m Z Gdde eZ e je je je j fZe j$e j&e j(e j*e j,e j.e j0e j2fZGdd e eZGd d e eZeGd d ZeGddZeGddZeGddZ eGddZ!eGddZ"eGddZ#eGddZ$y)) dataclass)datetime)Enum)Literal)HfMountHfUriparse_datetimec@eZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd Zy) SpaceStagea Enumeration of possible stage of a Space on the Hub. Value can be compared to a string: ```py assert SpaceStage.BUILDING == "BUILDING" ``` Taken from https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceInfo.ts#L61 (private url). NO_APP_FILE CONFIG_ERRORBUILDING BUILD_ERRORRUNNINGRUNNING_BUILDING RUNTIME_ERRORDELETINGSTOPPEDPAUSED APP_STARTINGRUNNING_APP_STARTINGN)__name__ __module__ __qualname____doc__r r rrrrrrrrrr]/root/repos/pocs/video-evals/.venv/lib/python3.12/site-packages/huggingface_hub/_space_api.pyr r sG  K!LHKG)#MHG F!L1rr cdeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZy) SpaceHardwarea= Enumeration of hardwares available to run your Space on the Hub. Value can be compared to a string: ```py assert SpaceHardware.CPU_BASIC == "cpu-basic" ``` Taken from https://github.com/huggingface-internal/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts (private url). z cpu-basicz cpu-upgradez zero-a10gzt4-smallz t4-mediuml4x1l4x4l40sx1l40sx4l40sx8z a10g-smallz a10g-largez a10g-largex2z a10g-largex4z a100-largea100x4a100x8z rtx-pro-6000zrtx-pro-6000x2zrtx-pro-6000x4zrtx-pro-6000x8N)rrrr CPU_BASIC CPU_UPGRADE ZERO_A10GT4_SMALL T4_MEDIUML4X1L4X4L40SX1L40SX4L40SX8 A10G_SMALL A10G_LARGE A10G_LARGEX2 A10G_LARGEX4 A100_LARGEA100X4A100X8 RTX_PRO_6000RTX_PRO_6000X2RTX_PRO_6000X4RTX_PRO_6000X8rrrr r Dsx IKIHI D D F F FJJ!L!LJ F F"L%N%N%Nrr ceZdZdZdZdZdZy) SpaceStoragea5 Enumeration of persistent storage available for your Space on the Hub. Value can be compared to a string: ```py assert SpaceStorage.SMALL == "small" ``` Taken from https://github.com/huggingface/moon-landing/blob/main/server/repo_types/SpaceHardwareFlavor.ts#L24 (private url). smallmediumlargeN)rrrrSMALLMEDIUMLARGErrrr>r>ns  E F Err>ceZdZUdZeded<eed<eed<dZedzed<dZe dzed<dZ edzed <dd Z d e fd Z d efd Zy)Volumea Describes a volume to mount in a Space or Job container. Args: type (`str`): Type of volume: `"bucket"`, `"model"`, `"dataset"`, or `"space"`. source (`str`): Source identifier, e.g. `"username/my-bucket"` or `"username/my-model"`. mount_path (`str`): Mount path inside the container, e.g. `"/data"`. Must start with `/`. revision (`str` or `None`): Git revision (only for repos, defaults to `"main"`). read_only (`bool` or `None`): Read-only mount. Forced `True` for repos, defaults to `False` for buckets. path (`str` or `None`): Subfolder prefix inside the bucket/repo to mount, e.g. `"path/to/dir"`. )bucketmodeldatasetspacetypesource mount_pathNrevision read_onlypathreturnc 2|jdd|_|d|_|jd}||n|d|_|jd|_|jd}||n|jd|_|jd |_y) NrKrHrL mountPathrMrNreadOnlyrOrP)getrKrLrMrNrOrP)selfkwargsrMrOs r__init__zVolume.__init__sJJvw/ X& ZZ , (2(>*F> %#~~D  99 99DL rc tt|j|j|j|j xsd|j |jjS)zGReturn the volume as an HF mount URI in the format expected by the CLI.)rKidrN path_in_repo)rLrMrO) rrrKrLrNrPrMrOto_uri)rVs rraz Volume.to_urisMdiiDKK$--^b^g^g^mkmnnn  &(  r)rQN)rrrrr__annotations__strrNrOboolrPrXdictr\rarrrrFrFsf$ 7 88 KOHcDj!Itd{!D#*'  rrFcXeZdZUeded<eeeedzfed<eed<deddfdZ y) SpaceHotReloading)createdcanceledstatusNreplica_statusesrawr[rQc:|d|_|d|_||_y)NrjreplicaStatuses)rjrkrlrZs rrXzSpaceHotReloading.__init__s"8n $%6 7r) rrrrrblisttuplercrerXrrrrgrgs> ) **5cDj122 ITdrrgceZdZUdZeed<edzed<edzed<edzed<edzed<e ed<e dzed <e e dzed <e ed <d e d dfdZy) SpaceRuntimea Contains information about the current runtime of a Space. Args: stage (`str`): Current stage of the space. Example: RUNNING. hardware (`str` or `None`): Current hardware of the space. Example: "cpu-basic". Can be `None` if Space is `BUILDING` for the first time. requested_hardware (`str` or `None`): Requested hardware. Can be different from `hardware` especially if the request has just been made. Example: "t4-medium". Can be `None` if no hardware has been requested yet. sleep_time (`int` or `None`): Number of seconds the Space will be kept alive after the last request. By default (if value is `None`), the Space will never go to sleep if it's running on an upgraded hardware, while it will go to sleep after 48 hours on a free 'cpu-basic' hardware. For more details, see https://huggingface.co/docs/hub/spaces-gpus#sleep-time. volumes (`list[Volume]` or `None`): List of volumes mounted in the Space. Each volume is a [`Volume`] object describing its type, source, mount path, and optional settings. `None` if no volumes are attached. raw (`dict`): Raw response from the server. Contains more information about the Space runtime like number of replicas, number of cpu, memory size,... stageNhardwarerequested_hardware sleep_timestoragedev_mode hot_reloadingvolumesrlr[rQc|d|_|jdxsi}|jd|_|jd|_|jd|_|jd|_|jdd|_|jd x} t|nd|_|jd }||Dcgc] }td i|c}nd|_ ||_ ycc}w) Nrsrtcurrent requested gcTimeoutrwdevModeF hotReloadingrzr) rsrUrtrurvrwrxrgryrFrzrl)rVr[ hardware_dictraw_hr raw_volumesvs rrXzSpaceRuntime.__init__s'] ,2 %)))4 "/"3"3K"@((;/xx * E2 EIXXnE];]6:j.v6pthhy) =H=T[9  9Z^ :s C/)rrrrr rbr intr>rdrgrorFrerXrrrrrrrsq2 d""%,,d  D  N$t++ &\D  I T d rrrcPeZdZUdZeed<edzed<edzed<dededdfdZy) SpaceSecreta& Contains information about a secret of a Space. Secret values are write-only and cannot be read back. Only the key, description, and last update time are returned by the API. Args: key (`str`): Secret key. Example: `"GITHUB_API_KEY"` description (`str` or None): Description of the secret. Example: `"Github API key to access the Github API"`. updated_at (`datetime` or None): datetime of the last update of the secret (if the secret has been updated at least once). keyN description updated_atvaluesrQc||_|jd|_|jd}|t||_yd|_y)Nr updatedAt)rrUrr rrVrrrs rrXzSpaceSecret.__init__s@!::m4ZZ , 8B8N.4TXr rrrrrcrbrrerXrrrrrs@  Ht4YCYY$YrrcZeZdZUdZeed<eed<edzed<edzed<dededdfd Zy) SpaceVariablea Contains information about the current variables of a Space. Args: key (`str`): Variable key. Example: `"MODEL_REPO_ID"` value (`str`): Variable value. Example: `"the_model_repo_id"`. description (`str` or None): Description of the variable. Example: `"Model Repo ID of the implemented model"`. updatedAt (`datetime` or None): datetime of the last update of the variable (if the variable has been updated at least once). rvalueNrrrrQc||_|d|_|jd|_|jd}|t ||_yd|_y)Nrrr)rrrUrr rrs rrXzSpaceVariable.__init__,sKG_ !::m4ZZ , 8B8N.4TXrrrrrrrsE  H Jt4YCYY$YrrceZdZUdZeed<eed<eed<edzed<edzed<eed<eed <eedzed <e dzed <edzed <edzed <e dzed<edzed<de ddfdZ y)SpaceSearchResultaA single result from the Spaces semantic search API. Returned by [`HfApi.search_spaces`]. Attributes: id (`str`): ID of the Space (e.g. `"username/repo-name"`). author (`str`): Author of the Space. title (`str`): Display title of the Space. emoji (`str` or `None`): Emoji icon of the Space. sdk (`str` or `None`): SDK used by the Space (e.g. `"gradio"`, `"docker"`, `"static"`). likes (`int`): Number of likes. private (`bool`): Whether the Space is private. tags (`list[str]` or `None`): List of tags. runtime ([`SpaceRuntime`] or `None`): Runtime information (stage, hardware, etc.). ai_short_description (`str` or `None`): AI-generated short description. ai_category (`str` or `None`): AI-generated category (e.g. `"Image Generation"`). semantic_relevancy_score (`float` or `None`): Semantic relevancy score (0-1) relative to the search query. trending_score (`int` or `None`): Trending score. r_authortitleNemojisdklikesprivatetagsruntimeai_short_description ai_categorysemantic_relevancy_scoretrending_scorer[rQcN|jd}|d|_|jdd|_|jdd|_|jd|_|jd|_|jdd |_|jd d |_|jd |_|r t|nd|_ |jd |_ |jd|_ |jd|_ |jd|_y)Nrr_rr^rrrrrrFrrrsemanticRelevancyScore trendingScore)rUr_rrrrrrrrrrrrrr)rVr[rs rrXzSpaceSearchResult.__init__es((9%t*hhx, XXgr* XXg& 88E?XXgq) xx 51 HHV$ 07|G,T $(HH-C$D!88M2(,1I(J%"hh7r) rrrrrcrbrrdrorrfloatrerXrrrrr4sB G K J : tO J M s)d  D  *$t#dl*$J8T8d8rrcJeZdZUdZeed<eed<eed<eed<deddfd Zy) SpaceTemplatea Contains information about a Space template available on the Hub. Returned by [`HfApi.list_space_templates`]. The `repo_id` can be passed as `space_template` to [`HfApi.create_repo`] to seed a new Space from that template. Args: name (`str`): Human-friendly name of the template (e.g. `"JupyterLab"`, `"chatbot"`). repo_id (`str`): Repo id of the template Space (e.g. `"SpacesExamples/jupyterlab"`). sdk (`str`): SDK the template is built with (e.g. `"gradio"`, `"docker"`, `"static"`). preferred_private (`bool`): Whether Spaces created from this template are recommended to be private. namerepo_idrpreferred_privater[rQNcT|d|_|d|_|d|_|d|_y)NrrepoIdrpreferredPrivate)rrrrrZs rrXzSpaceTemplate.__init__s1L H~ ;!%&8!9r) rrrrrcrbrdrerXrrrrrvs1" I L H:T:d:rrcVeZdZUdZeed<eed<edzed<edzed<deddfd Zy) ZeroGpuQuotaa Contains information about the ZeroGPU quota of the authenticated user. The ZeroGPU quota is consumed each time you use a ZeroGPU Space (from the UI or through its API) and is reset periodically. See https://huggingface.co/docs/hub/spaces-zerogpu for more details. Returned by [`HfApi.get_zero_gpu_quota`]. Args: base (`float`): Total quota, in GPU-seconds. remaining (`float`): Remaining quota, in GPU-seconds. resets_at (`datetime` or `None`): Date at which the quota will be reset. `None` if the quota has not been used yet. overquota_used (`float` or `None`): Overquota (paid) GPU-seconds consumed once the base quota is exhausted. PRO, Team and Enterprise users can purchase credits to go beyond the base quota at https://huggingface.co/settings/billing?add-credits=true. base remainingN resets_atoverquota_usedr[rQc|d|_|d|_|jdx} t|nd|_|jd|_y)Nrr|resetsAt overquotaUsed)rrrUr rr)rVr[rs rrXzZeroGpuQuota.__init__sKL iDHHHZDX7Xy6e 2ko"hh7r) rrrrrrbrrerXrrrrrs;( K$DL 8T8d8rrN)% dataclassesrrenumrtypingrhuggingface_hub.utilsrrr rcr rrrrINTERMEDIATE_SPACE_STAGESrrrr r rrrTERMINAL_SPACE_STAGESr r>rFrgrrrrrrrrrrrs"@@2d28##  '&C'&T3" 99 9x   // /d YY Y6 YY Y8 >8>8 >8B :: :< 88 8r