como 0.1.3 → 0.1.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6abe56829893db16ba0a4e8edc68ac151d0581df
+  data.tar.gz: 5f77bff2462357c36f9f4e50c19b595164469c76
+SHA512:
+  metadata.gz: 7dbe4187f2d360b07e4be7efbddf97acc88b8f0899f7852224e2e2e567e196afb6df74609ae228b6e561090241b08b5c3a135440f4c139488648a37135e02101
+  data.tar.gz: 44ac5dbe7ccfff7270ee98eef31774f03eeb7b5b4acd917f84df65fe48eb6b82acd3b64c8ed892d1acf0dd473d0c68ff1be1ec418d5876bf30da80ed3f360606

data/CHANGELOG.rdoc

@@ -1,5 +1,12 @@
 = Version history
 
+[0.1.4] Documentation improvements (links to methods).
+        Fix to Opt#apply return value when type is :switch.
+        Opt#fatal added for user error reporting towards command line user.
+        Non-existing options for option with multiple values defaults
+          to an empty array.
+        Possibility to separate option definition and execution.
+
 [0.1.3] Customization through COMO env variable and hooks.
         Version information returned programmatically with Como.version.
         "command" is aliased to "subcmd" to enable highlighting of the

data/doc/Como/ArgsParseState.html

@@ -193,7 +193,7 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>A new instance of ArgsParseState.</p>
+<p>Create parse state.</p>
 </div></span>
   
 </li>
@@ -409,7 +409,7 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>A new instance of ArgsParseState</p>
+<p>Create parse state.</p>
 
 
   </div>
@@ -443,13 +443,13 @@
       <pre class="lines">
 
 
-1897
-1898
-1899
-1900</pre>
+2004
+2005
+2006
+2007</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1897</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2004</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>
     <span class='id identifier rubyid_set'>set</span><span class='lparen'>(</span> <span class='id identifier rubyid_list'>list</span> <span class='rparen'>)</span>
@@ -506,12 +506,12 @@
       <pre class="lines">
 
 
-1933
-1934
-1935</pre>
+2040
+2041
+2042</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1933</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2040</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_done?'>done?</span>
     <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>
@@ -547,12 +547,12 @@
       <pre class="lines">
 
 
-1918
-1919
-1920</pre>
+2025
+2026
+2027</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1918</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2025</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>
     <span class='ivar'>@args</span><span class='lbracket'>[</span> <span class='id identifier rubyid_idx'>idx</span> <span class='rbracket'>]</span>
@@ -588,12 +588,12 @@
       <pre class="lines">
 
 
-1939
-1940
-1941</pre>
+2046
+2047
+2048</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1939</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2046</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>
     <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>
@@ -629,12 +629,12 @@
       <pre class="lines">
 
 
-1944
-1945
-1946</pre>
+2051
+2052
+2053</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1944</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2051</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>
     <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>
@@ -670,12 +670,12 @@
       <pre class="lines">
 
 
-1923
-1924
-1925</pre>
+2030
+2031
+2032</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1923</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2030</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>
     <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>
@@ -711,12 +711,12 @@
       <pre class="lines">
 
 
-1908
-1909
-1910</pre>
+2015
+2016
+2017</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1908</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2015</span>
 
 <span class='kw'>def</span> <span class='kw'>next</span>
     <span class='ivar'>@idx</span> <span class='op'>+=</span> <span class='int'>1</span>
@@ -752,12 +752,12 @@
       <pre class="lines">
 
 
-1913
-1914
-1915</pre>
+2020
+2021
+2022</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1913</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2020</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_prev'>prev</span>
     <span class='ivar'>@idx</span> <span class='op'>-=</span> <span class='int'>1</span>
@@ -793,12 +793,12 @@
       <pre class="lines">
 
 
-1928
-1929
-1930</pre>
+2035
+2036
+2037</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1928</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2035</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>
     <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>
@@ -834,12 +834,12 @@
       <pre class="lines">
 
 
-1903
-1904
-1905</pre>
+2010
+2011
+2012</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1903</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2010</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>
     <span class='ivar'>@args</span> <span class='op'>=</span> <span class='id identifier rubyid_list'>list</span>
@@ -875,16 +875,16 @@
       <pre class="lines">
 
 
-1949
-1950
-1951
-1952
-1953
-1954
-1955</pre>
+2056
+2057
+2058
+2059
+2060
+2061
+2062</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1949</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 2056</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>
     <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>
@@ -903,7 +903,7 @@
 </div>
 
     <div id="footer">
-  Generated on Wed Jul  9 14:02:43 2014 by
+  Generated on Sat Nov 22 10:05:16 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.6.1 (ruby-1.9.3).
 </div>

data/doc/Como/ComoCommon.html

@@ -94,9 +94,7 @@
   
   
     <dt class="r2 last">Defined in:</dt>
-    <dd class="r2 last">lib/como.rb<span class="defines">,<br />
-  lib/version.rb</span>
-</dd>
+    <dd class="r2 last">lib/como.rb</dd>
   
 </dl>
 <div class="clear"></div>
