commit | ea925a0a47d225b2ca7f9932b01d2ed4f3ec74f6 | [log] [tgz] |
---|---|---|
author | Nathan Youngman <git@nathany.com> | Wed Dec 31 20:16:54 2014 -0700 |
committer | Nathan Youngman <git@nathany.com> | Wed Dec 31 20:22:27 2014 -0700 |
tree | e1484d0bf001312975e6f1b72e42e00c46e58855 | |
parent | 81f73985c1753fb9e1ee756d3c4199440c6ef030 [diff] |
update readme on v0 branch
This branch contains fsnotify.v0 which is API-compatible with howeyc/fsnotify. Bugfixes may be backported, but I recommend upgrading.
Cross platform: Windows, Linux, BSD and OS X.
package main import ( "log" "gopkg.in/fsnotify.v0" ) 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:
When a file is moved 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 (a recursive watcher is in the works #56).
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 (see #7)
Why am I receiving multiple events for the same file on OS X?
Spotlight indexing on OS X can result in multiple events (see #62). A temporary workaround is to add your folder(s) to the Spotlight Privacy settings until we have a native FSEvents implementation (see #54).
How many files can be watched at once?
There are OS-specific limits as to how many watches can be created: