bauxite 0.4.5 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b814f19ff06421cccdeaeaf132a5977ec7db4e8f
-  data.tar.gz: 99a5eeab70836e91ae71e4d46a6cafba25b1e2a4
+  metadata.gz: 3d2de14a5ada49ae2a057af9b513f46c2a2916f2
+  data.tar.gz: 0743f340ef2e0d1030af41db4aebdc731bcbd8c6
 SHA512:
-  metadata.gz: bf31de624cb941fc831973d51adee95b78632e87ff75cf4ff01a818a2f85aaab7312de68b68eef282dd1ef30a3b92e75baf13d12e6346b76ca47ed1b8a5dbe47
-  data.tar.gz: e4f7a6a65891bd76a3428b61457a488fd3ef3b624a7132e3cd822f94a1fc9697434bb821ad6aca6a9397d185ab7c900baf7bfcaa710e6f7678556ba70a12f501
+  metadata.gz: cdeeab574ae065d77a2804aff4a0821c535ecbd07b3da0db488e5c2681f26e34ea6d31620a9567967106f710186cebefde3580ad68bc4b4aad1b5efcbe5fb3b2
+  data.tar.gz: f4020a1a39e42018318d125154ab8909d1ad012bdabbb6b8af293023c3fd0e28411595de2736a3c56d603b4fd6161cb6c917831654c22a02cd1c79b4bff23a5f

data/README.md

@@ -96,7 +96,7 @@ For example, in this HTML fragment:
 
     <input type="text" name="q" />
 
-If we want to type the text "Hello WebDriver!" in textbox we can do the following:
+If we want to type the text "Hello WebDriver!" in the textbox we can do the following:
 
     write "name=q" "Hello WebDriver!"
 
