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 threaded() -> Self
pub fn threaded() -> Self
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) -> Self
pub fn subprocess(binary: PathBuf) -> Self
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) -> Self
pub fn subprocess_with(binary: PathBuf, process_spawner: ProcessSpawner) -> Self
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: Spawnable>(&self, service: S) -> Result<SpawnedService>
pub async fn spawn<S: Spawnable>(&self, service: S) -> Result<SpawnedService>
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§
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
Mutably borrows from an owned value. Read more
§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>
Converts
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>
Converts
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§impl<T> NoneValue for Twhere
T: Default,
impl<T> NoneValue for Twhere
T: Default,
type NoneType = T
§fn null_value() -> T
fn null_value() -> T
The none-equivalent value.
§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
§impl<T> ServiceExt for T
impl<T> ServiceExt for T
§fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>where
Self: Sized,
fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>where
Self: Sized,
Apply a transformation to the response body. Read more
§fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>where
Self: Sized,
fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>where
Self: Sized,
High level tracing that classifies responses using HTTP status codes. Read more
§fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>where
Self: Sized,
fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>where
Self: Sized,
High level tracing that classifies responses using gRPC headers. Read more