! !K-  N""    yy!!!r Nr!rr"r)__name__ __module__ __qualname____doc__intrr4r rrrsV###*#### " " " " " "r rc(eZdZdZd defdZd d Zd S) 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. Fnewline_metadatac||_dS)zInitialize the renderer with formatting options. Parameters ---------- newline_metadata : bool If True, display metadata on separate lines instead of inline. N)r?)rr?s rrzDescriptionRenderer.__init__Ws!1r r!rr"rcddlm}ddlm}|j}|||}nXt ||sHt |jdr ||}n'ddlm}||t|}g}|jr=d |j}| |d|dd |j r=d |j }| |d |dd |j (| |d |j dd |j r| |d d |jr\|rZddlm}ddlm}g} |jr| |j|D]} | | | r|| n |S|D]} | | |S)aRender parameter description with metadata annotations. Enriches the base description with choices, environment variables, default values, and required status. Parameters ---------- entry : HelpEntry The table entry to render. Returns ------- ~rich.console.RenderableType Description with appended metadata. r)Text) InlineTextN__rich_console__z, z [choices: ]dimz [env var: z [default: z [required]zdim red)Group) rich.textrBcyclopts.help.inline_textrC description isinstancehasattrstrchoicesr,appendenv_vardefaultrequiredr? rich.consolerGprimary_renderable) rr!rBrCrJmetadata_items choices_str env_vars_str RichGroup renderablesitems rr4zDescriptionRenderer.__call__as #"""""888888'  $*TTVV,,KKK44 Au(*<== A(j55 +*****(jc+.>.>)?)?@@  = M))EM22K  ! !$$'C['C'C'CU"K"K L L L = N99U]33L  ! !$$'D\'D'D'De"L"L M M M = $  ! !$$'EU]'E'E'Eu"M"M N N N > B  ! !$$}i"@"@ A A A   ^  7 7 7 7 7 7 & & & & & &K- C"";#ABBB' ) )""4((((/:E99k**ttvv E' ) )""4(((( r N)Fr6)r7r8r9r:boolrr4r<r rr>r>MsX111111KKKKKKr r>ceZdZdZddZdS) AsteriskRendererzRenderer for required parameter asterisk indicator. A simple renderer that displays an asterisk (*) for required parameters. r!rr"rc|jrdndS)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. *r%rR)rr!s rr4zAsteriskRenderer.__call__sn,ss",r Nr6)r7r8r9r:r4r<r rr]r]s2 - - - - - -r r]ceZdZUdZeedfed< dZeed< dZeed< dZ e ded < dZ e ded < dZ e ded < d Z ed ed< dZeded< dZeded< dZedzed< dZedzed< dZedzed< dZedzed< dZeed< dZedzed< d"d Zd!ZdS)# 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. rrendererr%headerfooterNr header_style footer_stylestyleleft)rQricenterrightfulljustifytop)rnmiddlebottomverticalellipsis)foldcroprrignoreoverflowwidth min_widthrratioFno_wrap highlightr!rr"rct|jtrt|j|}n,t |jr||}nd}|dn|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. Nr%)rKrcrMrcallable)rr!values r _render_cellzColumnSpec._render_cellLsk dmS ) ) -Jt}--e44EE dm $ $ MM%((EEE]rr-r c t|fi|Sr5r rkwargss rcopyzColumnSpec.copyZd%%f%%%r r6)r7r8r9r:rrM__annotations__rdrerfrrgrhrmrrqrvrwr;rxrryrzr[r{rrr<r rrbrbs  CO$$$$*FC FC +/L(;'... +/L(;'... $(E8K ''' FLGWA BKKK 49Hg/0888 ?IHg:;HHH E3: !IsTz    !IsTz    E3: GT "Itd{!!! . . . .&&&&&r rbr%rizred bold)rcrdrmrwrhOptioncyan)rcrdrmrh Descriptionrs)rcrdrmrvconsoler optionsrentriesrr".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?rCommandrirrcrdrmrhr)mathceilrwrbrDescriptionColumn)rrrrcommand_columns rget_default_command_columnsrqsZ& '-$.//I 222 N  r ctj|jdz}tt |ddd|}t d|Drt |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. rrrrirrc3$K|] }|jV dSr5r`).0xs r z0get_default_parameter_columns..s$ ' '!1: ' ' ' ' ' 'r )rrrwrbranyAsteriskColumnr)rrrr name_columns rget_default_parameter_columnsrs& '-$.//I 222 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"ZdS)# 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. Ntitlecaptionrrh border_stylerfrgr boxF show_header show_footer show_linesT show_edgeexpandpad_edge)rrrrpaddingcollapse_paddingrwrxsafe_boxcolumns.rrr"rc  |j}|rtd|Drd}id|jd|jd|jd|jd|jd|jd |jd |d |j d |j d |j d|j d|j d|jd|jd|jd|jd|ji}||ddlm}|di|}|D]q}|j|j|j|j|j|j|j|j|j|j|j|j|jd } |j |j| d<|jdi| r|D] fd|D} |j | |S)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. c3&K|] }|j V dSr5)rd)rcols rrz"TableSpec.build..Qs&AA#3:~AAAAAAr Frrrhrrfrgrrrrrrrrrrwrxrrr) rdrerfrgrhrmrqrvrwrxrryrzNr{c:g|]}|Sr<)r)rres r z#TableSpec.build..s'<<"O"O#-#-!>H+(.(8% E  ( (x ( ( ( ( " "A<<<r]rbr NameColumnrlistrrrrrr<r rrsr $$$$$$::::::::::::!!!!!! 1DDDDDDDDDD......      $$$$$$      ''''''0000003"3"3"3"3"3"3"3"l________D--------,U&U&U&U&U&U&U&U&r       Z \^^     J(;(;(=(=m]cntuuu !1<@