RubyGems - cliutils - Versions diffs - 1.0.2 → 1.0.3 - Mend

cliutils 1.0.2 → 1.0.3

Files changed (46) hide show

checksums.yaml +4 -4
data/.gitignore +2 -0
data/.yardoc/checksums +11 -11
data/.yardoc/object_types +0 -0
data/.yardoc/objects/root.dat +0 -0
data/Gemfile.lock +12 -33
data/README.md +1 -1
data/Rakefile +36 -31
data/cliutils.gemspec +3 -2
data/lib/cliutils/configuration.rb +13 -31
data/lib/cliutils/configurator.rb +23 -62
data/lib/cliutils/ext/Hash+Extensions.rb +39 -78
data/lib/cliutils/ext/Logger+Extensions.rb +6 -11
data/lib/cliutils/ext/String+Extensions.rb +25 -13
data/lib/cliutils/logger-delegator.rb +15 -39
data/lib/cliutils/messenging.rb +10 -28
data/lib/cliutils/prefs.rb +18 -43
data/lib/cliutils/pretty-io.rb +59 -127
data/lib/cliutils/version.rb +2 -1
data/lib/cliutils.rb +2 -0
metadata +20 -32
data/bin/cliutils +0 -38
data/doc/CLIUtils/Configuration.html +0 -373
data/doc/CLIUtils/Configurator.html +0 -873
data/doc/CLIUtils/LoggerDelegator.html +0 -560
data/doc/CLIUtils/Messenging.html +0 -396
data/doc/CLIUtils/Prefs.html +0 -609
data/doc/CLIUtils/PrettyIO.html +0 -1333
data/doc/CLIUtils.html +0 -131
data/doc/Hash.html +0 -672
data/doc/Logger.html +0 -233
data/doc/String.html +0 -562
data/doc/_index.html +0 -207
data/doc/class_list.html +0 -54
data/doc/css/common.css +0 -1
data/doc/css/full_list.css +0 -57
data/doc/css/style.css +0 -339
data/doc/file.README.html +0 -415
data/doc/file_list.html +0 -56
data/doc/frames.html +0 -26
data/doc/index.html +0 -415
data/doc/js/app.js +0 -219
data/doc/js/full_list.js +0 -178
data/doc/js/jquery.js +0 -4
data/doc/method_list.html +0 -389
data/doc/top-level-namespace.html +0 -114

data/doc/CLIUtils/Prefs.html DELETED Viewed

