Ki$ldZddlZddlmZmZmZddlmZmZerddl m Z m Z ddl m Z mZGddZy) zHTML documentation formatter.N) TYPE_CHECKINGAnyOptional) escape_html extract_text)ConsoleConsoleOptions) HelpEntry HelpPanelc eZdZdZ ddedededzdeedzfdZdd Z defd Z d e d d e dddddfdZ dedd e d ddfdZ dedd e d ddfdZd e d d e ddeddfdZd e d d e ddeddfdZy) 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. N heading_levelinclude_hiddenapp_name command_chaincv||_||_||_|xsg|_t j |_yN)rrrrioStringIO_output)selfrrrrs i/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/cyclopts/help/formatters/html.py__init__zHtmlFormatter.__init__s5+,  *0b{{} returnc6tj|_y)z!Reset the internal output buffer.N)rrrrs rresetzHtmlFormatter.reset+s{{} rc6|jjS)zGet the accumulated HTML output. Returns ------- str The HTML documentation string. )rgetvaluers r get_outputzHtmlFormatter.get_output/s||$$&&rconsoleroptionsr panelr c |jsy|jjd|jrXt t |j|}|jjd|j d|d|j d|jr@t t |j|}|r|jjd|d|jd k(r|j|j|n+|jd k(r|j|j||jjd y) 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
) entriesrwritetitlerrr descriptionformat_format_command_panel_format_parameter_panel)rr"r#r$ title_text desc_texts r__call__zHtmlFormatter.__call__9s"}}  ;< ;;$\%++w%GHJ LL  D$6$6#77LZLX[\`\n\n[oors t   #L1B1BG$LMI ""%DYKx#XY <<9 $  & &u}}g > \\[ (  ( ( @ >*rr)r c|sy|jjd|D]}|j}|sd}n|jr|d|dd}}|jrB|j|gz}|jddj |ddj } n|jd|j } d| dt|d }|r\d j d |D} |d | d }n;|d|dd}}dt|d}|r d j d|D} |d | d }tt|j|} |jjd|d| r|jjd| |jjd|jjdy)zFormat command entries as HTML. Parameters ---------- entries : list[HelpEntry] Command entries to format. console : Optional[Console] Console for text extraction. Nz ) rr* all_optionsrrjoinlowerrrr,) rr)r"entrynames name_html primary_namealiases full_chain anchor_id aliases_str desc_htmls rr.z#HtmlFormatter._format_command_panelcs  9: *E%%E (-a%)g %%!%!3!3|n!DJ#'==/388JqrN3K2L M S S UI#'==/<. A G G II( 8K I).a%)g $[%>$?wG "&))+LG+L"LK#,+R }A >I#L1B1BG$LMI LL  i[ B C ""R {#34 LL  y ); *> 9%rc|sy|jjd|D]}|jx}rdjd|D}nd}|jjd|dt |j |}|r'|jjdt |g}|jr|jd |jr7djd |jD}|jd |d |j4t |j|} |jd t | d|jr7djd|jD} |jd| d |r.|jjddj|d |jjd|jjdy)zFormat parameter entries as HTML. Parameters ---------- entries : list[HelpEntry] Parameter entries to format. console : Optional[Console] Console for text extraction. Nz