// Copyright 2018 Parity Technologies (UK) Ltd. // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), // to deal in the Software without restriction, including without limitation // the rights to use, copy, modify, merge, publish, distribute, sublicense, // and/or sell copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. use futures::StreamExt; use libp2p_core::{Endpoint, Multiaddr}; use libp2p_identify as identify; use libp2p_ping as ping; use libp2p_swarm::{ behaviour::FromSwarm, dummy, ConnectionDenied, NetworkBehaviour, SwarmEvent, THandler, THandlerInEvent, THandlerOutEvent, }; use std::fmt::Debug; /// Small utility to check that a type implements `NetworkBehaviour`. #[allow(dead_code)] fn require_net_behaviour() {} // TODO: doesn't compile /*#[test] fn empty() { #[allow(dead_code)] #[derive(NetworkBehaviour)] struct Foo {} }*/ #[test] fn one_field() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo { ping: ping::Behaviour, } #[allow( dead_code, unreachable_code, clippy::diverging_sub_expression, clippy::used_underscore_binding )] fn foo() { let _out_event: ::ToSwarm = unimplemented!(); match _out_event { FooEvent::Ping(ping::Event { .. }) => {} } } } #[test] fn two_fields() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo { ping: ping::Behaviour, identify: identify::Behaviour, } #[allow( dead_code, unreachable_code, clippy::diverging_sub_expression, clippy::used_underscore_binding )] fn foo() { let _out_event: ::ToSwarm = unimplemented!(); match _out_event { FooEvent::Ping(ping::Event { .. }) => {} FooEvent::Identify(event) => { let _: identify::Event = event; } } } } #[test] fn three_fields() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo { ping: ping::Behaviour, identify: identify::Behaviour, kad: libp2p_kad::Kademlia, } #[allow( dead_code, unreachable_code, clippy::diverging_sub_expression, clippy::used_underscore_binding )] fn foo() { let _out_event: ::ToSwarm = unimplemented!(); match _out_event { FooEvent::Ping(ping::Event { .. }) => {} FooEvent::Identify(event) => { let _: identify::Event = event; } FooEvent::Kad(event) => { let _: libp2p_kad::KademliaEvent = event; } } } } #[test] fn custom_event() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(to_swarm = "MyEvent", prelude = "libp2p_swarm::derive_prelude")] struct Foo { ping: ping::Behaviour, identify: identify::Behaviour, } #[allow(clippy::large_enum_variant)] enum MyEvent { Ping(ping::Event), Identify(identify::Event), } impl From for MyEvent { fn from(event: ping::Event) -> Self { MyEvent::Ping(event) } } impl From for MyEvent { fn from(event: identify::Event) -> Self { MyEvent::Identify(event) } } #[allow(dead_code)] fn foo() { require_net_behaviour::(); } } #[test] fn custom_event_mismatching_field_names() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(to_swarm = "MyEvent", prelude = "libp2p_swarm::derive_prelude")] struct Foo { a: ping::Behaviour, b: identify::Behaviour, } #[allow(clippy::large_enum_variant)] enum MyEvent { Ping(ping::Event), Identify(identify::Event), } impl From for MyEvent { fn from(event: ping::Event) -> Self { MyEvent::Ping(event) } } impl From for MyEvent { fn from(event: identify::Event) -> Self { MyEvent::Identify(event) } } #[allow(dead_code)] fn foo() { require_net_behaviour::(); } } #[test] fn bound() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo where ::ToSwarm: Debug, { ping: ping::Behaviour, bar: T, } } #[test] fn where_clause() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo where T: Copy + NetworkBehaviour, ::ToSwarm: Debug, { ping: ping::Behaviour, bar: T, } } #[test] fn nested_derives_with_import() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo { ping: ping::Behaviour, } #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Bar { foo: Foo, } #[allow( dead_code, unreachable_code, clippy::diverging_sub_expression, clippy::used_underscore_binding )] fn foo() { let _out_event: ::ToSwarm = unimplemented!(); match _out_event { BarEvent::Foo(FooEvent::Ping(ping::Event { .. })) => {} } } } #[test] fn custom_event_emit_event_through_poll() { #[allow(clippy::large_enum_variant)] enum BehaviourOutEvent { Ping(ping::Event), Identify(identify::Event), } impl From for BehaviourOutEvent { fn from(event: ping::Event) -> Self { BehaviourOutEvent::Ping(event) } } impl From for BehaviourOutEvent { fn from(event: identify::Event) -> Self { BehaviourOutEvent::Identify(event) } } #[allow(dead_code, clippy::large_enum_variant)] #[derive(NetworkBehaviour)] #[behaviour( to_swarm = "BehaviourOutEvent", prelude = "libp2p_swarm::derive_prelude" )] struct Foo { ping: ping::Behaviour, identify: identify::Behaviour, } #[allow( dead_code, unreachable_code, clippy::diverging_sub_expression, clippy::used_underscore_binding )] async fn bar() { require_net_behaviour::(); let mut _swarm: libp2p_swarm::Swarm = unimplemented!(); // check that the event is bubbled up all the way to swarm loop { match _swarm.select_next_some().await { SwarmEvent::Behaviour(BehaviourOutEvent::Ping(_)) => break, SwarmEvent::Behaviour(BehaviourOutEvent::Identify(_)) => break, _ => {} } } } } #[test] fn with_toggle() { use libp2p_swarm::behaviour::toggle::Toggle; #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo { identify: identify::Behaviour, ping: Toggle, } #[allow(dead_code)] fn foo() { require_net_behaviour::(); } } #[test] fn with_either() { use either::Either; #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo { kad: libp2p_kad::Kademlia, ping_or_identify: Either, } #[allow(dead_code)] fn foo() { require_net_behaviour::(); } } #[test] fn with_generics() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo { a: A, b: B, } #[allow(dead_code)] fn foo() { require_net_behaviour::< Foo< libp2p_kad::Kademlia, libp2p_ping::Behaviour, >, >(); } } #[test] fn with_generics_mixed() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo { a: A, ping: libp2p_ping::Behaviour, } #[allow(dead_code)] fn foo() { require_net_behaviour::>>( ); } } #[test] fn custom_event_with_either() { use either::Either; #[allow(clippy::large_enum_variant)] enum BehaviourOutEvent { Kad(libp2p_kad::KademliaEvent), PingOrIdentify(Either), } impl From for BehaviourOutEvent { fn from(event: libp2p_kad::KademliaEvent) -> Self { BehaviourOutEvent::Kad(event) } } impl From> for BehaviourOutEvent { fn from(event: Either) -> Self { BehaviourOutEvent::PingOrIdentify(event) } } #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour( to_swarm = "BehaviourOutEvent", prelude = "libp2p_swarm::derive_prelude" )] struct Foo { kad: libp2p_kad::Kademlia, ping_or_identify: Either, } #[allow(dead_code)] fn foo() { require_net_behaviour::(); } } #[test] fn generated_out_event_derive_debug() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo { ping: ping::Behaviour, } fn require_debug() where T: NetworkBehaviour, ::ToSwarm: Debug, { } require_debug::(); } #[test] fn multiple_behaviour_attributes() { #[allow(dead_code)] #[derive(NetworkBehaviour)] #[behaviour(to_swarm = "FooEvent")] #[behaviour(prelude = "libp2p_swarm::derive_prelude")] struct Foo { ping: ping::Behaviour, } require_net_behaviour::(); struct FooEvent; impl From for FooEvent { fn from(_: ping::Event) -> Self { unimplemented!() } } } #[test] fn custom_out_event_no_type_parameters() { use libp2p_identity::PeerId; use libp2p_swarm::{ConnectionId, PollParameters, ToSwarm}; use std::task::Context; use std::task::Poll; pub(crate) struct TemplatedBehaviour { _data: T, } impl NetworkBehaviour for TemplatedBehaviour { type ConnectionHandler = dummy::ConnectionHandler; type ToSwarm = void::Void; fn handle_established_inbound_connection( &mut self, _: ConnectionId, _: PeerId, _: &Multiaddr, _: &Multiaddr, ) -> Result, ConnectionDenied> { Ok(dummy::ConnectionHandler) } fn handle_established_outbound_connection( &mut self, _: ConnectionId, _: PeerId, _: &Multiaddr, _: Endpoint, ) -> Result, ConnectionDenied> { Ok(dummy::ConnectionHandler) } fn on_connection_handler_event( &mut self, _peer: PeerId, _connection: ConnectionId, message: THandlerOutEvent, ) { void::unreachable(message); } fn poll( &mut self, _ctx: &mut Context, _: &mut impl PollParameters, ) -> Poll>> { Poll::Pending } fn on_swarm_event(&mut self, event: FromSwarm) { match event { FromSwarm::ConnectionEstablished(_) | FromSwarm::ConnectionClosed(_) | FromSwarm::AddressChange(_) | FromSwarm::DialFailure(_) | FromSwarm::ListenFailure(_) | FromSwarm::NewListener(_) | FromSwarm::NewListenAddr(_) | FromSwarm::ExpiredListenAddr(_) | FromSwarm::ListenerError(_) | FromSwarm::ListenerClosed(_) | FromSwarm::NewExternalAddrCandidate(_) | FromSwarm::ExternalAddrExpired(_) | FromSwarm::ExternalAddrConfirmed(_) => {} } } } #[derive(NetworkBehaviour)] #[behaviour(to_swarm = "OutEvent", prelude = "libp2p_swarm::derive_prelude")] struct Behaviour { custom: TemplatedBehaviour, } #[derive(Debug)] enum OutEvent { None, } impl From for OutEvent { fn from(_e: void::Void) -> Self { Self::None } } require_net_behaviour::>(); require_net_behaviour::>(); } #[test] fn ui() { let t = trybuild::TestCases::new(); t.compile_fail("tests/ui/fail/*.rs"); }