file

Documentation

Overview

Package file handles simple file related tools for ease of use

Index

• Constants
• Variables
• func AppendToAsciiFile(filename, value string) error
• func AsciiFileToLines(filename string) []string
• func AsciiFileToString(fileName string) string
• func CleanFolder(chain, rootFolder string, subFolders []string) error
• func Copy(destPath, sourcePath string) (int64, error)
• func EarliestFileInFolder(path string) (string, error)
• func Empty(file *os.File) (err error)
• func EstablishFolder(rootPath string) error
• func EstablishFolders(rootPath string, folders []string) error
• func FileExists(filename string) bool
• func FileSize(filename string) int64
• func FolderExists(path string) bool
• func GetNewestInDirectory(directory string) (fileInfo os.FileInfo, err error)
• func IsFolderEmpty(folder string) (bool, error)
• func IsLaterThan(fn1, fn2 string) (bool, error)
• func IsTestMode() bool
• func LatestFileInFolder(path string) (string, error)
• func LinesToAsciiFile(filename string, value []string) error
• func Lock(file *os.File) error
• func MakeBackup(tmpPath, origFn string) (string, error)
• func NFilesInFolder(path string) int
• func Remove(fileName string) bool
• func RunWithFileSupport(mode string, run func(cmd *cobra.Command, args []string) error, ...) func(cmd *cobra.Command, args []string) error
• func StringToAsciiFile(filename, value string) error
• func Touch(filename string) bool
• func Unlock(file *os.File) error
• func WaitOnLock(filePath string, openFlags int) (file *os.File, err error)
• func WordCount(fileName string, ignoreHeader bool) (int, error)
• type CommandFileLine
• type CommandsFile
  • func ParseCommandsFile(cmd *cobra.Command, filePath string) (cf CommandsFile, err error)

Constants

const (
	// MagicNumber is used to check data validity
	MagicNumber      = 0xdeadbeef
	SmallMagicNumber = uint16(0xdead)
)

Variables

var DefaultOpenFlags = os.O_RDWR | os.O_CREATE

var DefaultOpenFlagsAppend = os.O_RDWR | os.O_CREATE | os.O_APPEND

Functions

func AppendToAsciiFile

func AppendToAsciiFile(filename, value string) error

func AsciiFileToLines

func AsciiFileToLines(filename string) []string

func AsciiFileToString

func AsciiFileToString(fileName string) string

func CleanFolder

func CleanFolder(chain, rootFolder string, subFolders []string) error

CleanFolder removes any files that may be partial or incomplete

func Copy

func Copy(destPath, sourcePath string) (int64, error)

func EarliestFileInFolder

func EarliestFileInFolder(path string) (string, error)

EarliestFileInFolder returns the latest (alphabetically) file in the folder

func Empty

func Empty(file *os.File) (err error)

Empty is a shortcut function to seek to the beginning of a file and truncate it to 0. It does not call file.Sync though, making all operations in-memory only.

func EstablishFolder

func EstablishFolder(rootPath string) error

EstablishFolder creates folders given a list of folders

func EstablishFolders

func EstablishFolders(rootPath string, folders []string) error

EstablishFolders creates the rootPath and any subfolders

func FileExists

func FileExists(filename string) bool

func FileSize

func FileSize(filename string) int64

func FolderExists

func FolderExists(path string) bool

func GetNewestInDirectory

func GetNewestInDirectory(directory string) (fileInfo os.FileInfo, err error)

func IsFolderEmpty

func IsFolderEmpty(folder string) (bool, error)

func IsLaterThan

func IsLaterThan(fn1, fn2 string) (bool, error)

func IsTestMode

func IsTestMode() bool

func LatestFileInFolder

func LatestFileInFolder(path string) (string, error)

LatestFileInFolder returns the latest (alphabetically) file in the folder

func LinesToAsciiFile

func LinesToAsciiFile(filename string, value []string) error

func Lock

func Lock(file *os.File) error

Lock asks the OS to lock a file for the current process

func MakeBackup

func MakeBackup(tmpPath, origFn string) (string, error)

func NFilesInFolder

func NFilesInFolder(path string) int

func Remove

func Remove(fileName string) bool

func RunWithFileSupport

func RunWithFileSupport(
	mode string,
	run func(cmd *cobra.Command, args []string) error,
	resetOptions func(testMode bool),
) func(cmd *cobra.Command, args []string) error

RunWithFileSupport returns a function to run Cobra command. The command runs in the usual way unless `--file` is specified. If it is specified, this function will parse the file and then run the command in series of independent calls (just like calling `chifra` N times on the command line, but without wasting time and resources for the startup)

func StringToAsciiFile

func StringToAsciiFile(filename, value string) error

func Touch

func Touch(filename string) bool

func Unlock

func Unlock(file *os.File) error

Unlock removes OS-level file lock

func WaitOnLock

func WaitOnLock(filePath string, openFlags int) (file *os.File, err error)

WaitOnLock tries to lock a file for maximum `maxSecondsLock`

func WordCount

func WordCount(fileName string, ignoreHeader bool) (int, error)

Types

type CommandFileLine

type CommandFileLine struct {
	LineNumber uint
	Flags      []string
	Args       []string
}

CommandFileLine stores line number for future reference, flag (usually a string that starts with "-" or "--") and args (any other string) information

type CommandsFile

type CommandsFile struct {
	Lines []CommandFileLine
}

CommandsFile is data structure representing the text file with commands (flags and arguments) on each line. Lines trigger independent invocations of given chifra subcommand.

func ParseCommandsFile

func ParseCommandsFile(cmd *cobra.Command, filePath string) (cf CommandsFile, err error)

ParseCommandsFile parses a text file into `CommandsFile` struct. While parsing, the function validates flags present on the current line.