iHdZddlmZddlmZmZddlmZmZm Z m Z m Z m Z m Z erddlmZ ddeeddd ed ed ed ed dfdZdZ dddded edededededzdeedzdeded efdZy)z0HTML documentation generation for cyclopts apps.) TYPE_CHECKING) escape_html extract_text)build_command_chainextract_description extract_usagefilter_help_entriesformat_usage_linegenerate_anchoriterate_commands)Applinesappr include_hiddenapp_nameprefixdepthreturnNc |jsyt||D]\}}|r||n|}|d|jddj} d|dzz} |j | d| d|d|jr>|j | d t |||||d|dz|j | d |j | d y) z,Recursively generate HTML table of contents.N- z z
  • z z z
    • ) _commandsr replacelowerappend_generate_html_toc) rrrrrrnamesubapp display_name full_pathindents x/home/jay/workspace/.worktrees/task-2116-dev1/scripts/.codegraph-venv/lib/python3.12/site-packages/cyclopts/docs/html.pyrrs ==(n= ' f,2&$( j,"6"6sC"@!ABHHJ # x~i[kRS    LLF86* + ufnh<.XYHZ\ade\e f LLF87+ , xu%& 'a= :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; } recursive heading_levelmax_heading_level standalone custom_css command_chain generate_tocflatten_commandsc  ddlm} |g}g} |s|s| jd|s;|jd} | } | }t ||}| jd|d|d|dnv|r|dn|jd} d j |} t | }t ||}| jd | jd|d |d t| d |d |jjdd}t||}|r,t|d}|r| jdt|d|rs|sq|jre| jd| jd| jdt| ||| dd| jd| jdt|}|rt |dz|}| jd|d|d| jdt|t r|}n t|d}t#||d}| jdt|d| jd|j|g5|j%g|}ddd| |dz|| |}|j'D]A\}}|s|r |j(s|st+||||_|j,s8|dd|C|j/j1}|r| j||jr7t3||D]'\}}t5||| }| r|}n|dz}| jd t7|dkDr'| d d j |ddj9n| d |j9}t ||} | jd| d |d td j |d | d |j||g5|jjd|}!t||!}"|"r,t|"d}#|#r| jd!t|#dt|}$|$r| r|dz}%n|d"z}%t |%|}%| jd|%d|%d| jdt|$t r|$}&n t|$d}&t#|&|d}&| jdt|&d| jd|r|j%g|!}'| r|dz}(n|d"z}(t |(|}(| |(|| |})|'D]A\}*}+|s|*r |*j(s|st+||+||+_|+j,s8|)dd|+C|)j/j1},|,r| j|,|ry|jrmt3||D]^\}-}.t5||-| }/| r|}0n|d"z}0|.j||.g5t;|.|||0|d#d|/d#| $ }1ddd| j1`ddd|r| jd%| jd&*|r| jd&|s|s| jdd'j | }2|r!|r|nt<}3d(t| d)|3d*|2d+}4|4S|2S#1swYBxYw#1swYxYw#1swYxYw),aQGenerate 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. r) HtmlFormatterNz
    zzrz!
    z id="z" class="command-title">z z
    z
    z

    Table of Contents

    zrz >Usage$)rz
    z
    )r&rrr*rz!
    F) r%rr&r'r(r)r*r+r,u6↑ Back to topz  z z) - CLI Documentation z )cyclopts.help.formatters.htmlr.rrminjoinr r app_stackresolverrrrr isinstancestrr _assemble_help_panelsresetshowr entries get_outputstripr rlenrgenerate_html_docs DEFAULT_CSS)5rr%rr&r'r(r)r*r+r,r.rr full_commandtitleeffective_level anchor_idr0 description desc_textusage usage_level usage_texthelp_panels_with_groups formattergrouppanel panel_docsrrsub_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 r#rErEGsf<  E 67 88A; m->? r/**=eWCGXXYZ[(5=##((1+xx . #L1 m->? 89 !yk1OP[\hPiOjjtvEuFFG H --'' @R'SK%c;7K d3  LL8Y9O8PPVW XMcmm 67 12 V5#~xQG W X # E -!+->?  r+i }A>? 01 eS !J%eT2J&z=M  *;z+B*C6JK X u M"%";";B "LM#a'%# I OO/) u% /UNKEM == dD% ()%%'--/J Z  }},S.An 'LD& 3M4 R  $1!$1A$5! LL< =()A-*Achh'8'<=>?EEG z4&)//1  #&&79J"K  LL()yk9WXcdgdldlm~dYAXBBLM`Laabc  !!3-0P 2"("2"2":":=S^":"_"5fo"N"$0$$GM$ 'HUbIcHddj%kl*&1 '.;a.?+.;a.?+*-.ACT*U'LL2&9%:)DWCXXY!Z[LL!<=!)S1)2)5i)F%6~GXad%eNLL#6{>7R6SSY!Z[LL*!'!=!=b/!RJ(.;a.?+.;a.?+*-.ACT*U'$1&9'5!)&7 %M 1;A, 9-)INN$-0CFIWe0fI-$,,)$i@ A&3%=%=%?%E%E%GN% ^4!1!13CFN3[2/ Z':;Lk[c'd +3@03@13D0(116:2FG *< **3/=.B2C+0+/.:-21A +K  [1/2sP 2f UV LL &]n 'b \" X99U#L&jK  ! "#   SMMn  GP 2P 2s8Z',E5["B[)Z4 ?['Z14Z= 9[[ )r) TFrTNNTF)__doc__typingrcyclopts._markuprrcyclopts.docs.baserrrr r r r cyclopts.corer listr=boolintrrFrEr$r#rvs#6 6! ' 9' '' '  '  ' '8T r !&*"_ ___ _  _  _d _9t#___ _r$