Struct State

pub struct State {
    pub storage: Storage,
    pub stdin: Box<dyn BufRead>,
    pub stdout: WriteHandle,
    pub stderr: WriteHandle,
    /* private fields */
}

Fields

storage: Storage

stdin: Box<dyn BufRead>

stdout: WriteHandle

stderr: WriteHandle

Implementations

impl State

pub fn new() -> Self

Creates a new state for running a program.

You must use a method such as with_code or with_source_file to set the program source code before using run to execute it.

pub fn with_code(self, code: impl AsRef<str>) -> Self

Sets the code that will be executed.

pub fn with_source_file(self, path: impl AsRef<Path>) -> Result<Self>

Sets both the code and the current directory by reading from the given file path.

Errors

Returns an error if reading from the file failed.

Panics

Panics if the path is invalid.

pub fn with_source_directory(self, dir_path: impl AsRef<Path>) -> Self

Sets the source directory for resolving imports to the given directory.

pub fn with_cwd(self) -> Self

Sets the current directory to the operating systems current working directory.

Panics

Panics if env::current_dir returned an error.

pub fn run(&mut self) -> Result<Atom>

Runs the given program with the details specified by this state.

Returns the result the program returned.

Panics

Panics if code was not set.

pub const fn make_type_id(&mut self) -> i64

Returns a new type id for a type call.

Trait Implementations

impl Default for State

fn default() -> Self

Returns the “default value” for a type.