action_command 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2cd366bbe081e13a248bcff7ef460127574f2c73
-  data.tar.gz: 3d8a05a55480d5d10fa609d4e9d69ede0bd849c2
+  metadata.gz: b605106ac4ef7cb666c6a7f0dc61c3c5da322c7a
+  data.tar.gz: 155ec4f83025e426935f424024e009af572d1081
 SHA512:
-  metadata.gz: 1e7674270076303b570cd4687d4816218edd54eb8afa96a01611c9c0cc42a4eea0827dc769e8690958f3b737bdee6a2bcb09d7171fe9faee545b793c4b2c84f7
-  data.tar.gz: 3adbd8341c395686657dd8d9dd8a840e760dc1f0c96f93aa2c8af935b9a3b3ea6c4035f1efaa46f1a6342c7c12de9288acb991cd37233f94dd62a5fbe9425370
+  metadata.gz: eda1183bbe4a57392f76f90ff681d0f3b82c2cf5516cb2c2b9ce7adc14e22ffee3c73a8df9bdc856e57df10566bd8928cffffdae673970427c008c4726faa708
+  data.tar.gz: c6302fd177aa94a8e74caa101dcf56bb4c1d19e93c4a087490a0a5b79f25286cb2f2479e66924dd9cb72da259144bc3fb2b34b4e40398eae416b2e9ceb79d006

data/Gemfile.lock

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

data/README.md

