rango 0.0.3 → 0.0.4

data/doc/head/Kernel.html

@@ -16,7 +16,7 @@
   <h1 class="title">Module: Kernel</h1>
   <div class="section docstring">
   <p>
-coding: utf-8
+encoding: utf-8
 </p>
 
 </div><div class="section constants">
@@ -32,6 +32,8 @@ coding: utf-8
         <span class='name'><a href="#command-instance_method" title="#command">#command</a></span><span class='args'>(command)</span>
         <span class='block'></span>
         
+          <span class='alias'>#sh</span>
+        
       </th>
       <td class="docstring">
         
@@ -51,6 +53,21 @@ coding: utf-8
       </td>
     </tr>
   
+    <tr>
+      <th class="signature">
+        <span class='name'><a href="#os-instance_method" title="#os">#os</a></span><span class='args'></span>
+        <span class='block'></span>
+        
+      </th>
+      <td class="docstring">
+        <p>
+os.
+</p>
+
+        
+      </td>
+    </tr>
+  
     <tr>
       <th class="signature">
         <span class='name'><a href="#p_and_return-instance_method" title="#p_and_return">#p_and_return</a></span><span class='args'>(*args)</span>
@@ -71,8 +88,7 @@ coding: utf-8
       </th>
       <td class="docstring">
         <p>
