Struct uiua::SafeSys

pub struct SafeSys { /* private fields */ }

A safe backend with no IO other than captured stdout and stderr

Implementations

impl SafeSys

pub fn new() -> Self

Create a new safe system backend

pub fn take_stdout(&self) -> Vec<u8>

Take the captured stdout

pub fn take_stderr(&self) -> Vec<u8>

Take the captured stderr

Trait Implementations

impl Default for SafeSys

fn default() -> SafeSys

Returns the “default value” for a type.

impl SysBackend for SafeSys

fn any(&self) -> &dyn Any

Cast the backend to &dyn Any

fn any_mut(&mut self) -> &mut dyn Any

Cast the backend to &mut dyn Any

fn print_str_stdout(&self, s: &str) -> Result<(), String>

Print a string (without a newline) to stdout

fn print_str_stderr(&self, s: &str) -> Result<(), String>

Print a string (without a newline) to stderr

fn save_error_color(&self, message: String, colored: String)

Save a color-formatted version of an error message for later printing

fn print_str_trace(&self, s: &str)

Print a string that was create by trace

fn scan_line_stdin(&self) -> Result<Option<String>, String>

Read a line from stdin

fn set_raw_mode(&self, raw_mode: bool) -> Result<(), String>

Set the terminal to raw mode

fn var(&self, name: &str) -> Option<String>

Get an environment variable

fn term_size(&self) -> Result<(usize, usize), String>

Get the size of the terminal

fn file_exists(&self, path: &str) -> bool

Check if a file exists

fn list_dir(&self, path: &str) -> Result<Vec<String>, String>

List the contents of a directory

fn is_file(&self, path: &str) -> Result<bool, String>

Check if a path is a file

fn delete(&self, path: &str) -> Result<(), String>

Delete a file or directory

fn trash(&self, path: &str) -> Result<(), String>

Move a file or directory to the trash

fn read(&self, handle: Handle, count: usize) -> Result<Vec<u8>, String>

Read at most count bytes from a stream

fn read_all(&self, handle: Handle) -> Result<Vec<u8>, String>

Read from a stream until the end

fn read_until(&self, handle: Handle, delim: &[u8]) -> Result<Vec<u8>, String>

Read from a stream until a delimiter is reached

fn write(&self, handle: Handle, contents: &[u8]) -> Result<(), String>

Write bytes to a stream

fn create_file(&self, path: &Path) -> Result<Handle, String>

Create a file

fn open_file(&self, path: &Path) -> Result<Handle, String>

Open a file

fn file_read_all(&self, path: &Path) -> Result<Vec<u8>, String>

Read all bytes from a file

fn file_write_all(&self, path: &Path, contents: &[u8]) -> Result<(), String>

Write all bytes to a file

fn sleep(&self, seconds: f64) -> Result<(), String>

Sleep the current thread for seconds seconds

fn show_image(&self, image: DynamicImage) -> Result<(), String>

Show an image

fn show_gif(&self, gif_bytes: Vec<u8>) -> Result<(), String>

Show a GIF

fn play_audio(&self, wave_bytes: Vec<u8>) -> Result<(), String>

Play audio from WAV bytes

fn audio_sample_rate(&self) -> u32

Get the audio sample rate

fn stream_audio(&self, f: AudioStreamFn) -> Result<(), String>

Stream audio

fn tcp_listen(&self, addr: &str) -> Result<Handle, String>

Create a TCP listener and bind it to an address

fn tcp_accept(&self, handle: Handle) -> Result<Handle, String>

Accept a connection with a TCP listener

fn tcp_connect(&self, addr: &str) -> Result<Handle, String>

Create a TCP socket and connect it to an address

fn tcp_addr(&self, handle: Handle) -> Result<String, String>

Get the connection address of a TCP socket

fn tcp_set_non_blocking( &self, handle: Handle, non_blocking: bool ) -> Result<(), String>

Set a TCP socket to non-blocking mode

fn tcp_set_read_timeout( &self, handle: Handle, timeout: Option<Duration> ) -> Result<(), String>

Set the read timeout of a TCP socket

fn tcp_set_write_timeout( &self, handle: Handle, timeout: Option<Duration> ) -> Result<(), String>

Set the write timeout of a TCP socket

fn close(&self, handle: Handle) -> Result<(), String>

Close a stream

fn invoke(&self, path: &str) -> Result<(), String>

Invoke a path with the system’s default program

fn run_command_inherit( &self, command: &str, args: &[&str] ) -> Result<i32, String>

Run a command, inheriting standard IO

fn run_command_capture( &self, command: &str, args: &[&str] ) -> Result<(i32, String, String), String>

Run a command, capturing standard IO

fn run_command_stream( &self, command: &str, args: &[&str] ) -> Result<Handle, String>

Run a command and return an IO stream handle

fn change_directory(&self, path: &str) -> Result<(), String>

Change the current directory

fn https_get(&self, request: &str, handle: Handle) -> Result<String, String>

Make an HTTPS request on a TCP socket

fn ffi( &self, file: &str, result_ty: FfiType, name: &str, arg_tys: &[FfiType], args: &[Value] ) -> Result<Value, String>

Call a foreign function interface

fn load_git_module(&self, url: &str) -> Result<PathBuf, String>

Load a git repo as a module