@@ -1,609 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-<title>
-  Class: CLIUtils::Prefs
-    &mdash; Documentation by YARD 0.8.7.4
-</title>
-  <link rel="stylesheet" href="../css/style.css" type="text/css" charset="utf-8" />
-  <link rel="stylesheet" href="../css/common.css" type="text/css" charset="utf-8" />
-<script type="text/javascript" charset="utf-8">
-  hasFrames = window.top.frames.main ? true : false;
-  relpath = '../';
-  framesUrl = "../frames.html#!CLIUtils/Prefs.html";
-</script>
-  <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
-  <script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
-  </head>
-  <body>
-    <div id="header">
-      <div id="menu">
-    <a href="../_index.html">Index (P)</a> &raquo;
-    <span class='title'><span class='object_link'><a href="../CLIUtils.html" title="CLIUtils (module)">CLIUtils</a></span></span>
-     &raquo;
-    <span class="title">Prefs</span>
-  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
-</div>
-      <div id="search">
-    <a class="full_list_link" id="class_list_link"
-        href="../class_list.html">
-      Class List
-    </a>
-    <a class="full_list_link" id="method_list_link"
-        href="../method_list.html">
-      Method List
-    </a>
-    <a class="full_list_link" id="file_list_link"
-        href="../file_list.html">
-      File List
-    </a>
-</div>
-      <div class="clear"></div>
-    </div>
-    <iframe id="search_frame"></iframe>
-    <div id="content"><h1>Class: CLIUtils::Prefs
-</h1>
-<dl class="box">
-    <dt class="r1">Inherits:</dt>
-    <dd class="r1">
-      <span class="inheritName">Object</span>
-        <ul class="fullTree">
-          <li>Object</li>
-            <li class="next">CLIUtils::Prefs</li>
-        </ul>
-        <a href="#" class="inheritanceTree">show all</a>
-      </dd>
-      <dt class="r2">Includes:</dt>
-      <dd class="r2"><span class='object_link'><a href="PrettyIO.html" title="CLIUtils::PrettyIO (module)">PrettyIO</a></span></dd>
-    <dt class="r1 last">Defined in:</dt>
-    <dd class="r1 last">lib/cliutils/prefs.rb</dd>
-</dl>
-<div class="clear"></div>
-<h2>Overview</h2><div class="docstring">
-  <div class="discussion">
-<h6 id="label-"></h6>
-<pre class="code ruby"><code class="ruby">PrefManager Class
-Engine to derive preferences from a YAML file, deliver
-those to a user via a prompt, and collect the results.
-======================================================</code></pre>
-  </div>
-</div>
-<div class="tags">
-</div>
-  <h2>Instance Attribute Summary <small>(<a href="#" class="summary_toggle">collapse</a>)</small></h2>
-  <ul class="summary">
-      <li class="public ">
-  <span class="summary_signature">
-      <a href="#answers-instance_method" title="#answers (instance method)">- (Object) <strong>answers</strong> </a>
-  </span>
-      <span class="note title readonly">readonly</span>
-    <span class="summary_desc"><div class='inline'>
-<h6 id="label-Attributes++%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D.">Attributes  ====================================================.</h6>
-</div></span>
-</li>
-      <li class="public ">
-  <span class="summary_signature">
-      <a href="#config_path-instance_method" title="#config_path (instance method)">- (Object) <strong>config_path</strong> </a>
-  </span>
-      <span class="note title readonly">readonly</span>
-    <span class="summary_desc"><div class='inline'>
-<h6 id="label-Attributes++%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D.">Attributes  ====================================================.</h6>
-</div></span>
-</li>
-      <li class="public ">
-  <span class="summary_signature">
-      <a href="#prompts-instance_method" title="#prompts (instance method)">- (Object) <strong>prompts</strong> </a>
-  </span>
-      <span class="note title readonly">readonly</span>
-    <span class="summary_desc"><div class='inline'>
-<h6 id="label-Attributes++%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D.">Attributes  ====================================================.</h6>
-</div></span>
-</li>
-  </ul>
-    <h2>
-      Instance Method Summary
-      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
-    </h2>
-    <ul class="summary">
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#ask-instance_method" title="#ask (instance method)">- (Object) <strong>ask</strong> </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>—————————————————-  ask method.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#initialize-instance_method" title="#initialize (instance method)">- (Prefs) <strong>initialize</strong>(data) </a>
-  </span>
-    <span class="note title constructor">constructor</span>
-    <span class="summary_desc"><div class='inline'>
-<h6 id="label-Methods++%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D++----------------------------------------------------++initialize+method.">Methods  ====================================================  —————————————————-  initialize method.</h6>
-</div></span>
-</li>
-    </ul>
-  <h3 class="inherited">Methods included from <span class='object_link'><a href="PrettyIO.html" title="CLIUtils::PrettyIO (module)">PrettyIO</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="PrettyIO.html#color_chart-instance_method" title="CLIUtils::PrettyIO#color_chart (method)">#color_chart</a></span>, <span class='object_link'><a href="PrettyIO.html#debug-instance_method" title="CLIUtils::PrettyIO#debug (method)">#debug</a></span>, <span class='object_link'><a href="PrettyIO.html#error-instance_method" title="CLIUtils::PrettyIO#error (method)">#error</a></span>, <span class='object_link'><a href="PrettyIO.html#included-class_method" title="CLIUtils::PrettyIO.included (method)">included</a></span>, <span class='object_link'><a href="PrettyIO.html#info-instance_method" title="CLIUtils::PrettyIO#info (method)">#info</a></span>, <span class='object_link'><a href="PrettyIO.html#info_block-instance_method" title="CLIUtils::PrettyIO#info_block (method)">#info_block</a></span>, <span class='object_link'><a href="PrettyIO.html#log-instance_method" title="CLIUtils::PrettyIO#log (method)">#log</a></span>, <span class='object_link'><a href="PrettyIO.html#prompt-instance_method" title="CLIUtils::PrettyIO#prompt (method)">#prompt</a></span>, <span class='object_link'><a href="PrettyIO.html#section-instance_method" title="CLIUtils::PrettyIO#section (method)">#section</a></span>, <span class='object_link'><a href="PrettyIO.html#section_block-instance_method" title="CLIUtils::PrettyIO#section_block (method)">#section_block</a></span>, <span class='object_link'><a href="PrettyIO.html#success-instance_method" title="CLIUtils::PrettyIO#success (method)">#success</a></span>, <span class='object_link'><a href="PrettyIO.html#warn-instance_method" title="CLIUtils::PrettyIO#warn (method)">#warn</a></span>, <span class='object_link'><a href="PrettyIO.html#wrap-class_method" title="CLIUtils::PrettyIO.wrap (method)">wrap</a></span>, <span class='object_link'><a href="PrettyIO.html#wrap_at-class_method" title="CLIUtils::PrettyIO.wrap_at (method)">wrap_at</a></span>, <span class='object_link'><a href="PrettyIO.html#wrap_limit-class_method" title="CLIUtils::PrettyIO.wrap_limit (method)">wrap_limit</a></span></p>
-<div id="constructor_details" class="method_details_list">
-  <h2>Constructor Details</h2>
-    <div class="method_details first">
-  <h3 class="signature first" id="initialize-instance_method">
-    - (<tt><span class='object_link'><a href="" title="CLIUtils::Prefs (class)">Prefs</a></span></tt>) <strong>initialize</strong>(data)
-</h3><div class="docstring">
-  <div class="discussion">
-<h6 id="label-"></h6>
-<pre class="code ruby"><code class="ruby">Methods
-====================================================
-----------------------------------------------------
-initialize method
-Reads prompt data from YAML file.
-@return Void
-----------------------------------------------------</code></pre>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-24
-25
-26
-27
-28
-29
-30
-31
-32
-33
-34
-35
-36
-37
-38
-39
-40
-41
-42
-43
-44
-45
-46</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/cliutils/prefs.rb', line 24</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='id identifier rubyid_data'>data</span><span class='rparen'>)</span>
-  <span class='ivar'>@answers</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
-  <span class='ivar'>@prompts</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
-  <span class='kw'>case</span> <span class='id identifier rubyid_data'>data</span>
-  <span class='kw'>when</span> <span class='const'>String</span>
-    <span class='kw'>if</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_exists?'>exists?</span><span class='lparen'>(</span><span class='id identifier rubyid_data'>data</span><span class='rparen'>)</span>
-      <span class='ivar'>@config_path</span> <span class='op'>=</span> <span class='id identifier rubyid_data'>data</span>
-      <span class='id identifier rubyid_prompts'>prompts</span> <span class='op'>=</span> <span class='const'>YAML</span><span class='op'>::</span><span class='id identifier rubyid_load_file'>load_file</span><span class='lparen'>(</span><span class='id identifier rubyid_data'>data</span><span class='rparen'>)</span>
-      <span class='ivar'>@prompts</span><span class='period'>.</span><span class='id identifier rubyid_deep_merge!'>deep_merge!</span><span class='lparen'>(</span><span class='id identifier rubyid_prompts'>prompts</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_deep_symbolize_keys!'>deep_symbolize_keys!</span>
-    <span class='kw'>else</span>
-      <span class='id identifier rubyid_fail'>fail</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Invalid configuration file: </span><span class='embexpr_beg'>#{</span> <span class='id identifier rubyid_yaml_path'>yaml_path</span> <span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
-    <span class='kw'>end</span>
-  <span class='kw'>when</span> <span class='const'>Array</span>
-    <span class='ivar'>@config_path</span> <span class='op'>=</span> <span class='kw'>nil</span>
-    <span class='id identifier rubyid_prompts'>prompts</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='symbol'>:prompts</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_data'>data</span><span class='rbrace'>}</span>
-    <span class='ivar'>@prompts</span><span class='period'>.</span><span class='id identifier rubyid_deep_merge!'>deep_merge!</span><span class='lparen'>(</span><span class='id identifier rubyid_prompts'>prompts</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_deep_symbolize_keys!'>deep_symbolize_keys!</span>
-  <span class='kw'>else</span>
-    <span class='id identifier rubyid_fail'>fail</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Invalid configuration data</span><span class='tstring_end'>&#39;</span></span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-</div>
-  <div id="instance_attr_details" class="attr_details">
-    <h2>Instance Attribute Details</h2>
-      <span id=""></span>
-      <div class="method_details first">
-  <h3 class="signature first" id="answers-instance_method">
-    - (<tt>Object</tt>) <strong>answers</strong>  <span class="extras">(readonly)</span>
-</h3><div class="docstring">
-  <div class="discussion">
-<h6 id="label-"></h6>
-<pre class="code ruby"><code class="ruby">Attributes
-====================================================</code></pre>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-13
-14
-15</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/cliutils/prefs.rb', line 13</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_answers'>answers</span>
-  <span class='ivar'>@answers</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <span id=""></span>
-      <div class="method_details ">
-  <h3 class="signature " id="config_path-instance_method">
-    - (<tt>Object</tt>) <strong>config_path</strong>  <span class="extras">(readonly)</span>
-</h3><div class="docstring">
-  <div class="discussion">
-<h6 id="label-"></h6>
-<pre class="code ruby"><code class="ruby">Attributes
-====================================================</code></pre>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-13
-14
-15</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/cliutils/prefs.rb', line 13</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_config_path'>config_path</span>
-  <span class='ivar'>@config_path</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <span id=""></span>
-      <div class="method_details ">
-  <h3 class="signature " id="prompts-instance_method">
-    - (<tt>Object</tt>) <strong>prompts</strong>  <span class="extras">(readonly)</span>
-</h3><div class="docstring">
-  <div class="discussion">
-<h6 id="label-"></h6>
-<pre class="code ruby"><code class="ruby">Attributes
-====================================================</code></pre>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-13
-14
-15</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/cliutils/prefs.rb', line 13</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_prompts'>prompts</span>
-  <span class='ivar'>@prompts</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-  </div>
-  <div id="instance_method_details" class="method_details_list">
-    <h2>Instance Method Details</h2>
-      <div class="method_details first">
-  <h3 class="signature first" id="ask-instance_method">
-    - (<tt>Object</tt>) <strong>ask</strong>
-</h3><div class="docstring">
-  <div class="discussion">
-    <hr>
-<pre class="code ruby"><code class="ruby">ask method
-Runs through all of the prompt questions and collects
-answers from the user. Note that all questions w/o
-requirements are examined first; once those are
-complete, questions w/ requirements are examined.
-@return Void
-----------------------------------------------------</code></pre>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-57
-58
-59
-60
-61
-62
-63
-64
-65</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/cliutils/prefs.rb', line 57</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_ask'>ask</span>
-  <span class='ivar'>@prompts</span><span class='lbracket'>[</span><span class='symbol'>:prompts</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_reject'>reject</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_p'>p</span><span class='op'>|</span> <span class='id identifier rubyid_p'>p</span><span class='lbracket'>[</span><span class='symbol'>:requirements</span><span class='rbracket'>]</span> <span class='rbrace'>}</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_p'>p</span><span class='op'>|</span>
-    <span class='id identifier rubyid__deliver_prompt'>_deliver_prompt</span><span class='lparen'>(</span><span class='id identifier rubyid_p'>p</span><span class='rparen'>)</span>
-  <span class='kw'>end</span>
-  <span class='ivar'>@prompts</span><span class='lbracket'>[</span><span class='symbol'>:prompts</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_find_all'>find_all</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_p'>p</span><span class='op'>|</span> <span class='id identifier rubyid_p'>p</span><span class='lbracket'>[</span><span class='symbol'>:requirements</span><span class='rbracket'>]</span> <span class='rbrace'>}</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_p'>p</span><span class='op'>|</span>
-    <span class='id identifier rubyid__deliver_prompt'>_deliver_prompt</span><span class='lparen'>(</span><span class='id identifier rubyid_p'>p</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid__requirements_fulfilled?'>_requirements_fulfilled?</span><span class='lparen'>(</span><span class='id identifier rubyid_p'>p</span><span class='rparen'>)</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-  </div>
-</div>
-    <div id="footer">
-  Generated on Sat Mar 29 17:22:03 2014 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.7.4 (ruby-2.1.0).
-</div>
-  </body>
-</html>