action_command 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0ff531e1eca24b2ebde5421dc5bfb145a3060658
-  data.tar.gz: 157affdb256a84d6a8afd79ef73b2dbf7b684917
+  metadata.gz: 879f72610d61724fbc97d332f42f5747684fcf87
+  data.tar.gz: 6708760e32d75083d4bf016df78879ef76e385d7
 SHA512:
-  metadata.gz: a23a99e55f8fbd985631f5e55f983f0f6bb8f7fa76f96b81c371bfade67f76628dbfa8e949e72a8eae87df7d9555d8259d6be7c9467e9a2ab67750d5118dbeb9
-  data.tar.gz: 107d8d93f7d3877f171b0bafc7b605e4bd49f251e1d6681d0fdc830701c9e574bd2b8fb2187eef120919b87ea83b66c9d2643acf76fe1a7c3cf361187d7ebb66
+  metadata.gz: aefeb76599b455594b3e07b2c8ce73615b4f34a161f0ef36d148b7a2b348bea923bab3ef7fd4d2a5e8c8b389192f098b06bcaeec2e4089e582333a1c3e308bdb
+  data.tar.gz: 9ff15a57e4c1f95837787dbd2574ae5d0f751c1effd340bc6bdd6798558fe927ecb23bf4b5b95c2f4fb67c0097dd6404075cf95d3fd975253dd3d006f7b8282a

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    action_command (0.1.1)
+    action_command (0.1.2)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -26,8 +26,8 @@ Or install it yourself as:
 ## Usage
 
 `action_command` is designed to help you centralize logic which might otherwise end up in a controller or model, and easily invoke it from a controller, a test,
-or a rake command.  I read placing logic in 'actions' rather than models in the book [Rails 4 Test Prescriptions](http://www.amazon.com/Rails-Test-Prescriptions-Healthy-Codebase/dp/1941222196)
-and liked it.
+or a rake command.  I encountered the idea in the book [Rails 4 Test Prescriptions](http://www.amazon.com/Rails-Test-Prescriptions-Healthy-Codebase/dp/1941222196),
+tried it and liked it.
 
 ### HelloWorld
 
@@ -55,7 +55,7 @@ class HelloWorldCommand < ActionCommand::Executable
   # assign results to the result.   You can also use methods like result.fail or 
   # result.info.
   def execute_internal(result)
-    result[:greeting] = "Hello #{@name}" unless no_output
+    result[:greeting] = "Hello #{@name}"
   end
 end
 ```
@@ -71,7 +71,7 @@ You can execute it from rails:
 #### HelloWorld: Execute from Rake
 
 When building a system, I find it useful to be able to easily run my actions from 
-the command-line as well.  In rails, you can create a lib/tasks/my_rake.task, and
+the command-line as well.  In rails, you can create a lib/tasks/my_task.rake, and
 configure your actions as task with one line:
 
 ```
@@ -85,7 +85,34 @@ end
 ```
 
 You can always invoke your rake task with [help] to see help on the input and output
-of the action.
+of the action.  Then 
+
+```
+rake  my_namespace:hello_world[help]
+```
+
+will produce:
+
+```
+HelloWorldCommand: Say hello to someone
+  Input: 
+    name: Name of person to say hello to
+    no_output: If true, intentionally produces no output (optional)
+  Output: 
+    greeting: Greeting for the person
+```    
+
+and 
+
+```
+rake my_namespace:hello_world[chris]
+```
+
+will produce:
+
+```
+greeting: Hello chris
+```
 
 #### HelloWorld: Execute from rspec/etc
 
@@ -100,7 +127,7 @@ Or, you can execute it from a testing framework.
 ```
 
 If your command does a lot, you might like to do some internal verifications during the testing process to aid
-debugging.   Inside a command's execute_internal method, you can use a block like this
+debugging.   Inside a command's execute_internal method, you can use a block like this:
 
 ```ruby
   def execute_internal(result)
@@ -114,6 +141,7 @@ debugging.   Inside a command's execute_internal method, you can use a block lik
     end
     
   end
+```
 
 ### Child Actions
 

data/doc/ActionCommand/Executable.html

@@ -594,12 +594,12 @@ validations within the testing context.</p>
       <pre class="lines">
 
 
+39
 40
-41
-42</pre>
+41</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 40</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 39</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_child_context?'>child_context?</span>
   <span class='kw'>return</span> <span class='op'>!</span><span class='id identifier rubyid_parent'>parent</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Symbol</span><span class='rparen'>)</span>
@@ -650,14 +650,14 @@ Command implementors should override execute_internal.</p>
       <pre class="lines">
 
 
+48
 49
 50
 51
-52
-53</pre>
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 49</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 48</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_execute'>execute</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_execute_internal'>execute_internal</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='rparen'>)</span>
@@ -716,12 +716,12 @@ that the command failed.</p>
       <pre class="lines">
 
 
