+ Q(i@Rt^RIHt^RIHt^RIHtHtHtH t H t H t H t H t HtHt]'d^RIHtRRltRRltRR R lltR R ltR RltRRRlltR#)z9RST documentation generation functions for cyclopts apps.) TYPE_CHECKING) extract_text) adjust_filters_for_subcommandextract_description extract_usagegenerate_anchor get_app_infois_all_builtin_flagsiterate_commandsnormalize_command_filtersshould_include_commandshould_show_usage)AppcFV^8dQhR\R\\,/#)titlereturn)strlist)formats"W/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/cyclopts/docs/rst.py __annotate__rsST#YcRRRV 2.#)zCreate an RST code block containing the title. Parameters ---------- title : str Title text to display in code block. Returns ------- list[str] RST formatted code block lines. z.. code-block:: textz rs&rmake_rst_code_block_titlers  eW  rcRV^8dQhR\R\R\\,/#)rrlevelr)rintr)rs"rrr+s%#"#"3#"s#"tCy#"rc ^R^R^R^R^R^R/pV^8d^pM V^8d^pW!,pV\V4,pV^8XdW@V.#W.#)zCreate an RST section header. Parameters ---------- title : str Section title. level : int Heading level (1-6). Returns ------- list[str] RST formatted section header lines. =-^"'~)len)rrmarkersmarker underlines&& rmake_rst_section_headerr,+ss 3 3 3 3 3 3 G qy  ^FU#I z),,!!rcNV^8dQhRRR\R\\R3,/#)rapprinclude_hiddenr)booldictr)rs"rrrQs*E44U CSrc^/pVP'd\W4F wr4WBV&K V#)aBuild mapping of command names to App objects. Parameters ---------- app : App The app to extract commands from. include_hidden : bool Whether to include hidden commands. Returns ------- dict[str, App] Mapping of command names to App instances. ) _commandsr )r.r/ command_mapnamesubapps&& r_build_command_mapr7Qs2K }}},SALD & B rc V^8dQhR\R\\R3,R\\,R\\,R,R\\,R,R\/#) rentriesr4r parent_pathnormalized_filterNnormalized_excluder)rr1rset)rs"rrrgsa(( (c5j!(c(3x$ ( C4 (  (rc.pVFpVP'gKVP^,pVPV4pVf VfVfVPV4KZK\K^\WrW4V4'gKsVPV4K V#)aFilter command entries based on inclusion/exclusion rules. Parameters ---------- entries : list Command entries to filter. command_map : dict[str, App] Mapping of command names to App objects. parent_path : list[str] Parent command path. normalized_filter : set[str] | None Normalized filter set. normalized_exclude : set[str] | None Normalized exclude set. Returns ------- list Filtered command entries. )namesgetappendr ) r9r4r:r;r<filtered_entriesentrycmd_namer6s &&&&& r_filter_command_entriesrEgs6 ;;;{{1~H __X.F~$,1C1K$++E22L,*(ARhnoo$++E2 rc>V^8dQhR\\,RR/#)rlinesrN)rr)rs"rrrs  c t rcVPR4VPR4VPR4VPR4R#)zGenerate table of contents using RST contents directive. The `.. contents::` directive automatically generates a TOC from section headings, which is the idiomatic approach for RST/Sphinx. z.. contents:: Table of Contentsz :local:z :depth: 6rN)rA)rGs&r _generate_tocrIs5  LL23 LL LL  LLrNc$V^8dQhRRR\R\R\R\R\\,R,R \R \R \\,R,R \\,R,R \R\R\R\/#)rr.r recursiver/ heading_levelmax_heading_level command_chainN generate_tocflatten_commandscommands_filterexclude_commands no_root_titlecode_block_title skip_preambler)r0r rr)rs"rrrsyy yyy y  y 9t# yyy#Y%y3i$&yyyy yrc ^RIHp .pVf.p\W4wpppV'dV'g VR,pM V'dTpMTpR.pV'dVPV4MVP V4\ RP V44PRR4pVP RV R24VP R 4V 'd V'gTpM6V'd V'dTpM#V'dV\V4,^, MTp\VV4pV 'd V'dCV 'd \V4pM \VV4pVPV4VP R 4VPPR R R 7pV 'Eg\V4'Ed V 'd V'd\V4pRpV'd\!V\"4'dTpM\%VRR R7pV'dRVP'R^4p\V4^8dRP V4 RV^, 2pMRP V4pV'd`VP R4VP R 4VP'R4FpVP RV 24K VP R 4V 'g`\)VV4pV'dLVR 9p\%VRVR7pV'd1VP VP+44VP R 4V'd&V'gVP,'d \/V4VPV.4;_uu_4VP1.V4pRRR4\3W4wp p!.p"\5VRR7p#V !V^,VR7p$XEFWwp%p&V'gV%'dV%P6'gK+V 'd V'gK=V&P8R8XEd<V&P:U'u.uF5p'V'P<'d\?VV'P<4'dK3V'NK7 p(p'V('gK\AV(V#V"V V!4p)V)'gKV&PB'd1VP RV&PB R24VP R 4V)Fp*V*P<'dV*P<^,MR p+\%V*PDR4p,VP RV+ R24V,'dVP RV, 24VP R 4K EKV&P8R8XgEKV$PG4V&PIR R7p-V$!RRV-4V$PK4P+4p.V.'gEKV&PB'd1VP RV&PB R24VP R 4VP V.4VP R 4EKZ V'EdVP,'Ed\3W4wp p!.p"\MW4EFtwp/p0\OV/V"V V!V04'gKVP R 4V'd VV/.,MVV/.p1V'dTp2MV 'dV'g V^, p2MTp2\QV/V V!4wp3p4V'*;'d9T ;'d/VRJ;'d#\V4^8H;'d V/V^,8Hp5V'*;'dLT ;'dBVRJ;'d6\V4^8H;'d V^,PSV/R,4p6V0PVV0.4;_uu_4\UT0TTT2TT1R TT3T4T6T T5;'gT6R7 p7RRR4VP X74EKw ^RI+p8RP V4p9V8PYRRV94p9V9# +'giELw;iuup'i +'giLi;i)!a1Generate 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). max_heading_level : int Maximum heading level to use. Headings deeper than this will be capped at this level. RST uses different underline characters for each level. Default is 6. 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. skip_preamble : bool If True, skip the description and usage sections for the target command when filtering to a single command via ``commands_filter``. Useful when the user provides their own section introduction. Default is False. Returns ------- str The generated RST documentation. ) RstFormatterNcyclopts /r#z.. _:r help_formatrestructuredtext)fallbackF)preserve_markupz:: z T)r/)rLr/commandz**z:**z`` parameterr.) rKr/rLrMrNrOrPrQrRrSrTrUz\n{3,}z )r]rst)-cyclopts.help.formatters.rstrWrextendrArjoinreplacer(minrr, app_stackresolver r isinstancerrsplitrstripr3rI_assemble_help_panelsr r7showrr9r?r rEr descriptionresetcopy get_outputr r r startswithgenerate_rst_docsresub):r.rKr/rLrMrNrOrPrQrRrSrTrUrWrGapp_name full_command base_titler anchor_parts anchor_nameeffective_heading_level header_linesr\usage usage_textpartslinerrpreserve desc_texthelp_panels_with_groupsnormalized_commands_filternormalized_exclude_commandsr:r4 formattergrouppanelecommand_entriesrBrC primary_namedesc panel_copyoutputr5r6subcommand_chainnext_heading_levelsub_commands_filtersub_exclude_commandsis_single_targetis_intermediate_pathsubdocsrxdocs:&&&&&&&&&&&&& rrwrwsD: E )5c)I&HlJ -b! K=1+<^\I0 u%    <<9 $*/--p-QL`adfgfmfmLnqq-Op" 7k;UWr  ${{{ r%++c23 R *16u{{1~" #E$5$5t< r,r23LL4v/ R *\\[ ( OO "-J dD* -))+113Fv;;;LL2ekk]#!67LL$ V$ R k0nyS]]]B[ C ?"$? ,SALD&)k#=?Z\b LL 9F}v5XW[L\ %2"}%2Q%6"%2"8U02M9 5 !5"!//!//#4///(A-//OA.. "!>>!>>#4/>>(A->>$A&11$*= !!!3-00+'#1"4&7"2!&%5$7%9"6%5"2"J"J6J1 LL !oBt ))E C &&FC (C JY   8qp10s*__1_19_12#_6 _. 6 ` )T) TFNTFNNFFF)__doc__typingrcyclopts._markuprcyclopts.docs.baserrrrrr r r r r cyclopts.corerrr,r7rErIrwrrrrsL? )   !(#"L,(V yyr