Struct Session 

pub struct Session {
    pub state: String,
    pub model: Option<String>,
    pub calibration: Option<f64>,
    pub questions: Vec<QuestionDraft>,
}

Fields

state: String

model: Option<String>

calibration: Option<f64>

questions: Vec<QuestionDraft>

Implementations

impl Session

pub fn load_from(path: &Path) -> Self

Read a session, or return an empty one for any reason at all.

pub fn load() -> Self

pub fn save_to(&self, path: &Path) -> Result<()>

Write the session beside path and rename it into place, so the file is always either the old session or the new one. Written in place, a crash between truncating and writing would leave a broken file, which loads as an empty form without a word.

pub fn clear_at(path: &Path) -> Result<()>

Forget the saved session. Emptying the form is a deliberate act, and leaving the old file behind would bring back on the next start what was just cleared.

pub fn persist(&self) -> Result<()>

Save a form worth keeping, or forget the saved one when the form is empty. Failure is reported rather than swallowed — the caller decides whether it is worth a message.

pub fn build<'a>(&self, client: &'a Client) -> SystemOne<'a>

Assemble the request this form describes, through the SDK’s own builder.

The request is built from the session rather than from the live widgets for two reasons. It makes what gets saved and what gets sent the same thing by construction — a reloaded form cannot send something different from the one that was saved. And it hands the background task an owned snapshot, so the request in flight is the form as it was when you pressed send, not as you have edited it since.

Nothing is validated here. cerno-core owns those rules, the OpenAPI document publishes them, and the service names both the offending question and what to do instead. A fourth copy in the client would be the one that drifts.

pub fn is_empty(&self) -> bool

Whether there is anything worth writing. An empty form should not leave a file behind.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.

impl Default for Session

fn default() -> Session

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Session

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Session

fn eq(&self, other: &Session) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Session

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Session