Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

watch

package

Go to main page

Versions in this module

v5

v5.1.0

Feb 24, 2026

v5.0.2

Jan 20, 2026

v5.0.1

Dec 18, 2025

v5.0.0

Dec 2, 2025

Changes in this version

+ const QuietPeriod

+ const WindowsBufferSizeEnvVar

+ func BatchDebounceEvents(ctx context.Context, clock clockwork.Clock, input <-chan FileEvent) <-chan []FileEvent

+ func DesiredWindowsBufferSize() int

+ func DockerIgnoreTesterFromContents(repoRoot string, contents string) (*dockerPathMatcher, error)

+ func MaybeIncreaseBufferSize(w *fsnotify.Watcher)

+ func NewDockerPatternMatcher(repoRoot string, patterns []string) (*dockerPathMatcher, error)

+ func SanitizeFileName(name string) string

+ type AnyMatcher struct

+ func (AnyMatcher) Matches(f string) (bool, error)

+ func (AnyMatcher) MatchesEntireDir(f string) (bool, error)

+ type CompositePathMatcher struct

+ Matchers []PathMatcher

+ func (c CompositePathMatcher) Matches(f string) (bool, error)

+ func (c CompositePathMatcher) MatchesEntireDir(f string) (bool, error)

+ type EmptyMatcher struct

+ func (EmptyMatcher) Matches(f string) (bool, error)

+ func (EmptyMatcher) MatchesEntireDir(f string) (bool, error)

+ type FileEvent string

+ func NewFileEvent(p string) FileEvent

+ type Notify interface

+ Close func() error

+ Errors func() chan error

+ Events func() chan FileEvent

+ Start func() error

+ func NewWatcher(paths []string) (Notify, error)

+ type PathMatcher interface

+ Matches func(file string) (bool, error)

+ MatchesEntireDir func(file string) (bool, error)

+ func EphemeralPathMatcher() PathMatcher

+ func LoadDockerIgnore(build *types.BuildConfig) (PathMatcher, error)

+ func NewCompositeMatcher(matchers ...PathMatcher) PathMatcher

+ type TempDir struct

+ func NewDir(prefix string) (*TempDir, error)

+ func NewDirAtRoot(root, prefix string) (*TempDir, error)

+ func NewDirAtSlashTmp(prefix string) (*TempDir, error)

+ func (d *TempDir) NewDeterministicDir(name string) (*TempDir, error)

+ func (d *TempDir) NewDir(prefix string) (*TempDir, error)

+ func (d *TempDir) Path() string

+ func (d *TempDir) TearDown() error

+ type TempDirFixture struct

+ func NewTempDirFixture(t testing.TB) *TempDirFixture

+ func (f *TempDirFixture) Chdir()

+ func (f *TempDirFixture) CopyFile(originalPath, newPath string)

+ func (f *TempDirFixture) JoinPath(path ...string) string

+ func (f *TempDirFixture) JoinPaths(paths []string) []string

+ func (f *TempDirFixture) MkdirAll(path string)

+ func (f *TempDirFixture) NewFile(prefix string) (*os.File, error)

+ func (f *TempDirFixture) Path() string

+ func (f *TempDirFixture) ReadFile(path string) string

+ func (f *TempDirFixture) Rm(pathInRepo string)

+ func (f *TempDirFixture) T() testing.TB

+ func (f *TempDirFixture) TempDir(prefix string) string

+ func (f *TempDirFixture) TouchFiles(paths []string)

+ func (f *TempDirFixture) WriteFile(path string, contents string) string

+ func (f *TempDirFixture) WriteSymlink(linkContents, destPath string)

v5.0.0-rc.2

Nov 13, 2025

Other modules containing this package

github.com/docker/compose/v2