target

Documentation

Index

• func Dir(dst string, sources ...string) (bool, error)
• func Glob(dst string, globs ...string) (bool, error)
• func Path(dst string, sources ...string) (bool, error)

Functions

func Dir

func Dir(dst string, sources ...string) (bool, error)

Dir reports whether any of the sources have been modified more recently than the destination. If a source or destination is a directory, modtimes of files under those directories are compared instead. If the destination file doesn't exist, it always returns true and nil. It's an error if any of the sources don't exist.

func Glob

func Glob(dst string, globs ...string) (bool, error)

Glob expands each of the globs (file patterns) into individual sources and then calls Path on the result, reporting if any of the resulting sources have been modified more recently than the destination. Syntax for Glob patterns is the same as stdlib's filepath.Glob. Note that Glob does not expand environment variables before globbing -- env var expansion happens during the call to Path. It is an error for any glob to return an empty result.

func Path

func Path(dst string, sources ...string) (bool, error)

Path first expands environment variables like $FOO or ${FOO}, and then reports if any of the sources have been modified more recently than the destination. Path does not descend into directories, it literally just checks the modtime of each thing you pass to it. If the destination file doesn't exist, it always returns true and nil. It's an error if any of the sources don't exist.