o § iHBã@sàdZddlmZddlmZddlmZerddlmZ ddd d e d e d e e e e d ffd d„Z d de e de e e e d fdede dBd df dd„Z      d!dd de d e dede e dBde de d e fdd„ZdS)"z5Documentation generation functions for cyclopts apps.é)Ú TYPE_CHECKING)Ú extract_text)ÚBaseDocGenerator)ÚAppFÚÚapprÚinclude_hiddenÚprefixÚreturnc Cszg}|js|St ||¡D]-\}}|r|›|›n|}| dd¡ ¡}| |||f¡t|||›dd}| |¡q |S)zwRecursively collect all commands for table of contents. Returns a list of (display_name, anchor, app) tuples. ú ú-)rr )Ú _commandsrÚiterate_commandsÚreplaceÚlowerÚappendÚ_collect_commands_for_tocÚextend) rrr ÚcommandsÚnameÚsubappÚ display_nameÚanchorÚnested©rú\/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/docs/markdown.pyr s rNÚlinesrÚlevelÚapp_namec Cs’|D]D\}}}| d¡}d|}| ¡d} |r$|dkr$|›d|›} n |r.|›d|›} n|} |  ¡ dd¡}| |›d| ›d|›d¡qd S) z-Generate TOC entries with proper indentation.r z éÿÿÿÿrr z- [`z`](#ú)N)ÚcountÚsplitrrr) rrrrrrÚ_appÚdepthÚindentÚcmd_nameÚ full_namerrrÚ_generate_toc_entries's   ìr(TéÚ recursiveÚ heading_levelÚ command_chainÚ generate_tocÚflatten_commandsc; CsÞddlm}g}|durg}t ||¡\} } } |rd| ›dn| } | d|›d| ›¡| d¡|jjdd d } t || ¡}|r[| d v}t|d|d }|r[| |  ¡¡| d¡|r|s|j rt ||d }|r| d¡| d¡t ||d| d| d¡t  |¡}|r½| d¡| d¡| d¡t|tƒrŸ|}nt|ddd }tj||dd}| |¡| d¡| d¡| g| ¡}t ||¡}|d}|d}|d}|d}||d|dd}|r| d¡|D]\}}| ¡d|_|dd|ƒ| ¡  ¡}|r | |¡qì| d¡|rA| d¡|D] \}}| ¡d|_|dd|ƒ| ¡  ¡}|r:| |¡q| d¡|rƒ|D]<\}}|jr| d|j›d ¡| ¡|jd|j|j|jd!}|dd|ƒ| ¡  ¡}|r|| |¡| d¡qF|r³| d"¡|D] \}}| ¡d|_|dd|ƒ| ¡  ¡}|r¬| |¡q| d¡|j rät ||¡D]%\} }!t || | ¡}"|rÏ|}#n|d}#| d|#›d#d |"¡›d¡| d¡|! |!g¡±|!jjd| d }$|$d v}%t |!|$¡}&|&rt|&d|%d }'|'r| |'  ¡¡| d¡t  |!¡}(|(rY| d¡| d¡| d¡t|(tƒr;|(})nt|(ddd })tj|)|"dd}| |¡| d¡| d¡|r™|! g|$¡}*t |*|¡}+|+d},|+d}-|+d}.|+d}/|r€|d}0n|d$}0||0|dd}1|,r¸| d¡|,D]\}}|1 ¡|1dd|ƒ|1 ¡  ¡}|r±| |¡q•| d¡|-rå| d¡|-D]\}}|1 ¡|1dd|ƒ|1 ¡  ¡}|rÞ| |¡qÂ| d¡|.r'|.D]<\}}|jr%| d|j›d ¡|1 ¡|jd|j|j|jd!}|1dd|ƒ|1 ¡  ¡}|r | |¡| d¡qê|/r™|o/|!j }2|2ro| d"¡|/D].\}}|jD]%}3|3jre|3jd}4|3jrXt|3jd|%d nd}| d%|4›d&|›¡qAq:| d¡n*| d"¡|/D]\}}|1 ¡|1dd|ƒ|1 ¡  ¡}|r’| |¡qv| d¡Wdƒn 1s¤wY|râ|!j rât |!|¡D]+\}5}6t |"|5| ¡}7|rÇ|}8n|d}8t|6|||8|7d|d'}9| |9¡| d¡q¶q½d( |¡ ¡d(}:|:S))a¾Generate markdown 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 (single #). 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 markdown documentation. r)ÚMarkdownFormatterNú`ú#r rÚ help_formatÚrestructuredtext)Úfallback)ÚmarkdownÚmd)Úpreserve_markup)rz## Table of Contents)rrz **Usage**:z ```consoleFú$)r z```rÚ argumentsÚoptionsÚgroupedr)Úlist)r+rÚ table_stylez**Arguments**: z **Options**: z**z**: )ÚtitleÚentriesÚformatÚ descriptionz**Commands**: z `éz* `z`: )r*rr+r,r-r.Ú ) Ú!cyclopts.help.formatters.markdownr/rÚ get_app_inforÚ app_stackÚresolveÚextract_descriptionrÚstripr rr(Ú extract_usageÚ isinstanceÚstrÚformat_usage_lineÚ_assemble_help_panelsÚcategorize_panelsÚresetr>Ú get_outputÚ __class__r?r@rArÚbuild_command_chainÚjoinÚnamesÚgenerate_markdown_docsÚrstrip);rr*rr+r,r-r.r/rrÚ full_commandÚ base_titler>r2rAÚpreserveÚ desc_textÚ toc_commandsÚusageÚ usage_textÚ usage_lineÚhelp_panels_with_groupsÚ categorizedÚcommand_panelsÚargument_panelsÚ option_panelsÚgrouped_panelsÚ formatterÚ_groupÚpanelÚoutputÚ panel_copyrrÚsub_command_chainÚsub_heading_levelÚsub_help_formatÚ preserve_subÚsub_descriptionÚ sub_desc_textÚ sub_usageÚsub_usage_textÚ sub_panelsÚsub_categorizedÚsub_argument_panelsÚsub_option_panelsÚsub_grouped_panelsÚsub_command_panelsÚpanel_heading_levelÚ sub_formatterÚ will_recurseÚentryr&Ú nested_nameÚ nested_appÚnested_command_chainÚnested_heading_levelÚ nested_docsÚdocrrrrVBsÀ '                 ý     €      €  ü    €     €                ÿ     €      €  ü    €     ÿý€ø     € €vÿù €rV)Fr)rN)TFr)NTF)Ú__doc__ÚtypingrÚcyclopts._markuprÚcyclopts.docs.baserÚ cyclopts.corerÚboolrLr<ÚtuplerÚintr(rVrrrrÚsf    ÿÿÿÿ þÿÿÿÿÿ þùÿþýü ûúùø