net-lattice-platform 0.12.0

Generic provider traits and Capability contract between the model and platform backends. Depends only on net-lattice-core — never on net-lattice-model.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

//! The contract between the model and platform backends.
//!
//! `net-lattice-platform` depends only on `net-lattice-core` — never on
//! `net-lattice-model`. Its provider traits describe the *shape* of a
//! contract, not the *content* of the model, via associated types. See
//! ARCHITECTURE.md for the full rationale, including how model
//! convergence is enforced one layer up, in `lattice`.
//!
//! Stage 0.4 added `InterfaceProvider`; Stage 0.5 added `DnsProvider`;
//! Stage 0.6 added `NeighborProvider`; Stage 0.7 added `AddressProvider`;
//! Stage 0.8 added `EventProvider`; Stage 0.16 adds `InterfaceMutator`.

mod address_mutator;
mod address_provider;
mod capability;
mod dns_mutator;
mod dns_provider;
mod event_provider;
mod interface_mutator;
mod interface_provider;
mod neighbor_provider;
mod route_provider;
#[cfg(feature = "async")]
mod tokio_event_provider;

pub use address_mutator::AddressMutator;
pub use address_provider::AddressProvider;
pub use capability::{Capability, CapabilityProvider};
pub use dns_mutator::DnsMutator;
pub use dns_provider::DnsProvider;
pub use event_provider::{EventProvider, EventReceiver, EventSender};
pub use interface_mutator::InterfaceMutator;
pub use interface_provider::InterfaceProvider;
pub use neighbor_provider::NeighborProvider;
pub use route_provider::RouteProvider;
#[cfg(feature = "async")]
pub use tokio_event_provider::{TokioEventReceiver, TokioEventSender};

/// Backend contract for native Tokio-based event delivery.
///
/// Implementations can expose operating-system notification mechanisms
/// directly through a Tokio-aware receiver without routing events through a
/// synchronous [`EventReceiver`] and a blocking adapter thread.
///
/// This trait is intended for backend implementations. Applications normally
/// subscribe through `Lattice::watch_async`.
///
/// Available with the `async` feature.
#[cfg(feature = "async")]
pub trait TokioEventProvider {
    /// The event type produced by the native watcher.
    type Event;
    /// The filter type accepted when creating a native watcher.
    type EventFilter;

    /// Creates a native Tokio-based watcher using `filter`.
    ///
    /// This method is intended for backend integration. Applications normally
    /// use `Lattice::watch_async`. The returned receiver owns the native
    /// subscription; dropping it releases associated backend resources and
    /// cancels event delivery.
    fn watch_tokio(
        &self,
        filter: Self::EventFilter,
    ) -> net_lattice_core::Result<TokioEventReceiver<Self::Event>>;
}