o i>%@s^dZddlmZmZerddlmZddlmZddlm Z ddlm Z m Z GdddZ d S) z,Base utilities for documentation generation.) TYPE_CHECKINGAny)App) HelpPanel) CommandSpec) format_doc format_usagec @sZeZdZdZed&dddeedBdeeeeffddZedeedBd ed edeefd d Z ed ed dddde de f ddZ eddde dee fddZ edddede dBfddZeddde dBfddZed'dedeededefddZe d(d!eee dfde deeeee dfffd"d#Zed(ddde fd$d%ZdS))BaseDocGeneratorz>Base class for documentation generators with shared utilities.Nappr command_chainreturncCsF|s |jd}|}|}n|r|dn|jd}d|}|}|||fS)adGet app name, full command path, and title. Parameters ---------- app : App The cyclopts App instance. command_chain : Optional[List[str]] Chain of parent commands leading to this app. Returns ------- Tuple[str, str, str] (app_name, full_command, title) r )namejoin)r r app_name full_commandtitlerX/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/docs/base.py get_app_infos   zBaseDocGenerator.get_app_info command_namercCs|r||gS||gS)arBuild command chain for a subcommand. Parameters ---------- command_chain : Optional[List[str]] Current command chain. command_name : str Name of the subcommand. app_name : str Name of the root app. Returns ------- List[str] Updated command chain. r)r rrrrrbuild_command_chain+s z$BaseDocGenerator.build_command_chainsubapp parent_appinclude_hiddencCs<||jvs ||jvr dSt|t|sdS|s|jsdSdS)aCheck if a command should be skipped. Parameters ---------- command_name : str Name of the command. subapp : App The subcommand App instance. parent_app : App The parent App instance. include_hidden : bool Whether to include hidden commands. Returns ------- bool True if command should be skipped. TF) _help_flags_version_flags isinstancetypeshow)rrrrrrrshould_skip_commandBs z$BaseDocGenerator.should_skip_commandpanelrcCs|r|jSdd|jDS)aKFilter help panel entries based on visibility settings. Parameters ---------- panel : HelpPanel The help panel to filter. include_hidden : bool Whether to include hidden entries. Returns ------- List[Any] Filtered panel entries. cS*g|]}|jrtdd|jDs|qS)css,|]}|dp|dp|dkVqdS)--help --version-hN) startswith.0nrrr ws*zBBaseDocGenerator.filter_help_entries...namesallr(errr tz8BaseDocGenerator.filter_help_entries..)entries)r!rrrrfilter_help_entriesas z$BaseDocGenerator.filter_help_entries help_formatcCst||}|S)aExtract app description. Parameters ---------- app : App The App instance. help_format : str Help format type. Returns ------- Optional[Any] The extracted description object, or None. )r)r r4 descriptionrrrextract_descriptionzs z$BaseDocGenerator.extract_descriptioncCs(|jdur |jr |jSdSt|g}|S)zExtract usage string. Parameters ---------- app : App The App instance. Returns ------- Optional[Any] The extracted usage object, or None. N)usager)r r7rrr extract_usages  zBaseDocGenerator.extract_usage$ usage_textprefixcCs|sdSd|vr|dd}|rd|nd}|dd}t|dkr7|r7|d|d|d}|S|rD|d|}|S|d|}|S)apFormat usage line with proper command path. Parameters ---------- usage_text : str Raw usage text. command_chain : List[str] Command chain for the app. prefix : str Prefix for the usage line (e.g., "$"). Returns ------- str Formatted usage line. zUsage:r N)replacestriprsplitlen)r:r r;rparts usage_linerrrformat_usage_lines z"BaseDocGenerator.format_usage_lineFhelp_panels_with_groupsc Cszggggd}|D]\}}|s|r|jsq |jdkrG|s=dd|jD}|r