-TODO: try_require and try_require_gem (diff require &#8216;readline&#8217;
-vs require &#8216;term/ansicolor&#8217;) for quick inspection.
+for quick inspection.
 </p>
 
         
@@ -105,7 +121,31 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection.
   
     <tr>
       <th class="signature">
-        <span class='name'><a href="#try_require-instance_method" title="#try_require">#try_require</a></span><span class='args'>(library, gemname = library)</span>
+        <span class='name'><a href="#require_gem_or_exit-instance_method" title="#require_gem_or_exit">#require_gem_or_exit</a></span><span class='args'>(library, gemname = library, options = Hash.new)</span>
+        <span class='block'></span>
+        
+      </th>
+      <td class="docstring">
+        
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        <span class='name'><a href="#try_require-instance_method" title="#try_require">#try_require</a></span><span class='args'>(library)</span>
+        <span class='block'></span>
+        
+      </th>
+      <td class="docstring">
+        
+        
+      </td>
+    </tr>
+  
+    <tr>
+      <th class="signature">
+        <span class='name'><a href="#try_require_gem-instance_method" title="#try_require_gem">#try_require_gem</a></span><span class='args'>(library, gemname = library, options = Hash.new)</span>
         <span class='block'></span>
         
       </th>
@@ -122,6 +162,18 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection.
       </td>
     </tr>
   
+    <tr>
+      <th class="signature">
+        <span class='name'><a href="#try_require_gem%21-instance_method" title="#try_require_gem!">#try_require_gem!</a></span><span class='args'>(library, gemname = library, options = Hash.new)</span>
+        <span class='block'></span>
+        
+      </th>
+      <td class="docstring">
+        
+        
+      </td>
+    </tr>
+  
 </table>
   </div>
 <div class="section methoddetails instance public">
@@ -140,7 +192,12 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection.
     <span class='block'></span>
   </tt>
 </div>
-
+<p class="aliases">
+  <span class="aka">Also known as:</span>
+  
+    <tt id="sh-instance_method">sh</tt>
+  
+</p>
 </div><div class="section source">
   <span>[<a class="source_link" href="#">View source</a>]</span>
   <div class="source_code">
@@ -150,13 +207,13 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection.
           <pre class="lines">
 
 
-32
-33
-34
-35</pre>
+56
+57
+58
+59</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 32</span>
+          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 56</span>
 
 <span class='def def kw'>def</span> <span class='command identifier id'>command</span><span class='lparen token'>(</span><span class='command identifier id'>command</span><span class='rparen token'>)</span>
   <span class='puts identifier id'>puts</span> <span class='command identifier id'>command</span>
@@ -243,6 +300,53 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection.
 </div>
     </div>
   
+    <div class="method">
+      <div class="method_header">
+  <h3>os</h3>
+</div><div id="os-instance_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'></span>
+    <span class='name'>os</span><span class='args'></span>
+    <span class='block'></span>
+  </tt>
+</div>
+
+</div><div class="section docstring">
+  <p>
+os.home
+</p>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+12
+13
+14</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 12</span>
+
+<span class='def def kw'>def</span> <span class='os identifier id'>os</span>
+  <span class='@os ivar id'>@os</span> <span class='opasgn op'>||=</span> <span class='OS constant id'>OS</span><span class='dot token'>.</span><span class='parse identifier id'>parse</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
     <div class="method">
       <div class="method_header">
   <h3>p_and_return</h3>
@@ -292,13 +396,13 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection.
           <pre class="lines">
 
 
-64
-65
-66
-67</pre>
+86
+87
+88
+89</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 64</span>
+          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 86</span>
 
 <span class='def def kw'>def</span> <span class='p_and_return identifier id'>p_and_return</span><span class='lparen token'>(</span><span class='mult op'>*</span><span class='args identifier id'>args</span><span class='rparen token'>)</span>
   <span class='p identifier id'>p</span><span class='lparen token'>(</span><span class='mult op'>*</span><span class='args identifier id'>args</span><span class='rparen token'>)</span>
@@ -329,8 +433,7 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection.
 
 </div><div class="section docstring">
   <p>
-TODO: try_require and try_require_gem (diff require &#8216;readline&#8217;
-vs require &#8216;term/ansicolor&#8217;) for quick inspection
+for quick inspection
 </p>
 
 </div><div class="section tags">
@@ -368,13 +471,13 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection
           <pre class="lines">
 
 
-58
-59
-60
-61</pre>
+80
+81
+82
+83</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 58</span>
+          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 80</span>
 
 <span class='def def kw'>def</span> <span class='puts_and_return identifier id'>puts_and_return</span><span class='lparen token'>(</span><span class='mult op'>*</span><span class='args identifier id'>args</span><span class='rparen token'>)</span>
   <span class='puts identifier id'>puts</span><span class='lparen token'>(</span><span class='mult op'>*</span><span class='args identifier id'>args</span><span class='rparen token'>)</span>
@@ -412,16 +515,16 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection
           <pre class="lines">
 
 
-37
-38
-39
-40
-41
-42
-43</pre>
+62
+63
+64
+65
+66
+67
+68</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 37</span>
+          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 62</span>
 
 <span class='def def kw'>def</span> <span class='quiet identifier id'>quiet</span><span class='lparen token'>(</span><span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
   <span class='old_stdout identifier id'>old_stdout</span> <span class='assign token'>=</span> <span class='STDOUT constant id'>STDOUT</span><span class='dot token'>.</span><span class='dup identifier id'>dup</span>
@@ -462,16 +565,16 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection
           <pre class="lines">
 
 
-45
-46
-47
-48
-49
-50
-51</pre>
+70
+71
+72
+73
+74
+75
+76</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 45</span>
+          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 70</span>
 
 <span class='def def kw'>def</span> <span class='quiet! fid id'>quiet!</span><span class='lparen token'>(</span><span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
   <span class='old_stderr identifier id'>old_stderr</span> <span class='assign token'>=</span> <span class='STDERR constant id'>STDERR</span><span class='dot token'>.</span><span class='dup identifier id'>dup</span>
@@ -489,16 +592,162 @@ vs require &#8216;term/ansicolor&#8217;) for quick inspection
 </div>
     </div>
   
+    <div class="method">
+      <div class="method_header">
+  <h3>require_gem_or_exit</h3>
+</div><div id="require_gem_or_exit-instance_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'></span>
+    <span class='name'>require_gem_or_exit</span><span class='args'>(library, gemname = library, options = Hash.new)</span>
+    <span class='block'></span>
+  </tt>
+</div>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="param">
+  <h3>Parameters:</h3>
+  <dl>
+  
+  </dl>
+</div><div class="since">
+  <h3>Since:</h3>
+  <dl>
+  
+    <dt>
+      
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'><p>
+0.0.3
+</p>
+</span>
+    </dd>
+  
+  </dl>
+</div>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+42
+43
+44
+45
+46
+47</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 42</span>
+
+<span class='def def kw'>def</span> <span class='require_gem_or_exit identifier id'>require_gem_or_exit</span><span class='lparen token'>(</span><span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='gemname identifier id'>gemname</span> <span class='assign token'>=</span> <span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='Hash constant id'>Hash</span><span class='dot token'>.</span><span class='new identifier id'>new</span><span class='rparen token'>)</span>
+  <span class='gemname identifier id'>gemname</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='gemname identifier id'>gemname</span> <span class='if if_mod kw'>if</span> <span class='gemname identifier id'>gemname</span><span class='dot token'>.</span><span class='is_a? fid id'>is_a?</span><span class='lparen token'>(</span><span class='Hash constant id'>Hash</span><span class='rparen token'>)</span> <span class='andop op'>&amp;&amp;</span> <span class='options identifier id'>options</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span>
+  <span class='try_require_gem! fid id'>try_require_gem!</span><span class='lparen token'>(</span><span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='gemname identifier id'>gemname</span><span class='comma token'>,</span> <span class='options identifier id'>options</span><span class='rparen token'>)</span>
+<span class='rescue rescue kw'>rescue</span> <span class='LoadError constant id'>LoadError</span>
+  <span class='exit identifier id'>exit</span> <span class='integer val'>1</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
     <div class="method">
       <div class="method_header">
   <h3>try_require</h3>
 </div><div id="try_require-instance_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'></span>
+    <span class='name'>try_require</span><span class='args'>(library)</span>
+    <span class='block'></span>
+  </tt>
+</div>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="param">
+  <h3>Parameters:</h3>
+  <dl>
+  
+  </dl>
+</div><div class="since">
+  <h3>Since:</h3>
+  <dl>
+  
+    <dt>
+      
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'><p>
+0.0.3
+</p>
+</span>
+    </dd>
+  
+  </dl>
+</div>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+50
+51
+52
+53
+54</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 50</span>
+
+<span class='def def kw'>def</span> <span class='try_require identifier id'>try_require</span><span class='lparen token'>(</span><span class='library identifier id'>library</span><span class='rparen token'>)</span>
+  <span class='require identifier id'>require</span> <span class='string val'>&quot;library&quot;</span>
+<span class='rescue rescue kw'>rescue</span> <span class='LoadError constant id'>LoadError</span>
+  <span class='return return kw'>return</span> <span class='false false kw'>false</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>try_require_gem</h3>
+</div><div id="try_require_gem-instance_method" class="section method">
   <div class="details_title">
   <div class='section methodsignature'>
   <tt class='def'>
     <span class='visibility'>public</span>
     <span class='return_types'><tt>Boolean</tt></span>
-    <span class='name'>try_require</span><span class='args'>(library, gemname = library)</span>
+    <span class='name'>try_require_gem</span><span class='args'>(library, gemname = library, options = Hash.new)</span>
     <span class='block'></span>
   </tt>
 </div>
@@ -591,37 +840,103 @@ True if require was successful, false otherwise.
           <pre class="lines">
 
 
-17
-18
-19
-20
-21
 22
 23
 24
 25
 26
-27
-28
-29
-30</pre>
+27</pre>
         </td>
         <td>
-          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 17</span>
-
-<span class='def def kw'>def</span> <span class='try_require identifier id'>try_require</span><span class='lparen token'>(</span><span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='gemname identifier id'>gemname</span> <span class='assign token'>=</span> <span class='library identifier id'>library</span><span class='rparen token'>)</span>
-  <span class='begin begin kw'>begin</span>
-    <span class='require identifier id'>require</span> <span class='library identifier id'>library</span>
-  <span class='rescue rescue kw'>rescue</span> <span class='LoadError constant id'>LoadError</span>
-    <span class='message identifier id'>message</span> <span class='assign token'>=</span> <span class='dstring node'>&quot;Gem #{gemname} isn't installed. Run sudo gem install #{gemname}.&quot;</span>
-    <span class='if if kw'>if</span> <span class='defined? defined kw'>defined?</span><span class='lparen token'>(</span><span class='Rango constant id'>Rango</span><span class='dot token'>.</span><span class='logger identifier id'>logger</span><span class='rparen token'>)</span>
-      <span class='Rango constant id'>Rango</span><span class='dot token'>.</span><span class='logger identifier id'>logger</span><span class='dot token'>.</span><span class='warn identifier id'>warn</span><span class='lparen token'>(</span><span class='message identifier id'>message</span><span class='rparen token'>)</span>
-      <span class='return return kw'>return</span> <span class='false false kw'>false</span>
-    <span class='else else kw'>else</span>
-      <span class='puts identifier id'>puts</span><span class='lparen token'>(</span><span class='message identifier id'>message</span><span class='rparen token'>)</span>
-      <span class='return return kw'>return</span> <span class='false false kw'>false</span>
-    <span class='end end kw'>end</span>
-  <span class='end end kw'>end</span>
+          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 22</span>
+
+<span class='def def kw'>def</span> <span class='try_require_gem identifier id'>try_require_gem</span><span class='lparen token'>(</span><span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='gemname identifier id'>gemname</span> <span class='assign token'>=</span> <span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='Hash constant id'>Hash</span><span class='dot token'>.</span><span class='new identifier id'>new</span><span class='rparen token'>)</span>
+  <span class='gemname identifier id'>gemname</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='gemname identifier id'>gemname</span> <span class='if if_mod kw'>if</span> <span class='gemname identifier id'>gemname</span><span class='dot token'>.</span><span class='is_a? fid id'>is_a?</span><span class='lparen token'>(</span><span class='Hash constant id'>Hash</span><span class='rparen token'>)</span> <span class='andop op'>&amp;&amp;</span> <span class='options identifier id'>options</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span>
+  <span class='try_require_gem! fid id'>try_require_gem!</span><span class='lparen token'>(</span><span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='gemname identifier id'>gemname</span><span class='comma token'>,</span> <span class='options identifier id'>options</span><span class='rparen token'>)</span>
+<span class='rescue rescue kw'>rescue</span> <span class='LoadError constant id'>LoadError</span>
+  <span class='return return kw'>return</span> <span class='false false kw'>false</span>
+<span class='end end kw'>end</span>
+</pre>
+        </td>
+      </tr>
+    </table>
+  </div>
+</div>
+</div>
+    </div>
+  
+    <div class="method">
+      <div class="method_header">
+  <h3>try_require_gem!</h3>
+</div><div id="try_require_gem%21-instance_method" class="section method">
+  <div class="details_title">
+  <div class='section methodsignature'>
+  <tt class='def'>
+    <span class='visibility'>public</span>
+    <span class='return_types'></span>
+    <span class='name'>try_require_gem!</span><span class='args'>(library, gemname = library, options = Hash.new)</span>
+    <span class='block'></span>
+  </tt>
+</div>
+
+</div><div class="section tags">
+  <h2>Meta Tags</h2>
+  <div class="param">
+  <h3>Parameters:</h3>
+  <dl>
+  
+  </dl>
+</div><div class="since">
+  <h3>Since:</h3>
+  <dl>
+  
+    <dt>
+      
+      
+      
+    </dt>
+    <dd>
+      <span class='desc'><p>
+0.0.3
+</p>
+</span>
+    </dd>
+  
+  </dl>
+</div>
+
+</div><div class="section source">
+  <span>[<a class="source_link" href="#">View source</a>]</span>
+  <div class="source_code">
+    <table>
+      <tr>
+        <td>
+          <pre class="lines">
+
+
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39</pre>
+        </td>
+        <td>
+          <pre class="code"><span class="info file"># File 'lib/rango/ext/kernel.rb', line 30</span>
+
+<span class='def def kw'>def</span> <span class='try_require_gem! fid id'>try_require_gem!</span><span class='lparen token'>(</span><span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='gemname identifier id'>gemname</span> <span class='assign token'>=</span> <span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='Hash constant id'>Hash</span><span class='dot token'>.</span><span class='new identifier id'>new</span><span class='rparen token'>)</span>
+  <span class='gemname identifier id'>gemname</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='library identifier id'>library</span><span class='comma token'>,</span> <span class='gemname identifier id'>gemname</span> <span class='if if_mod kw'>if</span> <span class='gemname identifier id'>gemname</span><span class='dot token'>.</span><span class='is_a? fid id'>is_a?</span><span class='lparen token'>(</span><span class='Hash constant id'>Hash</span><span class='rparen token'>)</span> <span class='andop op'>&amp;&amp;</span> <span class='options identifier id'>options</span><span class='dot token'>.</span><span class='empty? fid id'>empty?</span>
+  <span class='require identifier id'>require</span> <span class='library identifier id'>library</span>
+<span class='rescue rescue kw'>rescue</span> <span class='LoadError constant id'>LoadError</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='exception identifier id'>exception</span>
+  <span class='message identifier id'>message</span>  <span class='assign token'>=</span> <span class='dstring node'>&quot;Gem #{gemname} isn't installed. Run sudo gem install #{gemname}. (#{exception.inspect})&quot;</span>
+  <span class='logger identifier id'>logger</span>   <span class='assign token'>=</span> <span class='Rango constant id'>Rango</span><span class='dot token'>.</span><span class='logger identifier id'>logger</span><span class='dot token'>.</span><span class='method identifier id'>method</span><span class='lparen token'>(</span><span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:level</span><span class='rbrack token'>]</span> <span class='orop op'>||</span> <span class='symbol val'>:error</span><span class='rparen token'>)</span>
+  <span class='callable identifier id'>callable</span> <span class='assign token'>=</span> <span class='defined? defined kw'>defined?</span><span class='lparen token'>(</span><span class='Rango constant id'>Rango</span><span class='dot token'>.</span><span class='logger identifier id'>logger</span><span class='rparen token'>)</span> <span class='question op'>?</span> <span class='logger identifier id'>logger</span> <span class='colon op'>:</span> <span class='method identifier id'>method</span><span class='lparen token'>(</span><span class='symbol val'>:puts</span><span class='rparen token'>)</span>
+  <span class='callable identifier id'>callable</span><span class='dot token'>.</span><span class='call identifier id'>call</span><span class='lparen token'>(</span><span class='message identifier id'>message</span><span class='rparen token'>)</span>
+  <span class='raise identifier id'>raise</span> <span class='exception identifier id'>exception</span>
 <span class='end end kw'>end</span>
 </pre>
         </td>