plugins

Documentation

Index

• Constants
• func AddPluginRoute(route PluginRoute) error
• func CheckForNewVersion(plugin Plugin) (string, error)
• func CreateAndAddPluginRoute(name, source, executable, version, commitHash, triggerEvent string) error
• func DeletePlugin(name string) error
• func DeletePluginRoute(name string) error
• func GetPluginBinDir(name string) string
• func GetPluginDataDir(name string) string
• func GetPluginDir(name string) string
• func GetPluginExecutablePath(name string) (string, bool, error)
• func GetPluginSrcDir(name string) string
• func GetPluginVersion(name string) (*ver.Version, error)
• func GetPluginYMLPath(name string) string
• func GitCloneAndCheckoutVersion(cloneIntoDir, repositoryURL, checkoutVersion string) (*ver.Version, string, error)
• func GitVersionTags(gitRepoDir string) ([]ver.Version, error)
• func InitPaths() error
• func ParseArgs(args []string) (string, []string, bool)
• func RunPluginByCommand(plugin Plugin, args []string) error
• func RunPluginByEvent(plugin Plugin, pluginInput PluginInput) error
• func SortByName(plugins []Plugin)
• func TriggerEvent(name TriggerEventName, payload interface{}) error
• type Plugin
  • func InstallPlugin(srcURL, binURL, versionTag string) (Plugin, string, error)
  • func InstalledPluginList() ([]Plugin, error)
  • func LoadPlugin(name string) (Plugin, bool, error)
  • func LoadPlugins(eventName string) ([]Plugin, error)
  • func NewPluginFromBytes(bytes []byte) (plugin Plugin, err error)
  • func NewPluginFromYML(ymlPth string) (Plugin, error)
  • func (plugin Plugin) ExecutableURL() string
  • func (plugin Plugin) String() string
  • func (plugin Plugin) Validate() error
• type PluginInput
• type PluginMode
• type PluginRoute
  • func NewPluginRoute(name, source, executable, version, commitHash, triggerEvent string) (PluginRoute, error)
  • func ReadPluginRoute(name string) (PluginRoute, bool, error)
  • func (route PluginRoute) Validate() error
• type PluginRouting
  • func NewPluginRouting() PluginRouting
  • func NewPluginRoutingFromBytes(bytes []byte) (PluginRouting, error)
  • func NewPluginRoutingFromYMLOrEmpty(ymlPth string) (PluginRouting, error)
  • func (routing *PluginRouting) AddRoute(route PluginRoute)
  • func (routing *PluginRouting) DeleteRoute(routeName string)
  • func (routing PluginRouting) Validate() error
• type Requirement
• type TriggerEventName

Constants

const (
	// TypeGeneric ...
	TypeGeneric = "_"
	// TypeInit ...
	TypeInit = "init"
	// TypeRun ....
	TypeRun = "run"
)

Functions

func AddPluginRoute

func AddPluginRoute(route PluginRoute) error

AddPluginRoute ...

func CheckForNewVersion

func CheckForNewVersion(plugin Plugin) (string, error)

CheckForNewVersion ...

func CreateAndAddPluginRoute

func CreateAndAddPluginRoute(name, source, executable, version, commitHash, triggerEvent string) error

CreateAndAddPluginRoute ...

func DeletePlugin

func DeletePlugin(name string) error

DeletePlugin ...

func DeletePluginRoute

func DeletePluginRoute(name string) error

DeletePluginRoute ...

func GetPluginBinDir

func GetPluginBinDir(name string) string

GetPluginBinDir ...

func GetPluginDataDir

func GetPluginDataDir(name string) string

GetPluginDataDir ...

func GetPluginDir

func GetPluginDir(name string) string

GetPluginDir ...

func GetPluginExecutablePath

func GetPluginExecutablePath(name string) (string, bool, error)

GetPluginExecutablePath ...

func GetPluginSrcDir

func GetPluginSrcDir(name string) string

GetPluginSrcDir ...

func GetPluginVersion

func GetPluginVersion(name string) (*ver.Version, error)

GetPluginVersion ...

func GetPluginYMLPath

func GetPluginYMLPath(name string) string

GetPluginYMLPath ...

func GitCloneAndCheckoutVersion

func GitCloneAndCheckoutVersion(cloneIntoDir, repositoryURL, checkoutVersion string) (*ver.Version, string, error)

GitCloneAndCheckoutVersion ...

