i>e *ddlZddlZddlmZddlmZddlmZmZm Z m Z ddl m Z ddl mZer4ddlmZddlmZmZmZdd lmZdd lmZdd lmZdd lmZdd lmZddlm Z GddZ!GddZ"GddZ#GddZ$eGddZ%e%e$ddddZ&e%e!ddd Z'e%e#d!dd"#Z(d$d%d&d'd(e)d)d*e*e%d+ffd,Z+d$d%d&d'd(e)d)d*e*e%d+ffd-Z,eGd.d/Z-eGd0d1Z.y)2N)Iterable) attrgetter) TYPE_CHECKINGLiteralOptionalUnionevolve)frozen)Box)ConsoleConsoleOptionsRenderableType)PaddingDimensionsPanel) StyleTypeTable) HelpEntry)Rendererc,eZdZdZddedzfdZddZy) NameRendererzRenderer for parameter/command names with optional text wrapping. Parameters ---------- max_width : int | None Maximum width for wrapping. If None, no wrapping is applied. N max_widthc||_yzInitialize the renderer with formatting options. Parameters ---------- max_width : int | None Maximum width for wrapping. If None, no wrapping is applied. Nrselfrs y/home/jay/workspace/.worktrees/task-2116-dev1/scripts/.codegraph-venv/lib/python3.12/site-packages/cyclopts/help/specs.py__init__zNameRenderer.__init__ #cdj|j}|j|Stj||jddd}dj|S)azRender the names column with optional text wrapping. Parameters ---------- entry : HelpEntry The table entry to render. Returns ------- ~rich.console.RenderableType Combined names and shorts, optionally wrapped. Order: positive_names, positive_shorts, negative_names, negative_shorts   Fsubsequent_indentbreak_on_hyphenstabsize )join all_optionsrtextwrapwrap)rentrytextwrappeds r __call__zNameRenderer.__call__*sYxx))* >> !K--  NN""  yy!!r#Nr1rreturnr__name__ __module__ __qualname____doc__intr!r4r#r rrs##*#"r#rc,eZdZdZddedzfdZddZy)CommandNameRenderera Renderer for command names with aliases in parentheses. Displays commands in argparse-style format: ``primary (alias1, alias2)``. Parameters ---------- max_width : int | None Maximum width for wrapping. If None, no wrapping is applied. Nrc||_yrrrs r r!zCommandNameRenderer.__init__Sr"r#c*|jr|jdnd}t|jdd}|r|ddj|d}n|}|j|St j ||jdd d }d j|S) a%Render command name with aliases in parentheses. Parameters ---------- entry : HelpEntry The table entry to render. Returns ------- ~rich.console.RenderableType Primary command name with aliases in parentheses. rNz (, )r&Fr'r(r,)r.listr-rr/r0)rr1primaryaliasesr2r3s r r4zCommandNameRenderer.__call__]s+0*;*;%##A&u((,- Yb7!3 4A6DD >> !K--  NN""  yy!!r#r5r6r8r>r#r r@r@Hs##*# "r#r@c&eZdZdZddefdZddZy)DescriptionRendereraRenderer for descriptions with configurable metadata formatting. Parameters ---------- newline_metadata : bool If True, display metadata (choices, env vars, defaults) on separate lines. If False (default), display metadata inline with the description. newline_metadatac||_y)zInitialize the renderer with formatting options. Parameters ---------- newline_metadata : bool If True, display metadata on separate lines instead of inline. N)rL)rrLs r r!zDescriptionRenderer.__init__s !1r#cddlm}ddlm}|j}|||}nHt ||s)?@  ==))EMM2K  ! !$*[M'CU"K L ==99U]]3L  ! !$*\N!'De"L M == $  ! !$*U]]O1'Eu"M N >>  ! !$}i"@ A  ^ 7 &K--"";#A#AB' )""4( )/:9k* Etv E' )""4( ) r#N)Fr6)r9r:r;r<boolr!r4r>r#r rKrKs11Kr#rKceZdZdZddZy)AsteriskRendererzRenderer for required parameter asterisk indicator. A simple renderer that displays an asterisk (*) for required parameters. c"|jrdSdS)a,Render an asterisk for required parameters. Parameters ---------- entry : HelpEntry The table entry to render. Returns ------- ~rich.console.RenderableType An asterisk if the entry is required, empty string otherwise. *rCr_)rr1s r r4zAsteriskRenderer.__call__snns,",r#Nr6)r9r:r;r<r4r>r#r rjrjs  -r#rjcXeZdZUdZeedfed< dZeed< dZeed< dZ e ded < dZ e ded < dZ e ded < d Z ed ed< dZeded< dZeded< dZedzed< dZedzed< dZedzed< dZedzed< dZeed< dZedzed< ddZdZy) ColumnSpecaSpecification for a single column in a help table. Used by :class:`~cyclopts.help.formatters.default.DefaultFormatter` to define how individual columns are rendered in help tables. Each column can have its own renderer, styling, and layout properties. See Also -------- ~cyclopts.help.formatters.default.DefaultFormatter : The formatter that uses these specs. ~cyclopts.help.specs.TableSpec : Specification for the entire table. ~cyclopts.help.specs.PanelSpec : Specification for the outer panel. rrendererrCheaderfooterNr header_style footer_stylestyleleft)r^rvcenterrightfulljustifytop)r{middlebottomverticalellipsis)foldcroprignoreoverflowwidth min_widthrratioFno_wrap highlightct|jtrt|j|}n)t |jr|j|}nd}|dS|S)zRender the cell content based on the renderer type. If renderer is a string, retrieves that attribute from the entry. If renderer is callable, calls it with the entry. NrC)rXrprZrcallable)rr1values r _render_cellzColumnSpec._render_cellsU dmmS )-Jt}}-e4E dmm $MM%(EE]r--r#c t|fi|Sr5r rkwargss r copyzColumnSpec.copyd%f%%r#r6)r9r:r;r<rrZ__annotations__rqrrrsrrtrurzrr~rrr=rrrrrhrrrr>r#r rorosM CO$$*FC FC +/L(;'. +/L(;'. $(E8K ' FLGWA BK 49Hg/08 ?IHg:;H E3: !IsTz  !IsTz  E3: GT "Itd{! .&r#rorCrvrDzred bold)rprqrzrruOptioncyan)rprqrzru Descriptionr)rprqrzrconsoler optionsrentriesrr7.ctj|jdz}tt |ddd|}|t fS)aGet default column specifications for command display. Parameters ---------- console : ~rich.console.Console Rich console for width calculations. options : ~rich.console.ConsoleOptions Console rendering options. entries : list[HelpEntry] Command entries to display. Returns ------- tuple[ColumnSpec, ...] Column specifications for command table. ffffff?rCommandrvrrprqrzrur)mathceilrror@DescriptionColumn)rrrrcommand_columns r get_default_command_columnsrsK& '--$./I$y9 N  r#ctj|jdz}tt |ddd|}t d|Dr t |tfS|tfS)aGet default column specifications for parameter display. Parameters ---------- console : ~rich.console.Console Rich console for width calculations. options : ~rich.console.ConsoleOptions Console rendering options. entries : list[HelpEntry] Parameter entries to display. Returns ------- tuple[ColumnSpec, ...] Column specifications for parameter table. rrrrvrrc34K|]}|jywr5rm).0xs r z0get_default_parameter_columns..s '!1:: 's)rrrroranyAsteriskColumnr)rrrr name_columns r get_default_parameter_columnsrsn& '--$./I 2 K 'w ''         r#ceZdZUdZdZedzed< dZedzed< dZe ded< dZ e ded< dZ e ded< dZ e ded < dZ e d ed < d Zeed < d Zeed< d Zeed< dZeed< d Zeed< d Zeed< dZded< d Zeed< dZedzed< dZedzed< dZedzed< deedfdeddd fd!Zd"Zy)# TableSpeca$Specification for table layout and styling. Used by :class:`~cyclopts.help.formatters.default.DefaultFormatter` to control the appearance of tables that display commands and parameters. This spec defines table-wide properties like borders, headers, and padding. See Also -------- ~cyclopts.help.formatters.default.DefaultFormatter : The formatter that uses these specs. ~cyclopts.help.specs.ColumnSpec : Specification for individual columns. ~cyclopts.help.specs.PanelSpec : Specification for the outer panel. Ntitlecaptionrru border_stylersrtr boxF show_header show_footer show_linesT show_edgeexpandpad_edge)rrrrpaddingcollapse_paddingrrsafe_boxcolumns.rrr7rc L|j}|rtd|Drd}id|jd|jd|jd|j d|j d|jd |jd |d |jd |jd |jd|jd|jd|jd|jd|j d|j"d|j$i}|j'|ddlm}|di|}|D]}|j,|j.|j |j|j|j0|j2|j4|j |j"|j6|j8|j:d } |j<|j<| d<|j>di| |D]/} |D cgc]} | jA| } } |jB| 1|Scc} w)aConstruct and populate a rich.Table. Parameters ---------- columns : tuple[ColumnSpec, ...] Column specifications defining the table structure. entries : Iterable[HelpEntry] Table entries to populate the table with. **overrides Per-render overrides for table settings. Returns ------- Table A populated Rich Table. c36K|]}|j ywr5)rq)rcols r rz"TableSpec.build..sA#3::~AsFrrrurrsrtrrrrrrrrrrrrrr) rqrrrsrtrurzr~rrrrrrrr>)"rallrrrurrsrtrrrrrrrrrrrupdate rich.tablerrqrrrzr~rrrrr add_columnradd_row) rrr overridesroptsrtablecolumncol_optsercellss r buildzTableSpec.buildks^0&& 3AAAK TZZ t||  TZZ  D--  D--  D--   488  ;  4++  $//    dkk     t||   5 5 TZZ! " # $  % ( I$   )F -- -- & 3 3 & 3 3!>>"OO"OO#--#--!>>H+(.(8(8% E   (x (% )* "A4;r#r rrs E3: GS4Z $(E8K ' +/L(;'. +/L(;'. +/L(;'.  C% K K J It FD Hd $0G / #d" E3: !IsTz  !HdTk  Pz3'P+&P  Pd&r#rc,eZdZUdZdZeded< dZeded< dZe ded< d Z e ded < d Z ed ed < d Z ed ed< dZ eded< dZded< dZeed< dZedzed< dZedzed< dZedzed< dZeed< ddZdZy) PanelSpeca"Specification for panel (outer box) styling. Used by :class:`~cyclopts.help.formatters.default.DefaultFormatter` to control the appearance of the outer panel that wraps help sections. This spec defines the panel's border, title, subtitle, and overall styling. See Also -------- ~cyclopts.help.formatters.default.DefaultFormatter : The formatter that uses these specs. ~cyclopts.help.specs.TableSpec : Specification for the inner table. ~cyclopts.help.specs.ColumnSpec : Specification for individual columns. Nrrsubtitlerv)rvrwrx title_alignrwsubtitle_alignnonerrurr r)rrDrrTrrheightrFrc |j}|ddlm}|}|j|j|j |j ||j|j|j|j|j|jd }|j|j|d<|j|j|d<|j|ddlm}||fi|S)zKCreate a Panel around `renderable`. Use kwargs to override spec per render.r)ROUNDED) rrrurrrrrrrrrrr)rrich.boxrrrrurrrrrrrrrr rich.panelr)r renderablerrrrrs r rzPanelSpec.build shh ; (C ++"11ZZ --||kkZZkk    :: ! JJDM == $#}}D  I$Z(4((r#c t|fi|Sr5r rs r rzPanelSpec.copyArr#)rrr7r)r9r:r;r<rrrrrrrrurrrrrhrr=rrrrrr>r#r rrs# )-E8$ %, ,0Hh'(/ 7=K23< :BNG56A $*E8K ) +1L(;'0  C% $*G ) FD E3: FC$J !HdTk  It )B&r#r)/rr/collections.abcroperatorrtypingrrrrattrsr cyclopts.utilsr rr r`r rr rich.paddingrrr rich.stylerrr cyclopts.helprcyclopts.help.protocolsrrr@rKrjror NameColumnrrGrrrrrr>r#r rsw $::!DD. $ '0."."b5"5"p__D--,U&U&U&r      ^     (;(=m]cntu !1<@