goplugin

Documentation

Overview

Package goplugin - golang plugin in docker runner

Index

• type GoPlugin
  • func NewGoPlugin(options Options, runnerOptions RunnerOptions) (*GoPlugin, error)
  • func (gp *GoPlugin) Exec(codeRef logicrunner.Reference, data []byte, method string, ...) ([]byte, logicrunner.Arguments, error)
  • func (gp *GoPlugin) Start()
  • func (gp *GoPlugin) Stop()
• type Options
• type RPC
  • func (gpr *RPC) GetObject(ref logicrunner.Reference, reply *logicrunner.Object) error
• type RunnerOptions

Types

type GoPlugin

type GoPlugin struct {
	Options       Options
	RunnerOptions RunnerOptions
	// contains filtered or unexported fields
}

GoPlugin is a logic runner of code written in golang and compiled as go plugins

func NewGoPlugin

func NewGoPlugin(options Options, runnerOptions RunnerOptions) (*GoPlugin, error)

NewGoPlugin returns a new started GoPlugin

func (*GoPlugin) Exec

func (gp *GoPlugin) Exec(codeRef logicrunner.Reference, data []byte, method string, args logicrunner.Arguments) ([]byte, logicrunner.Arguments, error)

Exec runs a method on an object in controlled environment

func (*GoPlugin) Start

func (gp *GoPlugin) Start()

Start starts runner and RPC interface to help runner, note that NewGoPlugin does this for you

func (*GoPlugin) Stop

func (gp *GoPlugin) Stop()

Stop stops runner(s) and RPC service

type Options

type Options struct {
	// Listen  is address `GoPlugin` listens on and provides RPC interface for runner(s)
	Listen string
	// CodePath is path to directory with plugin's code, this should go away at some point
	CodePath string
}

Options of the GoPlugin

type RPC

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

RPC is a RPC interface for runner to use for variouse tasks, e.g. code fetching

func (*RPC) GetObject

func (gpr *RPC) GetObject(ref logicrunner.Reference, reply *logicrunner.Object) error

GetObject is an RPC retriving an object by its reference, so far short circueted to return code of the plugin

type RunnerOptions

type RunnerOptions struct {
	// Listen is address the runner listens on and provides RPC interface for the `GoPlugin`
	Listen string
	// CodeStoragePath is path to directory where the runner caches code
	CodeStoragePath string
}

RunnerOptions - set of options to control internal isolated code runner(s)