package iotest
import "testing/iotest"
Package iotest 实现了主要用于测试的 Readers 和 Writers。
Index
- Variables
- func DataErrReader(r io.Reader) io.Reader
- func ErrReader(err error) io.Reader
- func HalfReader(r io.Reader) io.Reader
- func NewReadLogger(prefix string, r io.Reader) io.Reader
- func NewWriteLogger(prefix string, w io.Writer) io.Writer
- func OneByteReader(r io.Reader) io.Reader
- func TestReader(r io.Reader, content []byte) error
- func TimeoutReader(r io.Reader) io.Reader
- func TruncateWriter(w io.Writer, n int64) io.Writer
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。
Output: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)
}
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 个字节后静默停止。