!z-_normalize_command_filters..!s&OOOckk#s33OOOc:h|]}|ddSr rrs rrz-_normalize_command_filters..%s&PPPckk#s33PPPr)rr normalized_includenormalized_excludes r_normalize_command_filtersr sT$"OOOOOQPP?OPPP 1 11rname parent_pathnormalized_commands_filternormalized_exclude_commandssubapprc |rd||gzn|}|rP||vs||vrdStt|D])}d|d|dz}||vrdS*|||vs||vrdStt|D])}d|d|dz}||vrdS*|s||vrdSt|dr'|jr |D]}||dzrdSdSdS)a9Determine if a command should be included based on filters. Parameters ---------- name : str The command name. parent_path : List[str] Path to parent commands. normalized_commands_filter : Optional[Set[str]] Set of commands to include (already normalized). normalized_exclude_commands : Optional[Set[str]] Set of commands to exclude (already normalized). subapp : App The subcommand App instance. Returns ------- bool True if the command should be included, False otherwise. .FNT _commands)joinrangelenhasattrr% startswith) rrrr r! full_pathiparent_segment filter_cmds r_should_include_commandr/*s63>Gv-...4I" . . .)?Z2Z2Z5s;''((  A XXk'AE'&:;;N!<<<uu="- - - ->X1X1X4s;''((  A XXk'AE'&:;;N!;;;tt< t'AAA4 6; ' ' F,< 8  ((S99 44 u 4rcd}|ug}|D]h}||dzrD|t|dzd}||dd^||krd}ni|gkrg}d}|rg}|D]}||dzrD|t|dzd}||dd^||dd||fS)aAdjust filter lists for subcommand context. Parameters ---------- name : str The current command name. normalized_commands_filter : Optional[Set[str]] Set of commands to include (already normalized). normalized_exclude_commands : Optional[Set[str]] Set of commands to exclude (already normalized). Returns ------- Tuple[Optional[List[str]], Optional[List[str]]] Adjusted commands_filter and exclude_commands lists (denormalized). Nr#r$rr)r*r(appendr) rrr sub_commands_filterr. sub_filtersub_exclude_commands exclude_cmd sub_excludes r_adjust_filters_for_subcommandr7es_*!- 4  J$$TCZ00 'D A 8 #**:+=+=c3+G+GHHHHt##&*#$ " $ $"$ "K!6 K KK%%dSj11 K)#d))a-//: $++K,?,?S,I,IJJJJ$++K,?,?S,I,IJJJJ  4 44rFappinclude_hiddenprefixc g}|js|S|g}t||\}}tj||D]\} } t | |||| s|r|| n| } | dd} || | | f|| gz} t| || d||| }| ||S)zwRecursively collect all commands for table of contents. Returns a list of (display_name, anchor, app) tuples. N r)r:r;rr r) r%rriterate_commandsr/rlowerr1_collect_commands_for_tocextend)r9r:r;rr rcommandsrr rr! display_nameanchor nested_pathnesteds rr@r@s1H = >X)??; ; )9#~NN  f& +9;VX^    ,2<&($((( %%c3//5577vv6777!TF* * )"%%%+-#      OrlinesrBapp_namec|sdS|d|d|d|ddS)z5Generate TOC entries with proper indentation for RST.Nz.. contents:: Commandsz :local:z :depth: 2r8)r1)rGrBrHs r_generate_toc_entriesrJs`  LL)*** LL LL    LLrTr$ recursive heading_level command_chain generate_tocflatten_commands no_root_titlec ^ ddlm} g} |g}tj||\} } }|r9t |dkrd|ddn|d}n|}dg}|r||n|| d|ddd d }| d |d | d | r|s|}n |r|r|}n|r|t |zdz n|}| r|r:t||}| || d |j d d}tj ||}|rT|dv}t|d|}|r<| || d | r|r,|r*| d| d | r|rtj|}d}|rtt#|t$r|}nt|dd}|rtj||d }d|vr(|dd }d|}|ro| d| d |dD]}| d|| d |g|}| |dz|}tj||}|d}|d}|d} |r| r|r| d| d |D]\}!}"|d |"_|dd|"|}#|#r*| |#| d |s| r,| r|r'| d| d |D]\}!}"|d |"_|dd|"|}#|#r*| |#| d | D]x\}!}"||dd|"|}#|#r*| |#| d y|r|jrt7||\}$}%g}&tj||D]\}'}(t;|'|&|$|%|(s| d |r||'gzn| |'g})|r|}*n|}*t=|'|$|%\}+},t?|(|||*|)d||+|,d }-| |-d| S)!aGenerate reStructuredText 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 (uses '=' markers). 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. commands_filter : list[str], optional If specified, only include commands in this list. Supports nested command paths like "db.migrate". Default is None (include all commands). exclude_commands : list[str], optional If specified, exclude commands in this list. Supports nested command paths like "db.migrate". Default is None (no exclusions). no_root_title : bool If True, skip generating the root application title. Useful when embedding in existing documentation with its own title. Default is False. Returns ------- str The generated RST documentation. r) RstFormatterNr$r=cycloptsr/z.. _:r8 help_formatrestructuredtext)fallback)rXrst)preserve_markupz **Usage:**F)r;zUsage:zUsage: z:: z )rLr: argumentsoptionsgroupedz**Arguments:**z **Options:**) rKr:rLrMrNrOrr rP) cyclopts.help.formatters.rstrRr get_app_infor(r&rAr1rr?r app_stackresolveextract_descriptionrstrip extract_usage isinstancestrformat_usage_linesplit_assemble_help_panelscategorize_panelsresettitle get_outputr%rr>r/r7generate_rst_docs).r9rKr:rLrMrNrOrr rPrRrGrH full_command base_titlern anchor_parts anchor_nameeffective_heading_level header_linesrW descriptionpreserve desc_textusage usage_textlinehelp_panels_with_groups formatter categorizedargument_panels option_panelsgrouped_panelsrpaneloutputrr rrr!subcommand_chainnext_heading_levelr2r4subdocss. rrprpsl:99999 E )9)FsM)Z)Z&HlJ/2=/A/AA/E/Eqrr*+++=Y[K\RR$ "$ "LD&*k#=?Z\b  LL   :G\}v55XW[L\  3%2""&3"9W02M99 5 !5(#-0."!1 3!5#   G LL ! ! ! ! 99U  r)NN)Fr8NNN)N) TFr$NTFNNF)__doc__typingrcyclopts._markuprcyclopts.docs.baser cyclopts.help.formatters._sharedr cyclopts.corerlistrhtuplesetrboolr/r7r@rJintrprrrrsa?? ))))))//////DDDDDD"!!!!!!)-)-22#Y%23i$&2 3s8d?CHtO +,2222:8 8c8!$C48"%SD 8  8  8888v/5 /5 #C4/5"%SD/5 49t T#Y- -. /5/5/5/5h!(,)-$( 00 00 0#Y% 0 3i$& 0 cT! 0 %S% !0000hVZ   9  $U3U?%; < HKd        &*"(,)-vv vvv v 9t# v  vv#Y%v3i$&vv vvvvvvr