summaryrefslogtreecommitdiffstats
path: root/plugin/pluginenv/options.go
blob: 827520fac4ad0d0784c81fd9881eba57fd3a52b9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
package pluginenv

import (
	"fmt"

	"github.com/mattermost/mattermost-server/model"
	"github.com/mattermost/mattermost-server/plugin"
	"github.com/mattermost/mattermost-server/plugin/rpcplugin"
)

// APIProvider specifies a function that provides an API implementation to each plugin.
func APIProvider(provider APIProviderFunc) Option {
	return func(env *Environment) {
		env.apiProvider = provider
	}
}

// SupervisorProvider specifies a function that provides a Supervisor implementation to each plugin.
// If unspecified, DefaultSupervisorProvider is used.
func SupervisorProvider(provider SupervisorProviderFunc) Option {
	return func(env *Environment) {
		env.supervisorProvider = provider
	}
}

// SearchPath specifies a directory that contains the plugins to launch.
func SearchPath(path string) Option {
	return func(env *Environment) {
		env.searchPath = path
	}
}

// WebappPath specifies the static directory serving the webapp.
func WebappPath(path string) Option {
	return func(env *Environment) {
		env.webappPath = path
	}
}

// DefaultSupervisorProvider chooses a supervisor based on the plugin's manifest contents. E.g. if
// the manifest specifies a backend executable, it will be given an rpcplugin.Supervisor.
func DefaultSupervisorProvider(bundle *model.BundleInfo) (plugin.Supervisor, error) {
	if bundle.Manifest == nil {
		return nil, fmt.Errorf("a manifest is required")
	}
	if bundle.Manifest.Backend == nil {
		return nil, fmt.Errorf("invalid manifest: missing backend plugin")
	}
	return rpcplugin.SupervisorProvider(bundle)
}