Struct OopRunOptions 

pub struct OopRunOptions {
    pub gear_name: String,
    pub config_gear_name: Option<String>,
    pub instance_id: Option<Uuid>,
    pub directory_endpoint: String,
    pub config_path: Option<PathBuf>,
    pub verbose: u8,
    pub print_config: bool,
    pub heartbeat_interval_secs: u64,
    pub version: Option<String>,
}

Configuration options for OoP gear bootstrap

Fields

gear_name: String

Logical gear name (e.g., “file-parser”)

This is the directory registration name, and since roles it is not always the gear’s own id. A role-split gear registers under its role’s directory name – event-broker-ingest for the cluster_ingest mode – while its configuration still lives under the gear id the #[toolkit::gear(name = ...)] attribute declares, because that is the key GearCtx::config() looks up. See Self::config_gear_name.

config_gear_name: Option<String>

The gears.<key> section this process’s configuration lives under.

None means the same as Self::gear_name, which is the answer for every gear that runs in one undifferentiated shape – so no existing caller changes behaviour.

It exists because gear_name was doing two jobs that used to be one string. The registry names a gear by its attribute, and GearCtx::config() reads gears.<that name>.config; a role changes the name the instance registers under and not the name it reads under. With the two conflated, a worker started as a role filed the master’s rendered blob under gears["event-broker-ingest"] while the gear read gears["event-broker"], so TOOLKIT_MODULE_CONFIG was inert under any role and only the local --config file had any effect. Nothing failed; the override simply did not arrive.

instance_id: Option<Uuid>

Instance ID (defaults to a random UUID if None)

directory_endpoint: String

Directory service gRPC endpoint (e.g., “http://127.0.0.1:50051”)

config_path: Option<PathBuf>

Path to configuration file

verbose: u8

Log verbosity level (0=default, 1=debug, 2=trace)

print_config: bool

Print effective configuration and exit

heartbeat_interval_secs: u64

Heartbeat interval in seconds (default: 5)

version: Option<String>

Gear version (used for DirectoryService registration and OpenAPI version). Defaults to None.

Implementations

impl OopRunOptions

pub fn config_gear_name(&self) -> &str

The gears.<key> section to read configuration from.

Self::config_gear_name when set, and Self::gear_name otherwise – so a caller that does not know about roles keeps exactly the behaviour it had.

Trait Implementations

impl Clone for OopRunOptions

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OopRunOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OopRunOptions

fn default() -> Self

Returns the “default value” for a type.