k7i_ SSKrSSKrSSKJr SSKJr SSKJrJrJ r J r SSK J r SSK Jr \(a4SSKJr SSKJrJrJr SS KJr SS KJr SS KJr SS KJr SS KJr SSKJ r "SS5r!"SS5r""SS5r#\"SS55r$\$"\#"5SSSSS9r%\$"\!"5SSSS9r&\$"\""5SSS S!9r'S"S#S$S%S&\(S'S(\)\$S)44S*jr*S"S#S$S%S&\(S'S(\)\$S)44S+jr+\"S,S-55r,\"S.S/55r-g)0N)Iterable) attrgetter) TYPE_CHECKINGLiteralOptionalUnionevolve)frozen)Box)ConsoleConsoleOptionsRenderableType)PaddingDimensionsPanel) StyleTypeTable) HelpEntry)Rendererc:\rSrSrSrSS\S-4SjjrS SjrSrg) 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_widthcXlg)zInitialize the renderer with formatting options. Parameters ---------- max_width : int | None Maximum width for wrapping. If None, no wrapping is applied. Nr)selfrs M/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/help/specs.py__init__NameRenderer.__init__ s #cUR(aSRUR5OSnUR(aSRUR5OSnU(aU(a US-U-nO U=(d UnURcU$[R "UURSSSS9nSRU5$)zRender 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.  z F)subsequent_indentbreak_on_hyphenstabsize )namesjoinshortsrtextwrapwrap)rentry names_str shorts_strtextwrappeds r__call__NameRenderer.__call__*s.3[[CHHU[[)b /4||SXXell+ s?Z/D* D >> !K--  NN""  yy!!r"rNr0rreturnr) __name__ __module__ __qualname____firstlineno____doc__intr r5__static_attributes__r"rrrs##*# "r"rc4\rSrSrSrSS\4SjjrS SjrSrg) DescriptionRendererMaRenderer 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_metadatacXlg)zInitialize the renderer with formatting options. Parameters ---------- newline_metadata : bool If True, display metadata on separate lines instead of inline. NrE)rrEs rr DescriptionRenderer.__init__Ws !1r"cSSKJn SSKJn URnUcU"U"55nOQ[ XC5(dA[ URS5(a U"U5nOSSKJn U"U"[U555n/nUR(a7SRUR5nURU"SUS3S55 UR(a7SRUR5nURU"S US3S55 URb&URU"S URS3S55 UR(aURU"S S 55 UR(anU(agSS KJn SSKJn /n UR"(aU RUR"5 UHn U RU 5 M U (aU"U 6$U"5$UHn URU 5 M U$)a?Render 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) InlineText__rich_console__z, z [choices: ]dimz [env var: z [default: z [required]zdim red)Group) rich.textrJcyclopts.help.inline_textrK description isinstancehasattrstrchoicesr,appendenv_vardefaultrequiredrE rich.consolerOprimary_renderable) rr0rJrKrRmetadata_items choices_str env_vars_str RichGroup renderablesitems rr5DescriptionRenderer.__call__as #8''  $TV,KK44u((*<==(5 +(c+.>)?@  ==))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"rGN)Fr8) r:r;r<r=r>boolr r5r@rAr"rrCrCMs11Kr"rCc"\rSrSrSrSSjrSrg)AsteriskRendererz~Renderer for required parameter asterisk indicator. A simple renderer that displays an asterisk (*) for required parameters. c,UR(aS$S$)zRender 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%rZ)rr0s rr5AsteriskRenderer.__call__snns,",r"rANr8)r:r;r<r=r>r5r@rAr"rrfrfs  -r"rfcb\rSrSr%Sr\\S4\S'Sr\\S'Sr \\S'Sr \ S \S 'Sr \ S \S 'Sr \ S \S 'S r\S\S'Sr\S\S'Sr\S\S'Sr\S-\S'Sr\S-\S'Sr\S-\S'Sr\S-\S'Sr\\S'Sr\S-\S'S SjrSrSrg)! 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)rYrucenterrightfulljustifytop)rzmiddlebottomverticalellipsis)foldcropr~ignoreoverflowwidth min_widthrratioFno_wrap highlightc[UR[5(a[UR5"U5nO.[ UR5(aURU5nOSnUcS$U$)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%)rSrorUrcallable)rr0values r _render_cellColumnSpec._render_cellLsY dmmS ) )t}}-e4E dmm $ $MM%(EE]r--r"c [U40UD6$r7r rkwargss rcopyColumnSpec.copyZd%f%%r"rAr8)r:r;r<r=r>rrU__annotations__rprqrrrrsrtryrr}rrr?rrrrrdrrrr@rAr"rrmrmsM CO$$*FC FC +/L(;'. +/L(;'. $(E8K ' FLGWA BK 49Hg/08 ?IHg:;H E3: !IsTz  !IsTz  E3: GT "Itd{! .&r"rmr%ruzred bold)rorpryrrtOptioncyan)rorpryrt Descriptionr)rorpryrconsoler optionsrentriesrr9.c[R"URS-5n[[ US9SSSUS9nU[ 4$)alGet 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?rCommandrurrorpryrtr)mathceilrrmrDescriptionColumn)rrrrcommand_columns rget_default_command_columnsrqsK& '--$./I 2 N  r"c[R"URS-5n[[ US9SSSUS9n[ SU55(a [ U[4$U[4$)arGet 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. rrrrurrc38# UHoRv M g7fr7rj).0xs r 0get_default_parameter_columns..s 'w!::ws)rrrrmranyAsteriskColumnr)rrrr name_columns rget_default_parameter_columnsrsq& '--$./I 2 K 'w '''         r"c\rSrSr%SrSr\S-\S'Sr\S-\S'Sr \ S\S'Sr \ S\S'Sr \ S\S 'Sr \ S\S 'Sr\ S \S 'S r\\S'S r\\S'S r\\S'Sr\\S'S r\\S'S r\\S'SrS\S'S r\\S'Sr\S-\S'Sr\S-\S'Sr\S-\S'S\\S4S\SS S!4S"jrS#r S$r!g)% TableSpeciaSpecification 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. Ntitlecaptionrrt border_stylerrrsr boxF show_header show_footer show_linesT show_edgeexpandpad_edge)rrrrpaddingcollapse_paddingrrsafe_boxcolumns.rrr9rc nURnU(a[SU55(aSn0SUR_SUR_SUR_SUR _SUR _SUR_S UR_S U_S UR_S UR_S UR_SUR_SUR_SUR_SUR_SUR _SUR"_SUR$0EnUR'U5 SSKJn U"S0UD6nUHnUR,UR.UR URURUR0UR2UR4UR UR"UR6UR8UR:S. n UR<bUR<U S'UR>"S0U D6 M UH2n UV s/sHoRAU 5PM n n URB"U 6 M4 U$s sn f)aMConstruct 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. c3B# UHoR(+v M g7fr7)rp)rcols rr"TableSpec.build..QsA#::~~sFrrrtrrrrsrrrrrrrrrrrrrr) rprqrrrsrtryr}rrrrrrrrA)"rallrrrtrrrrsrrrrrrrrrrrupdate rich.tablerrprqryr}rrrrr add_columnradd_row) rrr overridesroptsrtablecolumncol_optsercellss rbuildTableSpec.build8sR0&& 3AAAAK TZZ t||  TZZ  D--  D--  D--   488  ;  4++  $//    dkk     t||   5 5 TZZ! " # $  % ( I$  F -- -- & 3 3 & 3 3!>>"OO"OO#--#--!>>H+(.(8(8%    (x (%*A4;rrUrrrtrrrrrsrrrdrrrrrrrrr?rrtuplermrrrr@rAr"rrrs E3: GS4Z $(E8K ' +/L(;'. +/L(;'. +/L(;'.  C% K K J It FD Hd $0G / #d" E3: !IsTz  !HdTk  Pz3'P+&P  Pd&r"rc6\rSrSr%SrSr\S\S'Sr\S\S'Sr \ S\S 'S r \ S\S 'S r \S \S'S r \S \S'Sr\S\S'SrS\S'Sr\\S'Sr\S-\S'Sr\S-\S'Sr\S-\S'Sr\\S'SSjrSrSrg) PanelSpeciaSpecification 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. Nrrsubtitleru)rurvrw title_alignrvsubtitle_alignnonerrtrr r)rrrrTrrheightrFrc URnUcSSKJn UnURURUR UR UURURURURURURS. nURbURUS'URbURUS'URU5 SSKJn U"U40UD6$)zKCreate a Panel around `renderable`. Use kwargs to override spec per render.r)ROUNDED) rrrtrrrrrrrrrrr)rrich.boxrrrrtrrrrrrrrrr rich.panelr)r renderablerrrrrs rrPanelSpec.buildshh ; (C ++"11ZZ --||kkZZkk    :: ! JJDM == $#}}D  I$Z(4((r"c [U40UD6$r7r rs rrPanelSpec.copyrr"rA)rrr9r)r:r;r<r=r>rrrrrrrrtrrrrrdrr?rrrrrr@rAr"rrrs# )-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.protocolsrrrCrfrmr NameColumnrlistrrrrrrAr"rrsl $::!DD. $ '03"3"l__D--,U&U&U&r      ^     (;(=m]cntu !1<@