theganyo / lua2go

Easy access to your Go (Golang) modules from Lua and NGINX!

Accessing Go via Lua

This module enables easy access to Go modules from LuaJit and therefore, NGINX with the LuaJit module. So if you need the capabilities of Go in your NGINX processing, you've come to the right place!

Note: Lua2Go is now available from LuaRocks: http://luarocks.org/modules/scottganyo/lua2go

To use (see also the example:

1. Write your Go module and export your functions:

   //export add
   func add(operand1 int, operand2 int) int {
       return operand1 + operand2
   }
   

2. Build your go module as a shared library:

   go build -buildmode=c-shared -o example.so example.go

3. Include a bit of setup in your Lua file:

   local lua2go = require('lua2go')
   local example = lua2go.Load('./example.so')
   

4. Register your extern declarations from your header file (example.h) in your Lua:

   lua2go.Externs[[
     extern GoInt add(GoInt p0, GoInt p1);
   ]]
   

5. Call your Go function from Lua (see example for more detail):

   local result = lua2go.ToGo(example.add(1, 1))
   

6. Run your app:

   luajit myapp.lua

7. Bask in the glory of all that you've accomplished!

8. To see how Lua2Go can be incorporated into NGINX, check out the benchmark example.

Enjoy!