The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

DDUMONT / Config-Model-Itself-2.024 / lib / Config / Model / models / Itself / Element.pl 

            

              
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
129

              
#
# This file is part of Config-Model-Itself
#
# This software is Copyright (c) 2007-2019 by Dominique Dumont.
#
# This is free software, licensed under:
#
#   The GNU Lesser General Public License, Version 2.1, February 1999
#
#    Copyright (c) 2007-2008 Dominique Dumont.
#
#    This file is part of Config-Model-Itself.
#
#    Config-Model-Itself is free software; you can redistribute it
#    and/or modify it under the terms of the GNU Lesser Public License
#    as published by the Free Software Foundation; either version 2.1
#    of the License, or (at your option) any later version.
#
#    Config-Model-Itself is distributed in the hope that it will be
#    useful, but WITHOUT ANY WARRANTY; without even the implied
#    warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
#    See the GNU Lesser Public License for more details.
#
#    You should have received a copy of the GNU Lesser Public License
#    along with Config-Model-Itself; if not, write to the Free Software
#    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
use strict;
use warnings;
return [
 [
  name => "Itself::Element",
  include => ['Itself::NonWarpableElement' ,'Itself::WarpableElement'],
  include_after => 'type' , 
  'element' 
  => [
      # structural information
      'type' => { type => 'leaf',
                  value_type => 'enum',
                  choice => [qw/node warped_node hash list leaf check_list/],
                  mandatory => 1 ,
                  description => 'specify the type of the configuration element.'
                               . 'Leaf is used for plain value.',
                },
      # all elements
      'status' 
      => {
          type => 'leaf',
          value_type => 'enum', 
          choice => [qw/obsolete deprecated standard/],
          upstream_default => 'standard' ,
         },
       'level' 
       => {
           type => 'leaf',
           value_type => 'enum', 
           choice => [qw/important normal hidden/] ,
           upstream_default => 'normal',
           description => 'Used to highlight important parameter or to hide others. Hidden parameter are mostly used to hide features that are unavailable at start time. They can be made available later using warp mechanism',
          },
      'summary' 
      => {
          type => 'leaf',
          value_type => 'uniline', 
          description => 'enter short information regarding this element',
         },
      'description' 
      => {
          type => 'leaf',
          value_type => 'string', 
          description => 'enter detailed help information regarding this element',
         },
      # all but node or warped_node
      'warp' => {
          type => 'warped_node',
          level => 'hidden',
          config_class_name => 'Itself::WarpValue',
          warp => {
              follow => { elt_type => '- type' },
              rules  => [
                  '$elt_type ne "node"' => { level => 'normal' }
              ]
          },
          description => "change the properties (i.e. default value or its value_type) dynamically according to the value of another Value object located elsewhere in the configuration tree. "
      },
      # hash or list
      'index_type' 
      => { type => 'leaf',
           value_type => 'enum',
           level      => 'hidden' ,
           warp => { follow => '?type',
                     'rules'
                     => { 'hash' => {
                                     level => 'important',
                                     mandatory => 1,
                                     choice => [qw/string integer/] ,
                                    }
                        }
                   },
           description => 'Specify the type of allowed index for the hash. "String" means no restriction.',
         },
      'cargo' => {
          type => 'warped_node',
          level => 'hidden',
          warp => {
              follow => { 't' => '- type' },
              'rules' => [
                  '$t eq "list" or $t eq "hash"' => {
                      level => 'normal',
                      config_class_name => 'Itself::CargoElement',
                  },
              ],
          },
          description => 'Specify the properties of the configuration element configuration in this hash or list',
      }
  ],
 ],
];