bauxite 0.6.5 → 0.6.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3841662a25997807678f3e52176b061751172c8c
-  data.tar.gz: b22e3da073d4015be52e819bc8858831d51f3d40
+  metadata.gz: 90ce48c06f99606d8c8a5c73b576e222dc1dcab3
+  data.tar.gz: f0c003f941b4606eb917a18254e5c12ac5de6d54
 SHA512:
-  metadata.gz: 4676bd2187cd55b5770dbe6b5bcfbdd1b30008879f020a78701de4cdac9fede413cdc957ecac933287fd823615fdc5d7ac29d9b5b1881ebb0db2b009dd4669c8
-  data.tar.gz: 8ad2335de258b2a6c58f03709862ab36da4bfab9ccbee168c87158497d388fa942aa4be6537e77c84137aef59651588325a27df979bcb06fe00e2cb2e42fb105
+  metadata.gz: 896b21ed882309deb9cffa5d6efe34071916a0e5574fe7c6dcdda4ed4608b932420829c09d2fee2742c4d6b7d012ad62963fc4e67c8fbfe32b7eb4bcb01a04c4
+  data.tar.gz: 1ce615dc1d7b1d2c3112da20220c58f0f26d9f342f1dc5092c1deffde8bec9c49e4c5e64badfccc263fcf1a8906f81c5064c3d3c921ffb1ec86d338b79f251fa

data/README.md

