summaryrefslogtreecommitdiff
path: root/oh-my-zsh/plugins/wd
diff options
context:
space:
mode:
Diffstat (limited to 'oh-my-zsh/plugins/wd')
-rw-r--r--oh-my-zsh/plugins/wd/LICENSE21
-rw-r--r--oh-my-zsh/plugins/wd/README.md264
-rw-r--r--oh-my-zsh/plugins/wd/_wd.sh98
-rw-r--r--oh-my-zsh/plugins/wd/wd.plugin.zsh15
-rw-r--r--oh-my-zsh/plugins/wd/wd.sh513
5 files changed, 911 insertions, 0 deletions
diff --git a/oh-my-zsh/plugins/wd/LICENSE b/oh-my-zsh/plugins/wd/LICENSE
new file mode 100644
index 0000000..8caa6c6
--- /dev/null
+++ b/oh-my-zsh/plugins/wd/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Markus Færevaag
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. \ No newline at end of file
diff --git a/oh-my-zsh/plugins/wd/README.md b/oh-my-zsh/plugins/wd/README.md
new file mode 100644
index 0000000..1d19806
--- /dev/null
+++ b/oh-my-zsh/plugins/wd/README.md
@@ -0,0 +1,264 @@
+# wd
+
+[![Build Status](https://github.com/mfaerevaag/wd/actions/workflows/test.yml/badge.svg)](https://github.com/mfaerevaag/wd/actions)
+
+`wd` (*warp directory*) lets you jump to custom directories in zsh, without using `cd`.
+Why?
+Because `cd` seems inefficient when the folder is frequently visited or has a long path.
+
+![Demo](https://raw.githubusercontent.com/mfaerevaag/wd/master/tty.gif)
+
+## Setup
+
+### [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh)
+
+`wd` comes bundled with oh-my-zsh!
+
+Just add the plugin in your `.zshrc` file:
+
+```zsh
+plugins=(... wd)
+```
+
+### [Antigen](https://github.com/zsh-users/antigen)
+
+In your `.zshrc`:
+
+```zsh
+antigen bundle mfaerevaag/wd
+```
+
+### [Antibody](https://github.com/getantibody/antibody)
+
+In your `.zshrc`:
+
+```zsh
+antibody bundle mfaerevaag/wd
+```
+
+### [Fig](https://fig.io)
+
+Install `wd` here: [![Fig plugin store](https://fig.io/badges/install-with-fig.svg)](https://fig.io/plugins/other/wd_mfaerevaag)
+
+### Arch ([AUR](https://aur.archlinux.org/packages/zsh-plugin-wd-git/))
+
+1. Install from the AUR
+
+```zsh
+yay -S zsh-plugin-wd-git
+# or use any other AUR helper
+```
+
+2. Then add to your `.zshrc`:
+
+```zsh
+wd() {
+ . /usr/share/wd/wd.sh
+}
+```
+
+### [zplug](https://github.com/zplug/zplug)
+
+```zsh
+zplug "mfaerevaag/wd", as:command, use:"wd.sh", hook-load:"wd() { . $ZPLUG_REPOS/mfaerevaag/wd/wd.sh }"
+```
+
+### Automatic
+
+_Note: automatic install does not provide the manpage. It is also poor security practice to run remote code without first reviewing it, so you ought to look [here](https://github.com/mfaerevaag/wd/blob/master/install.sh)_
+
+Run either command in your terminal:
+
+```zsh
+curl -L https://github.com/mfaerevaag/wd/raw/master/install.sh | sh
+```
+
+or
+
+```zsh
+wget --no-check-certificate https://github.com/mfaerevaag/wd/raw/master/install.sh -O - | sh
+```
+
+### Manual
+
+1. Clone this repository on your local machine in a sensible location (if you know what you're doing of course all of this is up to you):
+
+```zsh
+git clone git@github.com:mfaerevaag/wd.git ~/.local/wd --depth 1
+```
+
+2. Add `wd` function to `.zshrc` (or `.profile` etc.):
+
+```zsh
+wd() {
+ . ~/.local/wd/wd.sh
+}
+```
+
+3. Install manpage (optional):
+
+```zsh
+sudo cp ~/.local/wd/wd.1 /usr/share/man/man1/wd.1
+sudo chmod 644 /usr/share/man/man1/wd.1
+```
+
+**Note:** when pulling and updating `wd`, you'll need to repeat step 3 should the manpage change
+
+## Completion
+
+If you're NOT using [oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh) and you want to utilize the zsh-completion feature, you will also need to add the path to your `wd` installation (`~/bin/wd` if you used the automatic installer) to your `fpath`.
+E.g. in your `~/.zshrc`:
+
+```zsh
+fpath=(~/path/to/wd $fpath)
+```
+
+Also, you may have to force a rebuild of `zcompdump` by running:
+
+```zsh
+rm -f ~/.zcompdump; compinit
+```
+
+## Usage
+
+* Add warp point to current working directory:
+
+```zsh
+wd add foo
+```
+
+If a warp point with the same name exists, use `wd add foo --force` to overwrite it.
+
+**Note:** a warp point cannot contain colons, or consist of only spaces and dots.
+The first will conflict in how `wd` stores the warp points, and the second will conflict with other features, as below.
+
+You can omit point name to automatically use the current directory's name instead.
+
+* From any directory, warp to `foo` with:
+
+```zsh
+wd foo
+```
+
+* You can also warp to a directory within `foo`, with autocompletion:
+
+```zsh
+wd foo some/inner/path
+```
+
+* You can warp back to previous directory and higher, with this dot syntax:
+
+```zsh
+wd ..
+wd ...
+```
+
+This is a wrapper for the zsh's `dirs` function.
+_You might need to add `setopt AUTO_PUSHD` to your `.zshrc` if you are not using [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh)._
+
+* Remove warp point:
+
+```zsh
+wd rm foo
+```
+
+You can omit point name to use the current directory's name instead.
+
+* List all warp points (stored in `~/.warprc` by default):
+
+```zsh
+wd list
+```
+
+* List files in given warp point:
+
+```zsh
+wd ls foo
+```
+
+* Show path of given warp point:
+
+```zsh
+wd path foo
+```
+
+* List warp points to current directory, or optionally, path to given warp point:
+
+```zsh
+wd show
+```
+
+* Remove warp points to non-existent directories.
+
+```zsh
+wd clean
+```
+
+Use `wd clean --force` to not be prompted with confirmation.
+
+* Print usage info:
+
+```zsh
+wd help
+```
+
+The usage will be printed also if you call `wd` with no command
+
+* Print the running version of `wd`:
+
+```zsh
+wd --version
+```
+
+* Specifically set the config file (default being `~/.warprc`), which is useful for testing:
+
+```zsh
+wd --config ./file <command>
+```
+
+* Force `exit` with return code after running. This is not default, as it will *exit your terminal*, though required for testing/debugging.
+
+```zsh
+wd --debug <command>
+```
+
+* Silence all output:
+
+```zsh
+wd --quiet <command>
+```
+
+## Configuration
+
+You can configure `wd` with the following environment variables:
+
+### `WD_CONFIG`
+
+Defines the path where warp points get stored. Defaults to `$HOME/.warprc`.
+
+## Testing
+
+`wd` comes with a small test suite, run with [shunit2](https://github.com/kward/shunit2). This can be used to confirm that things are working as they should on your setup, or to demonstrate an issue.
+
+To run, simply `cd` into the `test` directory and run the `tests.sh`.
+
+```zsh
+cd ./test
+./tests.sh
+```
+
+## Maintainers
+
+Following @mfaerevaag stepping away from active maintainership of this repository, the following users now are also maintainers of the repo:
+
+* @alpha-tango-kilo
+
+* @MattLewin
+
+Anyone else contributing is greatly appreciated and will be mentioned in the release notes!
+
+---
+
+Credit to [altschuler](https://github.com/altschuler) for an awesome idea.
+
+Hope you enjoy!
diff --git a/oh-my-zsh/plugins/wd/_wd.sh b/oh-my-zsh/plugins/wd/_wd.sh
new file mode 100644
index 0000000..8d5cf15
--- /dev/null
+++ b/oh-my-zsh/plugins/wd/_wd.sh
@@ -0,0 +1,98 @@
+#compdef wd
+
+zstyle ':completion::complete:wd:*:descriptions' format '%B%d%b'
+zstyle ':completion::complete:wd:*:commands' group-name commands
+zstyle ':completion::complete:wd:*:warp_points' group-name warp_points
+zstyle ':completion::complete:wd::' list-grouped
+
+zmodload zsh/mapfile
+
+function _wd() {
+ local WD_CONFIG=${WD_CONFIG:-$HOME/.warprc}
+ local ret=1
+
+ local -a commands
+ local -a warp_points
+
+ warp_points=( "${(f)mapfile[$WD_CONFIG]//$HOME/~}" )
+
+ typeset -A points
+ while read -r line
+ do
+ arr=(${(s,:,)line})
+ name=${arr[1]}
+ target_path=${arr[2]}
+
+ # replace ~ from path to fix completion (#17)
+ target_path=${target_path/#\~/$HOME}
+
+ points[$name]=$target_path
+ done < $WD_CONFIG
+
+ commands=(
+ 'add:Adds the current working directory to your warp points'
+ 'add!:Overwrites existing warp point'
+ 'export:Export warp points as static named directories'
+ 'rm:Removes the given warp point'
+ 'list:Outputs all stored warp points'
+ 'ls:Show files from given warp point'
+ 'path:Show path to given warp point'
+ 'show:Outputs all warp points that point to the current directory or shows a specific target directory for a point'
+ 'help:Show this extremely helpful text'
+ 'clean:Remove points warping to nonexistent directories'
+ 'clean!:Remove nonexistent directories without confirmation'
+ '..:Go back to last directory'
+ )
+
+ _arguments -C \
+ '1: :->first_arg' \
+ '2: :->second_arg' && ret=0
+
+ local target=$words[2]
+
+ case $state in
+ first_arg)
+ _describe -t warp_points "Warp points" warp_points && ret=0
+ _describe -t commands "Commands" commands && ret=0
+ ;;
+ second_arg)
+ case $target in
+ add\!|rm)
+ _describe -t points "Warp points" warp_points && ret=0
+ ;;
+ add)
+ _message 'Write the name of your warp point' && ret=0
+ ;;
+ show)
+ _describe -t points "Warp points" warp_points && ret=0
+ ;;
+ ls)
+ _describe -t points "Warp points" warp_points && ret=0
+ ;;
+ path)
+ _describe -t points "Warp points" warp_points && ret=0
+ ;;
+ *)
+ if [[ -v points[$target] ]]; then
+ # complete sub directories from the warp point
+ _path_files -W "(${points[$target]})" -/ && ret=0
+ fi
+
+ # don't complete anything if warp point is not valid
+ ;;
+ esac
+ ;;
+ esac
+
+ return $ret
+}
+
+_wd "$@"
+
+# Local Variables:
+# mode: Shell-Script
+# sh-indentation: 2
+# indent-tabs-mode: nil
+# sh-basic-offset: 2
+# End:
+# vim: ft=zsh sw=2 ts=2 et
diff --git a/oh-my-zsh/plugins/wd/wd.plugin.zsh b/oh-my-zsh/plugins/wd/wd.plugin.zsh
new file mode 100644
index 0000000..ca2ca7c
--- /dev/null
+++ b/oh-my-zsh/plugins/wd/wd.plugin.zsh
@@ -0,0 +1,15 @@
+#!/bin/zsh
+
+# WARP DIRECTORY
+# ==============
+# Jump to custom directories in terminal
+# because `cd` takes too long...
+#
+# @github.com/mfaerevaag/wd
+
+# Handle $0 according to the standard:
+# https://zdharma-continuum.github.io/Zsh-100-Commits-Club/Zsh-Plugin-Standard.html
+0="${${ZERO:-${0:#$ZSH_ARGZERO}}:-${(%):-%N}}"
+0="${${(M)0:#/*}:-$PWD/$0}"
+
+eval "wd() { source '${0:A:h}/wd.sh' }"
diff --git a/oh-my-zsh/plugins/wd/wd.sh b/oh-my-zsh/plugins/wd/wd.sh
new file mode 100644
index 0000000..e51cf90
--- /dev/null
+++ b/oh-my-zsh/plugins/wd/wd.sh
@@ -0,0 +1,513 @@
+#!/bin/zsh
+
+# WARP DIRECTORY
+# ==============
+# Jump to custom directories in terminal
+# because `cd` takes too long...
+#
+# @github.com/mfaerevaag/wd
+
+# version
+readonly WD_VERSION=0.5.0
+
+# colors
+readonly WD_BLUE="\033[96m"
+readonly WD_GREEN="\033[92m"
+readonly WD_YELLOW="\033[93m"
+readonly WD_RED="\033[91m"
+readonly WD_NOC="\033[m"
+
+## functions
+
+# helpers
+wd_yesorno()
+{
+ # variables
+ local question="${1}"
+ local prompt="${question} "
+ local yes_RETVAL="0"
+ local no_RETVAL="3"
+ local RETVAL=""
+ local answer=""
+
+ # read-eval loop
+ while true ; do
+ printf $prompt
+ read -r answer
+
+ case ${answer:=${default}} in
+ "Y"|"y"|"YES"|"yes"|"Yes" )
+ RETVAL=${yes_RETVAL} && \
+ break
+ ;;
+ "N"|"n"|"NO"|"no"|"No" )
+ RETVAL=${no_RETVAL} && \
+ break
+ ;;
+ * )
+ echo "Please provide a valid answer (y or n)"
+ ;;
+ esac
+ done
+
+ return ${RETVAL}
+}
+
+wd_print_msg()
+{
+ if [[ -z $wd_quiet_mode ]]
+ then
+ local color=$1
+ local msg=$2
+
+ if [[ $color == "" || $msg == "" ]]
+ then
+ print " ${WD_RED}*${WD_NOC} Could not print message. Sorry!"
+ else
+ print " ${color}*${WD_NOC} ${msg}"
+ fi
+ fi
+}
+
+wd_print_usage()
+{
+ command cat <<- EOF
+Usage: wd [command] [point]
+
+Commands:
+ <point> Warps to the directory specified by the warp point
+ <point> <path> Warps to the directory specified by the warp point with path appended
+ add <point> Adds the current working directory to your warp points
+ add Adds the current working directory to your warp points with current directory's name
+ rm <point> Removes the given warp point
+ rm Removes the given warp point with current directory's name
+ show <point> Print path to given warp point
+ show Print warp points to current directory
+ list Print all stored warp points
+ ls <point> Show files from given warp point (ls)
+ path <point> Show the path to given warp point (pwd)
+ clean Remove points warping to nonexistent directories (will prompt unless --force is used)
+
+ -v | --version Print version
+ -d | --debug Exit after execution with exit codes (for testing)
+ -c | --config Specify config file (default ~/.warprc)
+ -q | --quiet Suppress all output
+ -f | --force Allows overwriting without warning (for add & clean)
+
+ help Show this extremely helpful text
+EOF
+}
+
+wd_exit_fail()
+{
+ local msg=$1
+
+ wd_print_msg "$WD_RED" "$msg"
+ WD_EXIT_CODE=1
+}
+
+wd_exit_warn()
+{
+ local msg=$1
+
+ wd_print_msg "$WD_YELLOW" "$msg"
+ WD_EXIT_CODE=1
+}
+
+wd_getdir()
+{
+ local name_arg=$1
+
+ point=$(wd_show "$name_arg")
+ dir=${point:28+$#name_arg+7}
+
+ if [[ -z $name_arg ]]; then
+ wd_exit_fail "You must enter a warp point"
+ break
+ elif [[ -z $dir ]]; then
+ wd_exit_fail "Unknown warp point '${name_arg}'"
+ break
+ fi
+}
+
+# core
+
+wd_warp()
+{
+ local point=$1
+ local sub=$2
+
+ if [[ $point =~ "^\.+$" ]]
+ then
+ if [[ $#1 < 2 ]]
+ then
+ wd_exit_warn "Warping to current directory?"
+ else
+ (( n = $#1 - 1 ))
+ cd -$n > /dev/null
+ fi
+ elif [[ ${points[$point]} != "" ]]
+ then
+ if [[ $sub != "" ]]
+ then
+ cd ${points[$point]/#\~/$HOME}/$sub
+ else
+ cd ${points[$point]/#\~/$HOME}
+ fi
+ else
+ wd_exit_fail "Unknown warp point '${point}'"
+ fi
+}
+
+wd_add()
+{
+ local point=$1
+ local force=$2
+ cmdnames=(add rm show list ls path clean help)
+
+ if [[ $point == "" ]]
+ then
+ point=$(basename "$PWD")
+ fi
+
+ if [[ $point =~ "^[\.]+$" ]]
+ then
+ wd_exit_fail "Warp point cannot be just dots"
+ elif [[ $point =~ "[[:space:]]+" ]]
+ then
+ wd_exit_fail "Warp point should not contain whitespace"
+ elif [[ $point =~ : ]] || [[ $point =~ / ]]
+ then
+ wd_exit_fail "Warp point contains illegal character (:/)"
+ elif (($cmdnames[(Ie)$point]))
+ then
+ wd_exit_fail "Warp point name cannot be a wd command (see wd -h for a full list)"
+ elif [[ ${points[$point]} == "" ]] || [ ! -z "$force" ]
+ then
+ wd_remove "$point" > /dev/null
+ printf "%q:%s\n" "${point}" "${PWD/#$HOME/~}" >> "$WD_CONFIG"
+ if (whence sort >/dev/null); then
+ local config_tmp=$(mktemp "${TMPDIR:-/tmp}/wd.XXXXXXXXXX")
+ # use 'cat' below to ensure we respect $WD_CONFIG as a symlink
+ command sort -o "${config_tmp}" "$WD_CONFIG" && command cat "${config_tmp}" >| "$WD_CONFIG" && command rm "${config_tmp}"
+ fi
+
+ wd_export_static_named_directories
+
+ wd_print_msg "$WD_GREEN" "Warp point added"
+
+ # override exit code in case wd_remove did not remove any points
+ # TODO: we should handle this kind of logic better
+ WD_EXIT_CODE=0
+ else
+ wd_exit_warn "Warp point '${point}' already exists. Use 'add --force' to overwrite."
+ fi
+}
+
+wd_remove()
+{
+ local point_list=$1
+
+ if [[ "$point_list" == "" ]]
+ then
+ point_list=$(basename "$PWD")
+ fi
+
+ for point_name in $point_list ; do
+ if [[ ${points[$point_name]} != "" ]]
+ then
+ local config_tmp=$(mktemp "${TMPDIR:-/tmp}/wd.XXXXXXXXXX")
+ # Copy and delete in two steps in order to preserve symlinks
+ if sed -n "/^${point_name}:.*$/!p" "$WD_CONFIG" >| "$config_tmp" && command cp "$config_tmp" "$WD_CONFIG" && command rm "$config_tmp"
+ then
+ wd_print_msg "$WD_GREEN" "Warp point removed"
+ else
+ wd_exit_fail "Something bad happened! Sorry."
+ fi
+ else
+ wd_exit_fail "Warp point was not found"
+ fi
+ done
+}
+
+wd_list_all()
+{
+ wd_print_msg "$WD_BLUE" "All warp points:"
+
+ entries=$(sed "s:${HOME}:~:g" "$WD_CONFIG")
+
+ max_warp_point_length=0
+ while IFS= read -r line
+ do
+ arr=(${(s,:,)line})
+ key=${arr[1]}
+
+ length=${#key}
+ if [[ length -gt max_warp_point_length ]]
+ then
+ max_warp_point_length=$length
+ fi
+ done <<< "$entries"
+
+ while IFS= read -r line
+ do
+ if [[ $line != "" ]]
+ then
+ arr=(${(s,:,)line})
+ key=${arr[1]}
+ val=${line#"${arr[1]}:"}
+
+ if [[ -z $wd_quiet_mode ]]
+ then
+ printf "%${max_warp_point_length}s -> %s\n" "$key" "$val"
+ fi
+ fi
+ done <<< "$entries"
+}
+
+wd_ls()
+{
+ wd_getdir "$1"
+ ls "${dir/#\~/$HOME}"
+}
+
+wd_path()
+{
+ wd_getdir "$1"
+ echo "$(echo "$dir" | sed "s:~:${HOME}:g")"
+}
+
+wd_show()
+{
+ local name_arg=$1
+ # if there's an argument we look up the value
+ if [[ -n $name_arg ]]
+ then
+ if [[ -z $points[$name_arg] ]]
+ then
+ wd_print_msg "$WD_BLUE" "No warp point named $name_arg"
+ else
+ wd_print_msg "$WD_GREEN" "Warp point: ${WD_GREEN}$name_arg${WD_NOC} -> $points[$name_arg]"
+ fi
+ else
+ # hax to create a local empty array
+ local wd_matches
+ wd_matches=()
+ # do a reverse lookup to check whether PWD is in $points
+ PWD="${PWD/$HOME/~}"
+ if [[ ${points[(r)$PWD]} == "$PWD" ]]
+ then
+ for name in ${(k)points}
+ do
+ if [[ $points[$name] == "$PWD" ]]
+ then
+ wd_matches[$(($#wd_matches+1))]=$name
+ fi
+ done
+
+ wd_print_msg "$WD_BLUE" "$#wd_matches warp point(s) to current directory: ${WD_GREEN}$wd_matches${WD_NOC}"
+ else
+ wd_print_msg "$WD_YELLOW" "No warp point to $(echo "$PWD" | sed "s:$HOME:~:")"
+ fi
+ fi
+}
+
+wd_clean() {
+ local force=$1
+ local count=0
+ local wd_tmp=""
+
+ while read -r line
+ do
+ if [[ $line != "" ]]
+ then
+ arr=(${(s,:,)line})
+ key=${arr[1]}
+ val=${arr[2]}
+
+ if [ -d "${val/#\~/$HOME}" ]
+ then
+ wd_tmp=$wd_tmp"\n"`echo "$line"`
+ else
+ wd_print_msg "$WD_YELLOW" "Nonexistent directory: ${key} -> ${val}"
+ count=$((count+1))
+ fi
+ fi
+ done < "$WD_CONFIG"
+
+ if [[ $count -eq 0 ]]
+ then
+ wd_print_msg "$WD_BLUE" "No warp points to clean, carry on!"
+ else
+ if [ ! -z "$force" ] || wd_yesorno "Removing ${count} warp points. Continue? (y/n)"
+ then
+ echo "$wd_tmp" >! "$WD_CONFIG"
+ wd_print_msg "$WD_GREEN" "Cleanup complete. ${count} warp point(s) removed"
+ else
+ wd_print_msg "$WD_BLUE" "Cleanup aborted"
+ fi
+ fi
+}
+
+wd_export_static_named_directories() {
+ if [[ ! -z $WD_EXPORT ]]
+ then
+ command grep '^[0-9a-zA-Z_-]\+:' "$WD_CONFIG" | sed -e "s,~,$HOME," -e 's/:/=/' | while read -r warpdir ; do
+ hash -d "$warpdir"
+ done
+ fi
+}
+
+local WD_CONFIG=${WD_CONFIG:-$HOME/.warprc}
+local WD_QUIET=0
+local WD_EXIT_CODE=0
+local WD_DEBUG=0
+
+# Parse 'meta' options first to avoid the need to have them before
+# other commands. The `-D` flag consumes recognized options so that
+# the actual command parsing won't be affected.
+
+zparseopts -D -E \
+ c:=wd_alt_config -config:=wd_alt_config \
+ q=wd_quiet_mode -quiet=wd_quiet_mode \
+ v=wd_print_version -version=wd_print_version \
+ d=wd_debug_mode -debug=wd_debug_mode \
+ f=wd_force_mode -force=wd_force_mode
+
+if [[ ! -z $wd_print_version ]]
+then
+ echo "wd version $WD_VERSION"
+fi
+
+if [[ ! -z $wd_alt_config ]]
+then
+ WD_CONFIG=$wd_alt_config[2]
+fi
+
+# check if config file exists
+if [ ! -e "$WD_CONFIG" ]
+then
+ # if not, create config file
+ touch "$WD_CONFIG"
+else
+ wd_export_static_named_directories
+fi
+
+# disable extendedglob for the complete wd execution time
+setopt | grep -q extendedglob
+wd_extglob_is_set=$?
+[[ $wd_extglob_is_set ]] && setopt noextendedglob
+
+# load warp points
+typeset -A points
+while read -r line
+do
+ arr=(${(s,:,)line})
+ key=${arr[1]}
+ # join the rest, in case the path contains colons
+ val=${(j,:,)arr[2,-1]}
+
+ points[$key]=$val
+done < "$WD_CONFIG"
+
+# get opts
+args=$(getopt -o a:r:c:lhs -l add:,rm:,clean,list,ls:,path:,help,show -- $*)
+
+# check if no arguments were given, and that version is not set
+if [[ ($? -ne 0 || $#* -eq 0) && -z $wd_print_version ]]
+then
+ wd_print_usage
+
+# check if config file is writeable
+elif [ ! -w "$WD_CONFIG" ]
+then
+ # do nothing
+ # can't run `exit`, as this would exit the executing shell
+ wd_exit_fail "\'$WD_CONFIG\' is not writeable."
+
+else
+ # parse rest of options
+ local wd_o
+ for wd_o
+ do
+ case "$wd_o"
+ in
+ "-a"|"--add"|"add")
+ wd_add "$2" "$wd_force_mode"
+ break
+ ;;
+ "-e"|"export")
+ wd_export_static_named_directories
+ break
+ ;;
+ "-r"|"--remove"|"rm")
+ # Passes all the arguments as a single string separated by whitespace to wd_remove
+ wd_remove "${@:2}"
+ break
+ ;;
+ "-l"|"list")
+ wd_list_all
+ break
+ ;;
+ "-ls"|"ls")
+ wd_ls "$2"
+ break
+ ;;
+ "-p"|"--path"|"path")
+ wd_path "$2"
+ break
+ ;;
+ "-h"|"--help"|"help")
+ wd_print_usage
+ break
+ ;;
+ "-s"|"--show"|"show")
+ wd_show "$2"
+ break
+ ;;
+ "-c"|"--clean"|"clean")
+ wd_clean "$wd_force_mode"
+ break
+ ;;
+ *)
+ wd_warp "$wd_o" "$2"
+ break
+ ;;
+ --)
+ break
+ ;;
+ esac
+ done
+fi
+
+## garbage collection
+# if not, next time warp will pick up variables from this run
+# remember, there's no sub shell
+
+[[ $wd_extglob_is_set ]] && setopt extendedglob
+
+unset wd_extglob_is_set
+unset wd_warp
+unset wd_add
+unset wd_remove
+unset wd_show
+unset wd_list_all
+unset wd_print_msg
+unset wd_yesorno
+unset wd_print_usage
+unset wd_alt_config
+unset wd_quiet_mode
+unset wd_print_version
+unset wd_export_static_named_directories
+unset wd_o
+
+unset args
+unset points
+unset val &> /dev/null # fixes issue #1
+
+if [[ -n $wd_debug_mode ]]
+then
+ exit $WD_EXIT_CODE
+else
+ unset wd_debug_mode
+fi