Locally scoped functions for the command line.
A dofile is a Bash script containing functions (named do_). We can call these functions from the command line by executing dostuff <something> in the same directory or in a subdirectory of the dofile.
By default the dofile is named Dofile, this can be changed by setting the DOFILE environment variable.
Use -f to print all currently available dofiles and -p for all available functions.
Reachable dofiles may be source'd on invocation. To avoid accidental execution it's best to keep all code inside functions.
We can also call functions with arguments: dostuff <func> <arg1> <arg2> ....
Running the program without any arguments will execute a function named do_, arguments can't be passed to this default function.
If a function can't be found in the local dofile we go up the directory tree looking for other dofiles:
foo
├── Dofile # look here last
└── bar # the current directory
├── Dofile # look here first
├── x
├── y
└── z
By default functions will be run with the working directory set to the directory containing the dofile. We can force the directory to be the current working directory with the -l flag.
Tab completion for available functions:
__dostuff () {
local -a commands
if test -e ./Dofile; then
commands=($(dostuff -p))
if (( CURRENT == 2 )); then
_describe -t commands 'commands' commands
fi
return 0
else
return 1
fi
}
compdef __dostuff dostuff
Use cabal build.
See dostuff.cabal for requierements.