func GitVersionTags

func GitVersionTags(gitRepoDir string) ([]ver.Version, error)

GitVersionTags ...

func InitPaths

func InitPaths() error

InitPaths ...

func ParseArgs

func ParseArgs(args []string) (string, []string, bool)

ParseArgs ...

func RunPluginByCommand

func RunPluginByCommand(plugin Plugin, args []string) error

RunPluginByCommand ...

func RunPluginByEvent

func RunPluginByEvent(plugin Plugin, pluginInput PluginInput) error

RunPluginByEvent ...

func SortByName

func SortByName(plugins []Plugin)

SortByName ...

func TriggerEvent

func TriggerEvent(name TriggerEventName, payload interface{}) error

TriggerEvent ...

Types

type Plugin

type Plugin struct {
	Name        string `yaml:"name"`
	Description string `yaml:"description"`
	Executable  struct {
		OSX   string `yaml:"osx"`
		Linux string `yaml:"linux"`
	}
	TriggerEvent string        `yaml:"trigger"`
	Requirements []Requirement `yaml:"requirements"`
}

Plugin ...

func InstallPlugin

func InstallPlugin(srcURL, binURL, versionTag string) (Plugin, string, error)

InstallPlugin ...

func InstalledPluginList

func InstalledPluginList() ([]Plugin, error)

InstalledPluginList ...

func LoadPlugin

func LoadPlugin(name string) (Plugin, bool, error)

LoadPlugin ...

func LoadPlugins

func LoadPlugins(eventName string) ([]Plugin, error)

LoadPlugins ...

func NewPluginFromBytes

func NewPluginFromBytes(bytes []byte) (plugin Plugin, err error)

NewPluginFromBytes ...

func NewPluginFromYML

func NewPluginFromYML(ymlPth string) (Plugin, error)

NewPluginFromYML ...

func (Plugin) ExecutableURL

func (plugin Plugin) ExecutableURL() string

ExecutableURL ...

func (Plugin) String

func (plugin Plugin) String() string

func (Plugin) Validate

func (plugin Plugin) Validate() error

Validate ...

type PluginInput

type PluginInput map[string]string

PluginInput ...

type PluginMode

type PluginMode string

PluginMode ...

type PluginRoute

type PluginRoute struct {
	Name                   string `yaml:"name"`
	Source                 string `yaml:"source"`
	Version                string `yaml:"version"`
	CommitHash             string `yaml:"commit_hash"`
	Executable             string `yaml:"executable"`
	TriggerEvent           string `yaml:"trigger"`
	LatestAvailableVersion string `yaml:"latest_available_version"`
}

PluginRoute ...

func NewPluginRoute

func NewPluginRoute(name, source, executable, version, commitHash, triggerEvent string) (PluginRoute, error)

NewPluginRoute ...

func ReadPluginRoute

func ReadPluginRoute(name string) (PluginRoute, bool, error)

ReadPluginRoute ...

func (PluginRoute) Validate

func (route PluginRoute) Validate() error

Validate ...

type PluginRouting

type PluginRouting struct {
	RouteMap map[string]PluginRoute `yaml:"route_map"`
}

PluginRouting ...

func NewPluginRouting

func NewPluginRouting() PluginRouting

NewPluginRouting ...

func NewPluginRoutingFromBytes

func NewPluginRoutingFromBytes(bytes []byte) (PluginRouting, error)

NewPluginRoutingFromBytes ...

func NewPluginRoutingFromYMLOrEmpty

func NewPluginRoutingFromYMLOrEmpty(ymlPth string) (PluginRouting, error)

NewPluginRoutingFromYMLOrEmpty ...

func (*PluginRouting) AddRoute

func (routing *PluginRouting) AddRoute(route PluginRoute)

AddRoute ...

func (*PluginRouting) DeleteRoute

func (routing *PluginRouting) DeleteRoute(routeName string)

DeleteRoute ...

func (PluginRouting) Validate

func (routing PluginRouting) Validate() error

Validate ...

type Requirement

type Requirement struct {
	Tool       string `yaml:"tool"`
	MinVersion string `yaml:"min_version"`
	MaxVersion string `yaml:"max_version"`
}

Requirement ...

type TriggerEventName

type TriggerEventName string

TriggerEventName ...

const (
	// DidFinishRun ...
	DidFinishRun TriggerEventName = "DidFinishRun"
)