Enum State 

pub enum State {
    Prompting((Options, bool)),
    Connecting(Option<JoinHandle<Result<Connection, (Options, Error)>>>),
    Connected(Connection),
    Running,
}

The current state of an attempted connection.

Variants

Prompting((Options, bool))

The user is being prompted for connection settings. (connection options, whether to try connecting)

Connecting(Option<JoinHandle<Result<Connection, (Options, Error)>>>)

A connection is being attempted. When modal is called, if the thread is finished the result dictates the following state.

Connected(Connection)

A connection has sucessfully been made.

Running

The connection has been made, and removed so is presumably being run by the application.

Implementations

impl State

pub fn new(cli_args: &ArgMatches) -> Self

Create a new ConnctionOptions from a clap::ArgMatches.

Assumes cli_args contains a single serial, a single network, or neither. If anything is passd on the cli attempts to make the connection, which may result in a None variant with the error field set.

Return

• Prompting(ConnectionOptions, bool) with the options, and whether to try connecting.
• Connected(Connection) with a connection.

Panics

• If a contained serial option can’t be converted into a port and optional baud.

pub fn modal( &mut self, modal: &Modal, tokio_handle: &Handle, cancel: Option<&mut bool>, extra_content: impl FnOnce(&mut Ui), ) -> bool

Populate the modal to prompt the user for connection (and other settings) settings, and change state is relevant.

Returns true if the state is running, allowing this method to be used as a guard to populating the rest of the application.

Panics

If a thread to create the connection can’t be started.

pub fn try_get_connection(&mut self) -> Option<Connection>

Try getting the created connection.

Returns

• None if the current state isn’t Connected.
• Some if the current state is Connected, also removes the Connection and sets the state to Running.

Trait Implementations

impl Debug for State

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

Formats the value using the given formatter.

impl Default for State

fn default() -> Self

Returns the “default value” for a type.