idZddlmZddlmZddlmZddlmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZerddlmZ d.dd d ed ed eedzd eedzdeedzdedeeed ffdZdeedeeed fddfdZd/dd d edeed ffdZd/deedededdfdZdd dedeeddfdZdd deedeeddfdZ dd ded ed eedzd eedzdedeeddfdZ!deeddfdZ"d ed!eed fdeed"e#edzd#e#edzdef d$Z$ d0dd d%ed ed&e%d'e%deedzd(ed)ed eedzd eedzd*ed+ed,edefd-Z&y)1z5Documentation generation functions for cyclopts apps.) TYPE_CHECKING) extract_text)DEFAULT_FORMAT) adjust_filters_for_subcommandbuild_command_chainextract_description extract_usageformat_usage_linegenerate_anchor get_app_infois_all_builtin_flagsiterate_commandsnormalize_command_filtersshould_include_commandshould_show_commands_listshould_show_usage)AppNapprinclude_hiddenprefixcommands_filterexclude_commands parent_pathskip_filtered_commandreturnc 6g}|g}t||\}} t||D]t\} } t| ||| | s|xr | j} | s|r|| n| } |j | | f|| gz}|| d}t | |||||d}|j |v|S)zoRecursively collect all commands for table of contents. Returns a list of (display_name, app) tuples.  F)rrrrrr)rrr _commandsappend_collect_commands_for_tocextend)rrrrrrrcommandsnormalized_commands_filternormalized_exclude_commandsnamesubappskip_this_command display_name nested_path nested_prefixnesteds |/home/jay/workspace/.worktrees/task-2116-dev1/scripts/.codegraph-venv/lib/python3.12/site-packages/cyclopts/docs/markdown.pyr r sH >W)?; ;)n= f% +9;VX^  2Ff6F6F 06fXdV,DL OO\62 3"TF* !(4&* * ) +-#"'  7 : Olinesr"c i}|D]w\}}|jddz }d|z}|jd}t|}||vr||xxdz cc<|d||}nd||<|j|d|d|d yy ) zGenerate TOC entries with proper indentation. Parameters ---------- lines : list[str] List to append TOC entries to. commands : list[tuple[str, "App"]] List of (display_name, app) tuples. rz _rz- [``](#)N)countsplitr r) r.r" anchor_countsr(_appdepthindentcmd_nameanchors r,_generate_toc_entriesr=Qs%'M& = d""3'!+%%%'+ . ] " & !Q & !xqv!6 78F$%M& ! xtH:T&;< =r-cTi}|jrt||D] \}}|||< |S)a/Build 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. )rr)rr command_mapr%r&s r,_build_command_mapr@ms:K }},S.A 'LD& &K  ' r-content add_blankcR|r|j||r|jdyy)aAppend content to lines if present, optionally adding blank line. Parameters ---------- lines : list[str] List to append to. content : str Content to append (only if non-empty). add_blank : bool Whether to add a blank line after content. N)r)r.rArBs r,_append_if_presentrEs' W Rr- help_formatct||}|rF|dv}t|d|}|r1|j|j|jdyyy)aExtract and render app description. Parameters ---------- app : App The app to extract description from. help_format : str Help format (e.g., "markdown", "rich"). lines : list[str] List to append description to. markdownmdNpreserve_markuprD)rrrstrip)rrFr. descriptionpreserve desc_texts r,_render_description_sectionrQsX&c;7K"44 dHM  LL* + LL   r- command_chainct|rt|}|rr|jdt|tr|}nt |dd}t ||}|j||jd|jdyyy)zRender usage console block. Parameters ---------- app : App The app to extract usage from. command_chain : list[str] Command chain for usage line. lines : list[str] List to append usage to. z ```consoleNFrKz```rD)rr r isinstancestrrr )rrRr.usage usage_text usage_lines r,_render_usage_sectionrYs|c"  LL &%%" )%uM *:}EJ LL $ LL  LL  r-app_namect|||r|dnd|||}|r@|jd|jdt|||jdyy)aGenerate and render table of contents. Parameters ---------- app : App The app to generate TOC for. app_name : str Application name for TOC prefixes. include_hidden : bool Whether to include hidden commands. commands_filter : list[str] | None Commands to include. exclude_commands : list[str] | None Commands to exclude. skip_filtered_command : bool Whether to skip the single filtered command in TOC. lines : list[str] List to append TOC to. rrD)rrrrrz## Table of ContentsN)r rr=)rrZrrrrr. toc_commandss r, _render_tocr]sc:- %!)(1~r')3 L +, Re\2 R r-c8|j|jd}|dd||jj}|rN|jr|j d|jd|j ||j dyy)a Render a parameter panel as-is. Parameters ---------- panel : HelpPanel The parameter panel to render. formatter : MarkdownFormatter Formatter to use for rendering. lines : list[str] List to append rendered content to. rD)titleN****: )resetcopy get_outputrMr_r)panel formatterr. panel_copyoutputs r,_render_parameter_panelrisOO"%J dD*%  ! ! # ) ) +F ;; LL2ekk]%0 1 V R r-entriesr?normalized_filternormalized_excludecg}|D]j}|js|jd}|j|}||5|8|j|Jt|||||sZ|j|l|S)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. r)namesgetrr) rjr?rrkrlfiltered_entriesentryr;r&s r,_filter_command_entriesrr s6 3 ;;{{1~H __X.F~$,1C1K$++E2*(KARTfhno$++E2 3 r- recursive heading_levelmax_heading_level generate_tocflatten_commands no_root_titlecode_block_title skip_preamblec ddlm} g}|g}d}nd}|xr|duxrt|dk(}t||\}}}|r | rd|dn|}n|}|s:| r|s6t ||}|j d|zd ||j d |j jd t }|s| s t||||s| s t||||r|s|jrt||||| |||s|j |g5|jg|}dddt|| \}}g}t|d }| |dz|d}D]d\}}|s|r |j s|j"dk(r|j$Dcgc]'}|j&rt)||j&r&|)} }| sgt+| ||||}!|!sy|j,r|j d|j,d|!D]}"|"j&s|"j&d}#|d |#}$t/|$}%|"j0rt3|"j0ddnd }&|&r|j d|#d|%d|&t|j d|#d|%d|j d G|j"dk(sXt5|||gnt|| \}}g}|jrt7||D]\}'}(t9|'||||(st;||'|})|r|}*n | r|s|}*n|dz}*|duxrt|dk(}+|+xr|duxr|'|dk(},|+xr|duxr|dj=|'dz}-|xr|,}.| xr|xr|-}/| xr|,}0|.sS|/sQd j?|)}1| rd|1dn|1}2t |*|}3|j d|3zd |2|j d |0xs|/}4|(j ||(g5|(j jd | }5|5dv}6|4st|(|)|t|(|5||r&|(jg|5}7tA|'||\}8}9t|8|9\}:};t|(d }n|dz}>| |>|d}?|xr |(j}@|7D]\}}|s|r |j s|j"dk(rstC|(rg|j$Dcgc]'}|j&rt)|(|j&r&|)}A}|Ass@rg} AD]}"|"j&s|"j&d}#|