k7iAVSrSSKJr SSKJr SSKJr SSKJr \(aSSK J r S#S\ \ S-S \ \ S-S \ \\ S-\\ S-44S jjrS \ S \ \ S\\ S-S\\ S-SSS \4 SjrS \ S\\ S-S\\ S-S \ \ \ S-\ \ S-44SjrS$SSS\S\ S\ \ S-S \ \ S-S \ \ S-S \ \ \ \ S44SjjrS%S\ \ S\ \ \ \ S4S\ S-S S4SjjrS&SSS\S\S\S\ \ S-S\S \S\ \ S-S \ \ S-S!\S \ 4S"jjrg)'z9RST documentation generation functions for cyclopts apps.) TYPE_CHECKING) extract_text)BaseDocGenerator)make_rst_section_header)AppNcommands_filterexclude_commandsreturncSnUb!UVs1sHo3RSS5iM nnSnU(a!UVs1sHo3RSS5iM nnX$4$s snfs snf)abNormalize 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. N_-)replace)rr normalized_includecmdnormalized_excludes K/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/docs/rst.py_normalize_command_filtersr sl$"?NOkk#s3O?OP?Okk#s3?OP  11 PQs AAname parent_pathnormalized_commands_filternormalized_exclude_commandssubapprc U(aSRX/-5OUnU(aDX;dXS;ag[[U55H!nSRUSUS-5nXs;dM! g UbX;dXR;ag[[U55H!nSRUSUS-5nXr;dM! g U(dX;ag[US5(a5UR(a$UHnUR US-5(dM g gg)aDetermine 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_cmds r_should_include_commandr&*s63>v-.4I"  .)2Zs;'(A XXk'AE&:;N<) "-  -1Xs;'(A XXk'AE&:;N;) tA 6; ' 'F,<,<8 ((S999 cSnUbi/nUHYnURUS-5(a4U[U5S-SnURURSS55 MPX@:XdMWSn O U/:Xa/nSnU(ay/nUHqnURUS-5(a4U[U5S-SnURURSS55 MPURURSS55 Ms X64$)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). Nrrr r )r!rappendr) rrrsub_commands_filterr% sub_filtersub_exclude_commands exclude_cmd sub_excludes r_adjust_filters_for_subcommandr/es*!- 4J$$TCZ00'D A 8 #**:+=+=c3+GH#&*#5 " $"$ "!6K%%dSj11)#d)a-/: $++K,?,?S,IJ$++K,?,?S,IJ 7  44r'appinclude_hiddenprefixc /nUR(dU$Uc/n[X45upx[R"X5Hup[ XXxU 5(dMU(aUU 3OU n U R SS5R 5n URXU 45 XY/-n [U UU S3UUU S9nURU5 M U$)zoRecursively collect all commands for table of contents. Returns a list of (display_name, anchor, app) tuples.  r )r1r2rr r) rrriterate_commandsr&rlowerr)_collect_commands_for_tocextend)r0r1r2rr rcommandsrrrr display_nameanchor nested_pathnesteds rr7r7sH == >X?; )99#N & 9X^   ,2&$( %%c3/557v67!F* * )"^1%+-#   +O. Or'linesr9app_namecU(dgURS5 URS5 URS5 URS5 g)z5Generate TOC entries with proper indentation for RST.Nz.. contents:: Commandsz :local:z :depth: 2)r))r>r9r?s r_generate_toc_entriesrBs;  LL)* LL LL  LLr' recursive heading_level command_chain generate_tocflatten_commands no_root_titlec  SSKJn /n Uc/n[R"X5upnU(a)[ U5S:aSR USS5OUSnOUnS/nU(aUR U5 OURU 5 SR U5RSS5RS S5R5nU RS US 35 U RS 5 U (a U(dUnO+U(a U(aUnOU(aU[ U5-S- OUnU (aU(a.[UU5nU R U5 U RS 5 URRS SS9n[R"UU5nU(aGUS;n[USUS9nU(a0U RUR55 U RS 5 U (aU(a)U(a"U RS5 U RS 5 U (aU(a[R "U5nSnU(ak[#U[$5(aUnO [USSS9nU(a[R&"UUS S9nSU;a URSS 5R5nSU3nU(a_U RS5 U RS 5 UR)S5HnU RSU35 M U RS 5 UR+/U5nU "US-US9n[R,"UU5nUSnUSnUSn U(aU (aU(aU RS5 U RS 5 UHpun!n"UR/5 S U"lU"SSU"5 UR35R5n#U#(dMNU RU#5 U RS 5 Mr U(dU (GaU (aU(GaU RS5 U RS 5 UHpun!n"UR/5 S U"lU"SSU"5 UR35R5n#U#(dMNU RU#5 U RS 5 Mr U Hiun!n"UR/5 U"SSU"5 UR35R5n#U#(dMGU RU#5 U RS 5 Mk U(aUR4(a[7Xx5un$n%/n&[R8"X5H}un'n([;U'U&U$U%U(5(dMU RS 5 U(aUU'/-OU U'/n)U(aUn*OUn*[=U'U$U%5un+n,[?U(UUU*U)SUU+U,SS 9 n-U RU-5 M SR U 5$)!axGenerate 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) RstFormatterNrr4cycloptsr /z.. _:rA help_formatrestructuredtext)fallback)rPrst)preserve_markupz **Usage:**F)r2zUsage:zUsage: z:: z )rDr1 argumentsoptionsgroupedz**Arguments:**z **Options:**) rCr1rDrErFrGrr rH) cyclopts.help.formatters.rstrJr get_app_inforrr8r)rr6r app_stackresolveextract_descriptionrstrip extract_usage isinstancestrformat_usage_linesplit_assemble_help_panelscategorize_panelsresettitle get_outputrrr5r&r/generate_rst_docs).r0rCr1rDrErFrGrr rHrJr>r? 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,subdocss. rrhrhs]l: E )9)F)Fs)Z&HJ/2=/AA/Eqr*+=Y[K\rs? )/D!)-)-2#Y%23i$&2 3s8d?CHtO +,2:8 8c8!$C48"%SD 8  8  8v/5 /5 #C4/5"%SD/5 49t T#Y- -. /5h!(,)-$( 0 00 0#Y% 0 3i$& 0 cT! 0 %S% !0hVZ  9  $U3U?%; < HKd     &*"(,)-v vvv v 9t# v  vv#Y%v3i$&vv vr'