From 3ea550e2b43ce440c2a062a83dd183aa7d818d69 Mon Sep 17 00:00:00 2001
From: Leon van Kammen <leonvankammen@gmail.com>
Date: Thu, 23 Jul 2026 21:34:09 +0200
Subject: [PATCH] added tests + tweaks

---
 README.md                              |   1 +
 src/.init.lua                          |   7 +-
 src/.lua/test                          |   1 +
 src/cmd/test.lua                       |   4 +
 src/test/lust.lua                      | 305 +++++++++++++++++++++++++
 src/test/main.lua                      |  28 +++
 src/{tests.html => test/soakbean.html} |   0
 util/xrforge.sh                        |   1 +
 8 files changed, 344 insertions(+), 3 deletions(-)
 create mode 120000 src/.lua/test
 create mode 100644 src/cmd/test.lua
 create mode 100644 src/test/lust.lua
 create mode 100644 src/test/main.lua
 rename src/{tests.html => test/soakbean.html} (100%)

diff --git a/README.md b/README.md
index 19848b7..1fe7f6c 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,7 @@ scan files
 
 ## Ideas
 
+* fuzzy search: https://github.com/ssimonp/FuzzySearch-Roblox
 * landingpage = /about
 * scan functions in xrforge.lua / .xrforge
 * video-hover: https://codepen.io/coderofsalvation/pen/YPNOyqx
diff --git a/src/.init.lua b/src/.init.lua
index fe476cd..eb7c431 100644
--- a/src/.init.lua
+++ b/src/.init.lua
@@ -4,8 +4,6 @@ package.path = package.path .. ";middleware/?.lua"
 package.path = package.path .. ";cmd/?.lua"
 package.path = package.path .. ";plugin/?.lua"
 
-print = function(...) Log(kLogInfo, ... or "''") end -- nice redbean logging from now on
-
 util = require "util"
 json = require "json"
 
@@ -24,7 +22,8 @@ app = require("soakbean") {
     help         = {file="cmd/help.lua", info="display all possible flags"},
     server       = {file="cmd/server.lua", info="starts the webserver"},
     createplugin = {file="cmd/createplugin.lua", info="generates skeleton plugin"},
-    generate     = {file="cmd/generate.lua", info="generate www-folder with XR experiences"}
+    generate     = {file="cmd/generate.lua", info="generate www-folder with XR experiences"},
+    test         = {file="cmd/test.lua", info="run testsuite (selftest)"}
   }
 }
 
@@ -59,6 +58,8 @@ app.plugin[4] = app.plugin.manyfold
 
 app.runcmd(app) -- run clicmds
 
+print = function(...) Log(kLogInfo, ... or "''") end -- nice redbean logging from now on
+
 -- init URL router
 app.url['^/data']   = '/data.lua'          -- setup custom file endpoint
 