+69
 70
-71
-72</pre>
+71</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 70</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 69</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_execute_internal'>execute_internal</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='rparen'>)</span>
   
@@ -775,12 +775,12 @@ that the command failed.</p>
       <pre class="lines">
 
 
+29
 30
-31
-32</pre>
+31</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 30</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 29</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_rails_context?'>rails_context?</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_root_context'>root_context</span> <span class='op'>==</span> <span class='const'>ActionCommand</span><span class='op'>::</span><span class='const'>CONTEXT_RAILS</span>
@@ -834,12 +834,12 @@ that the command failed.</p>
       <pre class="lines">
 
 
+34
 35
-36
-37</pre>
+36</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 35</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 34</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_rake_context?'>rake_context?</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_root_context'>root_context</span> <span class='op'>==</span> <span class='const'>ActionCommand</span><span class='op'>::</span><span class='const'>CONTEXT_RAKE</span>
@@ -897,14 +897,12 @@ that the command failed.</p>
 18
 19
 20
-21
-22</pre>
+21</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 17</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_root_context'>root_context</span>
-  
   <span class='id identifier rubyid_context'>context</span> <span class='op'>=</span> <span class='id identifier rubyid_parent'>parent</span>
   <span class='id identifier rubyid_context'>context</span> <span class='op'>=</span> <span class='id identifier rubyid_context'>context</span><span class='period'>.</span><span class='id identifier rubyid_parent'>parent</span> <span class='kw'>until</span> <span class='id identifier rubyid_context'>context</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span> <span class='const'>Symbol</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_context'>context</span>
@@ -958,12 +956,12 @@ that the command failed.</p>
       <pre class="lines">
 
 
+24
 25
-26
-27</pre>
+26</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 25</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 24</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_test_context?'>test_context?</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_root_context'>root_context</span> <span class='op'>==</span> <span class='const'>ActionCommand</span><span class='op'>::</span><span class='const'>CONTEXT_TEST</span>
@@ -1019,12 +1017,12 @@ ActionCommand#execute_test.</p>
       <pre class="lines">
 
 
+58
 59
-60
-61</pre>
+60</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 59</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/executable.rb', line 58</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_testing'>testing</span>
   <span class='kw'>yield</span> <span class='ivar'>@test</span> <span class='kw'>if</span> <span class='ivar'>@test</span>
@@ -1039,7 +1037,7 @@ ActionCommand#execute_test.</p>
 </div>
 
     <div id="footer">
-  Generated on Thu Mar  3 16:34:07 2016 by
+  Generated on Fri Mar  4 10:20:15 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.2.3).
 </div>

data/doc/ActionCommand/InputOutput.html

@@ -989,7 +989,7 @@ missing</p>
       <pre class="code"><span class="info file"># File 'lib/action_command/input_output.rb', line 67</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_process_output'>process_output</span><span class='lparen'>(</span><span class='id identifier rubyid_dest'>dest</span><span class='comma'>,</span> <span class='id identifier rubyid_result'>result</span><span class='rparen'>)</span>
-  <span class='kw'>return</span> <span class='kw'>unless</span> <span class='id identifier rubyid_should_validate'>should_validate</span><span class='lparen'>(</span><span class='id identifier rubyid_dest'>dest</span><span class='rparen'>)</span>
+  <span class='kw'>return</span> <span class='kw'>unless</span> <span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_ok?'>ok?</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_should_validate'>should_validate</span><span class='lparen'>(</span><span class='id identifier rubyid_dest'>dest</span><span class='rparen'>)</span>
 
   <span class='ivar'>@output</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_param'>param</span><span class='op'>|</span>
     <span class='id identifier rubyid_sym'>sym</span> <span class='op'>=</span> <span class='id identifier rubyid_param'>param</span><span class='lbracket'>[</span><span class='symbol'>:symbol</span><span class='rbracket'>]</span>
