Struct bastion::executor::ProcStack

pub struct ProcStack {
    pub pid: AtomicUsize,
    // some fields omitted
}

Stack abstraction for lightweight processes

Example

use lightproc::proc_stack::ProcStack;
use lightproc::proc_state::EmptyProcState;

ProcStack::default()
    .with_before_start(|s: &mut EmptyProcState| { println!("Before start"); })
    .with_after_complete(|s: &mut EmptyProcState| { println!("After complete"); })
    .with_after_panic(|s: &mut EmptyProcState| { println!("After panic"); });

Fields

pid: AtomicUsize

Process ID for the Lightweight Process

Can be used to identify specific processes during any executor, reactor implementations.

Implementations

impl ProcStack

pub fn with_pid(self, pid: usize) -> ProcStack

Adds pid for the process which is going to take this stack

Example

use lightproc::proc_stack::ProcStack;

ProcStack::default()
    .with_pid(1);

pub fn with_state<S>(self, state: S) -> ProcStack where
    S: 'static + State, 

Adds state for the process which is going to be embedded into this stack.

Example

use lightproc::proc_stack::ProcStack;

pub struct GlobalState {
   pub amount: usize
}

ProcStack::default()
    .with_pid(1)
    .with_state(GlobalState { amount: 1 });

pub fn with_before_start<C, S>(self, callback: C) -> ProcStack where
    S: State,
    C: 'static + Fn(&mut S) + Send + Sync, 

Adds a callback that will be executed before polling inner future to the stack

use lightproc::proc_stack::{ProcStack};
use lightproc::proc_state::EmptyProcState;

ProcStack::default()
    .with_before_start(|s: &mut EmptyProcState| { println!("Before start"); });

pub fn with_after_complete<C, S>(self, callback: C) -> ProcStack where
    S: State,
    C: 'static + Fn(&mut S) + Send + Sync, 

Adds a callback that will be executed after inner future resolves to an output to the stack

use lightproc::proc_stack::ProcStack;
use lightproc::proc_state::EmptyProcState;

ProcStack::default()
    .with_after_complete(|s: &mut EmptyProcState| { println!("After complete"); });

pub fn with_after_panic<C, S>(self, callback: C) -> ProcStack where
    S: State,
    C: 'static + Fn(&mut S) + Send + Sync, 

Adds a callback that will be executed after inner future panics to the stack

use lightproc::proc_stack::ProcStack;
use lightproc::proc_state::EmptyProcState;

ProcStack::default()
    .with_after_panic(|s: &mut EmptyProcState| { println!("After panic"); });

pub fn get_pid(&self) -> usize

Utility function to get_pid for the implementation of executors.

use lightproc::proc_stack::ProcStack;

let proc = ProcStack::default().with_pid(123);

assert_eq!(proc.get_pid(), 123);

pub fn get_state<S>(&self) -> S where
    S: 'static + State + Copy, 

Get the state which is embedded into this ProcStack.

use lightproc::proc_stack::ProcStack;

#[derive(Copy, Clone)]
pub struct GlobalState {
   pub amount: usize
}

let mut proc = ProcStack::default().with_pid(123)
            .with_state(GlobalState { amount: 0} );

let state = proc.get_state::<GlobalState>();

Trait Implementations

impl Clone for ProcStack

pub fn clone(&self) -> ProcStack

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ProcStack

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

Formats the value using the given formatter.

impl Default for ProcStack

Default implementation for the ProcStack

pub fn default() -> ProcStack

Returns the “default value” for a type.