Add list action, don't run tool on external module

Using the `list` action with `-v` shows all current details for the
existing modules.
Don't try to install or update external modules, since they have an
absolute path instead of a valid URL.

CHANGELOG.md

@@ -7,9 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- `list` action. Using it with `-v` shows all current details for the existing
+  modules.
+
 ### Fixed
-- Error in `zimfw update` with the `git` tool when module directory is under an
+- Error in `zimfw update` with the `git` tool when module directory is under a
-  unresolved symlink.
+  symlinked directory.
+- Warning when `WARN_CREATE_GLOBAL` is set and `ZIM_HOME` is not.
+- Don't try to install or update external modules.
 
 ## [1.5.0] - 2021-08-10
 
@@ -133,7 +139,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 This is a major change, where modules are not git submodules in the Zim repo
 anymore, but customized and installed separately as individual repositories.
 External modules can more easily be installed, updated and uninstalled. This
-makes Zim the first project for Zsh that is both a set of community-maintained
+makes Zim a project for Zsh that is both a set of community-maintained
 modules with a default installation (like on-my-zsh and prezto) and a plugin
 manager (like antigen and zplug).
 

src/stage2/20_guard.zsh.erb

@@ -2,6 +2,7 @@ autoload -Uz is-at-least && if ! is-at-least <%= min_zsh_version %>; then
   print -u2 -PR "%F{red}${0}: Error starting Zim. You're using Zsh version %B${ZSH_VERSION}%b and versions < %B<%= min_zsh_version %>%b are not supported. Upgrade your Zsh.%f"
   return 1
 fi
+autoload -Uz zargs
 
 # Define Zim location
 if (( ! ${+ZIM_HOME} )) typeset -g ZIM_HOME=${0:A:h}

src/stage2/29_zimfw_build_init.zsh.erb

