program_tools 0.2.0

Rust script runner — compile and execute Rust files as scripts with output capture.
Documentation 
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

/// Internal namespace.
mod private
{
  use former::Former;
  use crate::run_options::RunOptions;

  /// Source configuration for a program.
  #[ derive( Debug, Former ) ]
  pub struct Source
  {
    /// Relative path to source file within the workspace (e.g., `"src/main.rs"`).
    pub file_path : String,
    /// Source code content as plain text.
    pub data : String,
  }

  /// Program configuration: an ordered collection of source files.
  #[ derive( Debug, Former ) ]
  pub struct Program
  {
    /// Ordered collection of source files comprising the compilable crate.
    #[ subform_entry ]
    pub source : Vec< Source >,
    /// Optional inline Cargo manifest content. When `None`, the runner generates
    /// a minimal default manifest. Must be valid TOML when provided.
    pub manifest : Option< String >,
  }

  /// Top-level execution plan: program definition and runtime configuration.
  #[ derive( Debug, Former ) ]
  pub struct Plan
  {
    /// The program to compile and execute.
    #[ subform_scalar ]
    pub program : Program,
    /// Execution configuration. `None` means use `RunOptions::default()`.
    pub run_options : Option< RunOptions >,
  }
}

mod_interface::mod_interface!
{
  exposed use private::
  {
    Source,
    Program,
    Plan,
  };

  prelude use private::
  {
    Source,
    Program,
    Plan,
  };
}