Add wipeenv command

Add the wipeenv command.

Signed-off-by: Doug Hellmann <doug.hellmann@gmail.com>

Author: dhellmann

docs/source/command_ref.rst

@@ -547,3 +547,18 @@ Syntax::
 
   cdproject
 
+===========================
+Managing Installed Packages
+===========================
+
+.. _command-wipeenv:
+
+wipeenv
+-------
+
+Remove all of the installed third-party packages in the current
+virtualenv.
+
+Syntax::
+
+  wipeenv

docs/source/history.rst

@@ -7,6 +7,8 @@ dev
 
 - Ensure that all $() style commands that produce paths are
   quoted. Addresses :bbissue:`164`.
+- Add :ref:`command-wipeenv` command for removing all packages
+  installed in the virtualenv.
 
 4.0
 ===

tests/test_wipeenv.sh

@@ -0,0 +1,48 @@
+# -*- mode: shell-script -*-
+
+test_dir=$(cd $(dirname $0) && pwd)
+source "$test_dir/setup.sh"
+
+setUp () {
+    rm -rf "$WORKON_HOME"
+    mkdir -p "$WORKON_HOME"
+    source "$test_dir/../virtualenvwrapper.sh"
+    rm -f "$test_dir/catch_output"
+    echo
+}
+
+tearDown() {
+    if type deactivate >/dev/null 2>&1
+    then 
+        deactivate
+    fi
+    rm -rf "$WORKON_HOME"
+}
+
+test_wipeenv () {
+    mkvirtualenv "wipetest" >/dev/null 2>&1
+    (cd tests/testpackage && python setup.py install) >/dev/null 2>&1
+    before="$(pip freeze)"
+    assertTrue "testpackage not installed" "pip freeze | grep testpackage"
+    wipeenv >/dev/null 2>&1
+    after="$(pip freeze)"
+    assertFalse "testpackage still installed" "pip freeze | grep testpackage"
+}
+
+test_empty_env () {
+    mkvirtualenv "wipetest" >/dev/null 2>&1
+    before="$(pip freeze)"
+    assertFalse "testpackage still installed" "pip freeze | grep testpackage"
+    wipeenv >/dev/null 2>&1
+    after="$(pip freeze)"
+    assertFalse "testpackage still installed" "pip freeze | grep testpackage"
+}
+
+test_not_active_env () {
+    mkvirtualenv "wipetest" >/dev/null 2>&1
+    deactivate
+    assertFalse "wipenv did not report an error" "wipeenv >/dev/null 2>&1"
+}
+
+. "$test_dir/shunit2"
+

virtualenvwrapper.sh

@@ -1131,6 +1131,26 @@ fi
 EOF
 }
 
+#
+# Remove all installed packages from the env
+#
+function wipeenv {
+    virtualenvwrapper_verify_workon_home || return 1
+    virtualenvwrapper_verify_active_environment || return 1
+
+    typeset req_file="$(virtualenvwrapper_tempfile "requirements.txt")"
+    pip freeze | egrep -v '(distribute|wsgiref)' > "$req_file"
+    if [ -n "$(cat "$req_file")" ]
+    then
+        echo "Uninstalling packages:"
+        cat "$req_file"
+        echo
+        pip uninstall -y $(cat "$req_file" | sed 's/>/=/g' | cut -f1 -d=)
+    else
+        echo "Nothing to remove."
+    fi
+    rm -f "$req_file"
+}
 
 #
 # Invoke the initialization functions