]> ruderich.org/simon Gitweb - config/dotfiles.git/blobdiff - zsh/rc
zsh/rc: Display staged/unstaged info next to cwd in prompt.
[config/dotfiles.git] / zsh / rc
diff --git a/zsh/rc b/zsh/rc
index 8fb53670fc42b7dab255a3bb156f89154f7250d8..c6691783224feb182fc95edfc7f521d98fbad12b 100644 (file)
--- a/zsh/rc
+++ b/zsh/rc
 # along with this file.  If not, see <http://www.gnu.org/licenses/>.
 
 
-source_debug ". ~/.zsh/rc"
+source_debug '. ~/.zsh/rc'
+
+
+# Warn when creating global variables from inside a function. Needs to be set
+# before declaring a function.
+setopt warn_create_global
 
 
 # HELPER FUNCTIONS
@@ -24,7 +29,7 @@ source_debug ". ~/.zsh/rc"
 # Return the name of the program which is called in the foreground with `fg`.
 # $1 is the name of the program (optional). If it's not 'fg' or 'fg *' it's
 # returned unchanged.
-resolve_fg_to_resumed_job_name() {
+zshrc_resolve_fg_to_resumed_job_name() {
     # $REPLY is used by convention for scalars ($reply for arrays) to return
     # values from functions. unset it here to prevent problems when REPLY is
     # bound to an integer or similar. Thanks to Mikachu in #zsh on Freenode
@@ -68,7 +73,8 @@ setopt correct
 # Enable zsh's extended glob abilities.
 setopt extendedglob
 
-# Don't exit if <C-d> is pressed.
+# Don't exit if <C-D> is pressed. Prevents exiting the shell by accident (e.g.
+# pressing <C-D> twice).
 setopt ignoreeof
 
 
@@ -94,7 +100,7 @@ bindkey -a -r '^[OA' '^[OB' '^[OC' '^[OD' '^[[A' '^[[B' '^[[C' '^[[D'
 # Make sure every entry in $fpath is unique.
 typeset -U fpath
 # ~/.zsh/functions/completion is a symbolic link to the Completion directory
-# of a Zsh CVS checkout. Use it to get the newest completions if available.
+# of a Zsh Git checkout. Use it to get the newest completions if available.
 if [[ -d ~/.zsh/functions/completion ]]; then
     fpath=(~/.zsh/functions/completion/*/*(/) $fpath)
 fi
@@ -153,8 +159,8 @@ setopt histignorespace
 # returned. Very useful to get old commands quickly - in addition to the
 # history commands (!..). Thanks to Mikachu in #zsh on Freenode (2010-01-17
 # 12:47 CET) for the information how to a use function with bindkey.
-zle -N my-vi-history-beginning-search-backward
-my-vi-history-beginning-search-backward() {
+zle -N zshrc-vi-history-beginning-search-backward
+zshrc-vi-history-beginning-search-backward() {
     local not_at_beginning_of_line
     if [[ $CURSOR -ne 0 ]]; then
         not_at_beginning_of_line=yes
@@ -169,7 +175,7 @@ my-vi-history-beginning-search-backward() {
         zle vi-forward-char
     fi
 }
-bindkey '^P' my-vi-history-beginning-search-backward
+bindkey '^P' zshrc-vi-history-beginning-search-backward
 bindkey -a '^P' history-beginning-search-backward # binding for Vi-mode
 # Here only Vi-mode is necessary as ^P enters Vi-mode and ^N only makes sense
 # after calling ^P.
@@ -228,16 +234,18 @@ if [[ $ZSH_VERSION == (4.3.<9->*|4.<4->*|<5->*) ||
     if [[ $ZSH_VERSION == (4.3.<11->*|4.<4->*|<5->*) ||
           -d ~/.zsh/functions/vcs_info ]]; then
         zstyle ':vcs_info:*' formats \
-            "($green%b%u%c$default:$blue%s$default)"
+            "(${green}%b%u%c${default}:${blue}%s${default})" \
+            "${green}%u%c${default}"
         zstyle ':vcs_info:*' actionformats \
-            "($green%b%u%c$default/$red%a$default:$blue%s$default)"
+            "(${green}%b%u%c${default}/${red}%a${default}:${blue}%s${default})" \
+            "${green}%u%c${default}"
     else
         # In older versions %u and %c are not defined yet and are not
         # correctly expanded.
         zstyle ':vcs_info:*' formats \
-            "($green%b$default:$blue%s$default)"
+            "(${green}%b${default}:${blue}%s${default})"
         zstyle ':vcs_info:*' actionformats \
-            "($green%b$default/$red%a$default:$blue%s$default)"
+            "(${green}%b${default}/${red}%a${default}:${blue}%s${default})"
     fi
     # Set style for formats/actionformats when unstaged (%u) and staged (%c)
     # changes are detected in the repository; check-for-changes must be set to
@@ -249,7 +257,7 @@ if [[ $ZSH_VERSION == (4.3.<9->*|4.<4->*|<5->*) ||
 
     # Default to run vcs_info. If possible we prevent running it later for
     # speed reasons. If set to a non empty value vcs_info is run.
-    FORCE_RUN_VCS_INFO=1
+    zshrc_force_run_vcs_info=1
 
     # Cache system inspired by Bart Trojanowski
     # (http://jukie.net/~bart/blog/pimping-out-zsh-prompt).
@@ -261,8 +269,8 @@ if [[ $ZSH_VERSION == (4.3.<9->*|4.<4->*|<5->*) ||
 
         # If the shell just started up or we changed directories (or for other
         # custom reasons) we must run vcs_info.
-        if [[ -n $FORCE_RUN_VCS_INFO ]]; then
-            FORCE_RUN_VCS_INFO=
+        if [[ -n $zshrc_force_run_vcs_info ]]; then
+            zshrc_force_run_vcs_info=
             return
         fi
 
@@ -282,26 +290,26 @@ if [[ $ZSH_VERSION == (4.3.<9->*|4.<4->*|<5->*) ||
 
     # Must run vcs_info when changing directories.
     prompt_chpwd() {
-        FORCE_RUN_VCS_INFO=1
+        zshrc_force_run_vcs_info=1
     }
     chpwd_functions+=(prompt_chpwd)
 
     # Used by prompt code below to determine if vcs_info should be run.
-    RUN_VCS_INFO=1
+    zshrc_use_vcs_info=1
 else
-    RUN_VCS_INFO=
+    zshrc_use_vcs_info=
 fi
 
-typeset -a longrun_data
-longrun_data=()
+typeset -a zshrc_longrun_data
+zshrc_longrun_data=()
 # Display runtime in seconds for long running programs (> 60 seconds) and send
 # a bell to notify me.
-longrun_preexec() {
+zshrc_longrun_preexec() {
     local program="$3"
 
     # Handle fg.
     local REPLY
-    resolve_fg_to_resumed_job_name "$program"
+    zshrc_resolve_fg_to_resumed_job_name "$program"
     program="$REPLY"
 
     # Don't track the time for certain (possible) long running processes which
@@ -309,35 +317,35 @@ longrun_preexec() {
     for ignore in elinks man mutt vim; do
         case $program in
             $ignore | $ignore\ *)
-                longrun_data=()
+                zshrc_longrun_data=()
                 return
                 ;;
         esac
     done
 
-    longrun_data=("$program" $EPOCHSECONDS)
+    zshrc_longrun_data=("$program" $EPOCHSECONDS)
 }
-longrun_precmd() {
+zshrc_longrun_precmd() {
     # No previous timestamp available or disabled for this command, ignore.
-    if [[ -z $longrun_data ]]; then
+    if [[ -z $zshrc_longrun_data ]]; then
         return
     fi
 
-    local difference=$(( EPOCHSECONDS - longrun_data[2] ))
+    local difference=$(( EPOCHSECONDS - zshrc_longrun_data[2] ))
     if [[ $difference -gt 60 ]]; then
         echo
         echo -n "${fg[yellow]}"
-        echo -n "~> ${(V)longrun_data[1]} took $difference seconds."
+        echo -n "~> ${(V)zshrc_longrun_data[1]} took $difference seconds."
         echo -n "${fg[default]}"
         echo    "\a" # send bell
     fi
 
     # Clear status. Prevents displaying old status information when pressing
     # enter with an empty command line.
-    longrun_data=()
+    zshrc_longrun_data=()
 }
-preexec_functions+=(longrun_preexec)
-precmd_functions+=(longrun_precmd)
+preexec_functions+=(zshrc_longrun_preexec)
+precmd_functions+=(zshrc_longrun_precmd)
 
 # Set the prompt. A two line prompt is used. On the top left the current
 # working directory is displayed, on the right vcs_info (if available) and the
@@ -346,20 +354,22 @@ precmd_functions+=(longrun_precmd)
 # if not 0.
 #
 # The prompt is in green and blue to make easily detectable, the error exit
-# code in red and bold and the job count in yellow.
+# code in red and bold and the job count in yellow. Designed for dark
+# terminals.
 #
 # Thanks to Adam's prompt for the basic idea of this prompt.
-prompt_precmd() {
+zshrc_prompt_precmd() {
     # Regex to remove elements which take no space. Used to calculate the
     # width of the top prompt. Thanks to Bart's and Adam's prompt code in
     # Functions/Prompts/prompt_*_setup.
     local zero='%([BSUbfksu]|([FB]|){*})'
 
     # Call vcs_info before every prompt.
-    if [[ -n $RUN_VCS_INFO ]]; then
+    if [[ -n $zshrc_use_vcs_info ]]; then
         vcs_info
     else
         vcs_info_msg_0_=
+        vcs_info_msg_1_=
     fi
 
     # Setup. Create variables holding the formatted content.
@@ -367,6 +377,9 @@ prompt_precmd() {
     # Current directory in yellow, truncated if necessary (WIDTH is replaced
     # below).
     local directory="${yellow}%WIDTH<..<%~%<<${default}"
+    # Minimal information about the VCS, only displayed if there are
+    # unstaged/staged changes.
+    local vcs_staged="${vcs_info_msg_1_}"
 
     # Information about the VCS in this directory.
     local vcs="${vcs_info_msg_0_}"
@@ -375,11 +388,16 @@ prompt_precmd() {
 
     # User name (%n) in bright green.
     local user="${green}%B%n%b${default}"
-    # Host name (%m) in bright green.
+    # Host name (%m) in bright green; underlined if running on a remote system
+    # through SSH.
     local host="${green}%B%m%b${default}"
-    # Number of background processes in yellow.
+    if [[ -n $SSH_CONNECTION ]]; then
+        host="%U${host}%u"
+    fi
+
+    # Number of background processes in yellow if not zero.
     local background="%(1j.${yellow}%j${default}.)"
-    # Exit code in bright red if not zero.
+    # Exit code in bright red in parentheses if not zero.
     local exitcode="%(?..(${red}%B%?%b${default}%) )"
 
     # Prefix characters in first and second line.
@@ -388,20 +406,25 @@ prompt_precmd() {
 
     # Combine them to create the prompt.
 
+    local top_left="${vcs_staged}"
     local top_right="${vcs}(${seconds})"
 
     local width_top_prefix=${#${(S%%)top_prefix//$~zero/}}
+    local width_top_left=${#${(S%%)top_left//$~zero/}}
     local width_top_right=${#${(S%%)top_right//$~zero/}}
 
     # Calculate the maximum width of ${top_left}. -2 are the braces of
     # ${top_left}, -1 is one separator from ${top_separator} (we want at least
     # one between left and right parts).
     local top_left_width_max=$((
-        COLUMNS - $width_top_prefix - 2 - 1 - $width_top_right
+        COLUMNS - $width_top_prefix
+                - $width_top_left - 2
+                - 1
+                - $width_top_right
     ))
     # Truncate directory if necessary.
-    local top_left="(${directory/WIDTH/${top_left_width_max}})"
-    local width_top_left=${#${(S%%)top_left//$~zero/}}
+    top_left="(${directory/WIDTH/${top_left_width_max}})${top_left}"
+    width_top_left=${#${(S%%)top_left//$~zero/}}
 
     # Calculate the width of the top prompt to fill the middle with "-".
     local width=$((
@@ -412,17 +435,17 @@ prompt_precmd() {
     PROMPT="${top_prefix}${top_left}${top_separator}${top_right}
 ${bottom_prefix}${user}@${host} ${background}%# ${exitcode}"
 }
-precmd_functions+=(prompt_precmd)
+precmd_functions+=(zshrc_prompt_precmd)
 
 
-# When screen, tmux, xterm or rxvt is used set the name of the window to the
-# currently running program.
+# When GNU screen, tmux, xterm or rxvt is used set the name of the window to
+# the currently running program.
 #
 # When a program is started preexec() sets the window's name to it; when it
 # stops precmd() resets the window's name to 'zsh'. 'fg' is supported and sets
 # the window's name to the resumed job.
 #
-# It works with screen, tmux, xterm and rxvt.
+# It works with GNU screen, tmux, xterm and rxvt.
 #
 # If a command is run with sudo or if the shell is running as root then a ! is
 # added at the beginning of the command to make this clear. If a command is
@@ -436,17 +459,13 @@ precmd_functions+=(prompt_precmd)
 if [[ $TERM == screen* || $TERM == xterm* || $TERM == rxvt* ]]; then
     # Is set to a non empty value to reset the window name in the next
     # precmd() call.
-    window_reset=yes
-    # Is set to a non empty value when the shell is running as root.
-    if [[ $UID -eq 0 ]]; then
-        window_root=yes
-    fi
+    zshrc_window_reset=yes
 
-    window_preexec() {
+    zshrc_window_preexec() {
         # Get the program name with its arguments.
         local program_name=$1
 
-        # When sudo is used use real program name instead, but with an
+        # When sudo is used, use real program name instead, but with an
         # exclamation mark at the beginning (handled below).
         local program_sudo=
         if [[ $program_name == sudo* ]]; then
@@ -456,7 +475,7 @@ if [[ $TERM == screen* || $TERM == xterm* || $TERM == rxvt* ]]; then
 
         # Handle fg.
         local REPLY
-        resolve_fg_to_resumed_job_name "$program_name"
+        zshrc_resolve_fg_to_resumed_job_name "$program_name"
         program_name="$REPLY"
 
         # Remove all arguments from the program name.
@@ -485,7 +504,7 @@ if [[ $TERM == screen* || $TERM == xterm* || $TERM == rxvt* ]]; then
 
         # Add an exclamation mark at the beginning if running with sudo or if
         # running zsh as root.
-        if [[ -n $program_sudo || -n $window_root ]]; then
+        if [[ -n $program_sudo || $UID -eq 0 ]]; then
             program_name=!$program_name
         fi
 
@@ -505,15 +524,15 @@ if [[ $TERM == screen* || $TERM == xterm* || $TERM == rxvt* ]]; then
         fi
 
         # Set the window name to the currently running program.
-        window_title "$program_name"
+        zshrc_window_title "$program_name"
 
         # Tell precmd() to reset the window name when the program stops.
-        window_reset=yes
+        zshrc_window_reset=yes
     }
 
-    window_precmd() {
+    zshrc_window_precmd() {
         # Abort if no window name reset is necessary.
-        [[ -z $window_reset ]] && return
+        [[ -z $zshrc_window_reset ]] && return
 
         # Reset the window name to 'zsh'.
         local name=zsh
@@ -524,41 +543,41 @@ if [[ $TERM == screen* || $TERM == xterm* || $TERM == rxvt* ]]; then
         fi
 
         # Prepend prefixes like in window_preexec().
-        if [[ -n $window_root ]]; then
+        if [[ $UID -eq 0 ]]; then
             name="!$name"
         fi
         if [[ -n $SSH_CONNECTION ]]; then
             name="@$name"
         fi
-        window_title $name
+        zshrc_window_title $name
 
         # Just reset the name, so no screen reset necessary for the moment.
-        window_reset=
+        zshrc_window_reset=
     }
 
-    # Sets the window title. Works with screen, tmux (which uses screen as
-    # TERM), xterm and rxvt. (V) escapes all non-printable characters. Thanks
+    # Sets the window title. Works with GNU screen, tmux (which uses screen as
+    # TERM), xterm and rxvt. (V) escapes all non-printable characters, thanks
     # to Mikachu in #zsh on Freenode (2010-08-07 17:09 CEST).
     if [[ $TERM == screen* ]]; then
-        window_title() {
+        zshrc_window_title() {
             print -n "\ek${(V)1}\e\\"
         }
     elif [[ $TERM == xterm* || $TERM == rxvt* ]]; then
-        window_title() {
+        zshrc_window_title() {
             print -n "\e]2;${(V)1}\e\\"
         }
     else
         # Fallback if another TERM is used.
-        window_title() { }
+        zshrc_window_title() { }
     fi
 
     # Add the preexec() and precmd() hooks.
-    preexec_functions+=(window_preexec)
-    precmd_functions+=(window_precmd)
+    preexec_functions+=(zshrc_window_preexec)
+    precmd_functions+=(zshrc_window_precmd)
 else
     # Fallback if another TERM is used, necessary to run screen (see below in
     # "RUN COMMANDS").
-    window_preexec() { }
+    zshrc_window_preexec() { }
 fi
 
 
@@ -723,7 +742,7 @@ alias -g EN='2>/dev/null'
 alias -g L='2>&1 | less'
 alias -g LS='2>&1 | less -S' # -S prevents wrapping of long lines
 alias -g D='2>&1 | colordiff | less'
-# Global aliases for often used commands in the command line.
+# Global aliases for often used commands.
 alias -g A='| awk'
 alias -g G='| grep'
 alias -g H='| head'
@@ -742,8 +761,8 @@ alias -g .....='../../../..'
 # is empty. I open so much windows that I don't know in which I have something
 # important. This helps me to remember which windows are empty (I run clear
 # after I finished my work in a window).
-if [[ -n $window_reset ]]; then
-    alias clear='clear; window_reset=yes; window_precmd reset'
+if [[ -n $zshrc_window_reset ]]; then
+    alias clear='clear; zshrc_window_reset=yes; zshrc_window_precmd reset'
 fi
 
 
@@ -799,18 +818,16 @@ fi
 
 if [[ $OSTYPE == linux* ]]; then
     # Settings when creating Debian packages.
-    DEBEMAIL=simon@ruderich.org
-    export DEBEMAIL
-    DEBFULLNAME='Simon Ruderich'
-    export DEBFULLNAME
+    export DEBEMAIL=simon@ruderich.org
+    export DEBFULLNAME='Simon Ruderich'
 fi
 
 
 # LOAD ADDITIONAL CONFIGURATION FILES
 
 # Configuration option for rc.local to use GNU screen/tmux. By default GNU
-# screen is used. Possible values: screen, tmux.
-use_multiplexer=screen
+# screen is used. Possible values: screen, tmux and empty (no value).
+zshrc_use_multiplexer=screen
 
 source_config ~/.zsh/rc.local
 
@@ -822,32 +839,32 @@ source_config ~/.zsh/rc.local
 # through ssh.
 if [[ $TERM != dumb && $TERM != linux && -z $STY && -z $TMUX ]]; then
     # Get running detached sessions.
-    if [[ $use_multiplexer = screen ]]; then
+    if [[ $zshrc_use_multiplexer = screen ]]; then
         session=$(screen -list | grep 'Detached' | awk '{ print $1; exit }')
-    elif [[ $use_multiplexer = tmux ]]; then
+    elif [[ $zshrc_use_multiplexer = tmux ]]; then
         session=$(tmux list-sessions 2>/dev/null \
                   | sed '/(attached)$/ d; s/^\([0-9]\{1,\}\).*$/\1/; q')
     fi
 
     # As we exec later we have to set the title here.
-    if [[ $use_multiplexer = screen ]]; then
-        window_preexec "screen"
-    elif [[ $use_multiplexer = tmux ]]; then
-        window_preexec "tmux"
+    if [[ $zshrc_use_multiplexer = screen ]]; then
+        zshrc_window_preexec screen
+    elif [[ $zshrc_use_multiplexer = tmux ]]; then
+        zshrc_window_preexec tmux
     fi
 
     # Create a new session if none is running.
     if [[ -z $session ]]; then
-        if [[ $use_multiplexer = screen ]]; then
+        if [[ $zshrc_use_multiplexer = screen ]]; then
             exec screen
-        elif [[ $use_multiplexer = tmux ]]; then
+        elif [[ $zshrc_use_multiplexer = tmux ]]; then
             exec tmux
         fi
     # Reattach to a running session.
     else
-        if [[ $use_multiplexer = screen ]]; then
+        if [[ $zshrc_use_multiplexer = screen ]]; then
             exec screen -r $session
-        elif [[ $use_multiplexer = tmux ]]; then
+        elif [[ $zshrc_use_multiplexer = tmux ]]; then
             exec tmux attach-session -t $session
         fi
     fi
@@ -861,22 +878,22 @@ fi
 # cases it doesn't work, the E alias can be used as workaround.
 #
 # Moved in the "run commands" section to prevent one unnecessary zsh process
-# when starting screen/tmux (see above).
+# when starting GNU screen/tmux (see above).
 exec 2>>(while read -r -k -u 0 line; do
-    printf '\e[91m%s\e[0m' "$line";
-    print -n $'\0';
+    printf '\e[91m%s\e[0m' "$line"
+    print -n $'\0'
 done &)
 
-# Run the following programs every 4 hours.
+# Run the following programs every 4 hours (and when zsh starts).
 PERIOD=14400
 periodic() {
     # Display fortunes.
     (( $+commands[fortune] )) && fortune -ac
     # Display reminders.
-    (( $+commands[rem] )) && [ -f ~/.reminders ] && rem -h
+    (( $+commands[rem] )) && [[ -f ~/.reminders ]] && rem -h
 }
 
 
-source_debug ". ~/.zsh/rc (done)"
+source_debug '. ~/.zsh/rc (done)'
 
 # vim: ft=zsh