rudder 0.2.2 → 0.3.0

data/docs/Rudder/DSL.html

@@ -143,7 +143,7 @@ See <a href="https://concourse-ci.org/pipeline-groups.html" target="_parent" tit
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#eval_from_file-class_method" title="eval_from_file (class method)">.<strong>eval_from_file</strong>(path)  &#x21d2; Rudder::DSL::Pipeline </a>
+      <a href="#eval_from_file-class_method" title="eval_from_file (class method)">.<strong>eval_from_file</strong>(path, vars: {})  &#x21d2; Rudder::DSL::Pipeline </a>
     
 
     
@@ -168,7 +168,7 @@ See <a href="https://concourse-ci.org/pipeline-groups.html" target="_parent" tit
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#from_file-class_method" title="from_file (class method)">.<strong>from_file</strong>(path)  &#x21d2; Rudder::DSL::Pipeline </a>
+      <a href="#from_file-class_method" title="from_file (class method)">.<strong>from_file</strong>(path, vars: {})  &#x21d2; Rudder::DSL::Pipeline </a>
     
 
     
@@ -225,7 +225,7 @@ See <a href="https://concourse-ci.org/pipeline-groups.html" target="_parent" tit
       <div class="method_details first">
   <h3 class="signature first" id="eval_from_file-class_method">
   
-    .<strong>eval_from_file</strong>(path)  &#x21d2; <tt><span class='object_link'><a href="DSL/Pipeline.html" title="Rudder::DSL::Pipeline (class)">Rudder::DSL::Pipeline</a></span></tt> 
+    .<strong>eval_from_file</strong>(path, vars: {})  &#x21d2; <tt><span class='object_link'><a href="DSL/Pipeline.html" title="Rudder::DSL::Pipeline (class)">Rudder::DSL::Pipeline</a></span></tt> 
   
 
   
@@ -256,6 +256,23 @@ See <a href="https://concourse-ci.org/pipeline-groups.html" target="_parent" tit
         &mdash;
         <div class='inline'>
 <p>to the <span class='object_link'><a href="DSL/Pipeline.html" title="Rudder::DSL::Pipeline (class)">Pipeline</a></span> definition</p>
+</div>
+      
+    </li>
+  
+    <li>
+      
+        <span class='name'>vars</span>
+      
+      
+        <span class='type'></span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>optional [Hash&lt;(Symbol, String), Any&gt;] of <code>Concourse</code>
+variables</p>
 </div>
       
     </li>
@@ -287,15 +304,15 @@ See <a href="https://concourse-ci.org/pipeline-groups.html" target="_parent" tit
       <pre class="lines">
 
 
-50
-51
-52</pre>
+52
+53
+54</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/rudder/dsl.rb', line 50</span>
+      <pre class="code"><span class="info file"># File 'lib/rudder/dsl.rb', line 52</span>
 
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_eval_from_file'>eval_from_file</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='rparen'>)</span>
-  <span class='const'><span class='object_link'><a href="../Rudder.html" title="Rudder (module)">Rudder</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="" title="Rudder::DSL (module)">DSL</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DSL/Pipeline.html" title="Rudder::DSL::Pipeline (class)">Pipeline</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="DSL/Pipeline.html#initialize-instance_method" title="Rudder::DSL::Pipeline#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_eval'><span class='object_link'><a href="DSL/Pipeline.html#eval-instance_method" title="Rudder::DSL::Pipeline#eval (method)">eval</a></span></span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_eval_from_file'>eval_from_file</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='label'>vars:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
+  <span class='const'><span class='object_link'><a href="../Rudder.html" title="Rudder (module)">Rudder</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="" title="Rudder::DSL (module)">DSL</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DSL/Pipeline.html" title="Rudder::DSL::Pipeline (class)">Pipeline</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="DSL/Pipeline.html#initialize-instance_method" title="Rudder::DSL::Pipeline#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='label'>vars:</span> <span class='id identifier rubyid_vars'>vars</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_eval'><span class='object_link'><a href="DSL/Pipeline.html#eval-instance_method" title="Rudder::DSL::Pipeline#eval (method)">eval</a></span></span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -305,7 +322,7 @@ See <a href="https://concourse-ci.org/pipeline-groups.html" target="_parent" tit
       <div class="method_details ">
   <h3 class="signature " id="from_file-class_method">
   