@@ -273,11 +273,11 @@ Assuming you have Selenium Server running on localhost and your workspace (e.g.
     # === suite.bxt === #
     test login.bxt
     test register.bxt
-    test browse_arround.bxt
+    test browse_around.bxt
     test purchase_something.bxt
     # more tests here...
 
-Note the `--csv-summary` option in the configuration above. That option generates a single-ling CSV file ideal to feed 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 `--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:
 
     <publishers>
       ...

data/Rakefile

@@ -9,7 +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.description = 'Bauxite is a façade over Selenium intended for non-developers. 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'

data/doc/Bauxite/Context.html

@@ -60,6 +60,7 @@
   <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>
+    <li><a href="#class-Bauxite::Context-label-Built-in+variable">Built-in variable</a>
   </ul>
 </div>
 
@@ -232,6 +233,39 @@ action:</p>
 href="Action.html#method-i-return_action">Bauxite::Action#return_action</a></p>
 </li></ul>
 
+<h3 id="class-Bauxite::Context-label-Built-in+variable">Built-in variable<span><a href="#class-Bauxite::Context-label-Built-in+variable">&para;</a> <a href="#documentation">&uarr;</a></span></h3>
+
+<p><a href="../Bauxite.html">Bauxite</a> has a series of built-in variables
+that provide information of the current test context and allow dynamic
+constomizations of the test behavior.</p>
+
+<p>The built-in variables are:</p>
+<dl class="rdoc-list label-list"><dt><code>__FILE__</code>
+<dd>
+<p>The file where the current action is defined.</p>
+</dd><dt><code>__DIR__</code>
+<dd>
+<p>The directory where <code>__FILE__</code> is.</p>
+</dd><dt><code>__SELECTOR__</code>
+<dd>
+<p>The default selector used when the selector specified does not contain an
+<code>=</code> character.</p>
+</dd><dt><code>__DEBUG__</code>
+<dd>
+<p>Set to true if the current action is being executed by the debug console.</p>
+</dd><dt><code>__RETURN__</code>
+<dd>
+<p>Used internally by <a
+href="Action.html#method-i-return_action">Bauxite::Action#return_action</a>
+to indicate which variables should be returned to the parent scope.</p>
+</dd></dl>
+
+<p>In general, variables surrounded by double underscores and variables whose
+names are only numbers are reserved for <a
+href="../Bauxite.html">Bauxite</a> and should not be used as part of a
+functional test. The obvious exception is when trying to change the test
+behavior by changing the built-in variables.</p>
+
   </section>
 
   
@@ -376,7 +410,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 113</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 140</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>
@@ -444,7 +478,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 226</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 253</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>
@@ -501,7 +535,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 215</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 242</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>)
@@ -551,7 +585,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 245</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">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>) 
@@ -594,7 +628,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 170</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 197</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>
@@ -643,7 +677,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 152</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 179</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>
@@ -702,7 +736,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 190</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 217</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>
@@ -768,7 +802,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 388</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 415</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>
         
@@ -810,7 +844,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 410</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 437</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>
@@ -878,7 +912,7 @@ logger type.</p>
 
           
           <div class="method-source-code" id="wait-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 408</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>
@@ -920,7 +954,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 404</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 431</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>
@@ -963,7 +997,7 @@ behavior).</p>
 
           
           <div class="method-source-code" id="exec_action-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 293</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>)
@@ -1011,7 +1045,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 488</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 515</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">exec_action_object</span>(<span class="ruby-identifier">action</span>)
         <span class="ruby-comment"># Inject built-in variables</span>
         <span class="ruby-identifier">file</span> = <span class="ruby-identifier">action</span>.<span class="ruby-identifier">file</span>
@@ -1055,7 +1089,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 277</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 304</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>)
@@ -1097,7 +1131,7 @@ preferred.</p>
 
           
           <div class="method-source-code" id="get_action-source">
-            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 450</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 477</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-identifier">file</span>, <span class="ruby-identifier">line</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>]
@@ -1171,7 +1205,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 302</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 329</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>
@@ -1238,7 +1272,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 366</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 393</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>
@@ -1287,7 +1321,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 338</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 365</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>]
@@ -1368,7 +1402,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 518</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 545</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> }
@@ -1408,7 +1442,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 508</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 535</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>
@@ -1447,7 +1481,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 547</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 574</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>
@@ -1489,7 +1523,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 571</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 598</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>
@@ -1528,7 +1562,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 557</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 584</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> }
@@ -1572,7 +1606,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 533</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 560</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>
@@ -1654,7 +1688,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 592</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 619</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>)
@@ -1707,7 +1741,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 615</span>
+            <pre><span class="ruby-comment"># File lib/bauxite/core/context.rb, line 642</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>)

data/doc/Bauxite/Selector.html

@@ -443,7 +443,7 @@ specified)</p>
 </li><li>
 <p>by text content (unless the element is a label)</p>
 </li><li>
-<p>by radio/checkbox button value</p>
+<p>by radio/checkbox/button/submit value</p>
 </li><li>
 <p>by referenced element (find a label by its text, then find the element
 pointed by the label&#39;s <code>for</code> attribute)</p>
@@ -472,7 +472,14 @@ child control element, including input, select, textarea and button).</p>
         <span class="ruby-identifier">target</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">_smart_try_find</span> { <span class="ruby-identifier">attr</span>(<span class="ruby-string">&quot;id*:&quot;</span><span class="ruby-operator">+</span><span class="ruby-identifier">arg</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">b</span>)            }
         <span class="ruby-identifier">target</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">_smart_try_find</span> { <span class="ruby-identifier">attr</span>(<span class="ruby-string">&quot;placeholder:&quot;</span><span class="ruby-operator">+</span><span class="ruby-identifier">arg</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">b</span>)    }
         <span class="ruby-identifier">quoted_arg</span> = <span class="ruby-string">&quot;&#39;&quot;</span><span class="ruby-operator">+</span><span class="ruby-identifier">arg</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-string">&quot;&#39;&quot;</span>, <span class="ruby-string">&quot;\\&#39;&quot;</span>)<span class="ruby-operator">+</span><span class="ruby-string">&quot;&#39;&quot;</span>
-        <span class="ruby-identifier">target</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">_smart_try_find</span> { <span class="ruby-identifier">selenium_find</span>(<span class="ruby-value">:css</span>, <span class="ruby-node">&quot;input[type=&#39;checkbox&#39;][value=#{quoted_arg}],input[type=&#39;radio&#39;][value=#{quoted_arg}]&quot;</span>) }
+        <span class="ruby-identifier">target</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">_smart_try_find</span> <span class="ruby-keyword">do</span>
+                <span class="ruby-identifier">selenium_find</span>(<span class="ruby-value">:css</span>, [<span class="ruby-node">&quot;input[type=&#39;checkbox&#39;][value=#{quoted_arg}]&quot;</span>,
+                        <span class="ruby-node">&quot;input[type=&#39;radio&#39;][value=#{quoted_arg}]&quot;</span>,
+                        <span class="ruby-node">&quot;input[type=&#39;button&#39;][value=#{quoted_arg}]&quot;</span>,
+                        <span class="ruby-node">&quot;input[type=&#39;submit&#39;][value=#{quoted_arg}]&quot;</span>
+                        ].<span class="ruby-identifier">join</span>(<span class="ruby-string">&#39;,&#39;</span>)
+                )
+        <span class="ruby-keyword">end</span>
         <span class="ruby-keyword">return</span> <span class="ruby-keyword">yield</span> <span class="ruby-identifier">target</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">target</span>
         
         <span class="ruby-identifier">target</span> = <span class="ruby-identifier">selenium_find</span>(<span class="ruby-value">:xpath</span>, <span class="ruby-node">&quot;//*[contains(text(), &#39;#{arg.gsub(&quot;&#39;&quot;, &quot;\\&#39;&quot;)}&#39;)]&quot;</span>)

data/doc/README_md.html

@@ -213,7 +213,7 @@ the <code>=</code> sign.</p>
 
 <pre>&lt;input type=&quot;text&quot; name=&quot;q&quot; /&gt;</pre>
 
-<p>If we want to type the text “Hello WebDriver!” in textbox we can do the
+<p>If we want to type the text “Hello WebDriver!” in the textbox we can do the
 following:</p>
 
 <pre>write &quot;name=q&quot; &quot;Hello WebDriver!&quot;</pre>
@@ -457,15 +457,16 @@ bauxite -l echo -u http://localhost:4444/wd/hub          \
 <pre># === suite.bxt === #
 test login.bxt
 test register.bxt
-test browse_arround.bxt
+test browse_around.bxt
 test purchase_something.bxt
 # more tests here...</pre>
 
 <p>Note the <code>--csv-summary</code> option in the configuration above. That
-option generates a single-ling CSV file ideal to feed the <code>Plot</code>
-Jenkins plugin. I won&#39;t go into the details of configuring the Plot
-plugin, but instead here is a fragment of a possible Jenkins config.xml
-plotting the <a href="Bauxite.html">Bauxite</a> test results:</p>
+option generates a single-line CSV file ideal to feed into the
+<code>Plot</code> Jenkins plugin. I won&#39;t go into the details of
+configuring the Plot plugin, but instead here is a fragment of a possible
+Jenkins <code>config.xml</code> plotting the <a
+href="Bauxite.html">Bauxite</a> test results:</p>
 
 <pre>&lt;publishers&gt;
   ...

data/doc/created.rid

@@ -1,5 +1,5 @@
-Thu, 30 Jan 2014 21:35:43 -0300
-README.md	Thu, 30 Jan 2014 21:30:21 -0300
+Fri, 31 Jan 2014 20:58:25 -0300
+README.md	Fri, 31 Jan 2014 08:21:19 -0300
 lib/bauxite/actions/break.rb	Mon, 27 Jan 2014 20:58:50 -0300
 lib/bauxite/actions/assert.rb	Mon, 27 Jan 2014 20:58:50 -0300
 lib/bauxite/actions/wait.rb	Mon, 27 Jan 2014 20:58:50 -0300
@@ -32,13 +32,13 @@ lib/bauxite/parsers/default.rb	Mon, 27 Jan 2014 20:58:50 -0300
 lib/bauxite/application.rb	Thu, 30 Jan 2014 20:35:05 -0300
 lib/bauxite/core/errors.rb	Mon, 27 Jan 2014 20:58:50 -0300
 lib/bauxite/core/selector.rb	Tue, 28 Jan 2014 21:05:35 -0300
-lib/bauxite/core/context.rb	Thu, 30 Jan 2014 20:50:42 -0300
+lib/bauxite/core/context.rb	Fri, 31 Jan 2014 20:56:57 -0300
 lib/bauxite/core/logger.rb	Mon, 27 Jan 2014 20:58:50 -0300
 lib/bauxite/core/action.rb	Mon, 27 Jan 2014 20:58:50 -0300
 lib/bauxite/core/parser.rb	Mon, 27 Jan 2014 20:58:50 -0300
 lib/bauxite/selectors/sid.rb	Tue, 28 Jan 2014 19:32:32 -0300
 lib/bauxite/selectors/attr.rb	Mon, 27 Jan 2014 20:58:50 -0300
-lib/bauxite/selectors/smart.rb	Tue, 28 Jan 2014 21:11:30 -0300
+lib/bauxite/selectors/smart.rb	Fri, 31 Jan 2014 20:43:53 -0300
 lib/bauxite/selectors/frame.rb	Tue, 28 Jan 2014 19:38:40 -0300
 lib/bauxite/loggers/terminal.rb	Mon, 27 Jan 2014 20:58:50 -0300
 lib/bauxite/loggers/file.rb	Mon, 27 Jan 2014 20:58:50 -0300

data/doc/index.html

@@ -243,7 +243,7 @@ the <code>=</code> sign.</p>
 
 <pre>&lt;input type=&quot;text&quot; name=&quot;q&quot; /&gt;</pre>
 
-<p>If we want to type the text “Hello WebDriver!” in textbox we can do the
+<p>If we want to type the text “Hello WebDriver!” in the textbox we can do the
 following:</p>
 
 <pre>write &quot;name=q&quot; &quot;Hello WebDriver!&quot;</pre>
@@ -487,15 +487,16 @@ bauxite -l echo -u http://localhost:4444/wd/hub          \
 <pre># === suite.bxt === #
 test login.bxt
 test register.bxt
-test browse_arround.bxt
+test browse_around.bxt
 test purchase_something.bxt
 # more tests here...</pre>
 
 <p>Note the <code>--csv-summary</code> option in the configuration above. That
-option generates a single-ling CSV file ideal to feed the <code>Plot</code>
-Jenkins plugin. I won&#39;t go into the details of configuring the Plot
-plugin, but instead here is a fragment of a possible Jenkins config.xml
-plotting the <a href="Bauxite.html">Bauxite</a> test results:</p>
+option generates a single-line CSV file ideal to feed into the
+<code>Plot</code> Jenkins plugin. I won&#39;t go into the details of
+configuring the Plot plugin, but instead here is a fragment of a possible
+Jenkins <code>config.xml</code> plotting the <a
+href="Bauxite.html">Bauxite</a> test results:</p>
 
 <pre>&lt;publishers&gt;
   ...

data/doc/table_of_contents.html

@@ -77,6 +77,7 @@
     <ul>
       <li><a href="Bauxite/Context.html#label-Context+variables">Context variables</a>
       <li><a href="Bauxite/Context.html#label-Variable+scope">Variable scope</a>
+      <li><a href="Bauxite/Context.html#label-Built-in+variable">Built-in variable</a>
       <li><a href="Bauxite/Context.html#5Buntitled-5D">Top Section</a>
       <li><a href="Bauxite/Context.html#Advanced+Helpers">Advanced Helpers</a>
       <li><a href="Bauxite/Context.html#Metadata">Metadata</a>

data/lib/bauxite/core/context.rb

@@ -83,6 +83,28 @@ module Bauxite
 	# action:
 	# - Action#return_action
 	#
+	# === Built-in variable
+	# Bauxite has a series of built-in variables that provide information of
+	# the current test context and allow dynamic constomizations of the test
+	# behavior.
+	#
+	# The built-in variables are:
+	# [<tt>__FILE__</tt>] The file where the current action is defined.
+	# [<tt>__DIR__</tt>] The directory where <tt>__FILE__</tt> is.
+	# [<tt>__SELECTOR__</tt>] The default selector used when the selector
+	#                         specified does not contain an <tt>=</tt>
+	#                         character.
+	# [<tt>__DEBUG__</tt>] Set to true if the current action is being executed
+	#                      by the debug console.
+	# [<tt>__RETURN__</tt>] Used internally by Action#return_action to indicate
+	#                       which variables should be returned to the parent
+	#                       scope.
+	#
+	# In general, variables surrounded by double underscores and variables
+	# whose names are only numbers are reserved for Bauxite and should not be
+	# used as part of a functional test. The obvious exception is when trying
+	# to change the test behavior by changing the built-in variables.
+	#
 	class Context
 		# Test engine driver instance (Selenium WebDriver).
 		attr_reader :driver
@@ -104,11 +126,16 @@ module Bauxite
 		# +options+ is a hash with the following values:
 		# [:driver] selenium driver symbol (defaults to +:firefox+)
 		# [:timeout] selector timeout in seconds (defaults to +10s+)
-		# [:logger] logger implementation name without the 'Logger' suffix (defaults to 'null' for Loggers::NullLogger).
-		# [:verbose] if +true+, show verbose error information (e.g. backtraces) if an error occurs (defaults to +false+)
-		# [:debug] if +true+, break into the #debug console if an error occurs (defaults to +false+)
-		# [:wait] if +true+, call ::wait before stopping the test engine with #stop (defaults to +false+)
-		# [:extensions] an array of directories that contain extensions to be loaded
+		# [:logger] logger implementation name without the 'Logger' suffix
+		#           (defaults to 'null' for Loggers::NullLogger).
+		# [:verbose] if +true+, show verbose error information (e.g.
+		#            backtraces) if an error occurs (defaults to +false+)
+		# [:debug] if +true+, break into the #debug console if an error occurs
+		#          (defaults to +false+)
+		# [:wait] if +true+, call ::wait before stopping the test engine with
+		#         #stop (defaults to +false+)
+		# [:extensions] an array of directories that contain extensions to be
+		#               loaded
 		#
 		def initialize(options)
 			@options = options

data/lib/bauxite/selectors/smart.rb

@@ -30,7 +30,7 @@ class Bauxite::Selector
 	# 4. by +id+ fragment (the +id+ contains the text specified)
 	# 5. by +placeholder+ attribute
 	# 6. by text content (unless the element is a label)
-	# 7. by radio/checkbox button value
+	# 7. by radio/checkbox/button/submit value
 	# 8. by referenced element (find a label by its text, then find the element
 	#    pointed by the label's +for+ attribute)
 	# 9. by child element (find a label by its text, then find the first
@@ -51,7 +51,14 @@ class Bauxite::Selector
 		target ||= _smart_try_find { attr("id*:"+arg, &b)            }
 		target ||= _smart_try_find { attr("placeholder:"+arg, &b)    }
 		quoted_arg = "'"+arg.gsub("'", "\\'")+"'"
-		target ||= _smart_try_find { selenium_find(:css, "input[type='checkbox'][value=#{quoted_arg}],input[type='radio'][value=#{quoted_arg}]") }
+		target ||= _smart_try_find do
+			selenium_find(:css, ["input[type='checkbox'][value=#{quoted_arg}]",
+				"input[type='radio'][value=#{quoted_arg}]",
+				"input[type='button'][value=#{quoted_arg}]",
+				"input[type='submit'][value=#{quoted_arg}]"
+				].join(',')
+			)
+		end
 		return yield target if target
 		
 		target = selenium_find(:xpath, "//*[contains(text(), '#{arg.gsub("'", "\\'")}')]")

data/lib/bauxite.rb

@@ -22,7 +22,7 @@
 
 #--
 module Bauxite
-	VERSION = "0.4.5"
+	VERSION = "0.4.6"
 end
 #++
 

data/test/smart_selector/page.html

@@ -9,5 +9,10 @@
 		<div><label for="my_input">By label sibling</label><input id="my_input" type="text" value="By label sibling"/></div>
 		<input type="radio" name="radio" value="By radio value"/>
 		<input type="checkbox" name="checkbox" value="By checkbox value"/>
+		<input type="submit" value="By submit text"  onclick="document.getElementById('btn_text').setAttribute('value', this.getAttribute('value'));"/>
+		<input type="button" value="By input button text" onclick="document.getElementById('btn_text').setAttribute('value', this.getAttribute('value'));"/>
+		<button onclick="document.getElementById('btn_text').setAttribute('value', this.innerHTML);">By button text</button>
+		
+		<input type="text" id="btn_text"/>
 	</body>
 </html>

data/test/smart_selector.bxt

@@ -9,3 +9,9 @@ assert "smart=By label sibling" "By label sibling"
 assert "smart=By label parent" "By label parent"
 assert "smart=By radio value" "By radio value"
 assert "smart=By checkbox value" "By checkbox value"
+click "smart=By submit text"
+assert btn_text "By submit text"
+click "smart=By input button text"
+assert btn_text "By input button text"
+click "smart=By button text"
+assert btn_text "By button text"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bauxite
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.4.6
 platform: ruby
 authors:
 - Patricio Zavolinsky
@@ -38,10 +38,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.1'
-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.
+description: Bauxite is a façade over Selenium intended for non-developers. 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.
 email: pzavolinsky at yahoo dot com dot ar
 executables:
 - bauxite