k7iq SrSSKJrJrJrJr SSKJr SSKJ r \(a SSK J r J r J r SSKJr SSKJr SSKJrJrJr \"S S 9"S S 55rg )z"Default Rich-based help formatter.) TYPE_CHECKINGAnyOptionalUnion)define)SILENT)ConsoleConsoleOptionsRenderableType) HelpPanel)ColumnSpecBuilder) ColumnSpec PanelSpec TableSpecT)kw_onlyc\rSrSr%SrSr\S\S'Sr\S\S'Sr \ \ SS 4S-\S '\ S 5r SSjrS S SSS\SS4SjrS S SSS\SS4SjrSSjrSrg)DefaultFormatteruKDefault help formatter using Rich library with customizable specs. Parameters ---------- panel_spec : Optional[PanelSpec] Panel specification for the outer box/panel styling. table_spec : Optional[TableSpec] Table specification for table styling (borders, padding, etc). column_specs : Optional[Union[tuple[ColumnSpec, ...], ColumnSpecBuilder]] Column specifications or builder function for table columns. Notes ----- The relationship between these specs can be visualized as: :: ╭─ Commands ───────────────────────────────────────────────────────╮ ← panel_spec │ serve Start the development server │ (border, title) │ --help Display this message and exit. │ ╰──────────────────────────────────────────────────────────────────╯ ↑ ↑ col[0] col[1] (name) (description) ╭─ Parameters ─────────────────────────────────────────────────────╮ ← panel_spec │ * PORT --port Server port number [required] │ │ VERBOSE --verbose Enable verbose output [default: False] │ ╰──────────────────────────────────────────────────────────────────╯ ↑ ↑ ↑ │ col[1] col[2] │ (name/flags) (description) │ col[0] (required marker) Where: - ``panel_spec`` controls the outer panel appearance (border, title, etc.) - ``table_spec`` controls the inner table styling (no visible borders by default) - ``column_specs`` defines individual columns (width, style, alignment, etc.) Nr panel_specr table_spec)r.r column_specsc SnU"SSU0UD6$)aICreate formatter with metadata on separate lines. Returns a DefaultFormatter configured to display parameter metadata (choices, env vars, defaults) on separate indented lines rather than inline with descriptions. Parameters ---------- **kwargs Additional keyword arguments to pass to DefaultFormatter constructor. Returns ------- DefaultFormatter Configured formatter instance with newline metadata display. Examples -------- >>> from cyclopts import App >>> from cyclopts.help import DefaultFormatter >>> app = App(help_formatter=DefaultFormatter.with_newline_metadata()) cSSKnSSKJnJnJnJn UR URS-5nU"U"US9SSUS9n U"U"SS 9S S S 9n [S U55(aXIU 4$X4$)Nr)AsteriskColumnrDescriptionRenderer NameRenderergffffff?) max_widthOptioncyan)rendererheaderstylerT)newline_metadata Descriptionfold)r r!overflowc38# UHoRv M g7f)N)required).0xs Z/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/help/formatters/default.py QDefaultFormatter.with_newline_metadata..column_builder..vs/w!::ws) mathcyclopts.help.specsrrrrceilwidthany) consoleoptionsentriesr.rrrrr name_columndescription_columns r+column_builder>DefaultFormatter.with_newline_metadata..column_builder`s    '--$"67I$% :# K",,dCMdj" /w///&5GHH4 4rr;)clskwargsr8s r+with_newline_metadata&DefaultFormatter.with_newline_metadataGs2 5499&99r:r3r r4r returncJURX1U5nURU5 g)zFormat and render a single help panel using Rich. Parameters ---------- console : ~rich.console.Console Console to render to. options : ~rich.console.ConsoleOptions Console rendering options. panel : HelpPanel Help panel to render. N) _render_panelprint)selfr3r4panelrendereds r+__call__DefaultFormatter.__call__|s"%%eg> hr:usagec6U(aURU5 gg)zRender the usage line. Parameters ---------- console : ~rich.console.Console Console to render to. options : ~rich.console.ConsoleOptions Console rendering options. usage : Any The usage line (Text or str). NrC)rDr3r4rIs r+ render_usageDefaultFormatter.render_usages  MM%  r: descriptionc6U(aURU5 gg)zRender the description. Parameters ---------- console : ~rich.console.Console Console to render to. options : ~rich.console.ConsoleOptions Console rendering options. description : Any The description (can be various Rich renderables). NrK)rDr3r4rNs r+render_description#DefaultFormatter.render_descriptions  MM+ & r:cUR(d[$SSKJn SSKJn SSKJn SSKJnJ nJ n J n URn [X5(a&SU lU R(aU"X"S55n UR =(d U"5n UR"=(d U"5n UR$nUcUR&S:XaU nOU n[)U5(aU"X#UR5nU R+XR5nU ceU R,c"U R+U"X5UR,S 9nU$U R+U"X55nU$) zRender a single help panel.r)Group)NewLine)Text)rrget_default_command_columnsget_default_parameter_columnscommand)title)r5r rich.consolerSrT rich.textrUr/rrrVrWrN isinstanceendplainrrrformatcallablebuildr[)rD help_panelr3r4 RichGrouprTrUrrrVrWpanel_descriptionrrcolumnstablerEs r+rBDefaultFormatter._render_panelsB!!M3("  '22 ' . .$&  ! &&$-.?$L!__3 __3 ## ?  I-57 G  g 0B0BCG  *<*<=!,,,    #$$Y/@%HPZP`P`$aE $$Y/@%HIE r:r;)r3r r4r rEr r@N)rdr r3r r4r r@r )__name__ __module__ __qualname____firstlineno____doc__rr__annotations__rrrtuple classmethodr>rGrrLrPrB__static_attributes__r;r:r+rrs)V)-J%,\(,J%,[PTL%/02EEFMTe2:2:h   !I !8H !QT !Y] ! ') '>N ']` 'ei '2r:rN)rntypingrrrrattrsrcyclopts.help.silentrr\r r r cyclopts.helpr cyclopts.help.protocolsr r/rrrrr;r:r+rxsJ(66'DD'9DDIIIr: