Struct ActorBuilder 

pub struct ActorBuilder<'a, E: Event, T: Topic<E>, A: Actor<Event = E>> { /* private fields */ }

Builder for registering an actor with custom configuration.

Returned by Supervisor::build_actor. Use this when you need to override per-actor settings such as channel capacity or when you want to separate actor construction from topic subscription.

Defaults to no topic subscriptions and channel capacity inherited from the global SupervisorConfig.

Examples

// Custom channel capacity for a slow consumer
sup.build_actor("writer", |ctx| Writer::new(ctx))
    .topics(&[Topic::Data])
    .channel_capacity(512)
    .build()?;

// Replace the entire actor config
sup.build_actor("fast", |ctx| Fast::new(ctx))
    .topics(Subscribe::all())
    .config(my_config)
    .build()?;

Implementations

impl<'a, E: Event, T: Topic<E>, A: Actor<Event = E>> ActorBuilder<'a, E, T, A>

pub fn topics<S>(self, topics: S) -> Self

where S: Into<Subscribe<E, T>>,

Set the topics this actor subscribes to.

Accepts anything that converts to Subscribe: a topic slice, Subscribe::all(), or Subscribe::none().

pub fn config<C>(self, config: C) -> Self

where C: Into<ActorConfig>,

Replace the entire ActorConfig for this actor.

pub fn with_config<F>(self, f: F) -> Self

where F: FnOnce(ActorConfig) -> ActorConfig,

Transform the current ActorConfig with a closure.

Unlike config() which replaces the entire config, this preserves inherited defaults and lets you tweak individual fields.

sup.build_actor("consumer", |ctx| Consumer::new(ctx))
    .topics(&[Topic::Data])
    .channel_capacity(256)
    .with_config(|c| c.with_max_events_per_tick(64))
    .build()?;

pub fn channel_capacity(self, capacity: usize) -> Self

Set the actor’s mailbox channel capacity.

Shorthand for modifying the channel capacity without replacing the full config. See ActorConfig::with_channel_capacity.

pub fn build(self) -> Result<ActorId>

Register the actor with the supervisor and return its ActorId.

Errors

Returns Error::DuplicateActorName if an actor with the same name is already registered.