dial [–group=default] number

Selects directory from a list in /DIAL and prints it to the console, e.g.

DIAL:
  default:
    # used as a short-cut for using a Dodo Commands layer
    '1': dodo backend.
    '2': dodo frontend.
  shift:
    # used for cd'ing into a directory
    '1': ${/ROOT/src_dir}/backend
    '2': ${/ROOT/src_dir}/frontend

# prints "/path/to/backend/"
dodo dial 1

# cd's into "/path/to/backend/"
cd $(dodo dial --group=shift 1)

This becomes useful when combined with a key binding in the shell. For example, in Fish the following binding allows you to go to a directory (in the ${/DIAL/default} group) with F1 and F2, and insert a string (in the ${/DIAL/shift} group) with Shift+F1 and Shift+F2, allowing for a very fast work-flow:

# /.config/fish/functions/dial_insert.fish
function dial_insert
    set cmd (dodo dial -g default $argv)
    if test $cmd
        commandline -i $cmd
    end
end

# /.config/fish/functions/dial_cd.fish
function dial_cd
    cd (dodo dial $argv)
    commandline -f repaint
end

# /.config/fish/functions/fish_user_key_bindings.fish
function fish_user_key_bindings
    bind --key f1 "dial_insert 0"
    bind --key f2 "dial_insert 1"

    bind \e\[1\;2P "dial_cd 1"
    bind \e\[1\;2Q "dial_cd 2"
end⏎

Tip

Dodo Commands comes with “dial” key bindings for fish. You can install them as follows:

# find location of the which.py script, e.g.
dodo which --fish-config

# There you will find subdirectories called ``functions`` and ``conf.d`` that need
# to be copied to ~/.config/fish (merging them with the existing directories there)
# If ~/.config/fish does not yet contain these subdirectories then you can do this using:
cd (dodo which --fish-config)
cp -rf functions conf.d ~/.config/fish

group[=default]

The group inside ${/DIAL} from which to pick.

The number to dial.

number

The number to dial.