lKjpP dZddlZddlmZddlmZddlmZmZm Z m Z m Z m Z erddl mZddd ed efd Zd ed efd Zdeeded eefdZded efdZded efdZdeeedfefd eddd eefdZdeeedfefd eefdZdeeedfefd eddd eefdZdeeedfefdeedfdedeedfdeedfd eef dZded eefdZd efdZd eeded eefd!Zy)"zBash completion script generator. Generates static bash completion scripts using COMPREPLY and compgen. Targets bash 3.2+ with no external dependencies. N) TYPE_CHECKING)is_iterable_type)CompletionActionCompletionDataclean_choice_textescape_for_shell_patternextract_completion_dataget_completion_action)Appappr prog_namereturnc|rtjd|std|d|jdd}t |}d|ddd|d d dg}|j t ||||j d g|jd|jd |d ||jddj|S)aGenerate bash completion script. Parameters ---------- app : App The Cyclopts application to generate completion for. prog_name : str Program name (alphanumeric with hyphens/underscores). Returns ------- str Complete bash completion script. Raises ------ ValueError If prog_name contains invalid characters. z^[a-zA-Z0-9_-]+$zInvalid prog_name: z0. Must be alphanumeric with hyphens/underscores.-_z# Bash completion for z# Generated by Cycloptsz() {z local cur prev}z complete -F _  ) rematch ValueErrorreplacer extend"_generate_completion_function_bodyappendjoin)r r func_namecompletion_dataliness i/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/cyclopts/completion/bash.pygenerate_completion_scriptr"s( BHH%8)D.ym;klmm!!#s+I-c2O ! ,! I;e  E LL3OYPSTU LL# LL LL= 1YK89 LL 99U choicec|jdd}|jdd}|jdd}|jdd}|S) a1Escape a choice for embedding inside a bash double-quoted string. Choices live inside ``local -a _c=("..." "...")`` arrays in the generated script (not as ``compgen -W`` whitespace-split tokens), so the only characters the shell still interprets are ``\``, ``"``, ``$`` and backtick. \z\\"z\"$z\$`z\`r)r$s r!_escape_bash_choicer+EsI^^D& )F ^^C 'F ^^C 'F ^^C 'F Mr#choicesindentc|Dcgc] }t|}}djd|D}|d|d|d|d|d|dgScc}w) aEmit bash that prefix-matches ``$cur`` against an array of choices. Avoids ``compgen -W`` whitespace tokenization, which mangles choices containing spaces, single quotes, or characters re-parsed by the surrounding ``$(...)`` (e.g. backticks). Parameters ---------- choices : list[str] Raw choice strings (already cleaned via ``clean_choice_text``). indent : str Indentation prefix. Returns ------- list[str] Bash code lines. rc3(K|] }d|d yw)r'N).0cs r! z*_emit_choice_completion..hs4GqAaS(Gsz local -a _c=() COMPREPLY=()zfor _x in "${_c[@]}"; doz0 [[ "$_x" == "${cur}"* ]] && COMPREPLY+=("$_x")done)r+r)r,r-r2escaped array_bodys r!_emit_choice_completionr9Tsz&077w!"1%wG74G44J (- |1- (, (,- (DE ($  8sA textcN|jdd}|jdd}|S)z*Escape description text for bash comments.rr r*)r:s r!_escape_bash_descriptionr=rs' <<c "D <<c "D Kr#actioncT|tjk(ry|tjk(ryy)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_bashrBys+!''' #// / r#r.cg}|jd|jd|jd|jt||jd|jt||||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 r s r!rrsh* E LL45 LL78 LL LL1/BC LL LL+OYLM Lr#c t}t}|jD]}|jD]h}|jr|jj s+|jj D]%}|j ds|j|'j|jD]6}|jD]%}|j dr|j|'8g}|jd|r0djt|} |jd| dn|jd|jd|jd|r0djt|} |jd | dn|jd |jd|jd |jd |jd |jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd |jd!|jd"|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd|jd#|jd$|jd%|jd&|jd'|jd(|jd)|jd|jd|jd|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)rz local options_with_values=''z local options_with_values=''rzK # Build list of all valid command names (to distinguish from positionals)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 LLMN LL&' LL LL LLYZ LLFG LL./ LL LL LL LL LLNO LL-. LL78 LL! LL&' LL78 LL45 LL67 LL$% LL!" LL LL12 LLMN LL&' LL LL LL*+ LLDE LL23 LL*+ LL LLDE LL12 LL LL LL Lr#c 2g}|jrt|jnd}|jrt|jnd}|jd|jdt d|j D}t |dzD]=}|j Dcgc]}t||k(s|} }| s3|jd|d|dk(r|jt|dd ||n|jd t| D]o}|D cgc] } t| } } d j| } |jd | d |jt||d|||jdq|jd|jd|jd|jd@|jd|jd|jd|Scc}wcc} w)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. r0z4 # Determine command level and generate completionsz case "${#cmd_path[@]}" inc32K|]}t|yw)N)len)r1paths r!r3z-_generate_completion_logic..9sA*@$CI*@s r4rz z case "${cmd_path[@]}" inrz "z")z z ;;z *)z esacz ;;z *)z esac) help_flagstuple version_flagsrmaxkeysranger]r_generate_completions_for_pathrRrr) rr r r rarc max_depthdepthr^relevant_pathscmd escaped_pathpath_strs r!rErEs* E*-..s~~&bJ030A0AE#++,rM LLGH LL./A/*>*>*@AAIy1}%+:+?+?+AX+A4SYRWEW$+AX  tE7!_% A: LL7XWacpq r LL9 :~.IMN# 8 = N88L1 y "56 2?D,Xbdqr ^,/ LL & LL ( LL & Z 1&4 LL LL LL L;Y Os/HH(H command_pathrarccX||vr|dgS||}g}g}|jDcgc]"}|jr|js!|$} }| D]x} | jjxsgD]%} | j ds|j | '| jD]%} | j ds|j | 'zg} |jD]6} | jD]%} | j ds| j | '8|D]/}|j ds||vs|| vs|j |1|D]/}|j ds||vs|| vs|j |1|j| g}|jD]6} | jD]%}|j dr|j |'8|jDcgc]}|j|js| }}|jd|j |d|r|jt||dn|j |d|j |dt|j}|r-t|j|||d}|j|nV|r|jt||dn5|r|jt!||dn|j |d|j |d |Scc}wcc}w) 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. r5rc6|j |jSdS)Nr)index)as r!z0_generate_completions_for_path..s!''2Eqww'L1'Lr#)keyzif [[ ${cur} == -* ]]; then z COMPREPLY=()elsefi)rJis_positional_onlyshowrLrMrNr negativesrPrQrrqsortr9_check_if_prev_needs_value#_generate_value_completion_for_prev_generate_positional_completion)rrnr-rarcrUr optionsarg keyword_argsrVrM flag_commandsrWflagrPrXpositional_argsneeds_value_completionvalue_completion_liness r!rgrg[s6?*(,'(( < (D EG#'>>_>C9O9O9QVYV^V^C>L_ &&++1r1Ds#t$2&&Ds#t$' !M"mm&,,Ds#$$T*-,  ??3 D$7D ._emit_ones&&T&2 5<=W(+WG=*7K@ @56KHMM6Z[ "m#9,GXYZ Z-|,-- >sA(Nr_rzcase ${positional_count} inrur4r` ;; *) COMPREPLY=()esac) strlist enumerateis_var_positionalrrrr]r) rr-r rrest_idxirhead rest_owneridxrVs r!r~r~s E..c. HO,3  "H -0FAs)1 '.?OIX4ND!)x/HJ J*  Yz623$ L# TaJ. YtAw/0 L  x<=>&t_MC LLF82cU!, - LL8xt_= > LLF86* +-  xt_%  ! LL:&? @ LLF8#34 5 xv&' xt_% Lr#c|D]F}|jr|jjxsgD]}|jdsyHy)aCheck if any options take values, requiring prev-word completion logic. Parameters ---------- arguments : ArgumentCollection Arguments to check. Returns ------- bool True if any option (starts with -) takes a value (is not a flag). rTF)rKrLrMrN)rJrVrMs r!r|r|sL! **//525??3'6 r#rPc g}|j|d|j|d|j|d|j|d|j|dd}|D]}|jr|jjxsgDcgc]}|j ds|}}|sQd}|j d } t |j} |D]}|j|d |d | r7| D cgc] } t| } } |jt| |d n9t| } | r|j|d | dn|j|d|j|d |r|j|d|r|jt||d n5|r|jt||d n|j|d|j|d|j|d|Sg}|r|jt|||S|r|jt|||S|j|d|Scc}wcc} w)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. zlocal _value_prev="${prev}"z9if [[ "$_value_prev" == "=" && $COMP_CWORD -ge 2 ]]; thenz+ _value_prev="${COMP_WORDS[COMP_CWORD-2]}"rwzcase "$_value_prev" inFrTrrur4r`z COMPREPLY=( $(compgen rrrrrr5) rrKrLrMrNrr rrrr9rBr~)rJrPrr-r has_casesrVrMrQr,r>r2rrs r!r}r}s& E  LLF889: LLF8TUV LLF8HIJ LLF82 LLF8123I     #+#5#5#:#:#@b#@Z#@$T__UXEY#@Z  &&T&2&x}}5D LLF82dV1- .9@AA,Q/A 4WoNO=fE LLF8+El^Sd!efLLF8+;!<= LLF86* +6 xt_%  LL0fXT?K L  LL8VHTX/Z [ LLF8#34 5 xv&' xt_% L  LL06B C L  LL8&Q R L LLF8<0 1 LU[BsI83I8I=) __doc__rtypingrcyclopts.annotationsrcyclopts.completion._baserrrrr r cycloptsr rr"r+rr9r=rBdictrbrrDrErgr~boolr|r}r0r#r!rs  1*E*c*c*Z   T#YS <33+;(%S/>9:  #Y Djd5c?N;Z6[j`deh`ijZ<%S/>9:<< < #Y <~_%S/>9:_S/_ _c3h _ c? _  #Y _DESET#YEPT*MT#YMadMimnqirMr#