Ki"dZddlmZmZmZmZddlmZddlm Z er ddl m Z m Z m Z ddlmZddlmZddlmZmZmZed Gd d Zy )z"Default Rich-based help formatter.) TYPE_CHECKINGAnyOptionalUnion)define)SILENT)ConsoleConsoleOptionsRenderableType) HelpPanel)ColumnSpecBuilder) ColumnSpec PanelSpec TableSpecT)kw_onlyceZdZUdZdZeded< dZeded< dZe e ddfdzed < e d Z ddZ d d d ddeddfdZd d d ddeddfdZddZy)DefaultFormatteruDefault 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 d}|dd|i|S)aCreate 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()) cddl}ddlm}m}m}m}|j |jdz}|||dd|} ||d d d } td |Dr|| | fS| | fS)Nr)AsteriskColumnrDescriptionRenderer NameRenderergffffff?) max_widthOptioncyan)rendererheaderstylerT)newline_metadata Descriptionfold)rr overflowc34K|]}|jyw)N)required).0xs l/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/cyclopts/help/formatters/default.py zQDefaultFormatter.with_newline_metadata..column_builder..vs/!1::/s) mathcyclopts.help.specsrrrrceilwidthany) consoleoptionsentriesr,rrrrr name_columndescription_columns r*column_builderz>DefaultFormatter.with_newline_metadata..column_builder`s    '--$"67I$% :# K",,dCMdj" /w//& 5GHH!34 4rr8)clskwargsr6s r*with_newline_metadataz&DefaultFormatter.with_newline_metadataGs2 5499&99r7r1r r2r returncL|j|||}|j|y)a=Format 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)selfr1r2panelrendereds r*__call__zDefaultFormatter.__call__|s$%%eWg> hr7usagec|rddlm}t|}|jj ds(t ||r|dd|z}n/|d|d}n!t ||r|n|t|d}|j |yy)a$Render 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). rTextzUsage:zUsage: bold)r!N) rich.textrGstrstrip startswith isinstancer?)r@r1r2rDrG usage_strusage_with_labels r* render_usagezDefaultFormatter.render_usages  &E I??$//9eT*'+IV'Du'L$'+geW,=V'L$-7ud,C5cRWj`fIg MM* + r7 descriptionc,|r|j|yy)a@Render 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). N)r?)r@r1r2rQs r*render_descriptionz#DefaultFormatter.render_descriptions  MM+ & r7c|jstSddlm}ddlm}ddlm}ddlm}m }m } m } |j} t| |r"d| _| jr|| |d} |j xs|} |j"xs|} |j$}||j&dk(r| }n| }t)|r||||j}| j+||j}| J| j,&| j+|| ||j, }|S| j+|| |}|S) zRender a single help panel.r)Group)NewLinerF)rrget_default_command_columnsget_default_parameter_columnscommand)title)r3r rich.consolerUrVrIrGr-rrrWrXrQrMendplainrrrformatcallablebuildr\)r@ help_panelr1r2 RichGrouprVrGrrrWrXpanel_descriptionrrcolumnstablerAs r*r>zDefaultFormatter._render_panelsF!!M3("  '22 ' .$&  ! &&$-.?$L!__3 __3 ## ?  I-57 G gw 0B0BCG  **<*<=!,,,    #$$Y/@%%HPZP`P`$aE $$Y/@%%HIE r7)r1r r2r rAr r<N)rcr r1r r2r r<r )__name__ __module__ __qualname____doc__rr__annotations__rrrtuple classmethodr;rCrrPrSr>r8r7r*rrs)V)-J%,\(,J%,[PTL%/02EEFMTe2:2:h  ,I,8H,QT,Y],6 ') '>N ']` 'ei '2r7rN)rktypingrrrrattrsrcyclopts.help.silentrr]r r r cyclopts.helpr cyclopts.help.protocolsr r-rrrrr8r7r*rtsJ(66'DD'9DDUUUr7