commit	b38d2daf53a0262773f11e1d797e9946bb5c02f8	[log] [tgz]
author	debrando <denis.brandolini@gmail.com>	Thu Oct 10 16:25:22 2013 +0200
committer	debrando <denis.brandolini@gmail.com>	Thu Oct 10 16:25:22 2013 +0200
tree	c571924afbc1d359620e34124f96f0b4ab6e4fb1
parent	08040c5a90632bd721465eb8ad74a8e61bd7bf95 [diff]

tree: c571924afbc1d359620e34124f96f0b4ab6e4fb1

README.md

File system notifications for Go

Cross platform, works on:

Windows
Linux
BSD
OSX

Example:

package main

import (
	"log"

	"github.com/howeyc/fsnotify"
)

func main() {
	watcher, err := fsnotify.NewWatcher()
	if err != nil {
		log.Fatal(err)
	}

	done := make(chan bool)

	// Process events
	go func() {
		for {
			select {
			case ev := <-watcher.Event:
				log.Println("event:", ev)
			case err := <-watcher.Error:
				log.Println("error:", err)
			}
		}
	}()

	err = watcher.Watch("testDir")
	if err != nil {
		log.Fatal(err)
	}

	<-done

	/* ... do stuff ... */
	watcher.Close()
}

For each event:

Name
IsCreate()
IsDelete()
IsModify()
IsRename()

Notes:

When a file is renamed to another directory is it still being watched?
- No (it shouldn't be, unless you are watching where it was moved to).
When I watch a directory, are all subdirectories watched as well?
- No, you must add watches for any directory you want to watch.
Do I have to watch the Error and Event channels in a separate goroutine?
- As of now, yes. Looking into making this single-thread friendly.
How avoid the criptic error “no space left on device” when adding watches?
- Probably you‘re out of inotify’s watches; verify your max with “cat /proc/sys/fs/inotify/max_user_watches”.