nettest

Documentation

Overview

Package nettest provides an in-memory socket, Pipe. It can be used in place of net.Dial and net.Listen for faster and more hermetic tests.

Index

• Variables
• type Pipe
  • func NewPipe() *Pipe
  • func (p *Pipe) Accept(cancel <-chan struct{}) (net.Conn, error)
  • func (p *Pipe) Connect(cancel <-chan struct{}) (net.Conn, error)
• type PipeListener
  • func NewListener(pipe *Pipe) *PipeListener
  • func (t *PipeListener) Accept() (net.Conn, error)
  • func (t *PipeListener) Addr() net.Addr
  • func (t *PipeListener) Close() error

Variables

var ErrCanceled = errors.New("pipe operation canceled by client")

ErrCanceled indicates that an operation was canceled by the client (e.g. via ctx.Done()).

Types

type Pipe

type Pipe struct {
	// contains filtered or unexported fields
}

Pipe is an in-memory socket. It provides similar functionality to net.Listen and net.Dial via the Pipe.Accept and Pipe.Connect methods, respectively. It is useful for faster and more deterministic testing of netcode.

func NewPipe

func NewPipe() *Pipe

NewPipe returns a Pipe.

func (*Pipe) Accept

func (p *Pipe) Accept(cancel <-chan struct{}) (net.Conn, error)

Accept returns a connection to the server for a client.

func (*Pipe) Connect

func (p *Pipe) Connect(cancel <-chan struct{}) (net.Conn, error)

Connect returns a connection to a client for the server.

type PipeListener

type PipeListener struct {
	*Pipe
	// contains filtered or unexported fields
}

PipeListener is a net.Listener which uses a Pipe to simulate a network connection.

func NewListener

func NewListener(pipe *Pipe) *PipeListener

NewListener returns a net.Listener which uses the given Pipe to simulate a network connection.

func (*PipeListener) Accept

func (t *PipeListener) Accept() (net.Conn, error)

func (*PipeListener) Addr

func (t *PipeListener) Addr() net.Addr

func (*PipeListener) Close

func (t *PipeListener) Close() error