1.4.0

* With 160 envs, cuts time from ~14s to ~2.5s
* Change the output to be more like `pyenv-versions'
* Shellcheck fixes
* virtualenv: Only show non-envs for completion since env engines don't support piggy-backing envs
* Remove dead/unused code
* Fix IFS handling
`IFS=: <command>' doesn't apply that IFS to expansions in <command>,
it has to be set separately earlier
* Adjust and refactor tests

---------

Co-authored-by: Ivan Pozdeev <vano@mail.mipt.ru>

.github/workflows/tests.yml

@@ -6,33 +6,14 @@ jobs:
       fail-fast: false
       matrix:
         os:
-          - ubuntu-24.04
           - ubuntu-22.04
-          - macos-15-intel
+          - ubuntu-24.04
-          - macos-15
           - macos-14
+          - macos-15
+          - macos-15-intel
+          - macos-26
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v2
-      # Normally, we would use the superbly maintained...
+      - run: git clone https://github.com/bats-core/bats-core.git --depth=1 -b v1.10.0 bats
-      # - uses: actions/setup-python@v2
-      #   with:
-      #    python-version: ${{ matrix.python-version }}
-      # ... but in the repo, we want to test pyenv builds on Ubuntu
-      # - run: |
-          # sudo apt-get install -y build-essential libssl-dev zlib1g-dev libbz2-dev \
-              # libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev \
-              # xz-utils tk-dev libffi-dev liblzma-dev python-openssl git
-      # https://github.com/pyenv/pyenv#installation
-      #- env:
-      #    PYENV_ROOT: /home/runner/work/pyenv/pyenv
-      #  run: |
-      #    echo $PYENV_ROOT
-      #    echo "$PYENV_ROOT/shims:$PYENV_ROOT/bin" >> $GITHUB_PATH
-      # macos-11 Github Actions env has an old `readlink` and lacks `greadlink` which causes Bats to break
-      - run: |
-          if [[ $RUNNER_OS == "macOS" ]] && [[ $(sw_vers -productVersion | awk -F. '{print $1}') -lt 12 ]]; then
-            brew install coreutils
-          fi
-      - run: git clone https://github.com/bats-core/bats-core.git --depth=1 -b v1.2.0 bats
       - run: bats/bin/bats --tap test

CHANGELOG.md

@@ -1,9 +1,18 @@
 ## Version History
 
-#### v1.2.6
+## v1.4.0
+* Fix POSIX sh (dash) compatibility in pyenv-virtualenv-init by @chrisolof in https://github.com/pyenv/pyenv-virtualenv/pull/526
+* Improve performance and output of `pyenv virtualenvs` by @samdoran in https://github.com/pyenv/pyenv-virtualenv/pull/502
+
+## v1.3.0
+* CI: cleanup by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/521
+* CI: tests: use Bats 1.10; support concurrent, out-of-order and multiple-times execution of stub commands; fix race condition between concurrent stubs by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/520
+* Drastically speed up precommand hook by caching active version to skip redundant `activate` calls by @jakelodwick in https://github.com/pyenv/pyenv-virtualenv/pull/523
+
+## v1.2.6
 * Fix changelog and version numbers
 
-#### v1.2.5
+## v1.2.5
 * Add prompt customization by @jimenezj8 in https://github.com/pyenv/pyenv-virtualenv/pull/476
 * README: fix and distinguish syntax highlighting in Bash vs Fish snippets by @diericx in https://github.com/pyenv/pyenv-virtualenv/pull/489
 * Fix pyenv-virtualenv using a different Python version in a conda environment by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/492
@@ -15,18 +24,18 @@
 * Convert issue template to new Github format by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/519
 * Prevent loss of data on `virtualenv-delete -f` if the env doesn't exist and the PREFIX envvar is set elsewhere by @SabriRamadanTNG in https://github.com/pyenv/pyenv-virtualenv/pull/518
 
-#### v1.2.4
+## v1.2.4
 * Fix failing to detect `-m venv` when "python" is not provided by the distro by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/479
 * README: Remove dollar signs from commands that are meant to be copied by @galonsky in https://github.com/pyenv/pyenv-virtualenv/pull/481
 * Reflect pyenv-latest switch change in 2.4.8 by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/484
 
-#### v1.2.3
+## v1.2.3
 * Fix: add `colorize` helper by @silverjam in https://github.com/pyenv/pyenv-virtualenv/pull/470
 * Bump pyenv-virtualenv reporting version to match release by @ushuz in https://github.com/pyenv/pyenv-virtualenv/pull/471
 * Add fish prompt changing by @romirk in https://github.com/pyenv/pyenv-virtualenv/pull/475
 * Don't activate if a 3rd-party venv is activated over ours by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/478
 
-#### v1.2.2
+## v1.2.2
 * Prompt removal was never done and is not planned anymore by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/447
 * Update PYENV_VIRTUALENV_VERSION by @jack-mcivor in https://github.com/pyenv/pyenv-virtualenv/pull/449
 * Add activate/deactivate hooks by @joshfrench in https://github.com/pyenv/pyenv-virtualenv/pull/452
@@ -34,10 +43,10 @@
 * Add fish install oneliner by @ElijahLynn in https://github.com/pyenv/pyenv-virtualenv/pull/322
 * Link python*-config into VE by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/460
 
-#### v1.2.1
+## v1.2.1
 * Support prefixes resolved by pyenv-latest as base version names by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/446
 
-#### v1.2.0
+## v1.2.0
 * ~/.*rc should be modified instead of ~/.*profile by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/384
 * Fixes #394 - update pyenv virtualenvs to list virtualenvs start with dot prefixes by @Gauravtalreja1 in https://github.com/pyenv/pyenv-virtualenv/pull/395
 * Fix installation steps to allow for Pyenv 2 by @native-api in https://github.com/pyenv/pyenv-virtualenv/pull/388
@@ -60,63 +69,63 @@
 * Use realpath of scripts to determine relative locations by @andrew-christianson in https://github.com/pyenv/pyenv-virtualenv/pull/308
 * Shell detect improvements by @scop in https://github.com/pyenv/pyenv-virtualenv/pull/377
 
