io

Documentation

Overview

Package io provide a library for reading and watching file, and reading from standard input.

Index

• func ConfirmYesNo(in io.Reader, msg string, defIsYes bool) bool
• func IsDirEmpty(dir string) (ok bool)
• func IsFileExist(parent, relpath string) bool
• func RmdirEmptyAll(path string) error
• type Reader
  • func NewReader(path string) (*Reader, error)
  • func (r *Reader) Current() byte
  • func (r *Reader) Init(src []byte)
  • func (r *Reader) ReadLine() (line []byte)
  • func (r *Reader) ReadUntil(seps, terms []byte) (tok []byte, isTerm bool, c byte)
  • func (r *Reader) Rest() []byte
  • func (r *Reader) ScanInt64() (n int64, c byte)
  • func (r *Reader) SkipHorizontalSpace() (n int, c byte)
  • func (r *Reader) SkipLine()
  • func (r *Reader) SkipN(n int) bool
  • func (r *Reader) SkipSpaces() (c byte)
  • func (r *Reader) SkipUntil(seps []byte) (c byte)
  • func (r *Reader) String() string
  • func (r *Reader) UnreadN(n int) byte
• type Watcher
  • func NewWatcher(file string, d time.Duration) (*Watcher, error)
  • func (w *Watcher) Stop()

Functions

func ConfirmYesNo

func ConfirmYesNo(in io.Reader, msg string, defIsYes bool) bool

ConfirmYesNo display a question to standard output and read for answer from input Reader for simple yes "y" or no "n" answer. If input Reader is nil, it will set to standard input. If "defIsYes" is true and answer is empty (only new line), then it will return true.

func IsDirEmpty

func IsDirEmpty(dir string) (ok bool)

IsDirEmpty will return true if directory is not exist or empty; otherwise it will return false.

func IsFileExist

func IsFileExist(parent, relpath string) bool

IsFileExist will return true if relative path is exist on parent directory; otherwise it will return false.

func RmdirEmptyAll

func RmdirEmptyAll(path string) error

RmdirEmptyAll remove directory in path if it's empty until one of the parent is not empty.

Types

type Reader

type Reader struct {
	X int    // X contains the current index of readed buffer.
	V []byte // V contains the buffer.
}

Reader represent a buffered reader that use an index to move through slice of bytes.

The following illustration show the uses of each fields,

+-+-+-+-+-+
| | | | | | <= r.V
+-+-+-+-+-+
   ^
   |
  r.X

func NewReader

func NewReader(path string) (*Reader, error)

NewReader open the file in path for reading.

func (*Reader) Current

func (r *Reader) Current() byte

Current byte at index position or 0 if EOF.

func (*Reader) Init

func (r *Reader) Init(src []byte)

Init initialize reader buffer from slice of byte.

func (*Reader) ReadLine

func (r *Reader) ReadLine() (line []byte)

ReadLine read one line including the line feed '\n' character.

func (*Reader) ReadUntil

func (r *Reader) ReadUntil(seps, terms []byte) (tok []byte, isTerm bool, c byte)

ReadUntil read the content of buffer until one of separator found, or until one of terminator character found, or until EOF. If terminator found, the returned isTerm value will be true, and c value will be the character that cause the termination.

func (*Reader) Rest

func (r *Reader) Rest() []byte

Rest return the rest of unreaded buffer.

func (*Reader) ScanInt64

func (r *Reader) ScanInt64() (n int64, c byte)

ScanInt64 convert textual representation of number into int64 and return it. Any spaces before actual reading of text will be ignored. The number may prefixed with '-' or '+', if its '-', the returned value must be negative.

On success, c is non digit character that terminate scan, if its 0, its mean EOF.

func (*Reader) SkipHorizontalSpace

func (r *Reader) SkipHorizontalSpace() (n int, c byte)

SkipHorizontalSpace read until no space, carriage return, or tab occurred on buffer. On EOF it will return 0.

func (*Reader) SkipLine

func (r *Reader) SkipLine()

SkipLine skip reading content until newline.

func (*Reader) SkipN

func (r *Reader) SkipN(n int) bool

SkipN skip reading n bytes from buffer and return true if EOF.

func (*Reader) SkipSpaces

func (r *Reader) SkipSpaces() (c byte)

SkipSpaces read until no white spaces found and return the first byte that is not white spaces. On EOF, it will return 0.

func (*Reader) SkipUntil

func (r *Reader) SkipUntil(seps []byte) (c byte)

SkipUntil skip reading content until one of separator found or EOF.

func (*Reader) String

func (r *Reader) String() string

String return all unreaded content as string.

func (*Reader) UnreadN

func (r *Reader) UnreadN(n int) byte

Unread the buffer N characters and return the character its pointed to. If N greater than buffer length, it will reset the pointer index back to zero.

type Watcher

type Watcher struct {
	C <-chan *os.FileInfo
	// contains filtered or unexported fields
}

A Watcher hold a channel that deliver file information when file is changed. If file is deleted, it will send a nil file information to channel and stop watching the file.

This is a naive implementation of file event change notification.

func NewWatcher

func NewWatcher(file string, d time.Duration) (*Watcher, error)

NewWatcher return a new file watcher that will inspect the file for changes with period specified by duration `d` argument. If duration is less or equal to zero, it will be set to default duration (5 seconds).

func (*Watcher) Stop

func (w *Watcher) Stop()

Stop watching the file.