@@ -1268,7 +1268,7 @@ description.</p>
 </div>
 
     <div id="footer">
-  Generated on Thu Mar  3 16:34:07 2016 by
+  Generated on Fri Mar  4 10:20:15 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.2.3).
 </div>

data/doc/ActionCommand/Result.html

@@ -869,7 +869,7 @@ result.</p>
 </div>
 
     <div id="footer">
-  Generated on Thu Mar  3 16:34:07 2016 by
+  Generated on Fri Mar  4 10:20:15 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.2.3).
 </div>

data/doc/ActionCommand.html

@@ -192,7 +192,7 @@ controller, etc)</p>
 
 </div>
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>0.1.0</span><span class='tstring_end'>&#39;</span></span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>0.1.2</span><span class='tstring_end'>&#39;</span></span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre></dd>
       
         <dt id="logger-classvariable" class="">@@logger =
           <div class="docstring">
@@ -1227,7 +1227,7 @@ validations.  See <span class='object_link'><a href="ActionCommand/Executable.ht
 </div>
 
     <div id="footer">
-  Generated on Thu Mar  3 16:34:07 2016 by
+  Generated on Fri Mar  4 10:20:15 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.2.3).
 </div>

data/doc/_index.html

@@ -161,7 +161,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Mar  3 16:34:06 2016 by
+  Generated on Fri Mar  4 10:20:14 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.2.3).
 </div>

data/doc/file.README.html

@@ -98,10 +98,10 @@ by others.</p>
 
 <p><code>action_command</code> is designed to help you centralize logic which
 might otherwise end up in a controller or model, and easily invoke it from
-a controller, a test, or a rake command. I read placing logic in
-&#39;actions&#39; rather than models in the book <a
+a controller, a test, or a rake command. I encountered the idea in the book
+<a
 href="http://www.amazon.com/Rails-Test-Prescriptions-Healthy-Codebase/dp/1941222196">Rails
-4 Test Prescriptions</a> and liked it.</p>
+4 Test Prescriptions</a>, tried it and liked it.</p>
 
 <h3 id="label-HelloWorld">HelloWorld</h3>
 
@@ -128,7 +128,7 @@ href="http://www.amazon.com/Rails-Test-Prescriptions-Healthy-Codebase/dp/1941222
 </span>  <span class='comment'># assign results to the result.   You can also use methods like result.fail or 
 </span>  <span class='comment'># result.info.
 </span>  <span class='kw'>def</span> <span class='id identifier rubyid_execute_internal'>execute_internal</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='rparen'>)</span>
