fix: add back inspect

the cdr command will change to <index> directory from a list of 10
most recently moved to directories. this only works for the interactive
cd command, and not the fs.cd function.
you can find the list of recent directories with `cdr list`.
usage: `cdr <index>`
the `cdr help` command also gives this bit of info

.gitmodules

@@ -1,3 +1,9 @@
 [submodule "libs/lunacolors"]
 	path = libs/lunacolors
 	url = https://github.com/Hilbis/Lunacolors
+[submodule "libs/succulent"]
+	path = libs/succulent
+	url = https://github.com/Rosettea/Succulent
+[submodule "libs/inspect"]
+	path = libs/inspect
+	url = https://github.com/kikito/inspect.lua

cmd/docgen/docgen.go

@@ -43,6 +43,7 @@ func main() {
 		"fs": "f",
 		"commander": "c",
 		"bait": "b",
+		"terminal": "term",
 	}
 	docs := make(map[string][]string)
 

docs/terminal.txt

@@ -0,0 +1,9 @@
+setRaw() > Puts the terminal in raw mode
+
+restoreState() > Restores the last saved state of the terminal
+
+saveState() > Saves the current state of the terminal
+
+size() > Gets the dimensions of the terminal. Returns a table with `width` and `height`
+Note: this is not the size in relation to the dimensions of the display
+

golibs/fs/fs.go

@@ -9,7 +9,6 @@ import (
 
 	"hilbish/util"
 	"github.com/yuin/gopher-lua"
-	"layeh.com/gopher-luar"
 )
 
 func Loader(L *lua.LState) int {
@@ -23,10 +22,6 @@ addition to the Lua standard library's I/O and fs functions.`)
 	return 1
 }
 
