dev -- Manage bdlm/.bdlmrc docker work environment containers

 dev [-t TARGET] [-p PATH] [-d] [command]

 The dev utility is used to manage bdlm/.bdlmrc docker containers to
 create a consistent bash-based shell environment. To detach from an
 instance, simply detach from the 'tmux' session (':detach')

 Command modifiers and alternate data inputs. Most commands take their
 own arguments.

     -h, -?
         Show the command usage screen

     --help, help
         Show this extended help screen

     --ctags-exclude
         Used to specify files or directories that should be excluded when
         compiling the tags file. The value can be either a comma-
         separated list of glob patterns or this option can be specified
         multiple times.

     -d, --daemonize
         Used when initializing or restarting an instance. If specified,
         allow the instance to continue running after detaching from the
         session, otherwise the container will be paused automatically.

         This is useful executing a long-running script to come back to
         or starting a daemon. If you forget to daemonize an instance,
         you can start it with the 'unpause' command after you detach.

     -p PATH, --path=PATH
         Specify the project path, this directory is mounted into /src
         inside the container. If omitted, the project path is set to
         the current directory.

     -t TARGET, --target=TARGET
         Specify an instance name. If omitted, current instances will be
         searched to see if any are attached to the project path. If none
         are found, TARGET is set to the basename of the project path.

     --tmux, --tmux=PATH
         Specify a tmux configuration file. If PATH is omitted then
         $HOME/.tmux.conf will be assumed. If the --tmux option
         is omitted then the .tmux.conf file from the docker image will
         be used.

     --tmux-prefix=PREFIX
         The default prefix key has been set to `M-space` (meta+space)
         to keep it from interfering with the default vim 'PageUp'
         binding. You can specify your preferred prefix binding when
         initializing an instance with this option. For example, to
         restore the default tmux prefix binding, use '--tmux-prefix=C-b'
         when initializing a new instance.

     --vimrc, --vimrc=PATH
         Specify a vim configuration file. If PATH is omitted then
         $HOME/.vimrc will be assumed. If the --vimrc option is
         omitted entirely then the default .vimrc file included with the
         docker image will be used.

         In addition, this script will attempt to mount a .vim/ folder
         from the same location as the .vimrc file.

 Available commands 'dev' can execute. Most commands accept the
 optional TARGET or PATH arguments. TARGET refers to the name of the
 instance you are manipulating and PATH refers to the working directory
 that gets mounted into the /src directory in the instance.

 If PATH is omitted, it defaults to the current directory. If TARGET is,
 omitted, current instances are searched to see if any are attached to
 PATH, and if so, TARGET is set to that instance name. If not, TARGET
 defaults to the basename of the PATH value.

 If TARGET is specified but PATH is omitted, the reverse behavior happens
 and current instances are searced for one named TARGET. If one is found,
 PATH is set to the path the TARGET instance is attached to, otherwise the
 default again becomes the current directory.

 Both TARGET and PATH can be specified using the option arguments --target
 and --path respectively.

     attach [TARGET]
         Attach to an instance specified by the [TARGET] argument.

         EXAMPLES
             dev attach TARGET
             dev -t TARGET attach
             dev -p PATH attach

     build-tags [TARGET]
         Update the project ctags file.

         EXAMPLES
             dev build-tags TARGET
             dev -t TARGET build-tags
             dev -p PATH build-tags

     init [TARGET] [PATH]
         Create a new instance.

         EXAMPLES
             dev init TARGET PATH
             dev -p PATH create TARGET
             dev -t TARGET create PATH
             dev -t TARGET -p PATH create

     kill [TARGET]
         Stop a running instance and clean up.

         EXAMPLES
             dev kill TARGET
             dev -t TARGET kill
             dev -p PATH kill

     ls [pattern]
         List currently running instances, optionally filtering results
         with a glob pattern. If pattern is '-q' (quiet) only instance
         names are returned.

         EXAMPLES
             dev ls
             dev ls java*
             dev ls *-php-v7.?
             dev ls -q

     pause [TARGET]
         Pause a running instance.

         EXAMPLES
             dev pause TARGET
             dev -t TARGET pause
             dev -p PATH pause

     restart [TARGET]
         Kill and re-create the specified running instance.

         EXAMPLES
             dev restart TARGET
             dev -t TARGET restart
             dev -p PATH restart

     rename [TARGET] NEW_NAME
         Rename a running or stopped instance. 'rename' does not accept a
         PATH argument.

         EXAMPLES
             dev rename TARGET NEW_NAME
             dev -t TARGET rename NEW_NAME

     self-update
         Update to the latest 'bdlm/.bdlmrc' docker image and 'dev' control
         script.

         EXAMPLES
             dev self-update

     unpause [TARGET]
         Start a paused instance.

         EXAMPLES
             dev unpause TARGET
             dev -t TARGET unpause
             dev -p PATH unpause

 - Improve error handling and messages

 Michael Kenney <[email protected]>