humidifier-reservoir 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d7d20aa3a279e1a06147c7d6a1f7bcdce6b64817
-  data.tar.gz: b53f34b255a333ed55426654b0395268e9925bc1
+  metadata.gz: ea83f857a6387b910a95b9c53538c4ff6851ae41
+  data.tar.gz: d1b405d712ae121e8971c32723d710c19d335f60
 SHA512:
-  metadata.gz: 7000ae7f9d8768d1fa793ab62585937bfc6e93c432bd2b4a0dd0d11ef4797af65f87a4382e4921877a7ab407897a791794c1608d2d1f6a0d5fd8b3abe13c45ee
-  data.tar.gz: bfc1e3fac90140b7e1fd2b50831242307bbd5e991ebbaf39205497da00842e8f3ad4752565a845712b451e1aeb2aff5d59e8539472fdec8af7721d8264c66327
+  metadata.gz: 0c02c9fe112c7c92f9d8347a33a5d215cdc2e27c12285794c5f39db74091632de4d6132c7f8436131717ad7cb484f3c2efae720ba8d88de183d03bd434cbea0b
+  data.tar.gz: f2271e19b9b510850d9df2ddbc7ff7c064fe0e9048c686339bef439bd3491c09b79bcf2b527608ef02fd585aba8370e98f2acde715668dced2919a61d5e8b3e4

data/.rubocop.yml

@@ -5,12 +5,12 @@ AllCops:
   Exclude:
   - 'vendor/**/*'
 
+Layout/IndentHeredoc:
+  Enabled: false
+
 Metrics/LineLength:
   Max: 100
 
-Style/IndentHeredoc:
-  Enabled: false
-
 Style/PercentLiteralDelimiters:
   PreferredDelimiters:
     default: '[]'

data/README.md

@@ -113,6 +113,100 @@ Now that you've configured your CLI, your resources, and your mappers, you can u
 
 Each command has an `--aws-profile` (or `-p`) option for specifying which profile to authenticate against when querying AWS. You should ensure that this profile has the correct permissions for creating whatever resources are going to part of your stack. You can also rely on the `AWS_*` environment variables, or the EC2 instance profile if you're deploying from an instance. For more information, see the [AWS docs](http://docs.aws.amazon.com/sdkforruby/api/) under the "Configuration" section.
 
