lenso 0.5.30

Rust authoring and Host facade for Lenso applications and Plugins.
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

//! The stable Rust interface for Lenso Plugins and product Hosts.
//!
//! Adapter and Kernel implementation details remain behind generated glue.

mod provider_stream;
mod typed_extension;

#[cfg(feature = "host")]
pub mod host;

pub use lenso_native_adapter::{
    ConfiguredPluginFactory, Lifecycle, LifecycleContext, ManagedTasks, ManagedTasksError,
    NativePluginDefinition, PluginConfig, link_plugin, plugin, plugin_impl, provides,
};
use lenso_plugin_authoring::PluginError as AuthoringPluginError;
pub use lenso_plugin_authoring::{
    BoundCapabilityClient, CapabilityClient, CapabilityClientMany, ManyPort, Port,
};

pub use provider_stream::{ProviderStream, ProviderStreamChannel, StreamInput};
pub use typed_extension::{CtxExt, TypedExtension, TypedExtensionError};

pub use lenso_kernel::{
    ActivateContext, CancellationToken, DeactivateContext, InvocationContext as Ctx,
    ManagedTaskScope, PluginFuture, PrepareContext, RuntimeFailure,
};

/// An operation failure preserving Domain and Runtime failures.
pub type PluginError<DomainError> = AuthoringPluginError<DomainError, RuntimeFailure>;

/// A Plugin operation result preserving Domain and Runtime failures.
pub type PluginResult<T, DomainError> = Result<T, PluginError<DomainError>>;

/// An asynchronous Event handler outcome observed by the Adapter after admission.
///
/// Event handlers have no publisher-visible Domain result. Returning a Runtime Failure lets the
/// Adapter report diagnostics and apply Plugin supervision after the Event was admitted.
pub type PluginEventResult = Result<(), RuntimeFailure>;

/// Common imports for native Rust Plugin authors.
pub mod prelude {
    pub use crate::{
        ActivateContext, BoundCapabilityClient, CancellationToken, CapabilityClient,
        CapabilityClientMany, Ctx, CtxExt, DeactivateContext, Lifecycle, LifecycleContext,
        ManagedTaskScope, ManagedTasks, ManagedTasksError, ManyPort, PluginConfig, PluginError,
        PluginEventResult, PluginFuture, PluginResult, Port, PrepareContext, ProviderStream,
        ProviderStreamChannel, RuntimeFailure, StreamInput, TypedExtension, TypedExtensionError,
        plugin, plugin_impl, provides,
    };
}

/// Implementation details used only by generated Plugin glue.
#[doc(hidden)]
pub mod __private {
    pub use lenso_native_adapter::__private::*;
}