+ Q(iHRt^RIHt^RIHtHt^RIHtHtH t H t H t H t H t ]'d^RIHtR RRlltRtR R R lltR#) z0HTML documentation generation for cyclopts apps.) TYPE_CHECKING) escape_html extract_text)build_command_chainextract_description extract_usagefilter_help_entriesformat_usage_linegenerate_anchoriterate_commands)AppcrV^8dQhR\\,RRR\R\R\R\RR /#) linesappr include_hiddenapp_nameprefixdepthreturnN)liststrboolint)formats"X/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/cyclopts/docs/html.py __annotate__rsR'' 9' '' '  '  ' 'c VP'gR#\W4FwrgV'dV V 2MTpV RVPRR4 2P4p RV^,,p VP V RV RV R24VP'dAVP V R24\ WW#V R2V^,4VP V R 24VP V R 24K R#) z,Recursively generate HTML table of contents.N- z z
  • z z z
    • ) _commandsr replacelowerappend_generate_html_toc) rrrrrrnamesubapp display_name full_pathindents &&&&&& rr%r%s ===(= ,2&$( j,"6"6sC"@!ABHHJ # x~i[kRS     LLF86* + un<.XYHZ\ade\e f LLF87+ , xu%&>ra= :root { --bg-color: #ffffff; --text-color: #333333; --border-color: #e0e0e0; --code-bg: #f5f5f5; --link-color: #0066cc; --header-bg: #f8f9fa; --required-color: #d73027; } * { box-sizing: border-box; } body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif; line-height: 1.6; color: var(--text-color); background: var(--bg-color); max-width: 1200px; margin: 0 auto; padding: 20px; } h1, h2, h3, h4, h5, h6 { margin-top: 24px; margin-bottom: 16px; font-weight: 600; line-height: 1.25; } h1 { font-size: 2em; border-bottom: 2px solid var(--border-color); padding-bottom: 0.3em; } h2 { font-size: 1.5em; border-bottom: 1px solid var(--border-color); padding-bottom: 0.3em; } h3 { font-size: 1.25em; } h4 { font-size: 1em; } code { background: var(--code-bg); padding: 2px 6px; border-radius: 3px; font-family: 'Courier New', Consolas, monospace; font-size: 0.9em; } pre { background: var(--code-bg); padding: 16px; border-radius: 6px; overflow-x: auto; font-family: 'Courier New', Consolas, monospace; font-size: 0.9em; } pre code { background: none; padding: 0; } .usage-block { margin: 16px 0; } .usage { background: #f8f9fa; border-left: 4px solid #0066cc; } .description, .app-description, .command-description { margin: 16px 0; color: var(--text-color); } .panel-description { margin: 12px 0; color: #666; } .help-panel { margin: 24px 0; } /* List styles for commands and parameters */ .commands-list, .parameters-list { list-style: none; padding-left: 0; margin: 16px 0; } .commands-list li, .parameters-list li { padding: 8px 0; border-bottom: 1px solid var(--border-color); } .commands-list li:last-child, .parameters-list li:last-child { border-bottom: none; } .commands-list code, .parameters-list code { font-weight: 600; } /* Metadata styling */ .parameter-metadata { display: inline-flex; gap: 8px; margin-left: 8px; flex-wrap: wrap; align-items: center; } .metadata-item { display: inline-block; padding: 2px 8px; font-size: 0.85em; border-radius: 4px; background: var(--code-bg); border: 1px solid var(--border-color); } .metadata-required { background: #fee; border-color: #fcc; color: #c00; font-weight: 600; } .metadata-default { background: #f0f8ff; border-color: #d0e8ff; color: #0066cc; } .metadata-env { background: #f0fff0; border-color: #d0ffd0; color: #080; } .metadata-choices { background: #fffaf0; border-color: #ffd0a0; color: #840; } .metadata-label { font-weight: 600; opacity: 0.8; text-transform: uppercase; font-size: 0.9em; } /* Table of Contents */ .table-of-contents { background: var(--header-bg); border-radius: 6px; padding: 16px; margin: 24px 0; } .table-of-contents h2 { margin-top: 0; border-bottom: none; padding-bottom: 0; } .table-of-contents ul { margin: 8px 0; padding-left: 24px; } .table-of-contents li { margin: 4px 0; } .table-of-contents a { color: var(--link-color); text-decoration: none; } .table-of-contents a:hover { text-decoration: underline; } /* General link styles */ a { color: var(--link-color); text-decoration: none; } a:hover { text-decoration: underline; } .commands-list a code { color: var(--link-color); } /* Back to top link */ .back-to-top { display: inline-block; margin-top: 8px; font-size: 0.9em; opacity: 0.7; } .back-to-top:hover { opacity: 1; } /* Responsive design */ @media (max-width: 768px) { body { padding: 10px; } .commands-list, .parameters-list { font-size: 0.9em; } } /* Dark mode support */ @media (prefers-color-scheme: dark) { :root { --bg-color: #1e1e1e; --text-color: #e0e0e0; --border-color: #444; --code-bg: #2d2d2d; --link-color: #66b3ff; --header-bg: #2d2d2d; } .usage { background: #2d2d2d; border-left-color: #66b3ff; } .table-of-contents { background: #2d2d2d; } .metadata-required { background: #4a2020; border-color: #6a3030; color: #ff9999; } .metadata-default { background: #20304a; border-color: #304060; color: #99ccff; } .metadata-env { background: #204a20; border-color: #306030; color: #99ff99; } .metadata-choices { background: #4a3020; border-color: #604030; color: #ffcc99; } } /* Command sections */ .command-section { margin-top: 32px; padding-top: 16px; border-top: 2px solid var(--border-color); } .command-section:first-child { border-top: none; } NcV^8dQhRRR\R\R\R\R\R\R ,R \\,R ,R \R \R \/ #)rrr recursiver heading_levelmax_heading_level standalone custom_cssN command_chain generate_tocflatten_commandsr)rrrr)rs"rrrGs__ ___ _  _  _d _9t#___ _rc T^RIHp Vf.p.p V'g V'gV PR4V'g?VP^,p T p T p\ W44pV PRV RV RV R24MV'd V^,MVP^,p RP V4p \ V 4p\ W44pV PR 4V PRV R V R \V 4 R V R2 4VPPR RR7p\VV4pV'd3\VR4pV'dV PR\V4 R24V'd~V'gvVP'ddV PR4V PR4V PR4\WW,R^4V PR4V PR4\V4pV'd\ V^,V4pV PRV RV R24V PR4\V\ 4'dTpM \VR4p\#VVRR7pV PR\V4 R24V PR4VPV.4;_uu_4VP%.V4pRRR4V !V^,VV VR7pVP'4XFbwppV'gV'dVP('gK*V'g\+VVV4VnVP,'gKXV!RRV4Kd VP/4P14pV'dV PV4VP'Ed\3W4EFwpp\5VVV 4pV 'dTpM V^,pV PR 4\7V4^8d,V RRP VR,4 2P94MV RV 2P94p\ VV4p V PRV R V R \RP V44 R V R2 4VPVV.4;_uu_4VPPR VR7p!\VV!4p"V"'d3\V"R4p#V#'dV PR \V#4 R24\V4p$V$'dV 'd V^,p%M V^,p%\ V%V4p%V PRV% RV% R24V PR4\V$\ 4'dT$p&M \V$R4p&\#V&VRR7p&V PR\V&4 R24V PR4V'dVP%.V!4p'V 'd V^,p(M V^,p(\ V(V4p(V !V(VV VR7p)V'Fbwp*p+V'gV*'dV*P('gK*V'g\+VV+V4V+nV+P,'gKXV)!RRV+4Kd V)P/4P14p,V,'dV PV,4V'dVP'd\3VV4Fqwp-p.\5VV-V 4p/V 'dTp0M V^,p0V.PVV..4;_uu_4\;V.VVV0VR!RV/R!V R"7 p1RRR4V PX14Ks RRR4V'dV PR#4V PR$4EK V'dV PR$4V'g V'gV PR4R%P V 4p2V'd(V'dTM\<p3R&\V 4 R'V3 R(V2 R)2p4V4#V2# +'giEL:;i +'giL;i +'giL;i)*aGenerate HTML documentation for a CLI application. Parameters ---------- app : App The cyclopts App instance to document. recursive : bool If True, generate documentation for all subcommands recursively. Default is True. include_hidden : bool If True, include hidden commands/parameters in documentation. Default is False. heading_level : int Starting heading level for the main application title. Default is 1. max_heading_level : int Maximum heading level to use. Headings deeper than this will be capped at this level. HTML supports levels 1-6. Default is 6. standalone : bool If True, generate a complete HTML document with , , etc. If False, generate only the body content. Default is True. custom_css : str Custom CSS to use instead of the default styles. command_chain : list[str] Internal parameter to track command hierarchy. Default is None. generate_toc : bool If True, generate a table of contents for multi-command apps. Default is True. flatten_commands : bool If True, generate all commands at the same heading level instead of nested. Default is False. Returns ------- str The generated HTML documentation. ) HtmlFormatterNz
    zzr z!
    z id="z" class="command-title">z z
    z
    z

    Table of Contents

    zz >Usage$)rz
    z
    )r-rrr1r:NNz!
    F) r,rr-r.r/r0r1r2r3u6↑ Back to topz  z z) - CLI Documentation z )cyclopts.help.formatters.htmlr5r$r&minjoinr r app_stackresolverrr!r%r isinstancerr _assemble_help_panelsresetshowrentries get_outputstripr rlenr#generate_html_docs DEFAULT_CSS)5rr,rr-r.r/r0r1r2r3r5rr full_commandtitleeffective_level anchor_idr7 description desc_textusage usage_level usage_texthelp_panels_with_groups formattergrouppanel panel_docsr&r'sub_command_chainsub_heading_leveleffective_sub_levelsub_help_formatsub_description sub_desc_text sub_usageusage_heading_levelsub_usage_text sub_panelspanel_heading_level sub_formatter sub_group sub_panelsub_panel_docs nested_name nested_app nested_chainnested_heading_level nested_docs body_contentcssdocs5&&&&&&&&&& rrKrKGsf<  E 67 88A; m? r/**=eWCGXXYZ[(5=##((1+xx . #L1 m? 89 !yk1OP[\hPiOjjtvEuFFG H --'' @R'SK%c;7K d3  LL8Y9O8PPVW XMcmmm 67 12 V5~QG W X # E -!+->?  r+i }A>? 01 eS ! !J%eT2J&z=M  *;z+B*C6JK X u  "%";";B "L #a'%# I OO/ u% /UNKEM === dD% (0%%'--/J Z  }}},SALD& 3M4 R  $1!$1A$5! LL< =()A-*Achh'8'<=>?EEG z4&)//1  #&&79J"K  LL()yk9WXcdgdldlm~dYAXBBLM`Laabc  !!3-00"("2"2":":=S^":"_"5fo"N"$0$$GM$ 'HUbIcHddj%kl*&1 '.;a.?+.;a.?+*-.ACT*U'LL2&9%:)DWCXXY!Z[LL!<=!)S11)2)5i)F%6~GXad%eNLL#6{>7R6SSY!Z[LL*!'!=!=b/!RJ(.;a.?+.;a.?+*-.ACT*U'$1&9'5!)&7 %M 1;, 9-)INNN$-0CFIWe0fI-$,,,)$i@ 1;&3%=%=%?%E%E%GN% ^4!1!1!13CFN3[/ Z':;Lk[c'd +3@03@13D0(116:2FGG*< **3/=.B2C+0+/.:-21A +KH [1/4\s1f UV LL &]Bb \" X99U#L&jK  ! "#   S   nHGG10sp,_0 A>` B1`>`A``- `7!`3``*`rzs?6 6!'8T n__r