como 0.0.2 → 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (58) hide show
  1. data/CHANGELOG.rdoc +12 -0
  2. data/README.rdoc +11 -5
  3. data/Rakefile +6 -1
  4. data/doc/Como/ArgsParseState.html +912 -0
  5. data/doc/Como/ComoCommon.html +305 -0
  6. data/doc/Como/MainOpt.html +636 -0
  7. data/doc/Como/MasterOpt.html +636 -0
  8. data/doc/Como/Opt/ErrorWithData.html +304 -0
  9. data/doc/Como/Opt/InvalidOption.html +158 -0
  10. data/doc/Como/Opt/MissingArgument.html +158 -0
  11. data/doc/Como/Opt.html +6098 -0
  12. data/doc/Como/RuleCheck.html +933 -0
  13. data/doc/Como/RuleDisplay.html +1193 -0
  14. data/doc/Como/Spec.html +1750 -0
  15. data/doc/Como.html +625 -0
  16. data/doc/_index.html +242 -0
  17. data/doc/class_list.html +53 -0
  18. data/doc/css/common.css +1 -0
  19. data/doc/css/full_list.css +57 -0
  20. data/doc/css/style.css +338 -0
  21. data/doc/file.CHANGELOG.html +90 -0
  22. data/doc/file.README.html +94 -0
  23. data/doc/file.como.html +1962 -0
  24. data/doc/file_list.html +58 -0
  25. data/doc/frames.html +28 -0
  26. data/doc/index.html +94 -0
  27. data/doc/js/app.js +214 -0
  28. data/doc/js/full_list.js +178 -0
  29. data/doc/js/jquery.js +4 -0
  30. data/doc/method_list.html +838 -0
  31. data/doc/top-level-namespace.html +112 -0
  32. data/lib/como.rb +1660 -661
  33. data/test/como_compatible +37 -0
  34. data/test/como_config +44 -0
  35. data/test/como_options +36 -0
  36. data/test/como_queries +44 -0
  37. data/test/como_rule_1 +28 -0
  38. data/test/como_rule_2 +28 -0
  39. data/test/como_subcmd +72 -0
  40. data/test/como_subcmd_config +88 -0
  41. data/test/golden/compatible.txt +438 -0
  42. data/test/golden/config.txt +319 -0
  43. data/test/golden/options.txt +438 -0
  44. data/test/golden/queries.txt +78 -0
  45. data/test/golden/rule_1.txt +454 -0
  46. data/test/golden/rule_2.txt +476 -0
  47. data/test/golden/subcmd.txt +360 -0
  48. data/test/golden/subcmd_config.txt +534 -0
  49. data/test/test_como.rb +22 -328
  50. data/test/test_compatible +28 -0
  51. data/test/test_config +12 -0
  52. data/test/test_options +28 -0
  53. data/test/test_queries +7 -0
  54. data/test/test_rule_1 +27 -0
  55. data/test/test_rule_2 +27 -0
  56. data/test/test_subcmd +30 -0
  57. data/test/test_subcmd_config +31 -0
  58. metadata +62 -6
data/doc/file.como.html ADDED
@@ -0,0 +1,1962 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
+ <head>
5
+ <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII" />
6
+ <title>
7
+ File: como
8
+
9
+ &mdash; Documentation by YARD 0.8.6.1
10
+
11
+ </title>
12
+
13
+ <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
14
+
15
+ <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
16
+
17
+ <script type="text/javascript" charset="utf-8">
18
+ hasFrames = window.top.frames.main ? true : false;
19
+ relpath = '';
20
+ framesUrl = "frames.html#!" + escape(window.location.href);
21
+ </script>
22
+
23
+
24
+ <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
25
+
26
+ <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
27
+
28
+
29
+ </head>
30
+ <body>
31
+ <div id="header">
32
+ <div id="menu">
33
+
34
+ <a href="_index.html">Index</a> &raquo;
35
+ <span class="title">File: como</span>
36
+
37
+
38
+ <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
39
+ </div>
40
+
41
+ <div id="search">
42
+
43
+ <a class="full_list_link" id="class_list_link"
44
+ href="class_list.html">
45
+ Class List
46
+ </a>
47
+
48
+ <a class="full_list_link" id="method_list_link"
49
+ href="method_list.html">
50
+ Method List
51
+ </a>
52
+
53
+ <a class="full_list_link" id="file_list_link"
54
+ href="file_list.html">
55
+ File List
56
+ </a>
57
+
58
+ </div>
59
+ <div class="clear"></div>
60
+ </div>
61
+
62
+ <iframe id="search_frame"></iframe>
63
+
64
+ <div id="content"><div id='filecontents'><pre class="code ruby"><span class='comment'># = Como
65
+ </span><span class='comment'>#
66
+ </span><span class='comment'># == Introduction
67
+ </span><span class='comment'>#
68
+ </span><span class='comment'># Como provides low manifest command line option parsing and
69
+ </span><span class='comment'># deployment. The command line options are described in compact table
70
+ </span><span class='comment'># format and option values are stored to conveniently named
71
+ </span><span class='comment'># properties. Como provides the command usage information based on the
72
+ </span><span class='comment'># option table (+ generic program info) automatically. Como supports
73
+ </span><span class='comment'># also subcommands and checking for option combinations using a simple
74
+ </span><span class='comment'># DSL.
75
+ </span><span class='comment'>#
76
+ </span><span class='comment'>#
77
+ </span><span class='comment'>#
78
+ </span><span class='comment'># == Usage Examples
79
+ </span><span class='comment'>#
80
+ </span><span class='comment'># === Simple example
81
+ </span><span class='comment'>#
82
+ </span><span class='comment'># Below is a small example program (&quot;como_simple&quot;) that demonstrates
83
+ </span><span class='comment'># typical usage.
84
+ </span><span class='comment'>#
85
+ </span><span class='comment'># ==== Program listing
86
+ </span><span class='comment'>#
87
+ </span><span class='comment'># require &quot;como&quot;
88
+ </span><span class='comment'># include Como
89
+ </span><span class='comment'>#
90
+ </span><span class='comment'># # Define command line arguments:
91
+ </span><span class='comment'># Spec.command( &quot;como_simple&quot;, &quot;Programmer&quot;, &quot;2013&quot;,
92
+ </span><span class='comment'># [
93
+ </span><span class='comment'># [ :single, &quot;file&quot;, &quot;-f&quot;, &quot;File argument.&quot; ],
94
+ </span><span class='comment'># [ :switch, &quot;debug&quot;, &quot;-d&quot;, &quot;Enable debugging.&quot; ],
95
+ </span><span class='comment'># ] )
96
+ </span><span class='comment'>#
97
+ </span><span class='comment'># puts &quot; File option: #{Opt['file'].value}&quot;
98
+ </span><span class='comment'># puts &quot; Debugging selected!&quot; if Opt['debug'].given
99
+ </span><span class='comment'>#
100
+ </span><span class='comment'># &quot;Spec.defineCheckHelp&quot; method takes 4 arguments:
101
+ </span><span class='comment'># [progname] Name of the program (or command).
102
+ </span><span class='comment'># [author] Author of the program.
103
+ </span><span class='comment'># [year] Year (or any date) for the program.
104
+ </span><span class='comment'># [option table] Description of the command options in format with 4
105
+ </span><span class='comment'># entries in each sub-array.
106
+ </span><span class='comment'>#
107
+ </span><span class='comment'># Help is added silenty by default:
108
+ </span><span class='comment'># [ :silent, &quot;help&quot;, &quot;-h&quot;, &quot;Display usage info.&quot; ],
109
+ </span><span class='comment'>#
110
+ </span><span class='comment'># Each option table entry is an Array of 4 values: type, name,
111
+ </span><span class='comment'># mnemonic, doc. Three different types are present in the example:
112
+ </span><span class='comment'># [:silent] Silent is left out from the &quot;usage&quot; printout (see
113
+ </span><span class='comment'># below). Also &quot;help&quot; is reserved as special option name to
114
+ </span><span class='comment'># designate command line Usage Help.
115
+ </span><span class='comment'># [:single] Single means that the option requires one argument (and only one).
116
+ </span><span class='comment'># [:switch] Switch is an optional flag (default value is false).
117
+ </span><span class='comment'>#
118
+ </span><span class='comment'># Option name is used to reference the option value from Opt class.
119
+ </span><span class='comment'># The command line option values are stored to Opt class
120
+ </span><span class='comment'># automatically. For example the file option value is returned by
121
+ </span><span class='comment'># executing &quot;Opt['file'].value&quot;. The option name also doubles as
122
+ </span><span class='comment'># long option, i.e. one could use &quot;--file &lt;filename&gt;&quot; on the command
123
+ </span><span class='comment'># line.
124
+ </span><span class='comment'>#
125
+ </span><span class='comment'># Existence of optional options can be tested using the &quot;given&quot;
126
+ </span><span class='comment'># method. For example &quot;Opt['debug'].given&quot; would return &quot;true&quot; if
127
+ </span><span class='comment'># &quot;-d&quot; was given on the command line.
128
+ </span><span class='comment'>#
129
+ </span><span class='comment'># ==== Example executions
130
+ </span><span class='comment'>#
131
+ </span><span class='comment'># Normal behavior would be achieved by executing:
132
+ </span><span class='comment'># shell&gt; como_simple -f example -d
133
+ </span><span class='comment'>#
134
+ </span><span class='comment'># The program would execute with the following output:
135
+ </span><span class='comment'># File option: example
136
+ </span><span class='comment'># Debugging selected!
137
+ </span><span class='comment'>#
138
+ </span><span class='comment'># Same output would be achieved with:
139
+ </span><span class='comment'># shell&gt; como_simple --file example --debug
140
+ </span><span class='comment'>#
141
+ </span><span class='comment'># Since option name doubles as long option.
142
+ </span><span class='comment'>#
143
+ </span><span class='comment'># Como includes certain &quot;extra&quot; behavior out-of-box. For example
144
+ </span><span class='comment'># given the command:
145
+ </span><span class='comment'># shell&gt; como_simple
146
+ </span><span class='comment'>#
147
+ </span><span class='comment'># The following is displayed on the screen:
148
+ </span><span class='comment'>#
149
+ </span><span class='comment'># como_simple error: Option &quot;-f&quot; missing for &quot;como_simple&quot;...
150
+ </span><span class='comment'>#
151
+ </span><span class='comment'># Usage:
152
+ </span><span class='comment'># como_simple -f &lt;file&gt; [-d]
153
+ </span><span class='comment'>#
154
+ </span><span class='comment'># -f File argument.
155
+ </span><span class='comment'># -d Enable debugging.
156
+ </span><span class='comment'>#
157
+ </span><span class='comment'>#
158
+ </span><span class='comment'># Copyright (c) 2013 by Programmer
159
+ </span><span class='comment'>#
160
+ </span><span class='comment'>#
161
+ </span><span class='comment'># Missing option error is displayed since &quot;file&quot; is a mandatory
162
+ </span><span class='comment'># option. The error message is followed by &quot;usage&quot; display (Usage
163
+ </span><span class='comment'># Help).
164
+ </span><span class='comment'>#
165
+ </span><span class='comment'># Given the command:
166
+ </span><span class='comment'># shell&gt; como_simple -h
167
+ </span><span class='comment'>#
168
+ </span><span class='comment'># would display the same &quot;usage&quot; screen except without the error
169
+ </span><span class='comment'># line. Documentation string is taken from the specification to
170
+ </span><span class='comment'># &quot;usage&quot; display. The &quot;help&quot; option is added automatically to the
171
+ </span><span class='comment'># specification.
172
+ </span><span class='comment'>#
173
+ </span><span class='comment'>#
174
+ </span><span class='comment'>#
175
+ </span><span class='comment'># === Subcmd example
176
+ </span><span class='comment'>#
177
+ </span><span class='comment'>#
178
+ </span><span class='comment'>#
179
+ </span><span class='comment'>#
180
+ </span><span class='comment'>#
181
+ </span><span class='comment'>#
182
+ </span><span class='comment'># == Option specification
183
+ </span><span class='comment'>#
184
+ </span><span class='comment'># === Overview
185
+ </span><span class='comment'>#
186
+ </span><span class='comment'>#
187
+ </span><span class='comment'>#
188
+ </span><span class='comment'># === Option types
189
+ </span><span class='comment'>#
190
+ </span><span class='comment'># The following types can be defined for the command line options:
191
+ </span><span class='comment'># [:switch] Single switch option (no arguments).
192
+ </span><span class='comment'># [:single] Mandatory single argument option.
193
+ </span><span class='comment'># [:multi] Mandatory multiple argument option. Option values in
194
+ </span><span class='comment'># array.
195
+ </span><span class='comment'># [:opt_single] Optional single argument option.
196
+ </span><span class='comment'># [:opt_multi] Optional multiple argument option. Option values in array.
197
+ </span><span class='comment'># [:opt_any] Optional multiple argument option (also none accepted).
198
+ </span><span class='comment'># Option values in array.
199
+ </span><span class='comment'># [:default] Default option (no switch associated). Any name and
200
+ </span><span class='comment'># option String value can be supplied to the spec, since
201
+ </span><span class='comment'># only the document string is used. Default option is
202
+ </span><span class='comment'># referred with &quot;nil&quot;.
203
+ </span><span class='comment'># [:exclusive] Option that does not coexist with other options.
204
+ </span><span class='comment'># [:silent] Option that does not coexist with other options and is not
205
+ </span><span class='comment'># displayed as an option in &quot;usage&quot; display. In effect a
206
+ </span><span class='comment'># sub-option of :exclusive.
207
+ </span><span class='comment'>#
208
+ </span><span class='comment'># TODO: multi note about termination.
209
+ </span><span class='comment'># TODO: leaving out short option.
210
+ </span><span class='comment'>#
211
+ </span><span class='comment'># === TODO: Change header: Specification method options
212
+ </span><span class='comment'>#
213
+ </span><span class='comment'># The common method for specifying the options is to use
214
+ </span><span class='comment'># &quot;Spec.defineCheckHelp&quot;. Method invocation includes definition
215
+ </span><span class='comment'># of the options, parsing the command line, checking for missing
216
+ </span><span class='comment'># mandatory options, and it will automatically display &quot;usage&quot; if
217
+ </span><span class='comment'># &quot;help&quot; option is given.
218
+ </span><span class='comment'>#
219
+ </span><span class='comment'># Automatic &quot;help&quot; option processing can be avoided using
220
+ </span><span class='comment'># &quot;Spec.defineCheck&quot; instead.
221
+ </span><span class='comment'>#
222
+ </span><span class='comment'># TODO: How options are inherited, program vs subcmd.
223
+ </span><span class='comment'>#
224
+ </span><span class='comment'># Both methods above accept additional parameters passed in a
225
+ </span><span class='comment'># Hash. The usable hash keys:
226
+ </span>
227
+ <span class='comment'># [:autohelp] Add help option automatically (default: true). Custom
228
+ </span><span class='comment'># help option can be provided and it can be made also
229
+ </span><span class='comment'># visible to user.
230
+ </span><span class='comment'># [:rulehelp] Include RuleCheck help to Usage Help (default: false).
231
+ </span><span class='comment'># [:header] Header lines before standard usage printout.
232
+ </span><span class='comment'># [:footer] Footer lines after standard usage printout.
233
+ </span><span class='comment'># [:subcheck] TODO
234
+ </span><span class='comment'># [:check] Check for missing arguments (default: true).
235
+ </span><span class='comment'># [:tab] TODO (default: 12).
236
+ </span><span class='comment'># [:help_exit] Exit program if help displayed (default: true).
237
+ </span><span class='comment'># [:error_exit] Exit program if error in options (default: true).
238
+ </span><span class='comment'>#
239
+ </span><span class='comment'>#
240
+ </span><span class='comment'>#
241
+ </span><span class='comment'># == Option referencing
242
+ </span><span class='comment'>#
243
+ </span><span class='comment'># Opt class includes the parsed option values. All options can be
244
+ </span><span class='comment'># tested whether they are specified on the command line using
245
+ </span><span class='comment'># &quot;Opt['name'].given&quot;. The &quot;given&quot; method takes optionally a block
246
+ </span><span class='comment'># argument. When block argument is used, the block is supplied with
247
+ </span><span class='comment'># option value and the block is executed if the option has been
248
+ </span><span class='comment'># set.
249
+ </span><span class='comment'>#
250
+ </span><span class='comment'># &quot;Opt['name'].value&quot; returns the provided option value. For
251
+ </span><span class='comment'># &quot;:switch&quot; type it is true/false value and for the other types a
252
+ </span><span class='comment'># String or an Array of Strings.
253
+ </span><span class='comment'>#
254
+ </span><span class='comment'># If an option takes multiple arguments, the value for the option is
255
+ </span><span class='comment'># an Array. The values can be iterated simply by:
256
+ </span><span class='comment'># Opt['files'].value.each do |val|
257
+ </span><span class='comment'># puts val
258
+ </span><span class='comment'># end
259
+ </span><span class='comment'>#
260
+ </span><span class='comment'># Short syntax for value referencing is performed with unary operator
261
+ </span><span class='comment'># &quot;~&quot;. Thus
262
+ </span><span class='comment'># Opt['files'].value
263
+ </span><span class='comment'># is equal to
264
+ </span><span class='comment'># ~Opt['files']
265
+ </span><span class='comment'>#
266
+ </span><span class='comment'># Sometimes it is convenient for the program to use an option to
267
+ </span><span class='comment'># include multiple parameter settings. These settings can be parsed
268
+ </span><span class='comment'># and mapped to a Hash. Como performs automatic conversion to numeric
269
+ </span><span class='comment'># values if possible. For example with option:
270
+ </span><span class='comment'># --set rounds=10 length=5
271
+ </span><span class='comment'># Como can be used extract the parameter values with the &quot;params&quot; method:
272
+ </span><span class='comment'># Opt['set'].params
273
+ </span><span class='comment'># And a Hash is returned:
274
+ </span><span class='comment'># { 'rounds' =&gt; 10, 'length' =&gt; 5 }
275
+ </span><span class='comment'>#
276
+ </span><span class='comment'># With &quot;:opt_any&quot; type, the user should first check if the option was given:
277
+ </span><span class='comment'># Opt['many_files_or_none'].given
278
+ </span><span class='comment'># Then check how many arguments where given:
279
+ </span><span class='comment'># Opt['many_files_or_none'].value.length
280
+ </span><span class='comment'># And finally decide what to do.
281
+ </span><span class='comment'>#
282
+ </span><span class='comment'># If the user gives the &quot;--&quot; option (double-dash), the arguments after
283
+ </span><span class='comment'># that option is returned as an Array with &quot;Opt.external&quot;. TODO:
284
+ </span><span class='comment'># silent to terminate multi options.
285
+ </span><span class='comment'>#
286
+ </span><span class='comment'>#
287
+ </span><span class='comment'>#
288
+ </span><span class='comment'># == Customization
289
+ </span><span class='comment'>#
290
+ </span><span class='comment'># If the default behavior is not satisfactory, changes can be
291
+ </span><span class='comment'># implemented simply by overloading the existing functions. Some
292
+ </span><span class='comment'># knowledge of the internal workings of Como is required though.
293
+ </span><span class='comment'>#
294
+ </span><span class='comment'>#
295
+ </span><span class='comment'># == Additional checks
296
+ </span><span class='comment'>#
297
+ </span><span class='comment'># Sometimes the options have to be used in combination to make sense
298
+ </span><span class='comment'># for the program. Como provides a facility to create relations
299
+ </span><span class='comment'># between options. Consider the following options spec:
300
+ </span><span class='comment'># Spec.defineCheckHelp( &quot;como_fulltest&quot;, &quot;Programmer&quot;, &quot;2013&quot;,
301
+ </span><span class='comment'># [
302
+ </span><span class='comment'># [ :silent, &quot;help&quot;, &quot;-h&quot;, &quot;Display usage info.&quot; ],
303
+ </span><span class='comment'># [ :single, &quot;file&quot;, &quot;-f&quot;, &quot;File argument.&quot; ],
304
+ </span><span class='comment'># [ :switch, &quot;o1&quot;, &quot;-o1&quot;, &quot;o1&quot; ],
305
+ </span><span class='comment'># [ :opt_single, &quot;o2&quot;, &quot;-o2&quot;, &quot;o2&quot; ],
306
+ </span><span class='comment'># [ :opt_single, &quot;o3&quot;, &quot;-o3&quot;, &quot;o3&quot; ],
307
+ </span><span class='comment'># [ :opt_multi, &quot;o4&quot;, &quot;-o4&quot;, &quot;o4&quot; ],
308
+ </span><span class='comment'># [ :opt_any, &quot;o5&quot;, &quot;-o5&quot;, &quot;o5&quot; ],
309
+ </span><span class='comment'># [ :switch, &quot;debug&quot;, &quot;-d&quot;, &quot;Enable debugging.&quot; ],
310
+ </span><span class='comment'># ] )
311
+ </span><span class='comment'>#
312
+ </span><span class='comment'># Spec.checkRule do
313
+ </span><span class='comment'># all( 'file',
314
+ </span><span class='comment'># one(
315
+ </span><span class='comment'># all( 'o1', 'o2' ),
316
+ </span><span class='comment'># one( 'o3', 'o4', 'o5' )
317
+ </span><span class='comment'># )
318
+ </span><span class='comment'># )
319
+ </span><span class='comment'># end
320
+ </span><span class='comment'>#
321
+ </span><span class='comment'># This spec includes multiple optional options (&quot;o?&quot;). The
322
+ </span><span class='comment'># &quot;Spec.checkRule&quot; method accepts a block where option rule
323
+ </span><span class='comment'># check DSL (Domain Specific Language) is used. The rule specifies
324
+ </span><span class='comment'># that the &quot;file&quot; option has to be used in combination with some other
325
+ </span><span class='comment'># options. These are &quot;all( 'o1', 'o2' )&quot; or &quot;one( 'o3', 'o4', 'o5' )&quot;,
326
+ </span><span class='comment'># i.e. either both &quot;o1&quot; and &quot;o2&quot;, or one of [&quot;o3&quot;,&quot;o4&quot;,&quot;o5]. The
327
+ </span><span class='comment'># checker will validate this rule and error if for example the command
328
+ </span><span class='comment'># line reads:
329
+ </span><span class='comment'># shell&gt; como_fulltest --file myfile -o3 black -o5
330
+ </span><span class='comment'>#
331
+ </span><span class='comment'># The following rules can be used (in combination):
332
+ </span><span class='comment'># [all] All options in the list.
333
+ </span><span class='comment'># [one] One and only one from the list.
334
+ </span><span class='comment'># [any] At least one of the list is given.
335
+ </span><span class='comment'># [none] No options are required.
336
+ </span><span class='comment'># [inv] Logical negation for existence.
337
+ </span><span class='comment'># [incr] Incremental options in order i.e. have to have previous to
338
+ </span><span class='comment'># have later.
339
+ </span><span class='comment'># [follow] Incremental options in order i.e. have to have all later if
340
+ </span><span class='comment'># had first.
341
+ </span>
342
+ <span class='kw'>module</span> <span class='const'>Como</span>
343
+
344
+
345
+ <span class='comment'># IO stream options for Como classes.
346
+ </span> <span class='kw'>class</span> <span class='const'>ComoCommon</span>
347
+
348
+ <span class='comment'># Default value for display output.
349
+ </span> <span class='cvar'>@@io</span> <span class='op'>=</span> <span class='const'>STDOUT</span>
350
+
351
+ <span class='comment'># Set @@io.
352
+ </span> <span class='kw'>def</span> <span class='const'>ComoCommon</span><span class='period'>.</span><span class='id identifier rubyid_setIo'>setIo</span><span class='lparen'>(</span> <span class='id identifier rubyid_io'>io</span> <span class='rparen'>)</span>
353
+ <span class='cvar'>@@io</span> <span class='op'>=</span> <span class='id identifier rubyid_io'>io</span>
354
+ <span class='kw'>end</span>
355
+
356
+ <span class='comment'># Get @@io.
357
+ </span> <span class='kw'>def</span> <span class='const'>ComoCommon</span><span class='period'>.</span><span class='id identifier rubyid_getIo'>getIo</span>
358
+ <span class='cvar'>@@io</span>
359
+ <span class='kw'>end</span>
360
+ <span class='kw'>end</span>
361
+
362
+
363
+ <span class='comment'># User interface for Como.
364
+ </span> <span class='kw'>class</span> <span class='const'>Spec</span> <span class='op'>&lt;</span> <span class='const'>ComoCommon</span>
365
+
366
+ <span class='comment'># Create specification for program with subcmds.
367
+ </span> <span class='comment'>#
368
+ </span> <span class='comment'># @param author [String] Program author.
369
+ </span> <span class='comment'># @param year [String] Year (or dates) for program.
370
+ </span> <span class='comment'># @yield defs [] Subcmd definitions.
371
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_program'>program</span><span class='lparen'>(</span> <span class='id identifier rubyid_author'>author</span><span class='comma'>,</span> <span class='id identifier rubyid_year'>year</span><span class='comma'>,</span> <span class='id identifier rubyid_config'>config</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_defs'>defs</span> <span class='rparen'>)</span>
372
+ <span class='kw'>if</span> <span class='id identifier rubyid_config'>config</span>
373
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_configOverlay'>configOverlay</span><span class='lparen'>(</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
374
+ <span class='kw'>end</span>
375
+ <span class='id identifier rubyid_spec'>spec</span> <span class='op'>=</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='id identifier rubyid_author'>author</span><span class='comma'>,</span> <span class='id identifier rubyid_year'>year</span> <span class='rparen'>)</span>
376
+ <span class='id identifier rubyid_spec'>spec</span><span class='period'>.</span><span class='id identifier rubyid_instance_eval'>instance_eval</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_defs'>defs</span> <span class='rparen'>)</span>
377
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span> <span class='const'>ArgsParseState</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='cvar'>@@argv</span> <span class='rparen'>)</span> <span class='rparen'>)</span>
378
+ <span class='kw'>end</span>
379
+
380
+
381
+ <span class='comment'># The primary entry point to Como. Defines the command
382
+ </span> <span class='comment'># switches and parses the command line. Performs &quot;usage&quot;
383
+ </span> <span class='comment'># display if &quot;help&quot; was selected.
384
+ </span> <span class='comment'>#
385
+ </span> <span class='comment'># @param prog [String] Program (i.e. command) name.
386
+ </span> <span class='comment'># @param author [String] Author of the program.
387
+ </span> <span class='comment'># @param year [String] Year (or dates) for program.
388
+ </span> <span class='comment'># @param defs [Array&lt;Array&gt;] Option definitions.
389
+ </span> <span class='comment'># @param config [Hash] Option definition's behavioral config
390
+ </span> <span class='comment'># (changes @@config defaults).
391
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_command'>command</span><span class='lparen'>(</span> <span class='id identifier rubyid_prog'>prog</span><span class='comma'>,</span> <span class='id identifier rubyid_author'>author</span><span class='comma'>,</span> <span class='id identifier rubyid_year'>year</span><span class='comma'>,</span> <span class='id identifier rubyid_defs'>defs</span><span class='comma'>,</span> <span class='id identifier rubyid_config'>config</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span> <span class='rparen'>)</span>
392
+ <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_defineCheck'>defineCheck</span><span class='lparen'>(</span> <span class='id identifier rubyid_prog'>prog</span><span class='comma'>,</span> <span class='id identifier rubyid_author'>author</span><span class='comma'>,</span> <span class='id identifier rubyid_year'>year</span><span class='comma'>,</span> <span class='id identifier rubyid_defs'>defs</span><span class='comma'>,</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
393
+ <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_usage'>usage</span> <span class='kw'>if</span> <span class='const'>Opt</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>help</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
394
+ <span class='kw'>end</span>
395
+
396
+ <span class='comment'># Alias to Spec.command.
397
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_defineCheckHelp'>defineCheckHelp</span><span class='lparen'>(</span> <span class='id identifier rubyid_prog'>prog</span><span class='comma'>,</span> <span class='id identifier rubyid_author'>author</span><span class='comma'>,</span> <span class='id identifier rubyid_year'>year</span><span class='comma'>,</span> <span class='id identifier rubyid_defs'>defs</span><span class='comma'>,</span> <span class='id identifier rubyid_config'>config</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span> <span class='rparen'>)</span>
398
+ <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_command'>command</span><span class='lparen'>(</span> <span class='id identifier rubyid_prog'>prog</span><span class='comma'>,</span> <span class='id identifier rubyid_author'>author</span><span class='comma'>,</span> <span class='id identifier rubyid_year'>year</span><span class='comma'>,</span> <span class='id identifier rubyid_defs'>defs</span><span class='comma'>,</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
399
+ <span class='kw'>end</span>
400
+
401
+ <span class='comment'># Same as &quot;defineCheckHelp&quot; except without automatic &quot;help&quot;
402
+ </span> <span class='comment'># option processing.
403
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_defineCheck'>defineCheck</span><span class='lparen'>(</span> <span class='id identifier rubyid_prog'>prog</span><span class='comma'>,</span> <span class='id identifier rubyid_author'>author</span><span class='comma'>,</span> <span class='id identifier rubyid_year'>year</span><span class='comma'>,</span> <span class='id identifier rubyid_defs'>defs</span><span class='comma'>,</span> <span class='id identifier rubyid_config'>config</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span> <span class='rparen'>)</span>
404
+ <span class='id identifier rubyid_spec'>spec</span> <span class='op'>=</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='id identifier rubyid_author'>author</span><span class='comma'>,</span> <span class='id identifier rubyid_year'>year</span> <span class='rparen'>)</span>
405
+ <span class='id identifier rubyid_spec'>spec</span><span class='period'>.</span><span class='id identifier rubyid_subcmd'>subcmd</span><span class='lparen'>(</span> <span class='id identifier rubyid_prog'>prog</span><span class='comma'>,</span> <span class='id identifier rubyid_defs'>defs</span><span class='comma'>,</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
406
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span> <span class='const'>ArgsParseState</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='cvar'>@@argv</span> <span class='rparen'>)</span> <span class='rparen'>)</span>
407
+ <span class='kw'>end</span>
408
+
409
+
410
+ <span class='comment'># Create Spec object that can handle subcmd definitions.
411
+ </span> <span class='comment'>#
412
+ </span> <span class='comment'># @param author [String] Program author.
413
+ </span> <span class='comment'># @param year [String] Year (or dates) for program.
414
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span> <span class='id identifier rubyid_author'>author</span><span class='comma'>,</span> <span class='id identifier rubyid_year'>year</span> <span class='rparen'>)</span>
415
+ <span class='ivar'>@author</span> <span class='op'>=</span> <span class='id identifier rubyid_author'>author</span>
416
+ <span class='ivar'>@year</span> <span class='op'>=</span> <span class='id identifier rubyid_year'>year</span>
417
+
418
+ <span class='const'>Spec</span><span class='period'>.</span><span class='const'>ArgCheck</span><span class='lparen'>(</span> <span class='id identifier rubyid_author'>author</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>String</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Author name is not a String</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
419
+ <span class='const'>Spec</span><span class='period'>.</span><span class='const'>ArgCheck</span><span class='lparen'>(</span> <span class='id identifier rubyid_year'>year</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>String</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Year is not a String</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
420
+ <span class='kw'>end</span>
421
+
422
+
423
+ <span class='comment'># Define subcommand options.
424
+ </span> <span class='comment'>#
425
+ </span> <span class='comment'># @param cmd [String] Subcmd name.
426
+ </span> <span class='comment'># @param defs [Array&lt;Array&gt;] Option definition table.
427
+ </span> <span class='comment'># @param config [] Configuration options.
428
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_subcmd'>subcmd</span><span class='lparen'>(</span> <span class='id identifier rubyid_cmd'>cmd</span><span class='comma'>,</span> <span class='id identifier rubyid_defs'>defs</span><span class='comma'>,</span> <span class='id identifier rubyid_config'>config</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span> <span class='rparen'>)</span>
429
+
430
+ <span class='kw'>unless</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span>
431
+
432
+ <span class='id identifier rubyid_master'>master</span> <span class='op'>=</span> <span class='const'>MasterOpt</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='ivar'>@author</span><span class='comma'>,</span> <span class='ivar'>@year</span><span class='comma'>,</span>
433
+ <span class='id identifier rubyid_cmd'>cmd</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='symbol'>:subcmd</span><span class='comma'>,</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
434
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_setMaster'>setMaster</span><span class='lparen'>(</span> <span class='id identifier rubyid_master'>master</span> <span class='rparen'>)</span>
435
+ <span class='id identifier rubyid_subcmd'>subcmd</span> <span class='op'>=</span> <span class='id identifier rubyid_master'>master</span>
436
+
437
+ <span class='kw'>else</span>
438
+
439
+ <span class='id identifier rubyid_subcmd'>subcmd</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_cmd'>cmd</span> <span class='rparen'>)</span>
440
+
441
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_setSubcmd'>setSubcmd</span><span class='lparen'>(</span> <span class='id identifier rubyid_subcmd'>subcmd</span> <span class='rparen'>)</span>
442
+
443
+ <span class='const'>Spec</span><span class='period'>.</span><span class='const'>ArgCheck</span><span class='lparen'>(</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Subcommand \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmd'>cmd</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot; not defined.</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_subcmd'>subcmd</span>
444
+
445
+ <span class='kw'>end</span>
446
+
447
+ <span class='comment'># Overlay user config on top of default.
448
+ </span> <span class='id identifier rubyid_subcmd'>subcmd</span><span class='period'>.</span><span class='id identifier rubyid_applyConfig'>applyConfig</span><span class='lparen'>(</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
449
+
450
+ <span class='kw'>if</span> <span class='id identifier rubyid_subcmd'>subcmd</span><span class='period'>.</span><span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span> <span class='symbol'>:autohelp</span> <span class='rbracket'>]</span>
451
+ <span class='comment'># Automatically add the help option.
452
+ </span> <span class='id identifier rubyid_defs'>defs</span><span class='period'>.</span><span class='id identifier rubyid_insert'>insert</span><span class='lparen'>(</span> <span class='int'>0</span><span class='comma'>,</span> <span class='lbracket'>[</span> <span class='symbol'>:silent</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>help</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>-h</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Display usage info.</span><span class='tstring_end'>&quot;</span></span> <span class='rbracket'>]</span> <span class='rparen'>)</span>
453
+ <span class='kw'>end</span>
454
+
455
+ <span class='id identifier rubyid_subcmd'>subcmd</span><span class='period'>.</span><span class='id identifier rubyid_setSubopt'>setSubopt</span><span class='lparen'>(</span> <span class='op'>*</span><span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_specify'>specify</span><span class='lparen'>(</span> <span class='id identifier rubyid_defs'>defs</span> <span class='rparen'>)</span> <span class='rparen'>)</span>
456
+ <span class='id identifier rubyid_subcmd'>subcmd</span>
457
+
458
+ <span class='kw'>end</span>
459
+
460
+
461
+ <span class='comment'># Specify and check options spec.
462
+ </span> <span class='comment'>#
463
+ </span> <span class='comment'># @param table [Array&lt;Array&gt;] Option definition table.
464
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_specify'>specify</span><span class='lparen'>(</span> <span class='id identifier rubyid_table'>table</span> <span class='rparen'>)</span>
465
+
466
+ <span class='id identifier rubyid_options'>options</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
467
+ <span class='id identifier rubyid_subcmds'>subcmds</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
468
+
469
+ <span class='comment'># Type checks for valid user input.
470
+ </span> <span class='const'>Spec</span><span class='period'>.</span><span class='const'>ArgCheck</span><span class='lparen'>(</span> <span class='id identifier rubyid_table'>table</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>Array</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Option table is not an Array</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
471
+
472
+ <span class='id identifier rubyid_table'>table</span><span class='period'>.</span><span class='id identifier rubyid_each_index'>each_index</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_idx'>idx</span><span class='op'>|</span>
473
+
474
+ <span class='id identifier rubyid_i'>i</span> <span class='op'>=</span> <span class='id identifier rubyid_table'>table</span><span class='lbracket'>[</span> <span class='id identifier rubyid_idx'>idx</span> <span class='rbracket'>]</span>
475
+
476
+ <span class='const'>Spec</span><span class='period'>.</span><span class='const'>ArgCheck</span><span class='lparen'>(</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>Array</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Option table entry is not an Array</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
477
+
478
+ <span class='kw'>if</span> <span class='id identifier rubyid_i'>i</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='op'>==</span> <span class='symbol'>:default</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span> <span class='op'>==</span> <span class='int'>2</span>
479
+
480
+ <span class='comment'># Add 2 dummy entries for :default type if needed.
481
+ </span> <span class='id identifier rubyid_table'>table</span><span class='lbracket'>[</span> <span class='id identifier rubyid_idx'>idx</span> <span class='rbracket'>]</span> <span class='op'>=</span> <span class='lbracket'>[</span> <span class='id identifier rubyid_i'>i</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_i'>i</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span> <span class='rbracket'>]</span>
482
+
483
+ <span class='kw'>elsif</span> <span class='id identifier rubyid_i'>i</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='op'>==</span> <span class='symbol'>:subcmd</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span> <span class='op'>==</span> <span class='int'>3</span>
484
+
485
+ <span class='comment'># Add 1 dummy entry for :subcmd type if needed.
486
+ </span> <span class='id identifier rubyid_table'>table</span><span class='lbracket'>[</span> <span class='id identifier rubyid_idx'>idx</span> <span class='rbracket'>]</span> <span class='op'>=</span> <span class='lbracket'>[</span> <span class='id identifier rubyid_i'>i</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_i'>i</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_i'>i</span><span class='lbracket'>[</span><span class='int'>2</span><span class='rbracket'>]</span> <span class='rbracket'>]</span>
487
+ <span class='kw'>end</span>
488
+
489
+ <span class='const'>Spec</span><span class='period'>.</span><span class='const'>ArgCheck</span><span class='lparen'>(</span> <span class='id identifier rubyid_table'>table</span><span class='lbracket'>[</span> <span class='id identifier rubyid_idx'>idx</span> <span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span> <span class='op'>==</span> <span class='int'>4</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Option table entry length not 4</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
490
+ <span class='kw'>end</span>
491
+
492
+
493
+ <span class='id identifier rubyid_table'>table</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_e'>e</span><span class='op'>|</span>
494
+
495
+ <span class='kw'>if</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='op'>==</span> <span class='symbol'>:subcmd</span>
496
+
497
+ <span class='id identifier rubyid_subcmds'>subcmds</span><span class='lbracket'>[</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span> <span class='rbracket'>]</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_subcmd'>subcmd</span><span class='lparen'>(</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>3</span><span class='rbracket'>]</span> <span class='rparen'>)</span>
498
+
499
+ <span class='kw'>else</span>
500
+
501
+ <span class='id identifier rubyid_option'>option</span> <span class='op'>=</span> <span class='kw'>nil</span>
502
+
503
+ <span class='kw'>case</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
504
+
505
+ <span class='kw'>when</span> <span class='symbol'>:switch</span>
506
+ <span class='id identifier rubyid_option'>option</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_switch'>switch</span><span class='lparen'>(</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>2</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>3</span><span class='rbracket'>]</span> <span class='rparen'>)</span>
507
+
508
+ <span class='kw'>when</span> <span class='symbol'>:exclusive</span>
509
+ <span class='id identifier rubyid_option'>option</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_exclusive'>exclusive</span><span class='lparen'>(</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>2</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>3</span><span class='rbracket'>]</span> <span class='rparen'>)</span>
510
+
511
+ <span class='kw'>when</span> <span class='symbol'>:silent</span>
512
+ <span class='id identifier rubyid_option'>option</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_exclusive'>exclusive</span><span class='lparen'>(</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>2</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>3</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='kw'>true</span> <span class='rparen'>)</span>
513
+
514
+ <span class='kw'>when</span> <span class='symbol'>:single</span><span class='comma'>,</span> <span class='symbol'>:multi</span><span class='comma'>,</span> <span class='symbol'>:opt_single</span><span class='comma'>,</span> <span class='symbol'>:opt_multi</span><span class='comma'>,</span> <span class='symbol'>:opt_any</span>
515
+ <span class='id identifier rubyid_option'>option</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_full'>full</span><span class='lparen'>(</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>2</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>3</span><span class='rbracket'>]</span> <span class='rparen'>)</span>
516
+
517
+ <span class='kw'>when</span> <span class='symbol'>:default</span>
518
+ <span class='id identifier rubyid_option'>option</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_defaultOpt'>defaultOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>3</span><span class='rbracket'>]</span> <span class='rparen'>)</span>
519
+
520
+ <span class='kw'>else</span>
521
+ <span class='id identifier rubyid_raise'>raise</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unknown option type: \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span>
522
+ <span class='kw'>end</span>
523
+
524
+ <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span> <span class='id identifier rubyid_option'>option</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span> <span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_option'>option</span>
525
+
526
+ <span class='kw'>end</span>
527
+
528
+ <span class='kw'>end</span>
529
+
530
+ <span class='lbracket'>[</span> <span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_values'>values</span><span class='comma'>,</span> <span class='id identifier rubyid_subcmds'>subcmds</span><span class='period'>.</span><span class='id identifier rubyid_values'>values</span> <span class='rbracket'>]</span>
531
+ <span class='kw'>end</span>
532
+
533
+
534
+ <span class='comment'># Command line options source.
535
+ </span> <span class='cvar'>@@argv</span> <span class='op'>=</span> <span class='const'>ARGV</span>
536
+
537
+ <span class='comment'># Set command line options source, i.e. @@argv (default: ARGV).
538
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_setArgv'>setArgv</span><span class='lparen'>(</span> <span class='id identifier rubyid_newArgv'>newArgv</span> <span class='rparen'>)</span>
539
+ <span class='cvar'>@@argv</span> <span class='op'>=</span> <span class='id identifier rubyid_newArgv'>newArgv</span>
540
+ <span class='kw'>end</span>
541
+
542
+ <span class='comment'># Display program usage (and optionally exit).
543
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_usage'>usage</span>
544
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_usage'>usage</span>
545
+ <span class='kw'>end</span>
546
+
547
+ <span class='comment'># Set optional header for &quot;usage&quot;.
548
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_setUsageHeader'>setUsageHeader</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
549
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_setUsageHeader'>setUsageHeader</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
550
+ <span class='kw'>end</span>
551
+
552
+
553
+ <span class='comment'># Set optional footer for &quot;usage&quot;.
554
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_setUsageFooter'>setUsageFooter</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
555
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_setUsageFooter'>setUsageFooter</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
556
+ <span class='kw'>end</span>
557
+
558
+
559
+ <span class='comment'># Check option combination rules.
560
+ </span> <span class='comment'>#
561
+ </span> <span class='comment'># @param opt [String] Opt name to which rules are set. If not
562
+ </span> <span class='comment'># given, Opt.current is used.
563
+ </span> <span class='comment'># @param rule [Proc] Rules to check.
564
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_checkRule'>checkRule</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
565
+ <span class='kw'>if</span> <span class='id identifier rubyid_opt'>opt</span>
566
+ <span class='id identifier rubyid_opt'>opt</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='lbracket'>[</span> <span class='id identifier rubyid_opt'>opt</span> <span class='rbracket'>]</span>
567
+ <span class='kw'>else</span>
568
+ <span class='id identifier rubyid_opt'>opt</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_current'>current</span>
569
+ <span class='kw'>end</span>
570
+ <span class='id identifier rubyid_opt'>opt</span><span class='period'>.</span><span class='id identifier rubyid_setRuleCheck'>setRuleCheck</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
571
+ <span class='id identifier rubyid_opt'>opt</span><span class='period'>.</span><span class='id identifier rubyid_checkRule'>checkRule</span>
572
+ <span class='kw'>end</span>
573
+
574
+
575
+ <span class='comment'># Check option combination rules.
576
+ </span> <span class='comment'>#
577
+ </span> <span class='comment'># @param opt [String] Opt name to which rules are set. If not
578
+ </span> <span class='comment'># given, Opt.current is used.
579
+ </span> <span class='comment'># @param rule [Proc] Rules to check.
580
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_checkRule'>checkRule</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
581
+ <span class='kw'>if</span> <span class='id identifier rubyid_opt'>opt</span>
582
+ <span class='id identifier rubyid_opt'>opt</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='lbracket'>[</span> <span class='id identifier rubyid_opt'>opt</span> <span class='rbracket'>]</span>
583
+ <span class='kw'>else</span>
584
+ <span class='id identifier rubyid_opt'>opt</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_current'>current</span>
585
+ <span class='kw'>end</span>
586
+ <span class='id identifier rubyid_opt'>opt</span><span class='period'>.</span><span class='id identifier rubyid_setRuleCheck'>setRuleCheck</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
587
+ <span class='kw'>end</span>
588
+
589
+ <span class='comment'># Additional option check.
590
+ </span> <span class='comment'># @param opt [String] Option name.
591
+ </span> <span class='comment'># @param error [String] Error string for false return values (from check).
592
+ </span> <span class='comment'># @param check [Proc] Checker proc run for the option. Either
593
+ </span> <span class='comment'># return false or generate an exception when errors found.
594
+ </span> <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='id identifier rubyid_checkAlso'>checkAlso</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_error'>error</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_check'>check</span> <span class='rparen'>)</span>
595
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_checkAlso'>checkAlso</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_error'>error</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_check'>check</span> <span class='rparen'>)</span>
596
+ <span class='kw'>end</span>
597
+
598
+
599
+ <span class='id identifier rubyid_private'>private</span>
600
+
601
+ <span class='kw'>def</span> <span class='const'>Spec</span><span class='period'>.</span><span class='const'>ArgCheck</span><span class='lparen'>(</span> <span class='id identifier rubyid_cond'>cond</span><span class='comma'>,</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
602
+ <span class='id identifier rubyid_raise'>raise</span><span class='lparen'>(</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_cond'>cond</span>
603
+ <span class='kw'>end</span>
604
+
605
+
606
+ <span class='kw'>end</span>
607
+
608
+
609
+
610
+
611
+ <span class='comment'># Opt includes all options spec information and parsed options
612
+ </span> <span class='comment'># and their values. Option instance is accessed with
613
+ </span> <span class='comment'># &quot;Opt['name']&quot;. The option status (Opt instance) can be
614
+ </span> <span class='comment'># queried with for example &quot;given&quot; and &quot;value&quot; methods.
615
+ </span> <span class='kw'>class</span> <span class='const'>Opt</span> <span class='op'>&lt;</span> <span class='const'>ComoCommon</span>
616
+
617
+
618
+ <span class='comment'># Create exception with capability to pass arbitrary data
619
+ </span> <span class='kw'>class</span> <span class='const'>ErrorWithData</span> <span class='op'>&lt;</span> <span class='const'>StandardError</span>
620
+ <span class='id identifier rubyid_attr_reader'>attr_reader</span> <span class='symbol'>:data</span>
621
+ <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span> <span class='id identifier rubyid_message'>message</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_data'>data</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
622
+ <span class='kw'>super</span><span class='lparen'>(</span> <span class='id identifier rubyid_message'>message</span> <span class='rparen'>)</span>
623
+ <span class='ivar'>@data</span> <span class='op'>=</span> <span class='id identifier rubyid_data'>data</span>
624
+ <span class='kw'>end</span>
625
+ <span class='kw'>end</span>
626
+
627
+
628
+ <span class='comment'># Missing argument exception.
629
+ </span> <span class='kw'>class</span> <span class='const'>MissingArgument</span> <span class='op'>&lt;</span> <span class='const'>ErrorWithData</span><span class='semicolon'>;</span> <span class='kw'>end</span>
630
+
631
+ <span class='comment'># Invalid (non-existing) option exception.
632
+ </span> <span class='kw'>class</span> <span class='const'>InvalidOption</span> <span class='op'>&lt;</span> <span class='const'>ErrorWithData</span><span class='semicolon'>;</span> <span class='kw'>end</span>
633
+
634
+
635
+
636
+ <span class='comment'># ------------------------------------------------------------
637
+ </span> <span class='comment'># Option specification:
638
+ </span>
639
+
640
+ <span class='comment'># Program i.e. highest level subcommand.
641
+ </span> <span class='cvar'>@@master</span> <span class='op'>=</span> <span class='kw'>nil</span>
642
+
643
+ <span class='comment'># List of parsed option specs and option values.
644
+ </span> <span class='cvar'>@@opts</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
645
+
646
+ <span class='comment'># Current subcommand recorded.
647
+ </span> <span class='cvar'>@@subcmd</span> <span class='op'>=</span> <span class='kw'>nil</span>
648
+
649
+
650
+ <span class='comment'># Set of default configs for printout.
651
+ </span> <span class='cvar'>@@config</span> <span class='op'>=</span> <span class='lbrace'>{</span>
652
+ <span class='symbol'>:autohelp</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span>
653
+ <span class='symbol'>:rulehelp</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='comma'>,</span>
654
+ <span class='symbol'>:header</span> <span class='op'>=&gt;</span> <span class='kw'>nil</span><span class='comma'>,</span>
655
+ <span class='symbol'>:footer</span> <span class='op'>=&gt;</span> <span class='kw'>nil</span><span class='comma'>,</span>
656
+ <span class='symbol'>:subcheck</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span>
657
+ <span class='symbol'>:check</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span>
658
+ <span class='symbol'>:tab</span> <span class='op'>=&gt;</span> <span class='int'>12</span><span class='comma'>,</span>
659
+ <span class='symbol'>:help_exit</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span>
660
+ <span class='symbol'>:error_exit</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span>
661
+ <span class='rbrace'>}</span>
662
+
663
+
664
+ <span class='comment'># Set master option.
665
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_setMaster'>setMaster</span><span class='lparen'>(</span> <span class='id identifier rubyid_master'>master</span> <span class='rparen'>)</span>
666
+ <span class='cvar'>@@master</span> <span class='op'>=</span> <span class='id identifier rubyid_master'>master</span>
667
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_setSubcmd'>setSubcmd</span><span class='lparen'>(</span> <span class='id identifier rubyid_master'>master</span> <span class='rparen'>)</span>
668
+ <span class='kw'>end</span>
669
+
670
+ <span class='comment'># Get master option.
671
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span>
672
+ <span class='cvar'>@@master</span>
673
+ <span class='kw'>end</span>
674
+
675
+
676
+ <span class='comment'># Add option to options list.
677
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_addOpt'>addOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span> <span class='rparen'>)</span>
678
+ <span class='cvar'>@@opts</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='id identifier rubyid_opt'>opt</span>
679
+ <span class='kw'>end</span>
680
+
681
+
682
+ <span class='comment'># Set current subcmd.
683
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_setSubcmd'>setSubcmd</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span> <span class='rparen'>)</span>
684
+ <span class='cvar'>@@subcmd</span> <span class='op'>=</span> <span class='id identifier rubyid_opt'>opt</span>
685
+ <span class='kw'>end</span>
686
+
687
+
688
+ <span class='comment'># Current subcmd processed.
689
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_current'>current</span>
690
+ <span class='cvar'>@@subcmd</span>
691
+ <span class='kw'>end</span>
692
+
693
+
694
+ <span class='comment'># Find option by name.
695
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span> <span class='rparen'>)</span>
696
+ <span class='id identifier rubyid_idx'>idx</span> <span class='op'>=</span> <span class='cvar'>@@opts</span><span class='period'>.</span><span class='id identifier rubyid_index'>index</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span> <span class='op'>==</span> <span class='id identifier rubyid_name'>name</span> <span class='kw'>end</span>
697
+ <span class='kw'>if</span> <span class='id identifier rubyid_idx'>idx</span>
698
+ <span class='cvar'>@@opts</span><span class='lbracket'>[</span> <span class='id identifier rubyid_idx'>idx</span> <span class='rbracket'>]</span>
699
+ <span class='kw'>else</span>
700
+ <span class='kw'>nil</span>
701
+ <span class='kw'>end</span>
702
+ <span class='kw'>end</span>
703
+
704
+
705
+ <span class='comment'># Reset &quot;dynamic&quot; class members.
706
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_reset'>reset</span>
707
+ <span class='cvar'>@@opts</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
708
+ <span class='kw'>end</span>
709
+
710
+
711
+ <span class='comment'># Select option object by name. Master is searched first and
712
+ </span> <span class='comment'># then the flattened list of all options.
713
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='op'>[]</span><span class='lparen'>(</span><span class='id identifier rubyid_str'>str</span><span class='rparen'>)</span>
714
+
715
+ <span class='comment'># Search Master first.
716
+ </span> <span class='id identifier rubyid_ret'>ret</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_argByName'>argByName</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
717
+
718
+ <span class='kw'>unless</span> <span class='id identifier rubyid_ret'>ret</span>
719
+ <span class='id identifier rubyid_ret'>ret</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
720
+ <span class='kw'>unless</span> <span class='id identifier rubyid_ret'>ret</span>
721
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>RuntimeError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Option \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_str'>str</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot; does not exist...</span><span class='tstring_end'>&quot;</span></span>
722
+ <span class='kw'>end</span>
723
+ <span class='kw'>end</span>
724
+
725
+ <span class='id identifier rubyid_ret'>ret</span>
726
+ <span class='kw'>end</span>
727
+
728
+
729
+ <span class='comment'># Return program name.
730
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_progname'>progname</span>
731
+ <span class='cvar'>@@master</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span>
732
+ <span class='kw'>end</span>
733
+
734
+
735
+ <span class='comment'># Return program year.
736
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_year'>year</span>
737
+ <span class='cvar'>@@master</span><span class='period'>.</span><span class='id identifier rubyid_year'>year</span>
738
+ <span class='kw'>end</span>
739
+
740
+
741
+ <span class='comment'># Return author.
742
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_author'>author</span>
743
+ <span class='cvar'>@@master</span><span class='period'>.</span><span class='id identifier rubyid_author'>author</span>
744
+ <span class='kw'>end</span>
745
+
746
+
747
+ <span class='comment'># Return arguments (options) that are specified as command
748
+ </span> <span class='comment'># external (i.e. after '--').
749
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_external'>external</span>
750
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_external'>external</span>
751
+ <span class='kw'>end</span>
752
+
753
+
754
+ <span class='comment'># Return arguments (options) that have no switch.
755
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_default'>default</span>
756
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_default'>default</span>
757
+ <span class='kw'>end</span>
758
+
759
+
760
+ <span class='comment'># Create option spec.
761
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_full'>full</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_type'>type</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No doc.</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
762
+ <span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_type'>type</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span> <span class='rparen'>)</span>
763
+ <span class='kw'>end</span>
764
+
765
+ <span class='comment'># Create sub-command option spec.
766
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_subcmd'>subcmd</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No doc.</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
767
+ <span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='symbol'>:subcmd</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span><span class='comma'>,</span> <span class='kw'>false</span> <span class='rparen'>)</span>
768
+ <span class='kw'>end</span>
769
+
770
+ <span class='comment'># Create switch option spec.
771
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_switch'>switch</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No doc.</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
772
+ <span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='symbol'>:switch</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span><span class='comma'>,</span> <span class='kw'>false</span> <span class='rparen'>)</span>
773
+ <span class='kw'>end</span>
774
+
775
+ <span class='comment'># Create exclusive option spec.
776
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_exclusive'>exclusive</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No doc.</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_silent'>silent</span> <span class='op'>=</span> <span class='kw'>false</span> <span class='rparen'>)</span>
777
+ <span class='id identifier rubyid_o'>o</span> <span class='op'>=</span> <span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='symbol'>:exclusive</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span><span class='comma'>,</span> <span class='kw'>false</span> <span class='rparen'>)</span>
778
+ <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_silent'>silent</span> <span class='op'>=</span> <span class='id identifier rubyid_silent'>silent</span>
779
+ <span class='id identifier rubyid_o'>o</span>
780
+ <span class='kw'>end</span>
781
+
782
+ <span class='comment'># Create default option spec, no switch.
783
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_defaultOpt'>defaultOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_doc'>doc</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No doc.</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
784
+ <span class='comment'>#new( nil, &quot;&lt;args&gt;&quot;, :default, doc, [] )
785
+ </span> <span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>&lt;default&gt;</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>&lt;args&gt;</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='symbol'>:default</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span><span class='comma'>,</span> <span class='lbracket'>[</span><span class='rbracket'>]</span> <span class='rparen'>)</span>
786
+ <span class='kw'>end</span>
787
+
788
+ <span class='comment'># Options iterator for all options.
789
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_blk'>blk</span> <span class='rparen'>)</span>
790
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='op'>&amp;</span><span class='id identifier rubyid_blk'>blk</span>
791
+ <span class='kw'>end</span>
792
+
793
+ <span class='comment'># Options iterator for given options.
794
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_each_given'>each_given</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_blk'>blk</span> <span class='rparen'>)</span>
795
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_each_given'>each_given</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_blk'>blk</span> <span class='rparen'>)</span>
796
+ <span class='kw'>end</span>
797
+
798
+ <span class='comment'># Overlay Opt default configuration options.
799
+ </span> <span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_configOverlay'>configOverlay</span><span class='lparen'>(</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
800
+ <span class='cvar'>@@config</span><span class='period'>.</span><span class='id identifier rubyid_merge!'>merge!</span><span class='lparen'>(</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
801
+ <span class='kw'>end</span>
802
+
803
+
804
+ <span class='comment'># ------------------------------------------------------------
805
+ </span> <span class='comment'># Opt properties:
806
+ </span>
807
+
808
+ <span class='comment'># Subcommand parent (i.e. host).
809
+ </span> <span class='id identifier rubyid_attr_accessor'>attr_accessor</span> <span class='symbol'>:parent</span>
810
+
811
+
812
+ <span class='comment'># Option name.
813
+ </span> <span class='id identifier rubyid_attr_accessor'>attr_accessor</span> <span class='symbol'>:name</span>
814
+
815
+ <span class='comment'># Short option string.
816
+ </span> <span class='id identifier rubyid_attr_accessor'>attr_accessor</span> <span class='symbol'>:opt</span>
817
+
818
+ <span class='comment'># Long option string.
819
+ </span> <span class='id identifier rubyid_attr_accessor'>attr_accessor</span> <span class='symbol'>:longOpt</span>
820
+
821
+ <span class='comment'># Option type.
822
+ </span> <span class='id identifier rubyid_attr_accessor'>attr_accessor</span> <span class='symbol'>:type</span>
823
+
824
+ <span class='comment'># Option value.
825
+ </span> <span class='id identifier rubyid_attr_accessor'>attr_accessor</span> <span class='symbol'>:value</span>
826
+
827
+ <span class='comment'># Option documentation string.
828
+ </span> <span class='id identifier rubyid_attr_accessor'>attr_accessor</span> <span class='symbol'>:doc</span>
829
+
830
+ <span class='comment'># Is option specified?
831
+ </span> <span class='id identifier rubyid_attr_writer'>attr_writer</span> <span class='symbol'>:given</span>
832
+
833
+ <span class='comment'># Is option hidden (usage).
834
+ </span> <span class='id identifier rubyid_attr_accessor'>attr_accessor</span> <span class='symbol'>:silent</span>
835
+
836
+ <span class='comment'># List of suboptions.
837
+ </span> <span class='id identifier rubyid_attr_reader'>attr_reader</span> <span class='symbol'>:subopt</span>
838
+
839
+ <span class='comment'># List of subcommands.
840
+ </span> <span class='id identifier rubyid_attr_reader'>attr_reader</span> <span class='symbol'>:subcmd</span>
841
+
842
+ <span class='comment'># Opt configuration.
843
+ </span> <span class='id identifier rubyid_attr_reader'>attr_reader</span> <span class='symbol'>:config</span>
844
+
845
+ <span class='comment'># Opt rules.
846
+ </span> <span class='id identifier rubyid_attr_reader'>attr_reader</span> <span class='symbol'>:rules</span>
847
+
848
+
849
+ <span class='comment'># Create Opt object:
850
+ </span> <span class='comment'># [name] Option name string.
851
+ </span> <span class='comment'># [opt] Switch string.
852
+ </span> <span class='comment'># [type] Option type. One of:
853
+ </span> <span class='comment'># * :switch
854
+ </span> <span class='comment'># * :single
855
+ </span> <span class='comment'># * :multi
856
+ </span> <span class='comment'># * :opt_single
857
+ </span> <span class='comment'># * :opt_multi
858
+ </span> <span class='comment'># * :opt_any
859
+ </span> <span class='comment'># * :default
860
+ </span> <span class='comment'># * :exclusive
861
+ </span> <span class='comment'># * :silent
862
+ </span> <span class='comment'># [doc] Option documentation.
863
+ </span> <span class='comment'># [value] Default value.
864
+ </span>
865
+ <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_type'>type</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
866
+ <span class='ivar'>@parent</span> <span class='op'>=</span> <span class='kw'>nil</span>
867
+ <span class='ivar'>@name</span> <span class='op'>=</span> <span class='id identifier rubyid_name'>name</span>
868
+ <span class='ivar'>@opt</span> <span class='op'>=</span> <span class='id identifier rubyid_opt'>opt</span>
869
+ <span class='ivar'>@longOpt</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>--</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
870
+ <span class='ivar'>@type</span> <span class='op'>=</span> <span class='id identifier rubyid_type'>type</span>
871
+ <span class='ivar'>@value</span> <span class='op'>=</span> <span class='id identifier rubyid_value'>value</span>
872
+ <span class='ivar'>@doc</span> <span class='op'>=</span> <span class='id identifier rubyid_doc'>doc</span>
873
+ <span class='ivar'>@silent</span> <span class='op'>=</span> <span class='kw'>false</span>
874
+ <span class='comment'># Whether option was set or not.
875
+ </span> <span class='ivar'>@given</span> <span class='op'>=</span> <span class='kw'>false</span>
876
+ <span class='ivar'>@subopt</span> <span class='op'>=</span> <span class='kw'>nil</span>
877
+ <span class='ivar'>@subcmd</span> <span class='op'>=</span> <span class='kw'>nil</span>
878
+ <span class='ivar'>@rules</span> <span class='op'>=</span> <span class='kw'>nil</span>
879
+
880
+ <span class='ivar'>@config</span> <span class='op'>=</span> <span class='cvar'>@@config</span><span class='period'>.</span><span class='id identifier rubyid_dup'>dup</span>
881
+
882
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_addOpt'>addOpt</span><span class='lparen'>(</span> <span class='kw'>self</span> <span class='rparen'>)</span>
883
+ <span class='kw'>end</span>
884
+
885
+
886
+ <span class='comment'># Set subcommand suboptions.
887
+ </span> <span class='comment'>#
888
+ </span> <span class='comment'># @param opts [Array&lt;Opt&gt;]
889
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_setSubopt'>setSubopt</span><span class='lparen'>(</span> <span class='id identifier rubyid_opts'>opts</span><span class='comma'>,</span> <span class='id identifier rubyid_subs'>subs</span> <span class='rparen'>)</span>
890
+ <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span>
891
+ <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_parent'>parent</span> <span class='op'>=</span> <span class='kw'>self</span>
892
+ <span class='kw'>end</span>
893
+
894
+ <span class='id identifier rubyid_subs'>subs</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span>
895
+ <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_parent'>parent</span> <span class='op'>=</span> <span class='kw'>self</span>
896
+ <span class='kw'>end</span>
897
+
898
+ <span class='ivar'>@subopt</span> <span class='op'>=</span> <span class='id identifier rubyid_opts'>opts</span>
899
+ <span class='ivar'>@subcmd</span> <span class='op'>=</span> <span class='id identifier rubyid_subs'>subs</span>
900
+ <span class='kw'>end</span>
901
+
902
+
903
+ <span class='comment'># Merge config to base config.
904
+ </span> <span class='comment'>#
905
+ </span> <span class='comment'># @param config [Hash] Configuration Hash to merge.
906
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_applyConfig'>applyConfig</span><span class='lparen'>(</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
907
+ <span class='ivar'>@config</span><span class='period'>.</span><span class='id identifier rubyid_merge!'>merge!</span><span class='lparen'>(</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
908
+ <span class='kw'>end</span>
909
+
910
+
911
+ <span class='comment'># Set rule checks for the option.
912
+ </span> <span class='comment'>#
913
+ </span> <span class='comment'># @param rule [Proc] Rule to check after command line parsing.
914
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_setRuleCheck'>setRuleCheck</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
915
+ <span class='ivar'>@rules</span> <span class='op'>=</span> <span class='id identifier rubyid_rule'>rule</span>
916
+ <span class='kw'>end</span>
917
+
918
+
919
+ <span class='comment'># ------------------------------------------------------------
920
+ </span> <span class='comment'># Command line parsing and checking:
921
+ </span>
922
+ <span class='comment'># Check provided args.
923
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span> <span class='id identifier rubyid_argsState'>argsState</span> <span class='rparen'>)</span>
924
+
925
+ <span class='comment'># Start at top.
926
+ </span> <span class='id identifier rubyid_top'>top</span> <span class='op'>=</span> <span class='kw'>self</span>
927
+
928
+ <span class='kw'>begin</span>
929
+
930
+ <span class='comment'># Parse and check for invalid arguments.
931
+ </span> <span class='kw'>begin</span>
932
+ <span class='id identifier rubyid_top'>top</span> <span class='op'>=</span> <span class='id identifier rubyid_top'>top</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span> <span class='id identifier rubyid_argsState'>argsState</span><span class='comma'>,</span> <span class='id identifier rubyid_top'>top</span><span class='period'>.</span><span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span> <span class='symbol'>:check</span> <span class='rbracket'>]</span> <span class='rparen'>)</span>
933
+ <span class='kw'>end</span> <span class='kw'>while</span><span class='lparen'>(</span> <span class='id identifier rubyid_top'>top</span> <span class='rparen'>)</span>
934
+
935
+ <span class='comment'># Check for any missing valid arguments.
936
+ </span> <span class='id identifier rubyid_checkMissing'>checkMissing</span>
937
+
938
+ <span class='kw'>rescue</span> <span class='const'>Opt</span><span class='op'>::</span><span class='const'>MissingArgument</span><span class='comma'>,</span> <span class='const'>Opt</span><span class='op'>::</span><span class='const'>InvalidOption</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_err'>err</span>
939
+
940
+ <span class='cvar'>@@io</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span>
941
+
942
+ <span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span> <span class='id identifier rubyid_err'>err</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span> <span class='rparen'>)</span>
943
+
944
+ <span class='comment'># Display subcmd specific usage info.
945
+ </span> <span class='id identifier rubyid_err'>err</span><span class='period'>.</span><span class='id identifier rubyid_data'>data</span><span class='period'>.</span><span class='id identifier rubyid_usage'>usage</span>
946
+
947
+ <span class='id identifier rubyid_exit'>exit</span><span class='lparen'>(</span> <span class='int'>1</span> <span class='rparen'>)</span> <span class='kw'>if</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span> <span class='symbol'>:error_exit</span> <span class='rbracket'>]</span>
948
+
949
+ <span class='kw'>end</span>
950
+
951
+ <span class='comment'># Revert back to top after hierarchy travelsal.
952
+ </span> <span class='id identifier rubyid_usageIfHelp'>usageIfHelp</span>
953
+
954
+ <span class='comment'># Check rules.
955
+ </span> <span class='id identifier rubyid_cur'>cur</span> <span class='op'>=</span> <span class='kw'>self</span>
956
+ <span class='kw'>while</span> <span class='id identifier rubyid_cur'>cur</span>
957
+ <span class='id identifier rubyid_cur'>cur</span><span class='period'>.</span><span class='id identifier rubyid_checkRule'>checkRule</span>
958
+ <span class='id identifier rubyid_cur'>cur</span> <span class='op'>=</span> <span class='id identifier rubyid_cur'>cur</span><span class='period'>.</span><span class='id identifier rubyid_givenSubcmd'>givenSubcmd</span>
959
+ <span class='kw'>end</span>
960
+
961
+ <span class='kw'>self</span>
962
+ <span class='kw'>end</span>
963
+
964
+
965
+
966
+ <span class='comment'># Parse cmdline options from args.
967
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span> <span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='id identifier rubyid_checkInvalids'>checkInvalids</span> <span class='op'>=</span> <span class='kw'>true</span> <span class='rparen'>)</span>
968
+
969
+ <span class='kw'>while</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span>
970
+
971
+ <span class='comment'>#puts &quot;Opt.parse (#{@name}): #{args.get}&quot;
972
+ </span>
973
+ <span class='kw'>if</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_isOptTerm'>isOptTerm</span>
974
+
975
+ <span class='comment'># Rest of the args do not belong to this program.
976
+ </span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_next'>next</span>
977
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_master'>master</span><span class='period'>.</span><span class='id identifier rubyid_external'>external</span> <span class='op'>=</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_rest'>rest</span>
978
+ <span class='kw'>break</span>
979
+
980
+ <span class='kw'>elsif</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_isOpt'>isOpt</span>
981
+
982
+ <span class='id identifier rubyid_o'>o</span> <span class='op'>=</span> <span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span> <span class='rparen'>)</span>
983
+
984
+ <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span>
985
+ <span class='kw'>if</span> <span class='id identifier rubyid_checkInvalids'>checkInvalids</span>
986
+ <span class='id identifier rubyid_raise'>raise</span> \
987
+ <span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unknown option \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
988
+ <span class='kw'>self</span> <span class='rparen'>)</span>
989
+ <span class='kw'>else</span>
990
+ <span class='id identifier rubyid_o'>o</span> <span class='op'>=</span> <span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
991
+ <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span>
992
+ <span class='id identifier rubyid_raise'>raise</span> \
993
+ <span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
994
+ <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No default option specified for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
995
+ <span class='kw'>self</span> <span class='rparen'>)</span>
996
+ <span class='kw'>else</span>
997
+ <span class='comment'># Default option.
998
+ </span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_value'>value</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_toValue'>toValue</span>
999
+ <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_next'>next</span>
1000
+ <span class='kw'>end</span>
1001
+ <span class='kw'>end</span>
1002
+
1003
+ <span class='kw'>elsif</span> <span class='id identifier rubyid_o'>o</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_hasArg'>hasArg</span>
1004
+
1005
+ <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_next'>next</span>
1006
+
1007
+ <span class='kw'>if</span> <span class='lparen'>(</span> <span class='op'>!</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span> <span class='op'>||</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_isOpt'>isOpt</span> <span class='rparen'>)</span> <span class='op'>&amp;&amp;</span>
1008
+ <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_type'>type</span> <span class='op'>!=</span> <span class='symbol'>:opt_any</span>
1009
+
1010
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>MissingArgument</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
1011
+ <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No argument given for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
1012
+ <span class='kw'>self</span> <span class='rparen'>)</span>
1013
+
1014
+ <span class='kw'>else</span>
1015
+
1016
+ <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_hasMany'>hasMany</span>
1017
+
1018
+ <span class='comment'># Get all argument for multi-option.
1019
+ </span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span> <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
1020
+ <span class='kw'>while</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span> <span class='op'>&amp;&amp;</span> <span class='op'>!</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_isOpt'>isOpt</span>
1021
+ <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_value'>value</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_toValue'>toValue</span>
1022
+ <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_next'>next</span>
1023
+ <span class='kw'>end</span>
1024
+
1025
+ <span class='kw'>else</span>
1026
+
1027
+ <span class='comment'># Get one argument for single-option.
1028
+ </span>
1029
+ <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
1030
+ <span class='id identifier rubyid_raise'>raise</span> \
1031
+ <span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
1032
+ <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Too many arguments for option (\&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;)...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
1033
+ <span class='kw'>self</span> <span class='rparen'>)</span>
1034
+ <span class='kw'>else</span>
1035
+ <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_toValue'>toValue</span>
1036
+ <span class='kw'>end</span>
1037
+ <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_next'>next</span>
1038
+ <span class='kw'>end</span>
1039
+ <span class='kw'>end</span>
1040
+
1041
+ <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span> <span class='op'>=</span> <span class='kw'>true</span>
1042
+
1043
+ <span class='kw'>else</span>
1044
+
1045
+ <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span>
1046
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No valid options specified...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
1047
+ <span class='kw'>self</span> <span class='rparen'>)</span>
1048
+ <span class='kw'>else</span>
1049
+ <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_value'>value</span> <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
1050
+ <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span> <span class='op'>=</span> <span class='kw'>true</span>
1051
+ <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_next'>next</span>
1052
+ <span class='kw'>end</span>
1053
+ <span class='kw'>end</span>
1054
+
1055
+ <span class='kw'>else</span>
1056
+
1057
+ <span class='comment'># Subcmd or default. Check for Subcmd first.
1058
+ </span>
1059
+ <span class='comment'># Search for Subcmd.
1060
+ </span> <span class='id identifier rubyid_o'>o</span> <span class='op'>=</span> <span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span> <span class='rparen'>)</span>
1061
+
1062
+ <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span>
1063
+
1064
+ <span class='comment'># Search for default option.
1065
+ </span> <span class='id identifier rubyid_o'>o</span> <span class='op'>=</span> <span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
1066
+ <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span>
1067
+ <span class='id identifier rubyid_raise'>raise</span> \
1068
+ <span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
1069
+ <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No default option specified for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
1070
+ <span class='kw'>self</span> <span class='rparen'>)</span>
1071
+ <span class='kw'>else</span>
1072
+ <span class='comment'># Default option.
1073
+ </span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span> <span class='op'>=</span> <span class='kw'>true</span>
1074
+ <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_value'>value</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_toValue'>toValue</span>
1075
+ <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_next'>next</span>
1076
+ <span class='kw'>end</span>
1077
+
1078
+ <span class='kw'>else</span>
1079
+
1080
+ <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span> <span class='op'>=</span> <span class='kw'>true</span>
1081
+ <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_next'>next</span>
1082
+ <span class='kw'>return</span> <span class='id identifier rubyid_o'>o</span>
1083
+
1084
+ <span class='kw'>end</span>
1085
+
1086
+ <span class='kw'>end</span>
1087
+ <span class='kw'>end</span>
1088
+
1089
+ <span class='kw'>nil</span>
1090
+ <span class='kw'>end</span>
1091
+
1092
+
1093
+ <span class='comment'># Check for any non-given required arguments recursively
1094
+ </span> <span class='comment'># through hierarchy of subcommands. MissingArgument Exception
1095
+ </span> <span class='comment'># is generated if argument is missing.
1096
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_checkMissing'>checkMissing</span>
1097
+
1098
+ <span class='comment'># Full cmd name.
1099
+ </span> <span class='id identifier rubyid_cmd'>cmd</span> <span class='op'>=</span> <span class='lparen'>(</span> <span class='id identifier rubyid_getParents'>getParents</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span> <span class='kw'>end</span> <span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'> </span><span class='tstring_end'>'</span></span> <span class='rparen'>)</span>
1100
+
1101
+ <span class='comment'># Check for any exclusive args first.
1102
+ </span> <span class='ivar'>@subopt</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1103
+ <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_type'>type</span> <span class='op'>==</span> <span class='symbol'>:exclusive</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
1104
+ <span class='kw'>return</span>
1105
+ <span class='kw'>end</span>
1106
+ <span class='kw'>end</span>
1107
+
1108
+
1109
+ <span class='comment'># Check for required arguments for this level before
1110
+ </span> <span class='comment'># subcmds.
1111
+ </span> <span class='ivar'>@subopt</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1112
+ <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_isRequired'>isRequired</span>
1113
+ <span class='kw'>unless</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
1114
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>MissingArgument</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
1115
+ <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Option \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot; missing for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmd'>cmd</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
1116
+ <span class='kw'>self</span> <span class='rparen'>)</span>
1117
+ <span class='kw'>end</span>
1118
+ <span class='kw'>end</span>
1119
+ <span class='kw'>end</span>
1120
+
1121
+ <span class='kw'>if</span> <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:subcheck</span> <span class='rbracket'>]</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_hasSubcmd'>hasSubcmd</span>
1122
+ <span class='comment'># Compulsory Subcommand checking enabled.
1123
+ </span> <span class='id identifier rubyid_subcmdGiven'>subcmdGiven</span> <span class='op'>=</span> <span class='kw'>false</span>
1124
+ <span class='kw'>else</span>
1125
+ <span class='id identifier rubyid_subcmdGiven'>subcmdGiven</span> <span class='op'>=</span> <span class='kw'>true</span>
1126
+ <span class='kw'>end</span>
1127
+
1128
+ <span class='comment'># Check for any subcmd args.
1129
+ </span> <span class='id identifier rubyid_sub'>sub</span> <span class='op'>=</span> <span class='id identifier rubyid_givenSubcmd'>givenSubcmd</span>
1130
+ <span class='kw'>if</span> <span class='id identifier rubyid_sub'>sub</span>
1131
+ <span class='id identifier rubyid_subcmdGiven'>subcmdGiven</span> <span class='op'>=</span> <span class='kw'>true</span>
1132
+ <span class='comment'># Use recursion to examine the next level.
1133
+ </span> <span class='kw'>return</span> <span class='id identifier rubyid_sub'>sub</span><span class='period'>.</span><span class='id identifier rubyid_checkMissing'>checkMissing</span>
1134
+ <span class='kw'>end</span>
1135
+
1136
+ <span class='comment'># If no subcmds are given, issue error.
1137
+ </span> <span class='id identifier rubyid_raise'>raise</span> <span class='const'>MissingArgument</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
1138
+ <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Subcommand required for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmd'>cmd</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
1139
+ <span class='kw'>self</span> <span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_subcmdGiven'>subcmdGiven</span>
1140
+
1141
+ <span class='kw'>end</span>
1142
+
1143
+
1144
+
1145
+ <span class='comment'># Check option combination rules.
1146
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_checkRule'>checkRule</span>
1147
+
1148
+ <span class='kw'>return</span> <span class='kw'>unless</span> <span class='ivar'>@rules</span>
1149
+
1150
+ <span class='kw'>begin</span>
1151
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>Opt</span><span class='op'>::</span><span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Option combination mismatch!</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='kw'>self</span> <span class='rparen'>)</span> <span class='kw'>unless</span>
1152
+ <span class='const'>RuleCheck</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span> <span class='kw'>self</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='ivar'>@rules</span> <span class='rparen'>)</span>
1153
+
1154
+ <span class='kw'>rescue</span> <span class='const'>Opt</span><span class='op'>::</span><span class='const'>MissingArgument</span><span class='comma'>,</span> <span class='const'>Opt</span><span class='op'>::</span><span class='const'>InvalidOption</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_err'>err</span>
1155
+ <span class='cvar'>@@io</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span>
1156
+ <span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span> <span class='id identifier rubyid_err'>err</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span> <span class='rparen'>)</span>
1157
+
1158
+ <span class='id identifier rubyid_usage'>usage</span><span class='lparen'>(</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='kw'>true</span> <span class='rparen'>)</span>
1159
+
1160
+ <span class='comment'># Included in
1161
+ </span><span class='comment'># # Display the possible combination:
1162
+ </span><span class='comment'># @@io.puts &quot;\n Option combinations:\n\n&quot;
1163
+ </span><span class='comment'># RuleDisplay.print( &amp;@rules )
1164
+ </span>
1165
+ <span class='kw'>end</span>
1166
+ <span class='kw'>end</span>
1167
+
1168
+
1169
+ <span class='comment'># Additional option check.
1170
+ </span> <span class='comment'># @param opt [String] Option name.
1171
+ </span> <span class='comment'># @param error [String] Error string for false return values (from check).
1172
+ </span> <span class='comment'># @param check [Proc] Checker proc run for the option. Either
1173
+ </span> <span class='comment'># return false or generate an exception when errors found.
1174
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_checkAlso'>checkAlso</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_error'>error</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_check'>check</span> <span class='rparen'>)</span>
1175
+ <span class='kw'>begin</span>
1176
+ <span class='kw'>if</span> <span class='kw'>self</span><span class='lbracket'>[</span><span class='id identifier rubyid_opt'>opt</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_evalCheck'>evalCheck</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_check'>check</span> <span class='rparen'>)</span> <span class='op'>!=</span> <span class='kw'>true</span>
1177
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>Opt</span><span class='op'>::</span><span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='id identifier rubyid_error'>error</span><span class='comma'>,</span> <span class='kw'>self</span> <span class='rparen'>)</span>
1178
+ <span class='kw'>end</span>
1179
+ <span class='kw'>rescue</span> <span class='const'>Opt</span><span class='op'>::</span><span class='const'>MissingArgument</span><span class='comma'>,</span> <span class='const'>Opt</span><span class='op'>::</span><span class='const'>InvalidOption</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_err'>err</span>
1180
+ <span class='cvar'>@@io</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span>
1181
+ <span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span> <span class='id identifier rubyid_err'>err</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span> <span class='rparen'>)</span>
1182
+ <span class='id identifier rubyid_err'>err</span><span class='period'>.</span><span class='id identifier rubyid_data'>data</span><span class='period'>.</span><span class='id identifier rubyid_usage'>usage</span>
1183
+ <span class='id identifier rubyid_exit'>exit</span><span class='lparen'>(</span> <span class='int'>1</span> <span class='rparen'>)</span>
1184
+ <span class='kw'>end</span>
1185
+ <span class='kw'>end</span>
1186
+
1187
+
1188
+
1189
+
1190
+ <span class='comment'># ------------------------------------------------------------
1191
+ </span> <span class='comment'># Opt query user interface:
1192
+ </span>
1193
+ <span class='comment'># Select option object by name operator.
1194
+ </span> <span class='kw'>def</span> <span class='op'>[]</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1195
+ <span class='id identifier rubyid_ret'>ret</span> <span class='op'>=</span> <span class='id identifier rubyid_argByName'>argByName</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1196
+ <span class='kw'>unless</span> <span class='id identifier rubyid_ret'>ret</span>
1197
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>RuntimeError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Subopt \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_str'>str</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot; does not exist for \&quot;</span><span class='embexpr_beg'>#{</span><span class='ivar'>@name</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;!</span><span class='tstring_end'>&quot;</span></span>
1198
+ <span class='kw'>end</span>
1199
+ <span class='id identifier rubyid_ret'>ret</span>
1200
+ <span class='kw'>end</span>
1201
+
1202
+
1203
+ <span class='comment'># All subcommand options, options and subcommands.
1204
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_suball'>suball</span>
1205
+ <span class='ivar'>@subopt</span> <span class='op'>+</span> <span class='ivar'>@subcmd</span>
1206
+ <span class='kw'>end</span>
1207
+
1208
+
1209
+ <span class='comment'># Options list iterator.
1210
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_each'>each</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_blk'>blk</span> <span class='rparen'>)</span>
1211
+ <span class='id identifier rubyid_suball'>suball</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1212
+ <span class='kw'>yield</span> <span class='id identifier rubyid_o'>o</span>
1213
+ <span class='kw'>end</span>
1214
+ <span class='kw'>end</span>
1215
+
1216
+
1217
+ <span class='comment'># Options iterator for given options.
1218
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_each_given'>each_given</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_blk'>blk</span> <span class='rparen'>)</span>
1219
+ <span class='id identifier rubyid_suball'>suball</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1220
+ <span class='kw'>yield</span> <span class='id identifier rubyid_o'>o</span> <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
1221
+ <span class='kw'>end</span>
1222
+ <span class='kw'>end</span>
1223
+
1224
+
1225
+ <span class='comment'># Number of given options.
1226
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_givenCount'>givenCount</span>
1227
+ <span class='id identifier rubyid_cnt'>cnt</span> <span class='op'>=</span> <span class='int'>0</span>
1228
+ <span class='id identifier rubyid_each_given'>each_given</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span>
1229
+ <span class='id identifier rubyid_cnt'>cnt</span> <span class='op'>+=</span> <span class='int'>1</span>
1230
+ <span class='kw'>end</span>
1231
+ <span class='id identifier rubyid_cnt'>cnt</span>
1232
+ <span class='kw'>end</span>
1233
+
1234
+
1235
+ <span class='comment'># Short syntax for value reference. Example: &quot;~Opt['file']&quot;.
1236
+ </span> <span class='kw'>def</span> <span class='op'>~</span><span class='lparen'>(</span><span class='rparen'>)</span>
1237
+ <span class='ivar'>@value</span>
1238
+ <span class='kw'>end</span>
1239
+
1240
+
1241
+ <span class='comment'># Return option value if given otherwise the default.
1242
+ </span> <span class='comment'># Example usage: fileName = Opt[&quot;file&quot;].apply( &quot;no_name.txt&quot; )
1243
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_apply'>apply</span><span class='lparen'>(</span> <span class='id identifier rubyid_default'>default</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
1244
+ <span class='kw'>if</span> <span class='id identifier rubyid_given'>given</span>
1245
+ <span class='id identifier rubyid_value'>value</span>
1246
+ <span class='kw'>else</span>
1247
+ <span class='id identifier rubyid_default'>default</span>
1248
+ <span class='kw'>end</span>
1249
+ <span class='kw'>end</span>
1250
+
1251
+
1252
+ <span class='comment'># Returns true if option is given, and block is not
1253
+ </span> <span class='comment'># present. When block is present, the block is executed (with
1254
+ </span> <span class='comment'># value as parameter) if option has been given.
1255
+ </span> <span class='comment'>#
1256
+ </span> <span class='comment'># @param yieldOpt [Boolean] Pass Opt to block instead of its
1257
+ </span> <span class='comment'># value.
1258
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_given'>given</span><span class='lparen'>(</span> <span class='id identifier rubyid_yieldOpt'>yieldOpt</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_prog'>prog</span> <span class='rparen'>)</span>
1259
+ <span class='kw'>if</span> <span class='id identifier rubyid_block_given?'>block_given?</span>
1260
+ <span class='kw'>if</span> <span class='ivar'>@given</span>
1261
+ <span class='kw'>if</span> <span class='id identifier rubyid_yieldOpt'>yieldOpt</span>
1262
+ <span class='kw'>yield</span><span class='lparen'>(</span> <span class='kw'>self</span> <span class='rparen'>)</span>
1263
+ <span class='kw'>else</span>
1264
+ <span class='kw'>yield</span><span class='lparen'>(</span> <span class='ivar'>@value</span> <span class='rparen'>)</span>
1265
+ <span class='kw'>end</span>
1266
+ <span class='kw'>else</span>
1267
+ <span class='kw'>false</span>
1268
+ <span class='kw'>end</span>
1269
+ <span class='kw'>else</span>
1270
+ <span class='ivar'>@given</span>
1271
+ <span class='kw'>end</span>
1272
+ <span class='kw'>end</span>
1273
+
1274
+
1275
+ <span class='comment'># Alias for given.
1276
+ </span> <span class='kw'>alias</span> <span class='id identifier rubyid_given?'>given?</span> <span class='id identifier rubyid_given'>given</span>
1277
+
1278
+
1279
+ <span class='comment'># Return the selected subcommand.
1280
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_givenSubcmd'>givenSubcmd</span>
1281
+ <span class='lparen'>(</span> <span class='ivar'>@subcmd</span><span class='period'>.</span><span class='id identifier rubyid_select'>select</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span> <span class='kw'>end</span> <span class='rparen'>)</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
1282
+ <span class='kw'>end</span>
1283
+
1284
+
1285
+ <span class='comment'># Returns Hash of option value parameters. Example command
1286
+ </span> <span class='comment'># line content:
1287
+ </span> <span class='comment'># -p rounds=10 length=5
1288
+ </span> <span class='comment'># Option value content in this case would be (Array of param
1289
+ </span> <span class='comment'># settings):
1290
+ </span> <span class='comment'># [ &quot;rounds=10&quot;, &quot;length=5&quot; ]
1291
+ </span> <span class='comment'># @return [Hash] Parameter settings included in the option.
1292
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_params'>params</span>
1293
+ <span class='id identifier rubyid_map'>map</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
1294
+ <span class='ivar'>@value</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span>
1295
+ <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>=</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
1296
+ <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='id identifier rubyid_str_to_num'>str_to_num</span><span class='lparen'>(</span> <span class='id identifier rubyid_value'>value</span> <span class='rparen'>)</span>
1297
+ <span class='id identifier rubyid_map'>map</span><span class='lbracket'>[</span> <span class='id identifier rubyid_name'>name</span> <span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_value'>value</span>
1298
+ <span class='kw'>end</span>
1299
+ <span class='id identifier rubyid_map'>map</span>
1300
+ <span class='kw'>end</span>
1301
+
1302
+
1303
+ <span class='comment'># Return default options.
1304
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_default'>default</span>
1305
+ <span class='id identifier rubyid_argByName'>argByName</span><span class='lparen'>(</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
1306
+ <span class='kw'>end</span>
1307
+
1308
+
1309
+ <span class='comment'># Select option object by name.
1310
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_argByName'>argByName</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1311
+ <span class='kw'>if</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='kw'>nil</span>
1312
+ <span class='ivar'>@subopt</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1313
+ <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_type'>type</span> <span class='op'>==</span> <span class='symbol'>:default</span>
1314
+ <span class='kw'>return</span> <span class='id identifier rubyid_o'>o</span>
1315
+ <span class='kw'>end</span>
1316
+ <span class='kw'>end</span>
1317
+ <span class='kw'>nil</span>
1318
+ <span class='kw'>else</span>
1319
+ <span class='id identifier rubyid_suball'>suball</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1320
+ <span class='kw'>if</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span>
1321
+ <span class='kw'>return</span> <span class='id identifier rubyid_o'>o</span>
1322
+ <span class='kw'>end</span>
1323
+ <span class='kw'>end</span>
1324
+ <span class='kw'>nil</span>
1325
+ <span class='kw'>end</span>
1326
+ <span class='kw'>end</span>
1327
+
1328
+
1329
+ <span class='comment'># Select option object by name/opt/longOpt.
1330
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_argById'>argById</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1331
+ <span class='kw'>if</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='kw'>nil</span>
1332
+ <span class='ivar'>@subopt</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1333
+ <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_type'>type</span> <span class='op'>==</span> <span class='symbol'>:default</span>
1334
+ <span class='kw'>return</span> <span class='id identifier rubyid_o'>o</span>
1335
+ <span class='kw'>end</span>
1336
+ <span class='kw'>end</span>
1337
+ <span class='kw'>nil</span>
1338
+ <span class='kw'>else</span>
1339
+ <span class='id identifier rubyid_suball'>suball</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1340
+ <span class='kw'>if</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span> <span class='op'>||</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span> <span class='op'>||</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_longOpt'>longOpt</span>
1341
+ <span class='kw'>return</span> <span class='id identifier rubyid_o'>o</span>
1342
+ <span class='kw'>end</span>
1343
+ <span class='kw'>end</span>
1344
+ <span class='kw'>nil</span>
1345
+ <span class='kw'>end</span>
1346
+ <span class='kw'>end</span>
1347
+
1348
+
1349
+ <span class='comment'># Option requires argument?
1350
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_hasArg'>hasArg</span>
1351
+ <span class='kw'>case</span> <span class='ivar'>@type</span>
1352
+ <span class='kw'>when</span> <span class='symbol'>:single</span><span class='comma'>,</span> <span class='symbol'>:multi</span><span class='comma'>,</span> <span class='symbol'>:opt_single</span><span class='comma'>,</span> <span class='symbol'>:opt_multi</span><span class='comma'>,</span> <span class='symbol'>:opt_any</span><span class='semicolon'>;</span> <span class='kw'>true</span>
1353
+ <span class='kw'>else</span> <span class='kw'>false</span>
1354
+ <span class='kw'>end</span>
1355
+ <span class='kw'>end</span>
1356
+
1357
+
1358
+ <span class='comment'># Option requires many arguments?
1359
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_hasMany'>hasMany</span>
1360
+ <span class='kw'>case</span> <span class='ivar'>@type</span>
1361
+ <span class='kw'>when</span> <span class='symbol'>:multi</span><span class='comma'>,</span> <span class='symbol'>:opt_multi</span><span class='comma'>,</span> <span class='symbol'>:opt_any</span><span class='semicolon'>;</span> <span class='kw'>true</span>
1362
+ <span class='kw'>else</span> <span class='kw'>false</span>
1363
+ <span class='kw'>end</span>
1364
+ <span class='kw'>end</span>
1365
+
1366
+
1367
+ <span class='comment'># Is mandatory argument?
1368
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_isRequired'>isRequired</span>
1369
+ <span class='kw'>case</span> <span class='ivar'>@type</span>
1370
+ <span class='kw'>when</span> <span class='symbol'>:single</span><span class='comma'>,</span> <span class='symbol'>:multi</span><span class='semicolon'>;</span> <span class='kw'>true</span>
1371
+ <span class='kw'>else</span> <span class='kw'>false</span>
1372
+ <span class='kw'>end</span>
1373
+ <span class='kw'>end</span>
1374
+
1375
+
1376
+ <span class='comment'># Test if option is silent.
1377
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_silent?'>silent?</span>
1378
+ <span class='ivar'>@silent</span>
1379
+ <span class='kw'>end</span>
1380
+
1381
+
1382
+ <span class='comment'># Test if option is of switch type.
1383
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_isSwitch'>isSwitch</span>
1384
+ <span class='kw'>case</span> <span class='ivar'>@type</span>
1385
+ <span class='kw'>when</span> <span class='symbol'>:switch</span><span class='comma'>,</span> <span class='symbol'>:exclusive</span><span class='comma'>,</span> <span class='symbol'>:default</span><span class='semicolon'>;</span> <span class='kw'>true</span>
1386
+ <span class='kw'>else</span> <span class='kw'>false</span>
1387
+ <span class='kw'>end</span>
1388
+ <span class='kw'>end</span>
1389
+
1390
+
1391
+ <span class='comment'># ------------------------------------------------------------
1392
+ </span> <span class='comment'># Opt &quot;Usage Help&quot; user interface:
1393
+ </span>
1394
+ <span class='comment'># Set optional header for &quot;usage&quot;.
1395
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_setUsageHeader'>setUsageHeader</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1396
+ <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:header</span> <span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_str'>str</span>
1397
+ <span class='kw'>end</span>
1398
+
1399
+
1400
+ <span class='comment'># Set optional footer for &quot;usage&quot;.
1401
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_setUsageFooter'>setUsageFooter</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1402
+ <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:footer</span> <span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_str'>str</span>
1403
+ <span class='kw'>end</span>
1404
+
1405
+
1406
+ <span class='comment'># Display program usage (and optionally exit).
1407
+ </span> <span class='comment'>#
1408
+ </span> <span class='comment'># @param doExit [NilClass,Boolean] Exit program after help
1409
+ </span> <span class='comment'># display. Default to help_exit config if nil.
1410
+ </span> <span class='comment'># @param ruleHelp [NilClass,Boolean] Include rule help to help
1411
+ </span> <span class='comment'># display. Deault to rulehelp config if nil.
1412
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_usage'>usage</span><span class='lparen'>(</span> <span class='id identifier rubyid_doExit'>doExit</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_ruleHelp'>ruleHelp</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
1413
+
1414
+ <span class='id identifier rubyid_doExit'>doExit</span> <span class='op'>=</span> <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:help_exit</span> <span class='rbracket'>]</span> <span class='kw'>if</span> <span class='id identifier rubyid_doExit'>doExit</span> <span class='op'>==</span> <span class='kw'>nil</span>
1415
+ <span class='id identifier rubyid_ruleHelp'>ruleHelp</span> <span class='op'>=</span> <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:rulehelp</span> <span class='rbracket'>]</span> <span class='kw'>if</span> <span class='id identifier rubyid_ruleHelp'>ruleHelp</span> <span class='op'>==</span> <span class='kw'>nil</span>
1416
+
1417
+ <span class='cvar'>@@io</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span> <span class='id identifier rubyid_usageNormal'>usageNormal</span>
1418
+
1419
+ <span class='kw'>if</span> <span class='id identifier rubyid_ruleHelp'>ruleHelp</span>
1420
+ <span class='cvar'>@@io</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n Option Combinations:</span><span class='tstring_end'>&quot;</span></span>
1421
+ <span class='cvar'>@@io</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span> <span class='const'>RuleDisplay</span><span class='period'>.</span><span class='id identifier rubyid_print'>print</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='ivar'>@rules</span> <span class='rparen'>)</span>
1422
+ <span class='kw'>end</span>
1423
+
1424
+ <span class='id identifier rubyid_exit'>exit</span><span class='lparen'>(</span> <span class='int'>1</span> <span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_doExit'>doExit</span>
1425
+ <span class='kw'>end</span>
1426
+
1427
+
1428
+ <span class='comment'># Display program usage (and optionally exit).
1429
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_usageIfHelp'>usageIfHelp</span>
1430
+ <span class='kw'>if</span> <span class='kw'>self</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>help</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
1431
+ <span class='id identifier rubyid_usage'>usage</span>
1432
+ <span class='kw'>elsif</span> <span class='id identifier rubyid_hasSubcmd'>hasSubcmd</span>
1433
+ <span class='id identifier rubyid_givenSubcmd'>givenSubcmd</span><span class='period'>.</span><span class='id identifier rubyid_usageIfHelp'>usageIfHelp</span>
1434
+ <span class='kw'>end</span>
1435
+ <span class='kw'>end</span>
1436
+
1437
+
1438
+ <span class='comment'># Usage printout for command.
1439
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_usageCommand'>usageCommand</span>
1440
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
1441
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>
1442
+ Subcommand \&quot;</span><span class='embexpr_beg'>#{</span><span class='ivar'>@name</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot; usage:
1443
+ </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_fullCommand'>fullCommand</span><span class='rbrace'>}</span><span class='tstring_content'> </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmdline'>cmdline</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> </span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='tstring_content'>
1444
+
1445
+ </span><span class='tstring_end'>&quot;</span></span>
1446
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='id identifier rubyid_suboptDoc'>suboptDoc</span>
1447
+
1448
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span>
1449
+ <span class='kw'>end</span>
1450
+
1451
+ <span class='comment'># Usage info for Opt:s.
1452
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_usageNormal'>usageNormal</span>
1453
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
1454
+
1455
+ <span class='kw'>if</span> <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:header</span> <span class='rbracket'>]</span>
1456
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span>
1457
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:header</span> <span class='rbracket'>]</span>
1458
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span>
1459
+ <span class='kw'>end</span>
1460
+
1461
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='id identifier rubyid_usageCommand'>usageCommand</span>
1462
+
1463
+ <span class='kw'>if</span> <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:footer</span> <span class='rbracket'>]</span>
1464
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:footer</span> <span class='rbracket'>]</span>
1465
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span>
1466
+ <span class='kw'>end</span>
1467
+
1468
+ <span class='id identifier rubyid_str'>str</span>
1469
+ <span class='kw'>end</span>
1470
+
1471
+
1472
+ <span class='comment'># Return cmdline usage strings for options in an Array.
1473
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_cmdline'>cmdline</span>
1474
+ <span class='id identifier rubyid_opts'>opts</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
1475
+
1476
+ <span class='ivar'>@subopt</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1477
+
1478
+ <span class='kw'>next</span> <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_silent?'>silent?</span>
1479
+
1480
+ <span class='id identifier rubyid_prural'>prural</span> <span class='op'>=</span> <span class='kw'>nil</span>
1481
+ <span class='kw'>case</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_type'>type</span>
1482
+ <span class='kw'>when</span> <span class='symbol'>:multi</span><span class='comma'>,</span> <span class='symbol'>:opt_multi</span><span class='semicolon'>;</span> <span class='id identifier rubyid_prural'>prural</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>+</span><span class='tstring_end'>&quot;</span></span>
1483
+ <span class='kw'>when</span> <span class='symbol'>:opt_any</span><span class='semicolon'>;</span> <span class='id identifier rubyid_prural'>prural</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>*</span><span class='tstring_end'>&quot;</span></span>
1484
+ <span class='kw'>else</span> <span class='id identifier rubyid_prural'>prural</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
1485
+ <span class='kw'>end</span>
1486
+
1487
+
1488
+ <span class='kw'>if</span> <span class='op'>!</span><span class='lparen'>(</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_isSwitch'>isSwitch</span> <span class='rparen'>)</span>
1489
+ <span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> &lt;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span><span class='rbrace'>}</span><span class='tstring_content'>&gt;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_prural'>prural</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
1490
+ <span class='kw'>else</span>
1491
+ <span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
1492
+ <span class='kw'>end</span>
1493
+
1494
+ <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span> <span class='op'>==</span> <span class='kw'>nil</span>
1495
+ <span class='id identifier rubyid_opt'>opt</span> <span class='op'>=</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_longOpt'>longOpt</span>
1496
+ <span class='kw'>else</span>
1497
+ <span class='id identifier rubyid_opt'>opt</span> <span class='op'>=</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span>
1498
+ <span class='kw'>end</span>
1499
+
1500
+ <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_isRequired'>isRequired</span>
1501
+ <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opt'>opt</span><span class='rbrace'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
1502
+ <span class='kw'>else</span>
1503
+ <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>[</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opt'>opt</span><span class='rbrace'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='rbrace'>}</span><span class='tstring_content'>]</span><span class='tstring_end'>&quot;</span></span>
1504
+ <span class='kw'>end</span>
1505
+ <span class='kw'>end</span>
1506
+
1507
+
1508
+ <span class='kw'>if</span> <span class='id identifier rubyid_hasSubcmd'>hasSubcmd</span>
1509
+ <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>&lt;&lt;subcommand&gt;&gt;</span><span class='tstring_end'>&quot;</span></span>
1510
+ <span class='kw'>end</span>
1511
+
1512
+ <span class='id identifier rubyid_opts'>opts</span>
1513
+
1514
+ <span class='kw'>end</span>
1515
+
1516
+
1517
+ <span class='comment'># Return document strings for options.
1518
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_suboptDoc'>suboptDoc</span>
1519
+
1520
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
1521
+ <span class='id identifier rubyid_format'>format</span> <span class='op'>=</span> <span class='const'>Proc</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_s'>s</span><span class='comma'>,</span><span class='id identifier rubyid_d'>d</span><span class='op'>|</span> <span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> %-</span><span class='embexpr_beg'>#{</span><span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:tab</span> <span class='rbracket'>]</span><span class='rbrace'>}</span><span class='tstring_content'>s%s\n</span><span class='tstring_end'>&quot;</span></span> <span class='op'>%</span> <span class='lbracket'>[</span> <span class='id identifier rubyid_s'>s</span><span class='comma'>,</span> <span class='id identifier rubyid_d'>d</span> <span class='rbracket'>]</span> <span class='rparen'>)</span> <span class='kw'>end</span>
1522
+
1523
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='id identifier rubyid_format'>format</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Options:</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_hasSubcmd'>hasSubcmd</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_hasVisibleOptions'>hasVisibleOptions</span>
1524
+
1525
+ <span class='ivar'>@subopt</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1526
+ <span class='kw'>next</span> <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_silent?'>silent?</span>
1527
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='id identifier rubyid_format'>format</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span> <span class='op'>?</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span> <span class='op'>:</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_longOpt'>longOpt</span><span class='comma'>,</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_doc'>doc</span> <span class='rparen'>)</span>
1528
+ <span class='kw'>end</span>
1529
+
1530
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span> <span class='op'>+</span> <span class='id identifier rubyid_format'>format</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Subcommands:</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_hasSubcmd'>hasSubcmd</span>
1531
+
1532
+ <span class='ivar'>@subcmd</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
1533
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='id identifier rubyid_format'>format</span><span class='period'>.</span><span class='id identifier rubyid_call'>call</span><span class='lparen'>(</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_doc'>doc</span> <span class='rparen'>)</span>
1534
+ <span class='kw'>end</span>
1535
+
1536
+ <span class='id identifier rubyid_str'>str</span>
1537
+ <span class='kw'>end</span>
1538
+
1539
+
1540
+ <span class='comment'># Find option object by option str.
1541
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1542
+ <span class='kw'>if</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='kw'>nil</span>
1543
+ <span class='lparen'>(</span> <span class='id identifier rubyid_suball'>suball</span><span class='period'>.</span><span class='id identifier rubyid_select'>select</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_type'>type</span> <span class='op'>==</span> <span class='symbol'>:default</span> <span class='rbrace'>}</span> <span class='rparen'>)</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
1544
+ <span class='kw'>elsif</span> <span class='id identifier rubyid_str'>str</span><span class='lbracket'>[</span><span class='int'>0</span><span class='op'>..</span><span class='int'>1</span><span class='rbracket'>]</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>--</span><span class='tstring_end'>&quot;</span></span>
1545
+ <span class='lparen'>(</span> <span class='id identifier rubyid_suball'>suball</span><span class='period'>.</span><span class='id identifier rubyid_select'>select</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_longOpt'>longOpt</span> <span class='op'>==</span> <span class='id identifier rubyid_str'>str</span> <span class='rbrace'>}</span> <span class='rparen'>)</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
1546
+ <span class='kw'>elsif</span> <span class='id identifier rubyid_str'>str</span><span class='lbracket'>[</span><span class='int'>0</span><span class='op'>..</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='op'>!=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>-</span><span class='tstring_end'>&quot;</span></span>
1547
+ <span class='lparen'>(</span> <span class='id identifier rubyid_suball'>suball</span><span class='period'>.</span><span class='id identifier rubyid_select'>select</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span> <span class='op'>==</span> <span class='id identifier rubyid_str'>str</span> <span class='rbrace'>}</span> <span class='rparen'>)</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
1548
+ <span class='kw'>else</span>
1549
+ <span class='lparen'>(</span> <span class='id identifier rubyid_suball'>suball</span><span class='period'>.</span><span class='id identifier rubyid_select'>select</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span> <span class='op'>==</span> <span class='id identifier rubyid_str'>str</span> <span class='rbrace'>}</span> <span class='rparen'>)</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
1550
+ <span class='kw'>end</span>
1551
+ <span class='kw'>end</span>
1552
+
1553
+
1554
+ <span class='comment'># Como error printout.
1555
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1556
+ <span class='cvar'>@@io</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_progname'>progname</span><span class='rbrace'>}</span><span class='tstring_content'> error: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_str'>str</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
1557
+ <span class='kw'>end</span>
1558
+
1559
+
1560
+
1561
+
1562
+ <span class='comment'># ------------------------------------------------------------
1563
+ </span> <span class='comment'># Internal methods:
1564
+ </span>
1565
+ <span class='id identifier rubyid_private'>private</span>
1566
+
1567
+
1568
+ <span class='comment'># Convert string to number if possible. The order of checks:
1569
+ </span> <span class='comment'># integer, float, and no-conversion.
1570
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_str_to_num'>str_to_num</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1571
+ <span class='kw'>begin</span> <span class='kw'>return</span> <span class='const'>Integer</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span><span class='semicolon'>;</span> <span class='kw'>rescue</span> <span class='semicolon'>;</span> <span class='kw'>end</span>
1572
+ <span class='kw'>begin</span> <span class='kw'>return</span> <span class='const'>Float</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span><span class='semicolon'>;</span> <span class='kw'>rescue</span> <span class='semicolon'>;</span> <span class='kw'>end</span>
1573
+ <span class='id identifier rubyid_str'>str</span>
1574
+ <span class='kw'>end</span>
1575
+
1576
+
1577
+ <span class='comment'># Return list of parents.
1578
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_getParents'>getParents</span>
1579
+ <span class='id identifier rubyid_list'>list</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
1580
+ <span class='id identifier rubyid_cur'>cur</span> <span class='op'>=</span> <span class='kw'>self</span>
1581
+ <span class='kw'>begin</span>
1582
+ <span class='id identifier rubyid_list'>list</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='id identifier rubyid_cur'>cur</span>
1583
+ <span class='id identifier rubyid_cur'>cur</span> <span class='op'>=</span> <span class='id identifier rubyid_cur'>cur</span><span class='period'>.</span><span class='id identifier rubyid_parent'>parent</span>
1584
+ <span class='kw'>end</span> <span class='kw'>while</span> <span class='id identifier rubyid_cur'>cur</span>
1585
+
1586
+ <span class='id identifier rubyid_list'>list</span><span class='period'>.</span><span class='id identifier rubyid_reverse'>reverse</span>
1587
+ <span class='kw'>end</span>
1588
+
1589
+
1590
+ <span class='comment'># Full command name.
1591
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_fullCommand'>fullCommand</span>
1592
+ <span class='lparen'>(</span> <span class='id identifier rubyid_getParents'>getParents</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span> <span class='kw'>end</span> <span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'> </span><span class='tstring_end'>'</span></span> <span class='rparen'>)</span>
1593
+ <span class='kw'>end</span>
1594
+
1595
+
1596
+ <span class='comment'># Test if option is of subcmd type.
1597
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_isSubcmd'>isSubcmd</span>
1598
+ <span class='ivar'>@type</span> <span class='op'>==</span> <span class='symbol'>:subcmd</span>
1599
+ <span class='kw'>end</span>
1600
+
1601
+
1602
+ <span class='comment'># Test if option is of subcmd type.
1603
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_hasVisibleOptions'>hasVisibleOptions</span>
1604
+ <span class='comment'># Count non-silent options.
1605
+ </span> <span class='lparen'>(</span> <span class='ivar'>@subopt</span><span class='period'>.</span><span class='id identifier rubyid_select'>select</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span> <span class='op'>!</span><span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_silent?'>silent?</span> <span class='kw'>end</span> <span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span> <span class='op'>&gt;</span> <span class='int'>0</span>
1606
+ <span class='kw'>end</span>
1607
+
1608
+
1609
+ <span class='comment'># Test if option is of subcmd type.
1610
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_hasSubcmd'>hasSubcmd</span>
1611
+ <span class='op'>!</span><span class='ivar'>@subcmd</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
1612
+ <span class='kw'>end</span>
1613
+
1614
+
1615
+ <span class='comment'># Custom check for the option. User has to know some Como
1616
+ </span> <span class='comment'># internals.
1617
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_evalCheck'>evalCheck</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_check'>check</span> <span class='rparen'>)</span>
1618
+ <span class='id identifier rubyid_instance_eval'>instance_eval</span> <span class='op'>&amp;</span><span class='id identifier rubyid_check'>check</span>
1619
+ <span class='kw'>end</span>
1620
+
1621
+ <span class='kw'>end</span>
1622
+
1623
+
1624
+
1625
+ <span class='comment'># Specialized Opt class for program (i.e. highest level
1626
+ </span> <span class='comment'># subcommand).
1627
+ </span> <span class='kw'>class</span> <span class='const'>MasterOpt</span> <span class='op'>&lt;</span> <span class='const'>Opt</span>
1628
+
1629
+ <span class='comment'># Program external arguments:
1630
+ </span> <span class='id identifier rubyid_attr_accessor'>attr_accessor</span> <span class='symbol'>:external</span>
1631
+
1632
+ <span class='comment'># Program author and year (date).
1633
+ </span> <span class='id identifier rubyid_attr_reader'>attr_reader</span> <span class='symbol'>:author</span><span class='comma'>,</span> <span class='symbol'>:year</span>
1634
+
1635
+
1636
+ <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span> <span class='id identifier rubyid_author'>author</span><span class='comma'>,</span> <span class='id identifier rubyid_year'>year</span><span class='comma'>,</span>
1637
+ <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_type'>type</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
1638
+ <span class='ivar'>@author</span> <span class='op'>=</span> <span class='id identifier rubyid_author'>author</span>
1639
+ <span class='ivar'>@year</span> <span class='op'>=</span> <span class='id identifier rubyid_year'>year</span>
1640
+ <span class='ivar'>@external</span> <span class='op'>=</span> <span class='kw'>nil</span>
1641
+ <span class='kw'>super</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_type'>type</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
1642
+
1643
+ <span class='comment'># # Set of default configs for printout.
1644
+ </span><span class='comment'># @config = {
1645
+ </span><span class='comment'># :header =&gt; nil,
1646
+ </span><span class='comment'># :footer =&gt; nil,
1647
+ </span><span class='comment'># :subcheck =&gt; true,
1648
+ </span><span class='comment'># :check =&gt; true,
1649
+ </span><span class='comment'># :tab =&gt; 12,
1650
+ </span><span class='comment'># :help_exit =&gt; true,
1651
+ </span><span class='comment'># :error_exit =&gt; true,
1652
+ </span><span class='comment'># }
1653
+ </span> <span class='kw'>end</span>
1654
+
1655
+
1656
+ <span class='comment'># Full command name.
1657
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_fullCommand'>fullCommand</span>
1658
+ <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_progname'>progname</span>
1659
+ <span class='kw'>end</span>
1660
+
1661
+
1662
+ <span class='comment'># Usage printout for command.
1663
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_usageCommand'>usageCommand</span>
1664
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>
1665
+ Usage:
1666
+ </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_fullCommand'>fullCommand</span><span class='rbrace'>}</span><span class='tstring_content'> </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmdline'>cmdline</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> </span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='tstring_content'>
1667
+
1668
+ </span><span class='tstring_end'>&quot;</span></span>
1669
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='id identifier rubyid_suboptDoc'>suboptDoc</span>
1670
+
1671
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>
1672
+
1673
+ Copyright (c) </span><span class='embexpr_beg'>#{</span><span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_year'>year</span><span class='rbrace'>}</span><span class='tstring_content'> by </span><span class='embexpr_beg'>#{</span><span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_author'>author</span><span class='rbrace'>}</span><span class='tstring_content'>
1674
+
1675
+ </span><span class='tstring_end'>&quot;</span></span>
1676
+ <span class='kw'>end</span>
1677
+
1678
+ <span class='kw'>end</span>
1679
+
1680
+
1681
+ <span class='comment'># Command argument parsing state.
1682
+ </span> <span class='kw'>class</span> <span class='const'>ArgsParseState</span>
1683
+
1684
+ <span class='comment'># @param list [Array&lt;String&gt;] List of Command Line Arguments (default:
1685
+ </span> <span class='comment'># ARGV).
1686
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span> <span class='id identifier rubyid_list'>list</span> <span class='rparen'>)</span>
1687
+ <span class='id identifier rubyid_set'>set</span><span class='lparen'>(</span> <span class='id identifier rubyid_list'>list</span> <span class='rparen'>)</span>
1688
+ <span class='ivar'>@idx</span> <span class='op'>=</span> <span class='int'>0</span>
1689
+ <span class='kw'>end</span>
1690
+
1691
+ <span class='comment'># Set list of arguments.
1692
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_set'>set</span><span class='lparen'>(</span> <span class='id identifier rubyid_list'>list</span> <span class='rparen'>)</span>
1693
+ <span class='ivar'>@args</span> <span class='op'>=</span> <span class='id identifier rubyid_list'>list</span>
1694
+ <span class='kw'>end</span>
1695
+
1696
+ <span class='comment'># Step to next argument.
1697
+ </span> <span class='kw'>def</span> <span class='kw'>next</span>
1698
+ <span class='ivar'>@idx</span> <span class='op'>+=</span> <span class='int'>1</span>
1699
+ <span class='kw'>end</span>
1700
+
1701
+ <span class='comment'># Step to previous argument.
1702
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_prev'>prev</span>
1703
+ <span class='ivar'>@idx</span> <span class='op'>-=</span> <span class='int'>1</span>
1704
+ <span class='kw'>end</span>
1705
+
1706
+ <span class='comment'># Get current argument.
1707
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_get'>get</span><span class='lparen'>(</span> <span class='id identifier rubyid_idx'>idx</span> <span class='op'>=</span> <span class='ivar'>@idx</span> <span class='rparen'>)</span>
1708
+ <span class='ivar'>@args</span><span class='lbracket'>[</span> <span class='id identifier rubyid_idx'>idx</span> <span class='rbracket'>]</span>
1709
+ <span class='kw'>end</span>
1710
+
1711
+ <span class='comment'># Get last argument.
1712
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_last'>last</span><span class='lparen'>(</span> <span class='id identifier rubyid_idx'>idx</span> <span class='op'>=</span> <span class='ivar'>@idx</span> <span class='rparen'>)</span>
1713
+ <span class='id identifier rubyid_idx'>idx</span> <span class='op'>==</span> <span class='lparen'>(</span> <span class='ivar'>@args</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span><span class='op'>-</span><span class='int'>1</span> <span class='rparen'>)</span>
1714
+ <span class='kw'>end</span>
1715
+
1716
+ <span class='comment'># Get rest of the arguments.
1717
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_rest'>rest</span><span class='lparen'>(</span> <span class='id identifier rubyid_idx'>idx</span> <span class='op'>=</span> <span class='ivar'>@idx</span> <span class='rparen'>)</span>
1718
+ <span class='ivar'>@args</span><span class='lbracket'>[</span> <span class='id identifier rubyid_idx'>idx</span><span class='op'>..</span><span class='op'>-</span><span class='int'>1</span> <span class='rbracket'>]</span>
1719
+ <span class='kw'>end</span>
1720
+
1721
+ <span class='comment'># Parser at argument list end?
1722
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_done?'>done?</span>
1723
+ <span class='ivar'>@idx</span> <span class='op'>&gt;=</span> <span class='ivar'>@list</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span>
1724
+ <span class='kw'>end</span>
1725
+
1726
+
1727
+ <span class='comment'># Test whether str is an option.
1728
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_isOpt'>isOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>=</span> <span class='id identifier rubyid_get'>get</span> <span class='rparen'>)</span>
1729
+ <span class='id identifier rubyid_str'>str</span><span class='lbracket'>[</span><span class='int'>0</span><span class='op'>..</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>-</span><span class='tstring_end'>&quot;</span></span>
1730
+ <span class='kw'>end</span>
1731
+
1732
+ <span class='comment'># Test whether str is an option list terminator.
1733
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_isOptTerm'>isOptTerm</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>=</span> <span class='id identifier rubyid_get'>get</span> <span class='rparen'>)</span>
1734
+ <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>--</span><span class='tstring_end'>&quot;</span></span>
1735
+ <span class='kw'>end</span>
1736
+
1737
+ <span class='comment'># Format value string if escaped.
1738
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_toValue'>toValue</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>=</span> <span class='id identifier rubyid_get'>get</span> <span class='rparen'>)</span>
1739
+ <span class='kw'>if</span> <span class='id identifier rubyid_str'>str</span><span class='lbracket'>[</span><span class='int'>0</span><span class='op'>..</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\\</span><span class='tstring_end'>&quot;</span></span>
1740
+ <span class='id identifier rubyid_str'>str</span><span class='lbracket'>[</span><span class='int'>1</span><span class='op'>..</span><span class='op'>-</span><span class='int'>1</span><span class='rbracket'>]</span>
1741
+ <span class='kw'>else</span>
1742
+ <span class='id identifier rubyid_str'>str</span>
1743
+ <span class='kw'>end</span>
1744
+ <span class='kw'>end</span>
1745
+
1746
+ <span class='kw'>end</span>
1747
+
1748
+
1749
+
1750
+ <span class='comment'># Set of methods which represent option combination checking.
1751
+ </span> <span class='comment'># In effect this is a meta language (DSL) for option
1752
+ </span> <span class='comment'># combinations.
1753
+ </span> <span class='comment'>#
1754
+ </span> <span class='comment'># Example:
1755
+ </span> <span class='comment'># RuleCheck.check( opt ) do
1756
+ </span> <span class='comment'># one(
1757
+ </span> <span class='comment'># incr( &quot;gcov&quot;, &quot;exclude&quot;, &quot;refreshed&quot; ),
1758
+ </span> <span class='comment'># &quot;manifest&quot;,
1759
+ </span> <span class='comment'># &quot;pairs&quot;,
1760
+ </span> <span class='comment'># &quot;files&quot;
1761
+ </span> <span class='comment'># )
1762
+ </span> <span class='comment'># end
1763
+ </span> <span class='kw'>class</span> <span class='const'>RuleCheck</span>
1764
+
1765
+ <span class='kw'>def</span> <span class='const'>RuleCheck</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
1766
+ <span class='id identifier rubyid_rc'>rc</span> <span class='op'>=</span> <span class='const'>RuleCheck</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span> <span class='rparen'>)</span>
1767
+ <span class='id identifier rubyid_rc'>rc</span><span class='period'>.</span><span class='id identifier rubyid_instance_eval'>instance_eval</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
1768
+ <span class='kw'>end</span>
1769
+
1770
+ <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
1771
+ <span class='ivar'>@opt</span> <span class='op'>=</span> <span class='id identifier rubyid_opt'>opt</span>
1772
+ <span class='kw'>end</span>
1773
+
1774
+
1775
+ <span class='comment'># Get given count.
1776
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_getScore'>getScore</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1777
+ <span class='id identifier rubyid_score'>score</span> <span class='op'>=</span> <span class='int'>0</span>
1778
+ <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span>
1779
+ <span class='kw'>if</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>TrueClass</span> <span class='op'>||</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>FalseClass</span>
1780
+ <span class='id identifier rubyid_score'>score</span> <span class='op'>+=</span> <span class='int'>1</span> <span class='kw'>if</span> <span class='id identifier rubyid_i'>i</span>
1781
+ <span class='kw'>else</span>
1782
+ <span class='id identifier rubyid_score'>score</span> <span class='op'>+=</span> <span class='int'>1</span> <span class='kw'>if</span> <span class='ivar'>@opt</span><span class='period'>.</span><span class='id identifier rubyid_argById'>argById</span><span class='lparen'>(</span><span class='id identifier rubyid_i'>i</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
1783
+ <span class='kw'>end</span>
1784
+ <span class='kw'>end</span>
1785
+ <span class='id identifier rubyid_score'>score</span>
1786
+ <span class='kw'>end</span>
1787
+
1788
+ <span class='comment'># Special condition when no options are given.
1789
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_none'>none</span>
1790
+ <span class='ivar'>@opt</span><span class='period'>.</span><span class='id identifier rubyid_givenCount'>givenCount</span> <span class='op'>==</span> <span class='int'>0</span>
1791
+ <span class='kw'>end</span>
1792
+
1793
+ <span class='comment'># Incremental options in order i.e. have to have previous
1794
+ </span> <span class='comment'># to have later.
1795
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_incr'>incr</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1796
+ <span class='id identifier rubyid_had'>had</span> <span class='op'>=</span> <span class='int'>0</span>
1797
+ <span class='id identifier rubyid_add'>add</span> <span class='op'>=</span> <span class='kw'>true</span>
1798
+ <span class='id identifier rubyid_scoreAll'>scoreAll</span> <span class='op'>=</span> <span class='int'>0</span>
1799
+ <span class='id identifier rubyid_i'>i</span> <span class='op'>=</span> <span class='int'>0</span>
1800
+ <span class='kw'>while</span> <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='id identifier rubyid_i'>i</span><span class='rbracket'>]</span>
1801
+ <span class='id identifier rubyid_score'>score</span> <span class='op'>=</span> <span class='id identifier rubyid_getScore'>getScore</span><span class='lparen'>(</span> <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='id identifier rubyid_i'>i</span><span class='rbracket'>]</span> <span class='rparen'>)</span>
1802
+ <span class='id identifier rubyid_had'>had</span> <span class='op'>+=</span> <span class='int'>1</span> <span class='kw'>if</span> <span class='lparen'>(</span> <span class='id identifier rubyid_score'>score</span> <span class='op'>==</span> <span class='int'>1</span> <span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_add'>add</span>
1803
+ <span class='id identifier rubyid_add'>add</span> <span class='op'>=</span> <span class='kw'>false</span> <span class='kw'>if</span> <span class='lparen'>(</span> <span class='id identifier rubyid_score'>score</span> <span class='op'>==</span> <span class='int'>0</span> <span class='rparen'>)</span>
1804
+ <span class='id identifier rubyid_scoreAll'>scoreAll</span> <span class='op'>+=</span> <span class='id identifier rubyid_score'>score</span>
1805
+ <span class='id identifier rubyid_i'>i</span> <span class='op'>+=</span> <span class='int'>1</span>
1806
+ <span class='kw'>end</span>
1807
+
1808
+ <span class='lparen'>(</span> <span class='id identifier rubyid_had'>had</span> <span class='op'>==</span> <span class='id identifier rubyid_scoreAll'>scoreAll</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_had'>had</span> <span class='op'>&gt;</span> <span class='int'>0</span> <span class='rparen'>)</span>
1809
+ <span class='kw'>end</span>
1810
+
1811
+ <span class='comment'># Incremental options in order i.e. have to have all later
1812
+ </span> <span class='comment'># if had first.
1813
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_follow'>follow</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1814
+ <span class='kw'>if</span> <span class='id identifier rubyid_getScore'>getScore</span><span class='lparen'>(</span> <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span> <span class='rparen'>)</span>
1815
+ <span class='id identifier rubyid_getScore'>getScore</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span> <span class='op'>==</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span>
1816
+ <span class='kw'>else</span>
1817
+ <span class='kw'>true</span>
1818
+ <span class='kw'>end</span>
1819
+ <span class='kw'>end</span>
1820
+
1821
+ <span class='comment'># One of list given.
1822
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_one'>one</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1823
+ <span class='id identifier rubyid_getScore'>getScore</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span> <span class='op'>==</span> <span class='int'>1</span>
1824
+ <span class='kw'>end</span>
1825
+
1826
+ <span class='comment'># At least one is given.
1827
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_any'>any</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1828
+ <span class='id identifier rubyid_getScore'>getScore</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span> <span class='op'>&gt;</span> <span class='int'>0</span>
1829
+ <span class='kw'>end</span>
1830
+
1831
+ <span class='comment'># All are given.
1832
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_all'>all</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1833
+ <span class='id identifier rubyid_getScore'>getScore</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span> <span class='op'>==</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span>
1834
+ <span class='kw'>end</span>
1835
+
1836
+ <span class='comment'># Logical inversion.
1837
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_inv'>inv</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1838
+ <span class='id identifier rubyid_getScore'>getScore</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span> <span class='op'>==</span> <span class='int'>0</span>
1839
+ <span class='kw'>end</span>
1840
+ <span class='kw'>end</span>
1841
+
1842
+
1843
+
1844
+ <span class='comment'># Display utility for RuleCheck. Usage model.
1845
+ </span> <span class='comment'>#
1846
+ </span> <span class='comment'># RuleDisplay.new.evalAndDisplay( &amp;rule )
1847
+ </span> <span class='comment'>#
1848
+ </span> <span class='comment'># Example expansion of options:
1849
+ </span> <span class='comment'>#
1850
+ </span> <span class='comment'># |--# One of:
1851
+ </span> <span class='comment'># | |--# Adding in order:
1852
+ </span> <span class='comment'># | | |--&lt;gcov&gt;
1853
+ </span> <span class='comment'># | | |--&lt;exclude&gt;
1854
+ </span> <span class='comment'># | | |--&lt;refreshed&gt;
1855
+ </span> <span class='comment'># | |--&lt;manifest&gt;
1856
+ </span> <span class='comment'># | |--&lt;pairs&gt;
1857
+ </span> <span class='comment'># | |--&lt;files&gt;
1858
+ </span> <span class='comment'>#
1859
+ </span> <span class='kw'>class</span> <span class='const'>RuleDisplay</span> <span class='op'>&lt;</span> <span class='const'>ComoCommon</span>
1860
+
1861
+ <span class='comment'># Eval rules to get an nested array and then display it.
1862
+ </span> <span class='kw'>def</span> <span class='const'>RuleDisplay</span><span class='period'>.</span><span class='id identifier rubyid_print'>print</span><span class='lparen'>(</span> <span class='id identifier rubyid_prefixStr'>prefixStr</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> </span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
1863
+ <span class='id identifier rubyid_rd'>rd</span> <span class='op'>=</span> <span class='const'>RuleDisplay</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='id identifier rubyid_prefixStr'>prefixStr</span> <span class='rparen'>)</span>
1864
+ <span class='id identifier rubyid_rd'>rd</span><span class='period'>.</span><span class='id identifier rubyid_evalAndDisplay'>evalAndDisplay</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
1865
+ <span class='kw'>end</span>
1866
+
1867
+ <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span> <span class='id identifier rubyid_prefixStr'>prefixStr</span> <span class='rparen'>)</span>
1868
+ <span class='comment'># Prefix string for lines. Rules add/rm from it.
1869
+ </span> <span class='ivar'>@prefixStr</span> <span class='op'>=</span> <span class='id identifier rubyid_prefixStr'>prefixStr</span>
1870
+ <span class='kw'>end</span>
1871
+
1872
+ <span class='kw'>def</span> <span class='id identifier rubyid_evalAndDisplay'>evalAndDisplay</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
1873
+ <span class='id identifier rubyid_printRule'>printRule</span><span class='lparen'>(</span> <span class='id identifier rubyid_instance_eval'>instance_eval</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span> <span class='rparen'>)</span>
1874
+ <span class='kw'>end</span>
1875
+
1876
+ <span class='comment'># Increase prefix string.
1877
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_addPrefix'>addPrefix</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1878
+ <span class='ivar'>@prefixStr</span> <span class='op'>+=</span> <span class='id identifier rubyid_str'>str</span>
1879
+ <span class='kw'>end</span>
1880
+
1881
+ <span class='comment'># Remove from prefix (either str or length ).
1882
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_rmPrefix'>rmPrefix</span><span class='lparen'>(</span> <span class='id identifier rubyid_item'>item</span> <span class='rparen'>)</span>
1883
+ <span class='kw'>if</span> <span class='id identifier rubyid_item'>item</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>String</span>
1884
+ <span class='id identifier rubyid_cnt'>cnt</span> <span class='op'>=</span> <span class='id identifier rubyid_item'>item</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span>
1885
+ <span class='kw'>else</span>
1886
+ <span class='id identifier rubyid_cnt'>cnt</span> <span class='op'>=</span> <span class='id identifier rubyid_item'>item</span>
1887
+ <span class='kw'>end</span>
1888
+ <span class='ivar'>@prefixStr</span> <span class='op'>=</span> <span class='ivar'>@prefixStr</span><span class='lbracket'>[</span><span class='int'>0</span><span class='op'>..</span><span class='op'>-</span><span class='lparen'>(</span><span class='id identifier rubyid_cnt'>cnt</span><span class='op'>+</span><span class='int'>1</span><span class='rparen'>)</span><span class='rbracket'>]</span>
1889
+ <span class='kw'>end</span>
1890
+
1891
+ <span class='comment'># Print prefix + str.
1892
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_p'>p</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1893
+ <span class='cvar'>@@io</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span><span class='lparen'>(</span> <span class='ivar'>@prefixStr</span> <span class='op'>+</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
1894
+ <span class='kw'>end</span>
1895
+
1896
+ <span class='comment'># Recursively go through the nested array of rule items and
1897
+ </span> <span class='comment'># print out rules.
1898
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_printRule'>printRule</span><span class='lparen'>(</span> <span class='id identifier rubyid_arr'>arr</span> <span class='rparen'>)</span>
1899
+ <span class='id identifier rubyid_p'>p</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>|--# </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_arr'>arr</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='rbrace'>}</span><span class='tstring_content'>:</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
1900
+ <span class='id identifier rubyid_item'>item</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>| </span><span class='tstring_end'>&quot;</span></span>
1901
+ <span class='id identifier rubyid_addPrefix'>addPrefix</span><span class='lparen'>(</span> <span class='id identifier rubyid_item'>item</span> <span class='rparen'>)</span>
1902
+
1903
+ <span class='id identifier rubyid_arr'>arr</span><span class='lbracket'>[</span><span class='int'>1</span><span class='op'>..</span><span class='op'>-</span><span class='int'>1</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span>
1904
+ <span class='kw'>if</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='op'>==</span> <span class='const'>Array</span>
1905
+ <span class='id identifier rubyid_printRule'>printRule</span><span class='lparen'>(</span> <span class='id identifier rubyid_i'>i</span> <span class='rparen'>)</span>
1906
+ <span class='kw'>else</span>
1907
+ <span class='id identifier rubyid_p'>p</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>|--&lt;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_i'>i</span><span class='rbrace'>}</span><span class='tstring_content'>&gt;</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
1908
+ <span class='kw'>end</span>
1909
+ <span class='kw'>end</span>
1910
+ <span class='id identifier rubyid_rmPrefix'>rmPrefix</span><span class='lparen'>(</span> <span class='id identifier rubyid_item'>item</span> <span class='rparen'>)</span>
1911
+ <span class='kw'>end</span>
1912
+
1913
+ <span class='comment'># Special condition where no arguments are given.
1914
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_none'>none</span>
1915
+ <span class='lbracket'>[</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>NONE</span><span class='tstring_end'>&quot;</span></span> <span class='rbracket'>]</span>
1916
+ <span class='kw'>end</span>
1917
+
1918
+ <span class='comment'># Incremental options in order i.e. have to have previous
1919
+ </span> <span class='comment'># to have later.
1920
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_incr'>incr</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1921
+ <span class='lbracket'>[</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Adding in order</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rbracket'>]</span>
1922
+ <span class='kw'>end</span>
1923
+
1924
+ <span class='comment'># Incremental options in order i.e. have to have all later
1925
+ </span> <span class='comment'># if had first.
1926
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_follow'>follow</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1927
+ <span class='lbracket'>[</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>If first then rest</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rbracket'>]</span>
1928
+ <span class='kw'>end</span>
1929
+
1930
+ <span class='comment'># One of list given.
1931
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_one'>one</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1932
+ <span class='lbracket'>[</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>One of</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rbracket'>]</span>
1933
+ <span class='kw'>end</span>
1934
+
1935
+ <span class='comment'># At least one is given.
1936
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_any'>any</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1937
+ <span class='lbracket'>[</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>One or more of</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rbracket'>]</span>
1938
+ <span class='kw'>end</span>
1939
+
1940
+ <span class='comment'># All are given.
1941
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_all'>all</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1942
+ <span class='lbracket'>[</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>All of</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rbracket'>]</span>
1943
+ <span class='kw'>end</span>
1944
+
1945
+ <span class='comment'># Logical inversion.
1946
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_inv'>inv</span><span class='lparen'>(</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
1947
+ <span class='lbracket'>[</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Not</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span> <span class='rbracket'>]</span>
1948
+ <span class='kw'>end</span>
1949
+
1950
+ <span class='kw'>end</span>
1951
+
1952
+
1953
+ <span class='kw'>end</span></pre></div></div>
1954
+
1955
+ <div id="footer">
1956
+ Generated on Wed Nov 27 11:34:25 2013 by
1957
+ <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
1958
+ 0.8.6.1 (ruby-1.9.3).
1959
+ </div>
1960
+
1961
+ </body>
1962
+ </html>