dirwatch

README

dirwatch

For watching for changes inside a directory and all sub-directories, recursively. Uses the package fsnotify.

Documentation:

Sample Usage

notify := func(ev Event) {
	// processing the event ev
}

// create the watcher which excludes
// any folder along the added paths
// that matches provided pattern(s).
watcher := New(Notify(notify), Exclude("/*/*/node_modules"))
defer watcher.Stop()
watcher.Add(dir1, true)
watcher.Add(dir2, false)
watcher.Add(dir3, true)

Environment:

• Ubuntu 18.04
• Go 1.10.3

TODO:

• more tests

Documentation

Index

• type Event
• type Option
  • func Exclude(exclude ...string) Option
  • func Logger(logger func(args ...interface{})) Option
  • func Notify(notify func(Event)) Option
• type Watcher
  • func New(opt ...Option) *Watcher
  • func (dw *Watcher) Add(path string, recursive bool)
  • func (dw *Watcher) Stop()

Examples

• Watcher (Recursive)
• Watcher (Simple)
• Watcher (SimpleExclude)

Types

type Event

type Event struct {
	Name string
	Op   fsnotify.Op
}

Event represents a single file system notification.

type Option

type Option func(*options)

Option modifies the options.

func Exclude

func Exclude(exclude ...string) Option

Exclude sets patterns to exclude from watch.

func Logger

func Logger(logger func(args ...interface{})) Option

Logger sets the logger for the watcher.

func Notify

func Notify(notify func(Event)) Option

Notify sets the notify callback.

type Watcher

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

Watcher watches over a directory and it's sub-directories, recursively.

Example (Recursive)

Output:

4

Example (Simple)

Output:

text.txt

Example (SimpleExclude)

Output:

4

func New

func New(opt ...Option) *Watcher

New creates a new *Watcher. Excluded patterns are based on filepath.Match function patterns.

func (*Watcher) Add

func (dw *Watcher) Add(path string, recursive bool)

Add adds a path to be watched.

func (*Watcher) Stop

func (dw *Watcher) Stop()

Stop stops the watcher. Safe to be called mutiple times.