Skip to main content

KernelRuntime

Struct KernelRuntime 

Source
pub struct KernelRuntime<S> { /* private fields */ }

Implementations§

Source§

impl<S> KernelRuntime<S>
where S: MemoryStore,

Source

pub fn load(store: S) -> Result<Self, RuntimeError>

Examples found in repository?
examples/runtime_persistence.rs (line 21)
19fn run() -> Result<(), Box<dyn std::error::Error>> {
20    let path = temp_state_path("runtime");
21    let mut runtime = KernelRuntime::load(JsonFileStore::new(&path))?;
22
23    let receipt = runtime.write_with_receipt("apps.demo.home.count", 3_u64)?;
24    let json = runtime_receipt_to_json(&receipt);
25
26    assert_eq!(json["events"][0]["path"][0], "apps");
27    assert_eq!(json["events"][0]["path"][2], "home");
28    assert_eq!(json["events"][0]["value"], 3.0);
29
30    let restored = KernelRuntime::load(JsonFileStore::new(&path))?;
31    assert_eq!(
32        restored.read("apps.demo.home.count"),
33        Some(&Value::from(3_u64))
34    );
35    assert!(restored.events().is_empty());
36
37    println!("{json}");
38    let _ = fs::remove_file(path);
39    Ok(())
40}
Source

pub fn new(kernel: Kernel, store: S) -> Self

Source

pub fn kernel(&self) -> &Kernel

Source

pub fn kernel_mut(&mut self) -> &mut Kernel

Source

pub fn store(&self) -> &S

Source

pub fn save(&self) -> Result<(), RuntimeError>

Source

pub fn read(&self, path: impl IntoPath) -> Option<&Value>

Examples found in repository?
examples/runtime_persistence.rs (line 32)
19fn run() -> Result<(), Box<dyn std::error::Error>> {
20    let path = temp_state_path("runtime");
21    let mut runtime = KernelRuntime::load(JsonFileStore::new(&path))?;
22
23    let receipt = runtime.write_with_receipt("apps.demo.home.count", 3_u64)?;
24    let json = runtime_receipt_to_json(&receipt);
25
26    assert_eq!(json["events"][0]["path"][0], "apps");
27    assert_eq!(json["events"][0]["path"][2], "home");
28    assert_eq!(json["events"][0]["value"], 3.0);
29
30    let restored = KernelRuntime::load(JsonFileStore::new(&path))?;
31    assert_eq!(
32        restored.read("apps.demo.home.count"),
33        Some(&Value::from(3_u64))
34    );
35    assert!(restored.events().is_empty());
36
37    println!("{json}");
38    let _ = fs::remove_file(path);
39    Ok(())
40}
Source

pub fn read_fresh(&mut self, path: impl IntoPath) -> Option<Value>

Source

pub fn write( &mut self, path: impl IntoPath, value: impl Into<Value>, ) -> Result<Memory, RuntimeError>

Source

pub fn write_with_receipt( &mut self, path: impl IntoPath, value: impl Into<Value>, ) -> Result<RuntimeReceipt<Memory>, RuntimeError>

Examples found in repository?
examples/runtime_persistence.rs (line 23)
19fn run() -> Result<(), Box<dyn std::error::Error>> {
20    let path = temp_state_path("runtime");
21    let mut runtime = KernelRuntime::load(JsonFileStore::new(&path))?;
22
23    let receipt = runtime.write_with_receipt("apps.demo.home.count", 3_u64)?;
24    let json = runtime_receipt_to_json(&receipt);
25
26    assert_eq!(json["events"][0]["path"][0], "apps");
27    assert_eq!(json["events"][0]["path"][2], "home");
28    assert_eq!(json["events"][0]["value"], 3.0);
29
30    let restored = KernelRuntime::load(JsonFileStore::new(&path))?;
31    assert_eq!(
32        restored.read("apps.demo.home.count"),
33        Some(&Value::from(3_u64))
34    );
35    assert!(restored.events().is_empty());
36
37    println!("{json}");
38    let _ = fs::remove_file(path);
39    Ok(())
40}
Source

pub fn execute( &mut self, target: impl AsRef<str>, body: Option<ExecuteValue>, ) -> Result<ExecuteValue, RuntimeError>

Source

pub fn execute_with_receipt( &mut self, target: impl AsRef<str>, body: Option<ExecuteValue>, ) -> Result<RuntimeReceipt<ExecuteValue>, RuntimeError>

Source

pub fn events(&self) -> &[KernelEvent]

Examples found in repository?
examples/runtime_persistence.rs (line 35)
19fn run() -> Result<(), Box<dyn std::error::Error>> {
20    let path = temp_state_path("runtime");
21    let mut runtime = KernelRuntime::load(JsonFileStore::new(&path))?;
22
23    let receipt = runtime.write_with_receipt("apps.demo.home.count", 3_u64)?;
24    let json = runtime_receipt_to_json(&receipt);
25
26    assert_eq!(json["events"][0]["path"][0], "apps");
27    assert_eq!(json["events"][0]["path"][2], "home");
28    assert_eq!(json["events"][0]["value"], 3.0);
29
30    let restored = KernelRuntime::load(JsonFileStore::new(&path))?;
31    assert_eq!(
32        restored.read("apps.demo.home.count"),
33        Some(&Value::from(3_u64))
34    );
35    assert!(restored.events().is_empty());
36
37    println!("{json}");
38    let _ = fs::remove_file(path);
39    Ok(())
40}
Source

pub fn events_matching( &self, path: impl IntoPath, ) -> Result<Vec<KernelEvent>, RuntimeError>

Source

pub fn drain_events(&mut self) -> Vec<KernelEvent>

Source

pub fn drain_events_matching( &mut self, path: impl IntoPath, ) -> Result<Vec<KernelEvent>, RuntimeError>

Trait Implementations§

Source§

impl<S: Debug> Debug for KernelRuntime<S>

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<S> Freeze for KernelRuntime<S>
where S: Freeze,

§

impl<S> RefUnwindSafe for KernelRuntime<S>
where S: RefUnwindSafe,

§

impl<S> Send for KernelRuntime<S>
where S: Send,

§

impl<S> Sync for KernelRuntime<S>
where S: Sync,

§

impl<S> Unpin for KernelRuntime<S>
where S: Unpin,

§

impl<S> UnsafeUnpin for KernelRuntime<S>
where S: UnsafeUnpin,

§

impl<S> UnwindSafe for KernelRuntime<S>
where S: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.