https://github.com/erdian718/lua

Go Lua Compiler and VM
https://github.com/erdian718/lua

compiler go js lua vm wasm

Last synced: about 1 month ago
JSON representation

Go Lua Compiler and VM

• Host: GitHub
• URL: https://github.com/erdian718/lua
• Owner: erdian718
• License: zlib
• Created: 2019-04-28T10:08:39.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-09-15T03:41:49.000Z (about 1 year ago)
• Last Synced: 2024-10-09T12:32:29.108Z (about 1 month ago)
• Topics: compiler, go, js, lua, vm, wasm
• Language: Go
• Size: 136 KB
• Stars: 24
• Watchers: 1
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Go Lua Compiler and VM

This is a Lua 5.3 VM and compiler written in [Go](http://golang.org/). This is intended to allow easy embedding into Go programs, with minimal fuss and bother. It can also run in a browser by Webassembly.

This repository is forked from [milochristiansen/lua](https://github.com/milochristiansen/lua), and I made some incompatible changes. So it's unlikely to be merged into the original repository.

The strftime function and string pattern matching is currently copied from [yuin/gopher-lua](https://github.com/yuin/gopher-lua). It may be rewritten in the future.

## Usage

```go

package main

import (

	"github.com/ofunc/lua/util"

)

func main() {

	l := util.NewState()

	util.Run(l, "main.lua")

}

```

```lua

local js = require 'js'

local window = js.global

window:setTimeout(function()

	window:alert('Hello world!')

end, 1000)

```

Please refer to the README for standard libraries.

## Dependencies

* [Go 1.12+](https://golang.org/)

## Modules

* [ioc](https://github.com/ofunc/ioc) - Inversion of Control module for Lua.

* [lmodbolt](https://github.com/ofunc/lmodbolt) - boltdb/bolt bindings for Lua.

* [lmodhttpclient](https://github.com/ofunc/lmodhttpclient) - http.Client bindings for Lua.

* [lmodmsgpack](https://github.com/ofunc/lmodmsgpack) - MessagePack for Lua.

* [lmodoffice](https://github.com/ofunc/lmodoffice) - A simple Lua module for converting various office documents into OOXML format files.

* [lmodxlsx](https://github.com/ofunc/lmodxlsx) - plandem/xlsx bindings for Lua.

* [mithril](https://github.com/ofunc/mithril) - Mithril.js bindings for Lua.

* [stream](https://github.com/ofunc/stream) - A simple lazy list module for Lua.

## Missing Stuff

The following standard functions are not available:

* `collectgarbage` (not possible, VM uses the Go collector)

* `xpcall` (VM has no concept of a message handler)

* `next` (I don't need it at this time)

* `load` (violates my security policy)

* `dofile` (violates my security policy, use `require`)

* `loadfile` (violates my security policy, use `require`)

* `string.dump` (violates my security policy)

* `string.pack` (I don't need it at this time, use [msgpack](https://github.com/ofunc/lmodmsgpack))

* `string.packsize` (I don't need it at this time, use [msgpack](https://github.com/ofunc/lmodmsgpack))

* `string.unpack` (I don't need it at this time, use [msgpack](https://github.com/ofunc/lmodmsgpack))

* * *

The following standard modules are not available:

* `package` (violates my security policy, use `util.AddPath`)

* `debug` (violates my security policy)

* `coroutine` (no coroutine support yet, use goroutine)

* * *

The following modules are not implemented exactly as the Lua 5.3 specification requires:

* `math.random` (initialize the seed by default using program startup time)

* `os` (Go style functions)

* `io` (Go style functions)

* * *

There are a few things that are implemented exactly as the Lua 5.3 specification requires, where the reference

Lua implementation does not follow the specification exactly:

* The `#` (length) operator always returns the number of positive integer keys. When the table is a sequence, it's exactly equal to the sequence's length.

* Modulo operator (`%`) is implemented the same way most languages implement it, not the way Lua does. This does not matter unless you are using negative operands.

* * *

The following *core language* features are not supported:

* Hexadecimal floating point literals are not supported at this time.

* Weak references of any kind are not supported. This is because the VM uses Go's garbage collector, and it does not support weak references.

* Finalizers are not supported.

## TODO

* More tests.

* Better error hints.

* Code optimization.