shared

type Plugin ¶

type Plugin struct {
	// Impl is the plugin implementation.
	Impl Pluginer
}

Plugin is the implementation of plugin.Plugin so we can serve/consume this.

This has two methods: Server must return an RPC server for this plugin type. We construct a PluginRPCServer for this.

Client must return an implementation of our interface that communicates over an RPC client. We return PluginRPC for this.

Ignore MuxBroker. That is used to create more multiplexed streams on our plugin connection and is a more advanced use case.

func (Plugin) Client(b *hcplugin.MuxBroker, c *rpc.Client) (interface{}, error)

func (p *Plugin) Server(*hcplugin.MuxBroker) (interface{}, error)

type PluginRPC ¶

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

PluginRPC is an implementation that talks over RPC.

func (g *PluginRPC) Start() error

type PluginRPCServer ¶

type PluginRPCServer struct {
	// Impl is the real implementation.
	Impl Pluginer
}

PluginRPCServer is the RPC server that PluginRPC talks to, conforming to the requirements of net/rpc.

func (s *PluginRPCServer) Start(args interface{}, resp *error) error

type Pluginer ¶

type Pluginer interface {
	Start() error
}

Pluginer is the interface that we're exposing as a plugin.

type ServeOpts ¶

type ServeOpts struct {
	// Plugin is the interface implementation.
	Plugin Pluginer

	// Logger is the logger that go-plugin will use.
	Logger hclog.Logger
}

ServeOpts are the configurations to serve a plugin.