fileutil

Documentation

Overview

Package fileutil contains utilities for working with the file system.

Package fileutil contains utilities for working with the file system.

Package fileutil contains utilities for working with the file system.

Index

• Constants
• func DeleteFile(filepath string) (err error)
• func Exists(filePath string) bool
• func Harden(path string) (err error)
• func HardenDataFolder() error
• func HardenedWriteFile(filename string, data []byte) (err error)
• func IsDirEmpty(location string) (bool, error)
• func IsDirectory(srcPath string) bool
• func IsFile(srcPath string) bool
• func LocalFileExist(path string) (bool, error)
• func MakeDirs(destinationDir string) (err error)
• func MakeDirsWithExecuteAccess(destinationDir string) (err error)
• func MoveFile(filename, srcPath, dstPath string) (result bool, err error)
• func ReadAllText(filePath string) (text string, err error)
• func RecursivelyHarden(path string) error
• func RemoveInvalidChars(filePath string) string
• func Uncompress(src, dest string) error
• func WriteAllText(filePath string, text string) (err error)
• func WriteIntoFileWithPermissions(absolutePath, content string, perm os.FileMode) (result bool, err error)
• type DiskSpaceInfo
  • func GetDiskSpaceInfo() (diskSpaceInfo DiskSpaceInfo, err error)

Examples

• Exists
• IsDirEmpty
• IsDirectory
• IsFile
• LocalFileExist
• ReadAllText
• RemoveInvalidChars

Constants

const (
	RWPermission = 0600
)

Functions

func DeleteFile

func DeleteFile(filepath string) (err error)

DeleteFile deletes the specified file

func Exists

func Exists(filePath string) bool

Exists returns true if the given file exists, false otherwise, ignoring any underlying error

Example

path := filepath.Join("artifact", "testdata", "CheckMyHash.txt")
content := Exists(path)
fmt.Println(content)

Output:

true

func Harden

func Harden(path string) (err error)

Harden the provided path with non-inheriting ACL for admin access only.

func HardenDataFolder

func HardenDataFolder() error

HardenDataFolder sets permission of %PROGRAM_DATA% folder for Windows. In Linux, each components handles the permission of its data.

func HardenedWriteFile

func HardenedWriteFile(filename string, data []byte) (err error)

HardenedWriteFile calls ioutil.WriteFile and guarantees a hardened permission control. If the file already exists, it hardens the permissions before writing data to it.

func IsDirEmpty

func IsDirEmpty(location string) (bool, error)

IsDirEmpty returns true if the given directory is empty else it returns false

Example

path := filepath.Join("artifact", "testdata")
content, err := IsDirEmpty(path)
if err != nil {
	log.Fatalf("error: %v", err)
}
fmt.Println(content)

Output:

false

func IsDirectory

func IsDirectory(srcPath string) bool

IsDirectory returns true or false depending if given srcPath is directory or not

Example

path := filepath.Join("artifact", "testdata", "CheckMyHash.txt")
content := IsDirectory(path)
fmt.Println(content)

Output:

false

func IsFile

func IsFile(srcPath string) bool

IsFile returns true or false depending if given srcPath is a regular file or not

Example

path := filepath.Join("artifact", "testdata", "CheckMyHash.txt")
content := IsFile(path)
fmt.Println(content)

Output:

true

func LocalFileExist

func LocalFileExist(path string) (bool, error)

LocalFileExist returns true if the given file exists, false otherwise.

Example

// file exists
path := filepath.Join("artifact", "testdata", "CheckMyHash.txt")
content, err := LocalFileExist(path)
if err != nil {
	log.Fatalf("error: %v", err)
}
fmt.Println(content)

// file does not exist
path = filepath.Join("testdata", "blah")
content, err = LocalFileExist(path)
if err != nil {
	log.Fatalf("error: %v", err)
}
fmt.Println(content)

Output:

true
false

func MakeDirs

func MakeDirs(destinationDir string) (err error)

MakeDirs create the directories along the path if missing.

func MakeDirsWithExecuteAccess

func MakeDirsWithExecuteAccess(destinationDir string) (err error)

MakeDirsWithExecuteAccess create the directories along the path if missing.

func MoveFile

func MoveFile(filename, srcPath, dstPath string) (result bool, err error)

MoveFile moves file from srcPath directory to dstPath directory only if both directories exist

func ReadAllText

func ReadAllText(filePath string) (text string, err error)

ReadAllText reads all content from the specified file

Example

// valid file
path := filepath.Join("artifact", "testdata", "CheckMyHash.txt")
content, err := ReadAllText(path)
if err != nil {
	log.Fatalf("error: %v", err)
}
fmt.Println(content)

// invalid file
path = filepath.Join("testdata", "invalid.txt")
content, err = ReadAllText(path)
if err != nil {
	log.Fatalf("error: %v", err)
}
fmt.Println(content)

Output:

Will you please check my hash?
Will you please check my hash?
Will you please check my hash?

func RecursivelyHarden

func RecursivelyHarden(path string) error

RecursivelyHarden the files and directory under the specified path.

func RemoveInvalidChars

func RemoveInvalidChars(filePath string) string

RemoveInvalidChars strips any invalid characters from filepath

Example

// Path with invalid char
path1 := "Fix:ThisPath"
content1 := RemoveInvalidChars(path1)
fmt.Println(content1)

// path with no invalid char
path2 := "DoNotFixThisPath"
content2 := RemoveInvalidChars(path2)
fmt.Println(content2)

// empty path should not return error
path3 := ""
content3 := RemoveInvalidChars(path3)
fmt.Println(content3)

Output:

FixThisPath
DoNotFixThisPath

func Uncompress

func Uncompress(src, dest string) error

Uncompress untar the installation package

func WriteAllText

func WriteAllText(filePath string, text string) (err error)

WriteAllText writes all text content to the specified file

func WriteIntoFileWithPermissions

func WriteIntoFileWithPermissions(absolutePath, content string, perm os.FileMode) (result bool, err error)

WriteIntoFileWithPermissions writes into file with given file mode permissions

Types

type DiskSpaceInfo

type DiskSpaceInfo struct {
	AvailBytes int64
	FreeBytes  int64
	TotalBytes int64
}

DiskSpaceInfo stores the available, free, and total bytes

func GetDiskSpaceInfo

func GetDiskSpaceInfo() (diskSpaceInfo DiskSpaceInfo, err error)

GetDiskSpaceInfo returns DiskSpaceInfo with available, free, and total bytes from system disk space