-    .<strong>from_file</strong>(path)  &#x21d2; <tt><span class='object_link'><a href="DSL/Pipeline.html" title="Rudder::DSL::Pipeline (class)">Rudder::DSL::Pipeline</a></span></tt> 
+    .<strong>from_file</strong>(path, vars: {})  &#x21d2; <tt><span class='object_link'><a href="DSL/Pipeline.html" title="Rudder::DSL::Pipeline (class)">Rudder::DSL::Pipeline</a></span></tt> 
   
 
   
@@ -335,6 +352,23 @@ See <a href="https://concourse-ci.org/pipeline-groups.html" target="_parent" tit
         &mdash;
         <div class='inline'>
 <p>to the <span class='object_link'><a href="DSL/Pipeline.html" title="Rudder::DSL::Pipeline (class)">Pipeline</a></span> definition</p>
+</div>
+      
+    </li>
+  
+    <li>
+      
+        <span class='name'>vars</span>
+      
+      
+        <span class='type'></span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>optional [Hash&lt;(Symbol, String), Any&gt;] of <code>Concourse</code>
+variables</p>
 </div>
       
     </li>
@@ -366,15 +400,15 @@ See <a href="https://concourse-ci.org/pipeline-groups.html" target="_parent" tit
       <pre class="lines">
 
 
-39
 40
-41</pre>
+41
+42</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/rudder/dsl.rb', line 39</span>
+      <pre class="code"><span class="info file"># File 'lib/rudder/dsl.rb', line 40</span>
 
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_from_file'>from_file</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='rparen'>)</span>
-  <span class='const'><span class='object_link'><a href="../Rudder.html" title="Rudder (module)">Rudder</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="" title="Rudder::DSL (module)">DSL</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DSL/Pipeline.html" title="Rudder::DSL::Pipeline (class)">Pipeline</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="DSL/Pipeline.html#initialize-instance_method" title="Rudder::DSL::Pipeline#initialize (method)">new</a></span></span> <span class='id identifier rubyid_path'>path</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_from_file'>from_file</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='label'>vars:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
+  <span class='const'><span class='object_link'><a href="../Rudder.html" title="Rudder (module)">Rudder</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="" title="Rudder::DSL (module)">DSL</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="DSL/Pipeline.html" title="Rudder::DSL::Pipeline (class)">Pipeline</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="DSL/Pipeline.html#initialize-instance_method" title="Rudder::DSL::Pipeline#initialize (method)">new</a></span></span> <span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='label'>vars:</span> <span class='id identifier rubyid_vars'>vars</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -446,7 +480,7 @@ pipelines</p>
 </div>
 
       <div id="footer">
-  Generated on Fri Aug 16 17:25:43 2019 by
+  Generated on Wed Nov  6 21:05:08 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/docs/Rudder.html

@@ -118,7 +118,7 @@
         <dt id="VERSION-constant" class="">VERSION =
           
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>0.2.1</span><span class='tstring_end'>&#39;</span></span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>0.2.2</span><span class='tstring_end'>&#39;</span></span></pre></dd>
       
     </dl>
   
@@ -140,7 +140,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#compile-class_method" title="compile (class method)">.<strong>compile</strong>(path)  &#x21d2; Hash </a>
+      <a href="#compile-class_method" title="compile (class method)">.<strong>compile</strong>(path, vars: {})  &#x21d2; Hash </a>
     
 
     
@@ -199,7 +199,7 @@ handle <code>output</code>.</p>
       <div class="method_details first">
   <h3 class="signature first" id="compile-class_method">
   
-    .<strong>compile</strong>(path)  &#x21d2; <tt>Hash</tt> 
+    .<strong>compile</strong>(path, vars: {})  &#x21d2; <tt>Hash</tt> 
   
 
   
@@ -230,6 +230,23 @@ Hash</p>
         &mdash;
         <div class='inline'>
 <p>the path to the <code>Rudder</code> definition</p>
+</div>
+      
+    </li>
+  
+    <li>
+      
+        <span class='name'>vars</span>
+      
+      
+        <span class='type'></span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>optional [Hash&lt;(Symbol, String), Any&gt;] of <code>Concourse</code>
+variables</p>
 </div>
       
     </li>
@@ -261,15 +278,15 @@ Hash</p>
       <pre class="lines">
 
 
-20
 21
