Zjw UdZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl m Z mZddlmZddlmZddlmZmZmZmZmZmZmZddlZddlZddlmZmZddl m!Z!m"Z"m#Z#dd l$m%Z%dd l&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,dd l-m.Z.d d l/m0Z0d dl1m2Z2m3Z3e*jhZ5dZ6dZ7erddl8m9Z9dde:dzddfdZ;dZede:zZ?e e=e:e@e:geAdzfZBede:ZCde:dzdejdejddfd ZFejd!ZHGd"d#eZIgd$ZJe=eKe:e:feLd%<dejddfd&ZMd'ejdeOfd(ZPd'ejd)e=e:ddfd*ZQd)e=e:deOfd+ZRd)e=e:d,eOd-eOddfd.ZSd/e:dd0fd1ZTd2ejd3e:d4e=eKe:e:fddfd5ZV dd6eBd7e ge=eKe:e:ffdzdeWeIfd8ZXdd9e?de=e:dzdeWefd:ZYGd;deWedzddz"generate_epilog..Vs --help` for more information about a command. Read the documentation at )CLI_REFERENCE_URLjoin)r,r-docs_url examples_strs r)generate_epilogr9KsS7B#$[M2GXH99<8<r?r@lines r)_format_epilog_no_indentrFfs< !!#LL& 'D   & 'r+z\s*\|\s*ceZdZdZeZdejddffd Zdejde e de ffd Z e dejde e ddfd Zdejd e dejdzffd Zdee e e ffd Zdejd ej&ddfdZdejd ej&ddfdZdejde e fdZxZS)HFCliTyperGroupa Typer Group that: - lists commands alphabetically within sections. - separates commands by topic (main, help, etc.). - formats epilog without extra indentation. - supports aliases via pipe-separated names (e.g. ``name="list | ls"``). - consumes the global formatting flags (``--format``, ``--json``, ``-q`` / ``--quiet``, ``--no-truncate``) anywhere in the args of a leaf command and applies them to ``out``, so leaf commands don't need to declare these options themselves. - rewrites ``spaces/user/repo`` to ``user/repo --type space`` for commands that accept ``--type``. - enriches "No such option" / "No such command" errors with available options or commands. r?r$Nc t ||S#tj$rP}|j=|jj &|jj }t |tjrx|j|jDcgc]@}|j|j|x} |js||jdfBncc}w}}t|d||j|jDcgc]G}t |tjr+|js|j|jx}r|Incc}w}}t|d|d}~wwxYw)atEnrich unknown-option errors with available options or subcommands. Catches `NoSuchOption` raised during subcommand `make_context()` (option parsing). For leaf commands (e.g. `hf repos create --test`) we list the command's options; for groups (e.g. `hf cache --test`) we list subcommands since groups have no user-facing options. NPlimitcommandsoptions)superinvokeclick NoSuchOptionr?command isinstanceGroup list_commands get_commandhiddenget_short_help_str_enrich_usage_error get_paramsOptionget_help_record) selfr?ecmdnamesubitemsprecord __class__s r)rPzHFCliTyperGroup.invokesN 7>#& &!! uu QUU]]%>eemmc5;;/%($5$5aee$< #&??155$#??CLUXU_U_s55B5?@E (:u=  "%!6%a6qxxWXWhWhijininWoMoVMoE (9e< ' s/E6A1E1AC3E1A EE11E6argsc |r|djds|dnd}|r|j||nd}||j|| t|||\}}}|&t)|t j*s t-|||||fS#t j $r!}|||jjD cgc]-\} } | jstj| D]} | /ncc} } } w} } } } tj|| } | r>djd| D}|jj!dd|d|_|j#|Dcgc]6}|j||x} |js||j%d f8ncc}w}}t'|d |d}~wwxYw) Nr-, c3(K|] }d|d yw)'Nr1r2ms r)r4z2HFCliTyperGroup.resolve_command..s+Fas!H+Fs.z. Did you mean ?rJrKrM) startswithrW_rewrite_repo_type_prefixrOresolve_commandrQ UsageErrorrMrcrX _ALIAS_SPLITrCdifflibget_close_matchesr6messagerstriprVrYrZrTrU_consume_format_flags_for_leaf)r^r?rgcmd_namer`ra resolved_cmdsub_argsr_key registeredalias visible_namesmatches suggestionsrbrcrfs r)rszHFCliTyperGroup.resolve_commands"47+=+=c+B4719dsH-t ?  * *3 5 +07+B3+M (D,4  #J|U[[,Q *< B\8++9 {x3,0==+>+>+@!!'Z%,,!-!3!3C!8 !!!! ! "33HmL"&))+Fg+F"FK#$99#3#3C#8"9 UV WAI!% 2 23 7#//T::GPSPZPZ3111;< $Az59 ) s1 B G$F;2C6 5A5F;*;F&%F;;Gr`ctd|jD}|syt}d}|jD]A}t|tj s|j dvr|j||dz }C|syt}|jD][}t|tjs|jr+g|j|jD]}|j|]d}g} d} | t|kr^|| } | dk(rnS| jdrd| vs| |vr| dz } n%| d z } n||vr| j| |dz }| dz } | t|kr^| syd} d} g}| D]}||jd d }t|d k7s|dt j"vr<|d}t j"|}| !|| k7rt j$d | d |d|} |} |j||dd |d f|sytd|Drt j$d| d|D] \}}|||< |j'd| gy)uRewrite prefixed repo IDs (e.g. ``spaces/user/repo``) to ``user/repo --type space``. Only applies to commands that have a ``--type`` / ``--repo-type`` option and at least one repo-ID positional argument (any ``click.Argument`` whose name ends with ``_id``, e.g. ``repo_id``, ``from_id``, ``to_id``). When the token that maps to such an argument matches ``{prefix}/org/repo`` (where *prefix* is one of ``spaces``, ``datasets``, or ``models``), the prefix is stripped and an implicit ``--type {type}`` is appended. An error is raised if ``--type`` is also provided explicitly or if multiple prefixed arguments disagree on the repo type. Only repo-ID positional slots are inspected so that other positional arguments (filenames, local paths, patterns …) are never misinterpreted as prefixed repo IDs. c3pK|].}t|tjxrd|jv0yw)--typeN)rTrQr\opts)r2params r)r4z.s-q]bj =X(ejjBXXqs46Nr)repo_idfrom_idto_idr--ri=/z!Conflicting repo type prefixes: 'z/' and 'z/'.c3K|]6}|dk(xs+|jdxs|dk(xs|jd8yw)rz--type= --repo-typez --repo-type=Nrqr2args r)r4z.sI  8O rs~~i8 rC=

