fs

Documentation

Index

• func CopyDir(src, dst string) error
• func EquivalentPaths(p1, p2 string) (bool, error)
• func HasFilepathPrefix(path, prefix string) (bool, error)
• func IsDir(name string) (bool, error)
• func IsNonEmptyDir(name string) (bool, error)
• func IsRegular(name string) (bool, error)
• func IsSymlink(path string) (bool, error)
• func RenameWithFallback(src, dst string) error

Functions

func CopyDir

func CopyDir(src, dst string) error

CopyDir recursively copies a directory tree, attempting to preserve permissions. Source directory must exist, destination directory must *not* exist.

func EquivalentPaths

func EquivalentPaths(p1, p2 string) (bool, error)

EquivalentPaths compares the paths passed to check if they are equivalent. It respects the case-sensitivity of the underlying filesysyems.

func HasFilepathPrefix

func HasFilepathPrefix(path, prefix string) (bool, error)

HasFilepathPrefix will determine if "path" starts with "prefix" from the point of view of a filesystem.

Unlike filepath.HasPrefix, this function is path-aware, meaning that it knows that two directories /foo and /foobar are not the same thing, and therefore HasFilepathPrefix("/foobar", "/foo") will return false.

This function also handles the case where the involved filesystems are case-insensitive, meaning /foo/bar and /Foo/Bar correspond to the same file. In that situation HasFilepathPrefix("/Foo/Bar", "/foo") will return true. The implementation is *not* OS-specific, so a FAT32 filesystem mounted on Linux will be handled correctly.

func IsDir

func IsDir(name string) (bool, error)

IsDir determines is the path given is a directory or not.

func IsNonEmptyDir

func IsNonEmptyDir(name string) (bool, error)

IsNonEmptyDir determines if the path given is a non-empty directory or not.

func IsRegular

func IsRegular(name string) (bool, error)

IsRegular determines if the path given is a regular file or not.

func IsSymlink

func IsSymlink(path string) (bool, error)

IsSymlink determines if the given path is a symbolic link.

func RenameWithFallback

func RenameWithFallback(src, dst string) error

RenameWithFallback attempts to rename a file or directory, but falls back to copying in the event of a cross-device link error. If the fallback copy succeeds, src is still removed, emulating normal rename behavior.