rPj<,dZddlZddlZddlZddlZddlZddlZddlmZddl m Z ddl m Z ddl mZmZddlZddlmZddlmZdd lmZdd lmZmZmZmZmZmZGd d ee Zd ededdfdZ GddZ!e dededefdZ"de#de#fdZ$dede%eeffdZ&ejNdZ(dedefdZ)dedefdZ*dedefdZ+dedefd Z,d!e-ed"e-e-ede%eeffd#Z.d$edefd%Z/d!e-ed"e-e-ed&e0de0fd'Z1d$edefd(Z2e!Z3y))z"Output framework for the `hf` CLI.N)Sequence)Enum)cache)Anycast) constants)ConfirmationError)CardData)ANSI StatusLinedisable_progress_barsenable_progress_barsis_agenttabulatec$eZdZdZdZdZdZdZdZy) OutputFormatzGOutput format for CLI commands with auto detection of agent/human mode.agentautohumanjsonquietN) __name__ __module__ __qualname____doc__rrrrr`/home/oem/CyberBrain26-unified/.venv/lib/python3.12/site-packages/huggingface_hub/cli/_output.pyrr#sQ E D E D Errvalueskwargsreturnc"t|i|ddiy)zLike `print`, but always flushed: some CLI flows block on user action right after printing (e.g. the device-code login), so output must not stay buffered.flushTN)print)rr s r _print_flushr%-s 6(V(4(rc eZdZUdZeed<eed<d&dZejfdeddfdZ deddfdZ defd Z d'ddd d e dzd e dzd e dzddfdZ dddddeee efdee dzde dzdee e fdzddf dZdddede dzddfdZde deddfdZddddde dedede ddf d Zd'de dzdefd!Zde ddfd"Zde ddfd#Zde ddfd$Zde ddfd%Zy)(OutputzOutput sink for the `hf` CLI. Mode is resolved once at init time based on `is_agent()` auto-detection and can be overridden per-command via `set_mode()`. mode no_truncater!Nc2d|_|jy)NF)r)set_modeselfs r__init__zOutput.__init__=s  rc,|tjk(r*trtjntj}||_|tjk(}t j|tj|r tytyy)zPOverride the output mode (called once at startup and again per '--format' flag).N) rrrrrr(r set_enabledrHF_HUB_DISABLE_PROGRESS_BARSrr )r-r(is_humans rr+zOutput.set_modeAsl <$$ $)1<%%9K9KD <--- "  1 1 9$&%' :rc||_y)z2Toggle off cell truncation for human table output.Nr))r-r)s rset_no_truncatezOutput.set_no_truncateNs &rc<|jtjk(SN)r(rrr,s ris_quietzOutput.is_quietRsyyL....r)rrmsgrrc||| td|}t|}|jxtjk(r| t |yytj k(r| t |yyy)z)Print a free-form text message to stdout.Nz&Cannot mix 'msg' with 'human'/'agent'.) ValueError _strip_ansir(rrr%r)r-r9rrs rtextz Output.textUss ? E$5 !IJJE$Eii###$ '%##$ '%$r)headersid_key alignmentsitemsr>r?r@c |sc|jxxtjk(rnxtjk(rnnt dytj k(r t dyy|At |dj}|Dcgc]tfd|Ds}}|Dcgc]!}|Dcgc]}|j|c}#} }}|jxtjk(r|Dcgc] }t|} }| D cgc]} | D cgc] } t| c} } } } t| | |j}it|| |xsi}|jD cic]\}} t|| }}} t t!t#d| | ||r|j%d yyxtjk(rDt d j'|| D]#} t d j'd | D%yxtj k(r/t t j(t |t* ytj,k(r>|xs|d}|D]/}t t/t+|j|d 1yycc}wcc}wcc}}wcc}wcc} wcc} } wcc} }w)aPrint tabular data to stdout. Args: items: List of dicts. Headers are auto-detected from keys if not provided. headers: Explicit column names. If None, derived from dict keys (all-None columns filtered). id_key: Key to print in quiet mode. If None, uses the first header. alignments: Optional mapping of header name to "left" or "right". Defaults to "left". zNo results found.z[]Nrc3DK|]}|jduywr7)get).0itemcols r zOutput.table..s8eW[#d9R8es r4zlist[list[str | int]])r>r@z>Use `--no-truncate` or `--format json` to display full values. c32K|]}t|ywr7)_format_table_cell_agentrEvs rrHzOutput.table..s*T1+CA+F*Tdefault)r(rrrr%rlistkeysanyrD _to_header_format_table_value_human_truncate_columnsr)_infer_alignmentsrArrhintjoindumpsstrr_escape_control_chars)r-rAr>r?r@ all_columnsrGrFhrowsscreaming_headersrowrMformatted_rows is_truncatedinferredkscreaming_alignments quiet_keys ` rtablez Output.tablefsc ))<'\''*<,*<*<< !45 "&& &  ?uQx}}/K&1fsS8e_d8e5esfGf;@A4g.!.AAii###U:CSQSUEM^^EU'VTQ 1 q(8'V$'V4nE 1#7 II^_ ###TYYw/0VC *TPS*T!TUV"""TZZU SAB##"0gaj !VD !6s488Ir;R7S!TUV$7g.A%E3^2o (WsH J/$J// J98J4 J9;J? K K /K 6K4J9K )r?datacftj|rt|ts t |}|j t jk(r|t|j|dy|j t jk(rdnd}ttj||ty)zPrint structured data as JSON in all modes (indented for human, compact otherwise). Accepts a dict or a dataclass. NrQ)indentrP) dataclasses is_dataclass isinstancetype_dataclass_to_dictr(rrr%rDrrr[r\)r-rjr?rms rdictz Output.dicts  # #D )*T42H%d+D 99 ** *v/A &"- . ii<#5#554TZZVSABrmessagec |jxtjk(rstjt ddd|g}|j D]\}}| |jd|d|!tdj|yxtjk(rO|j Dcgc]\}}| |d|}}}t|rdj|y|yxtjk(r/t|r tj|t yd ytjk(r+t|j!}|rt|d yyycc}}w) z"Print a success summary to stdout.u✓z[OK] Nz z:  =rOrQr)r(rrr green _ascii_saferAappendr%rZrrr[r\rrRr)r-rtrjpartsrfrMrs rresultz Output.results+ii###{5&'A&B!G9$MNO JJL4DAq} r!Bqc]34TYYu-.###04 N1 A3asNNSXXe_C7C"""dTZZc:KK##dkkm, +$ Os 9 E4 E4Fz--yes)rPyes confirm_paramrPr~rc|ry|jtjk7rt|d|dt j ||dy)zV Ask for confirmation. Raises `ConfirmationError` in non-human modes. Nz Use z to skip confirmation.T)rPabort)r(rrr clickconfirm)r-rtrPr~rs rrzOutput.confirmsE   99 ** *#wiu]OCY$Z[ [ gwd;rczt|jtjk(}||j ||S)zEReturn a status line that emits only in human mode (no-op otherwise).)enabled)r r(rrupdate)r-rtstatuss rrz Output.statuss2DII1C1C$CD   MM' " rc|jtjk(r2tt j d|t jytd|t jy)z0Print a non-fatal warning to stderr (all modes).z Warning: fileN)r(rrr%r yellowsysstderrr-rts rwarningzOutput.warningsG 99 ** * y %:;#** M 9WI.SZZ @rc|jtjk(r2tt j d|t jytd|t jy)z%Print an error to stderr (all modes).zError: rN)r(rrr%r redrrrs rerrorz Output.errorsG 99 ** * GG9"56SZZ H 77),3:: >rc|jtjk(ry|jtjk(r/t t j |tjyt |tjy)aPrint a text message to stderr (human: gray, json/agent: plain text). Suppressed in quiet mode. Kept in json mode (like agent) since agents commonly run with ``--format json`` and the message goes to stderr so it never pollutes the parsed stdout. Nr) r(rrrr%r grayrrrs rlogz Output.logsP 99 ** *  99 ** * 7+#** = szz 2rc,|jd|y)a:Print a helpful hint to stderr (human: gray, json/agent: plain text). Suppressed in quiet mode. Kept in json mode (like agent) since agents commonly run with ``--format json`` and the next-command hints are useful there; hints go to stderr so they never pollute the parsed stdout. zHint: N)rrs rrYz Output.hints 6'#$r)r!Nr7)rrrrr__annotations__boolr.rr+r5r8r\r=rrsrrRrir}rr rrrrrYrrrr'r'3s -9,=,= (\ ($ ('4'D'/$/($\`(d (S4Z(sUYz(ei(*%)!,0 8VS#X'8VcT! 8V d 8V cNT) 8V 8Vt7; C Ct Ct C,c,3,4,&8=%fm.,s'Iq 1T!WQr]:Is*,)rZrs rr]r]*s 77IDI IIrcRtdj|jS)Nrv)r]rZsplitrs r _single_liner/s $**,!7 88rrcPtjdd|}|jS)zAConvert a camelCase or PascalCase string to SCREAMING_SNAKE_CASE.z([a-z])([A-Z])z\1_\2)rerupper)rss rrUrU3s!  (D1A 779rr>r`cfi}t|D]\}tfd|Dsd||<!|S)zNReturn ``{"col": "right"}`` for columns where every non-None value is numeric.c3K|]<}|duxs/t|ttfxrt|t >ywr7)rpintfloatr)rErbrs rrHz$_infer_alignments..=sHuils1v~d*SVc5\"B"c:VYZ[V\^bKcGcdusAAright) enumerateall)r>r`r}r_rs @rrXrX9s?F'" 1 uptu uF1I  Mrrc4|yt|tr|r tddSdSt|tjr|j dSt|t rt jd|r|ddSt|t r t|St|trdjd |DSt|tr9d |vrtt |d Sttj|Stt |S) z/Convert a value to string for terminal display.NrQu✔r~z%Y-%m-%dz^\d{4}-\d{2}-\d{2}T z, c32K|]}t|ywr7)rVrLs rrHz,_format_table_value_human..OsE!215ErNr)rprrzrstrftimer\rsearchrrRrZrsrr[rs rrVrVBs }%,1{5%(9r9%**+~~j))%")),BE"JSbz%E""%yyEuEEE E4 U?E&M 23 3DJJu-.. E ##rr)c  |ssyt|}t|Dcgc]6tt|gfdttD8}}tjj td|dz z }t ||kry|j |Dcgc]}tt|dc} t |kDrEt fdt D fdd }|dkrn |xxdzcc<t |kDrEd} D]:} t| D]*\} t|  kDsd } | d d z d z| <,<| Scc}wcc}w)aTruncate cells in-place to fit the current terminal width. Returns `True` if any cell was truncated, so the caller can emit a hint. `shutil.get_terminal_size` is cross-platform: it honors `$COLUMNS`, then queries the OS-native API, then falls back to `(80, 24)`. Fc3@K|]}t|ywr7)len)rErrr`s rrHz$_truncate_columns..hs%P!c$q'!*o%Psrrc3:K|]\}}||kDs|ywr7r)rEiw min_widthss rrHz$_truncate_columns..vs @41aa*Q-.?Q @sc|Sr7r)rcapss rz#_truncate_columns..ws $q'rr)rrPTNz...) rrangemaxshutilget_terminal_sizecolumnssumcopyr)r>r`r)nrnaturalbudgetr_widest truncatedrbcellrrs ` ` @@rrWrWWsn$ G A[`ab[cdVWs3wqz?Q%PuSY?O%PQdGd % % ' / /#aQ- ?F 7|v <<>D*12Q#c!fa.2J d)f  @9T? @!  A:  V   d)f I5 ~ 5GAt4y47" mQ! ,u4A 55 9e3s ;E&1E+c~t|tjr|jStt |S)zHFormat a cell value for agent TSV output (ISO timestamps, tabs escaped).)rprrrr\rs rrKrKs.%**+  E ##r)4rrnrrrrrcollections.abcrenumr functoolsrtypingrrrhuggingface_hubrhuggingface_hub.errorsr huggingface_hub.repocard_datar huggingface_hub.utilsr r r rrrr\rr%r'rzobjectrrsrrcompilerr<r]rrUrRrXrVrrWrKoutrrrrs) $ %42ss3)#))) A%A%NcSS"  6  NS NT#s(^ N 2::' ("c"c"JJJ 9s9s9SS tCyT#YDcN$S$S$*- #Y- tCy/- -  -`$C$C$ hr