Documentation ¶
Index ¶
- func GenerateIDs(t *testing.T, logger zerolog.Logger, n int, opts ...func(*optsConfig)) (flow.IdentityList, []*p2pnode.Node, []observable.Observable)
- func GenerateIDsMiddlewaresNetworks(t *testing.T, n int, log zerolog.Logger, codec network.Codec, ...) (flow.IdentityList, []*p2pnode.Node, []network.Middleware, []network.Network, ...)
- func GenerateNetworks(t *testing.T, log zerolog.Logger, ids flow.IdentityList, ...) []network.Network
- func GenerateSubscriptionManagers(t *testing.T, mws []network.Middleware) []network.SubscriptionManager
- func NewResourceManager(t *testing.T) p2pNetwork.ResourceManager
- func StartNodes(ctx irrecoverable.SignalerContext, t *testing.T, nodes []*p2pnode.Node, ...)
- func StartNodesAndNetworks(ctx irrecoverable.SignalerContext, t *testing.T, nodes []*p2pnode.Node, ...)
- func WithDHT(prefix string, dhtOpts ...dht.Option) func(*optsConfig)
- func WithIdentityOpts(idOpts ...func(*flow.Identity)) func(*optsConfig)
- func WithPeerUpdateInterval(interval time.Duration) func(*optsConfig)
- type ConduitSendWrapperFunc
- type ConduitWrapper
- func (c *ConduitWrapper) Multicast(msg interface{}, conduit network.Conduit, targetIDs ...flow.Identifier) error
- func (c *ConduitWrapper) Publish(msg interface{}, conduit network.Conduit, targetIDs ...flow.Identifier) error
- func (c *ConduitWrapper) Unicast(msg interface{}, conduit network.Conduit, targetIDs ...flow.Identifier) error
- type EchoEngine
- func (te *EchoEngine) Process(channel channels.Channel, originID flow.Identifier, event interface{}) error
- func (te *EchoEngine) ProcessLocal(event interface{}) error
- func (te *EchoEngine) Submit(channel channels.Channel, originID flow.Identifier, event interface{})
- func (te *EchoEngine) SubmitLocal(event interface{})
- type MeshEngine
- func (e *MeshEngine) Process(channel channels.Channel, originID flow.Identifier, event interface{}) error
- func (e *MeshEngine) ProcessLocal(event interface{}) error
- func (e *MeshEngine) Submit(channel channels.Channel, originID flow.Identifier, event interface{})
- func (e *MeshEngine) SubmitLocal(event interface{})
- type PeerTag
- type TagWatchingConnManager
- type UpdatableIDProvider
- func GenerateIDsAndMiddlewares(t *testing.T, n int, logger zerolog.Logger, codec network.Codec, ...) (flow.IdentityList, []*p2pnode.Node, []network.Middleware, ...)
- func GenerateMiddlewares(t *testing.T, logger zerolog.Logger, identities flow.IdentityList, ...) ([]network.Middleware, []*UpdatableIDProvider)
- func NewUpdatableIDProvider(identities flow.IdentityList) *UpdatableIDProvider
- func (p *UpdatableIDProvider) ByNodeID(flowID flow.Identifier) (*flow.Identity, bool)
- func (p *UpdatableIDProvider) ByPeerID(peerID peer.ID) (*flow.Identity, bool)
- func (p *UpdatableIDProvider) Identifiers() flow.IdentifierList
- func (p *UpdatableIDProvider) Identities(filter flow.IdentityFilter) flow.IdentityList
- func (p *UpdatableIDProvider) SetIdentities(identities flow.IdentityList)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func GenerateIDs ¶
func GenerateIDs( t *testing.T, logger zerolog.Logger, n int, opts ...func(*optsConfig), ) (flow.IdentityList, []*p2pnode.Node, []observable.Observable)
GenerateIDs is a test helper that generate flow identities with a valid port and libp2p nodes.
func GenerateIDsMiddlewaresNetworks ¶
func GenerateIDsMiddlewaresNetworks( t *testing.T, n int, log zerolog.Logger, codec network.Codec, consumer slashing.ViolationsConsumer, opts ...func(*optsConfig), ) (flow.IdentityList, []*p2pnode.Node, []network.Middleware, []network.Network, []observable.Observable)
func GenerateNetworks ¶
func GenerateNetworks( t *testing.T, log zerolog.Logger, ids flow.IdentityList, mws []network.Middleware, sms []network.SubscriptionManager, ) []network.Network
GenerateNetworks generates the network for the given middlewares
func GenerateSubscriptionManagers ¶
func GenerateSubscriptionManagers(t *testing.T, mws []network.Middleware) []network.SubscriptionManager
GenerateSubscriptionManagers creates and returns a ChannelSubscriptionManager for each middleware object.
func NewResourceManager ¶ added in v0.28.0
func NewResourceManager(t *testing.T) p2pNetwork.ResourceManager
NewResourceManager creates a new resource manager for testing with huge limits.
func StartNodes ¶ added in v0.28.0
func StartNodes(ctx irrecoverable.SignalerContext, t *testing.T, nodes []*p2pnode.Node, duration time.Duration)
StartNodes starts the provided nodes and their peer managers using the provided irrecoverable context
func StartNodesAndNetworks ¶ added in v0.28.0
func StartNodesAndNetworks(ctx irrecoverable.SignalerContext, t *testing.T, nodes []*p2pnode.Node, nets []network.Network, duration time.Duration)
StartNodesAndNetworks starts the provided networks and libp2p nodes, returning the irrecoverable error channel
func WithIdentityOpts ¶ added in v0.23.9
func WithPeerUpdateInterval ¶ added in v0.28.0
Types ¶
type ConduitSendWrapperFunc ¶
type ConduitSendWrapperFunc func(msg interface{}, conduit network.Conduit, targetIDs ...flow.Identifier) error
ConduitSendWrapperFunc is a wrapper around the set of methods offered by the Conduit (e.g., Publish). This data type is solely introduced at the test level. Its primary purpose is to make the same test reusable on different Conduit methods.
type ConduitWrapper ¶
type ConduitWrapper struct{}
func (*ConduitWrapper) Multicast ¶
func (c *ConduitWrapper) Multicast(msg interface{}, conduit network.Conduit, targetIDs ...flow.Identifier) error
Multicast defines a function that receives a message, conduit of an engine instance, and a set of target ID. It then sends the message to the target IDs using the Multicast method of conduit.
func (*ConduitWrapper) Publish ¶
func (c *ConduitWrapper) Publish(msg interface{}, conduit network.Conduit, targetIDs ...flow.Identifier) error
Publish defines a function that receives a message, conduit of an engine instance, and a set target IDs. It then sends the message to the target IDs using the Publish method of conduit.
func (*ConduitWrapper) Unicast ¶
func (c *ConduitWrapper) Unicast(msg interface{}, conduit network.Conduit, targetIDs ...flow.Identifier) error
Unicast defines a function that receives a message, conduit of an engine instance, and a set of target IDs. It then sends the message to the target IDs using individual Unicasts to each target in the underlying network.
type EchoEngine ¶
type EchoEngine struct { sync.RWMutex mockcomponent.Component // contains filtered or unexported fields }
EchoEngine is a simple engine that is used for testing the correctness of driving the engines with libp2p, in addition to receiving and storing incoming messages it also echos them back
func NewEchoEngine ¶
func NewEchoEngine(t *testing.T, net network.Network, cap int, channel channels.Channel, echo bool, send ConduitSendWrapperFunc) *EchoEngine
func (*EchoEngine) Process ¶
func (te *EchoEngine) Process(channel channels.Channel, originID flow.Identifier, event interface{}) error
Process receives an originID and an event and casts them into the corresponding fields of the EchoEngine. It then flags the received channel on reception of an event. It also sends back an echo of the message to the origin ID
func (*EchoEngine) ProcessLocal ¶
func (te *EchoEngine) ProcessLocal(event interface{}) error
ProcessLocal is implemented for a valid type assertion to Engine any call to it fails the test
func (*EchoEngine) Submit ¶
func (te *EchoEngine) Submit(channel channels.Channel, originID flow.Identifier, event interface{})
Submit is implemented for a valid type assertion to Engine any call to it fails the test
func (*EchoEngine) SubmitLocal ¶
func (te *EchoEngine) SubmitLocal(event interface{})
SubmitLocal is implemented for a valid type assertion to Engine any call to it fails the test
type MeshEngine ¶
type MeshEngine struct { sync.Mutex mockcomponent.Component // contains filtered or unexported fields }
MeshEngine is a simple engine that is used for testing the correctness of driving the engines with libp2p, it simply receives and stores the incoming messages
func GenerateEngines ¶
func GenerateEngines(t *testing.T, nets []network.Network) []*MeshEngine
GenerateEngines generates MeshEngines for the given networks
func NewMeshEngine ¶
func (*MeshEngine) Process ¶
func (e *MeshEngine) Process(channel channels.Channel, originID flow.Identifier, event interface{}) error
Process receives an originID and an event and casts them into the corresponding fields of the MeshEngine. It then flags the received channel on reception of an event.
func (*MeshEngine) ProcessLocal ¶
func (e *MeshEngine) ProcessLocal(event interface{}) error
ProcessLocal is implemented for a valid type assertion to Engine any call to it fails the test
func (*MeshEngine) Submit ¶
func (e *MeshEngine) Submit(channel channels.Channel, originID flow.Identifier, event interface{})
Submit is implemented for a valid type assertion to Engine any call to it fails the test
func (*MeshEngine) SubmitLocal ¶
func (e *MeshEngine) SubmitLocal(event interface{})
SubmitLocal is implemented for a valid type assertion to Engine any call to it fails the test
type TagWatchingConnManager ¶ added in v0.21.0
type TagWatchingConnManager struct { *connection.ConnManager // contains filtered or unexported fields }
func NewTagWatchingConnManager ¶ added in v0.21.0
func NewTagWatchingConnManager(log zerolog.Logger, idProvider module.IdentityProvider, metrics module.NetworkMetrics) *TagWatchingConnManager
func (*TagWatchingConnManager) Protect ¶ added in v0.21.0
func (cwcm *TagWatchingConnManager) Protect(id peer.ID, tag string)
func (*TagWatchingConnManager) Subscribe ¶ added in v0.21.0
func (cwcm *TagWatchingConnManager) Subscribe(observer observable.Observer)
func (*TagWatchingConnManager) Unprotect ¶ added in v0.21.0
func (cwcm *TagWatchingConnManager) Unprotect(id peer.ID, tag string) bool
func (*TagWatchingConnManager) Unsubscribe ¶ added in v0.21.0
func (cwcm *TagWatchingConnManager) Unsubscribe(observer observable.Observer)
type UpdatableIDProvider ¶ added in v0.21.1
type UpdatableIDProvider struct {
// contains filtered or unexported fields
}
UpdatableIDProvider implements an IdentityProvider which can be manually updated by setting the IdentityList to a new value. It also implements an IdentifierProvider which provides the identifiers of the IdentityList. This is mainly used to simulate epoch transitions in tests.
func GenerateIDsAndMiddlewares ¶
func GenerateIDsAndMiddlewares(t *testing.T, n int, logger zerolog.Logger, codec network.Codec, consumer slashing.ViolationsConsumer, opts ...func(*optsConfig), ) (flow.IdentityList, []*p2pnode.Node, []network.Middleware, []observable.Observable, []*UpdatableIDProvider)
GenerateIDsAndMiddlewares returns nodeIDs, libp2pNodes, middlewares, and observables which can be subscirbed to in order to witness protect events from pubsub
func GenerateMiddlewares ¶
func GenerateMiddlewares(t *testing.T, logger zerolog.Logger, identities flow.IdentityList, libP2PNodes []*p2pnode.Node, codec network.Codec, consumer slashing.ViolationsConsumer, opts ...func(*optsConfig)) ([]network.Middleware, []*UpdatableIDProvider)
GenerateMiddlewares creates and initializes middleware instances for all the identities
func NewUpdatableIDProvider ¶ added in v0.21.1
func NewUpdatableIDProvider(identities flow.IdentityList) *UpdatableIDProvider
func (*UpdatableIDProvider) ByNodeID ¶ added in v0.21.1
func (p *UpdatableIDProvider) ByNodeID(flowID flow.Identifier) (*flow.Identity, bool)
func (*UpdatableIDProvider) Identifiers ¶ added in v0.21.1
func (p *UpdatableIDProvider) Identifiers() flow.IdentifierList
func (*UpdatableIDProvider) Identities ¶ added in v0.21.1
func (p *UpdatableIDProvider) Identities(filter flow.IdentityFilter) flow.IdentityList
func (*UpdatableIDProvider) SetIdentities ¶ added in v0.21.1
func (p *UpdatableIDProvider) SetIdentities(identities flow.IdentityList)
SetIdentities updates the IdentityList returned by this provider.