Skip to content

luapure v0.1.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@htcom-code htcom-code released this 28 Jun 08:46
· 8 commits to main since this release
v0.1.0
b0a8f6b

[0.1.0] — 2026-06-28

First release. Targets PUC-Lua 5.4.8.

Added

  • Engine. Pure-Go port of PUC-Lua 5.4.8: instruction set, single-pass
    lexer+parser+codegen (no AST), and the VM dispatch loop.
  • Standard libraries. base, string (incl. patterns and string.pack/
    unpack), table, math (xoshiro256** PRNG, bit-identical to PUC), os, io,
    coroutine, utf8, debug, and require/package.
  • Precompiled chunks. Dump/undump ported from ldump.c/lundump.c; output
    is byte-identical to luac 5.4.8 on a 64-bit little-endian host, and luapure
    loads luac output and vice versa.
  • Embedding API. Table create/read/write, Go-callback argument checking
    (Check*/Opt*), ToValue/FromValue conversion, structured *LuaError
    with Value()/Traceback(), userdata with metatables and uservalues,
    sandboxing (NewSandbox/RunWith), cooperative cancellation (SetContext),
    file loading (LoadFile/DoFile/CompileReader), and lifecycle Close.
  • Version identifiers. luapure.Version / VersionString() and the Lua
    global _LUAPURE_VERSION ("luapure 0.1.0 (Lua 5.4.8)"); _VERSION stays
    exactly "Lua 5.4" for PUC conformance.
  • Debugger. Breakpoint / step / pause core, exposed over the Model Context
    Protocol (stdio + HTTP, debugmcp) and the Debug Adapter Protocol (TCP,
    debugdap), with standalone binaries under cmd/.
  • Conformance. 30/33 of the official Lua 5.4 test files pass — the PASS-able
    ceiling; the three remaining are structural won't-fixes (see ROADMAP.md).
  • Docs. README with quickstart, docs/FILEMAP.md (PUC↔Go map), runnable
    embedding examples, make doc/make doc-web.

Notes — intentional divergences from PUC

Observable semantics still match PUC; these are structural:

  • GC delegated to the Go runtime; weak tables via weak.Pointer, __gc via
    runtime.SetFinalizer + a drain queue.
  • Value is a tagged struct, not NaN-boxing (Go's precise GC must follow
    pointers).
  • Errors unwind via panic/recover instead of longjmp.
  • Coroutines are goroutines handing off over channels.
  • Configurable memory-limit caps stand in for PUC's malloc-failure path (Go
    cannot turn OOM into a catchable error).

Full changelog: CHANGELOG.md

Assets 2
Loading