Struct ProcessStartArgs 

pub struct ProcessStartArgs {
    pub next_handlers_count: usize,
    pub yield_count: u16,
    /* private fields */
}

Arguments for on_process_start handlers.

Empty in this release.

Fields

next_handlers_count: usize

Number of start handlers yet to run.

yield_count: u16

Number of times this handler has yielded.

If this exceeds 32 times the handler is ignored.

Implementations

impl ProcessStartArgs

pub const MAX_YIELD_COUNT: u16 = 32

Yield requests after this are ignored.

pub fn yield_once(&self)

Let other process start handlers run first.

The handler must call this if it takes over the process and it cannot determinate if it should from the environment.

fn run_foo_process() {}
on_process_start!(|args| {
    if args.yield_count == 0 {
        return args.yield_once();
    }

    // yielded once, handlers that affect all processes (loggers, tracers) are inited now
    if std::env::var("IS_FOO").is_ok() {
        // take over as "foo" process
        run_foo_process();
        zng_env::exit(0);
    }
});

pub fn yield_until_app(&self) -> bool

Yields until is running the the app-process.

Returns true if should skip the handler.

on_process_start!(|args| {
    if args.yield_until_app() {
        return;
    }

    println!("Is running in the app-process");
});

Note that the handler is still called before the APP context starts, you can register a APP.on_init handler to run in the new app context.