-    <span class='id identifier rubyid_result'>result</span><span class='lbracket'>[</span><span class='symbol'>:greeting</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Hello </span><span class='embexpr_beg'>#{</span><span class='ivar'>@name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_no_output'>no_output</span>
+    <span class='id identifier rubyid_result'>result</span><span class='lbracket'>[</span><span class='symbol'>:greeting</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Hello </span><span class='embexpr_beg'>#{</span><span class='ivar'>@name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
   <span class='kw'>end</span>
 <span class='kw'>end</span>
 </code></pre>
@@ -144,7 +144,7 @@ href="http://www.amazon.com/Rails-Test-Prescriptions-Healthy-Codebase/dp/1941222
 
 <p>When building a system, I find it useful to be able to easily run my
 actions from the command-line as well. In rails, you can create a
-lib/tasks/my_rake.task, and configure your actions as task with one line:</p>
+lib/tasks/my_task.rake, and configure your actions as task with one line:</p>
 
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_namespace'>namespace</span> <span class='symbol'>:my_namespace</span> <span class='kw'>do</span>
 
@@ -156,7 +156,28 @@ lib/tasks/my_rake.task, and configure your actions as task with one line:</p>
 </code></pre>
 
 <p>You can always invoke your rake task with [help] to see help on the input
-and output of the action.</p>
+and output of the action. Then</p>
+
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_rake'>rake</span>  <span class='label'>my_namespace:</span><span class='id identifier rubyid_hello_world'>hello_world</span><span class='lbracket'>[</span><span class='id identifier rubyid_help'>help</span><span class='rbracket'>]</span>
+</code></pre>
+
+<p>will produce:</p>
+
+<pre class="code ruby"><code class="ruby">HelloWorldCommand: Say hello to someone
+  Input: 
+    name: Name of person to say hello to
+    no_output: If true, intentionally produces no output (optional)
+  Output: 
+    greeting: Greeting for the person</code></pre>
+
+<p>and</p>
+
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_rake'>rake</span> <span class='label'>my_namespace:</span><span class='id identifier rubyid_hello_world'>hello_world</span><span class='lbracket'>[</span><span class='id identifier rubyid_chris'>chris</span><span class='rbracket'>]</span>
+</code></pre>
+
+<p>will produce:</p>
+
+<pre class="code ruby"><code class="ruby">greeting: Hello chris</code></pre>
 
 <h4 id="label-HelloWorld-3A+Execute+from+rspec-2Fetc">HelloWorld: Execute from rspec/etc</h4>
 
@@ -171,7 +192,7 @@ and output of the action.</p>
 
 <p>If your command does a lot, you might like to do some internal
 verifications during the testing process to aid debugging. Inside a
-command&#39;s execute_internal method, you can use a block like this</p>
+command&#39;s execute_internal method, you can use a block like this:</p>
 
 <pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_execute_internal'>execute_internal</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='rparen'>)</span>
     <span class='comment'># ... do some logic
@@ -184,18 +205,23 @@ command&#39;s execute_internal method, you can use a block like this</p>
     <span class='kw'>end</span>
     
   <span class='kw'>end</span>
+</code></pre>
+
+<h3 id="label-Child+Actions">Child Actions</h3>
 
-<span class='comment'>### Child Actions
-</span>
-<span class='const'>Actions</span> <span class='id identifier rubyid_can'>can</span> <span class='id identifier rubyid_execute'>execute</span> <span class='id identifier rubyid_their'>their</span> <span class='id identifier rubyid_own'>own</span> <span class='id identifier rubyid_child'>child</span> <span class='id identifier rubyid_actions'>actions</span><span class='period'>.</span>  <span class='const'>Within</span> <span class='id identifier rubyid_an'>an</span> <span class='id identifier rubyid_action'>action</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>s execute_internal method
-</span></span></code></pre>
+<p>Actions can execute their own child actions. Within an action&#39;s
+execute_internal method you should call additional actions via:</p>
 
-<p>ruby  def execute_internal  @names.each_with_index do |name, i|  # the i
-parameter will cause the result of the child command to be nested  # in the
-result under that value. For example, here I would expect  # <a
-href="i">result</a>[:greeting] to contain the greeting for each subcommand
-after  # execution.  ActionCommand.execute_child(self, HelloWorldCommand,
-result, i, name: name)  end  end “`</p>
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_execute_internal'>execute_internal</span>
+    <span class='ivar'>@names</span><span class='period'>.</span><span class='id identifier rubyid_each_with_index'>each_with_index</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_i'>i</span><span class='op'>|</span>
+      <span class='comment'># the i parameter will cause the result of the child command to be nested
+</span>      <span class='comment'># in the result under that value.  For example, here I would expect
+</span>      <span class='comment'># result[i][:greeting] to contain the greeting for each subcommand after
+</span>      <span class='comment'># execution.
+</span>      <span class='const'>ActionCommand</span><span class='period'>.</span><span class='id identifier rubyid_execute_child'>execute_child</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span> <span class='const'>HelloWorldCommand</span><span class='comma'>,</span> <span class='id identifier rubyid_result'>result</span><span class='comma'>,</span> <span class='id identifier rubyid_i'>i</span><span class='comma'>,</span> <span class='label'>name:</span> <span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span>
+    <span class='kw'>end</span>
+  <span class='kw'>end</span>
+</code></pre>
 
 <h2 id="label-Development">Development</h2>
 
@@ -227,7 +253,7 @@ href="http://opensource.org/licenses/MIT">MIT License</a>.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Thu Mar  3 16:34:07 2016 by
+  Generated on Fri Mar  4 10:20:14 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.2.3).
 </div>

data/doc/index.html

@@ -98,10 +98,10 @@ by others.</p>
 
 <p><code>action_command</code> is designed to help you centralize logic which
 might otherwise end up in a controller or model, and easily invoke it from
-a controller, a test, or a rake command. I read placing logic in
-&#39;actions&#39; rather than models in the book <a
+a controller, a test, or a rake command. I encountered the idea in the book
+<a
 href="http://www.amazon.com/Rails-Test-Prescriptions-Healthy-Codebase/dp/1941222196">Rails
-4 Test Prescriptions</a> and liked it.</p>
+4 Test Prescriptions</a>, tried it and liked it.</p>
 
 <h3 id="label-HelloWorld">HelloWorld</h3>
 
@@ -128,7 +128,7 @@ href="http://www.amazon.com/Rails-Test-Prescriptions-Healthy-Codebase/dp/1941222
 </span>  <span class='comment'># assign results to the result.   You can also use methods like result.fail or 
 </span>  <span class='comment'># result.info.
 </span>  <span class='kw'>def</span> <span class='id identifier rubyid_execute_internal'>execute_internal</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='rparen'>)</span>
-    <span class='id identifier rubyid_result'>result</span><span class='lbracket'>[</span><span class='symbol'>:greeting</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Hello </span><span class='embexpr_beg'>#{</span><span class='ivar'>@name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_no_output'>no_output</span>
+    <span class='id identifier rubyid_result'>result</span><span class='lbracket'>[</span><span class='symbol'>:greeting</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Hello </span><span class='embexpr_beg'>#{</span><span class='ivar'>@name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
   <span class='kw'>end</span>
 <span class='kw'>end</span>
 </code></pre>
@@ -144,7 +144,7 @@ href="http://www.amazon.com/Rails-Test-Prescriptions-Healthy-Codebase/dp/1941222
 
 <p>When building a system, I find it useful to be able to easily run my
 actions from the command-line as well. In rails, you can create a
-lib/tasks/my_rake.task, and configure your actions as task with one line:</p>
+lib/tasks/my_task.rake, and configure your actions as task with one line:</p>
 
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_namespace'>namespace</span> <span class='symbol'>:my_namespace</span> <span class='kw'>do</span>
 
@@ -156,7 +156,28 @@ lib/tasks/my_rake.task, and configure your actions as task with one line:</p>
 </code></pre>
 
 <p>You can always invoke your rake task with [help] to see help on the input
-and output of the action.</p>
+and output of the action. Then</p>
+
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_rake'>rake</span>  <span class='label'>my_namespace:</span><span class='id identifier rubyid_hello_world'>hello_world</span><span class='lbracket'>[</span><span class='id identifier rubyid_help'>help</span><span class='rbracket'>]</span>
+</code></pre>
+
+<p>will produce:</p>
+
+<pre class="code ruby"><code class="ruby">HelloWorldCommand: Say hello to someone
+  Input: 
+    name: Name of person to say hello to
+    no_output: If true, intentionally produces no output (optional)
+  Output: 
+    greeting: Greeting for the person</code></pre>
+
+<p>and</p>
+
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_rake'>rake</span> <span class='label'>my_namespace:</span><span class='id identifier rubyid_hello_world'>hello_world</span><span class='lbracket'>[</span><span class='id identifier rubyid_chris'>chris</span><span class='rbracket'>]</span>
+</code></pre>
+
+<p>will produce:</p>
+
+<pre class="code ruby"><code class="ruby">greeting: Hello chris</code></pre>
 
 <h4 id="label-HelloWorld-3A+Execute+from+rspec-2Fetc">HelloWorld: Execute from rspec/etc</h4>
 
@@ -171,7 +192,7 @@ and output of the action.</p>
 
 <p>If your command does a lot, you might like to do some internal
 verifications during the testing process to aid debugging. Inside a
-command&#39;s execute_internal method, you can use a block like this</p>
+command&#39;s execute_internal method, you can use a block like this:</p>
 
 <pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_execute_internal'>execute_internal</span><span class='lparen'>(</span><span class='id identifier rubyid_result'>result</span><span class='rparen'>)</span>
     <span class='comment'># ... do some logic
@@ -184,18 +205,23 @@ command&#39;s execute_internal method, you can use a block like this</p>
     <span class='kw'>end</span>
     
   <span class='kw'>end</span>
+</code></pre>
+
+<h3 id="label-Child+Actions">Child Actions</h3>
 
-<span class='comment'>### Child Actions
-</span>
-<span class='const'>Actions</span> <span class='id identifier rubyid_can'>can</span> <span class='id identifier rubyid_execute'>execute</span> <span class='id identifier rubyid_their'>their</span> <span class='id identifier rubyid_own'>own</span> <span class='id identifier rubyid_child'>child</span> <span class='id identifier rubyid_actions'>actions</span><span class='period'>.</span>  <span class='const'>Within</span> <span class='id identifier rubyid_an'>an</span> <span class='id identifier rubyid_action'>action</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>s execute_internal method
-</span></span></code></pre>
+<p>Actions can execute their own child actions. Within an action&#39;s
+execute_internal method you should call additional actions via:</p>
 
-<p>ruby  def execute_internal  @names.each_with_index do |name, i|  # the i
-parameter will cause the result of the child command to be nested  # in the
-result under that value. For example, here I would expect  # <a
-href="i">result</a>[:greeting] to contain the greeting for each subcommand
-after  # execution.  ActionCommand.execute_child(self, HelloWorldCommand,
-result, i, name: name)  end  end “`</p>
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_execute_internal'>execute_internal</span>
+    <span class='ivar'>@names</span><span class='period'>.</span><span class='id identifier rubyid_each_with_index'>each_with_index</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_i'>i</span><span class='op'>|</span>
+      <span class='comment'># the i parameter will cause the result of the child command to be nested
+</span>      <span class='comment'># in the result under that value.  For example, here I would expect
+</span>      <span class='comment'># result[i][:greeting] to contain the greeting for each subcommand after
+</span>      <span class='comment'># execution.
+</span>      <span class='const'>ActionCommand</span><span class='period'>.</span><span class='id identifier rubyid_execute_child'>execute_child</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span> <span class='const'>HelloWorldCommand</span><span class='comma'>,</span> <span class='id identifier rubyid_result'>result</span><span class='comma'>,</span> <span class='id identifier rubyid_i'>i</span><span class='comma'>,</span> <span class='label'>name:</span> <span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span>
+    <span class='kw'>end</span>
+  <span class='kw'>end</span>
+</code></pre>
 
 <h2 id="label-Development">Development</h2>
 
@@ -227,7 +253,7 @@ href="http://opensource.org/licenses/MIT">MIT License</a>.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Thu Mar  3 16:34:07 2016 by
+  Generated on Fri Mar  4 10:20:14 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.2.3).
 </div>

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Thu Mar  3 16:34:07 2016 by
+  Generated on Fri Mar  4 10:20:14 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.2.3).
 </div>