@@ -121,11 +119,6 @@
   
     <dl class="constants">
       
-        <dt id="VERSION-constant" class="">VERSION =
-          
-        </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>0.1.3</span><span class='tstring_end'>&quot;</span></span></pre></dd>
-      
         <dt id="io-classvariable" class="">@@io =
           <div class="docstring">
   <div class="discussion">
@@ -202,7 +195,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#runHook-class_method" title="runHook (class method)">+ (Object) <strong>runHook</strong>(name, args) </a>
+      <a href="#runHook-class_method" title="runHook (class method)">+ (Object) <strong>runHook</strong>(name, args) { ... }</a>
     
 
     
@@ -216,7 +209,9 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'>
+<p>Run hook.</p>
+</div></span>
   
 </li>
 
@@ -224,7 +219,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#setHook-class_method" title="setHook (class method)">+ (Object) <strong>setHook</strong>(name, &amp;code) </a>
+      <a href="#setHook-class_method" title="setHook (class method)">+ (Object) <strong>setHook</strong>(name) { ... }</a>
     
 
     
@@ -238,7 +233,9 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'>
+<p>Set hook content.</p>
+</div></span>
   
 </li>
 
@@ -302,12 +299,12 @@
       <pre class="lines">
 
 
-480
-481
-482</pre>
+490
+491
+492</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 480</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 490</span>
 
 <span class='kw'>def</span> <span class='const'>ComoCommon</span><span class='period'>.</span><span class='id identifier rubyid_getIo'>getIo</span>
     <span class='cvar'>@@io</span>
@@ -320,24 +317,73 @@
       <div class="method_details ">
   <h3 class="signature " id="runHook-class_method">
   
-    + (<tt>Object</tt>) <strong>runHook</strong>(name, args) 
+    + (<tt>Object</tt>) <strong>runHook</strong>(name, args) { ... }
+  
+
   
 
   
+</h3><div class="docstring">
+  <div class="discussion">
+    
+<p>Run hook.</p>
 
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>name</span>
+      
+      
+        <span class='type'>(<tt>String</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>Hook name.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+<p class="tag_title">Yields:</p>
+<ul class="yield">
+  
+    <li>
+      
+      
+        <span class='type'></span>
+      
+      
+      
+        
+        <div class='inline'>
+<p>code Hook arguments.</p>
+</div>
+      
+    </li>
   
-</h3><table class="source_code">
+</ul>
+
+</div><table class="source_code">
   <tr>
     <td>
       <pre class="lines">
 
 
-488
-489
-490</pre>
+506
+507
+508</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 488</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 506</span>
 
 <span class='kw'>def</span> <span class='const'>ComoCommon</span><span class='period'>.</span><span class='id identifier rubyid_runHook'>runHook</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span>
     <span class='cvar'>@@hook</span><span class='lbracket'>[</span> <span class='id identifier rubyid_name'>name</span> <span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_yield'>yield</span><span class='lparen'>(</span> <span class='id identifier rubyid_args'>args</span> <span class='rparen'>)</span> <span class='kw'>if</span> <span class='cvar'>@@hook</span><span class='lbracket'>[</span> <span class='id identifier rubyid_name'>name</span> <span class='rbracket'>]</span>
@@ -350,24 +396,73 @@
       <div class="method_details ">
   <h3 class="signature " id="setHook-class_method">
   
-    + (<tt>Object</tt>) <strong>setHook</strong>(name, &amp;code) 
+    + (<tt>Object</tt>) <strong>setHook</strong>(name) { ... }
   
 
   
 
   
-</h3><table class="source_code">
+</h3><div class="docstring">
+  <div class="discussion">
+    
+<p>Set hook content.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>name</span>
+      
+      
+        <span class='type'>(<tt>String</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>Hook name.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+<p class="tag_title">Yields:</p>
+<ul class="yield">
+  
+    <li>
+      
+      
+        <span class='type'></span>
+      
+      
+      
+        
+        <div class='inline'>
+<p>code Hook code.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
   <tr>
     <td>
       <pre class="lines">
 
 
-484
-485
-486</pre>
+498
+499
+500</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 484</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 498</span>
 
 <span class='kw'>def</span> <span class='const'>ComoCommon</span><span class='period'>.</span><span class='id identifier rubyid_setHook'>setHook</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_code'>code</span> <span class='rparen'>)</span>
     <span class='cvar'>@@hook</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_code'>code</span>
@@ -403,12 +498,12 @@
       <pre class="lines">
 
 
-475
-476
-477</pre>
+485
+486
+487</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 475</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 485</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>
     <span class='cvar'>@@io</span> <span class='op'>=</span> <span class='id identifier rubyid_io'>io</span>
@@ -423,7 +518,7 @@
 </div>
 
     <div id="footer">
-  Generated on Wed Jul  9 14:02:42 2014 by
+  Generated on Sat Nov 22 10:05:15 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.6.1 (ruby-1.9.3).
 </div>