-22</pre>
+22
+23</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/rudder.rb', line 20</span>
+      <pre class="code"><span class="info file"># File 'lib/rudder.rb', line 21</span>
 
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_compile'>compile</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='rparen'>)</span>
-  <span class='const'><span class='object_link'><a href="" title="Rudder (module)">Rudder</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Rudder/DSL.html" title="Rudder::DSL (module)">DSL</a></span></span><span class='period'>.</span><span class='id identifier rubyid_eval_from_file'><span class='object_link'><a href="Rudder/DSL.html#eval_from_file-class_method" title="Rudder::DSL.eval_from_file (method)">eval_from_file</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_h'><span class='object_link'><a href="Rudder/DSL/Pipeline.html#to_h-instance_method" title="Rudder::DSL::Pipeline#to_h (method)">to_h</a></span></span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_compile'>compile</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='label'>vars:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
+  <span class='const'><span class='object_link'><a href="" title="Rudder (module)">Rudder</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Rudder/DSL.html" title="Rudder::DSL (module)">DSL</a></span></span><span class='period'>.</span><span class='id identifier rubyid_eval_from_file'><span class='object_link'><a href="Rudder/DSL.html#eval_from_file-class_method" title="Rudder::DSL.eval_from_file (method)">eval_from_file</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='label'>vars:</span> <span class='id identifier rubyid_vars'>vars</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_h'><span class='object_link'><a href="Rudder/DSL/Pipeline.html#to_h-instance_method" title="Rudder::DSL::Pipeline#to_h (method)">to_h</a></span></span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -352,12 +369,12 @@ handle <code>output</code></p>
       <pre class="lines">
 
 
-32
 33
-34</pre>
+34
+35</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/rudder.rb', line 32</span>
+      <pre class="code"><span class="info file"># File 'lib/rudder.rb', line 33</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_dump'>dump</span><span class='lparen'>(</span><span class='id identifier rubyid_pipeline'>pipeline</span><span class='comma'>,</span> <span class='id identifier rubyid_output'>output</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_output'>output</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span><span class='lparen'>(</span><span class='const'>YAML</span><span class='period'>.</span><span class='id identifier rubyid_dump'>dump</span><span class='lparen'>(</span><span class='id identifier rubyid_pipeline'>pipeline</span><span class='period'>.</span><span class='id identifier rubyid_to_h'>to_h</span><span class='rparen'>)</span><span class='rparen'>)</span>
@@ -372,7 +389,7 @@ handle <code>output</code></p>
 </div>
 
       <div id="footer">
-  Generated on Fri Aug 16 17:25:43 2019 by
+  Generated on Wed Nov  6 21:05:08 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/docs/_index.html

@@ -201,7 +201,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Aug 16 17:25:42 2019 by
+  Generated on Wed Nov  6 21:05:08 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/docs/file.README.html

@@ -71,8 +71,8 @@ src="https://img.shields.io/badge/License-MIT-yellow.svg"></a></p>
 href="https://concourse-ci.org/">Concourse CI</a> pipelines.</p>
 
 <p>Rubygems release docs can be found above, or head over to <a
-href="https://jhmcstanton.github.io/rudder">jhmcstanton.github.io/rudder</a>
-for the latest docs from HEAD.</p>
+href="https://rudder.jhmcstanton.com">rudder.jhmcstanton.com</a> for the
+latest docs from HEAD.</p>
 
 <h2 id="label-Goals">Goals</h2>
 
@@ -190,7 +190,7 @@ href="https://opensource.org/licenses/MIT">MIT License</a>.</p>
 </div></div>
 
       <div id="footer">
-  Generated on Fri Aug 16 17:25:43 2019 by
+  Generated on Wed Nov  6 21:05:08 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/docs/index.html

@@ -71,8 +71,8 @@ src="https://img.shields.io/badge/License-MIT-yellow.svg"></a></p>
 href="https://concourse-ci.org/">Concourse CI</a> pipelines.</p>
 
 <p>Rubygems release docs can be found above, or head over to <a
-href="https://jhmcstanton.github.io/rudder">jhmcstanton.github.io/rudder</a>
-for the latest docs from HEAD.</p>
+href="https://rudder.jhmcstanton.com">rudder.jhmcstanton.com</a> for the
+latest docs from HEAD.</p>
 
 <h2 id="label-Goals">Goals</h2>
 
@@ -190,7 +190,7 @@ href="https://opensource.org/licenses/MIT">MIT License</a>.</p>
 </div></div>
 
       <div id="footer">
-  Generated on Fri Aug 16 17:25:43 2019 by
+  Generated on Wed Nov  6 21:05:08 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/docs/method_list.html

@@ -356,6 +356,14 @@
   </li>
   
 
+  <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Rudder/DSL/Pipeline.html#vars-instance_method" title="Rudder::DSL::Pipeline#vars (method)">#vars</a></span>
+      <small>Rudder::DSL::Pipeline</small>
+    </div>
+  </li>
+  
+
 
       </ul>
     </div>

data/docs/top-level-namespace.html

@@ -100,7 +100,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Aug 16 17:25:43 2019 by
+  Generated on Wed Nov  6 21:05:08 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/examples/vars/README.md

@@ -0,0 +1,6 @@
+# Vars Example
+
+It is occasionally useful to be able to include a Concourse vars file while
+generating a pipeline with Rudder. This is a simple example of doing so.
+
+![Vars Pipeline](../images/vars/vars.png)

data/examples/vars/vars.yml

@@ -0,0 +1,4 @@
+some_values:
+  - first
+  - second
+  - third

data/examples/vars/vars_pipeline.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+vals = vars[:some_values]
+
+resource :timer, :time do
+  # The source field can also be assigned via a method
+  source(interval: '5m')
+end
+
+vals.each do |val|
+  job "echo #{val}" do
+    plan << { get: :timer, trigger: true }
+    plan << { task: 'print', config: {
+      platform: 'linux',
+      image_resource: { type: 'docker-image', source: { repository: 'busybox' }},
+      run: {
+        path: 'echo',
+        args: ['Value: ', val]
+      }
+      }
+    }
+  end
+end

data/exe/rudder

@@ -10,7 +10,7 @@ name = File.basename __FILE__
 
 # TODO: Figure out a nice way to join these options with fly's without
 # tieing them together
-options = {}
+options = { }
 optparse = OptionParser.new do |opts|
   opts.banner = "Usage: #{name} [options]"
 
@@ -22,6 +22,10 @@ optparse = OptionParser.new do |opts|
     options[:rudder] = c
   end
 
+  opts.on('-l', '--load-vars-from CONCOURSE_VARS', 'Path to the CONCOURSE_VARS yaml file') do |v|
+    options[:vars] = v
+  end
+
   opts.on('-v', '--version', 'Show version') do
     options[:version] = true
   end
@@ -39,7 +43,11 @@ unless options[:rudder]
   exit 1
 end
 
-pipeline = Rudder.compile(options[:rudder])
+vars = {}
+vars_path = options[:vars]
+vars = YAML.load_file(vars_path) if vars_path
+
+pipeline = Rudder.compile(options[:rudder], vars: vars)
 
 output   = STDOUT
 if options[:output]

data/lib/rudder/dsl/pipeline.rb

@@ -139,6 +139,31 @@ module Rudder
     #       }
     #     }
     #   end
+    #
+    # === Loading Concourse Variables
+    # Occasionally it is helpful to have access to concourse variable
+    # when generating a pipeline, for example, when a Rudder pipeline
+    # should be parameterized on some value already stored in a Concourse
+    # parameter file. Rudder supports loading a concourse vars file from
+    # the {Rudder} command line. These are exposed to the pipeline dsl
+    # through the +vars+ accessor.
+    #
+    # @example Loading Concourse Variables
+    #   #
+    #   # vars_pipeline.rb
+    #   #
+    #   # Assuming a variables file of the form:
+    #   #
+    #   # my_branch: awesome-feature
+    #   #
+    #
+    #   my_branch = vars[:my_branch] # <--- Pulls in the variable here
+    #
+    #   resource :my_git_repo, :git do
+    #     source[:uri]    = 'https://github.com/my/repo.git'
+    #     source[:branch] = my_branch
+    #   end
+    #   ...
     class Pipeline
       include Rudder::DSL::Util
       # {Hash} of names to {Rudder::DSL::Resource}
@@ -153,6 +178,9 @@ module Rudder
       # {Hash} of names to {Rudder::DSL::Group}
       # @return [Hash<(String, Symbol), Rudder::DSL::Group>]
       attr_accessor :groups
+      # {Hash} of concourse variables
+      # @return [Hash<Symbol, (String,Float,Hash,Array)>]
+      attr_accessor :vars
 
       ##
       # All pipelines require:
@@ -179,9 +207,12 @@ module Rudder
       #                  map of Group names to their definitions.
       # @param resources_types [Hash<(String, Symbol), Rudder::DSL::ResourceType]
       #                  map of Resource Type names to their definitions.
+      # @param vars      [Hash<(String, Symbol), (String,Float,Hash,Array)]
+      #                  map of var names to corresponding concourse variable
+      #                  value
       #
       def initialize(file_path = nil, resources: {}, jobs: {},
-                     groups: {}, resource_types: {})
+                     groups: {}, resource_types: {}, vars: {})
         @resources      = resources
         @jobs           = jobs
         @groups         = groups
@@ -196,6 +227,9 @@ module Rudder
         # rubocop:enable Layout/AlignHash, Layout/SpaceBeforeComma
         @pipelines = {}
         @file_path = file_path
+        @vars      = vars.map do |k, v|
+          [k.to_sym, v]
+        end.to_h
       end
 
       ##

data/lib/rudder/dsl.rb

@@ -34,10 +34,11 @@ module Rudder
     # at the +path+
     #
     # @param path [String] to the {Rudder::DSL::Pipeline} definition
+    # @param vars optional [Hash<(Symbol, String), Any>] of +Concourse+ variables
     # @return [Rudder::DSL::Pipeline] from +path+, unevaluated
     #
-    def self.from_file(path)
-      Rudder::DSL::Pipeline.new path
+    def self.from_file(path, vars: {})
+      Rudder::DSL::Pipeline.new path, vars: vars
     end
 
     ##
@@ -45,10 +46,11 @@ module Rudder
     # at the +path+
     #
     # @param path [String] to the {Rudder::DSL::Pipeline} definition
+    # @param vars optional [Hash<(Symbol, String), Any>] of +Concourse+ variables
     # @return [Rudder::DSL::Pipeline] from +path+, fully evaluated
     #
-    def self.eval_from_file(path)
-      Rudder::DSL::Pipeline.new(path).eval
+    def self.eval_from_file(path, vars: {})
+      Rudder::DSL::Pipeline.new(path, vars: vars).eval
     end
   end
 end

data/lib/rudder/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rudder
-  VERSION = '0.2.2'
+  VERSION = '0.3.0'
 end

data/lib/rudder.rb

@@ -15,10 +15,11 @@ module Rudder
   # to a {Hash}
   #
   # @param path [String] the path to the +Rudder+ definition
+  # @param vars optional [Hash<(Symbol, String), Any>] of +Concourse+ variables
   # @return [Hash] Concourse YAML friendly hash
   #
-  def self.compile(path)
-    Rudder::DSL.eval_from_file(path).to_h
+  def self.compile(path, vars: {})
+    Rudder::DSL.eval_from_file(path, vars: vars).to_h
   end
 
   ##

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rudder
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Jim McStanton
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-08-16 00:00:00.000000000 Z
+date: 2019-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -101,6 +101,7 @@ files:
 - bin/console
 - bin/setup
 - docker-compose.yml
+- docs/CNAME
 - docs/Rudder.html
 - docs/Rudder/DSL.html
 - docs/Rudder/DSL/Component.html
@@ -142,6 +143,7 @@ files:
 - examples/images/shared/borrows.png
 - examples/images/shared/common.png
 - examples/images/shared/wrapper.png
+- examples/images/vars/vars.png
 - examples/includes/README.md
 - examples/includes/includes_pipeline.rb
 - examples/includes/jobs/log.rb
@@ -150,6 +152,9 @@ files:
 - examples/shared/borrows_pipeline.rb
 - examples/shared/common_pipeline.rb
 - examples/shared/wrapper_pipeline.rb
+- examples/vars/README.md
+- examples/vars/vars.yml
+- examples/vars/vars_pipeline.rb
 - exe/rudder
 - lib/rudder.rb
 - lib/rudder/dsl.rb
@@ -168,10 +173,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/jhmcstanton/rudder
-  changelog_uri: https://github.com/jhmcstanton/rudder/blob/0.2.2/CHANGELOG.md
+  changelog_uri: https://github.com/jhmcstanton/rudder/blob/0.3.0/CHANGELOG.md
   source_code_uri: https://github.com/jhmcstanton/rudder
   bug_tracker_uri: https://github.com/jhmcstanton/rudder/issues
-  documentation_uri: https://www.rubydoc.info/gems/rudder/0.2.2
+  documentation_uri: https://www.rubydoc.info/gems/rudder/0.3.0
 post_install_message: 
 rdoc_options: []
 require_paths: