simple-service 0.1.5 → 0.2.1

data/doc/Simple/Service.html

@@ -88,7 +88,7 @@
 <h2>Overview</h2><div class="docstring">
   <div class="discussion">
     
-<p>The <strong>Simple::Service</strong> interface</p>
+<p><strong>The Simple::Service interface</strong></p>
 
 <p>This module implements the main API of the Simple::Service ruby gem.</p>
 <ol><li>
@@ -109,16 +109,19 @@
 <span class='kw'>end</span>
 </code></pre>
 </li><li>
-<p><em>Discover services:</em> To discover services in a service module use the #actions method. This returns a Hash of actions. [TODO] why a Hash?</p>
+<p><em>Discover services:</em> To discover services in a service module use the #actions method. This returns a Hash of actions. </p>
 
 <pre class="code ruby"><code class="ruby">Simple::Service.actions(GodMode)
 =&gt; {:build_universe=&gt;#&lt;Simple::Service::Action...&gt;, ...}
 </code></pre>
-</li><li>
-<p><em>Invoke a service:</em> run <code>Simple::Service.invoke</code> or <code>Simple::Service.invoke2</code>. You must set a context first. </p>
+</li></ol>
+
+<p>TODO: why a Hash? It feels much better if Simple::Service.actions returns an array of names.</p>
+<ol><li>
+<p><em>Invoke a service:</em> run <code>Simple::Service.invoke3</code> or <code>Simple::Service.invoke</code>. You must set a context first.</p>
 
 <pre class="code ruby"><code class="ruby">Simple::Service.with_context do
-  Simple::Service.invoke(GodMode, :build_universe, &quot;TestWorld&quot;, c: 1e9)
+  Simple::Service.invoke3(GodMode, :build_universe, &quot;TestWorld&quot;, c: 1e9)
 end
 =&gt; 42
 </code></pre>
@@ -270,7 +273,7 @@ end
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#invoke-class_method" title="invoke (class method)">.<strong>invoke</strong>(service, name, *args, **named_args)  &#x21d2; Object </a>
+      <a href="#invoke-class_method" title="invoke (class method)">.<strong>invoke</strong>(service, name, args: {}, flags: {})  &#x21d2; Object </a>
     
 
     
@@ -285,7 +288,7 @@ end
 
   
     <span class="summary_desc"><div class='inline'>
-<p>invokes an action with a given <code>name</code> in a service with <code>arguments</code> and <code>params</code>.</p>
+<p><strong>Note:</strong> You cannot call this method if the context is not set.</p>
 </div></span>
   
 </li>
@@ -294,7 +297,7 @@ end
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#invoke2-class_method" title="invoke2 (class method)">.<strong>invoke2</strong>(service, name, args: {}, flags: {})  &#x21d2; Object </a>
+      <a href="#invoke3-class_method" title="invoke3 (class method)">.<strong>invoke3</strong>(service, name, *args, **flags)  &#x21d2; Object </a>
     
 
     
@@ -309,7 +312,7 @@ end
 
   
     <span class="summary_desc"><div class='inline'>
-<p>invokes an action with a given <code>name</code> in a service with a Hash of arguments.</p>
+<p>invokes an action with a given <code>name</code> in a service with <code>args</code> and <code>flags</code>.</p>
 </div></span>
   
 </li>
@@ -356,7 +359,9 @@ end
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'>
+<p>Raises an error if the passed in object is not a service.</p>
+</div></span>
   
 </li>
 
@@ -420,15 +425,15 @@ end
       <pre class="lines">
 
 
-69
-70
-71
-72
-73
-74</pre>
+78
+79
+80
+81
+82
+83</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 69</span>
+      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 78</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_action'>action</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_actions'>actions</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_actions'>actions</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='rparen'>)</span>
@@ -467,14 +472,14 @@ end
       <pre class="lines">
 
 
-62
-63
-64
-65
-66</pre>
+71
+72
+73
+74
+75</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 62</span>
+      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 71</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_actions'>actions</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_verify_service!'>verify_service!</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='rparen'>)</span>
@@ -542,12 +547,12 @@ end
       <pre class="lines">
 
 
-47
-48
-49</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 47</span>
+      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_included'>included</span><span class='lparen'>(</span><span class='id identifier rubyid_klass'>klass</span><span class='rparen'>)</span> <span class='comment'># @private
 </span>  <span class='id identifier rubyid_klass'>klass</span><span class='period'>.</span><span class='id identifier rubyid_extend'>extend</span> <span class='const'><span class='object_link'><a href="Service/ClassMethods.html" title="Simple::Service::ClassMethods (module)">ClassMethods</a></span></span>
@@ -560,7 +565,7 @@ end
       <div class="method_details ">
   <h3 class="signature " id="invoke-class_method">
   
-    .<strong>invoke</strong>(service, name, *args, **named_args)  &#x21d2; <tt>Object</tt> 
+    .<strong>invoke</strong>(service, name, args: {}, flags: {})  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -569,17 +574,7 @@ end
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>invokes an action with a given <code>name</code> in a service with <code>arguments</code> and <code>params</code>.</p>
-
-<p>You cannot call this method if the context is not set.</p>
-
-<p>When calling #invoke using positional arguments they will be matched against positional arguments of the invoked method - but they will not be matched against named arguments.</p>
-
-<p>When there are not enough positional arguments to match the number of required positional arguments of the method we raise an ArgumentError.</p>
-
-<p>When there are more positional arguments provided than the number accepted by the method we raise an ArgumentError.</p>
-
-<p>Entries in the named_args Hash that are not defined in the action itself are ignored.</p>
+<p><strong>Note:</strong> You cannot call this method if the context is not set.</p>
 
 
   </div>
@@ -606,19 +601,27 @@ end
       <pre class="lines">
 
 
-91
-92
-93
-94
-95</pre>
+141
+142
+143
+144
+145
+146
+147
+148
+149</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 91</span>
+      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 141</span>
+
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_invoke'>invoke</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='label'>args:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='label'>flags:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="Service/ContextMissingError.html" title="Simple::Service::ContextMissingError (class)">ContextMissingError</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Need to set context before calling ::Simple::Service.invoke3</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_context'>context</span>
 
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_invoke'>invoke</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_named_args'>named_args</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="Service/ContextMissingError.html" title="Simple::Service::ContextMissingError (class)">ContextMissingError</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Need to set context before calling ::Simple::Service.invoke</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_context'>context</span>
+  <span class='id identifier rubyid_expect!'>expect!</span> <span class='id identifier rubyid_args'>args</span> <span class='op'>=&gt;</span> <span class='lbracket'>[</span><span class='const'>Hash</span><span class='comma'>,</span> <span class='const'>Array</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='label'>flags:</span> <span class='const'>Hash</span>
+  <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_keys'>keys</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_key'>key</span><span class='op'>|</span> <span class='id identifier rubyid_expect!'>expect!</span> <span class='id identifier rubyid_key'>key</span> <span class='op'>=&gt;</span> <span class='const'>String</span> <span class='rbrace'>}</span> <span class='kw'>if</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Hash</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_flags'>flags</span><span class='period'>.</span><span class='id identifier rubyid_keys'>keys</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_key'>key</span><span class='op'>|</span> <span class='id identifier rubyid_expect!'>expect!</span> <span class='id identifier rubyid_key'>key</span> <span class='op'>=&gt;</span> <span class='const'>String</span> <span class='rbrace'>}</span>
 
