fileutil

README

fileutil

The package contains various helpers to interact with files

Documentation

Index

• Variables
• func CopyFile(src, dst string) error
• func CountLines(filename string) (uint, error)
• func CountLinesWithOptions(reader io.Reader, separator []byte, filter func([]byte) bool) (uint, error)
• func CountLinesWithSeparator(separator []byte, filename string) (uint, error)
• func CreateFolder(path string) error
• func CreateFolders(paths ...string) error
• func DeleteFilesOlderThan(folder string, filter FileFilters) error
• func DownloadFile(filepath string, url string) error
• func ExecutableName() string
• func FileExists(filename string) bool
• func FileOrFolderExists(name string) bool
• func FolderExists(foldername string) bool
• func GetTempFileName() (string, error)
• func HasPermission(fileName string, permission int) (bool, error)
• func HasStdin() bool
• func IsReadable(fileName string) (bool, error)
• func IsWriteable(fileName string) (bool, error)
• func Marshal(encodeType EncodeType, data []byte, obj interface{}) error
• func MarshalToWriter(encodeType EncodeType, r io.Writer, obj interface{}) error
• func ReadFile(filename string) (chan string, error)
• func ReadFileWithBufferSize(filename string, maxCapacity int) (chan string, error)
• func ReadFileWithReader(r io.Reader) (chan string, error)
• func ReadFileWithReaderAndBufferSize(r io.Reader, maxCapacity int) (chan string, error)
• func RemoveAll(paths ...string) (errored map[string]error)
• func Unmarshal(encodeType EncodeType, data []byte, obj interface{}) error
• func UnmarshalFromReader(encodeType EncodeType, r io.Reader, obj interface{}) error
• func UseMusl(path string) (bool, error)
• type EncodeType
• type FileFilters

Variables

var ErrInvalidSeparator = errors.New("invalid separator")

var IsNotEmpty = func(data []byte) bool {
	return len(data) > 0
}

IsNotEmpty determines if a data chunk is empty

var SkipEmptyLine = func(line []byte) bool {
	return len(line) > 0
}

Functions

func CopyFile

func CopyFile(src, dst string) error

CopyFile from source to destination

func CountLines

func CountLines(filename string) (uint, error)

CountLines counts the lines in a file

func CountLinesWithOptions

func CountLinesWithOptions(reader io.Reader, separator []byte, filter func([]byte) bool) (uint, error)

CountLinesWithOptions from a reader and custom filter function

func CountLinesWithSeparator

func CountLinesWithSeparator(separator []byte, filename string) (uint, error)

CountLinesWithSeparator of a file

func CreateFolder

func CreateFolder(path string) error

CreateFolder path

func CreateFolders

func CreateFolders(paths ...string) error

CreateFolders in the list

func DeleteFilesOlderThan

func DeleteFilesOlderThan(folder string, filter FileFilters) error

func DownloadFile

func DownloadFile(filepath string, url string) error

DownloadFile to specified path

func ExecutableName

func ExecutableName() string

func FileExists

func FileExists(filename string) bool

FileExists checks if the file exists in the provided path

func FileOrFolderExists

func FileOrFolderExists(name string) bool

FileOrFolderExists checks if the file/folder exists

func FolderExists

func FolderExists(foldername string) bool

FolderExists checks if the folder exists

func GetTempFileName

func GetTempFileName() (string, error)

GetTempFileName generate a temporary file name

func HasPermission

func HasPermission(fileName string, permission int) (bool, error)

HasPermission checks if the file has the requested permission

func HasStdin

func HasStdin() bool

HasStdin determines if the user has piped input

func IsReadable

func IsReadable(fileName string) (bool, error)

IsReadable verify file readability

func IsWriteable

func IsWriteable(fileName string) (bool, error)

IsWriteable verify file writeability

func Marshal

func Marshal(encodeType EncodeType, data []byte, obj interface{}) error

func MarshalToWriter

func MarshalToWriter(encodeType EncodeType, r io.Writer, obj interface{}) error

func ReadFile

func ReadFile(filename string) (chan string, error)

ReadFile with filename

func ReadFileWithBufferSize

func ReadFileWithBufferSize(filename string, maxCapacity int) (chan string, error)

ReadFile with filename and specific buffer size

func ReadFileWithReader

func ReadFileWithReader(r io.Reader) (chan string, error)

ReadFileWithReader and stream on a channel

func ReadFileWithReaderAndBufferSize

func ReadFileWithReaderAndBufferSize(r io.Reader, maxCapacity int) (chan string, error)

ReadFileWithReader with specific buffer size and stream on a channel

func RemoveAll

func RemoveAll(paths ...string) (errored map[string]error)

RemoveAll specified paths, returning those that caused error

func Unmarshal

func Unmarshal(encodeType EncodeType, data []byte, obj interface{}) error

func UnmarshalFromReader

func UnmarshalFromReader(encodeType EncodeType, r io.Reader, obj interface{}) error

func UseMusl

func UseMusl(path string) (bool, error)

UseMusl checks if the specified elf file uses musl

Types

type EncodeType

type EncodeType uint8

const (
	YAML EncodeType = iota
	JSON
)

type FileFilters

type FileFilters struct {
	OlderThan    time.Duration
	Prefix       string
	Suffix       string
	RegexPattern string
	CustomCheck  func(filename string) bool
	Callback     func(filename string) error
}