bauxite 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ff6775d805df3867861598c574b723a829915881
-  data.tar.gz: b89f4a63f828908954334e3007bb2db4beb980aa
+  metadata.gz: e8a3aa61e78bd381ca5c2f417827a89170c6c69e
+  data.tar.gz: 3acbfd338e46b99e2968f28cbd78eb4135881ece
 SHA512:
-  metadata.gz: 6c6d221343fd711016288d105ffb1f14d905527c23d5a4c62759a8837ac526ecba48dfdec2dcef920a1e377fe73f61f0df82d02eff2c1f7a8999c1e67e4e8e42
-  data.tar.gz: 2d9df0072b5841c102b4185e9118ee932f4656e83894a5cd7ebed4d956f3d23cda61be50b2106200b1dc8e33deabfd7945dc12ec06c02d52cd50578a09e1d2d9
+  metadata.gz: a73a8fa920d65a790a9757a9f04eda4a2dbf03479ba3a2b9f44c48fba50f4df498ad0f32e678c33d79be417305187dc69e4d9b37b41b6c93aece9b2c671e0182
+  data.tar.gz: 5cffd2b7beeb8e542f0f87483c4bc880c44438d7becf11a59901062a13c24ef8252f3e0e2777e26d1e7f66cada19bad2a69b605171249d2fcf541b9f82994b86

data/README.md

