binder

package module
v0.0.0-...-2a21303 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 29, 2018 License: MIT Imports: 8 Imported by: 27

README

Binder

High level go to Lua binder. Write less, do more.

Travis Coverage Status Go Report Card GoDoc license binder

Package binder allows to easily bind to Lua. Based on gopher-lua.

Write less, do more!

  1. Killer-feature
  2. Installation
  3. Examples
    1. Functions
    2. Modules
    3. Tables
    4. Options
    5. Killer-featured errors
  4. License

Killer-feature

You can display detailed information about the error and get something like this:

Error

See _example/04-highlight-errors. And read more about it.

Installation

$ go get -u github.com/alexeyco/binder

To run unit tests:

$ cd $GOPATH/src/github.com/alexeyco/binder
$ go test -cover

To see why you need to bind go to lua (need few minutes):

$ cd $GOPATH/src/github.com/alexeyco/binder
$ go test -bench=.

Examples

Functions
package main

import (
	"errors"
	"log"

	"github.com/alexeyco/binder"
)

func main() {
	b := binder.New(binder.Options{
		SkipOpenLibs: true,
	})

	b.Func("log", func(c *binder.Context) error {
		t := c.Top()
		if t == 0 {
			return errors.New("need arguments")
		}

		l := []interface{}{}

		for i := 1; i <= t; i++ {
			l = append(l, c.Arg(i).Any())
		}

		log.Println(l...)
		return nil
	})

	if err := b.DoString(`
		log('This', 'is', 'Lua')
	`); err != nil {
		log.Fatalln(err)
	}
}
Modules
package main

import (
	"errors"
	"log"

	"github.com/alexeyco/binder"
)

func main() {
	b := binder.New()

	m := b.Module("reverse")
	m.Func("string", func(c *binder.Context) error {
		if c.Top() == 0 {
			return errors.New("need arguments")
		}

		s := c.Arg(1).String()

		runes := []rune(s)
		for i, j := 0, len(runes)-1; i < j; i, j = i+1, j-1 {
			runes[i], runes[j] = runes[j], runes[i]
		}

		c.Push().String(string(runes))
		return nil
	})

	if err := b.DoString(`
		local r = require('reverse')

		print(r.string('ABCDEFGHIJKLMNOPQRSTUFVWXYZ'))
	`); err != nil {
		log.Fatalln(err)
	}
}

Tables
package main

import (
	"errors"
	"log"

	"github.com/alexeyco/binder"
)

type Person struct {
	Name string
}

func main() {
	b := binder.New()

	t := b.Table("person")
	t.Static("new", func(c *binder.Context) error {
		if c.Top() == 0 {
			return errors.New("need arguments")
		}
		n := c.Arg(1).String()

		c.Push().Data(&Person{n}, "person")
		return nil
	})

	t.Dynamic("name", func(c *binder.Context) error {
		p, ok := c.Arg(1).Data().(*Person)
		if !ok {
			return errors.New("person expected")
		}

		if c.Top() == 1 {
			c.Push().String(p.Name)
		} else {
			p.Name = c.Arg(2).String()
		}

		return nil
	})

	if err := b.DoString(`
		local p = person.new('Steeve')
		print(p:name())

		p:name('Alice')
		print(p:name())
	`); err != nil {
		log.Fatalln(err)
	}
}
Options
// Options binder options object
type Options struct {
	// CallStackSize is call stack size
	CallStackSize int
	// RegistrySize is data stack size
	RegistrySize int
	// SkipOpenLibs controls whether or not libraries are opened by default
	SkipOpenLibs bool
	// IncludeGoStackTrace tells whether a Go stacktrace should be included in a Lua stacktrace when panics occur.
	IncludeGoStackTrace bool
}

Read more.

For example:

b := binder.New(binder.Options{
	SkipOpenLibs: true,
})
package main

import (
	"errors"
	"log"
	"os"

	"github.com/alexeyco/binder"
)

type Person struct {
	Name string
}

func main() {
	b := binder.New()
	
	// ...

	if err := b.DoString(`-- some string`); err != nil {
		switch err.(type) {
		case *binder.Error:
			e := err.(*binder.Error)
			e.Print()

			os.Exit(0)
			break
		default:
			log.Fatalln(err)
		}
	}
}