diff --git a/src/.lua/test b/src/.lua/test
new file mode 120000
index 0000000..419df4f
--- /dev/null
+++ b/src/.lua/test
@@ -0,0 +1 @@
+../test
\ No newline at end of file
diff --git a/src/cmd/test.lua b/src/cmd/test.lua
new file mode 100644
index 0000000..49fa10f
--- /dev/null
+++ b/src/cmd/test.lua
@@ -0,0 +1,4 @@
+return function(app,argv)
+  require('test/main')
+  os.exit()
+end
diff --git a/src/test/lust.lua b/src/test/lust.lua
new file mode 100644
index 0000000..2bc19e6
--- /dev/null
+++ b/src/test/lust.lua
@@ -0,0 +1,305 @@
+-- lust v0.2.0 - Lua test framework
+-- https://github.com/bjornbytes/lust
+-- MIT LICENSE
+
+local lust = {}
+lust.level = 0
+lust.passes = 0
+lust.errors = 0
+lust.befores = {}
+lust.afters = {}
+
+local red = string.char(27) .. '[31m'
+local green = string.char(27) .. '[32m'
+local normal = string.char(27) .. '[0m'
+local function indent(level) return string.rep('\t', level or lust.level) end
+
+function lust.nocolor()
+  red, green, normal = '', '', ''
+  return lust
+end
+
+function lust.describe(name, fn)
+  print(indent() .. name)
+  lust.level = lust.level + 1
+  fn()
+  lust.befores[lust.level] = {}
+  lust.afters[lust.level] = {}
+  lust.level = lust.level - 1
+end
+
+function lust.it(name, fn)
+  for level = 1, lust.level do
+    if lust.befores[level] then
+      for i = 1, #lust.befores[level] do
+        lust.befores[level][i](name)
+      end
+    end
+  end
+
+  local success, err = pcall(fn)
+  if success then lust.passes = lust.passes + 1
+  else lust.errors = lust.errors + 1 end
+  local color = success and green or red
+  local label = success and 'PASS' or 'FAIL'
+  print(indent() .. color .. label .. normal .. ' ' .. name)
+  if err then
+    print(indent(lust.level + 1) .. red .. tostring(err) .. normal)
+  end
+
+  for level = 1, lust.level do
+    if lust.afters[level] then
+      for i = 1, #lust.afters[level] do
+        lust.afters[level][i](name)
+      end
+    end
+  end
+end
+
+function lust.before(fn)
+  lust.befores[lust.level] = lust.befores[lust.level] or {}
+  table.insert(lust.befores[lust.level], fn)
+end
+
+function lust.after(fn)
+  lust.afters[lust.level] = lust.afters[lust.level] or {}
+  table.insert(lust.afters[lust.level], fn)
+end
+
+-- Assertions
+local function isa(v, x)
+  if type(x) == 'string' then
+    return type(v[1]) == x, 'expected ' .. tostring(v[1]) .. ' to be a ' .. x
+  elseif type(x) == 'table' then
+    if type(v[1]) ~= 'table' then
+      return false, 'expected ' .. tostring(v[1]) .. ' to be a ' .. tostring(x)
+    end
+
+    local seen = {}
+    local meta = v[1]
+    while meta and not seen[meta] do
+      if meta == x then return true end
+      seen[meta] = true
+      meta = getmetatable(meta) and getmetatable(meta).__index
+    end
+
+    return false, 'expected ' .. tostring(v[1]) .. ' to be a ' .. tostring(x)
+  end
+
+  error('invalid type ' .. tostring(x))
+end
+
+local function has(t, x)
+  for k, v in pairs(t) do
+    if v == x then return true end
+  end
+  return false
+end
+
+local function eq(t1, t2, eps)
+  if type(t1) ~= type(t2) then return false end
+  if type(t1) == 'number' then return math.abs(t1 - t2) <= (eps or 0) end
+  if type(t1) ~= 'table' then return t1 == t2 end
+  for k, _ in pairs(t1) do
+    if not eq(t1[k], t2[k], eps) then return false end
+  end
+  for k, _ in pairs(t2) do
+    if not eq(t2[k], t1[k], eps) then return false end
+  end
+  return true
+end
+
+local function stringify(...)
+  local values = {}
+  for i = 1, select('#', ...) do
+    local value = select(i, ...)
+    if type(value) == 'string' then
+      table.insert(values, "'" .. tostring(value) .. "'")
+    elseif type(value) ~= 'table' or getmetatable(value) and getmetatable(value).__tostring then
+      table.insert(values, tostring(value))
+    else
+      local entries = {}
+      for i, v in ipairs(value) do
+        entries[#entries + 1] = stringify(v)
+      end
+      for k, v in pairs(value) do
+        if type(k) ~= 'number' or k > #value or k < 1 then
+          entries[#entries + 1] = ('[%s] = %s'):format(stringify(k), stringify(v))
+        end
+      end
+      table.insert(values, '{ ' .. table.concat(entries, ', ') .. ' }')
+    end
+  end
+  return table.concat(values, ', ')
+end
+
+local function all(t, fn, ...)
+  for i = 1, t.n or #t do
+    if not fn(t[i], i, ...) then return false end
+  end
+  return true
+end
+
+local function any(t, fn, ...)
+  for i, v in ipairs(t) do
+    if fn(v, i, ...) then return true end
+  end
+  return false
+end
+
+local function concat(t, s)
+  local strings = {}
+  for i = 1, t.n or #t do
+    table.insert(strings, tostring(t[i]))
+  end
+  return table.concat(strings, s)
+end
+
+local unpack = _G.unpack or table.unpack
+local function istable(x) return type(x) == 'table' end
+
+local paths = {
+  [''] = { 'to', 'to_not' },
+  to = { 'have', 'equal', 'be', 'exist', 'fail', 'match', 'approximately' },
+  to_not = {
+    'have', 'equal', 'be', 'exist', 'fail', 'match', 'approximately',
+    chain = function(a) a.negate = not a.negate end
+  },
+  a = { test = isa },
+  an = { test = isa },
+  be = { 'a', 'an', 'truthy', 'falsy',
+    test = function(v, ...)
+      local same = v.n == select('#', ...) and all(v, function(x, i, ...) return x == select(i, ...) end, ...)
+      return same, 'expected ' .. concat(v, ', ') .. ' and ' .. concat({ n = select('#', ...), ... }, ', ') .. ' to be the same'
+    end
+  },
+  exist = {
+    test = function(v)
+      return v.n > 0 and all(v, function(x) return x ~= nil end), 'expected ' .. concat(v, ', ') .. ' to exist'
+    end
+  },
+  truthy = {
+    test = function(v)
+      return v.n > 0 and all(v, function(x) return x end), 'expected ' .. concat(v, ', ') .. ' to be truthy'
+    end
+  },
+  falsy = {
+    test = function(v)
+      return all(v, function(x) return not x end), 'expected ' .. concat(v, ', ') .. ' to be falsy'
+    end
+  },
+  equal = {
+    test = function(v, ...)
+      local equal = true
+
+      equal = equal and v.n == select('#', ...)
+      equal = equal and all(v, function(x, i, ...) return eq(x, select(i, ...), v.epsilon) end, ...)
+
+      local comparison = ''
+      if any(v, istable) or any({ ... }, istable) then
+        comparison = comparison .. '\n' .. indent(lust.level + 1) .. 'LHS: ' .. stringify(unpack(v))
+        comparison = comparison .. '\n' .. indent(lust.level + 1) .. 'RHS: ' .. stringify(...)
+      end
+
+      return equal, 'expected ' .. concat(v, ', ') .. ' and ' .. concat({ n = select('#', ...), ... }, ', ') .. ' to be equal' .. comparison
+    end
+  },
+  have = {
+    test = function(v, x)
+      if type(v[1]) ~= 'table' then
+        error('expected ' .. tostring(v[1]) .. ' to be a table')
+      end
+
+      return has(v[1], x), 'expected ' .. tostring(v[1]) .. ' to contain ' .. tostring(x)
+    end
+  },
+  fail = { 'with',
+    test = function(v, pattern)
+      local ok, err = pcall(unpack(v))
+
+      if pattern then
+        return not ok and string.find(err, pattern), 'expected ' .. tostring(v[1]) .. ' to fail with error matching "' .. pattern .. '"'
+      else
+        return not ok, 'expected ' .. tostring(v[1]) .. ' to fail'
+      end
+    end
+  },
+  with = {
+    test = function(v, pattern)
+      local ok, message = pcall(unpack(v))
+      return not ok and message:match(pattern), 'expected ' .. tostring(v[1]) .. ' to fail with error matching "' .. pattern .. '"'
+    end
+  },
+  match = {
+    test = function(v, pattern)
+      local value = tostring(v[1])
+      local result = string.find(value, pattern)
+      return result ~= nil, 'expected ' .. value .. ' to match pattern [[' .. pattern .. ']]'
+    end
+  },
+  approximately = { 'be', 'equal',
+    chain = function(a, x) a.epsilon = x or 1e-3 end
+  }
+}
+
+function lust.expect(...)
+  local assertion = { action = '', negate = false, epsilon = 0, n = select('#', ...), ... }
+
+  setmetatable(assertion, {
+    __index = function(t, k)
+      if has(paths[rawget(t, 'action')], k) then
+        rawset(t, 'action', k)
+        local chain = paths[rawget(t, 'action')].chain
+        if chain then chain(t) end
+        return t
+      end
+      return rawget(t, k)
+    end,
+    __call = function(t, ...)
+      if paths[t.action].test then
+        local res, err = paths[t.action].test(t, ...)
+        if assertion.negate then
+          res = not res
+          err = err:gsub(' to ', ' to not ', 1)
+        end
+        if not res then
+          error(err or 'unknown failure', 2)
+        end
+      elseif paths[t.action].chain then
+        paths[t.action].chain(t, ...)
+        return t
+      end
+    end
+  })
+
+  return assertion
+end
+
+function lust.spy(target, name, run)
+  local spy = {}
+  local subject
+
+  local function capture(...)
+    table.insert(spy, {...})
+    return subject(...)
+  end
+
+  if type(target) == 'table' then
+    subject = target[name]
+    target[name] = capture
+  else
+    run = name
+    subject = target or function() end
+  end
+
+  setmetatable(spy, {__call = function(_, ...) return capture(...) end})
+
+  if run then run() end
+
+  return spy
+end
+
+lust.test = lust.it
+lust.paths = paths
+
+return lust
diff --git a/src/test/main.lua b/src/test/main.lua
new file mode 100644
index 0000000..89a2c9a
--- /dev/null
+++ b/src/test/main.lua
@@ -0,0 +1,28 @@
+local lust = require 'test/lust'
+local describe, it, expect = lust.describe, lust.it, lust.expect
+-- usage: https://github.com/bjornbytes/lust
+
+describe('my project', function()
+  lust.before(function()
+    -- This gets run before every test.
+  end)
+
+  describe('ℹ️ app vars', function() -- Can be nested
+    it('bindir', function()
+      print(app.bindir)
+      expect(app.bindir).to.fail('xrforge.com') -- Pass
+    end)
+
+    it('feature2', function()
+      expect(nil).to.exist() -- Fail
+    end)
+  end)
+end)
+
+if lust.errors == 0 then 
+  print("✅ all tests passed") 
+else
+  print("[!] some tests failed")
+  print("errors: " .. lust.errors .. " :(")
+end
+os.exit(lust.errors)
diff --git a/src/tests.html b/src/test/soakbean.html
similarity index 100%
rename from src/tests.html
rename to src/test/soakbean.html
diff --git a/util/xrforge.sh b/util/xrforge.sh
index 556e0ae..9d217a7 100755
--- a/util/xrforge.sh
+++ b/util/xrforge.sh
@@ -33,6 +33,7 @@ download(){
 
 build(){
   download redbean  
+  download janusweb
   cd src
   zip -r ../result/bin/xrforge.com * .lua .init.lua .args
 }