@@ -105,6 +105,7 @@ This section presented a  brief introduction into the basic Bauxite concepts. Fo
  - [Available Actions](http://pzavolinsky.github.io/bauxite/Bauxite/Action.html#Action+Methods)
  - [Available Bauxite Selectors](http://pzavolinsky.github.io/bauxite/Bauxite/Selector.html#Selector+Methods)
  - [Selenium Standard Selectors](http://pzavolinsky.github.io/bauxite/Bauxite/Selector.html#class-Bauxite::Selector-label-Standard+Selenium+Selectors)
+ - [Bauxite Variables](http://pzavolinsky.github.io/bauxite/Bauxite/Context.html#class-Bauxite::Context-label-Context+variables)
  - [Creating new Actions](http://pzavolinsky.github.io/bauxite/Bauxite/Action.html)
  - [Creating new Selectors](http://pzavolinsky.github.io/bauxite/Bauxite/Selector.html)
 

data/Rakefile

@@ -9,6 +9,7 @@ require 'rubygems/package_task'
 spec = Gem::Specification.new do |s|
 	s.name        = 'bauxite'
 	s.summary     = 'Bauxite is a façade over Selenium intended for non-developers'
+	s.description = 'The idea behind this project was to create a tool that allows non-developers to write web tests in a human-readable language. Another major requirement is to be able to easily extend the test language to create functional abstractions over technical details.'
 	s.author      = 'Patricio Zavolinsky'
 	s.email       = 'pzavolinsky at yahoo dot com dot ar'
 	s.homepage    = 'https://github.com/pzavolinsky/bauxite'
@@ -44,6 +45,8 @@ task :test do
 	
 	ruby "-Ilib bin/bauxite -v -e #{File.join('test', 'extension')} #{File.join('test', 'extension.bxt.manual')}"
 	
+	ruby "-Ilib bin/bauxite -v -s css #{File.join('test', 'default_selector.bxt.manual')}"
+	
 	system("ruby -Ilib bin/bauxite #{File.join('test', 'test.bxt.manual')}")
 	fail "The 'test' action test failed to return the expected exit status: the exit status was #{$?.exitstatus}" unless $?.exitstatus == 2
 end

data/doc/Bauxite.html

@@ -94,7 +94,7 @@
 
 <footer id="validator-badges" role="contentinfo">
   <p><a href="http://validator.w3.org/check/referer">Validate</a>
-  <p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.0.
+  <p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.1.
   <p>Based on <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
 </footer>
 

data/doc/Bauxite/Action.html

@@ -824,6 +824,7 @@ href="Context.html#method-i-with_vars">Bauxite::Context#with_vars</a>).</p>
             <pre><span class="ruby-comment"># File lib/bauxite/actions/open.rb, line 31</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">open</span>(<span class="ruby-identifier">url</span>)
         <span class="ruby-ivar">@ctx</span>.<span class="ruby-identifier">driver</span>.<span class="ruby-identifier">navigate</span>.<span class="ruby-identifier">to</span> <span class="ruby-identifier">url</span>
+        <span class="ruby-keyword">true</span>
 <span class="ruby-keyword">end</span></pre>
           </div>
           
@@ -1562,7 +1563,7 @@ href="Context.html#method-i-expand">Bauxite::Context#expand</a>).</p>
 
 <footer id="validator-badges" role="contentinfo">
   <p><a href="http://validator.w3.org/check/referer">Validate</a>
-  <p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.0.
+  <p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.1.
   <p>Based on <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
 </footer>
 

data/doc/Bauxite/ActionModule.html

@@ -336,7 +336,7 @@ might yield different results.</p>
 
 <footer id="validator-badges" role="contentinfo">
   <p><a href="http://validator.w3.org/check/referer">Validate</a>
-  <p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.0.
+  <p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.1.
   <p>Based on <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
 </footer>
 

data/doc/Bauxite/Application.html

@@ -176,6 +176,14 @@ enforces test isolation by resetting the test context before each test
 <dd>
 <p>Wait for user input when the test completes instead of closing the browser
 window.</p>
+</dd><dt>-s, --selector SELECTOR
+<dd>
+<p>Default selector strategy. This strategy is applied if the selector text
+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>-u, --url URL
 <dd>
 <p>This option is an alias of:</p>
@@ -245,7 +253,7 @@ indicates success).</p>
 
 <footer id="validator-badges" role="contentinfo">
   <p><a href="http://validator.w3.org/check/referer">Validate</a>
-  <p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.0.
+  <p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.1.
   <p>Based on <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
 </footer>
 

data/doc/Bauxite/Context.html

@@ -54,6 +54,15 @@
   </div>
 
   
+<div class="nav-section">
+  <h3>Table of Contents</h3>
+
+  <ul class="link-list" role="directory">
+    <li><a href="#class-Bauxite::Context-label-Context+variables">Context variables</a>
+    <li><a href="#class-Bauxite::Context-label-Variable+scope">Variable scope</a>
+  </ul>
+</div>
+
 
   <div id="class-metadata">
     <div id="sections-section" class="nav-section">
@@ -130,6 +139,8 @@
     
     <li ><a href="#method-i-stop">#stop</a>
     
+    <li ><a href="#method-i-with_driver_timeout">#with_driver_timeout</a>
+    
     <li ><a href="#method-i-with_timeout">#with_timeout</a>
     
     <li ><a href="#method-i-with_vars">#with_vars</a>
@@ -151,6 +162,72 @@
 by clients execute tests and by actions and selectors to interact with the
 test engine (i.e. Selenium WebDriver).</p>
 
+<h3 id="class-Bauxite::Context-label-Context+variables"><a href="Context.html">Context</a> variables<span><a href="#class-Bauxite::Context-label-Context+variables">&para;</a> <a href="#documentation">&uarr;</a></span></h3>
+
+<p><a href="Context.html">Context</a> variables are a key/value pairs scoped
+to the a test context.</p>
+
+<p>Variables can be set using different actions. For example:</p>
+<ul><li>
+<p><a href="Action.html#method-i-set">Bauxite::Action#set</a> sets a variable
+to a literal string.</p>
+</li><li>
+<p><a href="Action.html#method-i-store">Bauxite::Action#store</a> sets a
+variable to the value of an element in the page.</p>
+</li><li>
+<p><a href="Action.html#method-i-exec">Bauxite::Action#exec</a> sets a
+variable to the output of an external command (i.e. stdout).</p>
+</li><li>
+<p><a href="Action.html#method-i-js">Bauxite::Action#js</a> sets a variable to
+the result of Javascript command.</p>
+</li><li>
+<p><a href="Action.html#method-i-replace">Bauxite::Action#replace</a> sets a
+variable to the result of doing a  find-and-replace operation on a literal.</p>
+</li></ul>
+
+<p>Variables can be expanded in every <a href="Action.html">Action</a>
+argument (e.g. selectors, texts, expressions, etc.). To obtain the value of
+a variable through variable expansion the following syntax must be used:</p>
+
+<pre>${var_name}</pre>
+
+<p>For example:</p>
+
+<pre>set field &quot;greeting&quot;
+set name &quot;John&quot;
+write &quot;${field}_textbox&quot; &quot;Hi, my name is ${name}!&quot;
+click &quot;${field}_button&quot;</pre>
+
+<h3 id="class-Bauxite::Context-label-Variable+scope">Variable scope<span><a href="#class-Bauxite::Context-label-Variable+scope">&para;</a> <a href="#documentation">&uarr;</a></span></h3>
+
+<p>When the main test starts (via the <a
+href="Context.html#method-i-start">start</a> method), the test is bound to
+the global scope. The variables defined in the global scope are available
+to every test <a href="Action.html">Action</a>.</p>
+
+<p>The global scope can have nested variable scopes created by special
+actions. The variables defined in a scope <code>A</code> are only available
+to that scope and scopes nested within <code>A</code>.</p>
+
+<p>Every time an <a href="Action.html">Action</a> loads a file, a new nested
+scope is created. File-loading actions include:</p>
+<ul><li>
+<p><a href="Action.html#method-i-load">Bauxite::Action#load</a></p>
+</li><li>
+<p><a href="Action.html#method-i-tryload">Bauxite::Action#tryload</a></p>
+</li><li>
+<p><a href="Action.html#method-i-ruby">Bauxite::Action#ruby</a></p>
+</li><li>
+<p><a href="Action.html#method-i-test">Bauxite::Action#test</a></p>
+</li></ul>
+
+<p>A nested scope can bubble variables to its parent scope with the special
+action:</p>
+<ul><li>
+<p><a
+href="Action.html#method-i-return_action">Bauxite::Action#return_action</a></p>
+</li></ul>
+
   </section>
 
   
@@ -295,13 +372,14 @@ 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 69</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 113</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>
         <span class="ruby-ivar">@variables</span> = {
-                <span class="ruby-string">&#39;__TIMEOUT__&#39;</span> =<span class="ruby-operator">&gt;</span> (<span class="ruby-identifier">options</span>[<span class="ruby-value">:timeout</span>] <span class="ruby-operator">||</span> <span class="ruby-value">10</span>).<span class="ruby-identifier">to_i</span>,
-                <span class="ruby-string">&#39;__DEBUG__&#39;</span>   =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">false</span>
+                <span class="ruby-string">&#39;__TIMEOUT__&#39;</span>  =<span class="ruby-operator">&gt;</span> (<span class="ruby-identifier">options</span>[<span class="ruby-value">:timeout</span>] <span class="ruby-operator">||</span> <span class="ruby-value">10</span>).<span class="ruby-identifier">to_i</span>,
+                <span class="ruby-string">&#39;__DEBUG__&#39;</span>    =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">false</span>,
+                <span class="ruby-string">&#39;__SELECTOR__&#39;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:selector</span>] <span class="ruby-operator">||</span> <span class="ruby-string">&#39;sid&#39;</span>
         }
         <span class="ruby-ivar">@aliases</span> = {}
         <span class="ruby-ivar">@tests</span> = []
@@ -357,7 +435,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 176</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 221</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">debug</span>
         <span class="ruby-identifier">exec_action</span>(<span class="ruby-string">&#39;debug&#39;</span>, <span class="ruby-keyword">false</span>)
 <span class="ruby-keyword">end</span></pre>
@@ -414,10 +492,10 @@ 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 165</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 210</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-identifier">find</span>(<span class="ruby-identifier">selector</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</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>)
         <span class="ruby-keyword">end</span>
 <span class="ruby-keyword">end</span></pre>
           </div>
@@ -464,7 +542,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 195</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 240</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>) 
@@ -507,7 +585,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 120</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 165</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>
@@ -556,7 +634,7 @@ 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 102</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 147</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">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>
@@ -615,7 +693,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 140</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 185</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-ivar">@driver</span>.<span class="ruby-identifier">quit</span>
@@ -681,7 +759,7 @@ logger type.</p>
 
           
           <div class="method-source-code" id="load_logger-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 316</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 383</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>)
         <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>
         
@@ -723,7 +801,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 338</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 405</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>
@@ -791,7 +869,7 @@ logger type.</p>
 
           
           <div class="method-source-code" id="wait-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 309</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 376</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>
@@ -833,7 +911,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 332</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 399</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>
@@ -876,7 +954,7 @@ behavior).</p>
 
           
           <div class="method-source-code" id="exec_action-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 216</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">exec_action</span>(<span class="ruby-identifier">text</span>, <span class="ruby-identifier">log</span> = <span class="ruby-keyword">true</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-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-identifier">file</span>, <span class="ruby-identifier">line</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-identifier">text</span>, <span class="ruby-identifier">log</span>, <span class="ruby-identifier">file</span>, <span class="ruby-identifier">line</span>)
@@ -916,7 +994,7 @@ behavior).</p>
 
           
           <div class="method-source-code" id="exec_file-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 227</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">exec_file</span>(<span class="ruby-identifier">file</span>)
         <span class="ruby-ivar">@parser</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">file</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">action</span>, <span class="ruby-identifier">args</span>, <span class="ruby-identifier">text</span>, <span class="ruby-identifier">file</span>, <span class="ruby-identifier">line</span><span class="ruby-operator">|</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">text</span>, <span class="ruby-keyword">true</span>, <span class="ruby-identifier">file</span>, <span class="ruby-identifier">line</span>)
@@ -971,7 +1049,7 @@ handler will not exit after printing the error message.</p>
 
           
           <div class="method-source-code" id="handle_errors-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 252</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 297</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">handle_errors</span>(<span class="ruby-identifier">break_into_debug</span> = <span class="ruby-keyword">false</span>, <span class="ruby-identifier">exit_on_error</span> = <span class="ruby-keyword">true</span>)
         <span class="ruby-keyword">yield</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>
@@ -1003,6 +1081,57 @@ handler will not exit after printing the error message.</p>
         
 
         
+      </div>
+
+    
+      <div id="method-i-with_driver_timeout" class="method-detail ">
+        
+        <div class="method-heading">
+          <span class="method-name">with_driver_timeout</span><span
+            class="method-args">(timeout) { || ... }</span>
+          
+          <span class="method-click-advice">click to toggle source</span>
+          
+        </div>
+        
+
+        <div class="method-description">
+          
+          <p>Executes the given block using the specified driver <code>timeout</code>.</p>
+
+<p>Note that the driver <code>timeout</code> is the time (in seconds) Selenium
+will wait for a specific element to appear in the page (using any of the
+available <a href="Selector.html">Selector</a> strategies).</p>
+
+<p>For example</p>
+
+<pre class="ruby"><span class="ruby-identifier">ctx</span>.<span class="ruby-identifier">with_driver_timeout</span> <span class="ruby-value">0.5</span> <span class="ruby-keyword">do</span>
+    <span class="ruby-identifier">ctx</span>.<span class="ruby-identifier">find</span> (<span class="ruby-string">&#39;find_me_quickly&#39;</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span>
+        <span class="ruby-comment"># do something with e</span>
+    <span class="ruby-keyword">end</span>
+<span class="ruby-keyword">end</span>
+</pre>
+          
+          
+
+          
+          <div class="method-source-code" id="with_driver_timeout-source">
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 361</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>
+        <span class="ruby-keyword">yield</span>
+<span class="ruby-keyword">ensure</span>
+        <span class="ruby-ivar">@driver_timeout</span> = <span class="ruby-identifier">current</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">current</span>
+<span class="ruby-keyword">end</span></pre>
+          </div>
+          
+        </div>
+
+        
+
+        
       </div>
 
     
@@ -1036,7 +1165,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 288</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 333</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>]
@@ -1117,7 +1246,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 391</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 458</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> }
@@ -1157,7 +1286,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 381</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 448</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>
@@ -1196,7 +1325,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 420</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 487</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>
@@ -1238,7 +1367,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 444</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 511</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>
@@ -1277,7 +1406,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 430</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 497</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> }
@@ -1321,7 +1450,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 406</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 473</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>
@@ -1403,7 +1532,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 465</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 532</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>)
@@ -1456,7 +1585,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 488</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 555</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>)
@@ -1482,7 +1611,7 @@ variables is restored.</p>
 
 <footer id="validator-badges" role="contentinfo">
   <p><a href="http://validator.w3.org/check/referer">Validate</a>
-  <p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.0.
+  <p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.1.
   <p>Based on <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
 </footer>