gj4dZddlZddlZddlZddlZddlZddlZddlmZddl m Z ddl m Z m Z ddlZddlmZddlmZmZmZmZmZGdd ee Zd e d e d dfd ZGddZded efdZde d eee ffdZejdZ ded efdZ!ded efdZ"ded efdZ#de$ede$e$e d eeeffdZ%de d efdZ&de$ede$e$ede'd e'fd Z(de d efd!Z)eZ*dS)"z"Output framework for the `hf` CLI.N)Sequence)Enum)Anycast)ConfirmationError)ANSI StatusLinedisable_progress_barsis_agenttabulatec&eZdZdZdZdZdZdZdZdS) OutputFormatzGOutput format for CLI commands with auto detection of agent/human mode.agentautohumanjsonquietN) __name__ __module__ __qualname____doc__rrrrr_/var/www/app.qaans.com/backend/venv/lib/python3.11/site-packages/huggingface_hub/cli/_output.pyrr s-QQ E D E D EEErrvalueskwargsreturnc&t|i|ddidS)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)rrs 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$ZdS)'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_truncaterNc<d|_|dS)NF)r%set_modeselfs r__init__zOutput.__init__:s  rc|tjkr&tr tjn tj}||_|tjkrt dSdS)zPOverride the output mode (called once at startup and again per '--format' flag).N)rrr rrr$r )r)r$s rr'zOutput.set_mode>sX <$ $ $)1K<%%9KD <% % % ! # # # # # & %rc||_dS)z2Toggle off cell truncation for human table output.Nr%)r)r%s rset_no_truncatezOutput.set_no_truncateFs&rc,|jtjkSN)r$rrr(s ris_quietzOutput.is_quietJsyL...r)rrmsgrrc|$||td|}t|}|jxtjkr|t |dSdStjkr|t |dSdSdS)z)Print a free-form text message to stdout.Nz&Cannot mix 'msg' with 'human'/'agent'.) ValueError _strip_ansir$rrr!r)r)r2rrs rtextz Output.textMs ? E$5 !IJJJE$$Ei#####$ '''''%$###$ '''''%$$#r)headersid_key alignmentsitemsr7r8r9cs]|jxxtjkrnxtjkrnnt dntjkrt ddS5t d}fd|DfdD}|jxtjkrdD}d|D}t|||j } it||pi} d | D} t ttd ||| | r|d dSdSxtjkrVt d|D].} t dd| D/dSxtjkr8t t jt t"dStjkr4|pd} D]%}t || d&dSdS)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[]NrcLg|]tfdD S)c3FK|]}|duVdSr0get).0itemcols r z*Output.table...xs38e8eW[#d9R8e8e8e8e8e8er)any)r@rBr:s @r z Output.table..xs=fffsS8e8e8e8e_d8e8e8e5e5efsfffrc.g|]fdDS)c:g|]}|Srr>)r@hrAs rrEz+Output.table...ys#...!...rr)r@rAr7s @rrEz Output.table..ys/AAA4....g...AAArc,g|]}t|Sr _to_headerr@rHs rrEz Output.table..}s$D$D$DqZ]]$D$D$Drc&g|]}d|DS)c,g|]}t|Sr_format_table_value_humanr@vs rrEz+Output.table...~s"3^3^3^UV4Ma4P4P3^3^3^rr)r@rows rrEz Output.table..~s)2o2o2ocf3^3^Z]3^3^3^2o2o2orr-c4i|]\}}t||SrrJr@krRs r z Output.table..s$'V'V'VTQ 1 q'V'V'Vrzlist[list[str | int]])r7r9z>Use `--no-truncate` or `--format json` to display full values. c34K|]}t|VdSr0)_format_table_cell_agentrQs rrCzOutput.table..s+*T*T1+CA+F+F*T*T*T*T*T*Trdefault)r$rrrr!rlistkeys_truncate_columnsr%_infer_alignmentsr:r rhintjoindumpsstrrr?)r)r:r7r8r9 all_columnsrowsscreaming_headersformatted_rows is_truncatedinferredscreaming_alignmentsrS quiet_keyrAs `` rtablez Output.table^s  )<'\''''*<,*<*<*<*<*<*<*<*< !45555!&&& &&& F ?uQx}}//KffffkfffGAAAA5AAAi#####$D$DG$D$D$D!2o2ojn2o2o2o01BN`d`pqqq U/>>U:CSQSU'V'VX^^EUEU'V'V'V$4nEE 1#7 `II^_____``#####TYYw//000VVC *T*TPS*T*T*T!T!TUUUUVV"""""TZU SAAABBBBB###"0gaj !::D )R!8!89999::$#r)r8datacrtj|r$t|tst |}|jt jkr'|%t| |ddS|jt j krdnd}ttj ||tdS)zPrint structured data as JSON in all modes (indented for human, compact otherwise). Accepts a dict or a dataclass. Nr])indentr\) dataclasses is_dataclass isinstancetype_dataclass_to_dictr$rrr!r?rrrdre)r)ror8rrs rdictz Output.dicts  #D ) ) ,*T42H2H ,%d++D 9 * * *v/A &"-- . . . Fi<#5554TZVSAAABBBBBrmessagec |jxtjkrttjd|g}|D]"\}}||d|d|#td|dSxtj krGd|D}t|rd|n|dSxtj kr/t|rtj |tnd dStj kr.s'NNN1 A r r[r]r)r$rrrgreenr:appendr!rcrrrdrerr^r)r)ryropartsrVrRrs rresultz Output.resultsvi#####$47$4$4556 JJLL44DAq} ]!]]q]]333TYYu--.....#####NN NNNBSXXe___7CCCCC"""""dJTZc::::KKKKK###dkkmm,,, +++++,,$#rFz--yes)r\yes confirm_paramr\rrc|rdS|jtjkrt|d|dt j||ddS)zV Ask for confirmation. Raises `ConfirmationError` in non-human modes. Nz Use z to skip confirmation.T)r\abort)r$rrrtyperconfirm)r)ryr\rrs rrzOutput.confirms]   F 9 * * *#w$Z$Z]$Z$Z$Z[[ [ gwd;;;;;;rczt|jtjk}||||S)zEReturn a status line that emits only in human mode (no-op otherwise).)enabled)r r$rrupdate)r)rystatuss rrz Output.statuss9DI1C$CDDD   MM' " " " rc|jtjkr2tt jd|t jdStd|t jdS)z0Print a non-fatal warning to stderr (all modes).z Warning: fileN)r$rrr!ryellowsysstderrr)rys rwarningzOutput.warningsd 9 * * * %:%:%:;;#* M M M M M M .W..SZ @ @ @ @ @ @rc|jtjkr2tt jd|t jdStd|t jdS)z%Print an error to stderr (all modes).zError: rN)r$rrr!rredrrrs rerrorz Output.errorsd 9 * * * "5G"5"566SZ H H H H H H ,7,,3: > > > > > >rc|jtjkrdS|jtjkr2t t jd|tjdSt d|tjdS)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. NzHint: r) r$rrrr!rgrayrrrs rrbz Output.hints{ 9 * * * F 9 * * * #5G#5#566SZ H H H H H H +'++#* = = = = = =r)rNr0)rrrrr__annotations__boolr*rr'r.r1rer6rrxrr^rnrrr rrrrbrrrr#r#0s -9,=$$\$$$$$$'4'D''''/$////($\`(((d (S4Z(sUYz(ei((((*%)!,0 8:8:8:S#X'8:cT! 8: d 8: cNT) 8: 8:8:8:8:t7; C C C Ct Ct C C C C,c,3,4,,,,&8=%fm<<C >D > > > > > >rr#rRc t|tjr|St|trd|DSt|t r d|DS|S)z4Recursively serialize a value to be JSON-compatible.c8i|]\}}||t|Sr0_serialize_value)r@keyvals rrWz$_serialize_value..s(XXXxsC%c**rc,g|]}t|Srr)r@rAs rrEz$_serialize_value..s!5554 &&555r)rudatetime isoformatrxr:r^)rRs rrrs~!X&''6{{}} At  6XX17799XXXX At  65515555 Hrinfocbdtj|DS)z0Convert a dataclass to a json-serializable dict.c8i|]\}}||t|Sr0rrUs rrWz&_dataclass_to_dict..s- a a atq!STS`A""S`S`S`r)rsasdictr:)rs rrwrws- a a{/A$/G/G/M/M/O/O a a aarz\033\[[0-9;]*mr6c8td|S)Nr])_ANSI_REsubr6s rr5r5s <<D ! !!rcPd|S)Nr~)rcsplitrs r _single_liners 88DJJLL ! !!rnamecVtjdd|}|S)zAConvert a camelCase or PascalCase string to SCREAMING_SNAKE_CASE.z([a-z])([A-Z])z\1_\2)rerupper)rss rrKrKs$  (D11A 7799rr7rgcvi}t|D]%\}tfd|Drd||<&|S)zNReturn ``{"col": "right"}`` for columns where every non-None value is numeric.c3K|]L}|dup=t|ttfot|t VMdSr0)ruintfloatr)r@rScs rrCz$_infer_alignments..s]uuils1v~d*SVc5\"B"B"c:VYZ[V\^bKcKcGcuuuuuurright) enumerateall)r7rgrrHrs @rrara sXF'""  1 uuuuptuuu u u F1I Mrvaluec|dSt|tr|rdndSt|tjr|dSt|trt jd|r |ddSt|trt|St|trd d|DSt|trGd |vr"tt |d Sttj |Stt |S) z/Convert a value to string for terminal display.Nr]u✔z%Y-%m-%dz^\d{4}-\d{2}-\d{2}T z, c34K|]}t|VdSr0rOrQs rrCz,_format_table_value_human.. s+EE!2155EEEEEErr) rurrstrftimerermatchrr^rcrxrrdrs rrPrPs< }r%&%uu2%%*++*~~j)))%"(+A5"I"ISbSz%#E"""%/yyEEuEEEEEE E4 / U??E&M 2 233 3DJu--... E # ##rr%c |ssdSt}fdt|D}tjjt d|dz z }t ||krdS| dD t |krXt fdt D fdd }|dkrn# |xxdzcc<t |kXd}D]K}t|D]9\} } t|  | krd }| d | d z d z|| <:L|S)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)`. Fc g|]IttgfdttDRJS)c3NK|]}t|V dSr0)len)r@rrrgs rrCz/_truncate_columns...9s1%P%P!c$q'!*oo%P%P%P%P%P%Pr)maxrrange)r@rr7rgs @rrEz%_truncate_columns..9s[dddVWs3wqz??Q%P%P%P%P%PuSYY?O?O%P%P%PQQQdddrrcHg|]}tt|d S))rrrLs rrEz%_truncate_columns..Ds&222Q#c!ffa..222rc3:K|]\}}||k|VdSr0r)r@iw min_widthss rrCz$_truncate_columns..Gs5 @ @41aa*Q-.?.?Q.?.?.?.? @ @rc|Sr0r)rcapss rz#_truncate_columns..Hs $q'r)rr\TNz...) rrshutilget_terminal_sizecolumnsrsumcopyr) r7rgr%nnaturalbudgetwidest truncatedrSrcellrrs `` @@rr`r`(s$u G Addddd[`ab[c[cdddG % ' ' /#aQ-- ?F 7||vu <<>>D22'222J d))f   @ @ @ @9T?? @ @ @!!!!    A::  V   d))f  I55 ~~ 5 5GAt4yy47"" mQ! m,u4A 5 rct|tjr|Stt |S)zHFormat a cell value for agent TSV output (ISO timestamps, tabs escaped).)rurrrrers rrZrZXs;%*++!   E # ##r)+rrsrrrrrcollections.abcrenumrtypingrrrhuggingface_hub.errorsrhuggingface_hub.utilsrr r r r rerr!r#objectrrxrwcompilerr5rrKr^rarPrr`rZoutrrrrs)( $$$$$$ 444444]]]]]]]]]]]]]]3)#)))))) s>s>s>s>s>s>s>s>r  6    bSbT#s(^bbbb 2:' ( ("c"c"""""s"s""""SS tCyT#YDcN$S$S$$$$*- #Y- tCy/- -  ----`$C$C$$$$ fhhr