i/ddlmZddlmZddlmZddlmZddlmZGdde eZ Gdd e eZ Gd d e eZ eGd d Z eGddZeGddZeGddZeGddZeGddZdS)) dataclass)datetime)Enum)Literal)parse_datetimecBeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdS) 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 r r rrrrrrrr[/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/huggingface_hub/_space_api.pyr r sZ   K!LHKG)#MHG F!L1rr cveZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdS) 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-upgradezcpu-performancezcpu-xlsprx8z zero-a10gzt4-smallz t4-mediuml4x1l4x4l40sx1l40sx4l40sx8z a10g-smallz a10g-largez a10g-largex2z a10g-largex4z a100-largea100x4a100x8h200h200x2h200x4h200x8inf2x6N)rrrr CPU_BASIC CPU_UPGRADECPU_PERFORMANCECPU_XLSPRX8 ZERO_A10GT4_SMALL T4_MEDIUML4X1L4X4L40SX1L40SX4L40SX8 A10G_SMALL A10G_LARGE A10G_LARGEX2 A10G_LARGEX4 A100_LARGEA100X4A100X8H200H200X2H200X4H200X8INF2X6rrrrr1s  IK'O F EIHI D D F F FJJ!L!LJ F F D F F FFFFrrceZdZdZdZdZdZdS) 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)rrrrSMALLMEDIUMLARGErrrrFrF_s)   E F EEErrFceZdZUdZeded<eed<eed<dZedzed<dZe dzed<dZ edzed <dd Z d e fd Z d efd ZdS)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 p|dd|_|d|_|d}||n|d|_|d|_|d}||n|d|_|d |_dS) NrSrPrT mountPathrUrVreadOnlyrWrX)getrSrTrUrVrWrX)selfkwargsrUrWs r__init__zVolume.__init__sJJvw// X& ZZ ,, (2(>**F %#~D  9 9DL rc |jr d|jnd}|jr d|jnd}dddd|jd}d|jd|j||d |j| S) zDReturn the volume as an HF handle in the format expected by the CLI./@z:roz:rw)TFNzhf://zs/:)rXrVr]rWrSrTrU)r^rXrVros r to_hf_handlezVolume.to_hf_handles"&)349*.-?&t}&&&R%r 2 2 6 6t~r J JWtyWWDKWW4WW$/WSUWWWr)rYN)rrrrr__annotations__strrVrWboolrXr`dictrdrkrrrrNrNps$ 7 8888 KKKOOOHcDj!Itd{!!!D#*''''     XcXXXXXXrrNcleZdZUeded<eeeedzfed<eed<deddfdZ dS) SpaceHotReloading)createdcanceledstatusNreplica_statusesrawrcrYcH|d|_|d|_||_dS)NrtreplicaStatuses)rtrurvrbs rr`zSpaceHotReloading.__init__s&8n $%6 7r) rrrrrllisttuplermror`rrrrqrqsq ) ****5cDj12222 IIITdrrqceZdZUdZeed<edzed<edzed<edzed<edzed<e dzed<e e dzed <e ed <d e d dfd Z dS) 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_timestorage hot_reloadingvolumesrvrcrYc|d|_|did|_|did|_|d|_|d|_|dx}t |nd|_|d}| d |Dnd|_||_ dS) Nr}r~current requested gcTimeoutr hotReloadingrc&g|]}tdi|S)r)rN).0vs r z)SpaceRuntime.__init__..s"999  999r) r}r]r~rrrrqrrrv)r^rcraw_hr raw_volumess rr`zSpaceRuntime.__init__s'] R0044Y?? "&((:r":":">">{"K"K((;//xx ** EIXXnE]E];]6:j.v666pthhy)) =H=T99[9999Z^ r)rrrrr rlrintrFrqryrNror`rrrr|r|s2 d""""%,,,,d  D    $t++++ &\D    III T d      rr|cReZdZUdZeed<edzed<edzed<dededdfdZdS) 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_atvaluesrYc||_|d|_|d}|t|nd|_dS)Nr updatedAt)rr]rrrr^rrrs rr`zSpaceSecret.__init__sL!::m44ZZ ,, 8B8N.444TXr rrrrrmrlrror`rrrrrs}   HHHt4YCYY$YYYYYYrrc\eZdZUdZeed<eed<edzed<edzed<dededdfd ZdS) 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). rvalueNrrrrYc||_|d|_|d|_|d}|t |nd|_dS)Nrrr)rrr]rrrrs rr`zSpaceVariable.__init__sWG_ !::m44ZZ ,, 8B8N.444TXrrrrrrrs   HHH JJJt4YCYY$YYYYYYrrceZdZUdZeed<eed<eed<edzed<edzed<eed<eed <eedzed <e dzed <edzed <edzed <e dzed<edzed<de ddfdZ dS)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. idauthortitleNemojisdklikesprivatetagsruntimeai_short_description ai_categorysemantic_relevancy_scoretrending_scorercrYc|d}|d|_|dd|_|dd|_|d|_|d|_|dd |_|d d |_|d |_|rt|nd|_ |d |_ |d|_ |d|_ |d|_dS)NrrrrgrrrrrrFrrrsemanticRelevancyScore trendingScore)r]rrrrrrrrr|rrrrr)r^rcrs rr`zSpaceSearchResult.__init__Rs((9%%t*hhx,, XXgr** XXg&& 88E??XXgq)) xx 511 HHV$$ 07A|G,,,T $(HH-C$D$D!88M22(,1I(J(J%"hh77r) rrrrrmrlrrnryr|floatror`rrrrr!sB GGG KKK JJJ : tOOO JJJ MMM s)d  D    *$$$t#dl***$J8T8d888888rrN) dataclassesrrenumrtypingrhuggingface_hub.utilsrrmr rrFrNrqr|rrrrrrrsB"!!!!!00000022222d2226+++++C+++\3" 8X8X8X8X8X8X8X 8Xv   ,,,,,,, ,^ YYYYYYY Y6 YYYYYYY Y8 >8>8>8>8>8>8>8 >8>8>8r