Note: if SkipOpenLibs is true, not all open libs will be skipped in contrast to the basic logic of gopher-lua. If you set SkipOpenLibs to true, the following basic libraries will be loaded: all basic functions, table and package.

License

MIT License

Copyright (c) 2017 Alexey Popov

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Documentation

Overview

Package binder allows to easily bind to Lua. Based on https://github.com/yuin/gopher-lua

Write less, do more.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Argument

type Argument struct {
	// contains filtered or unexported fields
}

Argument is a call function argument

func (*Argument) Any

func (a *Argument) Any() interface{}

Any returns function argument as interface{}

func (*Argument) Bool

func (a *Argument) Bool() bool

Bool checks if function argument is bool and return it

func (*Argument) Data

func (a *Argument) Data() interface{}

Data checks if function argument is UserData and return it

func (*Argument) Number

func (a *Argument) Number() float64

Number checks if function argument is number (float64) and return it

func (*Argument) String

func (a *Argument) String() string

String checks if function argument is string and return it

type Binder

type Binder struct {
	*Loader
	// contains filtered or unexported fields
}

Binder is a binder... that's all

func New

func New(opts ...Options) *Binder

New returns new binder instance

func (*Binder) DoFile

func (b *Binder) DoFile(f string) error

DoFile runs lua script file

func (*Binder) DoString

func (b *Binder) DoString(s string) error

DoString runs lua script string

func (*Binder) Load

func (b *Binder) Load(loader *Loader)

Load apply Loader

type Context

type Context struct {
	// contains filtered or unexported fields
}

Context function context

func (*Context) Arg

func (c *Context) Arg(num int) *Argument

Arg returns function argument by number

func (*Context) Push

func (c *Context) Push() *Push

Push pushes function result

func (*Context) Top

func (c *Context) Top() int

Top returns count of function arguments

type Error

type Error struct {
	// contains filtered or unexported fields
}

Error error object

func (*Error) Error

func (e *Error) Error() string

Error returns error string

func (*Error) Print

func (e *Error) Print()

Print prints problem source code

func (*Error) Source

func (e *Error) Source() string

Source returns problem source code as string

type Handler

type Handler func(*Context) error

Handler is binder function handler

type Loader

type Loader struct {
	// contains filtered or unexported fields
}

Loader is basic loader object

func NewLoader

func NewLoader() *Loader

NewLoader returns new loader

func (*Loader) Func

func (l *Loader) Func(name string, handler Handler)

Func assign handler with specified alias

func (*Loader) Module

func (l *Loader) Module(name string) *Module

Module creates new module and returns it

func (*Loader) Table

func (l *Loader) Table(name string) *Table

Table creates new table and returns it

type Module

type Module struct {
	// contains filtered or unexported fields
}

Module is a lua module wrapper

func (*Module) Bool

func (m *Module) Bool(name string, value bool)

Bool sets module bool constant

func (*Module) Func

func (m *Module) Func(name string, handler Handler)

Func sets module function with specified name

func (*Module) Number

func (m *Module) Number(name string, value float64)

Number sets module number (float64) constant

func (*Module) String

func (m *Module) String(name, value string)

String sets module string constant

type Options

type Options struct {
	// CallStackSize is call stack size
	CallStackSize int
	// RegistrySize is data stack size
	RegistrySize int
	// SkipOpenLibs controls whether or not libraries are opened by default
	SkipOpenLibs bool
	// IncludeGoStackTrace tells whether a Go stacktrace should be included in a Lua stacktrace when panics occur.
	IncludeGoStackTrace bool
}

Options binder options object

type Push

type Push struct {
	// contains filtered or unexported fields
}

Push function result wrapper

func (*Push) Bool

func (p *Push) Bool(b bool)

Bool pushes bool function result

func (*Push) Data

func (p *Push) Data(d interface{}, t string)

Data pushes UserData function result

func (*Push) Number

func (p *Push) Number(n float64)

Number pushes sting function result

func (*Push) String

func (p *Push) String(s string)

String pushes sting function result

type Table

type Table struct {
	// contains filtered or unexported fields
}

Table lua tables wrapper

func (*Table) Dynamic

func (t *Table) Dynamic(name string, handler Handler)

Dynamic sets table "dynamic" method (f.e. foo:bar())

func (*Table) Static

func (t *Table) Static(name string, handler Handler)

Static sets table "static" method (f.e. foo.bar())

Directories

Path Synopsis
_example

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL