wca 0.46.0

The tool to make CLI ( commands user interface ). It is able to aggregate external binary applications, as well as functions, which are written in your language. 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

mod private
{
  use std ::collections ::HashMap;

  /// Represents a program that contains one or more namespaces, where each namespace contains a list of commands.
  ///
  /// A `Program` consists of one or more commannd
  ///
  /// The program can be executed by iterating over each commands and executing it
  // aaa: xxx: for Bohdan: Commands should be here instead of Namespace
  // aaa: remove concept Namespace
  // aaa: introduce concept Dictionary for grammar
  // aaa: done
  #[ derive( Debug, Clone, PartialEq, Eq ) ]
  pub struct Program< Command >
  {
  /// list of namespaces with commands
  pub commands: Vec< Command >,
 }

  /// Represents a parsed command that has been extracted from an input string by a `Parser`.
  ///
  /// The `ParsedCommand` struct is designed to be flexible and allow for a wide variety of commands to be parsed and represented. However, this flexibility also means that a `ParsedCommand` may contain invalid or unexpected data.
  ///
  /// # Example :
  ///
  /// ```
  /// # use wca ::parser ::ParsedCommand;
  /// # use std ::collections ::HashMap;
  /// ParsedCommand
  /// {
  ///   name: "command".to_string(),
  ///   subjects: vec![ "subject_value".to_string(), /* ... */ ],
  ///   properties: HashMap ::from_iter(
  ///   [
  ///     ( "prop_name".to_string(), "raw_prop_value".to_string() ),
  ///     /* ... */
  /// ])
  /// };
  /// ```
  ///
  /// In the above example, a `ParsedCommand` instance is created with the name "command", a single subject "`subject_value`", and one property "`prop_name`" with a raw value of "`raw_prop_value`".
  ///
  #[ derive( Default, Debug, Clone, PartialEq, Eq ) ]
  pub struct ParsedCommand
  {
  /// name of command without delimiter
  pub name: String,
  /// list of all subjects for the command
  pub subjects: Vec< String >,
  /// dictionary of properties. Each property has a name and a raw value
  pub properties: HashMap< String, String >
 }
}

//

crate ::mod_interface!
{
  orphan use Program;
  orphan use ParsedCommand;
}