improvements to bash completion

[ivanov]

[x] added nbconvert and history subcommands

[x] generalized subcommand completer logic

[x] profile, history, locate commands now have completions

[x] bash completion: ipython shows only subcmds

If a partial filename, or an flag or option argument is invoked, those
completions will still take place, but by default, to aid the user in the
discovery of subcommands, pressing tab immediately after ipython will list
only the subcommands as possible completions

[ivanov]

pinging @juliantaylor who wrote the original completer, and @ngoldbaum, who was the last to poke at it to enable zsh completion

[ngoldbaum]

This is a significant usability improvement. Works just fine under zsh.

[Carreau]

+1

[juliantaylor]

looks nice, maybe one could add this to the subcommand completion to get a space after them:

        if [ "$COMP_CWORD" == 1 ]; then
            local IFS=$'\t\n'
            local sub=$(echo $subcommands | sed -e "s/ / \t/g")
            COMPREPLY=( $(compgen -W "${sub}" -- ${cur}) )

[ivanov]

Thanks @juliantaylor, I played with it a bit trying to get this functionality yesterday, but couldn't get a clean enough of a patch. Your solution works nicely, so I've added that to this PR.

[ngoldbaum]

EDIT: disregard this, I made a mistake applying the patch.

Hmm, the patch @ivanov just applied broke completion for me. Perhaps I've messed something up - can someone else reproduce this? It behaves the same in bash and zsh, as far as I can tell.

$ ipython note<tab>

$ ipython notebook qtconsole console kernel profile locate history nbconvert

Before the patch, I got a nice ordered list:

$ ipython <tab><tab>
console    kernel     nbconvert  profile
history    locate     notebook   qtconsole
$ ipython 

or a sensible completion:

$ ipython note<tab>

$ ipython notebook

[juliantaylor]

works for me

[ngoldbaum]

Hmm, please disregard my last comment, it looks like I messed something up last night.

[jakobgager]

I'm really exited that the bash completion has been updated, however, you missed to add the options for nbconvert!
Simply add nbconvert in line 49.

[ivanov]

sweet, I've got another PR coming that improves bash completion in other ways, so I'll add it to that one, thanks, @jakobgager

[jakobgager]

I also tried to write such an update (see https://github.com/jakobgager/IPy_bash_complete).
I included subcommand sensitive completions like --to=<tab> gives latex, html, etc and even --post=<tab> -> pdf, serve (pdf if --to=latex has been specified, and serve if --to=html).

Unfortunately, I didn't succeeded to implement
-<tab> lists the options of --help, whereas
--<tab> lists the options of --help-all
This way the output would be less cluttered and easier to use.