package iotest

import "testing/iotest"

Package iotest 实现了主要用于测试的 Readers 和 Writers。

Index

Examples

Variables

var ErrTimeout = errors.New("timeout")

ErrTimeout 是一个伪造的超时错误。

Functions

func DataErrReader

func DataErrReader(r io.Reader) io.Reader

DataErrReader 改变 Reader 处理错误的方式。通常,Reader 会在读取到 最后一块数据之后的第一次 Read 调用中返回一个错误(通常是 EOF)。 DataErrReader 包装一个 Reader 并改变其行为,使最终错误与最终数据 一起返回,而不是在最终数据之后的第一次调用中返回。

func ErrReader

func ErrReader(err error) io.Reader

ErrReader 返回一个 io.Reader,其所有 Read 调用都返回 0, err。

Example
package main

import (
	"errors"
	"fmt"
	"testing/iotest"
)

func main() {
	// A reader that always returns a custom error.
	r := iotest.ErrReader(errors.New("custom error"))
	n, err := r.Read(nil)
	fmt.Printf("n:   %d\nerr: %q\n", n, err)

}

Output:

n:   0
err: "custom error"

func HalfReader

func HalfReader(r io.Reader) io.Reader

HalfReader 返回一个 Reader,其实现 Read 的方式 是从 r 读取请求字节数的一半。

func NewReadLogger

func NewReadLogger(prefix string, r io.Reader) io.Reader

NewReadLogger 返回一个 reader,其行为与 r 相同, 但会在每次读取时通过 log.Printf 向标准错误记录日志, 打印前缀以及所读取数据的十六进制表示。

func NewWriteLogger

func NewWriteLogger(prefix string, w io.Writer) io.Writer

NewWriteLogger 返回一个 writer,其行为与 w 相同, 但会在每次写入时通过 log.Printf 向标准错误记录日志, 打印前缀以及所写入数据的十六进制表示。

func OneByteReader

func OneByteReader(r io.Reader) io.Reader

OneByteReader 返回一个 Reader,其对每个非空 Read 的实现 是从 r 读取一个字节。

func TestReader

func TestReader(r io.Reader, content []byte) error

TestReader 测试从 r 读取是否返回预期的文件内容。 它以不同大小进行读取,直至 EOF。 如果 r 实现了 io.ReaderAt 或 io.Seeker,TestReader 还会检查 这些操作的行为是否正确。

如果 TestReader 发现任何不当行为,它会返回一个报告这些问题的错误。 错误文本可能跨越多行。

func TimeoutReader

func TimeoutReader(r io.Reader) io.Reader

TimeoutReader 在第二次无数据读取时返回 ErrTimeout。 后续的读取调用会成功。

func TruncateWriter

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

TruncateWriter 返回一个 Writer,它写入 w, 但在写入 n 个字节后静默停止。