o io8@sUdZddlZddlmZdeedededefdd Zd edefd d Z deededede eeeffd dZ dededeededede eeff ddZ dededeededede eeff ddZ dededeededede eeff ddZeeeeeeege eeffZe e e eeedZeeefed<dedBdefddZdeedeeddfdd Zdeedeed!eddfd"d#ZdS)$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_indentreturncCs\|}|t|kr,||}|}t|t|}|r||kr#|d7}n |S|t|ks|S)aSkip 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)rrrilinestrippedindentrd/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/help/rst_preprocessor.py_skip_indented_blocks     rr cCs@|sdS|ddvrt|dkp|ddvStd|}|duS)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)rrematch)r rrrr _is_list_item1s    rcCsg}|}td}|t|kr?||}|}t|t|}||ks$|s8|r+t||}||||f|d7}nn|t|ks|tdkrI|d}g} g} d} |D]g\} }}|sg| rd| d| g} d} qQt|} ||k}| r| r}| d| g} | |d} qQ|r| r| d| g} ||}| d||d} qQ| r| r| d| g} | |d} qQ| r| d| | |fS)aGather 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). infrFrT)floatrr minappendjoinr)rrrcollected_linesr min_indentr r r paragraphscurrent_paragraphlast_was_empty_is_list is_code_blockrelative_indentrrr_gather_indented_blockFs`       r'directive_name directive_argcurrent_indentcCs.|dkrdnd}d|d|d}||dfS)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]rr)r(r)rrr*prefixtagrrr_handle_version_directives r2c CsLt||d|\}}d|}d|d}|r"|d||fS||fS)a Handle 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 vr/r)r'rstrip) r(r)rrr*r next_icontentr1rrr_handle_deprecated_directives r7cCsZ|r|gng}t||d|\}}||g}g} g} |D]T} t| } | do,| } | rA| r;|d| g} | | q| rU| rO|d| g} | | q| ra|d| g} | rm|d| g} || q| r}|d| | r|d| d|}dddd}||}|rd|d|dnd|d}||fS) a Handle 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. rr r3zNote:u ⚠ Warning:z See also:)notewarningseealso)r'extendr startswithr4rr)r(r)rrr*r more_paragraphsr5blocks current_listcurrent_code_blockparar$is_coder6 prefix_mapr0 formattedrrr_handle_admonition_directivesL    "rF)r+versionchanged deprecatedr9r:r;DIRECTIVE_HANDLERStextcs|sdS|d}gg}d}d}hd}|t|kr||}|}t|t|}|drd|vrtd|} | r~| d } | d } t | } | ru| | | |||\} }| |vrm|duret} | n| | |}nt ||d |}nt ||d |}n ||d 7}|t|ks|r|durt fd d t |d tD}|st||n t|nt|d}|S) 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. r8Nr>r9r;r:z..z::z\.\.\s+(\w+)::\s*(.*)rc3s|] }|VqdS)N)r4).0r  result_partsrr s  z,process_sphinx_directives..)splitrr r=rrgroupr4rIgetrranyrange_insert_version_tags_at_index_insert_version_tagsr)rJr version_tagsfirst_inline_directive_idxr admonition_directivesr r r*rr(r)handlerr1r5has_text_afterresultrrNrprocess_sphinx_directives6sT        !   r^rOrXcCsld|}|r/tt|dddD]}||r'||d|||<dSq||dS||dS)z:Insert version tags at the end of the last non-empty line.rrN)rrUrr4r)rOrX tags_textidxrrrrWs  rW before_indexcCsXd|}t|dddD]}||r#||d|||<dSq |||dS)zgInsert version tags before the specified index, appending to the last non-empty line before that index.rrr_N)rrUr4insert)rOrXrbr`rarrrrVs  rV)__doc__rcollections.abcrliststrintrboolrtupler'r2r7rFDirectiveHandlerrIdict__annotations__r^rWrVrrrrsp *Z      "M Z&