@@ -210,17 +210,62 @@ command executions:
 ```
 
 When logging is on, the logger will receive single-line JSON messages
-at the debugging level for all command inputs and outputs.  All child
+at the info level for all command inputs and outputs.  All child
 commands under a parent will automatically be tagged with a serial
 number for correlation.  The result looks like this:
 
-TODO
+```
+I, [2016-03-07T14:31:53.292843 #47956]  INFO -- : {"sequence":"ade3605e40a4d5bf724c5f3d8e43420b","cmd":"CreateUserAction","depth":0,"kind":"command_input","msg":{"name":"Chris","email":"test@test.com","age":41}}
+I, [2016-03-07T14:31:53.293007 #47956]  INFO -- : {"sequence":"ade3605e40a4d5bf724c5f3d8e43420b","cmd":"CreateUserAction","depth":0,"kind":"info","msg":"start_transaction"}
+I, [2016-03-07T14:31:53.308212 #47956]  INFO -- : {"sequence":"ade3605e40a4d5bf724c5f3d8e43420b","cmd":"CreateUserAction","depth":0,"kind":"info","msg":"Saved user"}
+I, [2016-03-07T14:31:53.308336 #47956]  INFO -- : {"sequence":"ade3605e40a4d5bf724c5f3d8e43420b","cmd":"CreateUserAction","depth":0,"kind":"command_input","msg":{}}
+I, [2016-03-07T14:31:53.308442 #47956]  INFO -- : {"sequence":"ade3605e40a4d5bf724c5f3d8e43420b","cmd":"CreateUserAction","depth":0,"kind":"info","msg":"in child transaction"}
+I, [2016-03-07T14:31:53.308504 #47956]  INFO -- : {"sequence":"ade3605e40a4d5bf724c5f3d8e43420b","cmd":"CreateUserAction","depth":0,"kind":"command_output","msg":{}}
+I, [2016-03-07T14:31:53.308562 #47956]  INFO -- : {"sequence":"ade3605e40a4d5bf724c5f3d8e43420b","cmd":"CreateUserAction","depth":0,"kind":"info","msg":"end_transaction"}
+I, [2016-03-07T14:31:53.308837 #47956]  INFO -- : {"sequence":"ade3605e40a4d5bf724c5f3d8e43420b","cmd":"CreateUserAction","depth":0,"kind":"command_output","msg":{"user":{"email":"test@test.com","name":"Chris","age":41}}}
+```
 
 You can also optionally add your own entries to the log by calling
-`result.debug`, `result.info`, or `result.failed`.   If you pass these
-calls a string, they will include it as `msg` in the JSON.   If you
-pass them a hash, its contents will be merged into the JSON.
+`result.debug`, `result.info`, or `result.failed`.   You can pass these calls
+a string or a hash.
+
+You can use the included LogParser to parse this log if you like, or you can
+use the included PrettyPrintLogAction to print the log in a nested plain text
+format, like:
+
+```
+  HelloWorldCommand (8d315fe58dab39cb4f23a9f4ef366c8b)
+    input:
+      name: Chris
+    Hello Chris
+  output:
+    greeting: Hello Chris
+```
+
+### ActiveRecord Transactions
+
+You can wrap your command contents in a transaction by subclassing
+`ActionCommand::ExecutableTransaction`.  You must explicitly require
+`action_command/executable_transaction` to avoid a default dependency
+on ActiveRecord.
+
+If you call `result.failed` within a transaction, your transaction will
+automatically be rolled back.
 
+### Utilities
+
+It is often useful to allow a single parameter to be either an integer object id,
+an instance of the object itself, or a string used to lookup the object (used
+in command-line rake tasks).   You can do this using
+
+```ruby
+  def execute_internal(result)
+    user = ActionCommand::Utils.find_object(User, @user_id) { |p| User.find_by_email(p) }
+  end
+```
+
+This will user User.find if passed an Integer, will return a user object, or will yield
+to the lookup otherwise.
 
 ## Development
 
@@ -232,7 +277,6 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/action_command. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
-
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/doc/ActionCommand/Executable.html

@@ -1124,7 +1124,7 @@ ActionCommand#execute_test.</p>
 </div>
 
     <div id="footer">
-  Generated on Mon Mar  7 14:27:17 2016 by
+  Generated on Mon May 16 08:49:39 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

@@ -1401,7 +1401,7 @@ description.</p>
 </div>
 
     <div id="footer">
-  Generated on Mon Mar  7 14:27:17 2016 by
+  Generated on Mon May 16 08:49:39 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

@@ -117,6 +117,35 @@
   <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="#last_error-instance_method" title="#last_error (instance method)">- (String) <strong>last_error</strong> </a>
+    
+
+    
+  </span>
+  
+  
+  
+    
+      <span class="note title readonly">readonly</span>
+    
+    
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'>
+<p>The last string error message.</p>
+</div></span>
+  
+</li>
+
+    
       <li class="public ">
   <span class="summary_signature">
     
@@ -653,13 +682,15 @@
 9
 10
 11
-12</pre>
+12
+13</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 8</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span>
   <span class='ivar'>@result_code</span> <span class='op'>=</span> <span class='const'>RESULT_CODE_OK</span>
+  <span class='ivar'>@last_error</span>  <span class='op'>=</span> <span class='kw'>nil</span>
   <span class='ivar'>@values</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rbracket'>]</span>
   <span class='ivar'>@logger</span> <span class='op'>=</span> <span class='kw'>nil</span>
 <span class='kw'>end</span></pre>
@@ -676,7 +707,68 @@
       
       <span id=""></span>
       <div class="method_details first">
-  <h3 class="signature first" id="result_code-instance_method">
+  <h3 class="signature first" id="last_error-instance_method">
+  
+    - (<tt>String</tt>) <strong>last_error</strong>  <span class="extras">(readonly)</span>
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    
+<p>Returns the last string error message</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>String</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>the last string error message</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+79
+80
+81</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 79</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_last_error'>last_error</span>
+  <span class='ivar'>@last_error</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      
+      <span id=""></span>
+      <div class="method_details ">
+  <h3 class="signature " id="result_code-instance_method">
   
     - (<tt>Integer</tt>) <strong>result_code</strong>  <span class="extras">(readonly)</span>
   
@@ -719,12 +811,12 @@
       <pre class="lines">
 
 
-73
-74
-75</pre>
+76
+77
+78</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 73</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 76</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_result_code'>result_code</span>
   <span class='ivar'>@result_code</span>
@@ -767,12 +859,12 @@
       <pre class="lines">
 
 
-116
-117
-118</pre>
+122
+123
+124</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 116</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 122</span>
 
 <span class='kw'>def</span> <span class='op'>[]</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_current'>current</span><span class='lbracket'>[</span><span class='id identifier rubyid_key'>key</span><span class='rbracket'>]</span>
@@ -808,12 +900,12 @@
       <pre class="lines">
 
 
-101
-102
-103</pre>
+107
+108
+109</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 101</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 107</span>
 
 <span class='kw'>def</span> <span class='op'>[]=</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_val'>val</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_current'>current</span><span class='lbracket'>[</span><span class='id identifier rubyid_key'>key</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_val'>val</span>
@@ -849,12 +941,12 @@
       <pre class="lines">
 
 
-96
-97
-98</pre>
+102
+103
+104</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 96</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 102</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_current'>current</span>
   <span class='kw'>return</span> <span class='ivar'>@values</span><span class='period'>.</span><span class='id identifier rubyid_last'>last</span>
@@ -908,15 +1000,15 @@
       <pre class="lines">
 
 
-29
 30
 31
 32
 33
-34</pre>
+34
+35</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 29</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 30</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_debug'>debug</span><span class='lparen'>(</span><span class='id identifier rubyid_msg'>msg</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
   <span class='kw'>if</span> <span class='ivar'>@logger</span>
@@ -955,12 +1047,12 @@
       <pre class="lines">
 
 
-46
 47
-48</pre>
+48
+49</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 46</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 47</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span><span class='id identifier rubyid_msg'>msg</span><span class='rparen'>)</span>
   <span class='ivar'>@logger</span><span class='period'>.</span><span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span><span class='id identifier rubyid_build_log'>build_log</span><span class='lparen'>(</span><span class='id identifier rubyid_msg'>msg</span><span class='comma'>,</span> <span class='const'>ActionCommand</span><span class='op'>::</span><span class='const'>LOG_KIND_ERROR</span><span class='rparen'>)</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='ivar'>@logger</span>
@@ -1017,16 +1109,18 @@ result.</p>
       <pre class="lines">
 
 
-53
 54
 55
-56</pre>
+56
+57
+58</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 53</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 54</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_failed'>failed</span><span class='lparen'>(</span><span class='id identifier rubyid_msg'>msg</span><span class='rparen'>)</span>
   <span class='ivar'>@result_code</span> <span class='op'>=</span> <span class='const'>RESULT_CODE_FAILED</span>
+  <span class='ivar'>@last_error</span>  <span class='op'>=</span> <span class='id identifier rubyid_msg'>msg</span>
   <span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span><span class='id identifier rubyid_msg'>msg</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -1092,16 +1186,18 @@ result.</p>
       <pre class="lines">
 
 
-62
-63
 64
-65</pre>
+65
+66
+67
+68</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 62</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 64</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_failed_with_code'>failed_with_code</span><span class='lparen'>(</span><span class='id identifier rubyid_msg'>msg</span><span class='comma'>,</span> <span class='id identifier rubyid_result_code'>result_code</span><span class='rparen'>)</span>
   <span class='ivar'>@result_code</span> <span class='op'>=</span> <span class='id identifier rubyid_result_code'>result_code</span>
+  <span class='ivar'>@last_error</span> <span class='op'>=</span> <span class='id identifier rubyid_msg'>msg</span>
   <span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span><span class='id identifier rubyid_msg'>msg</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -1153,15 +1249,15 @@ result.</p>
       <pre class="lines">
 
 
-38
 39
 40
 41
 42
-43</pre>
+43
+44</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 38</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 39</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_info'>info</span><span class='lparen'>(</span><span class='id identifier rubyid_msg'>msg</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
   <span class='kw'>if</span> <span class='ivar'>@logger</span>
@@ -1213,12 +1309,12 @@ result.</p>
       <pre class="lines">
 
 
-111
-112
-113</pre>
+117
+118
+119</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 111</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 117</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_key?'>key?</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='id identifier rubyid_current'>current</span><span class='period'>.</span><span class='id identifier rubyid_key?'>key?</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
@@ -1254,14 +1350,14 @@ result.</p>
       <pre class="lines">
 
 
-121
-122
-123
-124
-125</pre>
+127
+128
+129
+130
+131</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 121</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 127</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_log_input'>log_input</span><span class='lparen'>(</span><span class='id identifier rubyid_params'>params</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>unless</span> <span class='ivar'>@logger</span>
@@ -1299,16 +1395,16 @@ result.</p>
       <pre class="lines">
 
 
-128
-129
-130
-131
-132
-133
-134</pre>
+134
+135
+136
+137
+138
+139
+140</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 128</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 134</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_log_output'>log_output</span>
   <span class='kw'>return</span> <span class='kw'>unless</span> <span class='ivar'>@logger</span>
@@ -1348,15 +1444,15 @@ result.</p>
       <pre class="lines">
 
 
-15
 16
 17
 18
 19
-20</pre>
+20
+21</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 15</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 16</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_logger='>logger=</span><span class='lparen'>(</span><span class='id identifier rubyid_logger'>logger</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>unless</span> <span class='id identifier rubyid_logger'>logger</span>
@@ -1413,12 +1509,12 @@ result.</p>
       <pre class="lines">
 
 
-23
 24
-25</pre>
+25
+26</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 23</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 24</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_logging?'>logging?</span>
   <span class='kw'>return</span> <span class='op'>!</span><span class='ivar'>@logger</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
@@ -1472,12 +1568,12 @@ result.</p>
       <pre class="lines">
 
 
-68
-69
-70</pre>
+71
+72
+73</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 68</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 71</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_ok?'>ok?</span>
   <span class='kw'>return</span> <span class='ivar'>@result_code</span> <span class='op'>==</span> <span class='const'>RESULT_CODE_OK</span>
@@ -1513,14 +1609,14 @@ result.</p>
       <pre class="lines">
 
 
-89
-90
-91
-92
-93</pre>
+95
+96
+97
+98
+99</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 89</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 95</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_pop'>pop</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>unless</span> <span class='id identifier rubyid_key'>key</span>
@@ -1558,20 +1654,20 @@ result.</p>
       <pre class="lines">
 
 
-76
-77
-78
-79
-80
-81
 82
 83
 84
 85
-86</pre>
+86
+87
+88
+89
+90
+91
+92</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 76</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 82</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_push'>push</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_cmd'>cmd</span><span class='rparen'>)</span>
   <span class='kw'>return</span> <span class='kw'>unless</span> <span class='id identifier rubyid_key'>key</span>
@@ -1615,12 +1711,12 @@ result.</p>
       <pre class="lines">
 
 
-137
-138
-139</pre>
+143
+144
+145</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 137</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 143</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_root_command'>root_command</span><span class='lparen'>(</span><span class='id identifier rubyid_cls'>cls</span><span class='rparen'>)</span>
   <span class='ivar'>@stack</span> <span class='op'>&lt;&lt;</span> <span class='lbrace'>{</span> <span class='label'>key:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>cmd:</span> <span class='id identifier rubyid_cls'>cls</span> <span class='rbrace'>}</span>  <span class='kw'>if</span> <span class='ivar'>@logger</span>
@@ -1656,12 +1752,12 @@ result.</p>
       <pre class="lines">
 
 
-106
-107
-108</pre>
+112
+113
+114</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 106</span>
+      <pre class="code"><span class="info file"># File 'lib/action_command/result.rb', line 112</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_sequence'>sequence</span>
   <span class='kw'>return</span> <span class='ivar'>@sequence</span>
@@ -1676,7 +1772,7 @@ result.</p>
 </div>
 
     <div id="footer">
-  Generated on Mon Mar  7 14:27:17 2016 by
+  Generated on Mon May 16 08:49:39 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

@@ -320,7 +320,7 @@ specific one through <span class='object_link'><a href="ActionCommand/Result.htm
 
 </div>
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>0.1.4</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.5</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">
@@ -1550,7 +1550,7 @@ validations.  See <span class='object_link'><a href="ActionCommand/Executable.ht
 </div>
 
     <div id="footer">
-  Generated on Mon Mar  7 14:27:17 2016 by
+  Generated on Mon May 16 08:49:39 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

@@ -205,7 +205,7 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Mar  7 14:27:16 2016 by
+  Generated on Mon May 16 08:49:38 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

@@ -270,17 +270,57 @@ executions:</p>
 </code></pre>
 
 <p>When logging is on, the logger will receive single-line JSON messages at
-the debugging level for all command inputs and outputs. All child commands
-under a parent will automatically be tagged with a serial number for
-correlation. The result looks like this:</p>
-
-<p>TODO</p>
+the info level for all command inputs and outputs. All child commands under
+a parent will automatically be tagged with a serial number for correlation.
+The result looks like this:</p>
+
+<pre class="code ruby"><code class="ruby">I, [2016-03-07T14:31:53.292843 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;command_input&quot;,&quot;msg&quot;:{&quot;name&quot;:&quot;Chris&quot;,&quot;email&quot;:&quot;test@test.com&quot;,&quot;age&quot;:41}}
+I, [2016-03-07T14:31:53.293007 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;info&quot;,&quot;msg&quot;:&quot;start_transaction&quot;}
+I, [2016-03-07T14:31:53.308212 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;info&quot;,&quot;msg&quot;:&quot;Saved user&quot;}
+I, [2016-03-07T14:31:53.308336 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;command_input&quot;,&quot;msg&quot;:{}}
+I, [2016-03-07T14:31:53.308442 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;info&quot;,&quot;msg&quot;:&quot;in child transaction&quot;}
+I, [2016-03-07T14:31:53.308504 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;command_output&quot;,&quot;msg&quot;:{}}
+I, [2016-03-07T14:31:53.308562 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;info&quot;,&quot;msg&quot;:&quot;end_transaction&quot;}
+I, [2016-03-07T14:31:53.308837 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;command_output&quot;,&quot;msg&quot;:{&quot;user&quot;:{&quot;email&quot;:&quot;test@test.com&quot;,&quot;name&quot;:&quot;Chris&quot;,&quot;age&quot;:41}}}</code></pre>
 
 <p>You can also optionally add your own entries to the log by calling
 <code>result.debug</code>, <code>result.info</code>, or
-<code>result.failed</code>. If you pass these calls a string, they will
-include it as <code>msg</code> in the JSON. If you pass them a hash, its
-contents will be merged into the JSON.</p>
+<code>result.failed</code>. You can pass these calls a string or a hash.</p>
+
+<p>You can use the included LogParser to parse this log if you like, or you
+can use the included PrettyPrintLogAction to print the log in a nested
+plain text format, like:</p>
+
+<pre class="code ruby"><code class="ruby">HelloWorldCommand (8d315fe58dab39cb4f23a9f4ef366c8b)
+    input:
+      name: Chris
+    Hello Chris
+  output:
+    greeting: Hello Chris</code></pre>
+
+<h3 id="label-ActiveRecord+Transactions">ActiveRecord Transactions</h3>
+
+<p>You can wrap your command contents in a transaction by subclassing
+<code>ActionCommand::ExecutableTransaction</code>. You must explicitly
+require <code>action_command/executable_transaction</code> to avoid a
+default dependency on ActiveRecord.</p>
+
+<p>If you call <code>result.failed</code> within a transaction, your
+transaction will automatically be rolled back.</p>
+
+<h3 id="label-Utilities">Utilities</h3>
+
+<p>It is often useful to allow a single parameter to be either an integer
+object id, an instance of the object itself, or a string used to lookup the
+object (used in command-line rake tasks). You can do this using</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='id identifier rubyid_user'>user</span> <span class='op'>=</span> <span class='const'>ActionCommand</span><span class='op'>::</span><span class='const'>Utils</span><span class='period'>.</span><span class='id identifier rubyid_find_object'>find_object</span><span class='lparen'>(</span><span class='const'>User</span><span class='comma'>,</span> <span class='ivar'>@user_id</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_p'>p</span><span class='op'>|</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_find_by_email'>find_by_email</span><span class='lparen'>(</span><span class='id identifier rubyid_p'>p</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
+  <span class='kw'>end</span>
+</code></pre>
+
+<p>This will user User.find if passed an Integer, will return a user object,
+or will yield to the lookup otherwise.</p>
 
 <h2 id="label-Development">Development</h2>
 
@@ -312,7 +352,7 @@ href="http://opensource.org/licenses/MIT">MIT License</a>.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Mon Mar  7 14:27:17 2016 by
+  Generated on Mon May 16 08:49:39 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

@@ -270,17 +270,57 @@ executions:</p>
 </code></pre>
 
 <p>When logging is on, the logger will receive single-line JSON messages at
-the debugging level for all command inputs and outputs. All child commands
-under a parent will automatically be tagged with a serial number for
-correlation. The result looks like this:</p>
-
-<p>TODO</p>
+the info level for all command inputs and outputs. All child commands under
+a parent will automatically be tagged with a serial number for correlation.
+The result looks like this:</p>
+
+<pre class="code ruby"><code class="ruby">I, [2016-03-07T14:31:53.292843 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;command_input&quot;,&quot;msg&quot;:{&quot;name&quot;:&quot;Chris&quot;,&quot;email&quot;:&quot;test@test.com&quot;,&quot;age&quot;:41}}
+I, [2016-03-07T14:31:53.293007 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;info&quot;,&quot;msg&quot;:&quot;start_transaction&quot;}
+I, [2016-03-07T14:31:53.308212 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;info&quot;,&quot;msg&quot;:&quot;Saved user&quot;}
+I, [2016-03-07T14:31:53.308336 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;command_input&quot;,&quot;msg&quot;:{}}
+I, [2016-03-07T14:31:53.308442 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;info&quot;,&quot;msg&quot;:&quot;in child transaction&quot;}
+I, [2016-03-07T14:31:53.308504 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;command_output&quot;,&quot;msg&quot;:{}}
+I, [2016-03-07T14:31:53.308562 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;info&quot;,&quot;msg&quot;:&quot;end_transaction&quot;}
+I, [2016-03-07T14:31:53.308837 #47956]  INFO -- : {&quot;sequence&quot;:&quot;ade3605e40a4d5bf724c5f3d8e43420b&quot;,&quot;cmd&quot;:&quot;CreateUserAction&quot;,&quot;depth&quot;:0,&quot;kind&quot;:&quot;command_output&quot;,&quot;msg&quot;:{&quot;user&quot;:{&quot;email&quot;:&quot;test@test.com&quot;,&quot;name&quot;:&quot;Chris&quot;,&quot;age&quot;:41}}}</code></pre>
 
 <p>You can also optionally add your own entries to the log by calling
 <code>result.debug</code>, <code>result.info</code>, or
-<code>result.failed</code>. If you pass these calls a string, they will
-include it as <code>msg</code> in the JSON. If you pass them a hash, its
-contents will be merged into the JSON.</p>
+<code>result.failed</code>. You can pass these calls a string or a hash.</p>
+
+<p>You can use the included LogParser to parse this log if you like, or you
+can use the included PrettyPrintLogAction to print the log in a nested
+plain text format, like:</p>
+
+<pre class="code ruby"><code class="ruby">HelloWorldCommand (8d315fe58dab39cb4f23a9f4ef366c8b)
+    input:
+      name: Chris
+    Hello Chris
+  output:
+    greeting: Hello Chris</code></pre>
+
+<h3 id="label-ActiveRecord+Transactions">ActiveRecord Transactions</h3>
+
+<p>You can wrap your command contents in a transaction by subclassing
+<code>ActionCommand::ExecutableTransaction</code>. You must explicitly
+require <code>action_command/executable_transaction</code> to avoid a
+default dependency on ActiveRecord.</p>
+
+<p>If you call <code>result.failed</code> within a transaction, your
+transaction will automatically be rolled back.</p>
+
+<h3 id="label-Utilities">Utilities</h3>
+
+<p>It is often useful to allow a single parameter to be either an integer
+object id, an instance of the object itself, or a string used to lookup the
+object (used in command-line rake tasks). You can do this using</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='id identifier rubyid_user'>user</span> <span class='op'>=</span> <span class='const'>ActionCommand</span><span class='op'>::</span><span class='const'>Utils</span><span class='period'>.</span><span class='id identifier rubyid_find_object'>find_object</span><span class='lparen'>(</span><span class='const'>User</span><span class='comma'>,</span> <span class='ivar'>@user_id</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_p'>p</span><span class='op'>|</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_find_by_email'>find_by_email</span><span class='lparen'>(</span><span class='id identifier rubyid_p'>p</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
+  <span class='kw'>end</span>
+</code></pre>
+
+<p>This will user User.find if passed an Integer, will return a user object,
+or will yield to the lookup otherwise.</p>
 
 <h2 id="label-Development">Development</h2>
 
@@ -312,7 +352,7 @@ href="http://opensource.org/licenses/MIT">MIT License</a>.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Mon Mar  7 14:27:16 2016 by
+  Generated on Mon May 16 08:49:38 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/method_list.html

@@ -160,14 +160,14 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="ActionCommand/ExecutableTransaction.html#execute-instance_method" title="ActionCommand::ExecutableTransaction#execute (method)">#execute</a></span>
-    <small>ActionCommand::ExecutableTransaction</small>
+    <span class='object_link'><a href="ActionCommand/Executable.html#execute-instance_method" title="ActionCommand::Executable#execute (method)">#execute</a></span>
+    <small>ActionCommand::Executable</small>
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="ActionCommand/Executable.html#execute-instance_method" title="ActionCommand::Executable#execute (method)">#execute</a></span>
-    <small>ActionCommand::Executable</small>
+    <span class='object_link'><a href="ActionCommand/ExecutableTransaction.html#execute-instance_method" title="ActionCommand::ExecutableTransaction#execute (method)">#execute</a></span>
+    <small>ActionCommand::ExecutableTransaction</small>
   </li>
   
 
@@ -238,26 +238,26 @@
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="ActionCommand/LogParser.html#initialize-instance_method" title="ActionCommand::LogParser#initialize (method)">#initialize</a></span>
-    <small>ActionCommand::LogParser</small>
+    <span class='object_link'><a href="ActionCommand/Result.html#initialize-instance_method" title="ActionCommand::Result#initialize (method)">#initialize</a></span>
+    <small>ActionCommand::Result</small>
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="ActionCommand/Result.html#initialize-instance_method" title="ActionCommand::Result#initialize (method)">#initialize</a></span>
-    <small>ActionCommand::Result</small>
+    <span class='object_link'><a href="ActionCommand/LogParser.html#initialize-instance_method" title="ActionCommand::LogParser#initialize (method)">#initialize</a></span>
+    <small>ActionCommand::LogParser</small>
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="ActionCommand/Executable.html#initialize-instance_method" title="ActionCommand::Executable#initialize (method)">#initialize</a></span>
-    <small>ActionCommand::Executable</small>
+    <span class='object_link'><a href="ActionCommand/InputOutput.html#initialize-instance_method" title="ActionCommand::InputOutput#initialize (method)">#initialize</a></span>
+    <small>ActionCommand::InputOutput</small>
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="ActionCommand/InputOutput.html#initialize-instance_method" title="ActionCommand::InputOutput#initialize (method)">#initialize</a></span>
-    <small>ActionCommand::InputOutput</small>
+    <span class='object_link'><a href="ActionCommand/Executable.html#initialize-instance_method" title="ActionCommand::Executable#initialize (method)">#initialize</a></span>
+    <small>ActionCommand::Executable</small>
   </li>
   
 
@@ -286,14 +286,14 @@
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="ActionCommand/LogMessage.html#key%3F-instance_method" title="ActionCommand::LogMessage#key? (method)">#key?</a></span>
-    <small>ActionCommand::LogMessage</small>
+    <span class='object_link'><a href="ActionCommand/Result.html#key%3F-instance_method" title="ActionCommand::Result#key? (method)">#key?</a></span>
+    <small>ActionCommand::Result</small>
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="ActionCommand/Result.html#key%3F-instance_method" title="ActionCommand::Result#key? (method)">#key?</a></span>
-    <small>ActionCommand::Result</small>
+    <span class='object_link'><a href="ActionCommand/LogMessage.html#key%3F-instance_method" title="ActionCommand::LogMessage#key? (method)">#key?</a></span>
+    <small>ActionCommand::LogMessage</small>
   </li>
   
 
@@ -316,210 +316,216 @@
   
 
   <li class="r1 ">
+    <span class='object_link'><a href="ActionCommand/Result.html#last_error-instance_method" title="ActionCommand::Result#last_error (method)">#last_error</a></span>
+    <small>ActionCommand::Result</small>
+  </li>
+  
+
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/LogMessage.html#line-instance_method" title="ActionCommand::LogMessage#line (method)">#line</a></span>
     <small>ActionCommand::LogMessage</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Result.html#log_input-instance_method" title="ActionCommand::Result#log_input (method)">#log_input</a></span>
     <small>ActionCommand::Result</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/Result.html#log_output-instance_method" title="ActionCommand::Result#log_output (method)">#log_output</a></span>
     <small>ActionCommand::Result</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Result.html#logger%3D-instance_method" title="ActionCommand::Result#logger= (method)">#logger=</a></span>
     <small>ActionCommand::Result</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand.html#logger%3D-class_method" title="ActionCommand.logger= (method)">logger=</a></span>
     <small>ActionCommand</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Result.html#logging%3F-instance_method" title="ActionCommand::Result#logging? (method)">#logging?</a></span>
     <small>ActionCommand::Result</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/LogMessage.html#match_message%3F-instance_method" title="ActionCommand::LogMessage#match_message? (method)">#match_message?</a></span>
     <small>ActionCommand::LogMessage</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/LogMessage.html#msg-instance_method" title="ActionCommand::LogMessage#msg (method)">#msg</a></span>
     <small>ActionCommand::LogMessage</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/LogParser.html#next-instance_method" title="ActionCommand::LogParser#next (method)">#next</a></span>
     <small>ActionCommand::LogParser</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Result.html#ok%3F-instance_method" title="ActionCommand::Result#ok? (method)">#ok?</a></span>
     <small>ActionCommand::Result</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/InputOutput.html#output-instance_method" title="ActionCommand::InputOutput#output (method)">#output</a></span>
     <small>ActionCommand::InputOutput</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Executable.html#parent-instance_method" title="ActionCommand::Executable#parent (method)">#parent</a></span>
     <small>ActionCommand::Executable</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/Result.html#pop-instance_method" title="ActionCommand::Result#pop (method)">#pop</a></span>
     <small>ActionCommand::Result</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/LogMessage.html#populate-instance_method" title="ActionCommand::LogMessage#populate (method)">#populate</a></span>
     <small>ActionCommand::LogMessage</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/InputOutput.html#print_output-instance_method" title="ActionCommand::InputOutput#print_output (method)">#print_output</a></span>
     <small>ActionCommand::InputOutput</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/InputOutput.html#process_input-instance_method" title="ActionCommand::InputOutput#process_input (method)">#process_input</a></span>
     <small>ActionCommand::InputOutput</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/InputOutput.html#process_output-instance_method" title="ActionCommand::InputOutput#process_output (method)">#process_output</a></span>
     <small>ActionCommand::InputOutput</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Result.html#push-instance_method" title="ActionCommand::Result#push (method)">#push</a></span>
     <small>ActionCommand::Result</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/Executable.html#rails_context%3F-instance_method" title="ActionCommand::Executable#rails_context? (method)">#rails_context?</a></span>
     <small>ActionCommand::Executable</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Executable.html#rake_context%3F-instance_method" title="ActionCommand::Executable#rake_context? (method)">#rake_context?</a></span>
     <small>ActionCommand::Executable</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/InputOutput.html#rake_input-instance_method" title="ActionCommand::InputOutput#rake_input (method)">#rake_input</a></span>
     <small>ActionCommand::InputOutput</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Result.html#result_code-instance_method" title="ActionCommand::Result#result_code (method)">#result_code</a></span>
     <small>ActionCommand::Result</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/LogMessage.html#root%3F-instance_method" title="ActionCommand::LogMessage#root? (method)">#root?</a></span>
     <small>ActionCommand::LogMessage</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Result.html#root_command-instance_method" title="ActionCommand::Result#root_command (method)">#root_command</a></span>
     <small>ActionCommand::Result</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/Executable.html#root_context-instance_method" title="ActionCommand::Executable#root_context (method)">#root_context</a></span>
     <small>ActionCommand::Executable</small>
   </li>
   
 
-  <li class="r2 ">
-    <span class='object_link'><a href="ActionCommand/Result.html#sequence-instance_method" title="ActionCommand::Result#sequence (method)">#sequence</a></span>
-    <small>ActionCommand::Result</small>
+  <li class="r1 ">
+    <span class='object_link'><a href="ActionCommand/LogMessage.html#sequence-instance_method" title="ActionCommand::LogMessage#sequence (method)">#sequence</a></span>
+    <small>ActionCommand::LogMessage</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/PrettyPrintLogAction.html#sequence-instance_method" title="ActionCommand::PrettyPrintLogAction#sequence (method)">#sequence</a></span>
     <small>ActionCommand::PrettyPrintLogAction</small>
   </li>
   
 
-  <li class="r2 ">
-    <span class='object_link'><a href="ActionCommand/LogMessage.html#sequence-instance_method" title="ActionCommand::LogMessage#sequence (method)">#sequence</a></span>
-    <small>ActionCommand::LogMessage</small>
+  <li class="r1 ">
+    <span class='object_link'><a href="ActionCommand/Result.html#sequence-instance_method" title="ActionCommand::Result#sequence (method)">#sequence</a></span>
+    <small>ActionCommand::Result</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/InputOutput.html#should_validate-instance_method" title="ActionCommand::InputOutput#should_validate (method)">#should_validate</a></span>
     <small>ActionCommand::InputOutput</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/InputOutput.html#show_help-instance_method" title="ActionCommand::InputOutput#show_help (method)">#show_help</a></span>
     <small>ActionCommand::InputOutput</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/PrettyPrintLogAction.html#source-instance_method" title="ActionCommand::PrettyPrintLogAction#source (method)">#source</a></span>
     <small>ActionCommand::PrettyPrintLogAction</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Executable.html#test-instance_method" title="ActionCommand::Executable#test (method)">#test</a></span>
     <small>ActionCommand::Executable</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/Executable.html#test_context%3F-instance_method" title="ActionCommand::Executable#test_context? (method)">#test_context?</a></span>
     <small>ActionCommand::Executable</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="ActionCommand/Executable.html#testing-instance_method" title="ActionCommand::Executable#testing (method)">#testing</a></span>
     <small>ActionCommand::Executable</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="ActionCommand/InputOutput.html#validate_input-instance_method" title="ActionCommand::InputOutput#validate_input (method)">#validate_input</a></span>
     <small>ActionCommand::InputOutput</small>
   </li>

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Mar  7 14:27:17 2016 by
+  Generated on Mon May 16 08:49:39 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/result.rb

@@ -7,6 +7,7 @@ module ActionCommand
     # By default, a command is ok?
     def initialize
       @result_code = RESULT_CODE_OK
+      @last_error  = nil
       @values = [{}]
       @logger = nil
     end
@@ -52,6 +53,7 @@ module ActionCommand
     # @param msg [String] message describing the failure.
     def failed(msg)
       @result_code = RESULT_CODE_FAILED
+      @last_error  = msg
       error(msg)
     end
     
@@ -61,6 +63,7 @@ module ActionCommand
     # @param result_code [Integer]
     def failed_with_code(msg, result_code)
       @result_code = result_code
+      @last_error = msg
       error(msg)
     end
   
@@ -72,6 +75,9 @@ module ActionCommand
     # @return [Integer] the current result code
     attr_reader :result_code
     
+    # @return [String] the last string error message
+    attr_reader :last_error
+    
     # adds results under the subkey until pop is called
     def push(key, cmd)
       return unless key

data/lib/action_command/version.rb

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

metadata

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