genfile_core 0.10.0

File generation tools for code generation and template materialization.
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

/// Parameter management for templates
/// Parameter descriptor defining a single template parameter.
///
/// Stores metadata about a parameter including its name, whether it's mandatory,
/// optional default value, and description.
///
/// # Examples
///
/// ```rust,ignore
/// use genfile_core::ParameterDescriptor;
///
/// // Direct construction
/// let param = ParameterDescriptor
/// {
///   parameter: "project_name".into(),
///   is_mandatory: true,
///   default_value: None,
///   description: Some( "Name of the project".into() ),
/// };
///
/// // Builder pattern
/// let param = ParameterDescriptor::former()
///   .parameter( "project_name" )
///   .is_mandatory( true )
///   .description( "Name of the project" )
///   .form();
/// ```
#[derive(Debug, Clone)]
#[cfg_attr(any(feature = "json", feature = "yaml"), derive(serde::Serialize, serde::Deserialize))]
pub struct ParameterDescriptor
{
  /// Parameter name
  pub parameter: String,
  /// Whether this parameter is mandatory
  pub is_mandatory: bool,
  /// Optional default value
  pub default_value: Option< String >,
  /// Optional description
  pub description: Option< String >,
}

/// Collection of parameter descriptors for a template.
///
/// Provides methods for validation and extracting mandatory parameters.
///
/// # Examples
///
/// ```rust,ignore
/// use genfile_core:: { Parameters, ParameterDescriptor };
///
/// // Direct construction
/// let params = Parameters
/// {
///   descriptors: vec!
///   [
///     ParameterDescriptor
///     {
///       parameter: "name".into(),
///       is_mandatory: true,
///       default_value: None,
///       description: None,
///     },
///   ],
/// };
///
/// // Builder pattern
/// let params = Parameters::former()
///   .descriptors( vec!
///   [
///     ParameterDescriptor::former()
///       .parameter( "name" )
///       .is_mandatory( true )
///       .form(),
///   ])
///   .form();
///
/// let mandatory = params.list_mandatory();
/// assert_eq!( mandatory.len(), 1 );
/// ```
#[derive(Debug, Clone, Default)]
#[cfg_attr(any(feature = "json", feature = "yaml"), derive(serde::Serialize, serde::Deserialize))]
pub struct Parameters
{
  /// List of parameter descriptors
  pub descriptors: Vec< ParameterDescriptor >,
}

impl Parameters
{
  /// Returns a list of all mandatory parameter names.
  ///
  /// # Returns
  ///
  /// Vector of parameter names that have `is_mandatory = true`.
  ///
  /// # Examples
  ///
  /// ```rust,ignore
  /// use genfile_core:: { Parameters, ParameterDescriptor };
  ///
  /// let params = Parameters
  /// {
  ///   descriptors: vec!
  ///   [
  ///     ParameterDescriptor
  ///     {
  ///       parameter: "name".into(),
  ///       is_mandatory: true,
  ///       default_value: None,
  ///       description: None,
  ///     },
  ///   ],
  /// };
  ///
  /// let mandatory = params.list_mandatory();
  /// assert_eq!( mandatory, vec![ "name" ] );
  /// ```
  #[must_use] 
  pub fn list_mandatory( &self ) -> Vec< &str >
  {
    self
      .descriptors
      .iter()
      .filter( | d | d.is_mandatory )
      .map( | d | d.parameter.as_str() )
      .collect()
  }
}