o i_ @sddlZddlZddlmZddlmZddlmZmZm Z m Z ddl m Z ddl mZerbddlmZddlmZmZmZdd lmZdd lmZdd lmZdd lmZdd lmZddlm Z GdddZ!GdddZ"GdddZ#eGdddZ$e$e#dddddZ%e$e!ddddZ&e$e"ddd d!Z'd"d#d$d%d&e(d'd(e)e$d)ffd*d+Z*d"d#d$d%d&e(d'd(e)e$d)ffd,d-Z+eGd.d/d/Z,eGd0d1d1Z-dS)2N)Iterable) attrgetter) TYPE_CHECKINGLiteralOptionalUnionevolve)frozen)Box)ConsoleConsoleOptionsRenderableType)PaddingDimensionsPanel) StyleTypeTable) HelpEntry)Rendererc@s.eZdZdZd dedBfddZd d d ZdS) 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_widthcC ||_dS)zInitialize the renderer with formatting options. Parameters ---------- max_width : int | None Maximum width for wrapping. If None, no wrapping is applied. Nr)selfrrY/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/help/specs.py__init__  zNameRenderer.__init__entryrreturnrcCsx|jr d|jnd}|jrd|jnd}|r!|r!|d|}n|p$|}|jdur,|Stj||jdddd}d|S) a&Render 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.  Nz F)subsequent_indentbreak_on_hyphenstabsize )namesjoinshortsrtextwrapwrap)rr names_str shorts_strtextwrappedrrr__call__*s   zNameRenderer.__call__Nr rr!r)__name__ __module__ __qualname____doc__intrr2rrrrrs rc@s*eZdZdZd defddZdd 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_metadatacCr)zInitialize the renderer with formatting options. Parameters ---------- newline_metadata : bool If True, display metadata on separate lines instead of inline. N)r;)rr;rrrrWrzDescriptionRenderer.__init__r rr!rc Csvddlm}ddlm}|j}|dur||}nt||s7t|jdr)||}nddlm}||t|}g}|jrNd |j}| |d|dd |j rcd |j }| |d |dd |j duru| |d |j dd |j r| |d d |jr|rddlm}ddlm}g} |jr| |j|D]} | | q| r|| S|S|D]} | | q|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.textr<cyclopts.help.inline_textr= description isinstancehasattrstrchoicesr*appendenv_vardefaultrequiredr; rich.consolerAprimary_renderable) rr r<r=rDmetadata_items choices_str env_vars_str RichGroup renderablesitemrrrr2asB                zDescriptionRenderer.__call__N)Fr4)r5r6r7r8boolrr2rrrrr:Ms  r:c@seZdZdZd ddZdS) AsteriskRendererzRenderer for required parameter asterisk indicator. A simple renderer that displays an asterisk (*) for required parameters. r rr!rcCs|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. *r#rL)rr rrrr2s zAsteriskRenderer.__call__Nr4)r5r6r7r8r2rrrrrVsrVc@s&eZdZUdZeedfed< dZeed< dZeed< dZ e ded < dZ e ded < dZ e ded < d Z ed ed< dZeded< dZeded< dZedBed< dZedBed< dZedBed< dZedBed< dZeed< dZedBed< d$d d!Zd"d#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)rKr`centerrightfulljustifytop)remiddlebottomverticalellipsis)foldcropriignoreoverflowwidth min_widthrratioFno_wrap highlightr rr!rcCsFt|jtrt|j|}n t|jr||}nd}|dur!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. Nr#)rErZrGrcallable)rr valuerrr _render_cellLs   zColumnSpec._render_cellcKt|fi|Sr3rrkwargsrrrcopyZzColumnSpec.copyr4)r5r6r7r8rrG__annotations__r[r\r]rr^r_rdrrhrmrnr9rorrprqrUrrruryrrrrrYsD        rYr#r`zred bold)rZr[rdrnr_Optioncyan)rZr[rdr_ Descriptionrj)rZr[rdrmconsoler optionsr entriesrr!.cCs0t|jd}tt|dddd|d}|tfS)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?rCommandr`r~rZr[rdr_r)mathceilrnrYrDescriptionColumn)rrrrcommand_columnrrrget_default_command_columnsqs rcCsLt|jd}tt|dddd|d}tdd|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. rrr}r`r~rcss|]}|jVqdSr3rX).0xrrr sz0get_default_parameter_columns..)rrrnrYranyAsteriskColumnr)rrrr name_columnrrrget_default_parameter_columnss rc@s`eZdZUdZdZedBed< dZedBed< 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< dZedBed< dZedBed< dZedBed< deedfdeddd fd!d"Zd#d$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. Ntitlecaptionrr_ border_styler]r^r boxF show_header show_footer show_linesT show_edgeexpandpad_edge)rrrrpaddingcollapse_paddingrnrosafe_boxcolumns.rrr!rc  sj|j}|rtdd|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]1}|j|j|j|j|j|j|j|j|j|j|j|j|jd } |jdur|j| d<|jdi| qn|D]fdd|D} |j | q|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. css|]}|j VqdSr3)r[rcolrrrrQsz"TableSpec.build..Frrr_rr]r^rrrrrrrrrrnrorrr) r[r\r]r^r_rdrhrmrnrorrprqNrrcsg|]}|qSr)rurerr sz#TableSpec.build..r)!rallrrr_rr]r^rrrrrrrrrnrorupdate rich.tablerr[r\rdrhrmrrprqrr add_columnadd_row) rrr overridesroptsrtablecolumncol_optscellsrrrbuild8s          zTableSpec.buildcKrvr3rrwrrrryrzzTableSpec.copy) r5r6r7r8rrGr{rr_rrr]r^rrrUrrrrrrrrnr9rortuplerYrrryrrrrrs\           Rrc@seZdZUdZdZeded< dZeded< dZe ded< d Z e ded < d Z ed ed < d Z ed ed< dZ eded< dZded< dZeed< dZedBed< dZedBed< dZedBed< dZeed< d"ddZd d!ZdS)# 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. Nrrsubtitler`)r`rarb title_alignrasubtitle_alignnonerr_rr r)rr|rrTrrnheightrFrr renderabler!rc Ks|j}|durddlm}|}|j|j|j|j||j|j|j |j |j |j d }|j dur1|j |d<|jdur;|j|d<||ddlm}||fi|S)zKCreate a Panel around `renderable`. Use kwargs to override spec per render.Nr)ROUNDED) rrr_rrrrrnrrrrrrr)rrich.boxrrrr_rrrrnrrrrrrr rich.panelr)rrrrrrrrrrrs.      zPanelSpec.buildcKrvr3rrwrrrryrzzPanelSpec.copy)rrr!r)r5r6r7r8rrr{rrrrr_rrrrrUrnr9rrrrrryrrrrrs<      !r).rr,collections.abcroperatorrtypingrrrrattrsr cyclopts.utilsr rr rMr r r rich.paddingrrr rich.stylerrr cyclopts.helprcyclopts.help.protocolsrrr:rVrYr NameColumnrlistrrrrrrrrrsv           6b  "  )R