Adds 'shell' command.

Makefile.setup.inc

@@ -16,5 +16,6 @@ help.lua util.lua index.lua cache.lua refresh_cache.lua loader.lua \
 admin_remove.lua fetch/hg.lua fetch/git_file.lua new_version.lua lint.lua \
 purge.lua path.lua path_cmd.lua write_rockspec.lua doc.lua upload.lua \
 upload/api.lua upload/multipart.lua fetch/git_http.lua fetch/hg_http.lua \
-fetch/hg_https.lua fetch/hg_ssh.lua fetch/git_https.lua fetch/git_ssh.lua
+fetch/hg_https.lua fetch/hg_ssh.lua fetch/git_https.lua fetch/git_ssh.lua \
+shell.lua
 

src/bin/luarocks

@@ -28,6 +28,7 @@ commands = {
    doc = "luarocks.doc",
    upload = "luarocks.upload",
    config = "luarocks.config_cmd",
+   shell = "luarocks.shell"
 }
 
 command_line.run_command(...)

src/luarocks/shell.lua

@@ -0,0 +1,41 @@
+
+--- @module luarocks.shell
+-- Driver for the `luarocks shell` command.
+local shell_cmd = {}
+
+local util = require("luarocks.util")
+local cfg = require("luarocks.cfg")
+local fs = require("luarocks.fs")
+
+shell_cmd.help_summary = "Starts a new shell with the variables from `luarocks path` correctly set."
+shell_cmd.help_arguments = ""
+shell_cmd.help = [[
+Starts a new shell with the variables LUA_PATH and LUA_CPATH set as 
+configured by the LuaRocks installation.
+]]
+
+--- Driver function for "shell" command.
+-- @return boolean This function always succeeds.
+function shell_cmd.run(...)
+   local lr_path, lr_cpath, lr_bin = cfg.package_paths()
+   local path_sep = cfg.export_path_separator
+
+   lr_path =  lr_path.. ";" .. package.path
+   lr_cpath = lr_cpath .. ";" .. package.cpath
+   lr_bin = lr_bin .. path_sep .. os.getenv("PATH")
+
+   lr_path = cfg.export_lua_path:format(util.remove_path_dupes(lr_path, ';'))
+   lr_cpath = cfg.export_lua_cpath:format(util.remove_path_dupes(lr_cpath, ';'))
+   lr_bin = cfg.export_path:format(util.remove_path_dupes(lr_bin, path_sep))
+
+   local shell, cmd = os.getenv("SHELL")
+   if shell then
+      cmd = ([[LUA_PATH="%s" LUA_CPATH="%s" PATH="%s" %s"]]):format(lr_path, lr_cpath, lr_bin, shell)
+   else
+      cmd = ([[cmd /k "%s && %s && %s"]]):format(lr_path, lr_cpath, lr_bin)
+   end
+   fs.execute(cmd)
+   return true
+end
+
+return shell_cmd