o iA@sdZddlmZddlmZddlmZddlmZer"ddl m Z   d-de e dBd e e dBd e ee dBee dBffd d Zd e de e dee dBdee dBddd ef ddZd e dee dBdee dBd e e e dBe e dBffddZ     d.dddede de e dBd e e dBde e dBd e e e e dffddZ d/de e de e e e dfd e dBd dfd!d"Z #  $  #    d0ddd%eded&ed'e e dBd(ed)ede e dBd e e dBd*ed e fd+d,ZdS)1z9RST documentation generation functions for cyclopts apps.) TYPE_CHECKING) extract_text)BaseDocGenerator)make_rst_section_header)AppNcommands_filterexclude_commandsreturncCs8d}|dur dd|D}d}|rdd|D}||fS)aNormalize command filter lists by converting underscores to dashes. Parameters ---------- commands_filter : Optional[List[str]] List of commands to include. exclude_commands : Optional[List[str]] List of commands to exclude. Returns ------- Tuple[Optional[Set[str]], Optional[Set[str]]] Normalized include and exclude sets for O(1) lookup. NcSh|]}|ddqS_-replace.0cmdrW/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/docs/rst.py !z-_normalize_command_filters..cSr r rrrrrr%rr)rrnormalized_includenormalized_excluderrr_normalize_command_filters srname parent_pathnormalized_commands_filternormalized_exclude_commandssubapprc Cs|r d||gn|}|r3||vs||vrdStt|D]}d|d|d}||vr2dSq|dur}||vs?||vrAdStt|D]}d|d|d}||vr[dSqG|sd||vrddSt|dr{|jr{|D] }||drzdSqndSdS)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) rrrrr full_pathiparent_segment filter_cmdrrr_should_include_command*s4 r+c Csd}|dur6g}|D]%}||dr'|t|dd}||ddq ||kr/d}nq |gkr6g}d}|reg}|D]&}||dr[|t|dd}||ddq>||ddq>||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). Nrr r r )r&r$appendr) rrrsub_commands_filterr* sub_filtersub_exclude_commands exclude_cmd sub_excluderrr_adjust_filters_for_subcommandes,r2Fappinclude_hiddenprefixc Csg}|js|S|dur g}t||\}}t||D]>\} } t| |||| s'q|r/|| n| } | dd} || | | f|| g} t| || d||| d}| |q|S)zwRecursively collect all commands for table of contents. Returns a list of (display_name, anchor, app) tuples. N r )r5r6rrr) r!rriterate_commandsr+rlowerr,_collect_commands_for_tocextend)r4r5r6rrrcommandsrrrr display_nameanchor nested_pathnestedrrrr:s6    r:linesr<app_namecCs4|sdS|d|d|d|ddS)z5Generate TOC entries with proper indentation for RST.Nz.. contents:: Commandsz :local:z :depth: 2r3)r,)rAr<rBrrr_generate_toc_entriess    rCTr recursive heading_level command_chain generate_tocflatten_commands no_root_titlec . Csvddlm} g} |durg}t||\} } }|r-t|dkr(d|ddn|d}n|}dg}|r:||n|| d|ddd d }| d |d | d | rc|sc|}n|rj|rj|}n |rt|t|dn|}| rz|rt ||}| || d |j j d dd}t ||}|r|dv}t|d|d}|r| || d | r|r|r| d| d | r|rt|}d}|rt|tr|}nt|ddd}|rtj||d d}d|vr|dd }d|}|r| d| d |dD] }| d|q | d |g|}| |d|d}t||}|d}|d}|d} |rx| rF|rx| d| d |D]%\}!}"|d |"_|dd|"|}#|#rv| |#| d qR|s~| r| r|r| d| d |D]%\}!}"|d |"_|dd|"|}#|#r| |#| d q| D]"\}!}"||dd|"|}#|#r| |#| d q|r6|jr6t||\}$}%g}&t||D]D\}'}(t|'|&|$|%|(sq| d |r ||'gn| |'g})|r|}*n|}*t|'|$|%\}+},t|(|||*|)d||+|,dd }-| |-qd| 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 r7cycloptsr /z.. _:r3 help_formatrestructuredtext)fallback)rPrst)preserve_markupz **Usage:**F)r6zUsage:zUsage: z:: z )rEr5 argumentsoptionsgroupedz**Arguments:**z **Options:**) rDr5rErFrGrHrrrI) cyclopts.help.formatters.rstrJr get_app_infor$r"r;r,rr9r app_stackresolveextract_descriptionrstrip extract_usage isinstancestrformat_usage_linesplit_assemble_help_panelscategorize_panelsresettitle get_outputr!rr8r+r2generate_rst_docs).r4rDr5rErFrGrHrrrIrJrArB full_command base_titlerf anchor_parts anchor_nameeffective_heading_level header_linesrO descriptionpreserve desc_textusage usage_textlinehelp_panels_with_groups formatter categorizedargument_panels option_panelsgrouped_panelsr paneloutputrrrrrsubcommand_chainnext_heading_levelr-r/subdocsrrrrhs 6(                                          rh)NN)Fr3NNN)N) TFr NTFNNF)__doc__typingrcyclopts._markuprcyclopts.docs.baser cyclopts.help.formatters._sharedr cyclopts.corerlistr`tuplesetrboolr+r2r:rCintrhrrrrs           ;   4    4