package filesystem

import "go.chromium.org/luci/common/system/filesystem"

Index ¶

• func AbsPath(base *string) error
• func CopyRecursively(src, dst string) error
• func CreateDirectories(baseDirectory string, files []string) error
• func IsNotExist(err error) bool
• func MakeDirs(path string) error
• func MakePathUserWritable(path string, fi os.FileInfo) error
• func MakeReadOnly(path string, filter func(string) bool) error
• func MakeTreeFilesReadOnly(ctx context.Context, root string) error
• func MakeTreeReadOnly(ctx context.Context, root string) error
• func MakeTreeWritable(ctx context.Context, root string) error
• func ReadableCopy(outfile, infile string) error
• func RemoveAll(path string) error
• func SetReadOnly(path string, readOnly bool) error
• func Touch(path string, when time.Time, mode os.FileMode) error
• type TempDir
• func (td *TempDir) With(fn func(string) error) error

Package Files ¶

filepath.go filesystem.go filesystem_unix.go tempdir.go

func AbsPath ¶ Uses

func AbsPath(base *string) error

AbsPath is a convenience wrapper around filepath.Abs that accepts a string pointer, base, and updates it on successful resolution.

func CopyRecursively ¶ Uses

func CopyRecursively(src, dst string) error

CopyRecursively efficiently copies a file or directory from src to dst.

`src` may be a file, directory, or a symlink to a file or directory. All symlinks are replaced with their targets, so the resulting directory structure in `dst` will never have any symlinks.

To increase speed, CopyRecursively hardlinks individual files into the (newly created) directory structure if possible.

func CreateDirectories ¶ Uses

func CreateDirectories(baseDirectory string, files []string) error

CreateDirectories creates the directory structure needed by the given list of files.

func IsNotExist ¶ Uses

func IsNotExist(err error) bool

IsNotExist calls os.IsNotExist on the unwrapped err.

func MakeDirs ¶ Uses

func MakeDirs(path string) error

MakeDirs is a convenience wrapper around os.MkdirAll that applies a 0755 mask to all created directories.

func MakePathUserWritable ¶ Uses

func MakePathUserWritable(path string, fi os.FileInfo) error

MakePathUserWritable updates the filesystem metadata on a single file or directory to make it user-writable.

fi is optional. If nil, os.Stat will be called on path. Otherwise, fi will be regarded as the results of calling os.Stat on path. This is provided as an optimization, since some filesystem operations automatically yield a FileInfo.

func MakeReadOnly ¶ Uses

func MakeReadOnly(path string, filter func(string) bool) error

MakeReadOnly recursively iterates through all of the files and directories starting at path and marks them read-only.

func MakeTreeFilesReadOnly ¶ Uses

func MakeTreeFilesReadOnly(ctx context.Context, root string) error

MakeTreeFilesReadOnly makes all the files in the directories read only but not the directories themselves. This means files can be created or deleted.

func MakeTreeReadOnly ¶ Uses

func MakeTreeReadOnly(ctx context.Context, root string) error

MakeTreeReadOnly makes all the files in the directories read only. Also makes the directories read only, only if it makes sense on the platform. This means no file can be created or deleted.

func MakeTreeWritable ¶ Uses

func MakeTreeWritable(ctx context.Context, root string) error

MakeTreeWritable makes all the files in the directories writeable. Also makes the directories writeable, only if it makes sense on the platform.

func ReadableCopy ¶ Uses

func ReadableCopy(outfile, infile string) error

ReadableCopy makes a copy of the file that is readable by everyone.

func RemoveAll ¶ Uses

func RemoveAll(path string) error

RemoveAll is a fork of os.RemoveAll that attempts to deal with read only files and directories by modifying permissions as necessary.

If the specified path does not exist, RemoveAll will return nil.

Note that RemoveAll will not modify permissions on parent directory of the provided path, even if it is read only and preventing deletion of the path on POSIX system.

Copied from https://go.googlesource.com/go/+/b86e76681366447798c94abb959bb60875bcc856/src/os/path.go#63

func SetReadOnly ¶ Uses

func SetReadOnly(path string, readOnly bool) error

SetReadOnly sets or resets the write bit on a file or directory. Zaps out access to 'group' and 'others'.

func Touch ¶ Uses

func Touch(path string, when time.Time, mode os.FileMode) error

Touch creates a new, empty file at the specified path.

If when is zero-value, time.Now will be used.

type TempDir ¶ Uses

type TempDir struct {
    // Dir is the base diectory. If empty, the default will be used (see
    // ioutil.TempDir)
    Dir string

    // Prefix is the prefix to apply to the temporary directory. If empty, a
    // default will be used (see ioutil.TempDir).
    Prefix string

    // OnCleanupErr, if not nil, will be called if TempDir cleanup fails.
    //
    // If nil, cleanup errors will be silently discarded.
    CleanupErrFunc func(tdir string, err error)
}

TempDir configures a temporary directory.

func (*TempDir) With ¶ Uses

func (td *TempDir) With(fn func(string) error) error

With creates a temporary directory and passes it to fn. After fn exits, the directory and all of its contents is deleted.

Any error that happens during setup or execution of the callback is returned. If an error occurs during cleanup, the optional CleanupErrFunc will be called.