0.10.0 release

README.rst

@@ -16,13 +16,13 @@ Basic usage
 
 .. code-block:: bash
 
-  hererocks lua53 -l5.3 -rlatest      # Install Lua 5.3 with latest LuaRocks into lua53 directory.
+  hererocks lua53 -l5.3 -rlatest      # Install Lua 5.3 with latest LuaRocks into 'lua53' directory.
-  lua53/bin/lua -v                    # Lua can now be run from lua53/bin directory.
+  source lua53/bin/activate           # Run activation script, adding 'lua53/bin' to $PATH.
-  lua53/bin/luarocks --version        # Same for LuaRocks.
+  lua -v                              # Lua, LuaRocks, and programs
-  lua53/bin/luarocks install luacheck # Libraries and programs installed with LuaRocks end up in
+  luarocks install luacheck           # installed using LuaRocks
-  lua53/bin/luacheck --version        # lua53 directory, too, with scripts in lua53/bin.
+  luacheck --version                  # can now be used.
-  export PATH="$PWD/lua53/bin:$PATH"  # Add it to PATH to run programs directly,
+  deactivate-lua                      # Remove 'lua53/bin' from $PATH.
-  lua -v                              # without lua53/bin prefix.
+  lua53/bin/lua -v                    # All the binaries can still be used directly.
 
 For more info see below or run ``hererocks --help`` for a complete listing of options.
 
@@ -42,7 +42,29 @@ Requirements
 
   * Windows: MinGW with tools such as ``gcc`` in PATH, or Visual Studio 2008 or later (see help message for ``--target``).
   * OS X: ``cc``.
-  * Other: ``gcc``.
+  * Other systems: ``gcc``.
+
+Activation scripts
+------------------
+
+``hererocks`` writes several activation scripts into ``bin`` subdirectory of the installation directory.
+When sourced (on Windows: simply executed) they add path to that subdirectory to ``PATH`` environment variable.
+This allows one to use ``lua``, ``luarocks`` and other programs installed in the created environment directly.
+Additionally, activation scripts make ``deactivate-lua`` command available. It removes path to currently activated
+environment from ``PATH``. Activating an environment deactivates the previous one automatically, if it exists.
+
+Several versions of activation scripts are installed to support various shells:
+
+* Windows:
+
+  * Batch: ``activate.bat``.
+  * PowerShell: ``activate.ps1``.
+
+* Other systems:
+
+  * Bash, Zsh, Dash: ``activate``.
+  * Fish: ``activate.fish``.
+  * Tcsh, csh: ``activate.csh``.
 
 Command-line options
 --------------------
@@ -112,7 +134,7 @@ Popular continuous integration services such as `Travis-CI <https://travis-ci.or
   before_install:
     - pip install hererocks
     - hererocks env --$LUA -rlatest    # Use latest LuaRocks, install into 'env' directory.
-    - export PATH="$PWD/env/bin:$PATH" # Add directory with all installed binaries to PATH.
+    - source env/bin/activate          # Add directory with all installed binaries to PATH.
     - luarocks install busted
 
   install:
@@ -135,9 +157,10 @@ Equivalent configuration (``appveyor.yml``) for `Appveyor <http://www.appveyor.c
     - LUA: "luajit 2.1"
 
   before_build:
-    - set PATH=%CD%\env\bin;C:\Python27\Scripts;%PATH% # Add directory containing 'pip'
+    - set PATH=C:\Python27\Scripts;%PATH% # Add directory containing 'pip' to PATH
-    - pip install hererocks                            # to PATH, too.
+    - pip install hererocks
     - hererocks env --%LUA% -rlatest
+    - call env\bin\activate
     - luarocks install busted
 
   build_script:

hererocks.py

@@ -31,7 +31,7 @@ if os.name == "nt":
     except ImportError:
         import winreg
 
-hererocks_version = "Hererocks 0.9.0"
+hererocks_version = "Hererocks 0.10.0"
 __all__ = ["main"]
 
 opts = None
@@ -1700,7 +1700,7 @@ def main(argv=None):
         formatter_class=argparse.ArgumentDefaultsHelpFormatter, add_help=False)
     parser.add_argument(
         "location", help="Path to directory in which Lua and/or LuaRocks will be installed. "
-        "Their binaries will be found in its 'bin' subdirectory. "
+        "Their binaries and activation scripts will be found in its 'bin' subdirectory. "
         "Scripts from modules installed using LuaRocks will also turn up there. "
         "If an incompatible version of Lua is already installed there it should be "
         "removed before installing the new one.")

setup.py

@@ -9,7 +9,7 @@ readme.close()
 
 setuptools.setup(
     name="hererocks",
-    version="0.9.0",
+    version="0.10.0",
     description="Tool for installing Lua and LuaRocks locally",
     long_description=long_description,
     keywords="lua",
@@ -28,7 +28,8 @@ setuptools.setup(
         "Programming Language :: Python :: 3.2",
         "Programming Language :: Python :: 3.3",
         "Programming Language :: Python :: 3.4",
-        "Programming Language :: Python :: 3.5"
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6"
     ],
     py_modules=["hererocks"],
     entry_points={