z!Ambiguous repo type: got prefix 'z8/' in repo ID and explicit --type. Use one or the other.r)anyparamssetrTrQArgumentraaddr\is_flagrsecondary_optslenrqappendrCrREPO_TYPES_MAPPINGrtextend)r`rghas_type_optionrepo_id_positionsarg_idxr value_optionsoptpositional_countrepo_id_arg_indicesir inferred_type first_prefixrewrites arg_indexpartsprefix mapped_type new_values r)rrz)HFCliTyperGroup._rewrite_repo_type_prefixs"qfifpfpqq '*eZZ E%0::!@@%))'21    ! #&% ZZ +E%.u}}?UZZ?%*>*>?+C!%%c*+ +)+ #d)mq'Cd{~~c"#:M!9FAFA#'88'..q1 A% Q#d)m# %) #' *,, CIO))#q1E5zQ%()2N2N"N1XF#66v>K([M-I&&)J<.X`ag`hhk'lmm'M!L OOY58*AeAhZ(@A B C     ""3L>Ayz  %- ( Iy'DO ( X}-.r+r{ct|||}||S|jjD]"\}}tj |}||vs |cSyN)rOrWrMrcrurC)r^r?r{r`registered_nameregistered_cmdaliasesrfs r)rWzHFCliTyperGroup.get_command(sdg!#x0 ?J04}}/B/B/D & +O^"((9G7"%% &r+cpi}|jD]$}tj|}|d}|dd||<&|S)zBBuild a mapping from primary command name to its aliases (if any).rrN)rMrurC)r^resultrrprimarys r) _alias_mapzHFCliTyperGroup._alias_map5sI')#}} (O &&7EAhG#ABiF7O ( r+r@ci}|j}|j|D]}|j||}| |jr$|j |j }|j |g}|r|ddj|d}t|dd} |j| gj||f|jd5|j|ddddt|jD]G} | dk(r |j| jd5|j|| dddIy#1swYmxYw#1swY`xYw) NrKz [alias: rj]topicr:z Main commandsz commands)rrVrWrXrYwidthgetr6getattr setdefaultrsectionwrite_dlsortedkeys capitalize) r^r?r@topics alias_maprar` help_textrrs r)format_commandszHFCliTyperGroup.format_commands>si"$OO% &&s+ CD""3-C{cjj..Y__.EImmD"-G(k499W3E2FaH C&1E   eR ( / /y0A B C   / /   vf~ . /FKKM* 2E""e&6&6&8%9#CD 2""6%=1 2 2 2 / /  2 2sE3EEE( c<g}|j|D]G}|j||}| |jr$t|dg}|s4|j |dI|rt |}t |||y|jrt |j||yy)Nr,r)rVrWrXrrr9rFr>)r^r?r@ all_examplesrar` cmd_examplesr>s r) format_epilogzHFCliTyperGroup.format_epilogUs#% &&s+ 5D""3-C{cjj"3 B7L##LO4  5 $\2F $VS) < [[ $T[[#y Ar+cg}|jD]+}tj|d}|j|-t |S)Nr)rMrurCrr)r^r? primary_namesrars r)rVzHFCliTyperGroup.list_commandsgsJ#% MM *D"((.q1G   ) *m$$r+)__name__ __module__ __qualname____doc__r context_classrQContextrPliststrtuplers staticmethodCommandrrrWdictr HelpFormatterrrrV __classcell__rfs@r)rHrHqs* "M%--D>%,5==%,S %,e%,N^/u}}^/DI^/$^/^/@ u}}   PT@T Dd3i025==2U=P=P2UY2.BB5;N;NBSWB$%%49%r+rH))z&--format [auto|human|agent|json|quiet]zWOutput format. Defaults to 'auto' which picks 'agent' or 'human' based on the terminal.)--jsonz+JSON output. Equivalent to '--format json'.)z -q, --quietz?Quiet output (one ID per line). Equivalent to '--format quiet'.) --no-truncatezQDo not truncate scalar values in human tables (list/dict columns stay shortened). _FORMATTING_OPTIONS_HELP_RECORDScz|jd5|jtdddy#1swYyxYw)NzFormatting options)rrr)r@s r)"_format_formatting_options_sectionr{s5   / 0=;<===s1:r`c|jD]J}t|tjsg|j|j }d|vs d|vs d|vsd|vsJyy)aReturn True if the command defines its own --format, --json or --quiet / -q. Used to skip the global formatting flag pre-processor and the duplicated "Formatting options" help section for legacy commands like 'hf jobs ps' that have their own format/quiet options. --formatr--quiet-qTF)rrTrQr\rr)r`rrs r)_has_local_formatting_optionrsf %. 33e223  T!1Y$5F$RV,  r+rgc |jjdryt|}tj|d}d}d}|j D]O}t |tjsg|j|j}d|vrd}d|vsd|vrd}d|vsNd}Q|rt|| | ytj}d d td df fd } d } | t|kr|| } | dk(rn| dk(rJ| d| dzt|k\rtj dt#|| dz}d || | dz=h| j%dr*| dt#| tdd}d || | dz=| dk(r#| dtj&}d || | dz=| dvr#| | tj(}| || | dz=| dz } | t|krtj*|y)uJApply global formatting flags from 'args' to a leaf command. Two modes, depending on the command: * **Pass-through commands** (ignore_unknown_options=True, e.g. 'hf extensions exec'): args are forwarded verbatim to an external binary; we don't touch them. * **Legacy commands with a local --format option** (e.g. 'hf jobs ps' whose '--format' accepts Go templates): the global flags are rewritten in-place to the legacy form ('--json' → '--format json', '--quiet'/'-q' → '--format quiet' when the cmd has no own '--quiet') so click can parse them locally. This preserves backwards compatibility with the previous shorthand behavior. * **Modern commands** (no local format/quiet/json options): the flags '--format ' / '--json' / '--quiet' / '-q' are stripped from 'args' and applied to the singleton 'out'. '--no-truncate' is stripped for all non-pass-through commands; when present, human table cells are not truncated. Raises click.UsageError if multiple conflicting flags are supplied (e.g. '--json' together with '--format table'). ignore_unknown_optionsNFrTrrr) rewrite_json rewrite_quietnew_flagr$cBtjdd|dy)Nrlz' and 'z' are mutually exclusive.)rQrt)r chosen_flags r)_check_conflictz7_consume_format_flags_for_leaf.._check_conflicts1  """Q{m78*D]#^_ _ #r+rrrz#Option '--format' requires a value.r --format=)rr)context_settingsr_consume_no_truncate_flagsrset_no_truncaterrTrQr\rr_rewrite_legacy_shorthandsrautorrrt_parse_format_valuerqjsonquietset_mode) r`rg no_truncatehas_local_formathas_local_quiethas_local_jsonrr chosen_moderrrrs @r)rzrzs>$  89,T2K $ON "%. 33e223  #    "O t !N ""4.6H\kXkl)=(A(AK"K`#`$` A c$i-1g $;  *  J '1uD !&&'LMM-d1q5k:K$KQQY  >>+ & J '-c#k2B2D.EFK$KQQY  (? H %.33K"KQQY  # # C .44KKQQY  Q= c$i-@LLr+cd}d}|t|krW||}|dk(r |S|dk(r d}|||dz=+|jdrtjd|dz }|t|krW|S) zSStrip all global --no-truncate flags from args and return whether any was provided.FrrrTrz--no-truncate=z-Option '--no-truncate' does not take a value.)rrqrQrt)rgrrrs r)rrsK A c$i-1g $;   / !KQQY  >>* +""#RS S Q c$i- r+rrc0td|D}|r8d|vr4|rtjd|jd}ddg|||dzd}|rHd|vrdnd |vrd nd }|7|rtjd |d |j|}dd g|||dzy y y )aRewrite --json / -q / --quiet to --format ... for legacy commands. Used for commands like 'hf jobs ps' that still own their '--format' option. The rewrite lets users keep using the global shorthand while click parses '--format ' locally. c3LK|]}|dk(xs|jdyw)rrNrrs r)r4z-_rewrite_legacy_shorthands..s'^RUSJ.M#..2MM^s"$rz/'--json' and '--format' are mutually exclusive.rrrTrrNrlz(' and '--format' are mutually exclusive.r)rrQrtindex)rgrrhas_format_in_argsidxflags r)rrs^Y]^^D( ""#TU Ujj")62S37!t|tyD7H)d  !&&4&0X'YZZ**T"C#-w"7DsQw  r+valuerc t|S#t$r:djdtD}tjd|d|ddwxYw)Nrjc34K|]}|jywrrrms r)r4z&_parse_format_value..s@a!''@szInvalid value for '--format': 'z'. Valid values: ro)r ValueErrorr6rQrt)rvalids r)rrsam#E** m @+?@@!@GXY^X__`abhllms AAerrorlabelrcc|r|jd|d|jvry|jj}d|d|dg}|D]\}}|jd|dd ||jd |d t |t j rJ|jr>|jd d jt|jdg|_|xjdj|z c_y)zHAppend a list of available options or commands to a usage error message.Nz Available z forz Available z for 'z':z 30s z Run 'z --help' for full details.z Did you mean: rjrpr/) r?rx command_pathrrTrQrR possibilitiesr6r)r rrccmd_pathlinesrars r)rZrZs EII%:eWD)AU]])Ryy%%HeWF8*B 7 8E 2i r$s1YK012 LL78*$>?@%++,1D1D ' &9L9L2M(N'OqQR  MMTYYu%%Mr+fallback_handlerextra_commands_providerc.Gfddt}|S)zRReturn a Typer group class that runs a fallback handler before command resolution.ceZdZdejdeedeffd Zdejdejddffd Z xZ S)8fallback_typer_group_factory..FallbackTyperGroupr?rgr$c|t|jj}| t|t|||Sr)rrMr SystemExitrOrs)r^r?rgfallback_exit_coderfrs r)rszHfallback_typer_group_factory..FallbackTyperGroup.resolve_command1sF!1$DMM.FallbackTyperGroup.format_commands7sd G #C 3&213"**+?@4!**7344344s A  A) rrrrQrrrrrsrrr)rfrrs@r)FallbackTyperGroupr0sO 6u}} 6DI 6% 6  4u}} 4ATAT 4Y] 4 4r+r )rH)rrr s`` r)fallback_typer_group_factoryr!*s 4_ 4 r+rc dtjdtjdtjddfd}dtdtjdtjddfd}dtjdtjdt t dt t fd}td |jtft||xsg|||d S) Nr^r?r@r$c2t|j||yr)rFr>r^r?r@s r)rz#HFCliCommand..format_epilogCs c9=r+ctj|||t|ry|jj dryt |y)Nr)rformat_optionsrrrrr$s r)r&z$HFCliCommand..format_optionsFsA##D#y9 ( -   $ $%= > *95r+rgc|sg|js[td|jDr?tj|j |j |jtj|||S)Nc3lK|],}t|tjxr |j.ywr)rTrQrrequired)r2rds r)r4z3HFCliCommand..parse_args..Ts'UA:a0?QZZ?Us24)color) resilient_parsingrrrQechoget_helpr*exitr parse_args)r^r?rgs r)r/z HFCliCommand..parse_argsPsWC11UUU 3<<>; &&tS$77r+r)rrr,rr&r/) rQrrrrrrtyperr)rr,rr&r/s r) HFCliCommandr1Bs>EMM> >%J]J]>bf>6\6 6%J]J]6bf688U]]8$s)8PTUXPY8  u'')*+ * B*,$    r+c"eZdZdZ dddddddddddddd dedzd ed eedzd eeefdzd edzd edzdedzdede de de de dedzde e defge deffffdZ xZ S)HFCliAppz&Custom Typer app for Hugging Face CLI.Nr:z [OPTIONS]TF) rr,rr;r> short_helpoptions_metavaradd_help_optionno_args_is_helprX deprecatedrich_help_panelrarr,rr;r>r4r5r6r7rXr8r9r$.c   r tdtdtfdtdtff     fd }|S)Nfunc.r$c`tt t    |S)N) clsrr;r>r4r5r6r7rXr8r9)rOr3rSr1)r;rfr6rr8r>r,r;rXrar7r5r9r^r4rs r)_innerz HFCliApp.command.._innersQ40 1!1% / / /% /1   r+)r9rr )r^rarr,rr;r>r4r5r6r7rXr8r9r>rfs`````````````` r)rSzHFCliApp.commandjsM$ >h$X.F #s(+ c0B     r+r) rrrrrTOPIC_Trrr boolrrSrrs@r)r3r3gs0 % %)26!!%* $ % &*%Dj% % s)d" % sCx.4/ %Dj%d %$J%%%%%%t% 8CH%&c(:: ;!%%r+r3r;r=cF|t}t||dd|dddddddgd S) a+Create a Typer app with consistent settings. Args: help: Help text for the app. epilog: Optional epilog text (use `generate_epilog` to create one). cls: Optional Click group class to use (defaults to `HFCliTyperGroup`). Returns: A configured Typer app. NTFxz-hz--help)max_content_widthhelp_option_names) r;r>add_completionr7r=rich_markup_moder9pretty_exceptions_enablesuggest_commandsr)rHr3)r;r>r=s r) typer_factoryrIsJ {   !&"%"&!1  r+ceZdZdZdZdZy)RepoTypemodeldatasetspaceN)rrrrLrMrNr1r+r)rKrKs EG Er+rKzNThe ID of the repo (e.g. `username/repo-name` or `spaces/username/repo-name`).)r;rrz2The type of repository (model, dataset, or space).zJA User Access Token generated from https://huggingface.co/settings/tokens.zfWhether to create a private repo if repo doesn't exist on the Hub. Ignored if the repo already exists.zDGit revision id which can be a branch name, a tag, or a commit hash.zLimit the number of results.z!Filter by author or organization.zHFilter by tags (e.g. 'text-classification'). Can be used multiple times.z Search query.z-ez--envz/Set environment variables. E.g. --env ENV=valuez-sz --secretszvSet secret environment variables. E.g. --secrets SECRET=value or `--secrets HF_TOKEN` to pass your Hugging Face token.z --env-filez(Read in a file of environment variables.z/Read in a file of secret environment variables.cjddlm}tjj }|x}||d<|S)zQReturn a copy of ``os.environ`` with the user's HF token injected (if available).r) get_tokenHF_TOKEN)huggingface_hubrPosenvironcopy)rPextended_environr#s r)_get_extended_environrWs4)zz()',$ r+envenv_filect}i}|r3|jtt|j ||xsgD]}|jt|| |S)zParse ``-e``/``--env``/``-s``/``--secrets`` and ``--env-file``/``--secrets-file`` CLI args into a dict. Uses an extended environment that includes the user's HF token so that bare ``--secrets HF_TOKEN`` resolves correctly. )rT)rWupdaterr read_text)rXrYrVenv_map env_values r) parse_env_mapr_(sd-.%'G{4>#;#;#=GWXYYBI {96FGHI Nr+r]ch|sy|jDcgc]\}}||xsddc}}Scc}}w)z_Convert an env/secrets dict to the ``[{"key": ..., "value": ...}]`` format used by the Hub API.N)r~r)rc)r]kvs r)env_map_to_key_value_listrd:s/ 5<]]_ ETQAR ( EE Es.z-vz--volumeaVMount one or more volumes. Format: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE is one of: models, datasets, spaces, buckets. TYPE defaults to models if omitted. models, datasets and spaces are always mounted read-only. buckets are read+write by default. E.g. -v hf://org/m:/data or -v hf://datasets/org/ds:/data or -v hf://buckets/org/b:/mnt:rovolumeszlist[Volume] | Nonec L|syg}|D]}t|}|jt|jj|jj |j |j|jjxsd|jjxsd|S)a_Parse volume specs from CLI arguments. Format: hf://[TYPE/]SOURCE[/PATH]:/MOUNT_PATH[:ro|:rw] Where TYPE is one of: models, datasets, spaces, buckets (defaults to models if omitted). SOURCE is the repo/bucket identifier (e.g. 'username/my-model'). PATH is an optional subfolder inside the repo/bucket. MOUNT_PATH starts with '/'. Optional ':ro' or ':rw' suffix for read-only or read-write. Examples: hf://my-org/my-model:/data (model, implicit type) hf://models/my-org/my-model:/data (model, explicit type) hf://datasets/my-org/my-dataset:/data:ro hf://buckets/my-org/my-bucket:/mnt hf://spaces/my-org/my-space:/app hf://datasets/org/ds/train:/data (with path inside repo) hf://buckets/org/b/sub/dir:/mnt (with path inside bucket) N)r0source mount_path read_onlypathrevision) rrrrgr0idrhri path_in_repork)rerraw_specmounts r) parse_volumesrpOs& F  x( \\&&|| ++//\\..6$..6$      Mr+ceZdZdZdZdZy) OutputFormatz$Output format for CLI list commands.tablerN)rrrrrsrr1r+r)rrrrus. E Dr+rrzOutput format (table or json).c0tj||S)aLCallback for the legacy FormatWithAutoOpt option type. Most commands now rely on the global --format / --json / -q flags consumed by _consume_format_flags_for_leaf instead of declaring FormatWithAutoOpt themselves. This callback is kept for the rare cases where a command still wires FormatWithAutoOpt explicitly. )rrr s r)_set_output_moderusLL Lr+zOutput format.)r;callbackrrzPrint only IDs (one per line).racPtjdd|}|jS)z\Convert a camelCase or PascalCase string to SCREAMING_SNAKE_CASE to be used as table header.z([a-z])([A-Z])z\1_\2)rerbupper)rass r) _to_headerr{s!  (D1A 779r+c|syt|tr|rdSdSt|tjr|jdSt|trt j d|r|ddSt|trdjd|DSt|tr'd |vrt |d Stj|St |S) z/Convert a value to string for terminal display.rau✔z%Y-%m-%dz^\d{4}-\d{2}-\d{2}TN rjc32K|]}t|ywr) _format_value)r2rcs r)r4z _format_value..s9aq)9sra) rTr@datetimestrftimerrxmatchrr6rrdumpsr s r)rrs %u%2%%**+~~j))%"((+A5"ISbz%yy95999 E4 U?uV}% %zz%  u:r+max_lencNt|}t||kDr |d|dz dz}|S)z/Format a value + truncate it for table display.Nrz...)rr)rrcells r) _format_cellrs2  D 4y7Mgk"U* Kr+headersrow_fn alignmentsc ||s tdytttttt f|Dcgc] }|| c}}|Dcgc] }t |}}|xsijD cic]\}} t || } }} tt||| ycc}wcc}wcc} }w)aiPrint items as a formatted table. Args: items: Sequence of dictionaries representing the items to display. headers: List of column headers. row_fn: Function that takes an item dict and returns a list of string values for each column. alignments: Optional mapping of header name to "left" or "right". Defaults to "left". zNo results found.N)rr) printr rr rintr{rcr) rcrrritemrowshscreaming_headersrbrcscreaming_alignmentss r)print_as_tablers  !" T%S/*+u-MtfTl-M ND0781A88:D:J9Q9Q9STAJqM1,TT (4!2?S TU .N8TsB. B3=B8formatrid_keyc |r|D]}t||y|tjk(r/ttjt |dt yG|rt |dj n|g}|D cgc] t fd|Ds c} |&dtt tfdtt ffd }t||| ycc} w) aPPrint list command output in the specified format. Args: items: Sequence of dictionaries representing the items to display. format: Output format. quiet: If True, print only IDs (one per line). id_key: Key to use for extracting IDs in quiet mode. headers: Optional list of column names for headers. If not provided, auto-detected from keys. row_fn: Optional function to extract row values. If not provided, uses _format_cell on each column. alignments: Optional mapping of header name to "left" or "right". Defaults to "left". Nr)indentdefaultrc3RK|]}t|j ywrrr)r2rcols r)r4z$print_list_output..s4cUY\$((3-5P4cs$'rr$c^Dcgc]}t|j|c}Scc}wrr)rrrs r)rz!print_list_output..row_fns$;BCCL#/C CCs!*)rrr) rrrrrrrrrrr r) rcrrrrrrr all_columnsrs ` `r)print_list_outputrs(  D $v,   """ djjeQ<=/4d58==?+6( "-d34c]b4c1c3d ~ Dc3h DDI D5'&ZPes CCrccBt|tjr|jSt|tr0|j Dcic]\}}| |t |c}}St|t r|Dcgc] }t |c}S|Scc}}wcc}w)z4Recursively serialize a value to be JSON-compatible.)rTr isoformatrrc_serialize_valuer)rcr~valrs r)rrs!X&&'{{} At ;<779XxsC%c**XX At 3454 &55 HY5s BB?Binfoctj|jDcic]\}}| |t|c}}Scc}}w)z9Convert repo info dataclasses to json-serializable dicts.) dataclassesasdictrcr)rrbrcs r)api_object_to_dictrs?/:/A/A$/G/M/M/O atq!STS`A" " aa as AAvalid_propertiescFdtdzdttdzffd }|S)zJCreate a callback to parse and validate comma-separated expand properties.rNr$c |y|jdDcgc]}|j}}|D]0}|vstjd|ddj |Dcgc]}t t |c}Scc}wcc}w)N,zInvalid expand property: 'z'. Valid values are: rj)rCstriptyper BadParameterr6r r<)rrd propertiesproprs r)_parse_expand_propertiesz?make_expand_properties_parser.._parse_expand_propertiess =).S)9:Aaggi: : D++((06KDIIVfLgKhi  9CC_d+CC ; Ds B*B )rrr<)rrs` r)make_expand_properties_parserr s/ Dd DtO7Lt7S D $#r+library)rR transformersch t|y#t$rtjddYywxYw)a Check whether a newer version of a library is available on PyPI. If a newer version is found, print a hint pointing at `hf update`. If current version is a pre-release (e.g. `1.0.0.rc1`), or a dev version (e.g. `1.0.0.dev1`), no check is performed. If `HF_HUB_DISABLE_UPDATE_CHECK` is set, the check is skipped entirely. This function is called at the entry point of the CLI. It only performs the check once every 24 hours, and any error during the check is caught and logged, to avoid breaking the CLI. Args: library: The library to check for updates. Currently supports "huggingface_hub" and "transformers". z$Error while checking for CLI update.Texc_infoN)_check_cli_update Exceptionloggerdebug)rs r)check_cli_updater!s2L'" L ;d KLs  11cPtjrytjj |t fddDryt jjtjrHt jjtj}tj|z dkryttjjjddttjj|dk(rt!dk(r t#}n t%|}||k(ry|dk(r t'}n t)}d|d |d d }|#|dk(r|d z }n |d dj+|z }t-j.|y)Nc3&K|]}|v ywrr1)r2tagcurrent_versions r)r4z$_check_cli_update..>s ;c3/ ! ;s)rcdeviQT)parentsexist_okrRbrewzA new version of z (z&) is available! You are using version roz To update, run: hf updatez To update, run: r)rHF_HUB_DISABLE_UPDATE_CHECK importlibmetadataversionrrSrjexistsCHECK_FOR_UPDATE_DONE_PATHgetmtimetimerparentmkdirtouchr_fetch_latest_brew_version_fetch_latest_pypi_version#_get_huggingface_hub_update_command _get_transformers_update_commandr6rhint)rmtimelatest_versionupdate_commandrxrs @r)rr7sp,,((009O ;] ;; ww~~i::;  !E!EF IIK% 9 ,   - -.55;;DSW;X - -.446##(;(=(G353G<N!B##<>9;!'"^,< A! A!cZt}| tdtj|S)zRun the install-method-appropriate update command for the `hf` CLI. Raises CLIError if the installation method can't be determined. Returns the subprocess exit code on success/failure of the update itself. zeCannot determine how to update huggingface_hub (unknown installation method). Please update manually.)rr subprocesscall)r`s r) run_updaterxs2 . /C { s   ??3 r+ctxdk(rgdSxdk(rtjdk(rgdSxdk(rgdSdk(rtjddd d d gS y ) zlReturn the command to update huggingface_hub as an argv list, or None if the installation method is unknown.r)rupgradehf hf_installernt) powershell -NoProfile-Commandz-iwr -useb https://hf.co/cli/install.ps1 | iex)bash-cz0curl -LsSf https://hf.co/cli/install.sh | bash -pip-minstall-UrRNrrSrasys executabler1r+r)rrsP   , , rww$^l l U U NND%DBST T r+ctxdk(rtjdk(rgdSxdk(rgdSdk(rtjddddd gS y ) ziReturn the command to update transformers as an argv list, or None if the installation method is unknown.rr)rrrz?iwr -useb https://hf.co/cli/install.ps1 | iex -WithTransformers)rrzHcurl -LsSf https://hf.co/cli/install.sh | bash -s -- --with-transformersrrrrrNrr1r+r)rrsL   rww$^  m m NND%D.Q Q r+r)NN)rlNNN)rrrrvimportlib.metadatarrrSrxrrrcollections.abcrrenumrpathlibrtypingrrr r r r r rQr typer.corerrrRrrrhuggingface_hub.errorsrhuggingface_hub.utilsrrrrrrhuggingface_hub.utils._dotenvr_help_formatterr_outputrr get_loggerr_MAX_CELL_LENGTHREPO_LIST_DEFAULT_LIMITr(r"rr*r5rr9r?rrFallbackHandlerTr<rrrFcompilerurHrr__annotations__rrr@rrzrrrrtrZr0r!r1Typerr3rIrKr RepoIdArgr\ RepoTypeOptTokenOpt PrivateOpt RevisionOptLimitOpt AuthorOpt FilterOpt SearchOptEnvOpt SecretsOpt EnvFileOptSecretsFileOptrrWr_rd VolumesOptrprr FormatOptruFormatWithAutoOptQuietOptr{rrrrobjectrrrrrrrrrrr1r+r)rs1  .OOO /::+6*.    ,[cDj[G[Pd3icDjC, . !C 'T#YC13:=>+37'S4Z'emm'PUPcPc'hl'rzz+& |%j|%~; $uS#X"7=%2E2E=$= emm  V VT#YV4VrT#Y4$8T#Y88VZ8_c82msm'=m &u// & &DsTWxDY &^b &"KO&%b$uS#X*?&?@4G /0""49t+;"tLGY"J(u{{(V  S4Z T*=MPT=T `j FsD ENN ]   ELL A  $JELL Y 4KELL u $JELL S  ELL457  $JELL9:<  IELL`ac  $JELLo&(   IELL  > IELL  H   $JELL 7 $JELL >tCH~! cT Dj #sTz/$FtCtO'<Fd3PS8nAUX\A\FIELL e   #49t+#0E#L3 ELL -  05IELL&1ABD ELLy'GHJ  SS (-=c)- V DcN #V #YV d38n%tCy0 1VS#X% V  V8 $;?(,&Q DcN #&Q &Q &Q  &Q #Y  &Q d38n%tCy0 1D 8 &QS#X%&Q &QR  6 bSbT#s(^b $H_4M$(Lg&GHLTL,(w'HI(d(Vd C$J  C   T#Y-= $s)d*:r+