iotest

Documentation

Overview

Package iotest implements Readers and Writers useful mainly for testing.

Index

• Variables
• func DataErrReader(r io.Reader) io.Reader
• func ErrReader(err error) io.Reader
• func HalfReader(r io.Reader) io.Reader
• func OneByteReader(r io.Reader) io.Reader
• func TimeoutReader(r io.Reader) io.Reader
• func TruncateWriter(w io.Writer, n int64) io.Writer

Variables

var ErrTimeout = errors.New("timeout")

ErrTimeout is a fake timeout error.

Functions

func DataErrReader

func DataErrReader(r io.Reader) io.Reader

DataErrReader changes the way errors are handled by a Reader. Normally, a Reader returns an error (typically EOF) from the first Read call after the last piece of data is read. DataErrReader wraps a Reader and changes its behavior so the final error is returned along with the final data, instead of in the first call after the final data.

func ErrReader

func ErrReader(err error) io.Reader

ErrReader returns an io.Reader that returns 0, err from all Read calls.

func HalfReader

func HalfReader(r io.Reader) io.Reader

HalfReader returns a Reader that implements Read by reading half as many requested bytes from r.

func OneByteReader

func OneByteReader(r io.Reader) io.Reader

OneByteReader returns a Reader that implements each non-empty Read by reading one byte from r.

func TimeoutReader

func TimeoutReader(r io.Reader) io.Reader

TimeoutReader returns ErrTimeout on the second read with no data. Subsequent calls to read succeed.

func TruncateWriter

func TruncateWriter(w io.Writer, n int64) io.Writer

TruncateWriter returns a Writer that writes to w but stops silently after n bytes.