+ Q(i>Rt^RIt^RIHt^RIHtHtHtHtH t H t ]'d ^RI H t ^RI HtRRltRR ltR R ltR R ltRRltRRltRRltRRltRRltRRltRRltRRltRRltR R!ltR#)"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)CompletionActionCompletionDataclean_choice_textextract_completion_dataget_completion_action strip_markup)App) CommandSpecc4V^8dQhRRR\R\/#)appr prog_namereturnstr)formats"^/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/cyclopts/completion/fish.py __annotate__rs!)#)#E)#c)#c)#cV'd\P!RV4'g\RV: R24h\V4pRV 2RR.p\;QJd*RVP 44F 'gK RM R M!RVP 444pV'd,VP \W44VPR4VP'd\VP4MR pVP'd\VP4MR pVP \W!WV44R PV4R ,#) aVGenerate 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 Cycloptsc3>"TFp\V4^8xK R#5i)N)len).0paths& r -generate_completion_script..7sO8Nc$i!m8NsTF )rematch ValueErrorranykeysextend_generate_helper_functionsappend help_flagstuple version_flags_generate_completionsjoin)r rcompletion_datalineshas_nested_commandsr)r+s&& rgenerate_completion_scriptr1s( BHH%8)DD.ym;klmm-c2O ! ,!  E #O8L8L8NO###O8L8L8NOO / KL R*-...s~~&bJ030A0A0AE#++,rM LL&:]^ 99U d ""rc0V^8dQhR\R\/#r textrr)rs"rrrDs&&c&c&rc&VPRR4#)z&Escape single quotes for fish strings.'z'\'')replacer4s&r_escape_fish_stringr9Ds <<W %%rc0V^8dQhR\R\/#r3r)rs"rrrIs%%3%3%rc`VPRR4pVPRR4p\V4#)z!Escape description text for fish.r  )r7r9r8s&r_escape_fish_descriptionr>Is- <<c "D <<c "D t $$rcV^8dQhR\R\\\R3,\3,R\\,/#)r rr..r)rdictr*rlist)rs"rrrPsAIII%S/>9:I #YIrcL\4pVP4FpVPFpVP4'dKVPP 'gK9VPP F-pVP R4'gKVPV4K/ K K RV R2pRRV 2RR.pV'd8RPR \V444pVPR V R 24MVPR 4VP.R O4V#)aGenerate helper function for command path detection. 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 sequencez function z! set -l cmd (commandline -opc)z set -l subcommandsr<c38"TFp\V4xK R#5iNr9)ropts& rr-_generate_helper_functions..ss`D_S 3C 8 8D_z set -l options_with_values 'r6z! set -l options_with_values '')z set -l skip_next 0z; # Extract non-option words (commands) from command linez! for i in (seq 2 (count $cmd))z set -l word $cmd[$i]z if test $skip_next -eq 1z set skip_next 0z continue endz) if string match -qr -- '^-' $wordz> # Check if this option takes a value (exact match)zF if string match -q -- "* $word *" " $options_with_values "z set skip_next 1z endz elsez* # Non-option word is a commandz$ set -a subcommands $wordrL endz8 # Check if subcommand sequence matches expected pathz2 if test (count $subcommands) -ne (count $argv)z return 1rMz" for i in (seq 1 (count $argv))z- if test $subcommands[$i] != $argv[$i]z return 1rLrMz return 0end) setvalues argumentsis_flag parametername startswithaddr-sortedr(r&) rr.options_with_valuesdataargumentrT func_namer/ escaped_optss && rr'r'Ps$%&&(H##%%(*<*<*A*A*A$..33Ds+++//54'))N3I@ I;+  Exx`FK^D_``  7 ~QGH 89 LL  B Lrc0V^8dQhR\R\/#)r actionr)rr)rs"rrrs+;rcbV\P8XdR#V\P8XdR#R#)zMap 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)r^s&r_map_completion_action_to_fishrbs+!''' !---6 rc V^8dQhR\\\R3,\3,R\R\\R3,R\\R3,R\\,/#)r r..rr)r+rr@r*rrrA)rs"rrrs`''%S/>9:''c3h'c? '  #Y 'rc .p\VP44FZwrVVP\VVVVV44V\ VP 4\ R78wgKIVPR4K\ V#)a/Generate 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)rWitemsr&_generate_completions_for_pathmaxr%rr()r.rr)r+r/ command_path_datas&&&& rr,r,st0 E%o&;&;&=>  *    33353? ? LL  ? Lrc V^8dQhR\\\R3,\3,R\\R3,R\R\\R3,R\\R3,R\\,/#)r r..rjrr)r+rrd)rs"rrrsr++%S/>9:+S/++c3h + c? +  #Y +rcPW9d.#W,p.p\W4pVP\WQW'44VPUu.uF0qP 4'dKVP 'gK.VNK2 p pV 'gV'g V'dVP\ V44VP\W'W444VP\WWuP44VP\VPW'VP44V#uupi)akGenerate 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_completionsrQis_positional_onlyshow_generate_option_section_header"_generate_help_version_completions!_generate_keyword_arg_completions help_format$_generate_command_option_completionscommands) r.rjrr)r+rYr/ conditionarg keyword_argss &&&&& rrhrhs6*  (D E' @I LL1$i[\#'>>_>C9O9O9QCVYV^V^CC>L_z] 4\BC 7 jhi 6|PY[k[klm 9$--_c_o_opq L`sD##D#7D#c V^8dQhR\R\\R3,R\R\R\\,/#)r rYrj.rrxr)rr*rrA)rs"rrrsF// /S/// /  #Y /rc XVPUUu.uF/qDPFqUPR4'dKVNK K1 pppV'g.#.pV'd%VPRRP V4 24MVPR4VPFpVPFppVPR4'dK\ VP VP4p \V 4p \V4p VPRV RV RV RV R2 4Kr K V#uuppi) aGenerate 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 commands complete -c z -a '' -d 'r6) rwnamesrUr(r-_get_description_from_appr rur>r9) rYrjrrxregistered_commandrTrwr/cmd_namedesc escaped_desc escaped_cmds &&&& rroros2(,}}'4#AYAYapapqtauAY}   E *388L+A*BCD ,-"mm*00H""3'',-?-C-CTEUEUVD3D9L-h7K LL< {!I;eK=PVWcVddef g1, L/s &D& D&c`V^8dQhR\\R3,R\\,/#)r rj.r)r*rrA)rs"rrr:s&$$%S/$d3i$rcBV'dRRPV4 2.#R.#)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-)rjs&rrrrr:s*!#((<"8!9:;; " ##rc V^8dQhR\R\R\\R3,R\\R3,R\\,/#)r rrxr).r+r)rr*rA)rs"rrrLsN****c3h*c? *  #Y *rc ^.pVFpVPR4'd'VR,pVPRV RV RV R24K@VPR4'gKY\V4^8XgKkV^,pVPRV RV RV R24K VFpVPR4'd'VR,pVPRV RV RV R 24K@VPR4'gKY\V4^8XgKkV^,pVPRV RV RV R 24K V#) a'Generate 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. --r NNr}r< -l z$ -d 'Display this message and exit.'rC -s z" -d 'Display application version.')rUr(r)rrxr)r+r/flag long_name short_names&&&& rrsrsLs"0 E ??4 RI LL< {!I;d9+Mqr s __S ! !c$i1naJ LL< {!I;d:,Nrs t  ??4 RI LL< {!I;d9+Mop q __S ! !c$i1naJ LL< {!I;d:,Npq r  Lrc jV^8dQhR\R\R\R\R\\,/#)r rzrrxrurrAr)rs"rrrysEIIIII I  #Y Irc ".pVEFp\VPP;'gRVR7p\V4pVP 4pVP RR7p \ VP4p VPP;'g.EFEp V PR4'gKV PR4'dV R,p RV R V R V 2.p M(\V 4^8XdV ^,pRV R V R V 2.p MKrV'dV PR V R 24MV 'dNV Uu.uFp\\V44NK ppR PV4pV PRV RV R 24M@\V 4pV'dV PV RV R 24MV PRV R 24VPR PV 44EKH VP Fp V PR4'gKV PR4'd*V R,p VPRV R V R V RV R 2 4K\\V 4^8XgKnV ^,pVPRV R V R V RV R 2 4K EK V#uupi)aGenerate 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. rrT)forcerCrrr}r<rrz-d 'r6z-x -a 'r~ -d 'z-r -d ')rrShelpr>rR get_choicesrhintrTrUrr(r9rr-rb negatives)rzrrxrur/rZrrrRchoicesr^rTr line_partsrcescaped_choices choices_str action_flagss&&&& rrtrtysx0 E H..3399r+N/5 ""$&&T&2&x}}5&&++11r1D??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/#_s2J c jV^8dQhR\R\R\R\R\\,/#)r rwrrxrurr)rs"rrrs>))))) )  #Y )rc .pVFpVPFpVPR4'gK\VPV4p\ V4pVPR4'd*VR,p VP RV RV RV RV R2 4K}\ V4^8XgKV^,p VP RV RV R V RV R2 4K K V#) a.Generate 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. rCrrr}r<rrr6r)rrUrr r>r(r) rwrrxrur/rrrrrrs &&&& rrvrvs0 E&*00H&&s++,-?-C-C[QD3D9L""4(($RL  |I;a {$ykQVWcVddefgX!#%a[  |I;a {$zlRWXdWeefgh1' LrcVV^8dQhR\\R3,R\R\/#)r rj.rr)r*r)rs"rrrs)22%S/2c2c2rcdV'gR#RV R2pRPRV44pRV RV R2#)zGenerate 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<c38"TFp\V4xK R#5irGrH)rcmds& rr*_get_condition_for_path..sQLS 3C 8 8LrKz-n 'r6r)rjrr[escaped_commandss&& rrnrnsD ))N3IxxQLQQ )A./q 11rc4V^8dQhRRR\R\/#)r cmd_appzApp | CommandSpecrurr)rs"rrrs#22':22QT2rc^RIHpV!VPR4pVP;'gRp\ WAR7# \d#\ TP;'gR4pL8i;i)zExtract description from App. Parameters ---------- cmd_app : App | CommandSpec Command app or spec. help_format : str Help text format. Returns ------- str Description text. )docstring_parse plaintextrr)cyclopts.help.helprrshort_description Exceptionrr)rrurparsedr4s&& rrrsc3' {;''--2  11 '7<<%%2&'s%=="A* A*)A*)__doc__r!typingrcyclopts.completion._baserrrrrrcycloptsr cyclopts.command_specr r1r9r>r'rbr,rhrorrrsrtrvrnrr rrrsw  1)#X& %IX('T+\/d$$*ZIX)X2.2r