o iF5@sxdZddlZddlmZmZmZddlmZmZer*ddl m Z m Z ddl m Z mZdedefd d ZGd d d ZdS) zHTML documentation formatter.N) TYPE_CHECKINGAnyOptional) escape_html extract_text)ConsoleConsoleOptions) HelpEntry HelpPaneltype_objreturncCs|durdSt|dr|j}nt|drt|d}nt|}|dddd}|dr;|dd }d |d S|d rB|S|d rS|d d }d|d S|drZ|S|dre|ddS|S)zFormat a type object into a readable string. Parameters ---------- type_obj : Any Type object to format. Returns ------- str Formatted type name. Nplain__rich_console__zztyping.Optional[z Optional[]z typing.Union[ zUnion[ztyping.)hasattrrrstriprstrreplace startswith)r type_str inner_type inner_typesrc/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/help/formatters/html.py_format_type_names*               rc @seZdZdZ    d$dedededBdeedBfd d Zd%d d Z d efddZ de dde dddd dfddZ dedde dd dfddZ dedde dd dfddZde dde dded dfdd Zde dde dd!ed dfd"d#ZdS)& HtmlFormatteraHTML documentation formatter. Parameters ---------- heading_level : int Starting heading level for panels (default: 2). E.g., 2 produces "

Commands

", 3 produces "

Commands

". include_hidden : bool Include hidden commands/parameters in documentation (default: False). app_name : str The root application name for generating anchor IDs. command_chain : list[str] The current command chain for generating anchor IDs. FN heading_levelinclude_hiddenapp_name command_chaincCs*||_||_||_|p g|_t|_dS)N)r"r#r$r%ioStringIO_output)selfr"r#r$r%rrr__init__Ns  zHtmlFormatter.__init__r cCst|_dS)z!Reset the internal output buffer.N)r&r'r(r)rrrreset[szHtmlFormatter.resetcCs |jS)zGet the accumulated HTML output. Returns ------- str The HTML documentation string. )r(getvaluer+rrr get_output_s zHtmlFormatter.get_outputconsoleroptionsrpanelr c Cs|jsdS|jd|jr(tt|j|}|jd|jd|d|jd|jr?tt|j|}|r?|jd|d|jd krL| |j|n |jd krX| |j||jd dS) a_Format and render a help panel as HTML. Parameters ---------- console : Optional[Console] Console for rendering (used for extracting plain text). options : Optional[ConsoleOptions] Console rendering options (unused for HTML). panel : HelpPanel Help panel to render. Nz
zz z

command parameterz
) entriesr(writetitlerrr" descriptionformat_format_command_panel_format_parameter_panel)r)r/r0r1 title_text desc_textrrr__call__is $  zHtmlFormatter.__call__r5r c Csb|sdS|jd|D]}g}|jr||j|jr"||j|jrw|rw|d}|jrF|j|g}|jdd|dd}n |jd|}d|dt |d}t |dkrvd d d |ddD} |d | }n|rd d d |Dnd }t t |j |} |jd|d| r|jd| |jdq |jddS)zFormat command entries as HTML. Parameters ---------- entries : list[HelpEntry] Command entries to format. console : Optional[Console] Console for text extraction. Nz ) r(r6namesextendshortsr$r%joinlowerrlenrr8) r)r5r/entryrQ primary_name full_chain anchor_id name_htmlaliases desc_htmlrrrr:s6      $ z#HtmlFormatter._format_command_panelcCs|sdS|jd|D]V}g}|jr||j|jr#||j|jdur.t|j|nd}d}|rstdd|D}tdd|D}|oI|}|r_|dvr_dd |Dd d |D}n|rs|d vrsd d |Dd d |D}|r|rt|dkrdt |ddt |dd} n d dd|D} nd} |jd| dt|j |} | r|jdt | g} |j r| d|jrd dd|jD} | d| d|dur5|r*|dvrtdd|D|r|dnd} | d t | d!n2|d vrtd"d|Dd#}| d t |d!n| d t |d!n | d t |d!|jrMd d$d|jD}| d%|d| r]|jd&d | d|jd'q |jd(dS))zFormat parameter entries as HTML. Parameters ---------- entries : list[HelpEntry] Parameter entries to format. console : Optional[Console] Console for text extraction. Nz