Struct wca::CommandsAggregator

source ·
pub struct CommandsAggregator { /* private fields */ }
Expand description

The CommandsAggregator struct is responsible for aggregating all commands that the user defines, and for parsing and executing them. It is the main entry point of the library.

CommandsAggregator component brings everything together. This component is responsible for configuring the Parser, Grammar, and Executor components based on the user’s needs. It also manages the entire pipeline of processing, from parsing the raw text input to executing the final command(parse -> validate -> execute).

§Example:

use wca::{ CommandsAggregator, Command, Routine, Type };

let ca = CommandsAggregator::former()
.grammar(
[
  Command::former()
  .phrase( "echo" )
  .hint( "prints all subjects and properties" )
  .subject( "argument", Type::String, false )
  .property( "property", "simple property", Type::String, false )
  .form(),
])
.executor(
[
  ( "echo".to_owned(), Routine::new( |( args, props )|
  {
    println!( "= Args\n{args:?}\n\n= Properties\n{props:?}\n" );
    Ok( () )
  })),
])
.build();

ca.perform( ".echo something" )?;

Implementations§

source§

impl CommandsAggregator

source

pub fn former() -> CommandsAggregatorFormer<CommandsAggregator, ReturnContainer>

Make former, variation of builder pattern to form structure defining values of fields step by step.

source§

impl CommandsAggregator

source

pub fn perform<S>(&self, program: S) -> Result<(), Error>
where S: IntoInput,

Parse, converts and executes a program

Takes a string with program and executes it

Trait Implementations§

source§

impl Debug for CommandsAggregator

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

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, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

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>,

§

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.
source§

impl<T> Any for T
where T: Any,