testsession

Documentation

Index

• func ConnectInstances(instances []Instance)
• type Instance
  • func NewInstance(ctx context.Context, net tn.Network, p tnet.Identity, ...) Instance
  • func (i *Instance) Blockstore() blockstore.Blockstore
  • func (i *Instance) SetBlockstoreLatency(t time.Duration) time.Duration
• type InstanceGenerator
  • func NewTestInstanceGenerator(net tn.Network, netOptions []bsnet.NetOpt, bsOptions []bitswap.Option) InstanceGenerator
  • func (g *InstanceGenerator) Close() error
  • func (g *InstanceGenerator) Instances(n int) []Instance
  • func (g *InstanceGenerator) Next() Instance

Functions

func ConnectInstances

func ConnectInstances(instances []Instance)

ConnectInstances connects the given instances to each other

Types

type Instance

type Instance struct {
	Peer     peer.ID
	Exchange *bitswap.Bitswap

	Adapter bsnet.BitSwapNetwork
	// contains filtered or unexported fields
}

Instance is a test instance of bitswap + dependencies for integration testing

func NewInstance

func NewInstance(ctx context.Context, net tn.Network, p tnet.Identity, netOptions []bsnet.NetOpt, bsOptions []bitswap.Option) Instance

NewInstance creates a test bitswap instance.

NB: It's easy make mistakes by providing the same peer ID to two different instances. To safeguard, use the InstanceGenerator to generate instances. It's just a much better idea.

func (*Instance) Blockstore

func (i *Instance) Blockstore() blockstore.Blockstore

Blockstore returns the block store for this test instance

func (*Instance) SetBlockstoreLatency

func (i *Instance) SetBlockstoreLatency(t time.Duration) time.Duration

SetBlockstoreLatency customizes the artificial delay on receiving blocks from a blockstore test instance.

type InstanceGenerator

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

InstanceGenerator generates new test instances of bitswap+dependencies

func NewTestInstanceGenerator

func NewTestInstanceGenerator(net tn.Network, netOptions []bsnet.NetOpt, bsOptions []bitswap.Option) InstanceGenerator

NewTestInstanceGenerator generates a new InstanceGenerator for the given testnet

func (*InstanceGenerator) Close

func (g *InstanceGenerator) Close() error

Close closes the clobal context, shutting down all test instances

func (*InstanceGenerator) Instances

func (g *InstanceGenerator) Instances(n int) []Instance

Instances creates N test instances of bitswap + dependencies and connects them to each other

func (*InstanceGenerator) Next

func (g *InstanceGenerator) Next() Instance

Next generates a new instance of bitswap + dependencies