plugeth/plugins/plugin_loader.go

203 lines
5.1 KiB
Go
Raw Permalink Normal View History

2021-03-15 20:02:37 +00:00
package plugins
import (
"flag"
"fmt"
2021-03-15 20:02:37 +00:00
"io/ioutil"
"path"
"plugin"
2021-06-25 19:57:24 +00:00
"reflect"
"strings"
"github.com/ethereum/go-ethereum/event"
"github.com/ethereum/go-ethereum/log"
"github.com/openrelayxyz/plugeth-utils/core"
"github.com/urfave/cli/v2"
)
2021-03-15 20:02:37 +00:00
type Subcommand func(core.Context, []string) error
2021-03-15 20:02:37 +00:00
type pluginDetails struct {
2023-06-09 10:08:56 +00:00
p *plugin.Plugin
name string
}
type PluginLoader struct {
Plugins []pluginDetails
2021-03-15 20:02:37 +00:00
Subcommands map[string]Subcommand
Flags []*flag.FlagSet
LookupCache map[string][]interface{}
}
func (pl *PluginLoader) Lookup(name string, validate func(interface{}) bool) []interface{} {
if v, ok := pl.LookupCache[name]; ok {
return v
}
results := []interface{}{}
for _, plugin := range pl.Plugins {
if v, err := plugin.p.Lookup(name); err == nil {
if validate(v) {
results = append(results, v)
} else {
log.Warn("Plugin matches hook but not signature", "plugin", plugin.name, "hook", name)
}
}
}
pl.LookupCache[name] = results
return results
}
func Lookup(name string, validate func(interface{}) bool) []interface{} {
if DefaultPluginLoader == nil {
log.Warn("Lookup attempted, but PluginLoader is not initialized", "name", name)
return []interface{}{}
}
return DefaultPluginLoader.Lookup(name, validate)
2021-03-15 20:02:37 +00:00
}
var DefaultPluginLoader *PluginLoader
2021-03-15 20:02:37 +00:00
func NewPluginLoader(target string) (*PluginLoader, error) {
log.Info("Loading plugins from directory", "path", target)
2021-03-15 20:02:37 +00:00
pl := &PluginLoader{
Plugins: []pluginDetails{},
2021-03-15 20:02:37 +00:00
Subcommands: make(map[string]Subcommand),
Flags: []*flag.FlagSet{},
LookupCache: make(map[string][]interface{}),
2021-03-15 20:02:37 +00:00
}
files, err := ioutil.ReadDir(target)
if err != nil {
log.Warn("Could not load plugins directory. Skipping.", "path", target)
return pl, nil
}
for _, file := range files {
fpath := path.Join(target, file.Name())
if !strings.HasSuffix(file.Name(), ".so") {
2023-06-09 10:08:56 +00:00
log.Debug("File in plugin directory is not '.so' file. Skipping.", "file", fpath)
2021-03-15 20:02:37 +00:00
continue
}
plug, err := plugin.Open(fpath)
if err != nil {
2023-06-09 10:08:56 +00:00
log.Warn("File in plugin directory could not be loaded", "file", fpath, "error", err)
2021-03-15 20:02:37 +00:00
continue
}
// Any type of plugin can potentially specify flags
f, err := plug.Lookup("Flags")
if err == nil {
flagset, ok := f.(*flag.FlagSet)
if !ok {
log.Warn("Found plugin.Flags, but it its not a *FlagSet", "file", fpath)
} else {
pl.Flags = append(pl.Flags, flagset)
}
}
sb, err := plug.Lookup("Subcommands")
if err == nil {
subcommands, ok := sb.(*map[string]func(core.Context, []string) error)
2021-03-15 20:02:37 +00:00
if !ok {
log.Warn("Could not cast plugin.Subcommands to `map[string]func(core.Context, []string) error`", "file", fpath, "type", reflect.TypeOf(sb))
} else {
2021-06-25 19:57:24 +00:00
for k, v := range *subcommands {
if _, ok := pl.Subcommands[k]; ok {
log.Warn("Subcommand redeclared", "file", fpath, "subcommand", k)
}
pl.Subcommands[k] = v
}
2021-03-15 20:02:37 +00:00
}
}
pl.Plugins = append(pl.Plugins, pluginDetails{plug, fpath})
2021-03-15 20:02:37 +00:00
}
return pl, nil
}
func Initialize(target string, ctx core.Context) (err error) {
DefaultPluginLoader, err = NewPluginLoader(target)
if err != nil {
return err
}
2021-07-12 19:45:42 +00:00
DefaultPluginLoader.Initialize(ctx)
return nil
}
func (pl *PluginLoader) Initialize(ctx core.Context) {
2021-07-12 19:45:42 +00:00
fns := pl.Lookup("Initialize", func(i interface{}) bool {
_, ok := i.(func(core.Context, core.PluginLoader, core.Logger))
2021-07-12 19:45:42 +00:00
return ok
})
for _, fni := range fns {
if fn, ok := fni.(func(core.Context, core.PluginLoader, core.Logger)); ok {
fn(ctx, pl, log.Root())
2021-07-12 19:45:42 +00:00
}
}
}
2021-03-15 20:02:37 +00:00
func (pl *PluginLoader) RunSubcommand(ctx *cli.Context) (bool, error) {
args := ctx.Args().Slice()
if len(args) == 0 {
return false, fmt.Errorf("no subcommand arguments")
}
2021-03-15 20:02:37 +00:00
subcommand, ok := pl.Subcommands[args[0]]
if !ok {
return false, fmt.Errorf("Subcommand %v does not exist", args[0])
}
2021-03-15 20:02:37 +00:00
return true, subcommand(ctx, args[1:])
}
func RunSubcommand(ctx *cli.Context) (bool, error) {
if DefaultPluginLoader == nil {
return false, fmt.Errorf("Plugin loader not initialized")
}
return DefaultPluginLoader.RunSubcommand(ctx)
}
2021-03-15 20:02:37 +00:00
func (pl *PluginLoader) ParseFlags(args []string) bool {
for _, flagset := range pl.Flags {
flagset.Parse(args)
}
return len(pl.Flags) > 0
}
2023-09-28 20:48:25 +00:00
func LookupOne[T any](pl *PluginLoader, name string) (T, bool) {
var zero T
if pl == nil {
if DefaultPluginLoader == nil {
log.Warn("Attempting to LookupOne, but default PluginLoader has not been initialized")
return zero, false
}
pl = DefaultPluginLoader
}
items := pl.Lookup(name, func(v interface{}) bool {
_, ok := v.(T)
return ok
})
if len(items) == 0 {
return zero, false
}
return items[0].(T), true
}
func ParseFlags(args []string) bool {
if DefaultPluginLoader == nil {
log.Warn("Attempting to parse flags, but default PluginLoader has not been initialized")
return false
}
return DefaultPluginLoader.ParseFlags(args)
2021-03-15 20:02:37 +00:00
}
type feedWrapper struct {
feed *event.Feed
}
func (f *feedWrapper) Send(item interface{}) int {
return f.feed.Send(item)
}
func (f *feedWrapper) Subscribe(ch interface{}) core.Subscription {
return f.feed.Subscribe(ch)
}
func (pl *PluginLoader) GetFeed() core.Feed {
return &feedWrapper{&event.Feed{}}
}