-func luaErr(L *lua.LState, msg string) {
-	L.Error(lua.LString(msg), 2)
-}
-
 var exports = map[string]lua.LGFunction{
 	"cd": fcd,
 	"mkdir": fmkdir,
@@ -42,7 +37,7 @@ func fcd(L *lua.LState) int {
 	err := os.Chdir(strings.TrimSpace(path))
 	if err != nil {
 		e := err.(*os.PathError).Err.Error()
-		luaErr(L, e)
+		L.RaiseError(e)
 	}
 
 	return 0
@@ -62,7 +57,7 @@ func fmkdir(L *lua.LState) int {
 		err = os.Mkdir(path, 0744)
 	}
 	if err != nil {
-		luaErr(L, err.Error())
+		L.RaiseError(err.Error())
 	}
 
 	return 0
@@ -75,7 +70,7 @@ func fstat(L *lua.LState) int {
 
 	pathinfo, err := os.Stat(path)
 	if err != nil {
-		luaErr(L, err.Error())
+		L.RaiseError(err.Error())
 		return 0
 	}
 	statTbl := L.NewTable()
@@ -92,18 +87,18 @@ func fstat(L *lua.LState) int {
 // Returns a table of files in `dir`
 func freaddir(L *lua.LState) int {
 	dir := L.CheckString(1)
-	names := []string{}
+	names := L.NewTable()
 
 	dirEntries, err := os.ReadDir(dir)
 	if err != nil {
-		luaErr(L, err.Error())
+		L.RaiseError(err.Error())
 		return 0
 	}
 	for _, entry := range dirEntries {
-		names = append(names, entry.Name())
+		names.Append(lua.LString(entry.Name()))
 	}
 
-	L.Push(luar.New(L, names))
+	L.Push(names)
 
 	return 1
 }

golibs/terminal/terminal.go

@@ -0,0 +1,80 @@
+package terminal
+
+import (
+	"os"
+
+	"hilbish/util"
+
+	"golang.org/x/term"
+	"github.com/yuin/gopher-lua"
+)
+
+var termState *term.State
+
+func Loader(L *lua.LState) int {
+	mod := L.SetFuncs(L.NewTable(), exports)
+	util.Document(L, mod, "The terminal library is a simple and lower level library for certain terminal interactions.")
+
+	L.Push(mod)
+
+	return 1
+}
+
+var exports = map[string]lua.LGFunction{
+	"setRaw": termraw,
+	"restoreState": termrestoreState,
+	"size": termsize,
+	"saveState": termsaveState,
+}
+
+// size()
+// Gets the dimensions of the terminal. Returns a table with `width` and `height`
+// Note: this is not the size in relation to the dimensions of the display
+func termsize(L *lua.LState) int {
+	w, h, err := term.GetSize(int(os.Stdin.Fd()))
+	if err != nil {
+		L.RaiseError(err.Error())
+		return 0
+	}
+	dimensions := L.NewTable()
+	L.SetField(dimensions, "width", lua.LNumber(w))
+	L.SetField(dimensions, "height", lua.LNumber(h))
+
+	L.Push(dimensions)
+	return 1
+}
+
+// saveState()
+// Saves the current state of the terminal
+func termsaveState(L *lua.LState) int {
+	state, err := term.GetState(int(os.Stdin.Fd()))
+	if err != nil {
+		L.RaiseError(err.Error())
+		return 0
+	}
+
+	termState = state
+	return 0
+}
+
+// restoreState()
+// Restores the last saved state of the terminal
+func termrestoreState(L *lua.LState) int {
+	err := term.Restore(int(os.Stdin.Fd()), termState)
+	if err != nil {
+		L.RaiseError(err.Error())
+	}
+
+	return 0
+}
+
+// setRaw()
+// Puts the terminal in raw mode
+func termraw(L *lua.LState) int {
+	_, err := term.MakeRaw(int(os.Stdin.Fd()))
+	if err != nil {
+		L.RaiseError(err.Error())
+	}
+
+	return 0
+}

hilbish.go

@@ -35,6 +35,7 @@ func HilbishLoader(L *lua.LState) int {
 	L.SetField(mod, "user", lua.LString(username))
 	L.SetField(mod, "host", lua.LString(host))
 	L.SetField(mod, "home", lua.LString(homedir))
+	L.SetField(mod, "dataDir", lua.LString(dataDir))
 
 	xdg := L.NewTable()
 	L.SetField(xdg, "config", lua.LString(confDir))

libs/ansikit/init.lua

@@ -1,7 +1,7 @@
 -- We're basically porting Ansikit to lua
 -- https://github.com/Luvella/AnsiKit/blob/master/lib/index.js
 -- which is made by yours truly sammy :^)
-
+local lunacolors = require 'lunacolors'
 local ansikit = {}
 
 ansikit.clear = function(scrollback)
@@ -77,6 +77,12 @@ ansikit.hideCursor = function()
 	return ansikit.printCSI('?25', 'l')
 end
 
+ansikit.link = function(url, text)
+	if not url then error 'ansikit: missing url for hyperlink' end
+	local text = (text and text or 'link')
+	io.write(lunacolors.blue('\27]8;;' .. url .. '\27\\' .. text .. '\27]8;;\27\\\n'))
+end
+
 ansikit.print = function(text)
 	io.write(ansikit.format(text))
 	return ansikit

libs/succulent

@@ -0,0 +1 @@
+Subproject commit 96dc95c24989be6596ccb9f7f7244d37f03d4acd

lua.go

@@ -11,6 +11,7 @@ import (
 	"hilbish/golibs/bait"
 	"hilbish/golibs/commander"
 	"hilbish/golibs/fs"
+	"hilbish/golibs/terminal"
 
 	"github.com/yuin/gopher-lua"
 	"layeh.com/gopher-luar"
@@ -40,8 +41,9 @@ func LuaInit() {
 	l.PreloadModule("hilbish", HilbishLoader)
 	l.DoString("hilbish = require 'hilbish'")
 
-	// Add fs module to Lua
+	// Add fs and terminal module module to Lua
 	l.PreloadModule("fs", fs.Loader)
+	l.PreloadModule("terminal", terminal.Loader)
 
 	cmds := commander.New()
 	// When a command from Lua is added, register it for use

main.go

@@ -175,7 +175,6 @@ input:
 
 		if err == io.EOF {
 			// Exit if user presses ^D (ctrl + d)
-			fmt.Println("")
 			break
 		}
 		if err != nil {

preload.lua

@@ -3,19 +3,17 @@
 local fs = require 'fs'
 local commander = require 'commander'
 local bait = require 'bait'
+require 'succulent' -- Function additions
 local oldDir = hilbish.cwd()
 
 local shlvl = tonumber(os.getenv 'SHLVL')
 if shlvl ~= nil then os.setenv('SHLVL', shlvl + 1) else os.setenv('SHLVL', 1) end
 
 -- Builtins
+local recentDirs = {}
 commander.register('cd', function (args)
 	if #args > 0 then
-		local path = ''
+		local path = table.concat(args, ' '):gsub('$%$','\0'):gsub('${([%w_]+)}', os.getenv)
-		for i = 1, #args do
-			path = path .. tostring(args[i]) .. ' '
-		end
-		path = path:gsub('$%$','\0'):gsub('${([%w_]+)}', os.getenv)
 		:gsub('$([%w_]+)', os.getenv):gsub('%z','$'):gsub('^%s*(.-)%s*$', '%1')
 
         if path == '-' then
@@ -26,12 +24,15 @@ commander.register('cd', function (args)
 
 		local ok, err = pcall(function() fs.cd(path) end)
 		if not ok then
-			if err == 1 then
+			print(err:sub(17))
-				print('directory does not exist')
+			return 1
-			end
-			return err
 		end
 		bait.throw('cd', path)
+
+		-- add to table of recent dirs
+		table.insert(recentDirs, 1, path)
+		recentDirs[11] = nil
+
 		return
 	end
 	fs.cd(hilbish.home)
@@ -49,11 +50,7 @@ commander.register('doc', function(args)
 	local globalDesc = [[
 These are the global Hilbish functions that are always available and not part of a module.]]
 	if #args > 0 then
-		local mod = ''
+		local mod = table.concat(args, ' '):gsub('^%s*(.-)%s*$', '%1')
-		for i = 1, #args do
-			mod = mod .. tostring(args[i]) .. ' '
-		end
-		mod = mod:gsub('^%s*(.-)%s*$', '%1')
 
 		local f = io.open(moddocPath .. mod .. '.txt', 'rb')
 		if not f then 
@@ -69,14 +66,16 @@ These are the global Hilbish functions that are always available and not part of
 			if backtickOccurence % 2 == 0 then
 				return '{reset}'
 			else
-				return '{invert}'
+				return '{underline}{green}'
 			end
 		end)))
 		f:close()
 
 		return
 	end
-	local modules = fs.readdir(moddocPath)
+	local modules = table.map(fs.readdir(moddocPath), function(f)
+		return lunacolors.underline(lunacolors.blue(f:sub(1, -5)))
+	end)
 
 	io.write [[
 Welcome to Hilbish's doc tool! Here you can find documentation for builtin
@@ -86,11 +85,7 @@ Usage: doc <module>
 
 Available modules: ]]
 
-	local mods = ''
+	print(table.concat(modules, ', '))
-	for i = 1, #modules do
-		mods = mods .. tostring(modules[i]):gsub('.txt', '') .. ', '
-	end
-	print(mods)
 
 	return
 end)
@@ -131,23 +126,40 @@ do
 	end)
 end
 
--- Function additions to Lua standard library
+commander.register('cdr', function(args)
-function string.split(str, delimiter)
+	if not args[1] then
-	local result = {}
+		print(lunacolors.format [[
-	local from = 1
+cdr: change directory to one which has been recently visied
 
-	local delim_from, delim_to = string.find(str, delimiter, from)
+usage: cdr <index>
 
-	while delim_from do
+to get a list of recent directories, use {green}{underline}cdr list{reset}]])
-		table.insert(result, string.sub(str, from, delim_from - 1))
+		return
-		from = delim_to + 1
-		delim_from, delim_to = string.find(str, delimiter, from)
 	end
 
-	table.insert(result, string.sub(str, from))
+	if args[1] == 'list' then
-
+		if #recentDirs == 0 then
-	return result
+			print 'No directories have been visited.'
+			return 1
 		end
+		print(table.concat(recentDirs, '\n'))
+		return
+	end
+
+	local index = tonumber(args[1])
+	if not index then
+		print(string.format('received %s as index, which isn\'t a number', index))
+		return 1
+	end
+
+	if not recentDirs[index] then
+		print(string.format('no recent directory found at index %s', index))
+		return 1
+	end
+
+	fs.cd(recentDirs[index])
+	return
+end)
 
 -- Hook handles
 bait.catch('command.not-found', function(cmd)

shell.go

@@ -55,11 +55,16 @@ func RunInput(input string) {
 		return
 	}
 	if commands[cmdArgs[0]] != nil {
+		luacmdArgs := l.NewTable()
+		for _, str := range cmdArgs[1:] {
+			luacmdArgs.Append(lua.LString(str))
+		}
+
 		err := l.CallByParam(lua.P{
 			Fn: commands[cmdArgs[0]],
 			NRet:    1,
 			Protect: true,
-		}, luar.New(l, cmdArgs[1:]))
+		}, luacmdArgs)
 		if err != nil {
 			fmt.Fprintln(os.Stderr,
 				"Error in command:\n\n" + err.Error())

vars.go

@@ -2,9 +2,10 @@ package main
 
 // String vars that are free to be changed at compile time
 var (
-	version = "v0.5.1"
+	version = "v0.6.0"
 	defaultConfDir = "" // ~ will be substituted for home, path for user's default config
 	defaultHistDir = ""
+	commonRequirePaths = "';./libs/?/init.lua;./?/init.lua;./?/?.lua'"
 
 	prompt string // Prompt will always get changed anyway
 	multilinePrompt = "> "

vars_linux.go

@@ -4,9 +4,10 @@ package main
 
 // String vars that are free to be changed at compile time
 var (
-	requirePaths = `';./libs/?/?.lua;./libs/?/init.lua;./?/init.lua;./?/?.lua'
+	requirePaths = commonRequirePaths + `
 	.. ';/usr/share/hilbish/libs/?/init.lua;'
-	.. ';/usr/share/hilbish/libs/?/?.lua;'
+	.. ';/usr/share/hilbish/libs/?/?.lua;'` + linuxUserPaths
+	linuxUserPaths = `
 	.. hilbish.xdg.data .. '/hilbish/libs/?/init.lua;'
 	.. hilbish.xdg.data	.. '/hilbish/libs/?/?.lua;'
 	.. hilbish.xdg.data	.. '/hilbish/libs/?.lua'

vars_windows.go

@@ -4,7 +4,7 @@ package main
 
 // String vars that are free to be changed at compile time
 var (
-	requirePaths = `';./libs/?/init.lua;./?/init.lua;./?/?.lua'
+	requirePaths = commonRequirePaths + `
 	.. hilbish.home .. '\\Appdata\\Roaming\\Hilbish\\libs\\?\\init.lua;'
 	.. hilbish.home .. '\\Appdata\\Roaming\\Hilbish\\libs\\?\\?.lua;'`
 	dataDir = "~\\Appdata\\Roaming\\Hilbish" // ~ and \ gonna cry?