chore: migrate to Lua 5.5 and lux 0.27.0, replace argparse with argp

.githooks/pre-commit

@@ -0,0 +1,12 @@
+#!/bin/sh
+set -e
+
+echo "Running pre-commit checks..."
+
+# Run code quality checks via just
+if command -v just >/dev/null 2>&1; then
+    just check
+else
+    echo "Error: 'just' command not found. Please install just (https://github.com/casey/just)"
+    exit 1
+fi

.github/workflows/tests.yml

@@ -23,9 +23,16 @@ jobs:
           # because it doesn't run tests (no busted dependency)
           version: 0.18.8
 
-      - name: Run tests
+      - name: Install just
         run: |
-          lx --lua-version 5.4 test
+          mkdir -p /tmp/just
+          curl -L https://github.com/casey/just/releases/download/1.48.1/just-1.48.1-x86_64-unknown-linux-musl.tar.gz -o /tmp/just/just.tar.gz
+          tar -xzf /tmp/just/just.tar.gz -C /tmp/just
+          sudo mv /tmp/just/just /usr/local/bin/
+          rm -rf /tmp/just
+
+      - name: Run tests
+        run: just test-ci
 
   lint:
     name: Lint & Format
@@ -40,10 +47,18 @@ jobs:
           # See comment in test job above for version pinning rationale
           version: 0.18.8
 
+      - name: Install just
+        run: |
+          mkdir -p /tmp/just
+          curl -L https://github.com/casey/just/releases/download/1.48.1/just-1.48.1-x86_64-unknown-linux-musl.tar.gz -o /tmp/just/just.tar.gz
+          tar -xzf /tmp/just/just.tar.gz -C /tmp/just
+          sudo mv /tmp/just/just /usr/local/bin/
+          rm -rf /tmp/just
+
       - name: Check formatting
         run: |
           lx fmt
           git diff --exit-code || (echo "::error::Code is not formatted. Run 'lx fmt' locally and commit the changes." && exit 1)
 
       - name: Run linter
-        run: lx --lua-version 5.4 lint
+        run: just lint-ci

.gitignore

@@ -27,3 +27,11 @@ luacov.report.out
 
 # Demo recording
 *.cast
+
+# Build artifacts
+.build/
+/roda
+bin_spin.luastatic.c
+spin.luastatic.c
+lua/spin.luastatic.c
+*.luastatic.c

.luacheckrc

@@ -0,0 +1,95 @@
+-- luacheck configuration for roda.lua
+-- Treat all warnings as errors by default
+-- but ignore some stylistic warnings
+
+ignore = {
+    "212", -- deep nesting
+    "213", -- long line (over 120 chars)
+    "211", -- line contains only whitespace
+    "111", -- setting non-standard global variable
+    "112", -- mutating non-standard global variable
+    "113", -- accessing undefined variable
+    "421", -- variable defined but not used (handled by unused argument detection)
+}
+
+-- Files to check
+files = {
+    "**/*.lua",
+    "!**/_spec.lua", -- exclude test files from some checks
+}
+
+-- Global variables that are allowed
+globals = {
+    "arg", -- command line arguments
+    "io",
+    "package",
+    "string",
+    "table",
+    "os",
+    "debug",
+    "math",
+    "coroutine",
+    "utf8",
+    "jit",
+    "bit",
+    "bit32",
+    "_G",
+    "_VERSION",
+    "require",
+    "setmetatable",
+    "getmetatable",
+    "pairs",
+    "ipairs",
+    "next",
+    "type",
+    "tostring",
+    "tonumber",
+    "assert",
+    "error",
+    "pcall",
+    "xpcall",
+    "rawget",
+    "rawset",
+    "rawequal",
+    "select",
+    "unpack",
+    "print",
+    "collectgarbage",
+    "dofile",
+    "load",
+    "loadfile",
+    "loadstring",
+    "module",
+    "setfenv",
+    "getfenv",
+    "newproxy",
+    "spawn",
+    "uv", -- luv library
+    "busted", -- test framework
+    "describe",
+    "it",
+    "before_each",
+    "after_each",
+    "setup",
+    "teardown",
+    "pending",
+    "assert",
+    "mock",
+    "stub",
+    "spy",
+}
+
+-- Maximum line length
+max_line_length = 120
+
+-- Maximum number of consecutive empty lines
+max_empty_lines = 2
+
+-- Allow unused arguments that start with underscore
+allow_unused = {"^_"} -- matches `_` and `_err` etc.
+
+-- Allow unused loop variables
+unused_args = false
+
+-- Check globals defined in other modules
+check_globals = false