-#### v1.1.5
+## v1.1.5
 
 * Fix install script (#290, #302)
 
-#### v1.1.4
+## v1.1.4
 
 * Support newer conda (#290)
 * Prefer `python3.x` executable if available (#206, #282, #296)
 
-#### v1.1.3
+## v1.1.3
 
 * No code changes since 1.1.2
 
-#### v1.1.2
+## v1.1.2
 
 * Use custom get-pip URL based on the target version (#253, #254, #255)
 * Source conda 4.4.4 shell files (#251)
 * Evaluate force flag before testing if venv exists (#232)
 
-#### v1.1.1
+## v1.1.1
 
 * Set `CONDA_PREFIX` to make is useable in conda activate/deactivate scripts (#224)
 * Generate `pydoc` executable after creating new virtualenv (#197, #230)
 
-#### v1.1.0
+## v1.1.0
 
 * fish: use "set -gx" instead of "setenv" (#215, #216, #217, #218)
 
-#### v1.0.0
+## v1.0.0
 
 * Use similar versioning scheme as pyenv; YYYYMMDD -> X.Y.Z
 
-#### v20160716
+## v20160716
 
 * Suppress activate/deactivate messages by default (#169, #170, #171)
 * Source conda package activate/deactivat scripts if exist (#173)
 * Use `source` in favor of `.` for `fish` (#175)
 * Use `python -m venv` instead of `pyvenv` due to deprecation of `pyvenv` after 3.6 (#184, #185)
 
-#### v20160315
+## v20160315
 
 * Evaluate `${PATH}` when outputted code is eval'd. (#154)
 * Set proper `CONDA_DEFAULT_ENV` for shorter name (#160)
 
-#### v20160202
+## v20160202
 
 * Install virtualenv 13.1.2 for CPython/Stackless 3.2.x (yyuu/pyenv#531)
 
-#### v20160112
+## v20160112
 
 * Fix problem with `virtualenv` to look up executables from source version with `--system-site-packages` (#62)
 
-#### v20151229
+## v20151229
 
 * Fix `deactivate` error on `fish` (#136)
 
-#### v20151222
+## v20151222
 
 * Improved interoperability with Anaconda/Miniconda (#103, #106, #107, #108)
 * Create `virtualenv` inside `envs` directory of source version, like Anaconda/Miniconda (#103, #107)
@@ -126,49 +135,49 @@
 * Add `--skip-aliases` to `pyenv virtualenvs` (#120)
 * Stop showing `version not installed` warning messages in precmd (#49)
 
-#### v20151103
+## v20151103
 
 * Passing return value from executed command. (#100)
 * Add workaround for commands installed in a virtual environment created by `pyvenv` (#62)
 * init: zsh: prepend hook to `precmd_functions` (#101)
 
-#### v20151006
+## v20151006
 
 * Ignore user's site-packages on ensurepip/get-pip (#89)
 * Find `python-config` from source version if current version is a virtualenv
 * Fix pyenv-virtualenv-init script for fish where command was in string and not being evaluated (#98)
 * Add foolproof for `-p` argument. (yyuu/pyenv#98)
 
-#### v20150719
+## v20150719
 
 * Add support for `conda` environments created by Anaconda/Miniconda (#91)
 * Look up commands for original version as well if the environment is created with `--system-site-packages` (#62)
 * Add error message if the source version is not installed (#83)
 
-#### v20150526
+## v20150526
 
 * Use `typeset -g` with `precmd_functions` (#75)
 * activate: display setup instructions only with `PYENV_VIRTUALENV_INIT=0` (#78)
 * Ignore failure of pyenv activate (#68)
 
-#### v20150119
+## v20150119
 
  * Ignore errors from `pyenv-version-name` since it might fail if there is configuration error (yyuu/pyenv#291)
  * The _shell_ version set in `activate` should be unset in `deactivate` (#61)
  * Anaconda has `activate` script nevertheless it is not a virtual environment (#65)
 
-#### v20141106
+## v20141106
 
  * Stop creating after `ensurepip` since it has done by `ensurepip` itself
  * Suppress some useless warnings from `pyenv virtualenv-init`
 
-#### v20141012
+## v20141012
 
  * Fix warnings from `shellcheck` to improve support for POSIX sh (#40)
  * Do not allow whitespace in `VIRTUALENV_NAME` (#44)
  * Should not persist `PYENV_DEACTIVATE` after automatic deactivation (#47, #48)
 
-#### v20140705
+## v20140705
 
  * Display information on auto-(de)?activation
  * Support manual (de)?activation with auto-activation enabled (#32, #34)
@@ -176,88 +185,88 @@
  * Use https://bootstrap.pypa.io/ to install setuptools and pip
  * Create backup of original virtualenv within `$(pyenv root)/versions` when `--upgrade`
 
-#### v20140615
+## v20140615
 
  * Fix incompatibility issue of `pyenv activate` and `pyenv deactivate` (#26)
  * Workaround for the issue with pyenv-which-ext (#26)
 
-#### v20140614
+## v20140614
 
  * Add `pyenv virtualenv-init` to enable auto-activation feature (#24)
  * Create symlinks for executables with version suffix (yyuu/pyenv#182)
 
-#### v20140602
+## v20140602
 
  * Use new style GH raw url to avoid redirects (raw.github.com -> raw.githubusercontent.com)
  * Repaired virtualenv activation and deactivation for the fish shell (#23)
 
-#### v20140421
+## v20140421
 
  * Display error if `pyenv activate` was invoked as a command
  * Fix completion of `pyenv activate` (#15)
  * Use `virtualenv` instead of `pyvenv` if `-p` has given (yyuu/pyenv#158)
 
-#### v20140123
+## v20140123
 
  * Add `activate` and `deactivate` to make `pyenv-virtualenv` work with [jedi](https://github.com/davidhalter/jedi) (#9)
  * Use `ensurepip` to install `pip` if it is available
  * Unset `PIP_REQUIRE_VENV` to avoid problem on the installation of `virtualenv` (#10)
  * Add tests
 
-#### v20140110.1
+## v20140110.1
 
  * Fix install script
 
-#### v20140110
+## v20140110
 
  * Support environment variables of `EZ_SETUP` and `GET_PIP`.
  * Support a short option `-p` of `virtualenv`.
 
-#### v20131216
+## v20131216
 
  * Use latest release of setuptools and pip if the version not given via environment variables.
 
-#### v20130622
+## v20130622
 
  * Removed bundled `virtualenv.py` script. Now pyenv-virtualenv installs `virtualenv` package into source version and then use it.
  * On Python 3.3+, use `pyvenv` as virtualenv command if `virtualenv` is not available.
  * Install setuptools and pip into environments created by `pyvenv`.
 
-#### v20130614
+## v20130614
 
  * Add `pyenv virtualenvs` to list all virtualenv versions.
  * *EXPERIMENTAL*: Add `--upgrade` option to re-create virtualenv with migrating packages
 
-#### v20130527
+## v20130527
 
  * Remove `python-virtualenv` which was no longer used.
  * Change the installation path of the `virtualenv.py` script. (`./libexec` -> `./libexec/pyenv-virtualenv/${VIRTUALENV_VERSION}`)
  * Download `virtualenv.py` if desired version has not been installed.
 
-#### v20130507
+## v20130507
 
  * Display virtualenv information in `--help` and `--version`
  * Update virtualenv version; 1.8.4 -> 1.9.1
 
-#### v20130307
+## v20130307
 
  * Rename the project; `s/python-virtualenv/pyenv-virtualenv/g`
  * The `pyenv-virtualenv` script is not depending on `python-virtualenv` now.
    `python-virtualenv` will left for compatibility and will not continue for future releases.
  * Update virtualenv version; 1.8.2 -> 1.8.4
 
-#### v20130218
+## v20130218
 
  * Add pyenv 0.2.x (rbenv 0.4.x) style help messages.
 
-#### v20121023
+## v20121023
 
  * Create virtualenv with exact name of python executables.
  * Changed command-line options of python-virtualenv.
    First argument should be a path to the python executable.
  * Add install script.
 
-#### v20120927
+## v20120927
 
  * Initial public release.
 

bin/pyenv-virtualenv

@@ -13,7 +13,7 @@
 #   -u/--upgrade     Imply --force
 #
 
-PYENV_VIRTUALENV_VERSION="1.2.6"
+PYENV_VIRTUALENV_VERSION="1.4.0"
 
 set -e
 [ -n "$PYENV_DEBUG" ] && set -x
@@ -24,7 +24,7 @@ fi
 
 # Provide pyenv completions
 if [ "$1" = "--complete" ]; then
-  exec pyenv-versions --bare
+  exec pyenv-versions --bare --skip-envs
 fi
 
 unset PIP_REQUIRE_VENV

bin/pyenv-virtualenv-init

@@ -9,6 +9,23 @@
 set -e
 [ -n "$PYENV_DEBUG" ] && set -x
 
+# Detect stat format for mtime: GNU uses -c %Y, BSD uses -f %m
+# -L follows symlinks: a symlinked .python-version reflects target changes
+if stat -L -c %Y / >/dev/null 2>&1; then
+  _stat_fmt="-L -c %Y"
+else
+  _stat_fmt="-L -f %m"
+fi
+
+# Check for version-name hooks at init time. Hooks can alter version
+# resolution in ways the mtime cache cannot track. If present, the hook
+# falls back to upstream behavior (no caching). Restart shell after
+# installing or removing pyenv plugins.
+_has_version_hooks=""
+if [ -n "$(pyenv hooks version-name 2>/dev/null)" ]; then
+  _has_version_hooks=1
+fi
+
 resolve_link() {
   $(type -p greadlink readlink | head -1) "$1"
 }
@@ -106,57 +123,147 @@ fish )
   cat <<EOS
 function _pyenv_virtualenv_hook --on-event fish_prompt;
   set -l ret \$status
+EOS
+
+  if [ -z "$_has_version_hooks" ]; then
+    cat <<EOS
+  if test "\$PYENV_VERSION" = "\$_PYENV_VH_VERSION" \\
+    -a "\$VIRTUAL_ENV" = "\$_PYENV_VH_VENV"
+    if test -n "\$PYENV_VERSION"
+      return \$ret
+    end
+    if test "\$PWD" = "\$_PYENV_VH_PWD" \\
+      -a "(stat ${_stat_fmt} \$_PYENV_VH_PATHS 2>/dev/null)" = "\$_PYENV_VH_MTIMES"
+      return \$ret
+    end
+  end
+EOS
+  fi
+  
+  cat <<EOS
   if [ -n "\$VIRTUAL_ENV" ]
     pyenv activate --quiet; or pyenv deactivate --quiet; or true
   else
     pyenv activate --quiet; or true
   end
+EOS
+
+  if [ -z "$_has_version_hooks" ]; then
+    cat <<EOS
+  set -g _PYENV_VH_PWD "\$PWD"
+  set -g _PYENV_VH_VERSION "\$PYENV_VERSION"
+  set -g _PYENV_VH_VENV "\$VIRTUAL_ENV"
+  set -l d "\$PWD"
+  set -l _pvh_found_local 0
+  set -g _PYENV_VH_PATHS
+  while true
+    if test -f "\$d/.python-version"; or test -L "\$d/.python-version"
+      set -g _PYENV_VH_PATHS \$_PYENV_VH_PATHS "\$d/.python-version"
+      if test -f "\$d/.python-version" 
+        set _pvh_found_local 1
+        break
+      end
+    else
+      set -g _PYENV_VH_PATHS \$_PYENV_VH_PATHS "\$d"
+    end
+    test "\$d" = "/"; and break
+    set d (string replace -r '/[^/]*\$' '' -- "\$d")
+    test -z "\$d"; and set d "/"
+  end
+  if test "\$_pvh_found_local" = "0"
+    set -g _PYENV_VH_PATHS \$_PYENV_VH_PATHS "\$PYENV_ROOT/version"
+  end
+  set -g _PYENV_VH_MTIMES (stat ${_stat_fmt} \$_PYENV_VH_PATHS 2>/dev/null)
+EOS
+  fi
+  
+  cat <<EOS
   return \$ret
 end
-EOS
- ;;
-ksh )
-  cat <<EOS
-function _pyenv_virtualenv_hook() {
 EOS
   ;;
-* )
+
+bash|zsh )
   cat <<EOS
 _pyenv_virtualenv_hook() {
-EOS
-  ;;
-esac
-
-if [[ "$shell" != "fish" ]]; then
-  cat <<EOS
   local ret=\$?
+EOS
+
+  if [ -z "$_has_version_hooks" ]; then
+    cat <<EOS
+  if [ "\${PYENV_VERSION-}" = "\${_PYENV_VH_VERSION-}" ] \\
+    && [ "\${VIRTUAL_ENV-}" = "\${_PYENV_VH_VENV-}" ]; then
+    if [ -n "\${PYENV_VERSION-}" ]; then
+      return \$ret
+    fi
+    if [ "\${PWD}" = "\${_PYENV_VH_PWD-}" ] \\
+      && [ "\$(stat ${_stat_fmt} "\${_PYENV_VH_PATHS[@]}" 2>/dev/null)" = "\${_PYENV_VH_MTIMES-}" ]; then
+      return \$ret
+    fi
+  fi
+EOS
+  fi
+
+  cat <<EOS
   if [ -n "\${VIRTUAL_ENV-}" ]; then
     eval "\$(pyenv sh-activate --quiet || pyenv sh-deactivate --quiet || true)" || true
   else
     eval "\$(pyenv sh-activate --quiet || true)" || true
   fi
+EOS
+
+  if [ -z "$_has_version_hooks" ]; then
+    cat <<EOS
+  _PYENV_VH_PWD="\${PWD}"
+  _PYENV_VH_VERSION="\${PYENV_VERSION-}"
+  _PYENV_VH_VENV="\${VIRTUAL_ENV-}"
+  local _pvh_d="\${PWD}" _pvh_found_local=0
+  _PYENV_VH_PATHS=()
+  while :; do
+    if [ -f "\${_pvh_d}/.python-version" ] || [ -L "\${_pvh_d}/.python-version" ]; then
+      _PYENV_VH_PATHS+=("\${_pvh_d}/.python-version")
+      if [ -f "\${_pvh_d}/.python-version" ]; then 
+        _pvh_found_local=1
+        break
+      fi
+    else
+      _PYENV_VH_PATHS+=("\${_pvh_d}")
+    fi
+    [ "\${_pvh_d}" = "/" ] && break
+    _pvh_d="\${_pvh_d%/*}"
+    [ -z "\${_pvh_d}" ] && _pvh_d="/"
+  done
+  if [ "\${_pvh_found_local}" = "0" ]; then
+    _PYENV_VH_PATHS+=("\${PYENV_ROOT}/version")
+  fi
+  _PYENV_VH_MTIMES="\$(stat ${_stat_fmt} "\${_PYENV_VH_PATHS[@]}" 2>/dev/null)"
+EOS
+  fi
+
+  cat <<EOS
   return \$ret
 };
 EOS
+  ;;
+esac
 
-  case "$shell" in
+case "$shell" in
-  bash )
+bash )
-    cat <<EOS
+  cat <<EOS
 if ! [[ "\${PROMPT_COMMAND-}" =~ _pyenv_virtualenv_hook ]]; then
   PROMPT_COMMAND="_pyenv_virtualenv_hook;\${PROMPT_COMMAND-}"
 fi
 EOS
-    ;;
+  ;;
-  zsh )
+zsh )
-    cat <<EOS
+  cat <<EOS
 typeset -g -a precmd_functions
 if [[ -z \$precmd_functions[(r)_pyenv_virtualenv_hook] ]]; then
   precmd_functions=(_pyenv_virtualenv_hook \$precmd_functions);
 fi
 EOS
-    ;;
+  ;;
-  * )
+* )
-    # FIXME: what should i do here??
+  # No prompt command support or it's installed elsewhere
-    ;;
+  ;;
-  esac
+esac
-fi

bin/pyenv-virtualenv-prefix

@@ -26,13 +26,17 @@ if [ -z "$PYENV_ROOT" ]; then
   PYENV_ROOT="${HOME}/.pyenv"
 fi
 
+OLDIFS="$IFS"
+IFS=:
 if [ -n "$1" ]; then
-  versions=($@)
+  # $@ is not affected by IFS
-  IFS=: PYENV_VERSION="${versions[*]}"
+  versions=("$@")
+  PYENV_VERSION="${versions[*]}"
   export PYENV_VERSION
 else
-  IFS=: versions=($(pyenv-version-name))
+  versions=($(pyenv-version-name))
 fi
+IFS="$OLDIFS"
 
 append_virtualenv_prefix() {
   if [ -d "${VIRTUALENV_PREFIX_PATH}" ]; then
@@ -49,7 +53,18 @@ for version in "${versions[@]}"; do
     echo "pyenv-virtualenv: version \`${version}' is not a virtualenv" 1>&2
     exit 1
   fi
-  PYENV_PREFIX_PATH="$(pyenv-prefix "${version}")"
+
+  # In the vast majority of cases, there's a direct match and 
+  # not spawning `pyenv-prefix' saves about half the invocation time
+  # with a signle argument which accumulates when called repeatedly
+  # (e.g. from `pyenv-virtualenvs').
+  # `pyenv-prefix' also does not have hooks to worry about.
+  # XXX: refactor the test into a shared module?
+  PYENV_PREFIX_PATH="${PYENV_ROOT}/versions/${version}"
+  if [[ ! -d "$PYENV_PREFIX_PATH" ]]; then
+    PYENV_PREFIX_PATH="$(pyenv-prefix "${version}")"
+  fi
+
   if [ -x "${PYENV_PREFIX_PATH}/bin/python" ]; then
     if [ -f "${PYENV_PREFIX_PATH}/bin/activate" ]; then
       if [ -f "${PYENV_PREFIX_PATH}/bin/conda" ]; then
@@ -94,4 +109,7 @@ for version in "${versions[@]}"; do
   fi
 done
 
-IFS=: echo "${VIRTUALENV_PREFIX_PATHS[*]}"
+OLDIFS="$IFS"
+IFS=:
+echo "${VIRTUALENV_PREFIX_PATHS[*]}"
+IFS="$OLDIFS"

bin/pyenv-virtualenvs

@@ -6,24 +6,9 @@
 # List all virtualenvs found in `$PYENV_ROOT/versions/*' and its `$PYENV_ROOT/versions/envs/*'.
 
 set -e
-[ -n "$PYENV_DEBUG" ] && set -x
+[[ -n $PYENV_DEBUG ]] && set -x
-if [ -L "${BASH_SOURCE}" ]; then
-    READLINK=$(type -p greadlink readlink | head -1)
-    if [ -z "$READLINK" ]; then
-        echo "pyenv: cannot find readlink - are you missing GNU coreutils?" >&2
-        exit 1
-    fi
-    resolve_link() {
-        $READLINK -f "$1"
-    }
-    script_path=$(resolve_link ${BASH_SOURCE})
-else
-    script_path=${BASH_SOURCE}
-fi
 
-. ${script_path%/*}/../libexec/pyenv-virtualenv-realpath
+if [[ -z $PYENV_ROOT ]]; then
-
-if [ -z "$PYENV_ROOT" ]; then
   PYENV_ROOT="${HOME}/.pyenv"
 fi
 
@@ -47,28 +32,26 @@ done
 
 versions_dir="${PYENV_ROOT}/versions"
 
-if [ -d "$versions_dir" ]; then
+if [[ ${BASH_VERSINFO[0]} -gt 3 ]]; then
-  versions_dir="$(realpath "$versions_dir")"
+  declare -A current_versions
-fi
-
-if [ -n "$bare" ]; then
-  hit_prefix=""
-  miss_prefix=""
-  current_versions=()
-  unset print_origin
-  include_system=""
 else
+  current_versions=()
+fi
+if [[ -z $bare ]]; then
   hit_prefix="* "
   miss_prefix="  "
   OLDIFS="$IFS"
-  IFS=: current_versions=($(pyenv-version-name || true))
+  IFS=:
+  if [[ ${BASH_VERSINFO[0]} -gt 3 ]]; then
+    for i in $(pyenv-version-name || true); do
+      current_versions["$i"]="1"
+    done
+  else
+    read -r -a current_versions <<< "$(pyenv-version-name || true)"
+  fi
   IFS="$OLDIFS"
-  print_origin="1"
-  include_system=""
 fi
 
-num_versions=0
-
 exists() {
   local car="$1"
   local cdar
@@ -82,39 +65,67 @@ exists() {
 }
 
 print_version() {
-  if exists "$1" "${current_versions[@]}"; then
+  local version="${1:?}"
-    echo "${hit_prefix}${1}${print_origin+$2}"
+  if [[ -n $bare ]]; then
-  else
+    echo "$version"
-    echo "${miss_prefix}${1}${print_origin+$2}"
+    return
+  fi
+  local path="${2:?}"
+  if [[ -L "$path" ]]; then
+    version_repr="$version --> $(readlink "$path")"
+  else
+    version_repr="$version (created from $(pyenv-virtualenv-prefix "$version" 2>/dev/null))"
+  fi
+  if [[ ${BASH_VERSINFO[0]} -gt 3 && ${current_versions["$1"]} ]] || \
+     { [[ ${BASH_VERSINFO[0]} -le 3 ]] && exists "$1" "${current_versions[@]}"; }; then
+    echo "${hit_prefix}${version_repr} (set by $(pyenv-version-origin))"
+  else
+    echo "${miss_prefix}${version_repr}"
   fi
-  num_versions=$((num_versions + 1))
 }
 
 shopt -s dotglob
 shopt -s nullglob
-for path in "$versions_dir"/*; do
+version_dir_entries=("$versions_dir"/*)
-  if [ -d "$path" ]; then
+venv_dir_entries=("$versions_dir"/*/envs/*)
-    if [ -n "$skip_aliases" ] && [ -L "$path" ]; then
+
-      target="$(realpath "$path")"
+if sort --version-sort </dev/null >/dev/null 2>&1; then
-      [ "${target%/*/envs/*}" != "$versions_dir" ] || continue
+    # system sort supports version sorting
-    fi
+    OLDIFS="$IFS"
-    virtualenv_prefix="$(pyenv-virtualenv-prefix "${path##*/}" 2>/dev/null || true)"
+    IFS='||'
-    if [ -d "${virtualenv_prefix}" ]; then
+
-      print_version "${path##*/}" " (created from ${virtualenv_prefix})"
+    read -r -a version_dir_entries <<< "$(
-    fi
+        printf "%s||" "${version_dir_entries[@]}" |
-    for venv_path in "${path}/envs/"*; do
+        sort --version-sort
-      venv="${path##*/}/envs/${venv_path##*/}"
+    )"
-      virtualenv_prefix="$(pyenv-virtualenv-prefix "${venv}" 2>/dev/null || true)"
+
-      if [ -d "${virtualenv_prefix}" ]; then
+    read -r -a venv_dir_entries <<< "$(
-        print_version "${venv}" " (created from ${virtualenv_prefix})"
+        printf "%s||" "${venv_dir_entries[@]}" |
-      fi
+        sort --version-sort
-    done
+    )"
+
+    IFS="$OLDIFS"
+fi
+
+for env_path in "${venv_dir_entries[@]}"; do
+  if [[ -d ${env_path} ]]; then
+    print_version "${env_path#"${PYENV_ROOT}"/versions/}" "${env_path}"
   fi
 done
+
+for env_path in "${version_dir_entries[@]}"; do
+  if [[ -d ${env_path} ]]; then
+    if [[ -L ${env_path} ]]; then
+      if [[ -z $skip_aliases ]]; then
+        print_version "${env_path#"${PYENV_ROOT}"/versions/}" "${env_path}"
+      fi
+    # Mimics the test from pyenv-virtualenv-prefix
+    # XXX: refactor itto a shared module ?
+    elif [[ -f "${env_path}/bin/activate" ]]; then
+      print_version "${env_path#"${PYENV_ROOT}"/versions/}" "${env_path}"
+    fi
+  fi
+done
+
 shopt -u dotglob
 shopt -u nullglob
-
-if [ "$num_versions" -eq 0 ] && [ -n "$include_system" ]; then
-  echo "Warning: no Python virtualenv detected on the system" >&2
-  exit 1
-fi

test/conda-prefix.bats

@@ -9,7 +9,6 @@ setup() {
 @test "display conda root" {
   setup_conda "anaconda-2.3.0"
   stub pyenv-version-name "echo anaconda-2.3.0"
-  stub pyenv-prefix "anaconda-2.3.0 : echo \"${PYENV_ROOT}/versions/anaconda-2.3.0\""
 
   PYENV_VERSION="anaconda-2.3.0" run pyenv-virtualenv-prefix
 
@@ -19,14 +18,12 @@ ${PYENV_ROOT}/versions/anaconda-2.3.0
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
   teardown_conda "anaconda-2.3.0"
 }
 
 @test "display conda env" {
   setup_conda "anaconda-2.3.0" "foo"
   stub pyenv-version-name "echo anaconda-2.3.0/envs/foo"
-  stub pyenv-prefix "anaconda-2.3.0/envs/foo : echo \"${PYENV_ROOT}/versions/anaconda-2.3.0/envs/foo\""
 
   PYENV_VERSION="anaconda-2.3.0/envs/foo" run pyenv-virtualenv-prefix
 
@@ -36,6 +33,5 @@ ${PYENV_ROOT}/versions/anaconda-2.3.0/envs/foo
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
   teardown_conda "anaconda-2.3.0" "foo"
 }

test/conda.bats

@@ -26,7 +26,8 @@ unstub_pyenv() {
   stub_pyenv "${PYENV_VERSION}"
   stub pyenv-prefix " : echo '${PYENV_ROOT}/versions/${PYENV_VERSION}'"
   stub pyenv-virtualenv-prefix " : echo '${PYENV_ROOT}/versions/${PYENV_VERSION}'"
-  stub pyenv-exec "conda * : echo PYENV_VERSION=\${PYENV_VERSION} \"\$@\""
+  stub -N pyenv-exec "conda list * : true"
+  stub -N pyenv-exec "conda create * : echo PYENV_VERSION=\${PYENV_VERSION} \"\$@\""
   stub pyenv-exec "python -s -m ensurepip : true"
 
   run pyenv-virtualenv venv
@@ -49,11 +50,11 @@ OUT
   stub_pyenv "${PYENV_VERSION}"
   stub pyenv-prefix " : echo '${PYENV_ROOT}/versions/${PYENV_VERSION}'"
   stub pyenv-virtualenv-prefix " : echo '${PYENV_ROOT}/versions/${PYENV_VERSION}'"
-  stub pyenv-exec "conda * : echo PYENV_VERSION=\${PYENV_VERSION} \"\$@\""
+  stub pyenv-exec "conda create * : echo PYENV_VERSION=\${PYENV_VERSION} \"\$@\""
   stub pyenv-exec "python -s -m ensurepip : true"
 
   run pyenv-virtualenv -p python3.5 venv
-
+  
   assert_success
   assert_output <<OUT
 PYENV_VERSION=miniconda3-3.16.0 conda create --name venv --yes python=3.5
@@ -72,7 +73,7 @@ OUT
   stub_pyenv "${PYENV_VERSION}"
   stub pyenv-prefix " : echo '${PYENV_ROOT}/versions/${PYENV_VERSION}'"
   stub pyenv-virtualenv-prefix " : echo '${PYENV_ROOT}/versions/${PYENV_VERSION}'"
-  stub pyenv-exec "conda * : echo PYENV_VERSION=\${PYENV_VERSION} \"\$@\""
+  stub pyenv-exec "conda create * : echo PYENV_VERSION=\${PYENV_VERSION} \"\$@\""
   stub pyenv-exec "python -s -m ensurepip : true"
 
   run pyenv-virtualenv --python=python3.5 venv

test/init.bats

@@ -29,22 +29,18 @@ load test_helper
   rm -f "${TMP}/script.sh"
 }
 
-@test "sh-compatible instructions" {
-  run pyenv-virtualenv-init bash
-  assert [ "$status" -eq 1 ]
-  assert_output_contains 'eval "$(pyenv virtualenv-init -)"'
-
-  run pyenv-virtualenv-init zsh
-  assert [ "$status" -eq 1 ]
-  assert_output_contains 'eval "$(pyenv virtualenv-init -)"'
-}
-
 @test "fish instructions" {
   run pyenv-virtualenv-init fish
   assert [ "$status" -eq 1 ]
   assert_output_contains 'status --is-interactive; and source (pyenv virtualenv-init -|psub)'
 }
 
+@test "other shells instructions" {
+    run pyenv-virtualenv-init some_other_sh
+    assert [ "$status" -eq 1 ]
+    assert_output_contains 'eval "$(pyenv virtualenv-init -)"'
+}
+
 @test "outputs bash-specific syntax" {
   export PYENV_VIRTUALENV_ROOT="${TMP}/pyenv/plugins/pyenv-virtualenv"
   run pyenv-virtualenv-init - bash
@@ -54,11 +50,44 @@ export PATH="${TMP}/pyenv/plugins/pyenv-virtualenv/shims:\${PATH}";
 export PYENV_VIRTUALENV_INIT=1;
 _pyenv_virtualenv_hook() {
   local ret=\$?
+  if [ "\${PYENV_VERSION-}" = "\${_PYENV_VH_VERSION-}" ] \\
+    && [ "\${VIRTUAL_ENV-}" = "\${_PYENV_VH_VENV-}" ]; then
+    if [ -n "\${PYENV_VERSION-}" ]; then
+      return \$ret
+    fi
+    if [ "\${PWD}" = "\${_PYENV_VH_PWD-}" ] \\
+      && [ "\$(stat ${_stat_fmt} "\${_PYENV_VH_PATHS[@]}" 2>/dev/null)" = "\${_PYENV_VH_MTIMES-}" ]; then
+      return \$ret
+    fi
+  fi
   if [ -n "\${VIRTUAL_ENV-}" ]; then
     eval "\$(pyenv sh-activate --quiet || pyenv sh-deactivate --quiet || true)" || true
   else
     eval "\$(pyenv sh-activate --quiet || true)" || true
   fi
+  _PYENV_VH_PWD="\${PWD}"
+  _PYENV_VH_VERSION="\${PYENV_VERSION-}"
+  _PYENV_VH_VENV="\${VIRTUAL_ENV-}"
+  local _pvh_d="\${PWD}" _pvh_found_local=0
+  _PYENV_VH_PATHS=()
+  while :; do
+    if [ -f "\${_pvh_d}/.python-version" ] || [ -L "\${_pvh_d}/.python-version" ]; then
+      _PYENV_VH_PATHS+=("\${_pvh_d}/.python-version")
+      if [ -f "\${_pvh_d}/.python-version" ]; then 
+        _pvh_found_local=1
+        break
+      fi
+    else
+      _PYENV_VH_PATHS+=("\${_pvh_d}")
+    fi
+    [ "\${_pvh_d}" = "/" ] && break
+    _pvh_d="\${_pvh_d%/*}"
+    [ -z "\${_pvh_d}" ] && _pvh_d="/"
+  done
+  if [ "\${_pvh_found_local}" = "0" ]; then
+    _PYENV_VH_PATHS+=("\${PYENV_ROOT}/version")
+  fi
+  _PYENV_VH_MTIMES="\$(stat ${_stat_fmt} "\${_PYENV_VH_PATHS[@]}" 2>/dev/null)"
   return \$ret
 };
 if ! [[ "\${PROMPT_COMMAND-}" =~ _pyenv_virtualenv_hook ]]; then
@@ -78,11 +107,45 @@ set -gx PATH '${TMP}/pyenv/plugins/pyenv-virtualenv/shims' \$PATH;
 set -gx PYENV_VIRTUALENV_INIT 1;
 function _pyenv_virtualenv_hook --on-event fish_prompt;
   set -l ret \$status
+  if test "\$PYENV_VERSION" = "\$_PYENV_VH_VERSION" \\
+    -a "\$VIRTUAL_ENV" = "\$_PYENV_VH_VENV"
+    if test -n "\$PYENV_VERSION"
+      return \$ret
+    end
+    if test "\$PWD" = "\$_PYENV_VH_PWD" \\
+      -a "(stat ${_stat_fmt} \$_PYENV_VH_PATHS 2>/dev/null)" = "\$_PYENV_VH_MTIMES"
+      return \$ret
+    end
+  end
   if [ -n "\$VIRTUAL_ENV" ]
     pyenv activate --quiet; or pyenv deactivate --quiet; or true
   else
     pyenv activate --quiet; or true
   end
+  set -g _PYENV_VH_PWD "\$PWD"
+  set -g _PYENV_VH_VERSION "\$PYENV_VERSION"
+  set -g _PYENV_VH_VENV "\$VIRTUAL_ENV"
+  set -l d "\$PWD"
+  set -l _pvh_found_local 0
+  set -g _PYENV_VH_PATHS
+  while true
+    if test -f "\$d/.python-version"; or test -L "\$d/.python-version"
+      set -g _PYENV_VH_PATHS \$_PYENV_VH_PATHS "\$d/.python-version"
+      if test -f "\$d/.python-version" 
+        set _pvh_found_local 1
+        break
+      end
+    else
+      set -g _PYENV_VH_PATHS \$_PYENV_VH_PATHS "\$d"
+    end
+    test "\$d" = "/"; and break
+    set d (string replace -r '/[^/]*\$' '' -- "\$d")
+    test -z "\$d"; and set d "/"
+  end
+  if test "\$_pvh_found_local" = "0"
+    set -g _PYENV_VH_PATHS \$_PYENV_VH_PATHS "\$PYENV_ROOT/version"
+  end
+  set -g _PYENV_VH_MTIMES (stat ${_stat_fmt} \$_PYENV_VH_PATHS 2>/dev/null)
   return \$ret
 end
 EOS
@@ -97,11 +160,44 @@ export PATH="${TMP}/pyenv/plugins/pyenv-virtualenv/shims:\${PATH}";
 export PYENV_VIRTUALENV_INIT=1;
 _pyenv_virtualenv_hook() {
   local ret=\$?
+  if [ "\${PYENV_VERSION-}" = "\${_PYENV_VH_VERSION-}" ] \\
+    && [ "\${VIRTUAL_ENV-}" = "\${_PYENV_VH_VENV-}" ]; then
+    if [ -n "\${PYENV_VERSION-}" ]; then
+      return \$ret
+    fi
+    if [ "\${PWD}" = "\${_PYENV_VH_PWD-}" ] \\
+      && [ "\$(stat ${_stat_fmt} "\${_PYENV_VH_PATHS[@]}" 2>/dev/null)" = "\${_PYENV_VH_MTIMES-}" ]; then
+      return \$ret
+    fi
+  fi
   if [ -n "\${VIRTUAL_ENV-}" ]; then
     eval "\$(pyenv sh-activate --quiet || pyenv sh-deactivate --quiet || true)" || true
   else
     eval "\$(pyenv sh-activate --quiet || true)" || true
   fi
+  _PYENV_VH_PWD="\${PWD}"
+  _PYENV_VH_VERSION="\${PYENV_VERSION-}"
+  _PYENV_VH_VENV="\${VIRTUAL_ENV-}"
+  local _pvh_d="\${PWD}" _pvh_found_local=0
+  _PYENV_VH_PATHS=()
+  while :; do
+    if [ -f "\${_pvh_d}/.python-version" ] || [ -L "\${_pvh_d}/.python-version" ]; then
+      _PYENV_VH_PATHS+=("\${_pvh_d}/.python-version")
+      if [ -f "\${_pvh_d}/.python-version" ]; then 
+        _pvh_found_local=1
+        break
+      fi
+    else
+      _PYENV_VH_PATHS+=("\${_pvh_d}")
+    fi
+    [ "\${_pvh_d}" = "/" ] && break
+    _pvh_d="\${_pvh_d%/*}"
+    [ -z "\${_pvh_d}" ] && _pvh_d="/"
+  done
+  if [ "\${_pvh_found_local}" = "0" ]; then
+    _PYENV_VH_PATHS+=("\${PYENV_ROOT}/version")
+  fi
+  _PYENV_VH_MTIMES="\$(stat ${_stat_fmt} "\${_PYENV_VH_PATHS[@]}" 2>/dev/null)"
   return \$ret
 };
 typeset -g -a precmd_functions
@@ -110,3 +206,13 @@ if [[ -z \$precmd_functions[(r)_pyenv_virtualenv_hook] ]]; then
 fi
 EOS
 }
+
+@test "outputs other shells syntax" {
+  export PYENV_VIRTUALENV_ROOT="${TMP}/pyenv/plugins/pyenv-virtualenv"
+  run pyenv-virtualenv-init - some_other_sh
+  assert_success
+  assert_output <<EOS
+export PATH="${TMP}/pyenv/plugins/pyenv-virtualenv/shims:\${PATH}";
+export PYENV_VIRTUALENV_INIT=1;
+EOS
+}

test/prefix.bats

@@ -12,10 +12,6 @@ create_version() {
   chmod +x "${PYENV_ROOT}/versions/$1/bin/python"
 }
 
-remove_version() {
-  rm -fr "${PYENV_ROOT}/versions/$1"
-}
-
 create_virtualenv() {
   create_version "$1"
   create_version "${2:-$1}"
@@ -40,11 +36,6 @@ create_virtualenv_pypy() {
   touch "${PYENV_ROOT}/versions/$1/bin/activate"
 }
 
-remove_virtualenv() {
-  remove_version "$1"
-  remove_version "${2:-$1}"
-}
-
 create_m_venv() {
   create_version "$1"
   create_version "${2:-$1}"
@@ -52,10 +43,6 @@ create_m_venv() {
   touch "${PYENV_ROOT}/versions/$1/bin/activate"
 }
 
-remove_m_venv() {
-  remove_version "${2:-$1}"
-}
-
 create_conda() {
   create_version "$1"
   create_version "${2:-$1}"
@@ -66,13 +53,8 @@ create_conda() {
   touch "${PYENV_ROOT}/versions/${2:-$1}/bin/activate"
 }
 
-remove_conda() {
-  remove_version "${2:-$1}"
-}
-
 @test "display prefix of virtualenv created by virtualenv" {
   stub pyenv-version-name "echo foo"
-  stub pyenv-prefix "foo : echo \"${PYENV_ROOT}/versions/foo\""
   create_virtualenv "foo" "2.7.11"
 
   PYENV_VERSION="foo" run pyenv-virtualenv-prefix
@@ -83,13 +65,10 @@ ${PYENV_ROOT}/versions/2.7.11
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
-  remove_virtualenv "foo" "2.7.11"
 }
 
 @test "display prefix of virtualenv created by virtualenv (pypy)" {
   stub pyenv-version-name "echo foo"
-  stub pyenv-prefix "foo : echo \"${PYENV_ROOT}/versions/foo\""
   create_virtualenv_pypy "foo" "pypy-4.0.1"
 
   PYENV_VERSION="foo" run pyenv-virtualenv-prefix
@@ -100,13 +79,10 @@ ${PYENV_ROOT}/versions/pypy-4.0.1
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
-  remove_virtualenv "foo" "pypy-4.0.1"
 }
 
 @test "display prefix of virtualenv created by virtualenv (jython)" {
   stub pyenv-version-name "echo foo"
-  stub pyenv-prefix "foo : echo \"${PYENV_ROOT}/versions/foo\""
   create_virtualenv_jython "foo" "jython-2.7.0"
 
   PYENV_VERSION="foo" run pyenv-virtualenv-prefix
@@ -117,14 +93,10 @@ ${PYENV_ROOT}/versions/jython-2.7.0
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
-  remove_virtualenv "foo" "jython-2.7.0"
 }
 
 @test "display prefixes of virtualenv created by virtualenv" {
   stub pyenv-version-name "echo foo:bar"
-  stub pyenv-prefix "foo : echo \"${PYENV_ROOT}/versions/foo\"" \
-                    "bar : echo \"${PYENV_ROOT}/versions/bar\""
   create_virtualenv "foo" "2.7.11"
   create_virtualenv "bar" "3.5.1"
 
@@ -136,14 +108,10 @@ ${PYENV_ROOT}/versions/2.7.11:${PYENV_ROOT}/versions/3.5.1
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
-  remove_virtualenv "foo" "2.7.11"
-  remove_virtualenv "bar" "3.5.1"
 }
 
 @test "display prefix of virtualenv created by venv" {
   stub pyenv-version-name "echo foo"
-  stub pyenv-prefix "foo : echo \"${PYENV_ROOT}/versions/foo\""
   create_m_venv "foo" "3.3.6"
 
   PYENV_VERSION="foo" run pyenv-virtualenv-prefix
@@ -154,14 +122,10 @@ ${PYENV_ROOT}/versions/3.3.6
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
-  remove_m_venv "foo" "3.3.6"
 }
 
 @test "display prefixes of virtualenv created by venv" {
   stub pyenv-version-name "echo foo:bar"
-  stub pyenv-prefix "foo : echo \"${PYENV_ROOT}/versions/foo\"" \
-                    "bar : echo \"${PYENV_ROOT}/versions/bar\""
   create_m_venv "foo" "3.3.6"
   create_m_venv "bar" "3.4.4"
 
@@ -173,14 +137,10 @@ ${PYENV_ROOT}/versions/3.3.6:${PYENV_ROOT}/versions/3.4.4
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
-  remove_m_venv "foo" "3.3.6"
-  remove_m_venv "bar" "3.4.4"
 }
 
 @test "display prefix of virtualenv created by conda" {
   stub pyenv-version-name "echo miniconda3-3.16.0/envs/foo"
-  stub pyenv-prefix "miniconda3-3.16.0/envs/foo : echo \"${PYENV_ROOT}/versions/miniconda3-3.16.0/envs/foo\""
   create_conda "miniconda3-3.16.0/envs/foo" "miniconda3-3.16.0"
 
   PYENV_VERSION="miniconda3-3.16.0/envs/foo" run pyenv-virtualenv-prefix
@@ -191,8 +151,6 @@ ${PYENV_ROOT}/versions/miniconda3-3.16.0/envs/foo
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
-  remove_conda "miniconda3-3.16.0/envs/foo" "miniconda3-3.16.0"
 }
 
 @test "should fail if the version is the system" {
@@ -210,7 +168,6 @@ OUT
 
 @test "should fail if the version is not a virtualenv" {
   stub pyenv-version-name "echo 3.4.4"
-  stub pyenv-prefix "3.4.4 : echo \"${PYENV_ROOT}/versions/3.4.4\""
   create_version "3.4.4"
 
   PYENV_VERSION="3.4.4" run pyenv-virtualenv-prefix
@@ -221,14 +178,10 @@ pyenv-virtualenv: version \`3.4.4' is not a virtualenv
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
-  remove_version "3.4.4"
 }
 
 @test "should fail if one of the versions is not a virtualenv" {
   stub pyenv-version-name "echo venv33:3.4.4"
-  stub pyenv-prefix "venv33 : echo \"${PYENV_ROOT}/versions/venv33\"" \
-                    "3.4.4 : echo \"${PYENV_ROOT}/versions/3.4.4\""
   create_virtualenv "venv33" "3.3.6"
   create_version "3.4.4"
 
@@ -240,7 +193,22 @@ pyenv-virtualenv: version \`3.4.4' is not a virtualenv
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-prefix
-  remove_virtualenv "venv33" "3.3.6"
-  remove_version "3.4.4"
 }
+
+@test "resolves a version that is not an exact match" {
+  stub pyenv-version-name "echo 3"
+  create_version "3.4.4"
+  
+  stub pyenv-prefix "3 : echo \"$PYENV_ROOT/versions/3.4.4\""
+
+  run pyenv-virtualenv-prefix
+
+  assert_failure
+  assert_output <<OUT
+pyenv-virtualenv: version \`3' is not a virtualenv
+OUT
+
+  unstub pyenv-version-name
+  unstub pyenv-prefix
+}
+

test/stubs/stub

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+export PS4='+($$:${BASH_SOURCE}:${LINENO}): ${FUNCNAME[0]:+${FUNCNAME[0]}(): }'
 set -e
 
 status=0
@@ -6,40 +7,158 @@ program="${0##*/}"
 PROGRAM="$(echo "$program" | tr a-z- A-Z_)"
 [ -n "$TMPDIR" ] || TMPDIR="/tmp"
 
-_STUB_PLAN="${PROGRAM}_STUB_PLAN"
+STUB_PLAN="${PROGRAM}_STUB_PLAN"
-_STUB_RUN="${PROGRAM}_STUB_RUN"
+STUB_PLAN="${!STUB_PLAN}"
-_STUB_INDEX="${PROGRAM}_STUB_INDEX"
-_STUB_RESULT="${PROGRAM}_STUB_RESULT"
-_STUB_END="${PROGRAM}_STUB_END"
-_STUB_LOG="${PROGRAM}_STUB_LOG"
 
-[ -n "${!_STUB_LOG}" ] || eval "${_STUB_LOG}"="${TMPDIR}/${program}-stub-log"
+STUB_RUN="${PROGRAM}_STUB_RUN"
-if test -z "${!_STUB_END}"; then echo "$program" "$@" >>"${!_STUB_LOG}"; fi
+STUB_RUN="${!STUB_RUN:-${TMPDIR}/${program}-stub-run}"
+STUB_INDEX=
+STUB_RESULT=
 
-[ -e "${!_STUB_PLAN}" ] || exit 1
+STUB_END="${PROGRAM}_STUB_END"
-[ -n "${!_STUB_RUN}" ] || eval "${_STUB_RUN}"="${TMPDIR}/${program}-stub-run"
+STUB_END="${!STUB_END}"
 
+STUB_LOG="${PROGRAM}_STUB_LOG"
+STUB_LOG="${!STUB_LOG:-${TMPDIR}/${program}-stub-log}"
+
+
+STUB_LOCKFILE="${TMPDIR}/${program}-stub.lock"
+
+release_lock() {
+  rm -f "$STUB_LOCKFILE"
+  trap - EXIT
+}
+
+acquire_lock() {
+  local start=$SECONDS
+  local acquire_timeout=10
+  local acquired=
+  while (( SECONDS <= start + $acquire_timeout )); do
+  
+    ( set -o noclobber; echo -n >"$STUB_LOCKFILE" ) 2>/dev/null && acquired=1
+
+    if [[ -n $acquired ]]; then
+      trap release_lock EXIT
+      break
+    else
+      # POSIX sleep(1) doesn't provide subsecond precision, but many others do
+      sleep 0.1 2>/dev/null || sleep 1
+    fi
+  done
+  if [[ -z $acquired ]]; then
+    echo "$0: error: could not acquire stub lock \`$STUB_LOCKFILE' in ${acquire_timeout} seconds" >&2
+    exit 2
+  fi
+}
+
+acquire_lock
+
+if [[ -z $STUB_END ]]; then echo "$program" "$@" >>"$STUB_LOG"; fi
+
+[[ -e $STUB_PLAN ]] || exit 1
 
 # Initialize or load the stub run information.
-eval "${_STUB_INDEX}"=1
+read_runfile() {
-eval "${_STUB_RESULT}"=0
+  if [[ -e $STUB_RUN ]]; then source "$STUB_RUN"; fi
-if test -e "${!_STUB_RUN}"; then source "${!_STUB_RUN}"; fi
+}
+write_runfile() {
+  {
+    local i
+    echo "STUB_INDEX=$STUB_INDEX"
+    echo "STUB_RESULT=$STUB_RESULT"
+    echo "STUB_RUNCOUNTS=()"
+    for i in ${!STUB_RUNCOUNTS[@]}; do
+      echo "STUB_RUNCOUNTS[$i]=${STUB_RUNCOUNTS[$i]}"
+    done
+  } > "$STUB_RUN"
+}
+update_runfile_index() {
+  ( STUB_INDEX=$((STUB_INDEX + 1))
+    write_runfile
+  )
+}
+update_runfile_result() {
+  (
+    # Another stubs may have run while we were running payload
+    # So we need to merge possible state changes
+    local our_result="$STUB_RESULT"
+    local -a our_runcounts
+    array_copy STUB_RUNCOUNTS our_runcounts
+    
+    read_runfile
+    
+    # merge our match_result and their match_result, with failure taking precedence
+    STUB_RESULT=$(( our_result | STUB_RESULT ))
+    
+    # 3-way merge STUB_RUNCOUNTS (their changes),
+    # our_runcounts (our changes) and initial_runcounts (base)
+    local i
+    for i in $(printf '%s\n' ${!STUB_RUNCOUNTS[@]} ${!our_runcounts[@]} | sort -u); do
+      STUB_RUNCOUNTS[$i]=$((STUB_RUNCOUNTS[i] + our_runcounts[i] - initial_runcounts[i]))
+    done
+    
+    write_runfile
+  )
+}
 
+array_copy() {
+  #`declare -p' is supposed to produce "declare -a src=([index]="value" <etc>)"
+  local data="$(declare -p ${1:?})"
+  local dest="${2:?}"
+  # Bash 5 dumps empty arrays as "declare -a arr"
+  if [[ $data != *=* ]]; then
+    data="()";
+  else
+    data="${data#*=}"
+  fi
+  
+  # Bash 3 and MacPorts version of Bash 5 dump arrays in single quotes "declare -a arr='()'"
+  #  but arr='(<value>)' createss "([0]='<value>')" rather than duplicate the array
+  if [[ ${data:0:1} == "'" && ${data:${#data}-1:1} == "'" ]]; then
+    data="${data:1:${#data}-2}"
+  fi
+  eval "$dest=$data"
+}
 
-# Loop over each line in the plan.
+STUB_INDEX=1
-index=0
+STUB_RESULT=0
-while IFS= read -r line; do
+declare -a STUB_RUNCOUNTS
-  index=$(($index + 1))
+read_runfile
-
+declare -a initial_runcounts
-  if [ -z "${!_STUB_END}" ] && [ $index -eq "${!_STUB_INDEX}" ]; then
+array_copy STUB_RUNCOUNTS initial_runcounts
-    # We found the plan line we're interested in.
-    # Start off by assuming success.
-    result=0
 
+# ${PROGRAM}_STUB_END envvar is set externally to trigger verification mode for `unstub'
+# Execution mode
+if [[ -z $STUB_END ]]; then
+  
+  # Loop over each line in the plan.
+  regular_command_index=0
+  no_order_command_index=0
+  match_result=1
+  while IFS= read -r line; do
+    line_flags="${line%% *}"
+    line="${line#${line_flags} }"
+    line_flag_no_order="$(if [[ $line_flags == N ]]; then echo 1; fi)"
+    line_flag_multiple="$(if [[ $line_flags == M ]]; then echo 1; fi)"
+    line_flag_regular="$(if [[ $line_flags == - ]]; then echo 1; fi)"
+    unset line_flags
+    
+    # Go through the plan until a match is found.
+    # For regular commands, only check the next command by index.
+    # Also keep track of no-order commands for the purpose of run count tracking
+    if [[ -n $line_flag_regular ]]; then
+      regular_command_index=$(($regular_command_index + 1))
+      if [[ $regular_command_index -ne $STUB_INDEX ]]; then
+        continue;
+      fi
+    else
+      no_order_command_index=$(($no_order_command_index + 1))
+    fi
+    
     # Split the line into an array of arguments to
     # match and a command to run to produce output.
     command=" $line"
-    if [ "$command" != "${command/ : }" ]; then
+    if [[ $command == *" : "* ]]; then
       patterns="${command%% : *}"
       command="${command#* : }"
     fi
@@ -54,67 +173,110 @@ while IFS= read -r line; do
 
     # Match the expected argument patterns to actual
     # arguments.
+    match_result=0
     for (( i=0; i<${#patterns[@]}; i++ )); do
       pattern="${patterns[$i]}"
       argument="${arguments[$i]}"
 
       case "$argument" in
         $pattern ) ;;
-        * ) result=1 ;;
+        * ) match_result=1 ;;
       esac
     done
 
     # If the arguments matched, evaluate the command
     # in a subshell. Otherwise, log the failure.
-    if [ $result -eq 0 ] ; then
+    if [ $match_result -eq 0 ] ; then
-      set +e
+
-      ( eval "$command" )
+      # If this is a regular command, push the regular command index for the next stub invocation
-      status="$?"
+      if [[ -n $line_flag_regular ]]; then
-      set -e
+        update_runfile_index
-    else
+      else
-      eval "${_STUB_RESULT}"=1
+        STUB_RUNCOUNTS[$no_order_command_index]=$((STUB_RUNCOUNTS[no_order_command_index]+1))
+      fi
+      
+      # Release the lock while running the payload to allow another `stub'
+      # of the same program to run concurrently (e.g. in a pipeline).
+      release_lock
+      
+      ( eval "$command" ) && status="$?" || status="$?"
+
+      break
     fi
-  fi
+    
-done < "${!_STUB_PLAN}"
+  done < "$STUB_PLAN"
 
-
+  #If we never matched anything, we failed.
-if [ -n "${!_STUB_END}" ]; then
+  if [[ $match_result -eq 1 ]]; then
-  # If the number of lines in the plan is larger than
+    STUB_RESULT=1
-  # the requested index, we failed.
+    
-  if [ $index -ge "${!_STUB_INDEX}" ]; then
+    #This also means that we never released the lock
-    eval "${_STUB_RESULT}"=1
+    # before running the payload
+  else 
+    acquire_lock
   fi
-  if [ "${!_STUB_RESULT}" -ne 0 ]; then
+  # Write out the match_result information.
+  update_runfile_result
+  release_lock
+ 
+  exit "$status"
+
+fi
+
+# Verification mode (`unstub')
+if [[ -n $STUB_END ]]; then
+
+  # `unstub' is supposed to run after any stubs are finished
+  release_lock
+
+  # If the number of regular commands in the plan is larger than
+  # the final regular_command_index, we failed.
+  if [[ $(grep -Ee '^-' "$STUB_PLAN" | wc -l ) -ge $STUB_INDEX ]]; then
+    STUB_RESULT=1
+  fi
+  
+  # If no-order commands weren't executed exactly once
+  # and multiple-times commands at least once, we failed.
+  no_order_command_index=0
+  while IFS= read -r line; do
+    line_flags="${line%% *}"
+    line="${line#${line_flags} }"
+    line_flag_no_order="$(if [[ $line_flags == N ]]; then echo 1; fi)"
+    line_flag_multiple="$(if [[ $line_flags == M ]]; then echo 1; fi)"
+    line_flag_regular="$(if [[ $line_flags == - ]]; then echo 1; fi)"
+    unset line_flags
+
+    if [[ -z $line_flag_regular ]]; then
+      continue
+    fi
+    
+    no_order_command_index=$((no_order_command_index + 1))
+    
+    if [[ ( -n $line_flag_no_order && \
+          (( STUB_RUNCOUNTS[no_order_command_index] != 1 )) ) \
+        || \
+        ( -n $line_flag_multiple && \
+        (( STUB_RUNCOUNTS[no_order_command_index] < 1 )) ) ]]
+    then
+      STUB_RESULT=1
+    fi
+    
+  done < "$STUB_PLAN"
+  
+  if [[ $STUB_RESULT -ne 0 ]]; then
     {
-      echo "index: $index; stub index: ${!_STUB_INDEX}"
       echo "plan:"
-      cat "${!_STUB_PLAN}" || true
+      cat "$STUB_PLAN" || true
-      echo "run:"
-      cat "${!_STUB_RUN}" || true
       echo "log:"
-      cat "${!_STUB_LOG}" || true
+      cat "$STUB_LOG" || true
     } >&2
   fi
 
   # Clean up the run file.
-  rm -f "${!_STUB_RUN}"
+  rm -f "$STUB_RUN"
-  rm -f "${!_STUB_LOG}"
+  rm -f "$STUB_LOG"
 
-  # Return the result.
+  # Return the run result.
-  exit "${!_STUB_RESULT}"
+  exit "$STUB_RESULT"
-
-else
-  # If the requested index is larger than the number
-  # of lines in the plan file, we failed.
-  if [ "${!_STUB_INDEX}" -gt $index ]; then
-    eval "${_STUB_RESULT}"=1
-  fi
-
-  # Write out the run information.
-  { echo "${_STUB_INDEX}=$((${!_STUB_INDEX} + 1))"
-    echo "${_STUB_RESULT}=${!_STUB_RESULT}"
-  } > "${!_STUB_RUN}"
-
-  exit "$status"
 
 fi

test/test_helper.bash

@@ -1,6 +1,15 @@
 export TMP="$BATS_TEST_DIRNAME/tmp"
 
-PATH=/usr/bin:/usr/sbin:/bin/:/sbin
+# Detect stat format for mtime: GNU uses -c %Y, BSD uses -f %m
+# Must match the detection in bin/pyenv-virtualenv-init
+if stat -L -c %Y / >/dev/null 2>&1; then
+  _stat_fmt="-L -c %Y"
+else
+  _stat_fmt="-L -f %m"
+fi
+export PS4='+(${BASH_SOURCE}:${LINENO}): ${FUNCNAME[0]:+${FUNCNAME[0]}(): }'
+
+PATH=/usr/bin:/usr/sbin:/bin:/sbin
 PATH="$BATS_TEST_DIRNAME/../bin:$PATH"
 PATH="$TMP/bin:$PATH"
 export PATH
@@ -10,6 +19,35 @@ teardown() {
 }
 
 stub() {
+  local FLAG_NO_ORDER=
+  local FLAG_MULTIPLE=
+  while (($#)); do
+    case "$1" in
+      -N|--no-order)
+        FLAG_NO_ORDER=1
+        shift
+        ;;
+      -M|--multiple)
+        FLAG_MULTIPLE=1
+        shift
+        ;;
+      -*)
+        echo "stub: unrecognized switch: $arg" >$2
+        return 1
+        ;;
+      *)
+        break
+        ;;
+    esac
+  done
+  
+  local FLAGS=-
+  if [[ -n $FLAG_MULTIPLE ]]; then
+    FLAGS=M
+  elif [[ -n $FLAG_NO_ORDER ]]; then
+    FLAGS=N
+  fi
+  
   local program="$1"
   local prefix="$(echo "$program" | tr a-z- A-Z_)"
   shift
@@ -23,7 +61,9 @@ stub() {
   ln -sf "${BATS_TEST_DIRNAME}/stubs/stub" "${TMP}/bin/${program}"
 
   touch "${TMP}/${program}-stub-plan"
-  for arg in "$@"; do printf "%s\n" "$arg" >> "${TMP}/${program}-stub-plan"; done
+  for arg in "$@"; do
+    echo "$FLAGS" "$arg" >> "${TMP}/${program}-stub-plan"
+  done
 }
 
 unstub() {

test/virtualenvs.bats

@@ -2,27 +2,79 @@
 
 load test_helper
 
-setup() {
+create_m_system_venv() {
-  export PYENV_ROOT="${TMP}/pyenv"
+  # Create a mock virtual environment in the same way a venv created from
-  mkdir -p "${PYENV_ROOT}/versions/2.7.6"
+  # the system Python version looks.
-  mkdir -p "${PYENV_ROOT}/versions/3.3.3"
+  #
-  mkdir -p "${PYENV_ROOT}/versions/venv27"
+  # The venv is in ${PYENV_ROOT}/versions, is not a symlink, and
-  mkdir -p "${PYENV_ROOT}/versions/venv33"
+  # home is /usr/bin in the pyenv.cfg.
+  create_executable "$2" "python"
+  create_executable "$2" "activate"
+
+  local version="$1"
+  local venv="$2"
+  local venv_dir="${PYENV_ROOT}/versions/${venv}"
+
+  echo "home = /usr/bin" > "${venv_dir}/pyvenv.cfg"
 }
 
-@test "list virtual environments only" {
+
-  stub pyenv-version-name ": echo system"
+create_m_venv() {
-  stub pyenv-virtualenv-prefix "2.7.6 : false"
+  # Create a mock virtual environment from an installed (not system) Python version.
-  stub pyenv-virtualenv-prefix "3.3.3 : false"
+  #
-  stub pyenv-virtualenv-prefix "venv27 : echo \"${PYENV_ROOT}/versions/2.7.6\""
+  # The venv name is a symlink inside ${PYENV_ROOT}/versions that points to
-  stub pyenv-virtualenv-prefix "venv33 : echo \"${PYENV_ROOT}/versions/3.3.3\""
+  # the real venv directory inside the Python version used to created and
+  # home points to the bin directory inside the venv dir.
+  setup_m_venv "$1/envs/$2"
+
+  local version="$1"
+  local venv="$2"
+  local venv_dir="${PYENV_ROOT}/versions/${version}/envs/${venv}"
+
+  echo "home = ${PYENV_ROOT}/versions/${version}/bin" > "${venv_dir}/pyvenv.cfg"
+  ln -sf "${venv_dir}" "${PYENV_ROOT}/versions/${venv}"
+}
+
+setup() {
+  export PYENV_ROOT="${TMP}/pyenv"
+}
+
+@test "system venv" {
+  stub pyenv-version-name ": echo venv314"
+  stub pyenv-version-origin ": echo PYENV_VERSION"
+
+  create_m_venv "3.14.3" "venv314"
+  create_m_system_venv "3.9.11" "system_venv"
 
   run pyenv-virtualenvs
 
   assert_success
   assert_output <<OUT
-  venv27 (created from ${PYENV_ROOT}/versions/2.7.6)
+  3.14.3/envs/venv314 (created from ${PYENV_ROOT}/versions/3.14.3)
-  venv33 (created from ${PYENV_ROOT}/versions/3.3.3)
+  system_venv (created from /usr)
+* venv314 --> ${PYENV_ROOT}/versions/3.14.3/envs/venv314 (set by PYENV_VERSION)
+OUT
+
+  unstub pyenv-version-name
+  unstub pyenv-version-origin
+}
+
+@test "list virtual environments" {
+  stub pyenv-version-name ": echo system"
+  stub pyenv-virtualenv-prefix "2.7.6/envs/venv27 : echo \"${PYENV_ROOT}/versions/2.7.6\""
+  stub pyenv-virtualenv-prefix "3.3.3/envs/venv33 : echo \"${PYENV_ROOT}/versions/3.3.3\""
+
+  create_m_venv "2.7.6" "venv27"
+  create_m_venv "3.3.3" "venv33"
+
+  run pyenv-virtualenvs
+
+  assert_success
+  assert_output <<OUT
+  2.7.6/envs/venv27 (created from ${PYENV_ROOT}/versions/2.7.6)
+  3.3.3/envs/venv33 (created from ${PYENV_ROOT}/versions/3.3.3)
+  venv27 --> ${PYENV_ROOT}/versions/2.7.6/envs/venv27
+  venv33 --> ${PYENV_ROOT}/versions/3.3.3/envs/venv33
 OUT
 
   unstub pyenv-version-name
@@ -30,37 +82,101 @@ OUT
 }
 
 @test "list virtual environments with hit prefix" {
-  stub pyenv-version-name ": echo venv33"
+  stub pyenv-version-name ": echo 3.3.3/envs/venv33"
-  stub pyenv-virtualenv-prefix "2.7.6 : false"
+  stub pyenv-version-origin ": echo PYENV_VERSION"
-  stub pyenv-virtualenv-prefix "3.3.3 : false"
+
-  stub pyenv-virtualenv-prefix "venv27 : echo \"/usr\""
+  create_m_venv "2.7.6" "venv27"
-  stub pyenv-virtualenv-prefix "venv33 : echo \"/usr\""
+  create_m_venv "3.3.3" "venv33"
 
   run pyenv-virtualenvs
 
   assert_success
   assert_output <<OUT
-  venv27 (created from /usr)
+  2.7.6/envs/venv27 (created from ${PYENV_ROOT}/versions/2.7.6)
-* venv33 (created from /usr)
+* 3.3.3/envs/venv33 (created from ${PYENV_ROOT}/versions/3.3.3) (set by PYENV_VERSION)
+  venv27 --> ${PYENV_ROOT}/versions/2.7.6/envs/venv27
+  venv33 --> ${PYENV_ROOT}/versions/3.3.3/envs/venv33
 OUT
 
   unstub pyenv-version-name
-  unstub pyenv-virtualenv-prefix
+  unstub pyenv-version-origin
 }
 
-@test "list virtual environments with --bare" {
+@test "list bare virtual environments" {
-  stub pyenv-virtualenv-prefix "2.7.6 : false"
+  create_m_venv "2.7.6" "venv27"
-  stub pyenv-virtualenv-prefix "3.3.3 : false"
+  create_m_venv "3.3.3" "venv33"
-  stub pyenv-virtualenv-prefix "venv27 : echo \"/usr\""
-  stub pyenv-virtualenv-prefix "venv33 : echo \"/usr\""
 
   run pyenv-virtualenvs --bare
 
   assert_success
   assert_output <<OUT
+2.7.6/envs/venv27
+3.3.3/envs/venv33
 venv27
 venv33
 OUT
-
+}
-  unstub pyenv-virtualenv-prefix
+
+@test "list bare virtual environments without aliases" {
+  create_m_venv "2.7.6" "venv27"
+  create_m_venv "3.3.3" "venv33"
+
+  run pyenv-virtualenvs --bare --skip-aliases
+
+  assert_success
+  assert_output <<OUT
+2.7.6/envs/venv27
+3.3.3/envs/venv33
+OUT
+}
+
+@test "list virtual environments without aliases" {
+  stub pyenv-version-name ": echo system"
+
+  create_m_venv "2.7.6" "venv27"
+  create_m_venv "3.3.3" "venv33"
+
+  run pyenv-virtualenvs --skip-aliases
+
+  assert_success
+  assert_output <<OUT
+  2.7.6/envs/venv27 (created from ${PYENV_ROOT}/versions/2.7.6)
+  3.3.3/envs/venv33 (created from ${PYENV_ROOT}/versions/3.3.3)
+OUT
+
+  unstub pyenv-version-name
+}
+
+@test "hit prefix matches alias version name" {
+  stub pyenv-version-name ": echo venv27"
+  stub pyenv-version-origin ": echo PYENV_VERSION"
+
+  create_m_venv "2.7.6" "venv27"
+  create_m_venv "3.3.3" "venv33"
+
+  run pyenv-virtualenvs
+
+  assert_success
+  assert_output <<OUT
+  2.7.6/envs/venv27 (created from ${PYENV_ROOT}/versions/2.7.6)
+  3.3.3/envs/venv33 (created from ${PYENV_ROOT}/versions/3.3.3)
+* venv27 --> ${PYENV_ROOT}/versions/2.7.6/envs/venv27 (set by PYENV_VERSION)
+  venv33 --> ${PYENV_ROOT}/versions/3.3.3/envs/venv33
+OUT
+
+  unstub pyenv-version-name
+  unstub pyenv-version-origin
+}
+
+@test "completions output" {
+  create_m_venv "2.7.6" "venv27"
+  create_m_venv "3.3.3" "venv33"
+
+  run pyenv-virtualenvs --complete
+
+  assert_success
+  assert_output <<OUT
+--bare
+--skip-aliases
+OUT
 }