k7io8%SrSSKrSSKJr S\\S\S\S\4SjrS \S\4S jr S\\S\S\S\ \\\44S jr S \S \S\\S\S\S\ \\44 Sjr S \S \S\\S\S\S\ \\44 Sjr S \S \S\\S\S\S\ \\44 Sjr\\\\\\\/\ \\44r\ \ \ \\\S.r\\\4\S'S\S-S\4SjrS\\S\\SS4SjrS\\S\\S\SS4Sjrg)aPreprocessing utilities for reStructuredText content. This module provides workarounds for limitations in the rich_rst library when rendering Sphinx directives. While rich_rst handles standard reStructuredText well, it doesn't support Sphinx-specific directives (versionadded, deprecated, note, warning, etc.). Since Cyclopts docstrings may contain these directives, we preprocess RST content to convert Sphinx directives into plain text annotations before passing to rich_rst. This ensures users see meaningful information in CLI help rather than raw directive syntax. This is a pragmatic workaround; ideally this functionality would be in rich_rst itself. N)Callablelines start_index base_indentreturncUnU[U5:aQXnUR5n[U5[U5- nU(aXb:aUS- nOU$U[U5:aMQU$)aRSkip over lines indented more than base_indent. Parameters ---------- lines : list[str] All lines in the text. start_index : int Index to start from. base_indent : int Base indentation level; lines must be indented more than this. Returns ------- int Index of the first non-matching line (or len(lines) if reached end). )lenlstrip)rrrilinestrippedindents X/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/help/rst_preprocessor.py_skip_indented_blockrse" A c%j.x;;=TS]*6/ FA  H c%j. Hr cU(dgUSS;a[U5S:H=(d USS;$[R"SU5nUSL$)zCheck if a line is a list item. Parameters ---------- line : str The stripped line to check. Returns ------- bool True if the line starts with a list marker. Fr)-*+r )  z^\d+[\.\)](\s|$)N)r rematch)r rs r _is_list_itemr1sN  Aw/!4yA~7aK!77 HH($ /E  rc/nUn[S5nU[U5:atXnUR5n[U5[U5- nX:dU(d+U(a [XX5nUR XhU45 US- nOOU[U5:aMtU[S5:XaUS-n/n /n Sn UGH!upnU(d-U (a"U R SR U 55 /n Sn M;[ U5n X:nU (a>U (a"U R SR U 55 /n U R U5 Sn MU(aHU (a"U R SR U 55 /n X- nU R SU-U-5 Sn MU (a)U (a"U R SR U 55 /n U R U5 Sn GM$ U (a U R SR U 55 X4$)ajGather lines indented more than base_indent, preserving structure. This function preserves paragraph breaks (blank lines), list structure, and code block indentation while gathering indented content. List items are kept on separate lines. Lines that are indented beyond the minimum content indentation (like code blocks) preserve their relative indentation. Parameters ---------- lines : list[str] All lines in the text. start_index : int Index to start from. base_indent : int Base indentation level; lines must be indented more than this. Returns ------- content_lines : list[str] Content lines preserving paragraph structure. Each element represents either a paragraph (multiple lines joined with spaces), a single list item line, or indented code lines. end_index : int Index of the first non-matching line (or len(lines) if reached end). infr FrT)floatr r minappendjoinr)rrrcollected_linesr min_indentr rr paragraphscurrent_paragraphlast_was_empty_is_list is_code_blockrelative_indents r_gather_indented_blockr+Fs6OAuJ c%j.x;;=TS]*  x 4  " "D(#; < FA  c%j.U5\! 1_ JN.8 !!#((+<"=>$&!!N#H-G"/M$%%chh/@&AB(*%!!(+!&$%%chh/@&AB(*%"("5!!#"7("BC!&!&7%%chh/@&AB(*%!((2!&= /@#((#456 =rdirective_name directive_argcurrent_indentc4US:XaSOSnSUSUS3nXcS-4$)aHandle versionadded and versionchanged directives. Parameters ---------- directive_name : str Name of the directive (e.g., "versionadded"). directive_arg : str Version number argument. lines : list[str] All lines in the text. start_index : int Current line index. current_indent : int Current indentation level. Returns ------- tag : str Formatted tag text. next_index : int Next line index to process. versionaddedAddedChanged[z in v]r )r,r-rrr.prefixtags r_handle_version_directiver8s32'.8WiF fXU=/ +C a rc[X#S-U5upVSRU5R5nSUS3nU(a USU3U4$UU4$)aHandle deprecated directive with optional content. Parameters ---------- directive_name : str Name of the directive ("deprecated"). directive_arg : str Version number argument. lines : list[str] All lines in the text. start_index : int Current line index. current_indent : int Current indentation level. Returns ------- tag : str Formatted tag text with optional content. next_index : int Next line index to process. r  u[⚠ Deprecated in vr4r)r+r!strip) r,r-rrr.r$next_icontentr7s r_handle_deprecated_directiver>s^20QWJkk*%++-G q 1C!(cU!G9 6 99c6 99rcU(aU/O/n[X#S-U5upgURU5 /n/n /n UGH n [U 5n U RS5=(a U R 5n U (a<U (a"UR SR U 55 /n U R U 5 MzU (a<U (a"UR SR U 55 /n U R U 5 MU (a"UR SR U 55 /n U (a"UR SR U 55 /n UR U 5 GM# U (a UR SR U 55 U (a UR SR U 55 SR U5R 5nSSSS.nXnU(a SUSUS3OSUS3nUU4$) aHandle note, warning, and seealso directives. Parameters ---------- directive_name : str Name of the directive (e.g., "note", "warning", "seealso"). directive_arg : str Inline content on the directive line. lines : list[str] All lines in the text. start_index : int Current line index. current_indent : int Current indentation level. Returns ------- tag : str Formatted tag text with content. next_index : int Next line index to process. r r r:zNote:u ⚠ Warning:z See also:)notewarningseealso)r+extendr startswithr;r r!)r,r-rrr.r$more_paragraphsr<blocks current_listcurrent_code_blockparar(is_coder= prefix_mapr6 formatteds r_handle_admonition_directiverNs2%2-rJ4U!O^\Oo& FL%//#&74::< ! dii(:;<%'"    %  dii 56!  % %d + dii 56! ! dii(:;<%'" MM$ 16 dii -. dii 234kk&!'')G!J  'F18$vhay-VHD>QI f r)r0versionchanged deprecatedrArBrCDIRECTIVE_HANDLERStextc  ^U(dgURS5n/m/nSnSn1SknU[U5:GaLXnUR5n[U5[U5- nURS5(aSU;a[R "SU5n U (aU R S 5n U R S 5R5n [RU 5n U (aSU "XXU5upX;a.Uc [T5nTRU R55 OURU 5 UnO6[XS -U5nO&[XS -U5nOTRU5 US - nU[U5:aGMLU(a[UbL[U4S j[US -[T5555nU(d [TX#5 O[TU5 O [TU5 SR!T5R5nU$) uProcess Sphinx directives in reStructuredText content for CLI help display. Converts Sphinx directives to readable format: - .. versionadded:: X -> [Added in vX] - .. versionchanged:: X -> [Changed in vX] - .. deprecated:: X -> [⚠ Deprecated in vX] - .. note:: content -> Note: content - .. warning:: content -> ⚠ Warning: content - .. seealso:: content -> See also: content Unknown directives are silently removed but logged as debug messages. Parameters ---------- text : str | None The reStructuredText content to process. Returns ------- str Processed text with directives converted to inline annotations. Returns empty string if input is None or empty. r@Nr>rArCrBz..z::z\.\.\s+(\w+)::\s*(.*)r c3J># UHnTUR5v M g7f)N)r;).0r result_partss r ,process_sphinx_directives..s%!1iA Q%%''1is #)splitr r rErrgroupr;rQgetr ranyrange_insert_version_tags_at_index_insert_version_tagsr!)rRr version_tagsfirst_inline_directive_idxr admonition_directivesr rr.rr,r-handlerr7r<has_text_afterresultrXs @rprocess_sphinx_directivesrh6s0  JJt ELL!% A; c%j.x;;=TS]2   t $ $)9HH5x@E!&Q % A 4 4 6 ,00@").Sa"bKC%>5=9<\9J6$++CIIK8%++C0A,UE>JA(A~F    % FA= c%j.B % 1 !167QTU7UWZ[gWh1i!N"-lLe%\<@ !| < YY| $ * * ,F MrrXrbcSRU5nU(aV[[U5S- SS5H'nXR5(dMXSU3X' g UR U5 gUR U5 g)z:Insert version tags at the end of the last non-empty line.rr N)r!r_r r;r )rXrb tags_textidxs rrarasz&I\*Q.B7C &&(('3'8&99+$F !8 I&I&r before_indexcSRU5n[US- SS5H'nXR5(dMXSU3X' g URX#5 g)zgInsert version tags before the specified index, appending to the last non-empty line before that index.rr rjN)r!r_r;insert)rXrbrmrkrls rr`r`sd&I\A%r2.   " " $ $#/#4"5Qyk BL  /  0r)__doc__rcollections.abcrliststrintrboolrtupler+r8r>rNDirectiveHandlerrQdict__annotations__rhrar`r5rrrzs  $ S   # RU >*W$s)W#WCWTYZ^_bZcehZhTiWt  (+ 48I LO ad  38_ <::(+:48I:LO:ad: 38_:>JJ(+J48IJLOJadJ 38_JZS#tCy#s;U38_LM./. (++ 3D../WC$JW3Wt 'tCy 'S 'd ' 1S 1c 1be 1jn 1r