@@ -6,8 +6,9 @@ _zimfw_build_init() {
   fi
   _zimfw_mv =(
     print -R "zimfw() { source ${ZIM_HOME}/zimfw.zsh \"\${@}\" }"
-    if (( ${#_zfpaths} )) print -R 'fpath=('${_zfpaths:A}' ${fpath})'
+    local -r zpre=$'*\0'
-    if (( ${#_zfunctions} )) print -R 'autoload -Uz '${_zfunctions}
+    if (( ${#_zfpaths} )) print -R 'fpath=('${${_zfpaths#${~zpre}}:A}' ${fpath})'
-    print -R ${(F)_zcmds}
+    if (( ${#_zfunctions} )) print -R 'autoload -Uz '${_zfunctions#${~zpre}}
+    print -R ${(F)_zcmds#${~zpre}}
   ) ${ztarget}
 }

src/stage2/30_zmodule.zsh.erb

@@ -73,6 +73,7 @@ Initialization options:
   fi
   if [[ ${zurl} == /* ]]; then
     zdir=${zurl%%/##}
+    zurl=''
   else
     zdir=${ZIM_HOME}/modules/${zmodule}
   fi
@@ -86,6 +87,11 @@ Initialization options:
         fi
         ;;
     esac
+    case ${1} in
+      -b|--branch|-t|--tag|-u|--use)
+        if [[ -z ${zurl} ]] print -u2 -PR "%F{yellow}<%= warn %>${funcfiletrace[1]}:%B${zmodule}:%b The zmodule option ${1} has no effect for external modules%f"
+        ;;
+    esac
     case ${1} in
       -b|--branch)
         shift
@@ -131,11 +137,10 @@ Initialization options:
     esac
     shift
   done
-  if [[ -n ${_zargs_action} ]]; then
+  if (( _zflags & 1 )); then
-    if (( ! zfrozen )); then
+    _zmodules_zargs+=("${ztool}" "${_zargs_action}" "${zmodule}" "${zdir}" "${zurl}" "${ztype}" "${zrev}" "${zfrozen}" "${zdisabled}")
-      _zmodules_zargs+=("${ztool}" "${_zargs_action}" "${zmodule}" "${zdir}" "${zurl}" "${ztype}" "${zrev}")
   fi
-  else
+  if (( _zflags & 2 )); then
     if (( zdisabled )); then
       _zdisableds+=(${zmodule})
     else
@@ -167,9 +172,10 @@ Initialization options:
       fi
       _zmodules+=(${zmodule})
       _zdirs+=(${zdir})
-      _zfpaths+=(${zfpaths})
+      # ${zmodule}$'\0' prefix is added to all zfpaths, zfunctions and zcmds to distinguish the originating modules
-      _zfunctions+=(${zfunctions})
+      _zfpaths+=(${zmodule}$'\0'${^zfpaths})
-      _zcmds+=(${zcmds})
+      _zfunctions+=(${zmodule}$'\0'${^zfunctions})
+      _zcmds+=(${zmodule}$'\0'${^zcmds})
     fi
   fi
 }

src/stage2/31_zimfw_source_zimrc.zsh.erb

@@ -1,11 +1,11 @@
 _zimfw_source_zimrc() {
-  local -r ztarget=<%= home %>/.zimrc _zargs_action=${1}
+  local -r ztarget=<%= home %>/.zimrc _zflags=${1} _zargs_action=${2}
   local -i _zfailed=0
   if ! source ${ztarget} || (( _zfailed )); then
     print -u2 -PR "%F{red}<%= failed %>Failed to source %B${ztarget}%b%f"
     return 1
   fi
-  if [[ -n ${_zargs_action} && ${#_zmodules_zargs} -eq 0 ]]; then
+  if (( _zflags & 1 && ${#_zmodules_zargs} == 0 )); then
     print -u2 -PR "%F{red}<%= failed %>No modules defined in %B${ztarget}%b%f"
     return 1
   fi

src/stage2/34_zimfw_list_unuseds.zsh.erb

@@ -0,0 +1,20 @@
+_zimfw_list_unuseds() {
+  local -i i=1
+  local -a zinstalled=(${ZIM_HOME}/modules/*(N/:t)) subdirs
+  # Search into subdirectories
+  while (( i <= ${#zinstalled} )); do
+    if (( ${_zmodules[(I)${zinstalled[i]}/*]} || ${_zdisableds[(I)${zinstalled[i]}/*]} )); then
+      subdirs=(${ZIM_HOME}/modules/${zinstalled[i]}/*(N/:t))
+      zinstalled+=(${zinstalled[i]}/${^subdirs})
+      zinstalled[i]=()
+    else
+      (( i++ ))
+    fi
+  done
+  # Unused = all installed modules not in _zmodules and _zdisableds
+  _zunuseds=(${${zinstalled:|_zmodules}:|_zdisableds})
+  local zunused
+  for zunused in ${_zunuseds}; do
+    _zimfw_print -PR "%B${zunused}:%b ${ZIM_HOME}/modules/${zunused}${1}"
+  done
+}

src/stage2/50_zimfw_uninstall.zsh.erb

@@ -1,25 +1,10 @@
 _zimfw_uninstall() {
-  local zopt zuninstalls=(${ZIM_HOME}/modules/*(N/:t))
+  local zopt
   if (( _zprintlevel > 0 )) zopt='-v'
-  # Search into subdirectories
+  if (( ${#_zunuseds} )); then
-  local -a subdirs
+    if (( _zprintlevel <= 0 )) || read -q "?Uninstall ${#_zunuseds} module(s) listed above [y/N]? "; then
-  local -i i=1
-  while (( i <= ${#zuninstalls} )); do
-    if (( ${_zmodules[(I)${zuninstalls[i]}/*]} || ${_zdisableds[(I)${zuninstalls[i]}/*]} )); then
-      subdirs=(${ZIM_HOME}/modules/${zuninstalls[i]}/*(N/:t))
-      zuninstalls+=(${zuninstalls[i]}/${^subdirs})
-      zuninstalls[i]=()
-    else
-      (( i++ ))
-    fi
-  done
-  # Uninstall all installed modules not in _zmodules and _zdisableds
-  zuninstalls=(${${zuninstalls:|_zmodules}:|_zdisableds})
-  if (( ${#zuninstalls} )); then
-    _zimfw_print -PR %B${(F)zuninstalls}%b
-    if (( _zprintlevel <= 0 )) || read -q "?Uninstall ${#zuninstalls} module(s) listed above [y/N]? "; then
       _zimfw_print
-      command rm -rf ${zopt} ${ZIM_HOME}/modules/${^zuninstalls} || return 1
+      command rm -rf ${zopt} ${ZIM_HOME}/modules/${^_zunuseds} || return 1
     fi
   fi
   _zimfw_print -P '<%= done %>Done with uninstall.'

src/stage2/69_zimfw_run_list.zsh.erb

@@ -0,0 +1,25 @@
+_zimfw_run_list() {
+  local -r ztool=${1} zmodule=${3} zdir=${4} zurl=${5} ztype=${6} zrev=${7}
+  local -ri zfrozen=${8} zdisabled=${9}
+  print -PRn "%B${zmodule}:%b ${zdir}"
+  if [[ -z ${zurl} ]] print -Pn ' %F{blue}%B(external)%b'
+  if (( ${zfrozen} )) print -Pn ' %F{cyan}(frozen)'
+  if (( ${zdisabled} )) print -Pn ' %F{magenta}(disabled)'
+  print -P '%f'
+  if (( _zprintlevel > 1 )); then
+    if [[ ${zfrozen} -eq 0 && -n ${zurl} ]]; then
+      print -Rn "  From: ${zurl}, "
+      if [[ -z ${zrev} ]]; then
+        print -n 'default branch'
+      else
+        print -Rn "${ztype} ${zrev}"
+      fi
+      print -R ", using ${ztool}"
+    fi
+    local -r zpre=${zmodule}$'\0'
+    local -r zfpaths=(${${(M)_zfpaths:#${zpre}*}#${zpre}}) zfunctions=(${${(M)_zfunctions:#${zpre}*}#${zpre}}) zcmds=(${${(M)_zcmds:#${zpre}*}#${zpre}})
+    if (( ${#zfpaths} )) print -R "  fpath: ${zfpaths[@]}"
+    if (( ${#zfunctions} )) print -R "  autoload: ${zfunctions[@]}"
+    if (( ${#zcmds} )) print -R "  cmd: ${(j:; :)zcmds[@]}"
+  fi
+}

src/stage2/70_zimfw_run_tool.zsh.erb

@@ -1,7 +1,8 @@
 _zimfw_run_tool() {
-  local -r ztool=${1}
+  local -ri zfrozen=${8}
-  shift
+  if (( zfrozen )) return 0
-  local -r zaction=${1} zmodule=${2} zdir=${3} clear_line=<%= clear_line %>
+  local -r ztool=${1} zaction=${2} zmodule=${3} zdir=${4} zurl=${5} clear_line=<%= clear_line %>
+  if [[ -z ${zurl} ]] return 0
   case ${zaction} in
     install)
       if [[ -e ${zdir} ]]; then
@@ -30,5 +31,5 @@ _zimfw_run_tool() {
       return 1
       ;;
   esac
-  zsh -c ${zcmd} ${ztool} "${@}" ${_zprintlevel}
+  zsh -c ${zcmd} ${ztool} ${_zprintlevel} "${@[2,7]}"
 }

src/stage2/80_zimfw.zsh.erb

@@ -9,6 +9,7 @@ Actions:
   %Bcompile%b         Compile Zsh files
   %Bhelp%b            Print this help
   %Binfo%b            Print Zim and system info
+  %Blist%b            List all modules
   %Binstall%b         Install new modules
   %Buninstall%b       Delete unused modules
                   (prompts for confirmation)
@@ -20,7 +21,7 @@ Options:
   %B-q%b              Quiet (yes to prompts, and
                   only outputs errors and warnings)
   %B-v%b              Verbose"
-  local -a _zdisableds _zmodules _zdirs _zfpaths _zfunctions _zcmds _zmodules_zargs
+  local -a _zdisableds _zmodules _zdirs _zfpaths _zfunctions _zcmds _zmodules_zargs _zunuseds
   local -i _zprintlevel=1
   if (( # > 2 )); then
      print -u2 -PR "%F{red}${0}: Too many options%f"$'\n\n'${zusage}
@@ -42,26 +43,29 @@ Options:
 
   case ${1} in
     build)
-      _zimfw_source_zimrc && _zimfw_build || return 1
+      _zimfw_source_zimrc 2 && _zimfw_build || return 1
       (( _zprintlevel-- ))
       _zimfw_compile
       ;;
-    init) _zimfw_source_zimrc && _zimfw_build ;;
+    init) _zimfw_source_zimrc 2 && _zimfw_build ;;
-    clean) _zimfw_source_zimrc && _zimfw_clean_compiled && _zimfw_clean_dumpfile ;;
+    clean) _zimfw_source_zimrc 2 && _zimfw_clean_compiled && _zimfw_clean_dumpfile ;;
-    clean-compiled) _zimfw_source_zimrc && _zimfw_clean_compiled ;;
+    clean-compiled) _zimfw_source_zimrc 2 && _zimfw_clean_compiled ;;
     clean-dumpfile) _zimfw_clean_dumpfile ;;
-    compile) _zimfw_source_zimrc && _zimfw_build_login_init && _zimfw_compile ;;
+    compile) _zimfw_source_zimrc 2 && _zimfw_build_login_init && _zimfw_compile ;;
     help) print -PR ${zusage} ;;
     info) _zimfw_info ;;
+    list)
+      _zimfw_source_zimrc 3 && zargs -n 9 -- "${_zmodules_zargs[@]}" -- _zimfw_run_list && \
+          _zimfw_list_unuseds ' %F{red}(unused)%f'
+      ;;
     install|update)
-      _zimfw_source_zimrc ${1} || return 1
+      _zimfw_source_zimrc 1 ${1} && \
-      autoload -Uz zargs && \
+          zargs -n 9 -P 0 -- "${_zmodules_zargs[@]}" -- _zimfw_run_tool && \
-          zargs -n 7 -P 10 -- "${_zmodules_zargs[@]}" -- _zimfw_run_tool && \
           _zimfw_print -PR "<%= done %>Done with ${1}. Restart your terminal for any changes to take effect." || return 1
       (( _zprintlevel-- ))
-      _zimfw_source_zimrc && _zimfw_build && _zimfw_compile
+      _zimfw_source_zimrc 2 && _zimfw_build && _zimfw_compile
       ;;
-    uninstall) _zimfw_source_zimrc && _zimfw_uninstall ;;
+    uninstall) _zimfw_source_zimrc 2 && _zimfw_list_unuseds && _zimfw_uninstall ;;
     upgrade)
       _zimfw_upgrade || return 1
       (( _zprintlevel-- ))

src/tools/degit.zsh.erb

@@ -1,6 +1,6 @@
 # This runs in a new shell
-readonly ACTION=${1} MODULE=${2} DIR=${3} URL=${4} REV=${6} CLEAR_LINE=<%= clear_line %>
+readonly -i PRINTLEVEL=${1}
-readonly -i PRINTLEVEL=${7}
+readonly ACTION=${2} MODULE=${3} DIR=${4} URL=${5} REV=${7} CLEAR_LINE=<%= clear_line %>
 readonly TEMP=.zdegit_${RANDOM}
 readonly TARBALL_TARGET=${DIR}/${TEMP}_tarball.tar.gz INFO_TARGET=${DIR}/.zdegit
 

src/tools/git.zsh.erb

@@ -1,7 +1,7 @@
 # This runs in a new shell
-readonly ACTION=${1} MODULE=${2} DIR=${3} URL=${4} TYPE=${5:=branch} CLEAR_LINE=<%= clear_line %>
+readonly -i PRINTLEVEL=${1}
-REV=${6}
+readonly ACTION=${2} MODULE=${3} DIR=${4} URL=${5} TYPE=${6:=branch} CLEAR_LINE=<%= clear_line %>
-readonly -i PRINTLEVEL=${7}
+REV=${7}
 
 print_error() {
   print -u2 -PR ${CLEAR_LINE}"%F{red}<%= error %>%B${MODULE}:%b ${1}%f"${2:+$'\n'${(F):-  ${(f)^2}}}

src/zimfw.zsh.erb

@@ -4,7 +4,7 @@ class Zim
       :clear_line, :ellipsis, :okay, :warn, :error, :done, :failed
 
   def initialize
-    @version = "1.5.1-SNAPSHOT"
+    @version = "1.6.0-SNAPSHOT"
     @home = "${ZDOTDIR:-${HOME}}"
     @min_zsh_version = "5.2"
     @startup_files_glob = ".z(shenv|profile|shrc|login|logout)"

zimfw.zsh

@@ -28,6 +28,7 @@ autoload -Uz is-at-least && if ! is-at-least 5.2; then
   print -u2 -PR "%F{red}${0}: Error starting Zim. You're using Zsh version %B${ZSH_VERSION}%b and versions < %B5.2%b are not supported. Upgrade your Zsh.%f"
   return 1
 fi
+autoload -Uz zargs
 
 # Define Zim location
 if (( ! ${+ZIM_HOME} )) typeset -g ZIM_HOME=${0:A:h}
@@ -58,9 +59,10 @@ _zimfw_build_init() {
   fi
   _zimfw_mv =(
     print -R "zimfw() { source ${ZIM_HOME}/zimfw.zsh \"\${@}\" }"
-    if (( ${#_zfpaths} )) print -R 'fpath=('${_zfpaths:A}' ${fpath})'
+    local -r zpre=$'*\0'
-    if (( ${#_zfunctions} )) print -R 'autoload -Uz '${_zfunctions}
+    if (( ${#_zfpaths} )) print -R 'fpath=('${${_zfpaths#${~zpre}}:A}' ${fpath})'
-    print -R ${(F)_zcmds}
+    if (( ${#_zfunctions} )) print -R 'autoload -Uz '${_zfunctions#${~zpre}}
+    print -R ${(F)_zcmds#${~zpre}}
   ) ${ztarget}
 }
 
@@ -179,6 +181,7 @@ Initialization options:
   fi
   if [[ ${zurl} == /* ]]; then
     zdir=${zurl%%/##}
+    zurl=''
   else
     zdir=${ZIM_HOME}/modules/${zmodule}
   fi
@@ -192,6 +195,11 @@ Initialization options:
         fi
         ;;
     esac
+    case ${1} in
+      -b|--branch|-t|--tag|-u|--use)
+        if [[ -z ${zurl} ]] print -u2 -PR "%F{yellow}! ${funcfiletrace[1]}:%B${zmodule}:%b The zmodule option ${1} has no effect for external modules%f"
+        ;;
+    esac
     case ${1} in
       -b|--branch)
         shift
@@ -237,11 +245,10 @@ Initialization options:
     esac
     shift
   done
-  if [[ -n ${_zargs_action} ]]; then
+  if (( _zflags & 1 )); then
-    if (( ! zfrozen )); then
+    _zmodules_zargs+=("${ztool}" "${_zargs_action}" "${zmodule}" "${zdir}" "${zurl}" "${ztype}" "${zrev}" "${zfrozen}" "${zdisabled}")
-      _zmodules_zargs+=("${ztool}" "${_zargs_action}" "${zmodule}" "${zdir}" "${zurl}" "${ztype}" "${zrev}")
   fi
-  else
+  if (( _zflags & 2 )); then
     if (( zdisabled )); then
       _zdisableds+=(${zmodule})
     else
@@ -273,26 +280,48 @@ Initialization options:
       fi
       _zmodules+=(${zmodule})
       _zdirs+=(${zdir})
-      _zfpaths+=(${zfpaths})
+      # ${zmodule}$'\0' prefix is added to all zfpaths, zfunctions and zcmds to distinguish the originating modules
-      _zfunctions+=(${zfunctions})
+      _zfpaths+=(${zmodule}$'\0'${^zfpaths})
-      _zcmds+=(${zcmds})
+      _zfunctions+=(${zmodule}$'\0'${^zfunctions})
+      _zcmds+=(${zmodule}$'\0'${^zcmds})
     fi
   fi
 }
 
 _zimfw_source_zimrc() {
-  local -r ztarget=${ZDOTDIR:-${HOME}}/.zimrc _zargs_action=${1}
+  local -r ztarget=${ZDOTDIR:-${HOME}}/.zimrc _zflags=${1} _zargs_action=${2}
   local -i _zfailed=0
   if ! source ${ztarget} || (( _zfailed )); then
     print -u2 -PR "%F{red}Failed to source %B${ztarget}%b%f"
     return 1
   fi
-  if [[ -n ${_zargs_action} && ${#_zmodules_zargs} -eq 0 ]]; then
+  if (( _zflags & 1 && ${#_zmodules_zargs} == 0 )); then
     print -u2 -PR "%F{red}No modules defined in %B${ztarget}%b%f"
     return 1
   fi
 }
 
+_zimfw_list_unuseds() {
+  local -i i=1
+  local -a zinstalled=(${ZIM_HOME}/modules/*(N/:t)) subdirs
+  # Search into subdirectories
+  while (( i <= ${#zinstalled} )); do
+    if (( ${_zmodules[(I)${zinstalled[i]}/*]} || ${_zdisableds[(I)${zinstalled[i]}/*]} )); then
+      subdirs=(${ZIM_HOME}/modules/${zinstalled[i]}/*(N/:t))
+      zinstalled+=(${zinstalled[i]}/${^subdirs})
+      zinstalled[i]=()
+    else
+      (( i++ ))
+    fi
+  done
+  # Unused = all installed modules not in _zmodules and _zdisableds
+  _zunuseds=(${${zinstalled:|_zmodules}:|_zdisableds})
+  local zunused
+  for zunused in ${_zunuseds}; do
+    _zimfw_print -PR "%B${zunused}:%b ${ZIM_HOME}/modules/${zunused}${1}"
+  done
+}
+
 _zimfw_version_check() {
   if (( _zprintlevel > 0 )); then
     setopt LOCAL_OPTIONS EXTENDED_GLOB
@@ -338,34 +367,19 @@ _zimfw_compile() {
 }
 
 _zimfw_info() {
-  print -R 'zimfw version: '${_zversion}' (built at 2021-08-31 23:40:27 UTC, previous commit is e56048f)'
+  print -R 'zimfw version: '${_zversion}' (built at 2021-09-19 18:30:02 UTC, previous commit is 3e1a89a)'
   print -R 'ZIM_HOME:      '${ZIM_HOME}
   print -R 'Zsh version:   '${ZSH_VERSION}
   print -R 'System info:   '$(command uname -a)
 }
 
 _zimfw_uninstall() {
-  local zopt zuninstalls=(${ZIM_HOME}/modules/*(N/:t))
+  local zopt
   if (( _zprintlevel > 0 )) zopt='-v'
-  # Search into subdirectories
+  if (( ${#_zunuseds} )); then
-  local -a subdirs
+    if (( _zprintlevel <= 0 )) || read -q "?Uninstall ${#_zunuseds} module(s) listed above [y/N]? "; then
-  local -i i=1
-  while (( i <= ${#zuninstalls} )); do
-    if (( ${_zmodules[(I)${zuninstalls[i]}/*]} || ${_zdisableds[(I)${zuninstalls[i]}/*]} )); then
-      subdirs=(${ZIM_HOME}/modules/${zuninstalls[i]}/*(N/:t))
-      zuninstalls+=(${zuninstalls[i]}/${^subdirs})
-      zuninstalls[i]=()
-    else
-      (( i++ ))
-    fi
-  done
-  # Uninstall all installed modules not in _zmodules and _zdisableds
-  zuninstalls=(${${zuninstalls:|_zmodules}:|_zdisableds})
-  if (( ${#zuninstalls} )); then
-    _zimfw_print -PR %B${(F)zuninstalls}%b
-    if (( _zprintlevel <= 0 )) || read -q "?Uninstall ${#zuninstalls} module(s) listed above [y/N]? "; then
       _zimfw_print
-      command rm -rf ${zopt} ${ZIM_HOME}/modules/${^zuninstalls} || return 1
+      command rm -rf ${zopt} ${ZIM_HOME}/modules/${^_zunuseds} || return 1
     fi
   fi
   _zimfw_print -P 'Done with uninstall.'
@@ -396,10 +410,37 @@ _zimfw_upgrade() {
   }
 }
 
+_zimfw_run_list() {
+  local -r ztool=${1} zmodule=${3} zdir=${4} zurl=${5} ztype=${6} zrev=${7}
+  local -ri zfrozen=${8} zdisabled=${9}
+  print -PRn "%B${zmodule}:%b ${zdir}"
+  if [[ -z ${zurl} ]] print -Pn ' %F{blue}%B(external)%b'
+  if (( ${zfrozen} )) print -Pn ' %F{cyan}(frozen)'
+  if (( ${zdisabled} )) print -Pn ' %F{magenta}(disabled)'
+  print -P '%f'
+  if (( _zprintlevel > 1 )); then
+    if [[ ${zfrozen} -eq 0 && -n ${zurl} ]]; then
+      print -Rn "  From: ${zurl}, "
+      if [[ -z ${zrev} ]]; then
+        print -n 'default branch'
+      else
+        print -Rn "${ztype} ${zrev}"
+      fi
+      print -R ", using ${ztool}"
+    fi
+    local -r zpre=${zmodule}$'\0'
+    local -r zfpaths=(${${(M)_zfpaths:#${zpre}*}#${zpre}}) zfunctions=(${${(M)_zfunctions:#${zpre}*}#${zpre}}) zcmds=(${${(M)_zcmds:#${zpre}*}#${zpre}})
+    if (( ${#zfpaths} )) print -R "  fpath: ${zfpaths[@]}"
+    if (( ${#zfunctions} )) print -R "  autoload: ${zfunctions[@]}"
+    if (( ${#zcmds} )) print -R "  cmd: ${(j:; :)zcmds[@]}"
+  fi
+}
+
 _zimfw_run_tool() {
-  local -r ztool=${1}
+  local -ri zfrozen=${8}
-  shift
+  if (( zfrozen )) return 0
-  local -r zaction=${1} zmodule=${2} zdir=${3} clear_line=$'\E[2K\r'
+  local -r ztool=${1} zaction=${2} zmodule=${3} zdir=${4} zurl=${5} clear_line=$'\E[2K\r'
+  if [[ -z ${zurl} ]] return 0
   case ${zaction} in
     install)
       if [[ -e ${zdir} ]]; then
@@ -423,8 +464,8 @@ _zimfw_run_tool() {
   local zcmd
   case ${ztool} in
     degit) zcmd="# This runs in a new shell
-readonly ACTION=\${1} MODULE=\${2} DIR=\${3} URL=\${4} REV=\${6} CLEAR_LINE=$'\E[2K\r'
+readonly -i PRINTLEVEL=\${1}
-readonly -i PRINTLEVEL=\${7}
+readonly ACTION=\${2} MODULE=\${3} DIR=\${4} URL=\${5} REV=\${7} CLEAR_LINE=$'\E[2K\r'
 readonly TEMP=.zdegit_\${RANDOM}
 readonly TARBALL_TARGET=\${DIR}/\${TEMP}_tarball.tar.gz INFO_TARGET=\${DIR}/.zdegit
 
@@ -569,9 +610,9 @@ create_dir() {
 }
 " ;;
     git) zcmd="# This runs in a new shell
-readonly ACTION=\${1} MODULE=\${2} DIR=\${3} URL=\${4} TYPE=\${5:=branch} CLEAR_LINE=$'\E[2K\r'
+readonly -i PRINTLEVEL=\${1}
-REV=\${6}
+readonly ACTION=\${2} MODULE=\${3} DIR=\${4} URL=\${5} TYPE=\${6:=branch} CLEAR_LINE=$'\E[2K\r'
-readonly -i PRINTLEVEL=\${7}
+REV=\${7}
 
 print_error() {
   print -u2 -PR \${CLEAR_LINE}\"%F{red}x %B\${MODULE}:%b \${1}%f\"\${2:+$'\n'\${(F):-  \${(f)^2}}}
@@ -656,11 +697,11 @@ esac
       return 1
       ;;
   esac
-  zsh -c ${zcmd} ${ztool} "${@}" ${_zprintlevel}
+  zsh -c ${zcmd} ${ztool} ${_zprintlevel} "${@[2,7]}"
 }
 
 zimfw() {
-  local -r _zversion='1.5.1-SNAPSHOT' zusage="Usage: %B${0}%b <action> [%B-q%b|%B-v%b]
+  local -r _zversion='1.6.0-SNAPSHOT' zusage="Usage: %B${0}%b <action> [%B-q%b|%B-v%b]
 
 Actions:
   %Bbuild%b           Build %Binit.zsh%b and %Blogin_init.zsh%b
@@ -670,6 +711,7 @@ Actions:
   %Bcompile%b         Compile Zsh files
   %Bhelp%b            Print this help
   %Binfo%b            Print Zim and system info
+  %Blist%b            List all modules
   %Binstall%b         Install new modules
   %Buninstall%b       Delete unused modules
                   (prompts for confirmation)
@@ -681,7 +723,7 @@ Options:
   %B-q%b              Quiet (yes to prompts, and
                   only outputs errors and warnings)
   %B-v%b              Verbose"
-  local -a _zdisableds _zmodules _zdirs _zfpaths _zfunctions _zcmds _zmodules_zargs
+  local -a _zdisableds _zmodules _zdirs _zfpaths _zfunctions _zcmds _zmodules_zargs _zunuseds
   local -i _zprintlevel=1
   if (( # > 2 )); then
      print -u2 -PR "%F{red}${0}: Too many options%f"$'\n\n'${zusage}
@@ -703,26 +745,29 @@ Options:
 
   case ${1} in
     build)
-      _zimfw_source_zimrc && _zimfw_build || return 1
+      _zimfw_source_zimrc 2 && _zimfw_build || return 1
       (( _zprintlevel-- ))
       _zimfw_compile
       ;;
-    init) _zimfw_source_zimrc && _zimfw_build ;;
+    init) _zimfw_source_zimrc 2 && _zimfw_build ;;
-    clean) _zimfw_source_zimrc && _zimfw_clean_compiled && _zimfw_clean_dumpfile ;;
+    clean) _zimfw_source_zimrc 2 && _zimfw_clean_compiled && _zimfw_clean_dumpfile ;;
-    clean-compiled) _zimfw_source_zimrc && _zimfw_clean_compiled ;;
+    clean-compiled) _zimfw_source_zimrc 2 && _zimfw_clean_compiled ;;
     clean-dumpfile) _zimfw_clean_dumpfile ;;
-    compile) _zimfw_source_zimrc && _zimfw_build_login_init && _zimfw_compile ;;
+    compile) _zimfw_source_zimrc 2 && _zimfw_build_login_init && _zimfw_compile ;;
     help) print -PR ${zusage} ;;
     info) _zimfw_info ;;
+    list)
+      _zimfw_source_zimrc 3 && zargs -n 9 -- "${_zmodules_zargs[@]}" -- _zimfw_run_list && \
+          _zimfw_list_unuseds ' %F{red}(unused)%f'
+      ;;
     install|update)
-      _zimfw_source_zimrc ${1} || return 1
+      _zimfw_source_zimrc 1 ${1} && \
-      autoload -Uz zargs && \
+          zargs -n 9 -P 0 -- "${_zmodules_zargs[@]}" -- _zimfw_run_tool && \
-          zargs -n 7 -P 10 -- "${_zmodules_zargs[@]}" -- _zimfw_run_tool && \
           _zimfw_print -PR "Done with ${1}. Restart your terminal for any changes to take effect." || return 1
       (( _zprintlevel-- ))
-      _zimfw_source_zimrc && _zimfw_build && _zimfw_compile
+      _zimfw_source_zimrc 2 && _zimfw_build && _zimfw_compile
       ;;
-    uninstall) _zimfw_source_zimrc && _zimfw_uninstall ;;
+    uninstall) _zimfw_source_zimrc 2 && _zimfw_list_unuseds && _zimfw_uninstall ;;
     upgrade)
       _zimfw_upgrade || return 1
       (( _zprintlevel-- ))