Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
lua
 
 
 
 
 
 
 
 

README.md

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!

About

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

Resources

License

Releases

No releases published

Packages

No packages published