data/lib/action_command/executable.rb

@@ -15,7 +15,6 @@ module ActionCommand
     # @return [Symbol] the symbol indicating what context this 
     # action was executed in, see the ActionCommand::CONTEXT_ constants.
     def root_context
-      
       context = parent
       context = context.parent until context.is_a? Symbol
       return context

data/lib/action_command/input_output.rb

@@ -65,7 +65,7 @@ module ActionCommand
     
     # Goes through, and makes sure that required output parameters exist
     def process_output(dest, result)
-      return unless should_validate(dest)
+      return unless result.ok? && should_validate(dest)
 
       @output.each do |param|
         sym = param[:symbol]

data/lib/action_command/utils.rb

@@ -6,7 +6,6 @@ module ActionCommand
     # Used for cases where you might want to pass an action a User object, or
     # the integer ID of a user object, or the unique email of a user object, and
     # have the command operate on the user object.
-  
     # Converts an item into an object as follows:
     # 1. If item is an object of cls, then returns it
     # 2. If item is an integer, then assumes its and id and returns cls.find(item)
@@ -16,6 +15,11 @@ module ActionCommand
       return cls.find(item) if item.is_a? Integer
       return yield(item)
     end
+    
+    
+     
+    
+    
   end
   
 end

data/lib/action_command/version.rb

@@ -1,4 +1,4 @@
 module ActionCommand
   # Version of this Gem
-  VERSION = '0.1.1'.freeze
+  VERSION = '0.1.2'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: action_command
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Chris Jones
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-03-03 00:00:00.000000000 Z
+date: 2016-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler