Pingo 是一个用来为Go语言程序编写插件的简单独立库,因为 Go 本身是静态链接的,因此所有插件都以外部进程方式存在。Pingo 旨在简化标准 RPC 包,支持 TCP 和 Unix 套接字作为通讯协议。当前还不支持远程插件,如果有需要,远程插件很快会提供。
使用 Pingo 创建一个插件非常简单,首先新建目录,如 "plugins/hello-world" ,然后在该目录下编写 main.go:
// 创建新的二进制文件
package main
import "github.com/dullgiulio/pingo"
// 创建要导出的对象
type MyPlugin struct{}
// 导出的方法,带有rpc签名
func (p *MyPlugin) SayHello(name string, msg *string) error {
*msg = "Hello, " + name
return nil
}
func main() {
plugin := &MyPlugin{}
// 注册要导出的对象
pingo.Register(plugin)
// 运行主程序
pingo.Run()
}
使用go build
命令编译并生成可执行文件:
cd plugins/hello-world
go build
接下来就可以调用该插件:
package main
import (
"log"
"github.com/dullgiulio/pingo"
)
func main() {
// 从创建的可执行文件中创建一个新插件。通过 TCP 连接到它
p := pingo.NewPlugin("tcp", "plugins/hello-world/hello-world")
// 启动插件
p.Start()
// 使用完插件后停止它
defer p.Stop()
var resp string
// 从先前创建的对象调用函数
if err := p.Call("MyPlugin.SayHello", "Go developer", &resp); err != nil {
log.Print(err)
} else {
log.Print(resp)
}
}
运行结果如下:
go run main.go
Hello, Go developer