lKjk^ dZddlZddlmZddlmZddlmZmZm Z m Z m Z m Z er ddl mZddlmZdd d ed efd Zd eeedfefd efdZded efdZded efdZd ed eeedfefd eefdZd ed eeedfefd eefdZded efdZd eeedfefd edeedfdeedfd eef dZd eeedfefdeedfd edeedfdeedfd eef dZdedeedfd ed eefdZdedeedfd eded eef dZ deedfd eefd Z!d ededeedfdeedfd eef d!Z"d"ed eded#ed eef d$Z#d%ed eded#ed eef d&Z$deedfd ed efd'Z%d(d)d#ed efd*Z&y)+zFish completion script generator. Generates static fish completion scripts using `complete -c COMMAND` statements. Completions auto-load from ~/.config/fish/completions/PROGNAME.fish. N) TYPE_CHECKING)is_iterable_type)CompletionActionCompletionDataclean_choice_textextract_completion_dataget_completion_action strip_markup)App) CommandSpecappr prog_namereturncn|rtjd|std|dt|}d|ddg}t d|j D}|r,|j t|||jdt|r,|j t|||jd|jrt|jnd}|jrt|jnd}|j t||||d j|d zS) aGenerate fish completion script. Parameters ---------- app : App The Cyclopts application to generate completion for. prog_name : str Program name for completion (alphanumeric with hyphens/underscores). Returns ------- str Complete fish 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# Fish completion for z# Generated by Cycloptsc38K|]}t|dkDyw)rN)len).0paths i/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/cyclopts/completion/fish.py z-generate_completion_script..8sO8Nc$i!m8Ns )rematch ValueErrorranykeysextend_generate_helper_functionsappend_any_nested_positional_choices!_generate_positional_index_helper help_flagstuple version_flags_generate_completionsjoin)r rcompletion_datalineshas_nested_commandsr$r&s rgenerate_completion_scriptr,s( BHH%8)D.ym;klmm-c2O ! ,!  E O8L8L8NOO / ?KL R%o6 6y/RS R*-..s~~&bJ030A0AE#++,rM LL& :}]^ 99U d ""r).c|jD]G\}}|s |jD]0}|j |js|j ds/yIy)u#Whether any nested command path has a positional argument with choices. The positional-index helper is only needed when there is at least one nested positional that emits a choice list — without choices, fish's default file fallback already produces sensible completions. TforceF)items argumentsindexshow get_choices)r)rdataarguments rr"r"Is[&++- d H~~%X]]##$#/ '. r-textc&|jddS)z&Escape single quotes for fish strings.'z'\'')replacer8s r_escape_fish_stringr=[s <<W %%r-c`|jdd}|jdd}t|S)z!Escape description text for fish.r  )r;r=r<s r_escape_fish_descriptionrA`s- <<c "D <<c "D t $$r-c<t}t}|jD]}|jD]h}|jr|jj s+|jj D]%}|j ds|j|'j|jD]6}|jD]%}|j dr|j|'8d|d} dd| ddg} |r7djd t|D} | jd | d n| jd |r7djd t|D} | jd| d n| jd| jgd| S)uDGenerate helper function for command path detection. Non-option words are classified by membership in a globally-aggregated set of registered command names (``all_commands``) — this matches the bash detector's behavior and prevents positional argument *values* from being mistaken for subcommands. Without this filter, typing any positional after the subcommand causes the helper to count it as a deeper command path, which then makes every ``-n ' '`` rule (including option and positional-choice rules) stop firing. Note: ``all_commands`` is built globally across all command levels — a positional value that happens to equal a real subcommand name from *some* level can still be misclassified, but that represents poor CLI design and matches the bash detector's behavior. Parameters ---------- prog_name : str Program name. completion_data : dict Completion data used to identify options that take values. Returns ------- list[str] Lines defining the helper function. -__fish__using_commandz6# Helper function to check exact command path sequence function ! set -l cmd (commandline -opc)z set -l subcommandsr?c32K|]}t|ywNr=ropts rrz-_generate_helper_functions..`D_S 3C 8D_ set -l options_with_values 'r:! set -l options_with_values ''c32K|]}t|ywrIrJrcmds rrz-_generate_helper_functions..sYDXS 3C 8DXrNz set -l all_commands 'z set -l all_commands '') set -l skip_next 0zJ # Extract command words (only real subcommand names) from command line! for i in (seq 2 (count $cmd)) set -l word $cmd[$i] if test $skip_next -eq 1 set skip_next 0 continue end) if string match -qr -- '^-' $wordz> # Check if this option takes a value (exact match)F if string match -q -- "* $word *" " $options_with_values " set skip_next 1 end elsezJ # Only add to subcommands if word is a registered command namez? if string match -q -- "* $word *" " $all_commands "z( set -a subcommands $wordr^rZ endz8 # Check if subcommand sequence matches expected pathz2 if test (count $subcommands) -ne (count $argv)z return 1r`z" for i in (seq 1 (count $argv))z- if test $subcommands[$i] != $argv[$i]z return 1rZr`z return 0end)setvaluesr2is_flag parametername startswithaddcommandsnamesr(sortedr!r) rr)options_with_values all_commandsr6r7rfregistered_commandcmd_name func_namer* escaped_opts escaped_cmdss rr r gs>%5L&&(H##%(*<*<*A*A$..33Ds++//54' #'-- .44**3/ $$X.5#0 ))N3I@ I;+  Exx`FK^D_``  7 ~QGH 89xxYF_using_command`` helper) so their value tokens don't get counted as positionals. rCrD_positional_indexzR# Helper: print the index of the next positional slot for the active command path.rFrGz set -l path_len $argv[1]r?c32K|]}t|ywrIrJrKs rrz4_generate_positional_index_helper..rMrNrOr:rP)rTz set -l consumed_path 0z set -l count 0rUrVrWrXrYrZr[r\r]r^r_z0 if test $consumed_path -lt $path_lenz; set consumed_path (math $consumed_path + 1)z elsez+ set count (math $count + 1)r^rZr`z echo $countra) rbrcr2rdrerfrgrhr(rkr!r) rr)rlr6r7rfrpr*rqs rr#r#s%&&(H##%(*<*<*A*A$..33Ds++//54'))$56I\ I;+&  E xx`FK^D_``  7 ~QGH 89 LL 6 Lr-actioncT|tjk(ry|tjk(ryy)a Map completion action to fish flags. Parameters ---------- action : CompletionAction Completion action type. Returns ------- str Fish completion flags ("-r -F" for files, "-r -a '(...)'" for directories, "" otherwise). z-r -Fz%-r -a '(__fish_complete_directories)'r)rFILES DIRECTORIES)rvs r_map_completion_action_to_fishrz s+!''' !---6 r-r$r&c g}t|jD]W\}}|jt||||||t |j t k7sG|jdY|S)akGenerate all fish completion commands. Parameters ---------- completion_data : dict Extracted completion data. prog_name : str Program name. help_flags : tuple[str, ...] Help flags. version_flags : tuple[str, ...] Version flags. Returns ------- list[str] Completion command lines. keyr)rkr1r_generate_completions_for_pathmaxrrr!)r)rr$r&r* command_path_datas rr'r'!sv0 E%o&;&;&=> e *    33353? ? LL  ? Lr-rcL||vrgS||}g}t||}|jt|||||jDcgc]"}|j r|j s!|$} }| s|s|r|jt ||jt|||||jt| |||j|jt|j|||j|jt||||Scc}w)aGenerate completions for a specific command path. Parameters ---------- completion_data : dict Extracted completion data. command_path : tuple[str, ...] Command path. prog_name : str Program name. help_flags : tuple[str, ...] Help flags. version_flags : tuple[str, ...] Version flags. Returns ------- list[str] Completion command lines. ) _get_condition_for_pathr _generate_subcommand_completionsr2is_positional_onlyr4_generate_option_section_header"_generate_help_version_completions!_generate_keyword_arg_completions help_format$_generate_command_option_completionsri _generate_positional_completions) r)rrr$r&r6r* conditionarg keyword_argss rr~r~Ks6?* < (D E' i@I LL1$ iQZ[\#'>>_>C9O9O9QVYV^V^C>L_z] 4\BC 7 9jZghi 6|YPY[_[k[klm 9$--T]_c_o_opq LL1$ iPQ L`sD! D!(D!r6c (sgS|jDcgc]}|j|js| }}|sgS|jdd}t |D]\}}|j s|}n|,t |D]\}}t |js|}n||n|d|}|dn||}d|d} d|d} t} djdD} | d| } gd dfd }t |D]{\}}|jd }|s|Dcgc]}tt|}}dj|}| d | d| d|}|jd|d|d|d}|{|jd }|rg||nd}|Dcgc]}tt|}}dj|}| d | d| d|}|jd|d|d|dScc}wcc}wcc}w)uEmit per-position choice rules for positional args at a nested path. Only nested paths (``len(command_path) > 0``) are handled. At root, the natural fish gate ``__fish_use_subcommand`` flips false as soon as the first positional is typed, so a position-N rule for N>0 can't be expressed cleanly there; root-level positional values (rare in practice) fall back to fish's default behavior. Positionals without choices (e.g. ``Path``) emit nothing — fish's default file completion kicks in automatically at positions where no rule fires. Iterable positionals (``list[X]``, ``set[X]``, ``*args``) own every slot from their index onwards. To avoid emitting two competing rest-arg specs (mirrors the bash/zsh "first iterable wins" rule), only the first iterable contributes a rest rule; later iterables remain reachable via their ``--name`` keyword forms. Nc"|jxsdS)Nr)r3)as rz2_generate_positional_completions..sqww|!|r-r|rDrtrEr?c32K|]}t|ywrIrJrRs rrz3_generate_positional_completions..QLS 3C 8LrNFcVs&jddjdyy)Nz# Positionals for: r?T)r!r()rheader_emittedr*sr_ensure_headerz8_generate_positional_completions.._ensure_headers. LL.sxx /E.FG H!Nr-Tr/z ; and test (z) = complete -c z -n 'z ' -f -a 'r:rz) -ge )rN)r2r3r4sort enumerateis_var_positionalrhintrr(r5r=rr!)r6rrrpositional_argsrest_idxihead rest_owner helper_fn using_cmd_fnpath_lenescaped_commandsbase_predicaterslot_idxr7choicescescaped_choices choices_strpos_cond rest_slotrr*s ` @@rrr{s.  &*nn[ns 8MRURZRZsnO[  34HO,3  "H -0FAs)1 '.?OIX4ND!)x/HJ)$56IYK~6L< HxxQLQQ$~Q'7&89NEN" (o(&&T&2 NUVg./@/CDgVhh/ $%\)AhZtH:V |I;eH:Y{mSTUV.((t(4 $,$8aIRYZRYQ23DQ3GHRYOZ((?3K()i[(6R[Q\]H   LL< {%z;-WXY Z Lo\NW[sH HH'H &Hrc |jDcgc]'}|jD]}|jdr|)}}}|sgSg}|r$|jddj |n|jd|jD]y}|jD]h}|jdrt |j |j} t| } t|} |jd|d|d| d| d j{|Scc}}w) aTGenerate completions for subcommands. Parameters ---------- data : CompletionData Completion data. command_path : tuple[str, ...] Command path. prog_name : str Program name. condition : str Fish condition. Returns ------- list[str] Completion command lines. rCz# Subcommands for: r?z# Root-level commandsrz -a '' -d 'r:) rirjrgr!r(_get_description_from_appr rrAr=) r6rrrrnrfrir*rodesc escaped_desc escaped_cmds rrrs2(,}}'4#ASAYAYaeapapqtauAY}   E *388L+A*BCD ,-"mm*00H""3',-?-C-CTEUEUVD3D9L-h7K LL< {!I;eK=PVWcVddef g1, L/s %DDc6|rddj|gSdgS)zGenerate section header comment for options. Parameters ---------- command_path : tuple[str, ...] Command path. Returns ------- list[str] Comment line. z# Options for: r?z# Root-level optionsr()rs rrrs*!#((<"8!9:;; " ##r-c g}|D]u}|jdr!|dd}|jd|d|d|d5|jdsGt|dk(sV|d }|jd|d|d |dw|D]u}|jdr!|dd}|jd|d|d|d 5|jdsGt|dk(sV|d }|jd|d|d |d w|S) acGenerate completions for help and version flags. Parameters ---------- prog_name : str Program name. condition : str Fish condition. help_flags : tuple[str, ...] Help flags. version_flags : tuple[str, ...] Version flags. Returns ------- list[str] Completion command lines. --Nrr? -l z$ -d 'Display this message and exit.'rC -s z" -d 'Display application version.')rgr!r)rrr$r&r*flag long_name short_names rrrs0 E ??4 QRI LL< {!I;d9+Mqr s __S !c$i1naJ LL< {!I;d:,Nrs t  ??4 QRI LL< {!I;d9+Mop q __S !c$i1naJ LL< {!I;d:,Npq r  Lr-rrc tg}|D]*}t|jjxsd|}t|}|j }|j d} t |j} |jjxsgD]} | jds| jdr| dd} d |d |d | g} n!t| dk(r| d }d |d |d |g} nZ|r| jd|dn| rK| Dcgc]}tt|}}d j|}| jd|d|dn:t| }|r| j|d|dn| jd|d|jd j| |j D]{} | jds| jdr$| dd} |jd |d |d | d|d Jt| dk(sY| d }|jd |d |d |d|d }-|Scc}w)aQGenerate completions for keyword arguments. Parameters ---------- keyword_args : list Keyword arguments. prog_name : str Program name. condition : str Fish condition. help_format : str Help text format. Returns ------- list[str] Completion command lines. rformatTr/rCrrNrr?rrrz-d 'r:z-x -a 'r -d 'z-r -d ')r rehelprArdr5r rrfrgrr!r=rr(rz negatives)rrrrr*r7rrrdrrvrfr line_partsrrrr action_flagss rrr@sj0 E H..339r+N/5 ""$&&T&2&x}}5&&++1r1D??3't$ H ,YKq 4 {ST Ta!!W ,YKq 4 |TU !!Da"89V]"^V]QR#67H7K#LV]"^!hh7 !!GK=|nA"NO=fE %%eL>&KL%% ~Q&?@ LL*- .528&&D??3't$ H  |I;a {$ykQVWcVddefgTa!!W  |I;a {$zlRWXdWeefgh'I!^ L/#_sH5ric ng}|D]}|jD]}|jdst|j|}t |}|jdr$|dd} |j d|d|d| d|d kt |dk(sz|d } |j d|d|d | d|d |S) ajGenerate completions for commands that look like options. Parameters ---------- commands : list List of RegisteredCommand tuples. prog_name : str Program name. condition : str Fish condition. help_format : str Help text format. Returns ------- list[str] Completion command lines. rCrrNrr?rrr:rr)rjrgrr rAr!r) rirrrr*rnrorrrrs rrrs0 E&*00H&&s+,-?-C-C[QD3D9L""4($QRL  |I;a {$ykQVWcVddefgX!#%a[  |I;a {$zlRWXdWeefgh1' Lr-cV|syd|d}djd|D}d|d|dS)aGenerate fish condition string for a command path. Parameters ---------- command_path : tuple[str, ...] Command path (empty for root). prog_name : str Program name. Returns ------- str Fish condition flag. z-n __fish_use_subcommandrDrEr?c32K|]}t|ywrIrJrRs rrz*_get_condition_for_path..rrNz-n 'r:r)rrrprs rrrsD ))N3IxxQLQQ )A./q 11r-cmd_appzApp | CommandSpeccddlm} ||jd}|jxsd}t ||S#t$rt |jxsd}Y1wxYw)zExtract description from App. Parameters ---------- cmd_app : App | CommandSpec Command app or spec. help_format : str Help text format. Returns ------- str Description text. r)docstring_parse plaintextrr)cyclopts.help.helprrshort_description Exceptionstrr )rrrparsedr8s rrrs_3' {;''-2 [ 11 '7<<%2&'s#8"AA)'__doc__rtypingrcyclopts.annotationsrcyclopts.completion._baserrrrr r cycloptsr cyclopts.command_specr rr,dictr%boolr"r=rAlistr r#rzr'r~rrrrrrrrrr-rrsq  11-#E-#c-#c-#`DsCx.9X4Y^b$&c&c& %3%3%cc%S/>9:c #YcL==%S/>9:= #Y=@+;('%S/>9:''c3h'c? '  #Y 'T-%S/>9:-S/--c3h - c? -  #Y -`Q QS/QQ #Y Qh/ /S/// /  #Y /d$%S/$d3i$$***c3h*c? *  #Y *ZIIII I  #Y IX)))) )  #Y )X2%S/2c2c2.2':22QT2r-