pub struct ServiceSpawner { /* private fields */ }Expand description
Unified service spawner.
Spawns Spawnable services with consistent lifecycle management,
regardless of execution mode.
§Example
use hyprstream_rpc::service::spawner::{ServiceSpawner, ProxyService};
use hyprstream_rpc::transport::TransportConfig;
// Spawn a REQ/REP service (RequestService implementations are directly Spawnable)
let service = MyRequestService::new(ctx, transport, verifying_key);
let spawner = ServiceSpawner::tokio();
let spawned = spawner.spawn(service).await?;
// Spawn an XSUB/XPUB proxy on dedicated thread
let proxy = ProxyService::new("events", ctx, pub_transport, sub_transport);
let spawner = ServiceSpawner::threaded();
let spawned = spawner.spawn(proxy).await?;
// Stop the service
spawned.stop().await?;Implementations§
Source§impl ServiceSpawner
impl ServiceSpawner
Sourcepub fn tokio() -> ServiceSpawner
pub fn tokio() -> ServiceSpawner
Create a spawner that runs services as tokio tasks.
Sourcepub fn threaded() -> ServiceSpawner
pub fn threaded() -> ServiceSpawner
Create a spawner that runs services on dedicated threads.
Each service gets its own thread with a single-threaded tokio runtime. Use this for services with !Send types (like tch-rs tensors).
Sourcepub fn subprocess(binary: PathBuf) -> ServiceSpawner
pub fn subprocess(binary: PathBuf) -> ServiceSpawner
Create a spawner that runs services as subprocesses.
The binary should be a hyprstream service <name> command.
Sourcepub fn subprocess_with(
binary: PathBuf,
process_spawner: ProcessSpawner,
) -> ServiceSpawner
pub fn subprocess_with( binary: PathBuf, process_spawner: ProcessSpawner, ) -> ServiceSpawner
Create a subprocess spawner with a custom process spawner.
Sourcepub fn mode(&self) -> &ServiceMode
pub fn mode(&self) -> &ServiceMode
Get the spawning mode.
Sourcepub async fn spawn<S>(&self, service: S) -> Result<SpawnedService, RpcError>where
S: Spawnable,
pub async fn spawn<S>(&self, service: S) -> Result<SpawnedService, RpcError>where
S: Spawnable,
Spawn any Spawnable service with registry integration.
This is the unified spawning API that works with both:
- Any
S: RequestService- REQ/REP services (directly Spawnable via blanket impl) ProxyService- XSUB/XPUB proxies
The service is automatically registered with the EndpointRegistry and unregistered when the returned handle is dropped.
§Example
// Spawn a REQ/REP service (RequestService implementations are directly Spawnable)
let service = MyRequestService::new(ctx, transport, verifying_key);
let spawned = spawner.spawn(service).await?;
// Spawn a proxy
let proxy = ProxyService::new("events", ctx, pub_transport, sub_transport);
let spawned = spawner.spawn(proxy).await?;Trait Implementations§
Source§impl Default for ServiceSpawner
impl Default for ServiceSpawner
Source§fn default() -> ServiceSpawner
fn default() -> ServiceSpawner
Auto Trait Implementations§
impl Freeze for ServiceSpawner
impl !RefUnwindSafe for ServiceSpawner
impl Send for ServiceSpawner
impl Sync for ServiceSpawner
impl Unpin for ServiceSpawner
impl UnsafeUnpin for ServiceSpawner
impl !UnwindSafe for ServiceSpawner
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more