v1.3.1
2 files changed
tree: bae27a03329ec28da7dd75b2b54783dde30bdf45
  1. .gitignore
  2. .travis.yml
  3. AUTHORS
  4. CHANGELOG.md
  5. CONTRIBUTING.md
  6. LICENSE
  7. README.md
  8. example_test.go
  9. fen.go
  10. fsnotify.go
  11. inotify.go
  12. inotify_poller.go
  13. inotify_poller_test.go
  14. inotify_test.go
  15. integration_darwin_test.go
  16. integration_test.go
  17. kqueue.go
  18. open_mode_bsd.go
  19. open_mode_darwin.go
  20. windows.go
README.md

File system notifications for Go

GoDoc Go Report Card Coverage

fsnotify utilizes golang.org/x/sys rather than syscall from the standard library. Ensure you have the latest version installed by running:

go get -u golang.org/x/sys/...

Cross platform: Windows, Linux, BSD and OS X.

AdapterOSStatus
inotifyLinux 2.6.27 or later, Android*Supported Build Status
kqueueBSD, OS X, iOS*Supported Build Status
ReadDirectoryChangesWWindowsSupported Build status
FSEventsOS XPlanned
FENSolaris 11In Progress
fanotifyLinux 2.6.37+
USN JournalsWindowsMaybe
PollingAllMaybe

* Android and iOS are untested.

Please see the documentation for usage. Consult the Wiki for the FAQ and further information.

API stability

fsnotify is a fork of howeyc/fsnotify with a new API as of v1.0. The API is based on this design document.

All releases are tagged based on Semantic Versioning. Further API changes are planned, and will be tagged with a new major revision number.

Go 1.6 supports dependencies located in the vendor/ folder. Unless you are creating a library, it is recommended that you copy fsnotify into vendor/github.com/fsnotify/fsnotify within your project, and likewise for golang.org/x/sys.

Contributing

Please refer to CONTRIBUTING before opening an issue or pull request.

Example

See example_test.go.

Related Projects