@@ -262,8 +262,7 @@ If you want to run Bauxite tests in your [Jenkins CI](http://jenkins-ci.org/) se
 
     #!/bin/bash
     source ~/.rvm/scripts/rvm
-    bauxite -l echo -u http://localhost:4444/wd/hub          \
-            -t 60 -o 240 --csv-summary "$WORKSPACE/test.csv" \
+    bauxite -t 60 -o 240 --jenkins "$WORKSPACE/test-results" \
             "$WORKSPACE/test/suite.bxt"
 
 Assuming you have Selenium Server running on localhost and your workspace (e.g. GIT repo) contains a folder named `test` with a file named `suite.bxt` the configuration above should work like a charm.
@@ -277,7 +276,9 @@ Assuming you have Selenium Server running on localhost and your workspace (e.g.
     test purchase_something.bxt
     # more tests here...
 
-Note the `--csv-summary` option in the configuration above. That option generates a single-line CSV file ideal to feed into the `Plot` Jenkins plugin. I won't go into the details of configuring the Plot plugin, but instead here is a fragment of a possible Jenkins `config.xml` plotting the Bauxite test results:
+Note the `--jenkins` option in the configuration above. That option sets the default configuration arguments for Jenkins integration. For more details on the `bauxite` command-line arguments refer to the [RDoc documentation](http://pzavolinsky.github.io/bauxite/Bauxite/Application.html).
+
+I won't go into the details of configuring the Jenkins publishing plugins to print Bauxite test results, but instead here is a fragment of a possible Jenkins `config.xml`:
 
     <publishers>
       ...
@@ -288,7 +289,7 @@ Note the `--csv-summary` option in the configuration above. That option generate
             <yaxis>Number of tests</yaxis>
             <series>
               <hudson.plugins.plot.CSVSeries>
-                <file>test.csv</file>
+                <file>test-results/summary.csv</file>
                 <label></label>
                 <fileType>csv</fileType>
                 <strExclusionSet>
@@ -314,7 +315,7 @@ Note the `--csv-summary` option in the configuration above. That option generate
             <yaxis>Test time (s)</yaxis>
             <series>
               <hudson.plugins.plot.CSVSeries>
-                <file>test.csv</file>
+                <file>test-results/summary.csv</file>
                 <label></label>
                 <fileType>csv</fileType>
                 <strExclusionSet>

data/doc/Bauxite/Action.html

@@ -669,14 +669,14 @@ will be stored in <code>__CAPTURE__</code>.</p>
 
 <span class="ruby-identifier">capture</span> <span class="ruby-identifier">my_file</span>.<span class="ruby-identifier">png</span>
 <span class="ruby-comment"># =&gt; this would capture the screenshot to my_file.png in the current</span>
-<span class="ruby-comment">#    working directory.</span>
+<span class="ruby-comment">#    output directory.</span>
 </pre>
           
           
 
           
           <div class="method-source-code" id="capture-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/actions/capture.rb, line 42</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/actions/capture.rb, line 40</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">capture</span>(<span class="ruby-identifier">file</span> = <span class="ruby-keyword">nil</span>)
         <span class="ruby-keyword">unless</span> <span class="ruby-identifier">file</span>
                 <span class="ruby-identifier">seq</span> = <span class="ruby-ivar">@ctx</span>.<span class="ruby-identifier">variables</span>[<span class="ruby-string">&#39;__CAPTURE_SEQ__&#39;</span>] <span class="ruby-operator">||</span> <span class="ruby-value">0</span>
@@ -690,17 +690,11 @@ will be stored in <code>__CAPTURE__</code>.</p>
                 <span class="ruby-identifier">file</span> = <span class="ruby-node">&quot;#{test}_#{file}&quot;</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">test</span>
                 <span class="ruby-identifier">file</span> = <span class="ruby-identifier">file</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp">/[^A-Z0-9_-]/i</span>, <span class="ruby-string">&#39;_&#39;</span>) <span class="ruby-operator">+</span> <span class="ruby-string">&#39;.png&#39;</span>
         <span class="ruby-keyword">end</span>
-
-        <span class="ruby-keyword">unless</span> <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">file</span>).<span class="ruby-identifier">absolute?</span>
-                <span class="ruby-identifier">output</span> = <span class="ruby-ivar">@ctx</span>.<span class="ruby-identifier">variables</span>[<span class="ruby-string">&#39;__OUTPUT__&#39;</span>]
-                <span class="ruby-keyword">if</span> <span class="ruby-identifier">output</span>
-                        <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">mkdir</span> <span class="ruby-identifier">output</span> <span class="ruby-keyword">unless</span> <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">exists?</span> <span class="ruby-identifier">output</span>
-                        <span class="ruby-identifier">file</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">output</span>, <span class="ruby-identifier">file</span>)
-                <span class="ruby-keyword">end</span>
-        <span class="ruby-keyword">end</span>
-
+        
+        <span class="ruby-identifier">file</span> = <span class="ruby-ivar">@ctx</span>.<span class="ruby-identifier">output_path</span>(<span class="ruby-identifier">file</span>)
+        
         <span class="ruby-ivar">@ctx</span>.<span class="ruby-identifier">driver</span>.<span class="ruby-identifier">save_screenshot</span>(<span class="ruby-identifier">file</span>)
-
+        
         <span class="ruby-ivar">@ctx</span>.<span class="ruby-identifier">variables</span>[<span class="ruby-string">&#39;__CAPTURE__&#39;</span>] = <span class="ruby-identifier">file</span>
         <span class="ruby-keyword">true</span>
 <span class="ruby-keyword">end</span></pre>

data/doc/Bauxite/Application.html

@@ -118,6 +118,10 @@ href="../Bauxite.html">Bauxite</a> version execute:</p>
 <dd>
 <p>Number of seconds to wait before issuing a timeout error. This timeout
 applies only to Selectors.</p>
+</dd><dt>-o, --open_timeout SECONDS
+<dd>
+<p>Number of seconds to wait before issuing a timeout error. This timeout
+applies only to page loading times (i.e. Net::HTTP).</p>
 </dd><dt>-d, --debug
 <dd>
 <p>If an error occurs, break into the debug console. This mode is very useful
@@ -161,6 +165,8 @@ otherwise it defaults to <code>terminal</code>.</p>
 <p>To see a complete list of the available loggers execute:</p>
 
 <pre>bauxite -h</pre>
+
+<p>Note that multiple instances of this option can be specified.</p>
 </dd><dt>-L, --logger-option OPTION
 <dd>
 <p>A <code>name=value</code> pair of options that are directly forwarded to
@@ -184,6 +190,19 @@ does not contain an <code>=</code> sign.</p>
 <p>To see a complete list of the available selectors execute:</p>
 
 <pre>bauxite -h</pre>
+</dd><dt>-c, --capture
+<dd>
+<p>If the test fails, capture a screenshot in the <code>output</code>
+directory. See the --output option below.</p>
+</dd><dt>--csv-summary FILE
+<dd>
+<p>Output a single-line CSV summary ideal to feed into the Plot Jenkins
+plugin. If <code>FILE</code> is not specified, defaults to
+<code>summary.csv</code></p>
+</dd><dt>--output DIR
+<dd>
+<p>Output directory for generated artifacts. Defaults to the current working
+directory.</p>
 </dd><dt>-u, --url URL
 <dd>
 <p>This option is an alias of:</p>
@@ -192,6 +211,19 @@ does not contain an <code>=</code> sign.</p>
 
 <p>If <code>URL</code> is not present
 <code>http://localhost:4444/wd/hub</code> will be assumed.</p>
+</dd><dt>--jenkins DIR
+<dd>
+<p>Configures default options for Jenkins integration. This option is an alias
+of:</p>
+
+<pre>-p remote -P url=http://localhost:4444/wd/hub -l echo -l html
+-L html_package=true -c --csv-summary
+--output DIR</pre>
+
+<p>Note that any of the options above can be overridden by specifying the
+option after the <code>--jenkins</code> option. For example:</p>
+
+<pre>--jenkins -u selenium.my-organization.com:4445</pre>
 </dd><dt>-e, --extension DIR
 <dd>
 <p>Loads every Ruby file (*.rb) inside <code>DIR</code> (and subdirectories).

data/doc/Bauxite/Context.html

@@ -138,6 +138,8 @@
     
     <li ><a href="#method-i-get_value">#get_value</a>
     
+    <li ><a href="#method-i-output_path">#output_path</a>
+    
     <li ><a href="#method-i-print_error">#print_error</a>
     
     <li ><a href="#method-i-reset_driver">#reset_driver</a>
@@ -412,7 +414,7 @@ href="Context.html#method-i-stop">stop</a> (defaults to <code>false</code>)</p>
 
           
           <div class="method-source-code" id="new-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 140</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 141</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">options</span>)
         <span class="ruby-ivar">@options</span> = <span class="ruby-identifier">options</span>
         <span class="ruby-ivar">@driver_name</span> = (<span class="ruby-identifier">options</span>[<span class="ruby-value">:driver</span>] <span class="ruby-operator">||</span> <span class="ruby-value">:firefox</span>).<span class="ruby-identifier">to_sym</span>
@@ -480,7 +482,7 @@ href="Context.html#method-i-stop">stop</a> (defaults to <code>false</code>)</p>
 
           
           <div class="method-source-code" id="debug-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 266</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 272</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">debug</span>
         <span class="ruby-identifier">exec_parsed_action</span>(<span class="ruby-string">&#39;debug&#39;</span>, [], <span class="ruby-keyword">false</span>)
 <span class="ruby-keyword">end</span></pre>
@@ -537,7 +539,7 @@ applies if no <code>block</code> was given).</p>
 
           
           <div class="method-source-code" id="find-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 255</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 261</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">find</span>(<span class="ruby-identifier">selector</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>) <span class="ruby-comment"># yields: element</span>
         <span class="ruby-identifier">with_timeout</span> <span class="ruby-constant">Selenium</span><span class="ruby-operator">::</span><span class="ruby-constant">WebDriver</span><span class="ruby-operator">::</span><span class="ruby-constant">Error</span><span class="ruby-operator">::</span><span class="ruby-constant">NoSuchElementError</span> <span class="ruby-keyword">do</span>
                 <span class="ruby-constant">Selector</span>.<span class="ruby-identifier">new</span>(<span class="ruby-keyword">self</span>, <span class="ruby-ivar">@variables</span>[<span class="ruby-string">&#39;__SELECTOR__&#39;</span>]).<span class="ruby-identifier">find</span>(<span class="ruby-identifier">selector</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -587,7 +589,7 @@ the inner text or the value of the <code>value</code> attribute.</p>
 
           
           <div class="method-source-code" id="get_value-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 285</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 291</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">get_value</span>(<span class="ruby-identifier">element</span>)
         <span class="ruby-keyword">if</span> [<span class="ruby-string">&#39;input&#39;</span>,<span class="ruby-string">&#39;select&#39;</span>,<span class="ruby-string">&#39;textarea&#39;</span>].<span class="ruby-identifier">include?</span> <span class="ruby-identifier">element</span>.<span class="ruby-identifier">tag_name</span>.<span class="ruby-identifier">downcase</span>
                 <span class="ruby-identifier">element</span>.<span class="ruby-identifier">attribute</span>(<span class="ruby-string">&#39;value&#39;</span>) 
@@ -630,7 +632,7 @@ the inner text or the value of the <code>value</code> attribute.</p>
 
           
           <div class="method-source-code" id="reset_driver-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 203</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 209</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">reset_driver</span>
         <span class="ruby-ivar">@driver</span>.<span class="ruby-identifier">quit</span>
         <span class="ruby-identifier">_load_driver</span>
@@ -679,9 +681,14 @@ href="Context.html#method-i-stop">stop</a>).</p>
 
           
           <div class="method-source-code" id="start-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 179</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 180</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">start</span>(<span class="ruby-identifier">actions</span> = [])
-        <span class="ruby-identifier">_load_driver</span>
+        <span class="ruby-keyword">begin</span>
+                <span class="ruby-identifier">_load_driver</span>
+        <span class="ruby-keyword">rescue</span> <span class="ruby-constant">StandardError</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
+                <span class="ruby-identifier">print_error</span>(<span class="ruby-identifier">e</span>)
+                <span class="ruby-identifier">raise</span>
+        <span class="ruby-keyword">end</span>
         <span class="ruby-keyword">return</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">actions</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
         <span class="ruby-keyword">begin</span>
                 <span class="ruby-identifier">actions</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">action</span><span class="ruby-operator">|</span>
@@ -744,7 +751,7 @@ href="Context.html#method-i-stop">stop</a> pattern.</p>
 
           
           <div class="method-source-code" id="stop-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 223</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 229</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">stop</span>
         <span class="ruby-constant">Context</span><span class="ruby-operator">::</span><span class="ruby-identifier">wait</span> <span class="ruby-keyword">if</span> <span class="ruby-ivar">@options</span>[<span class="ruby-value">:wait</span>]
         <span class="ruby-keyword">begin</span>
@@ -801,7 +808,7 @@ href="Context.html#method-i-stop">stop</a> pattern.</p>
         
         <div class="method-heading">
           <span class="method-name">load_logger</span><span
-            class="method-args">(name, options)</span>
+            class="method-args">(loggers, options)</span>
           
           <span class="method-click-advice">click to toggle source</span>
           
@@ -817,8 +824,14 @@ logger type.</p>
 
           
           <div class="method-source-code" id="load_logger-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 423</span>
-<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">load_logger</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">options</span>)
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 429</span>
+<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">load_logger</span>(<span class="ruby-identifier">loggers</span>, <span class="ruby-identifier">options</span>)
+        <span class="ruby-keyword">if</span> <span class="ruby-identifier">loggers</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Array</span>
+                <span class="ruby-keyword">return</span> <span class="ruby-constant">Loggers</span><span class="ruby-operator">::</span><span class="ruby-constant">CompositeLogger</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">options</span>, <span class="ruby-identifier">loggers</span>)
+        <span class="ruby-keyword">end</span>
+        
+        <span class="ruby-identifier">name</span> = <span class="ruby-identifier">loggers</span>
+        
         <span class="ruby-identifier">log_name</span> = (<span class="ruby-identifier">name</span> <span class="ruby-operator">||</span> <span class="ruby-string">&#39;null&#39;</span>).<span class="ruby-identifier">downcase</span>
         
         <span class="ruby-identifier">class_name</span> = <span class="ruby-node">&quot;#{log_name.capitalize}Logger&quot;</span>
@@ -859,7 +872,7 @@ logger type.</p>
 
           
           <div class="method-source-code" id="parse_action_default-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 445</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 457</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">parse_action_default</span>(<span class="ruby-identifier">text</span>, <span class="ruby-identifier">file</span> = <span class="ruby-string">&#39;&lt;unknown&gt;&#39;</span>, <span class="ruby-identifier">line</span> = <span class="ruby-value">0</span>)
         <span class="ruby-identifier">data</span> = <span class="ruby-identifier">text</span>.<span class="ruby-identifier">split</span>(<span class="ruby-string">&#39; &#39;</span>, <span class="ruby-value">2</span>)
         <span class="ruby-keyword">begin</span>
@@ -927,7 +940,7 @@ logger type.</p>
 
           
           <div class="method-source-code" id="wait-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 416</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 422</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">wait</span>
         <span class="ruby-constant">Readline</span>.<span class="ruby-identifier">readline</span>(<span class="ruby-string">&quot;Press ENTER to continue\n&quot;</span>)
 <span class="ruby-keyword">end</span></pre>
@@ -969,7 +982,7 @@ with the arguments specified in <code>args</code>.</p>
 
           
           <div class="method-source-code" id="add_alias-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 439</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 451</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">add_alias</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">action</span>, <span class="ruby-identifier">args</span>)
         <span class="ruby-ivar">@aliases</span>[<span class="ruby-identifier">name</span>] = { <span class="ruby-value">:action</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">action</span>, <span class="ruby-value">:args</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">args</span> }
 <span class="ruby-keyword">end</span></pre>
@@ -1012,7 +1025,7 @@ behavior).</p>
 
           
           <div class="method-source-code" id="exec_action-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 306</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 312</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">exec_action</span>(<span class="ruby-identifier">text</span>)
         <span class="ruby-identifier">data</span> = <span class="ruby-constant">Context</span><span class="ruby-operator">::</span><span class="ruby-identifier">parse_action_default</span>(<span class="ruby-identifier">text</span>, <span class="ruby-string">&#39;&lt;unknown&gt;&#39;</span>, <span class="ruby-value">0</span>)
         <span class="ruby-identifier">exec_parsed_action</span>(<span class="ruby-identifier">data</span>[<span class="ruby-value">:action</span>], <span class="ruby-identifier">data</span>[<span class="ruby-value">:args</span>], <span class="ruby-keyword">true</span>, <span class="ruby-identifier">text</span>)
@@ -1060,7 +1073,7 @@ ret.call if ret.respond_to? :call</pre>
 
           
           <div class="method-source-code" id="exec_action_object-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 525</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 537</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">exec_action_object</span>(<span class="ruby-identifier">action</span>)
         <span class="ruby-identifier">action</span>.<span class="ruby-identifier">execute</span>
 <span class="ruby-keyword">end</span></pre>
@@ -1099,7 +1112,7 @@ ret.call if ret.respond_to? :call</pre>
 
           
           <div class="method-source-code" id="exec_file-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 317</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 323</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">exec_file</span>(<span class="ruby-identifier">file</span>)
         <span class="ruby-identifier">current_dir</span>  = <span class="ruby-ivar">@variables</span>[<span class="ruby-string">&#39;__DIR__&#39;</span> ]
         <span class="ruby-identifier">current_file</span> = <span class="ruby-ivar">@variables</span>[<span class="ruby-string">&#39;__FILE__&#39;</span>]
@@ -1160,7 +1173,7 @@ preferred.</p>
 
           
           <div class="method-source-code" id="exec_parsed_action-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 347</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 353</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">exec_parsed_action</span>(<span class="ruby-identifier">action</span>, <span class="ruby-identifier">args</span>, <span class="ruby-identifier">log</span> = <span class="ruby-keyword">true</span>, <span class="ruby-identifier">text</span> = <span class="ruby-keyword">nil</span>)
         <span class="ruby-identifier">action</span> = <span class="ruby-identifier">get_action</span>(<span class="ruby-identifier">action</span>, <span class="ruby-identifier">args</span>, <span class="ruby-identifier">text</span>)
         <span class="ruby-identifier">ret</span> = <span class="ruby-keyword">nil</span>
@@ -1211,7 +1224,7 @@ preferred.</p>
 
           
           <div class="method-source-code" id="get_action-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 485</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 497</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">get_action</span>(<span class="ruby-identifier">action</span>, <span class="ruby-identifier">args</span>, <span class="ruby-identifier">text</span> = <span class="ruby-keyword">nil</span>)
         <span class="ruby-keyword">while</span> (<span class="ruby-identifier">alias_action</span> = <span class="ruby-ivar">@aliases</span>[<span class="ruby-identifier">action</span>])
                 <span class="ruby-identifier">action</span> = <span class="ruby-identifier">alias_action</span>[<span class="ruby-value">:action</span>]
@@ -1245,6 +1258,58 @@ preferred.</p>
         
 
         
+      </div>
+
+    
+      <div id="method-i-output_path" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">output_path</span><span
+            class="method-args">(path)</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Returns the output path for <code>path</code> accounting for the 
+<code>__OUTPUT__</code> variable.</p>
+
+<p>For example:</p>
+
+<pre class="ruby"><span class="ruby-comment"># assuming --output /mnt/disk</span>
+
+<span class="ruby-identifier">ctx</span>.<span class="ruby-identifier">output_path</span> <span class="ruby-string">&#39;/tmp/myfile.txt&#39;</span>
+<span class="ruby-comment"># =&gt; returns &#39;/tmp/myfile.txt&#39;</span>
+
+<span class="ruby-identifier">ctx</span>.<span class="ruby-identifier">output_path</span> <span class="ruby-string">&#39;myfile.txt&#39;</span>
+<span class="ruby-comment"># =&gt; returns &#39;/mnt/disk/myfile.txt&#39;</span>
+</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="output_path-source">
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 582</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">output_path</span>(<span class="ruby-identifier">path</span>)
+        <span class="ruby-keyword">unless</span> <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">path</span>).<span class="ruby-identifier">absolute?</span>
+                <span class="ruby-identifier">output</span> = <span class="ruby-ivar">@variables</span>[<span class="ruby-string">&#39;__OUTPUT__&#39;</span>]
+                <span class="ruby-keyword">if</span> <span class="ruby-identifier">output</span>
+                        <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">mkdir</span> <span class="ruby-identifier">output</span> <span class="ruby-keyword">unless</span> <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">exists?</span> <span class="ruby-identifier">output</span>
+                        <span class="ruby-identifier">path</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">output</span>, <span class="ruby-identifier">path</span>)
+                <span class="ruby-keyword">end</span>
+        <span class="ruby-keyword">end</span>
+        <span class="ruby-identifier">path</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
       </div>
 
     
@@ -1278,7 +1343,7 @@ handling the verbose option.</p>
 
           
           <div class="method-source-code" id="print_error-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 540</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 552</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">print_error</span>(<span class="ruby-identifier">e</span>, <span class="ruby-identifier">capture</span> = <span class="ruby-keyword">true</span>)
         <span class="ruby-keyword">if</span> <span class="ruby-ivar">@logger</span>
                 <span class="ruby-ivar">@logger</span>.<span class="ruby-identifier">log</span> <span class="ruby-node">&quot;#{e.message}\n&quot;</span>, <span class="ruby-value">:error</span>
@@ -1338,7 +1403,7 @@ available <a href="Selector.html">Selector</a> strategies).</p>
 
           
           <div class="method-source-code" id="with_driver_timeout-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 401</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 407</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">with_driver_timeout</span>(<span class="ruby-identifier">timeout</span>)
         <span class="ruby-identifier">current</span> = <span class="ruby-ivar">@driver_timeout</span>
         <span class="ruby-ivar">@driver</span>.<span class="ruby-identifier">manage</span>.<span class="ruby-identifier">timeouts</span>.<span class="ruby-identifier">implicit_wait</span> = <span class="ruby-identifier">timeout</span>
@@ -1387,7 +1452,7 @@ to execute the block itself.</p>
 
           
           <div class="method-source-code" id="with_timeout-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 373</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 379</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">with_timeout</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">error_types</span>)
         <span class="ruby-identifier">stime</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">new</span>
         <span class="ruby-identifier">timeout</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">stime</span> <span class="ruby-operator">+</span> <span class="ruby-ivar">@variables</span>[<span class="ruby-string">&#39;__TIMEOUT__&#39;</span>]
@@ -1468,7 +1533,7 @@ to execute the block itself.</p>
 
           
           <div class="method-source-code" id="action_args-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 578</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 613</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">action_args</span>(<span class="ruby-identifier">action</span>)
         <span class="ruby-identifier">action</span> <span class="ruby-operator">+=</span> <span class="ruby-string">&#39;_action&#39;</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">_action_methods</span>.<span class="ruby-identifier">include?</span> <span class="ruby-identifier">action</span>
         <span class="ruby-constant">Action</span>.<span class="ruby-identifier">public_instance_method</span>(<span class="ruby-identifier">action</span>).<span class="ruby-identifier">parameters</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">att</span>, <span class="ruby-identifier">name</span><span class="ruby-operator">|</span> <span class="ruby-identifier">name</span>.<span class="ruby-identifier">to_s</span> }
@@ -1508,7 +1573,7 @@ to execute the block itself.</p>
 
           
           <div class="method-source-code" id="actions-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 568</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 603</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">actions</span>
         <span class="ruby-identifier">_action_methods</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">m</span><span class="ruby-operator">|</span> <span class="ruby-identifier">m</span>.<span class="ruby-identifier">sub</span>(<span class="ruby-regexp">/_action$/</span>, <span class="ruby-string">&#39;&#39;</span>) }
 <span class="ruby-keyword">end</span></pre>
@@ -1547,7 +1612,7 @@ to execute the block itself.</p>
 
           
           <div class="method-source-code" id="loggers-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 607</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 642</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">loggers</span>
         <span class="ruby-constant">Loggers</span>.<span class="ruby-identifier">constants</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">l</span><span class="ruby-operator">|</span> <span class="ruby-identifier">l</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">downcase</span>.<span class="ruby-identifier">sub</span>(<span class="ruby-regexp">/logger$/</span>, <span class="ruby-string">&#39;&#39;</span>) }
 <span class="ruby-keyword">end</span></pre>
@@ -1589,7 +1654,7 @@ to execute the block itself.</p>
 
           
           <div class="method-source-code" id="max_action_name_size-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 631</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 666</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">max_action_name_size</span>
         <span class="ruby-identifier">actions</span>.<span class="ruby-identifier">inject</span>(<span class="ruby-value">0</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">s</span>,<span class="ruby-identifier">a</span><span class="ruby-operator">|</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">s</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">s</span> }
 <span class="ruby-keyword">end</span></pre>
@@ -1628,7 +1693,7 @@ to execute the block itself.</p>
 
           
           <div class="method-source-code" id="parsers-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 617</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 652</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">parsers</span>
         (<span class="ruby-constant">Parser</span>.<span class="ruby-identifier">public_instance_methods</span>(<span class="ruby-keyword">false</span>)                           <span class="ruby-operator">-</span> <span class="ruby-constant">ParserModule</span>.<span class="ruby-identifier">public_instance_methods</span>(<span class="ruby-keyword">false</span>))
         .<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">p</span>.<span class="ruby-identifier">to_s</span> }
@@ -1672,7 +1737,7 @@ custom  selectors are returned.</p>
 
           
           <div class="method-source-code" id="selectors-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 593</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 628</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">selectors</span>(<span class="ruby-identifier">include_standard_selectors</span> = <span class="ruby-keyword">true</span>)
         <span class="ruby-identifier">ret</span> = <span class="ruby-constant">Selector</span>.<span class="ruby-identifier">public_instance_methods</span>(<span class="ruby-keyword">false</span>).<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">a</span><span class="ruby-operator">|</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">sub</span>(<span class="ruby-regexp">/_selector$/</span>, <span class="ruby-string">&#39;&#39;</span>) }
         <span class="ruby-keyword">if</span> <span class="ruby-identifier">include_standard_selectors</span>
@@ -1754,7 +1819,7 @@ with the corresponding variable value.</p>
 
           
           <div class="method-source-code" id="expand-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 652</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 687</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">expand</span>(<span class="ruby-identifier">s</span>)
         <span class="ruby-identifier">result</span> = <span class="ruby-ivar">@variables</span>.<span class="ruby-identifier">inject</span>(<span class="ruby-identifier">s</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">s</span>,<span class="ruby-identifier">kv</span><span class="ruby-operator">|</span>
                 <span class="ruby-identifier">s</span> = <span class="ruby-identifier">s</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-node">/\$\{#{kv[0]}\}/</span>, <span class="ruby-identifier">kv</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">to_s</span>)
@@ -1807,7 +1872,7 @@ variables is restored.</p>
 
           
           <div class="method-source-code" id="with_vars-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 675</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 710</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">with_vars</span>(<span class="ruby-identifier">vars</span>)
         <span class="ruby-identifier">current</span> = <span class="ruby-ivar">@variables</span>
         <span class="ruby-ivar">@variables</span> = <span class="ruby-ivar">@variables</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">vars</span>)