-  <span class='id identifier rubyid_action'>action</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_invoke'>invoke</span><span class='lparen'>(</span><span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_named_args'>named_args</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_action'>action</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_invoke'>invoke</span><span class='lparen'>(</span><span class='label'>args:</span> <span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='label'>flags:</span> <span class='id identifier rubyid_flags'>flags</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -626,9 +629,9 @@ end
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="invoke2-class_method">
+  <h3 class="signature " id="invoke3-class_method">
   
-    .<strong>invoke2</strong>(service, name, args: {}, flags: {})  &#x21d2; <tt>Object</tt> 
+    .<strong>invoke3</strong>(service, name, *args, **flags)  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -637,28 +640,19 @@ end
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>invokes an action with a given <code>name</code> in a service with a Hash of arguments.</p>
+<p>invokes an action with a given <code>name</code> in a service with <code>args</code> and <code>flags</code>.</p>
+
+<p>This is a helper method which one can use to easily call an action from ruby source code.</p>
+
+<p>As the main purpose of this module is to call services with outside data, the <code>.invoke</code> action is usually preferred.</p>
 
-<p>You cannot call this method if the context is not set.</p>
+<p><strong>Note:</strong> You cannot call this method if the context is not set.</p>
 
 
   </div>
 </div>
 <div class="tags">
   
-<p class="tag_title">Raises:</p>
-<ul class="raise">
-  
-    <li>
-      
-      
-        <span class='type'>(<tt><span class='object_link'><a href="Service/ContextMissingError.html" title="Simple::Service::ContextMissingError (class)">ContextMissingError</a></span></tt>)</span>
-      
-      
-      
-    </li>
-  
-</ul>
 
 </div><table class="source_code">
   <tr>
@@ -666,19 +660,17 @@ end
       <pre class="lines">
 
 
-100
-101
-102
-103
-104</pre>
+94
+95
+96
+97</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 100</span>
+      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 94</span>
 
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_invoke2'>invoke2</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='label'>args:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='label'>flags:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_raise'>raise</span> <span class='const'><span class='object_link'><a href="Service/ContextMissingError.html" title="Simple::Service::ContextMissingError (class)">ContextMissingError</a></span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Need to set context before calling ::Simple::Service.invoke</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_context'>context</span>
-
-  <span class='id identifier rubyid_action'>action</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_invoke2'>invoke2</span><span class='lparen'>(</span><span class='label'>args:</span> <span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='label'>flags:</span> <span class='id identifier rubyid_flags'>flags</span><span class='rparen'>)</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_invoke3'>invoke3</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_flags'>flags</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_flags'>flags</span> <span class='op'>=</span> <span class='id identifier rubyid_flags'>flags</span><span class='period'>.</span><span class='id identifier rubyid_each_with_object'>each_with_object</span><span class='lparen'>(</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='lparen'>(</span><span class='id identifier rubyid_k'>k</span><span class='comma'>,</span> <span class='id identifier rubyid_v'>v</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_hsh'>hsh</span><span class='op'>|</span> <span class='id identifier rubyid_hsh'>hsh</span><span class='lbracket'>[</span><span class='id identifier rubyid_k'>k</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_v'>v</span> <span class='rbrace'>}</span>
+  <span class='id identifier rubyid_invoke'>invoke</span> <span class='id identifier rubyid_service'>service</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='label'>args:</span> <span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='label'>flags:</span> <span class='id identifier rubyid_flags'>flags</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -699,6 +691,8 @@ end
     
 <p>returns true if the passed in object is a service module.</p>
 
+<p>A service must be a module, and it must include the Simple::Service module.</p>
+
 
   </div>
 </div>
@@ -724,15 +718,21 @@ end
       <pre class="lines">
 
 
-52
-53
-54</pre>
+57
+58
+59
+60
+61
+62</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 52</span>
+      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 57</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_service?'>service?</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_service'>service</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Module</span><span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_service'>service</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span><span class='lparen'>(</span><span class='kw'>self</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_verify_service!'>verify_service!</span> <span class='id identifier rubyid_service'>service</span>
+  <span class='kw'>true</span>
+<span class='kw'>rescue</span> <span class='op'>::</span><span class='const'>ArgumentError</span>
+  <span class='kw'>false</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -751,6 +751,8 @@ end
 </h3><div class="docstring">
   <div class="discussion">
     
+<p>Raises an error if the passed in object is not a service</p>
+
 
   </div>
 </div>
@@ -776,17 +778,17 @@ end
       <pre class="lines">
 
 
-56
-57
-58
-59</pre>
+65
+66
+67
+68</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 56</span>
+      <pre class="code"><span class="info file"># File 'lib/simple/service.rb', line 65</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_verify_service!'>verify_service!</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='rparen'>)</span> <span class='comment'># @private
 </span>  <span class='id identifier rubyid_raise'>raise</span> <span class='op'>::</span><span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_service'>service</span><span class='period'>.</span><span class='id identifier rubyid_inspect'>inspect</span><span class='embexpr_end'>}</span><span class='tstring_content'> must be a Simple::Service, but is not even a Module</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_service'>service</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Module</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_raise'>raise</span> <span class='op'>::</span><span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_service'>service</span><span class='period'>.</span><span class='id identifier rubyid_inspect'>inspect</span><span class='embexpr_end'>}</span><span class='tstring_content'> must be a Simple::Service, did you &#39;include Simple::Service&#39;</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_service?'>service?</span><span class='lparen'>(</span><span class='id identifier rubyid_service'>service</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_raise'>raise</span> <span class='op'>::</span><span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_service'>service</span><span class='period'>.</span><span class='id identifier rubyid_inspect'>inspect</span><span class='embexpr_end'>}</span><span class='tstring_content'> must be a Simple::Service, did you &#39;include Simple::Service&#39;</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_service'>service</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span><span class='lparen'>(</span><span class='kw'>self</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -853,7 +855,7 @@ end
 </div>
 
       <div id="footer">
-  Generated on Tue Dec  3 13:46:26 2019 by
+  Generated on Wed Dec  4 22:57:13 2019 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.20 (ruby-2.5.1).
 </div>

data/doc/Simple.html

@@ -107,7 +107,7 @@
 </div>
 
       <div id="footer">
-  Generated on Tue Dec  3 13:46:26 2019 by
+  Generated on Wed Dec  4 22:57:12 2019 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.20 (ruby-2.5.1).
 </div>

data/doc/_index.html

@@ -63,6 +63,9 @@
     <li class="r1"><a href="index.html" title="README">README</a></li>
     
   
+    <li class="r2"><a href="file.TODO.html" title="TODO">TODO</a></li>
+    
+  
   </ul>
 
 <div class="clear"></div>
@@ -178,21 +181,6 @@
         </ul>
       
         
-        <ul id="alpha_I" class="alpha">
-          <li class="letter">I</li>
-          <ul>
-            
-              <li>
-                <span class='object_link'><a href="Simple/Service/Action/IndieHash.html" title="Simple::Service::Action::IndieHash (class)">IndieHash</a></span>
-                
-                  <small>(Simple::Service::Action)</small>
-                
-              </li>
-            
-          </ul>
-        </ul>
-      
-        
         <ul id="alpha_M" class="alpha">
           <li class="letter">M</li>
           <ul>
@@ -230,9 +218,6 @@
         </ul>
       
         
-          </td><td valign='top' width="33%">
-          
-        
         <ul id="alpha_P" class="alpha">
           <li class="letter">P</li>
           <ul>
@@ -248,6 +233,9 @@
         </ul>
       
         
+          </td><td valign='top' width="33%">
+          
+        
         <ul id="alpha_S" class="alpha">
           <li class="letter">S</li>
           <ul>
@@ -276,7 +264,7 @@
 </div>
 
       <div id="footer">
-  Generated on Tue Dec  3 13:46:26 2019 by
+  Generated on Wed Dec  4 22:57:12 2019 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.20 (ruby-2.5.1).
 </div>

data/doc/class_list.html

@@ -43,7 +43,7 @@
 
       <ul id="full_list" class="class">
         <li id="object_" class="odd"><div class="item" style="padding-left:30px"><span class='object_link'><a href="top-level-namespace.html" title="Top Level Namespace (root)">Top Level Namespace</a></span></div></li>
-<li id='object_Simple' class='even'><div class='item' style='padding-left:30px'><a class='toggle'></a> <span class='object_link'><a href="Simple.html" title="Simple (module)">Simple</a></span><small class='search_info'>Top Level Namespace</small></div><ul><li id='object_Simple::Service' class='collapsed odd'><div class='item' style='padding-left:45px'><a class='toggle'></a> <span class='object_link'><a href="Simple/Service.html" title="Simple::Service (module)">Service</a></span><small class='search_info'>Simple</small></div><ul><li id='object_Simple::Service::Action' class='collapsed'><div class='item' style='padding-left:60px'><a class='toggle'></a> <span class='object_link'><a href="Simple/Service/Action.html" title="Simple::Service::Action (class)">Action</a></span> &lt; Object<small class='search_info'>Simple::Service</small></div><ul><li id='object_Simple::Service::Action::Comment' class='collapsed'><div class='item' style='padding-left:75px'><a class='toggle'></a> <span class='object_link'><a href="Simple/Service/Action/Comment.html" title="Simple::Service::Action::Comment (class)">Comment</a></span> &lt; Object<small class='search_info'>Simple::Service::Action</small></div><ul><li id='object_Simple::Service::Action::Comment::Extractor' class='collapsed'><div class='item' style='padding-left:90px'><span class='object_link'><a href="Simple/Service/Action/Comment/Extractor.html" title="Simple::Service::Action::Comment::Extractor (module)">Extractor</a></span><small class='search_info'>Simple::Service::Action::Comment</small></div></li></ul></li><li id='object_Simple::Service::Action::IndieHash' class='collapsed'><div class='item' style='padding-left:75px'><span class='object_link'><a href="Simple/Service/Action/IndieHash.html" title="Simple::Service::Action::IndieHash (class)">IndieHash</a></span> &lt; Object<small class='search_info'>Simple::Service::Action</small></div></li><li id='object_Simple::Service::Action::MethodReflection' class='collapsed'><div class='item' style='padding-left:75px'><span class='object_link'><a href="Simple/Service/Action/MethodReflection.html" title="Simple::Service::Action::MethodReflection (module)">MethodReflection</a></span><small class='search_info'>Simple::Service::Action</small></div></li><li id='object_Simple::Service::Action::Parameter' class='collapsed'><div class='item' style='padding-left:75px'><span class='object_link'><a href="Simple/Service/Action/Parameter.html" title="Simple::Service::Action::Parameter (class)">Parameter</a></span> &lt; Object<small class='search_info'>Simple::Service::Action</small></div></li></ul></li><li id='object_Simple::Service::ArgumentError' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/ArgumentError.html" title="Simple::Service::ArgumentError (class)">ArgumentError</a></span> &lt; ArgumentError<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::ClassMethods' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/ClassMethods.html" title="Simple::Service::ClassMethods (module)">ClassMethods</a></span><small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::Context' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/Context.html" title="Simple::Service::Context (class)">Context</a></span> &lt; Object<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::ContextMissingError' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/ContextMissingError.html" title="Simple::Service::ContextMissingError (class)">ContextMissingError</a></span> &lt; StandardError<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::ContextReadOnlyError' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/ContextReadOnlyError.html" title="Simple::Service::ContextReadOnlyError (class)">ContextReadOnlyError</a></span> &lt; StandardError<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::ExtraArguments' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/ExtraArguments.html" title="Simple::Service::ExtraArguments (class)">ExtraArguments</a></span> &lt; ArgumentError<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::GemHelper' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/GemHelper.html" title="Simple::Service::GemHelper (module)">GemHelper</a></span><small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::MissingArguments' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/MissingArguments.html" title="Simple::Service::MissingArguments (class)">MissingArguments</a></span> &lt; ArgumentError<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::NoSuchAction' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/NoSuchAction.html" title="Simple::Service::NoSuchAction (class)">NoSuchAction</a></span> &lt; ArgumentError<small class='search_info'>Simple::Service</small></div></li></ul></li></ul></li>
+<li id='object_Simple' class='even'><div class='item' style='padding-left:30px'><a class='toggle'></a> <span class='object_link'><a href="Simple.html" title="Simple (module)">Simple</a></span><small class='search_info'>Top Level Namespace</small></div><ul><li id='object_Simple::Service' class='collapsed odd'><div class='item' style='padding-left:45px'><a class='toggle'></a> <span class='object_link'><a href="Simple/Service.html" title="Simple::Service (module)">Service</a></span><small class='search_info'>Simple</small></div><ul><li id='object_Simple::Service::Action' class='collapsed'><div class='item' style='padding-left:60px'><a class='toggle'></a> <span class='object_link'><a href="Simple/Service/Action.html" title="Simple::Service::Action (class)">Action</a></span> &lt; Object<small class='search_info'>Simple::Service</small></div><ul><li id='object_Simple::Service::Action::Comment' class='collapsed'><div class='item' style='padding-left:75px'><a class='toggle'></a> <span class='object_link'><a href="Simple/Service/Action/Comment.html" title="Simple::Service::Action::Comment (class)">Comment</a></span> &lt; Object<small class='search_info'>Simple::Service::Action</small></div><ul><li id='object_Simple::Service::Action::Comment::Extractor' class='collapsed'><div class='item' style='padding-left:90px'><span class='object_link'><a href="Simple/Service/Action/Comment/Extractor.html" title="Simple::Service::Action::Comment::Extractor (module)">Extractor</a></span><small class='search_info'>Simple::Service::Action::Comment</small></div></li></ul></li><li id='object_Simple::Service::Action::MethodReflection' class='collapsed'><div class='item' style='padding-left:75px'><span class='object_link'><a href="Simple/Service/Action/MethodReflection.html" title="Simple::Service::Action::MethodReflection (module)">MethodReflection</a></span><small class='search_info'>Simple::Service::Action</small></div></li><li id='object_Simple::Service::Action::Parameter' class='collapsed'><div class='item' style='padding-left:75px'><span class='object_link'><a href="Simple/Service/Action/Parameter.html" title="Simple::Service::Action::Parameter (class)">Parameter</a></span> &lt; Object<small class='search_info'>Simple::Service::Action</small></div></li></ul></li><li id='object_Simple::Service::ArgumentError' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/ArgumentError.html" title="Simple::Service::ArgumentError (class)">ArgumentError</a></span> &lt; ArgumentError<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::ClassMethods' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/ClassMethods.html" title="Simple::Service::ClassMethods (module)">ClassMethods</a></span><small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::Context' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/Context.html" title="Simple::Service::Context (class)">Context</a></span> &lt; Object<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::ContextMissingError' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/ContextMissingError.html" title="Simple::Service::ContextMissingError (class)">ContextMissingError</a></span> &lt; StandardError<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::ContextReadOnlyError' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/ContextReadOnlyError.html" title="Simple::Service::ContextReadOnlyError (class)">ContextReadOnlyError</a></span> &lt; StandardError<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::ExtraArguments' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/ExtraArguments.html" title="Simple::Service::ExtraArguments (class)">ExtraArguments</a></span> &lt; ArgumentError<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::GemHelper' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/GemHelper.html" title="Simple::Service::GemHelper (module)">GemHelper</a></span><small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::MissingArguments' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/MissingArguments.html" title="Simple::Service::MissingArguments (class)">MissingArguments</a></span> &lt; ArgumentError<small class='search_info'>Simple::Service</small></div></li><li id='object_Simple::Service::NoSuchAction' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Simple/Service/NoSuchAction.html" title="Simple::Service::NoSuchAction (class)">NoSuchAction</a></span> &lt; ArgumentError<small class='search_info'>Simple::Service</small></div></li></ul></li></ul></li>
 
       </ul>
     </div>

data/doc/file.README.html

@@ -111,7 +111,7 @@
 <p>If the calling site, however, has <strong>named arguments</strong> (in a Hash), one would invoke a service using <code>invoke2</code>. This is used for HTTPD integration (with <code>simple-httpd</code>.)</p>
 
 <pre class="code ruby"><code class="ruby">  <span class='id identifier rubyid_args'>args</span> <span class='op'>=</span> <span class='lbrace'>{</span> <span class='label'>name:</span>  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>My Universe</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>c:</span> <span class='int'>299792458</span><span class='rbrace'>}</span>
-  <span class='const'><span class='object_link'><a href="Simple.html" title="Simple (module)">Simple</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Simple/Service.html" title="Simple::Service (module)">Service</a></span></span><span class='period'>.</span><span class='id identifier rubyid_invoke2'><span class='object_link'><a href="Simple/Service.html#invoke2-class_method" title="Simple::Service.invoke2 (method)">invoke2</a></span></span> <span class='const'>GodMode</span><span class='comma'>,</span> 
+  <span class='const'><span class='object_link'><a href="Simple.html" title="Simple (module)">Simple</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Simple/Service.html" title="Simple::Service (module)">Service</a></span></span><span class='period'>.</span><span class='id identifier rubyid_invoke2'>invoke2</span> <span class='const'>GodMode</span><span class='comma'>,</span> 
                           <span class='symbol'>:build_universe</span><span class='comma'>,</span> 
                           <span class='label'>args:</span> <span class='id identifier rubyid_args'>args</span>
 </code></pre>
@@ -122,7 +122,7 @@
 
 <pre class="code ruby"><code class="ruby"><span class='const'><span class='object_link'><a href="Simple.html" title="Simple (module)">Simple</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Simple/Service.html" title="Simple::Service (module)">Service</a></span></span><span class='period'>.</span><span class='id identifier rubyid_with_context'><span class='object_link'><a href="Simple/Service.html#with_context-class_method" title="Simple::Service.with_context (method)">with_context</a></span></span><span class='lparen'>(</span><span class='kw'>nil</span><span class='rparen'>)</span> <span class='kw'>do</span>
     <span class='id identifier rubyid_args'>args</span> <span class='op'>=</span> <span class='lbrace'>{</span> <span class='label'>name:</span>  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>My Universe</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>c:</span> <span class='int'>299792458</span><span class='rbrace'>}</span>
-    <span class='const'><span class='object_link'><a href="Simple.html" title="Simple (module)">Simple</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Simple/Service.html" title="Simple::Service (module)">Service</a></span></span><span class='period'>.</span><span class='id identifier rubyid_invoke2'><span class='object_link'><a href="Simple/Service.html#invoke2-class_method" title="Simple::Service.invoke2 (method)">invoke2</a></span></span> <span class='const'>GodMode</span><span class='comma'>,</span> 
+    <span class='const'><span class='object_link'><a href="Simple.html" title="Simple (module)">Simple</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Simple/Service.html" title="Simple::Service (module)">Service</a></span></span><span class='period'>.</span><span class='id identifier rubyid_invoke2'>invoke2</span> <span class='const'>GodMode</span><span class='comma'>,</span> 
                             <span class='symbol'>:build_universe</span><span class='comma'>,</span>
                             <span class='label'>args:</span> <span class='id identifier rubyid_args'>args</span>
 <span class='kw'>end</span>
@@ -136,7 +136,7 @@
 </div></div>
 
       <div id="footer">
-  Generated on Tue Dec  3 13:46:26 2019 by
+  Generated on Wed Dec  4 22:57:12 2019 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.20 (ruby-2.5.1).
 </div>

data/doc/file.TODO.html

@@ -0,0 +1,70 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>
+  File: TODO
+  
+    &mdash; Documentation by YARD 0.9.20
+  
+</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">
+  pathId = "TODO";
+  relpath = '';
+</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 class="nav_wrap">
+      <iframe id="nav" src="file_list.html?1"></iframe>
+      <div id="resizer"></div>
+    </div>
+
+    <div id="main" tabindex="-1">
+      <div id="header">
+        <div id="menu">
+  
+    <a href="_index.html">Index</a> &raquo; 
+    <span class="title">File: TODO</span>
+  
+</div>
+
+        <div id="search">
+  
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+
+        <svg width="24" height="24">
+          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
+        </svg>
+    </a>
+  
+</div>
+        <div class="clear"></div>
+      </div>
+
+      <div id="content"><div id='filecontents'>lib/simple/service.rb<br/>    39  why a Hash? It feels much better if Simple::Service.actions returns<br/>        an array of names.</div></div>
+
+      <div id="footer">
+  Generated on Wed Dec  4 22:57:12 2019 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.20 (ruby-2.5.1).
+</div>
+
+    </div>
+  </body>
+</html>

data/doc/file_list.html

@@ -49,6 +49,11 @@
   </li>
   
 
+  <li id="object_TODO" class="even">
+    <div class="item"><span class="object_link"><a href="file.TODO.html" title="TODO">TODO</a></span></div>
+  </li>
+  
+
 
       </ul>
     </div>