# a .fish complete file usually looks like a like # `complete -c command -n '__fish_seen_subcommand_from arg' -a arg -l long -s short -d 'description' # attempt to loosely pasrse it and convert to nu completions # parse every .fish file in the current directory and make a .nu completions file of it def build-completions-from-pwd [] { ls *.fish | par-each { |f| let out = ($f.name | str replace ".fish" ".nu") print $"building nushell completions from ($f.name)" build-completion $f.name $out } } # build a completion form a .fish file and generate a .nu file def build-completion [fish_file: path, nu_file: path] { open $fish_file | parse-fish | make-commands-completion | str join "\n\n" | save $nu_file } # parse a .fish file based on autogenerated complete syntax # returns a table of flags to arguments # currently only handles complete's args that don't use boolean flags (e.g. -f) def parse-fish [] { let data = ( $in | tokenize-complete-lines | where (($it | length) mod 2) == 1 # currently we only support complete args that all have args (pairs). including 'complete' this means an odd number of tokens | each { |tokens| $tokens | pair-args } # turn the tokens into a list of pairs | flatten # merge them all into a top level label ) # default every column in the table to "" to make processing easier # some values having null often breaks nu or requires lots of checking $data | columns | reduce -f $data { |c, acc| $acc | default "" $c } | default "" a | cleanup_subcommands # clean garbage subcommands } # tokenize each line of the fish file into a list of tokens # make use of detect columns -n which with one like properly tokenizers arguments including across quotes def tokenize-complete-lines [] { lines | where $it starts-with 'complete' # only complete command lines | each { str replace -a "\\\\'" "" # remove escaped quotes ' which break detect columns | str replace -a "-f " "" # remove -f which is a boolean flag we don't support yet | detect columns -n | transpose -i tokens | get tokens } } # turn a list of tokens for a line into a record of {flag: arg} def pair-args [] { where $it != complete # drop complete command as we don't need it | window 2 -s 2 # group by ordered pairs, using window 2 -s 2 instead of group 2 to automatically drop any left overs | each { |pair| [ {$"($pair.0 | str trim -c '-')": ($pair.1 | unquote)} # turn into a [{ :}] removing quotes ] } | reduce { |it, acc| $acc | merge $it } # merge the list of records into one big record } def unquote [] { str trim -c "\'" # trim ' | str trim -c "\"" # trim " } # remove any entries which contain things in subcommands that may be fish functions or incorrect parses def cleanup_subcommands [] { where (not ($it.a | str contains "$")) and (not ($it.a | str starts-with "-")) and (not ($it.a starts-with "(")) } # from a parsed fish table, create the completion for it's command and sub commands def make-commands-completion [] { let fishes = $in $fishes | get c # c is the command name | uniq # is cloned on every complete line | each { |command| $fishes | where c == $command | make-subcommands-completion [$command] | str join "\n\n" } } # make the action nu completion string from subcommand and args # subcommand can be empty which will be the root command def make-subcommands-completion [parents: list] { let quote = '"' # a `"` let fishes = $in $fishes | group-by a # group by sub command (a flag) | transpose name args # turn it into a table of name to arguments | each {|subcommand| [ # description (if ('d' in ($subcommand.args | columns)) and ($subcommand.args.d != "") { $"# ($subcommand.args.d.0)\n" }) # extern name $'extern "($parents | append $subcommand.name | str join " " | str trim)"' # params " [\n" ( $fishes | if ('n' in ($subcommand.args | columns)) { if ($subcommand.name != "") { where ($it.n | str contains $subcommand.name) # for subcommand -> any where n matches `__fish_seen_subcommand_from arg` for the subcommand name } else { where ($it.n == "__fish_use_subcommand") and ($it.a == "") # for root command -> any where n == __fish_use_subcommand and a is empty. otherwise a means a subcommand } } else { $fishes # catch all } | build-flags | str join "\n" ) "\n\t...args" "\n]" ] | str join } } # build the list of flag string in nu syntax # record -> list def build-flags [] { $in | each { |subargs| if ('l' in ($subargs | columns)) and ($subargs.l != "") { [ "\t--" $subargs.l ( [ (if ('s' in ($subargs | columns)) and ($subargs.s != "") { [ "(-" $subargs.s ")" ] | str join }) (if ('d' in ($subargs | columns)) and ($subargs.d != "") { [ "\t\t\t\t\t# " $subargs.d ] | str join }) ] | str join ) ] | str join } } }