fileutil

Documentation

Index

• func DirFiles(dir string) ([]string, error)
• func DirsEqual(src, dst string) bool
• func ExpandPath(p string) (string, error)
• func FileExists(filename string) bool
• func HasDir(dirPath string) (bool, error)
• func HashDir(dir string) (string, error)
• func HomeDir() string
• func IpcEndpoint(ipcPath, datadir string) string
• func MkdirAll(dirPath string) error
• func ReadFileAsBytes(filename string) ([]byte, error)
• func RecursiveFileFind(filename, dir string) (bool, string, error)

Functions

func DirFiles

func DirFiles(dir string) ([]string, error)

DirFiles returns list of files found within a given directory and its sub-directories. Directory prefix will not be included as a part of returned file string i.e. for a file located in "dir/foo/bar" only "foo/bar" part will be returned.

func DirsEqual

func DirsEqual(src, dst string) bool

DirsEqual checks whether two directories have the same content.

func ExpandPath

func ExpandPath(p string) (string, error)

ExpandPath given a string which may be a relative path. 1. replace tilde with users home dir 2. expands embedded environment variables 3. cleans the path, e.g. /a/b/../c -> /a/c Note, it has limitations, e.g. ~someuser/tmp will not be expanded

func FileExists

func FileExists(filename string) bool

FileExists returns true if a file is not a directory and exists at the specified path.

func HasDir

func HasDir(dirPath string) (bool, error)

HasDir checks if a directory indeed exists at the specified path.

func HashDir

func HashDir(dir string) (string, error)

HashDir calculates and returns hash of directory: each file's hash is calculated and saved along with the file name into the list, after which list is hashed to produce the final signature. Implementation is based on https://github.com/golang/mod/blob/release-branch.go1.15/sumdb/dirhash/hash.go

func HomeDir

func HomeDir() string

HomeDir for a user.

func IpcEndpoint

func IpcEndpoint(ipcPath, datadir string) string

ipcEndpoint resolves an IPC endpoint based on a configured value, taking into account the set data folders as well as the designated platform we're currently running on.

func MkdirAll

func MkdirAll(dirPath string) error

MkdirAll takes in a path, expands it if necessary, and looks through the permissions of every directory along the path, ensuring we are not attempting to overwrite any existing permissions. Finally, creates the directory accordingly with standardized, Prysm project permissions. This is the static-analysis enforced method for creating a directory programmatically in Prysm.

func ReadFileAsBytes

func ReadFileAsBytes(filename string) ([]byte, error)

ReadFileAsBytes expands a file name's absolute path and reads it as bytes from disk.

func RecursiveFileFind

func RecursiveFileFind(filename, dir string) (bool, string, error)