reload

Documentation

Index

• Constants
• func ConvertIgnored(ignored []string) (map[string]struct{}, error)
• func InitDefaults(c *Config)
• type Config
  • func (c *Config) Valid() error
• type Event
• type Options
• type Plugin
  • func (s *Plugin) Init(cfg config.Configurer, log log.Logger, res resetter.Resetter) error
  • func (s *Plugin) Name() string
  • func (s *Plugin) Serve() chan error
  • func (s *Plugin) Stop() error
• type ServiceConfig
• type SimpleHook
• type Watcher
  • func NewWatcher(configs []WatcherConfig, log log.Logger, options ...Options) (*Watcher, error)
  • func (w *Watcher) StartPolling(duration time.Duration) error
  • func (w *Watcher) Stop()
• type WatcherConfig

Constants

const PluginName string = "reload"

PluginName contains default plugin name.

Functions

func ConvertIgnored

func ConvertIgnored(ignored []string) (map[string]struct{}, error)

ConvertIgnored is used to convert slice to map with ignored files

func InitDefaults

func InitDefaults(c *Config)

InitDefaults sets missing values to their default values.

Types

type Config

type Config struct {
	// Interval is a global refresh interval
	Interval time.Duration

	// Patterns is a global file patterns to watch. It will be applied to every directory in project
	Patterns []string

	// Services is set of services which would be reloaded in case of FS changes
	Services map[string]ServiceConfig
}

Config is a Reload configuration point.

func (*Config) Valid

func (c *Config) Valid() error

Valid validates the configuration.

type Event

type Event struct {
	Path string
	Info os.FileInfo
	// contains filtered or unexported fields
}

An Event describes an event that is received when files or directory changes occur. It includes the os.FileInfo of the changed file or directory and the type of event that's occurred and the full path of the file.

type Options

type Options func(*Watcher)

Options is used to set Watcher Options

type Plugin

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

func (*Plugin) Init

func (s *Plugin) Init(cfg config.Configurer, log log.Logger, res resetter.Resetter) error

Init controller service

func (*Plugin) Name

func (s *Plugin) Name() string

func (*Plugin) Serve

func (s *Plugin) Serve() chan error

func (*Plugin) Stop

func (s *Plugin) Stop() error

type ServiceConfig

type ServiceConfig struct {
	// Enabled indicates that service must be watched, doest not required when any other option specified
	Enabled bool

	// Recursive is options to use nested files from root folder
	Recursive bool

	// Patterns is per-service specific files to watch
	Patterns []string

	// Dirs is per-service specific dirs which will be combined with Patterns
	Dirs []string

	// Ignore is set of files which would not be watched
	Ignore []string
}

type SimpleHook

type SimpleHook func(filename string, pattern []string) error

SimpleHook is used to filter by simple criteria, CONTAINS

type Watcher

type Watcher struct {
	// main event channel
	Event chan Event
	// contains filtered or unexported fields
}

func NewWatcher

func NewWatcher(configs []WatcherConfig, log log.Logger, options ...Options) (*Watcher, error)

NewWatcher returns new instance of File Watcher

func (*Watcher) StartPolling

func (w *Watcher) StartPolling(duration time.Duration) error

func (*Watcher) Stop

func (w *Watcher) Stop()

type WatcherConfig

type WatcherConfig struct {
	// service name
	ServiceName string

	// Recursive or just add by singe directory
	Recursive bool

	// Directories used per-service
	Directories []string

	// simple hook, just CONTAINS
	FilterHooks func(filename string, pattern []string) error

	// path to file with Files
	Files map[string]os.FileInfo

	// Ignored Directories, used map for O(1) amortized get
	Ignored map[string]struct{}

	// FilePatterns to ignore
	FilePatterns []string
}