osutil

Documentation

Overview

Package osutil implements some OS utility functions.

Package osutil implements some OS utility functions.

Index

• func AbsFilepath(path string) (string, error)
• func CreateFileWithLines(filename string, lines []string, lineSuffix string, useBuffer bool) error
• func EmptyAll(name string) error
• func EnvExists(fields ...string) (missing []string, haveAll bool)
• func EnvFiltered(rx *regexp.Regexp) map[string]string
• func Exists(name string) (bool, error)
• func FileModAge(name string) (time.Duration, error)
• func FileModAgeFromInfo(fi os.FileInfo) time.Duration
• func FinfosToFilepaths(dir string, fis []os.FileInfo) []string
• func GetFileInfo(path string) (os.FileInfo, error)
• func IsDir(name string) (bool, error)
• func IsFile(name string) (bool, error)
• func IsFileWithSizeGtZero(name string) (bool, error)
• func ReadDirMore(dir string, rx *regexp.Regexp, inclDirs, inclFiles, inclEmptyFiles bool) ([]os.DirEntry, error)
• func ReadDirRxSubmatch(dir string, rx *regexp.Regexp, subMatchIdx uint, ...) (map[string][]os.DirEntry, error)
• func ReadDirRxSubmatchCaptureGreatest(dir string, rx *regexp.Regexp, subMatchIdx uint, ...) (string, error)
• func ReadDirRxSubmatchCaptures(dir string, rx *regexp.Regexp, subMatchIdx uint, ...) ([]string, error)
• func ReadDirRxSubmatchEntriesGreatest(dir string, rx *regexp.Regexp, subMatchIdx uint, ...) ([]os.DirEntry, error)
• func ReadSubdirMax(dir string, rx *regexp.Regexp) (os.DirEntry, error)
• func ReadSubdirMin(dir string, rx *regexp.Regexp) (os.DirEntry, error)
• func UserGoSrcDir() (string, error)
• type DirEntrySlice
  • func (slice DirEntrySlice) Infos() ([]os.FileInfo, error)
  • func (slice DirEntrySlice) Len() int
  • func (slice DirEntrySlice) Less(i, j int) bool
  • func (slice DirEntrySlice) Names(dir string, sortNames bool) []string
  • func (slice DirEntrySlice) Sort()
  • func (slice DirEntrySlice) Swap(i, j int)
• type EnvVar
  • func Env() []EnvVar
• type FileInfoMore
  • func NewFileInfoMoreFromPath(path string) (FileInfoMore, error)

Functions

func AbsFilepath

func AbsFilepath(path string) (string, error)

AbsFilepath returns an absolute filepath, using the user's current / home directory if indicated in the filepath string.

func CreateFileWithLines

func CreateFileWithLines(filename string, lines []string, lineSuffix string, useBuffer bool) error

CreateFileWithLines creates a file and writes lines to it. It will optionally add a `lineSuffix` (e.g. `"\n"`) and use `bufio`.

func EmptyAll

func EmptyAll(name string) error

EmptyAll will delete all contents of a directory, leaving the provided directory. This is different from os.Remove which also removes the directory provided.

func EnvExists

func EnvExists(fields ...string) (missing []string, haveAll bool)

func EnvFiltered

func EnvFiltered(rx *regexp.Regexp) map[string]string

EnvFiltered returns a map[string]string of environment variables that match a regular expression.

func Exists

func Exists(name string) (bool, error)

Exists checks whether the named filepath exists or not for a file or directory.

func FileModAge

func FileModAge(name string) (time.Duration, error)

FileModAge returns a time.Duration representing the age of the named file from FileInfo.ModTime().

func FileModAgeFromInfo

func FileModAgeFromInfo(fi os.FileInfo) time.Duration

FileModAgeFromInfo returns the file last modification age as a time.Duration.

func FinfosToFilepaths

func FinfosToFilepaths(dir string, fis []os.FileInfo) []string

FinfosToFilepaths returns a slice of string from a directory and sli=ce of `os.FileInfo`.

func GetFileInfo

func GetFileInfo(path string) (os.FileInfo, error)

GetFileInfo returns an os.FileInfo from a filepath.

func IsDir

func IsDir(name string) (bool, error)

func IsFile

func IsFile(name string) (bool, error)

func IsFileWithSizeGtZero

func IsFileWithSizeGtZero(name string) (bool, error)

IsFileWithSizeGtZero verifies a path exists, is a file and is not empty, returning an error otherwise. An os file not exists check can be done with os.IsNotExist(err) which acts on error from os.Stat()

func ReadDirMore

func ReadDirMore(dir string, rx *regexp.Regexp, inclDirs, inclFiles, inclEmptyFiles bool) ([]os.DirEntry, error)

func ReadDirRxSubmatch

func ReadDirRxSubmatch(dir string, rx *regexp.Regexp, subMatchIdx uint, inclDirs, inclFiles, inclEmptyFiles bool) (map[string][]os.DirEntry, error)

ReadDirRxSubmatch takes a directory, regular expression and boolean to indicate whether to include zero size files and returns the greatest of a single match in the regular expression.

func ReadDirRxSubmatchCaptureGreatest

func ReadDirRxSubmatchCaptureGreatest(dir string, rx *regexp.Regexp, subMatchIdx uint, inclDirs, inclFiles, inclEmptyFiles bool) (string, error)

ReadDirRxSubmatchCaptureGreatest takes a directory, regular expression and returns the greatest of a single submatch in the regular expression.

func ReadDirRxSubmatchCaptures

func ReadDirRxSubmatchCaptures(dir string, rx *regexp.Regexp, subMatchIdx uint, inclDirs, inclFiles, inclEmptyFiles bool) ([]string, error)

ReadDirRxSubmatchCaptures takes a directory, regular expression and returns the greatest of captures from the regular expression.

func ReadDirRxSubmatchEntriesGreatest

func ReadDirRxSubmatchEntriesGreatest(dir string, rx *regexp.Regexp, subMatchIdx uint, inclDirs, inclFiles, inclEmptyFiles bool) ([]os.DirEntry, error)

func ReadSubdirMax

func ReadSubdirMax(dir string, rx *regexp.Regexp) (os.DirEntry, error)

func ReadSubdirMin

func ReadSubdirMin(dir string, rx *regexp.Regexp) (os.DirEntry, error)

func UserGoSrcDir

func UserGoSrcDir() (string, error)

Types

type DirEntrySlice

type DirEntrySlice []os.DirEntry

func (DirEntrySlice) Infos

func (slice DirEntrySlice) Infos() ([]os.FileInfo, error)

Infos returns a `[]os.FileInfo` slice.

func (DirEntrySlice) Len

func (slice DirEntrySlice) Len() int

func (DirEntrySlice) Less

func (slice DirEntrySlice) Less(i, j int) bool

func (DirEntrySlice) Names

func (slice DirEntrySlice) Names(dir string, sortNames bool) []string

func (DirEntrySlice) Sort

func (slice DirEntrySlice) Sort()

func (DirEntrySlice) Swap

func (slice DirEntrySlice) Swap(i, j int)

type EnvVar

type EnvVar struct {
	Key   string
	Value string
}

func Env

func Env() []EnvVar

type FileInfoMore

type FileInfoMore struct {
	FileInfo os.FileInfo
	ModAge   time.Duration
}

FileInfoMore provides a struct hold FileInfo with additional information.

func NewFileInfoMoreFromPath

func NewFileInfoMoreFromPath(path string) (FileInfoMore, error)

NewFileInfoMoreFromPath returns a FileInfoMore struct populatig both FileInfo and ModAge (last modification time).