+#### --prefix
+
+The `deploy` command also allows a `--prefix` command line argument that will override the default prefix (if one is configured) for the stack that is being deployed. This is especially useful when you're deploying multiple copies of the same stack (for instance, multiple autoscaling groups) that have different purposes or semantically mean newer versions of resources.
+
+### Shortcuts
+
+A couple of convenient shortcuts are built into `humidifier-reservoir` so that writing templates and mappers both can be more concise.
+
+#### Automatic id properties
+
+There are a lot of properties in the AWS CloudFormation resource specification that are simply pointers to other entities within the AWS ecosystem. For example, an `AWS::EC2::VPCGatewayAttachment` entity has a `VpcId` property that represents the ID of the associated `AWS::EC2::VPC`.
+
+Because this pattern is so common, `humidifier-reservoir` detects all properties ending in `Id` and allows you to specify them without the suffix. If you choose to use this format, `humidifier-reservoir` will automatically turn that value into a [CloudFormation resource reference](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html).
+
+#### Anonymous mappers
+
+A lot of the time, mappers that you create will not be overly complicated, especially if you're using the aforementioned automatic id properties. Therefore, the `config.map` method takes a block, and allows you to specify the mapper inline. This is recommended for mappers that aren't too complicates as to warrant their own class (for instance, for testing purposes). An example of this using the `UserMapper` from above is below:
+
+```ruby
+Humidifier::Reservoir.configure do |config|
+  config.map :users, to: 'AWS::IAM::User' do
+    GROUPS = {
+      'eng' => %w[Engineering Testing Deployment],
+      'admin' => %w[Management Administration]
+    }
+
+    defaults do |logical_name|
+      { path: '/reservoir/', user_name: logical_name }
+    end
+
+    attribute :group do |group|
+      groups = GROUPS[group]
+      groups.any? ? { groups: GROUPS[group] } : {}
+    end
+  end
+end
+```
+
+#### Cross-stack references
+
+AWS allows cross-stack references through the [intrinsic `Fn::ImportValue` function](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-importvalue.html). You can take advantage of this with `humidifier-reservoir` by using the `export: true` option on resources in your stacks. For instance, if in one stack you have a subnet that you need to reference in another, you could (`stacks/vpc/subnets.yml`):
+
+```yaml
+ProductionPrivateSubnet2a:
+  vpc: ProductionVPC
+  cidr_block: 10.0.0.0/19
+  availability_zone: us-west-2a
+  export: true
+
+ProductionPrivateSubnet2b:
+  vpc: ProductionVPC
+  cidr_block: 10.0.64.0/19
+  availability_zone: us-west-2b
+  export: true
+
+ProductionPrivateSubnet2c:
+  vpc: ProductionVPC
+  cidr_block: 10.0.128.0/19
+  availability_zone: us-west-2c
+  export: true
+```
+
+And then in another stack, you could reference those values (`stacks/rds/db_subnets_groups.yml`):
+
+```yaml
+ProductionDBSubnetGroup:
+  db_subnet_group_description: Production DB private subnet group
+  subnets:
+  - ProductionPrivateSubnet2a
+  - ProductionPrivateSubnet2b
+  - ProductionPrivateSubnet2c
+```
+
+Within the configuration, you would specify to use the `Fn::ImportValue` function like so:
+
+```ruby
+Humidifier::Reservoir.configure do |config|
+  config.stack_path = 'stacks'
+
+  config.map :subnets, to: 'EC2::Subnet'
+
+  config.map :db_subnet_groups, to: 'RDS::DBSubnetGroup' do
+    attribute :subnets do |subnet_names|
+      subnet_ids =
+        subnet_names.map do |subnet_name|
+          Humidifier.fn.import_value(subnet_name)
+        end
+
+      { subnet_ids: subnet_ids }
+    end
+  end
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/docs/Humidifier.html

@@ -107,9 +107,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sun Oct  1 09:25:22 2017 by
+  Generated on Wed Nov  8 13:26:15 2017 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.9 (ruby-2.4.1).
+  0.9.9 (ruby-2.4.2).
 </div>
 
     </div>

data/docs/Humidifier/Reservoir.html

@@ -124,7 +124,7 @@
 
 </div>
       </dt>
-      <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>0.1.0</span><span class='tstring_end'>&#39;</span></span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre></dd>
+      <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>0.2.0</span><span class='tstring_end'>&#39;</span></span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre></dd>
     
   </dl>
 
@@ -490,9 +490,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sun Oct  1 09:25:22 2017 by
+  Generated on Wed Nov  8 13:26:15 2017 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.9 (ruby-2.4.1).
+  0.9.9 (ruby-2.4.2).
 </div>
 
     </div>

data/docs/Humidifier/Reservoir/BaseMapper.html

@@ -115,6 +115,28 @@ specifying custom attributes.</p>
   
 
 </div>
+  <h2>Constant Summary</h2>
+  <dl class="constants">
+    
+      <dt id="COMMON_ATTRIBUTES-constant" class="">COMMON_ATTRIBUTES =
+        <div class="docstring">
+  <div class="discussion">
+    
+<p>The list of attributes that are common to all resources that need to be
+handles separately.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div>
+      </dt>
+      <dd><pre class="code"><span class='const'>Resource</span><span class='op'>::</span><span class='const'>COMMON_ATTRIBUTES</span><span class='period'>.</span><span class='id identifier rubyid_values'>values</span></pre></dd>
+    
+  </dl>
+
 
 
 
@@ -281,13 +303,13 @@ to the groups attribute after some transformation.</p>
       <pre class="lines">
 
 
-21
-22
-23
-24</pre>
+25
+26
+27
+28</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/base_mapper.rb', line 21</span>
+      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/base_mapper.rb', line 25</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_attribute'>attribute</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_define_method'>define_method</span><span class='lparen'>(</span><span class='symbol'>:attribute_</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
@@ -324,12 +346,12 @@ to the groups attribute after some transformation.</p>
       <pre class="lines">
 
 
-27
-28
-29</pre>
+31
+32
+33</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/base_mapper.rb', line 27</span>
+      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/base_mapper.rb', line 31</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_attribute_methods'>attribute_methods</span>
   <span class='ivar'>@attribute_methods</span> <span class='op'>||=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
@@ -375,12 +397,12 @@ based on the logical name.</p>
       <pre class="lines">
 
 
-41
-42
-43</pre>
+45
+46
+47</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/base_mapper.rb', line 41</span>
+      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/base_mapper.rb', line 45</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_defaults'>defaults</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_define_method'>define_method</span><span class='lparen'>(</span><span class='symbol'>:attribute_defaults</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
@@ -423,19 +445,35 @@ logical name for the resource, and the user-specified attributes.</p>
       <pre class="lines">
 
 
-48
-49
-50
-51
-52</pre>
+52
+53
+54
+55
+56
+57
+58
+59
+60
+61
+62
+63
+64</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/base_mapper.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/base_mapper.rb', line 52</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_resource_for'>resource_for</span><span class='lparen'>(</span><span class='id identifier rubyid_clazz'>clazz</span><span class='comma'>,</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_attributes'>attributes</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_mapped'>mapped</span> <span class='op'>=</span> <span class='id identifier rubyid_respond_to?'>respond_to?</span><span class='lparen'>(</span><span class='symbol'>:attribute_defaults</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='id identifier rubyid_attribute_defaults'>attribute_defaults</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span> <span class='op'>:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
-  <span class='id identifier rubyid_attributes'>attributes</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='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='op'>|</span> <span class='id identifier rubyid_mapped'>mapped</span><span class='period'>.</span><span class='id identifier rubyid_merge!'>merge!</span><span class='lparen'>(</span><span class='id identifier rubyid_mapped_from'>mapped_from</span><span class='lparen'>(</span><span class='id identifier rubyid_clazz'>clazz</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
-  <span class='id identifier rubyid_clazz'>clazz</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_mapped'>mapped</span><span class='rparen'>)</span>
+
+  <span class='id identifier rubyid_attributes'>attributes</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='op'>|</span>
+    <span class='id identifier rubyid_mapped'>mapped</span><span class='period'>.</span><span class='id identifier rubyid_merge!'>merge!</span><span class='lparen'>(</span><span class='id identifier rubyid_mapped_from'>mapped_from</span><span class='lparen'>(</span><span class='id identifier rubyid_clazz'>clazz</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span><span class='rparen'>)</span>
+  <span class='kw'>end</span>
+
+  <span class='id identifier rubyid_common_attributes'>common_attributes</span> <span class='op'>=</span> <span class='id identifier rubyid_common_attributes_from'>common_attributes_from</span><span class='lparen'>(</span><span class='id identifier rubyid_mapped'>mapped</span><span class='rparen'>)</span>
+
+  <span class='id identifier rubyid_resource'>resource</span> <span class='op'>=</span> <span class='id identifier rubyid_clazz'>clazz</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_mapped'>mapped</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_resource'>resource</span><span class='period'>.</span><span class='id identifier rubyid_update_attributes'>update_attributes</span><span class='lparen'>(</span><span class='id identifier rubyid_common_attributes'>common_attributes</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_resource'>resource</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -447,9 +485,9 @@ logical name for the resource, and the user-specified attributes.</p>
 </div>
 
       <div id="footer">
-  Generated on Sun Oct  1 09:25:22 2017 by
+  Generated on Wed Nov  8 13:26:16 2017 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.9 (ruby-2.4.1).
+  0.9.9 (ruby-2.4.2).
 </div>
 
     </div>

data/docs/Humidifier/Reservoir/CLI.html

@@ -131,6 +131,28 @@ about.</p>
         <li class="public ">
   <span class="summary_signature">
     
+      <a href="#change-instance_method" title="#change (instance method)">#<strong>change</strong>(name = nil)  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'></div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
       <a href="#deploy-instance_method" title="#deploy (instance method)">#<strong>deploy</strong>(name = nil)  &#x21d2; Object </a>
     
 
@@ -205,9 +227,9 @@ about.</p>
 
     
       <div class="method_details first">
-  <h3 class="signature first" id="deploy-instance_method">
+  <h3 class="signature first" id="change-instance_method">
   
-    #<strong>deploy</strong>(name = nil)  &#x21d2; <tt>Object</tt> 
+    #<strong>change</strong>(name = nil)  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -219,6 +241,7 @@ about.</p>
       <pre class="lines">
 
 
+12
 13
 14
 15
@@ -227,18 +250,61 @@ about.</p>
 18
 19
 20
-21
-22</pre>
+21</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/cli.rb', line 13</span>
+      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/cli.rb', line 12</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_deploy'>deploy</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_stack_names'>stack_names</span> <span class='op'>=</span> <span class='id identifier rubyid_name'>name</span> <span class='op'>?</span> <span class='lbracket'>[</span><span class='id identifier rubyid_name'>name</span><span class='rbracket'>]</span> <span class='op'>:</span> <span class='const'><span class='object_link'><a href="../Reservoir.html" title="Humidifier::Reservoir (module)">Reservoir</a></span></span><span class='period'>.</span><span class='id identifier rubyid_stacks'><span class='object_link'><a href="../Reservoir.html#stacks-class_method" title="Humidifier::Reservoir.stacks (method)">stacks</a></span></span>
+<span class='kw'>def</span> <span class='id identifier rubyid_change'>change</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_stack_names'>stack_names</span> <span class='op'>=</span> <span class='id identifier rubyid_stack_names_from'>stack_names_from</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_authorize'>authorize</span>
 
   <span class='id identifier rubyid_stack_names'>stack_names</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_stack_name'>stack_name</span><span class='op'>|</span>
     <span class='id identifier rubyid_stack'>stack</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Stack.html" title="Humidifier::Reservoir::Stack (class)">Stack</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="Stack.html#initialize-instance_method" title="Humidifier::Reservoir::Stack#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_stack_name'>stack_name</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Creating a changeset for </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_stack'>stack</span><span class='period'>.</span><span class='id identifier rubyid_stack_name'>stack_name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+    <span class='id identifier rubyid_stack'>stack</span><span class='period'>.</span><span class='id identifier rubyid_create_change_set'>create_change_set</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="deploy-instance_method">
+  
+    #<strong>deploy</strong>(name = nil)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/cli.rb', line 26</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_deploy'>deploy</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_stack_names'>stack_names</span> <span class='op'>=</span> <span class='id identifier rubyid_stack_names_from'>stack_names_from</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_authorize'>authorize</span>
+
+  <span class='id identifier rubyid_stack_names'>stack_names</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_stack_name'>stack_name</span><span class='op'>|</span>
+    <span class='id identifier rubyid_stack'>stack</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Stack.html" title="Humidifier::Reservoir::Stack (class)">Stack</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="Stack.html#initialize-instance_method" title="Humidifier::Reservoir::Stack#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_stack_name'>stack_name</span><span class='comma'>,</span> <span class='label'>prefix:</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:prefix</span><span class='rbracket'>]</span><span class='rparen'>)</span>
     <span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Deploying </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_stack'>stack</span><span class='period'>.</span><span class='id identifier rubyid_stack_name'>stack_name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
     <span class='id identifier rubyid_stack'>stack</span><span class='period'>.</span><span class='id identifier rubyid_deploy'>deploy</span><span class='lparen'>(</span><span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:wait</span><span class='rbracket'>]</span><span class='rparen'>)</span>
   <span class='kw'>end</span>
@@ -263,15 +329,15 @@ about.</p>
       <pre class="lines">
 
 
-25
-26
-27</pre>
+38
+39
+40</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/cli.rb', line 25</span>
+      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/cli.rb', line 38</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_display'>display</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_pattern'>pattern</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_puts'>puts</span> <span class='const'><span class='object_link'><a href="Stack.html" title="Humidifier::Reservoir::Stack (class)">Stack</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="Stack.html#initialize-instance_method" title="Humidifier::Reservoir::Stack#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_pattern'>pattern</span> <span class='op'>&amp;&amp;</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_pattern'>pattern</span><span class='embexpr_end'>}</span><span class='regexp_end'>/i</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_cf'><span class='object_link'><a href="Stack.html#to_cf-instance_method" title="Humidifier::Reservoir::Stack#to_cf (method)">to_cf</a></span></span>
+  <span class='id identifier rubyid_puts'>puts</span> <span class='const'><span class='object_link'><a href="Stack.html" title="Humidifier::Reservoir::Stack (class)">Stack</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="Stack.html#initialize-instance_method" title="Humidifier::Reservoir::Stack#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='label'>pattern:</span> <span class='id identifier rubyid_pattern'>pattern</span> <span class='op'>&amp;&amp;</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_pattern'>pattern</span><span class='embexpr_end'>}</span><span class='regexp_end'>/i</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_cf'><span class='object_link'><a href="Stack.html#to_cf-instance_method" title="Humidifier::Reservoir::Stack#to_cf (method)">to_cf</a></span></span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -293,19 +359,19 @@ about.</p>
       <pre class="lines">
 
 
-30
-31
-32
-33
-34
-35
-36</pre>
+43
+44
+45
+46
+47
+48
+49</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/cli.rb', line 30</span>
+      <pre class="code"><span class="info file"># File 'lib/humidifier/reservoir/cli.rb', line 43</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_validate'>validate</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_stack_names'>stack_names</span> <span class='op'>=</span> <span class='id identifier rubyid_name'>name</span> <span class='op'>?</span> <span class='lbracket'>[</span><span class='id identifier rubyid_name'>name</span><span class='rbracket'>]</span> <span class='op'>:</span> <span class='const'><span class='object_link'><a href="../Reservoir.html" title="Humidifier::Reservoir (module)">Reservoir</a></span></span><span class='period'>.</span><span class='id identifier rubyid_stacks'><span class='object_link'><a href="../Reservoir.html#stacks-class_method" title="Humidifier::Reservoir.stacks (method)">stacks</a></span></span>
+  <span class='id identifier rubyid_stack_names'>stack_names</span> <span class='op'>=</span> <span class='id identifier rubyid_stack_names_from'>stack_names_from</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_authorize'>authorize</span>
 
   <span class='id identifier rubyid_print'>print</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Validating... </span><span class='tstring_end'>&#39;</span></span>
@@ -321,9 +387,9 @@ about.</p>
 </div>
 
       <div id="footer">
-  Generated on Sun Oct  1 09:25:22 2017 by
+  Generated on Wed Nov  8 13:26:15 2017 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.9 (ruby-2.4.1).
+  0.9.9 (ruby-2.4.2).
 </div>
 
     </div>