Merge pull request #37 from otiai10/develop

Add "OnDirExists" option
tree: 070c214b9ced606b3305c77cd7e18a787db5d309
  1. .github/
  2. .gitignore
  5. all_test.go
  6. copy.go
  7. example_test.go
  8. go.mod
  9. go.sum
  10. options.go
  11. stat_times.go
  12. stat_times_darwin.go
  13. stat_times_freebsd.go
  14. stat_times_windows.go
  15. testdata/


Go Reference Actions Status codecov License: MIT Go Report Card GitHub tag (latest SemVer)

copy copies directories recursively.

Example Usage

err := Copy("your/directory", "your/directory.copy")

Advanced Usage

// Options specifies optional actions on copying.
type Options struct {

	// OnSymlink can specify what to do on symlink
	OnSymlink func(src string) SymlinkAction

	// OnDirExists can specify what to do when there is a directory already existing in destination.
	OnDirExists func(src, dest string) DirExistsAction

	// Skip can specify which files should be skipped
	Skip func(src string) (bool, error)

	// AddPermission to every entities,
	// NO MORE THAN 0777
	AddPermission os.FileMode

	// Sync file after copy.
	// Useful in case when file must be on the disk
	// (in case crash happens, for example),
	// at the expense of some performance penalty
	Sync bool

	// Preserve the atime and the mtime of the entries
	// On linux we can preserve only up to 1 millisecond accuracy
	PreserveTimes bool

// For example...
opt := Options{
	Skip: func(src string) {
		return strings.HasSuffix(src, ".git")
err := Copy("your/directory", "your/directory.copy", opt)