!>#w ' ''r!textc^|dd}|dd}|S)z*Escape description text for bash comments.rr r%)r's r_escape_bash_descriptionr*Hs- <<c " "D <<c " "D Kr!actioncN|tjkrdS|tjkrdSdS)zMap completion action to bash compgen flags. Parameters ---------- action : CompletionAction Completion action type. Returns ------- str Compgen flags ("-f", "-d", or ""). z-fz-dr)rFILES DIRECTORIES)r+s r_map_completion_action_to_bashr/Os1!'''t #/ / /t 2r!r.c>g}|d|d|d|t||d|t||||S)aRGenerate the body of the bash completion function. Parameters ---------- completion_data : dict All extracted completion data. prog_name : str Program name. app : App Application instance. Returns ------- list[str] Lines of bash code for the completion function body. z! cur="${COMP_WORDS[COMP_CWORD]}"z$ prev="${COMP_WORDS[COMP_CWORD-1]}"r)rr _generate_command_path_detection_generate_completion_logic)rr r rs rrrcs* E LL4555 LL7888 LL LL1/BBCCC LL LL+OYLLMMM Lr!c t}t}|D]}|jD][}|sE|jjr9|jjD],}|dr||-\|jD]6}|j D],}|ds||-7g}| d|rHdt|D} d | } | d| dn| d| d| d |rHd t|D} d | } | d | dn| d | d| d | d| d| d| d| d| d| d| d| d| d| d| d| d| d| d| d| d| d| d| d| d| d | d!| d"| d#| d$| d| d| d| d| d| d| d| d| d| d| d| d%| d&| d'| d(| d)| d*| d+| d| d| d|S),a[Generate bash code to detect the current command path. This function generates two passes through COMP_WORDS: 1. First pass builds cmd_path by identifying valid command names 2. Second pass counts positionals (non-option words after the command path) The two-pass approach is necessary because we need to know the full command path length before we can correctly identify which words are positionals. Note: all_commands is built globally across all command levels. If a positional argument value happens to match a command name from a different level, it could be incorrectly classified (though this represents poor CLI design). Parameters ---------- completion_data : dict All extracted completion data. Returns ------- list[str] Lines of bash code for command path detection. rzD # Build list of options that take values (to skip their arguments)c,g|]}t|Sr&.0opts r z4_generate_command_path_detection..s!XXXS+C00XXXr!rz local options_with_values='r$z local options_with_values=''rzK # Build list of all valid command names (to distinguish from positionals)c,g|]}t|Sr5r6r8cmds rr:z4_generate_command_path_detection..s!QQQS+C00QQQr!z local all_commands='z local all_commands=''z> # Detect command path by collecting valid command words onlyz local -a cmd_path=()z local i skip_next=0z$ for ((i=1; i>> LLMNNN LL&''' LL LL LLYZZZ LLFGGG LL./// LL LL LL LL LLNOOO LL-... LL7888 LL!!! LL&''' LL7888 LL4555 LL6777 LL$%%% LL!""" LL LL1222 LLMNNN LL&''' LL LL LL*+++ LLDEEE LL2333 LL*+++ LL LLDEEE LL1222 LL LL LL Lr!c p g}|jrt|jnd}|jrt|jnd}|d|dt d|D}t |dzD]P fd|D}|s&|d d d kr'|t|dd ||n|d t|D]k}d |} |d | d|t||d|||dl|d|d|d|dR|d|d|d|S)aMGenerate the main completion logic using case statements. Parameters ---------- completion_data : dict All extracted completion data. prog_name : str Program name. app : App Application instance. Returns ------- list[str] Lines of bash code for completion logic. r5z4 # Determine command level and generate completionsz case "${#cmd_path[@]}" inc34K|]}t|VdSNlen)r8paths r z-_generate_completion_logic..s(AA$CIIAAAAAAr!c:g|]}t|k|Sr5rV)r8rXdepths rr:z._generate_completion_logic..s*XXX4SYYRWEWEW$EWEWEWr! )rz z case "${cmd_path[@]}" inrz "z")z z ;;z *)z esacz ;;z *)z esac) help_flagstuple version_flagsrmaxkeysranger_generate_completions_for_pathrHr) rr r rr_ra max_depthrelevant_pathsrXpath_strr\s @rr2r2sE* E*-.@s~&&&bJ030AIE#+,,,rM LLGHHH LL.///AA/*>*>*@*@AAAAAIy1}%%!!XXXX?+?+?+A+AXXX   _E___%%% A:: LL7XWacpqq r r r r LL9 : : :~.. - -88D>> 5555666 2?D,Xbdqrr ^,,,, LL & & & LL ( ( ( LL & & & Z     LL LL LL Lr! command_pathindentr_rac\||vr|dgS||}g}g}d|jD}|D]q} | jjpgD],} | dr|| -| jD],} | dr|| -rg} |jD]6} | jD],} | dr| | -7|D]4} | dr| |vr| | vr|| 5|D]4} | dr| |vr| | vr|| 5|| g}|jD]6} | jD],}|ds||-7d|jD}| d||d|r=d|D}d |}||d |d n||d ||d t|j}|r0t|j|||d}||n|r=d|D}d |}||d |d nA|r'|t||dn||d ||d|S)aGenerate completions for a specific command path. Parameters ---------- completion_data : dict All extracted completion data. command_path : tuple[str, ...] Current command path. indent : str Indentation string. help_flags : tuple[str, ...] Help flag names. version_flags : tuple[str, ...] Version flag names. Returns ------- list[str] Lines of bash code for completions at this command path. COMPREPLY=()cHg|]}||j| Sr5)is_positional_onlyshowr8args rr:z2_generate_completions_for_path..Qs2___C9O9O9Q9Q_VYV^_C___r!rc.g|]}|j |j|SrU)indexrorps rr:z2_generate_completions_for_path..rs([[[s 8MRURZ8Ms8M8M8Mr!c"|j|jndS)Nr)rs)as rz0_generate_completions_for_path..ss!'2Eqww1r!)keyzif [[ ${cur} == -* ]]; thenc,g|]}t|Sr5r6r7s rr:z2_generate_completions_for_path..xs!GGG.s33GGGr!rz COMPREPLY=( $(compgen -W '' -- "${cur}") )z COMPREPLY=()else c,g|]}t|Sr5r6r<s rr:z2_generate_completions_for_path..s!III/44IIIr!fi)r@rBrCrDr negativesrFrGrsortr_check_if_prev_needs_value#_generate_value_completion_for_prev_generate_positional_completion)rrirjr_rarKroptions keyword_argsrLrC flag_commandsrMflagrFrNpositional_argsescaped_options options_strneeds_value_completionvalue_completion_linesescaped_commands commands_strs rrere/s6?**'''(( < (D EG__4>___L %%&+1r % %Ds## %t$$$& % %Ds## %t$$$ %M"m++&, + +Ds## +$$T*** +!! ??3   !D$7$7D d|D}d|}||d|dnt |}|r||d |d n||d nn||d t|D]\}} | d}t| j}||d |d|r=d|D}d|}||d|dnEt |}|r||d|d n||d||d||d||d||d||d|S)aEGenerate position-aware positional argument completion. Parameters ---------- positional_args : list List of positional arguments sorted by index. indent : str Indentation string. Returns ------- list[str] Lines of bash code for position-aware positional completion. rZrTforcecFg|]}tt|Sr5r&rr8cs rr:z3_generate_positional_completion..s*ZZZQ23DQ3G3GHHZZZr!rCOMPREPLY=( $(compgen -W 'ryzCOMPREPLY=( $(compgen  -- "${cur}") )rlzcase ${positional_count} inr{r^cFg|]}tt|Sr5rrs rr:z3_generate_positional_completion..+"^"^"^QR#67H7K7K#L#L"^"^"^r! COMPREPLY=( $(compgen -W ' COMPREPLY=( $(compgen  COMPREPLY=() ;; *)esac)rW get_choicesrhintrrr/ enumerate) rrjrchoicesr+escaped_choices choices_str compgen_flagidxrLs rrrs E ?q  !!$00t0<<&q'9'>??  6ZZRYZZZO((?33K LLF__k___ ` ` ` `9&AAL 6 ]]l]]]^^^^ 4445555  ===>>>&77 , ,MC***66G*8=99F LLF,,c,,, - - - >"^"^V]"^"^"^!hh77  ggkggghhhh=fEE >LLF!e!el!e!e!effffLLF!|r$| t||n||d|S)aGenerate value completion based on previous word. Parameters ---------- arguments : ArgumentCollection Arguments with potential values. commands : list[str] Available commands at this level. positional_args : list List of positional arguments sorted by index. indent : str Indentation string. Returns ------- list[str] Lines of bash code for value completion. zcase "${prev}" inFc<g|]}|d|S)r)rD)r8rCs rr:z7_generate_value_completion_for_prev..s*ZZZ$T__UXEYEYZZZZr!Trr{r^cFg|]}tt|Sr5rrs rr:z7_generate_value_completion_for_prev.. rr!rrryrrrrrc,g|]}t|Sr5r6r<s rr:z7_generate_value_completion_for_prev..!MMMS 3C 8 8MMMr!r]rc,g|]}t|Sr5r6r<s rr:z7_generate_value_completion_for_prev..(rr!rrl) rrArBrCrrrrr/rr)r@rFrrjr has_casesrLrGrr+rCrrrrrs rrrs6& E LLF///000I,,       ZZ8#5#:#@bZZZ   &&T&22&x}55 , ,D LLF--d--- . . . >"^"^V]"^"^"^!hh77  ggkggghhhh=fEE >LLF!e!el!e!e!effffLLF!rs  *E*c*c****Z(((((( 33+;(%S/>9:  #Y Djd5c?N;Z6[j`deh`ijjjjZ:%S/>9::: : #Y ::::zc%S/>9:cS/c cc3h c c? c  #Y ccccL9S9T#Y9999xT*JT#YJadJimnqirJJJJJJr!