o iF@sdZddlmZddlmZmZddlmZerddlm Z  dde e ddd e d e d e d e d dfddZdZ        dddde d e de de de dBde e dBde de d e fddZdS) z0HTML documentation generation for cyclopts apps.) TYPE_CHECKING) escape_html extract_text)BaseDocGenerator)Applinesapprinclude_hiddenapp_nameprefixdepthreturnNc Cs|jsdSt||D]X\}}|r||n|}|d|dd} d|d} || d| d|d|jr[|| d t|||||d|d|| d || d q dS) z,Recursively generate HTML table of contents.N- z z
  • z z z
    • ) _commandsriterate_commandsreplacelowerappend_generate_html_toc) rrr r r r namesubapp display_name full_pathindentrX/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/docs/html.pyr s  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; } TFr recursive heading_level standalone custom_css command_chain generate_tocflatten_commandsc 1Csddlm} |dur g}g} |s|s| d|s2|jd} | } | } | d|d| d|dn?|r8|dn|jd} d |} | d d |d d}|d d }| d | d|d |dt| d|d |jj ddd}t ||}|rt |d}|r| dt|d|r|s|j r| d| d| dt| ||| dd| d| dt |}|r| d|d d|d d| dt|tr|}nt |d}t j||dd}| dt|d| d|g|}| |d || |d }||D]%\}}|s#|r#|js#q|s-t |||_|jr7|dd|q|}|rG| ||j rt ||D]q\}}t ||| }|rc|}n|d }| d t|d kr| d d |d dn| d |}| d|d |dtd |d|d ||g|jj d|d}t ||}|rt |d}|r| d!t|dt |} | r|r|d }!n|d"}!| d|!d|!d| dt| tr| }"nt | d}"t j|"|dd}"| dt|"d| d|ro|g|}#|r+|d }$n|d"}$| |$|| |d }%|#D]'\}&}'|sI|&rI|&jsIq9|sUd#d$|'jD|'_|'jr_|%dd|'q9|%}(|(ro| |(|r|j rt ||D](\})}*t ||)| }+|r|},n|d"},t|*|||,d%d|+d%|d& }-| |-q|Wdn 1swY|r| d'| d(qQ|r| d(|s|s| dd)| }.|r|r|nt}/d*t| d+|/d,|.d-}0|0S|.S).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. 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
    zzrrrz!
    z id="z" class="command-title">z z
    z
    z

    Table of Contents

    zz >Usage$)r z
    z
    )rr r r"z!
    cSs*g|]}|jrtdd|jDs|qS)css,|]}|dp|dp|dkVqdS)z--helpz --versionz-hN) startswith).0nrrr s  z0generate_html_docs...)namesall)r.errr sz&generate_html_docs..F)rr rr r!r"r#r$u6↑ Back to topz  z z) - CLI Documentation z )cyclopts.help.formatters.htmlr%rrjoinrrr app_stackresolverextract_descriptionrrr extract_usage isinstancestrformat_usage_line_assemble_help_panelsresetshowfilter_help_entriesentries get_outputstriprbuild_command_chainlengenerate_html_docs DEFAULT_CSS)1rrr rr r!r"r#r$r%rr full_commandtitle anchor_idr' description desc_textusage usage_texthelp_panels_with_groups formattergrouppanel panel_docsrrsub_command_chainsub_heading_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_contentcssdocrrrrH?s< .                          &               Y      rH)r)TFrTNNTF)__doc__typingrcyclopts._markuprrcyclopts.docs.baser cyclopts.corerlistr=boolintrrIrHrrrrsl