bauxite 0.1.0

data/lib/bauxite/actions/break.rb

@@ -0,0 +1,39 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Prompts the user to press ENTER before resuming execution.
+	#
+	# Note that this method provides an action named +break+ and not
+	# break_action.
+	#
+	# See Context::wait.
+	#
+	# For example:
+	#     break
+	#     # => echoes "Press ENTER to continue" and waits for user input
+	#
+	# :category: Action Methods
+	def break_action
+		lambda { Bauxite::Context::wait }
+	end
+end

data/lib/bauxite/actions/click.rb

@@ -0,0 +1,35 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Triggers the +click+ event on the selected element.
+	#
+	# For example:
+	#     # assuming <button type="button" id="btn">click me</button>
+	#     click btn
+	#     # => this would click the button
+	#
+	# :category: Action Methods
+	def click(selector)
+		@ctx.find(selector) { |e| e.click }
+	end
+end

data/lib/bauxite/actions/debug.rb

@@ -0,0 +1,99 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Breaks into the debug console.
+	#
+	# In the debug console you can type action strings and test their result.
+	#
+	# The debug console supports a history of previously executed actions and
+	# autocomplete (pressing the +TAB+ key).
+	#
+	# For example:
+	#     debug
+	#     # => this breaks into the debug console
+	# :category: Action Methods
+	def debug
+		lambda { _debug_process }
+	end
+	
+private
+	@@debug_line = 0
+	def _debug_process
+		Readline.completion_append_character = " "
+		Readline.completer_word_break_characters = ""
+		Readline.completion_proc = lambda { |str| _debug_auto_complete(str) }
+		
+		while line = _debug_get_line
+			break if line.strip == 'exit'
+			@ctx.handle_errors(false, false) do
+				@ctx.exec_action({ :text => line, :file => '<debug>', :line => @@debug_line }, true)
+			end
+			@@debug_line += 1
+		end
+	end
+
+	def _debug_get_line
+		line = Readline.readline(@ctx.logger.debug_prompt, true)
+		return nil if line.nil?
+		if line =~ /^\s*$/ or Readline::HISTORY.to_a[-2] == line
+			Readline::HISTORY.pop
+		end
+		line
+	end
+	
+	def _debug_auto_complete(str)
+		action_name = str.sub(/ .*/, '')
+		#puts "\n\nac: ==>#{str}<==\nname: ==>#{action_name}<==\n\n"
+		
+		actions = (Bauxite::Context::actions + ['exit']).grep(/^#{Regexp.escape(action_name)}/)
+		
+		return actions unless actions.size == 1 and actions[0] == action_name and action_name != 'exit'
+		
+		args = str.sub(/^\S+ /, '')
+		
+		data = ['']
+		
+		if args != ''
+			begin
+				data = Bauxite::Context::parse_args(args)
+			rescue
+			#puts "\nhasta aca\n"
+				return []
+			end
+		end
+		return [] if data.size == 0
+		
+		arg_name = Bauxite::Context::action_args(actions[0])[data.size - 1]
+		return [] if arg_name != 'selector'
+		
+		arg_value = data[-1]
+		#puts "\n\val: ==>#{arg_value}<==\n\n"
+		
+		data.pop
+		data = data.join('" "')
+		data = '"'+data+'" ' if data.size > 0
+		
+		selectors = Bauxite::Context::selectors.grep(/^#{Regexp.escape(arg_value)}/)
+			.map { |s| "#{action_name} #{data}#{s}=" }
+	end
+end

data/lib/bauxite/actions/echo.rb

@@ -0,0 +1,36 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Prints the value of the specified +text+.
+	#
+	# +text+ is subject to variable expansion (see Context#expand).
+	#
+	# For example:
+	#     echo "Hello World!"
+	#     # => this would print "Hello World!" in the terminal window.
+	#
+	# :category: Action Methods
+	def echo(text)
+		true
+	end
+end

data/lib/bauxite/actions/exec.rb

@@ -0,0 +1,46 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Executes +command+, optionally storing the results in a variable.
+	#
+	# If the first argument of +command+ is <tt>name=...</tt> the results
+	# of the execution will be assigned to the variable named +name+.
+	#
+	# For example:
+	#     exec "that_day=date --date='2001-01-01' | cut -f 1 -d ' '"
+	#     echo "${that_day}"
+	#     # => this would print 'Mon'
+	#
+	# :category: Action Methods
+	def exec(*command)
+		data = command[0].split('=', 2)
+		name = nil
+		if (data.size == 2)
+			name = data[0]
+			command[0] = data[1]
+		end
+
+		ret = `#{command.join(' ')}`
+		@ctx.variables[name] = ret.strip if name
+	end
+end

data/lib/bauxite/actions/js.rb

@@ -0,0 +1,41 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Executes the specified Javascript +script+, optionally storing the
+	# results the variable named +name+.
+	#
+	# Note that if +name+ is provided, the script must return a value using
+	# the Javascript +return+ statement.
+	#
+	# For example:
+	#     js "return document.title" title_var
+	#     echo "${title_var}"
+	#     # => this would print the title of the page
+	#
+	# :category: Action Methods
+	def js(script, name = nil)
+		result = @ctx.driver.execute_script(script)
+		@ctx.variables[name] = result if name
+		true
+	end
+end

data/lib/bauxite/actions/load.rb

@@ -0,0 +1,49 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Load the specified file into an isolated variable context and execute
+	# the actions specified. If the file does not exist, this action fails.
+	# See #tryload for a similar action that skips if the file does not exist.
+	#
+	# +file+ can be a path relative to the current test file.
+	#
+	# An optional list of variables can be provided in +vars+. These variables
+	# will override the value of the context variables for the execution of the
+	# file (See Context#with_vars).
+	#
+	# The syntax of the variable specification is:
+	#     "var1_name=var1_value" "var2_name=var2_value" ...
+	#
+	# For example:
+	#     load other_test.bxt "othervar=value_just_for_other"
+	#     echo "${othervar}"
+	#     # => this would load and execute other_test.bxt, injecting othervar
+	#     #    into its context. After other_test.bxt completes, othervar will
+	#     #    be restored to its original value (or be undefined if it didn't
+	#     #    exist prior to the 'load' call).
+	#
+	# :category: Action Methods
+	def load(file, *vars)
+		tryload(file, *vars) || (raise Bauxite::Errors::FileNotFoundError, "File not found: #{file}")
+	end
+end

data/lib/bauxite/actions/open.rb

@@ -0,0 +1,34 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Opens the specified +url+ in the browser.
+	#
+	# For example:
+	#     open "http://www.ruby-lang.org"
+	#     # => this would open http://www.ruby-lang.org in the browser window
+	#
+	# :category: Action Methods
+	def open(url)
+		@ctx.driver.navigate.to url
+	end
+end

data/lib/bauxite/actions/params.rb

@@ -0,0 +1,40 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Asserts that the variables named +vars+ are defined and not empty.
+	#
+	# For example:
+	#     params host db_name username password
+	#     # => this would fail if any of the four variables listed above
+	#     #    is not defined or is empty
+	#
+	# :category: Action Methods
+	def params(*vars)
+		missing = vars.select { |v| (@ctx.variables[v] || '') == '' }.join(', ')
+		if missing != ''
+			raise Bauxite::Errors::AssertionError, 
+				"Assertion failed: the following variables must be defined and not be empty: #{missing}."
+		end
+		true
+	end
+end

data/lib/bauxite/actions/replace.rb

@@ -0,0 +1,37 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Replaces the occurrences of +pattern+ in +text+ with +replacement+ and
+	# assigns the result to the variable named +name+.
+	#
+	# For example:
+	#     set place "World"
+	#     replace "Hello ${place}" "World" "Universe" greeting
+	#     echo "${greeting}!"
+	#     # => this would print 'Hello Universe!'
+	#
+	# :category: Action Methods
+	def replace(text, pattern, replacement, name)
+		@ctx.variables[name] = text.gsub(_pattern(pattern), replacement)
+	end
+end

data/lib/bauxite/actions/reset.rb

@@ -0,0 +1,37 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Resets the test engine by closing and reopening the browser. As a side
+	# effect of resetting the test engine, all cookies, logins and cache items
+	# are destroyed.
+	#
+	# For example:
+	#     reset
+	#     # => this would close and re-open the browser window, removing 
+	#     #    cookies, cache, login sessions, etc.
+	#
+	# :category: Action Methods
+	def reset()
+		@ctx.reset_driver
+	end
+end

data/lib/bauxite/actions/return.rb

@@ -0,0 +1,62 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Returns the specified variables to the parent scope (if any).
+	#
+	# If +vars+ is <tt>*</tt> every variable defined in the current scope
+	# will be returned to the parent scope.
+	#
+	# The syntax of the variable specification is:
+	#     "var1_name" "var2_name" ...
+	#
+	# Note that this method provides an action named +return+ and not
+	# return_action.
+	#
+	# For example:
+	#     set result "42"
+	#     return result
+	#     # => this would inject the result variable (whose value is 42)
+	#     #    into the calling context.
+	#
+	# Full example (see #load, #write, #click, #store and #assert for more
+	# details):
+	#     # in main.bxt
+	#     load login.txt "username=jdoe" "password=hello world!"
+	#
+	#         # in login.bxt
+	#         write id=user "${username}"
+	#         write id=pass "${password}"
+	#         click id=login
+	#         store id=loginName fullName
+	#         return fullName
+	#
+	#     # back in main.bxt
+	#     assert id=greeting "Welcome ${fullName}!"
+	#     # => this assertion uses the variable returned from login.bxt
+	#
+	# :category: Action Methods
+	def return_action(*vars)
+		rets = @ctx.variables['__RETURN__'] || []
+		@ctx.variables['__RETURN__'] = rets + vars
+	end
+end

data/lib/bauxite/actions/ruby.rb

@@ -0,0 +1,58 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Load the specified ruby file into an isolated variable context and
+	# execute the ruby code.
+	#
+	# +file+ can be a path relative to the current test file.
+	#
+	# An optional list of variables can be provided in +vars+. See #load.
+	#
+	# The ruby action file must contain a single lambda that takes a Context
+	# instance as its only argument.
+	#
+	# For example:
+	#     # === my_test.rb ======= #
+	#     lambda do |ctx|
+	#         ctx.exec_action 'echo "${message}"'
+	#         ctx.driver.navigate.to 'http://www.ruby-lang.org'
+	#         ctx.variables['new'] = 'from ruby!'
+	#         ctx.exec_action 'return new'
+	#     end
+	#     # === end my_test.rb === #
+	#
+	#     # in main.bxt
+	#     ruby my_test.rb "message=Hello World!"
+	#     echo "${new}"
+	#     # => this would print 'from ruby!'
+	#
+	# :category: Action Methods
+	def ruby(file, *vars)
+		# _load_file_action is defined in tryload.rb
+		_load_file_action(file, *vars) do |f|
+			content = ''
+			File.open(f, 'r') { |ff| content = ff.read }
+			eval(content).call(@ctx)
+		end || (raise Bauxite::Errors::FileNotFoundError, "File not found: #{file}")
+	end
+end

data/lib/bauxite/actions/set.rb

@@ -0,0 +1,39 @@
+#--
+# Copyright (c) 2014 Patricio Zavolinsky
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#++
+
+class Bauxite::Action
+	# Sets the variable named +name+ to the +value+ specified.
+	#
+	# Both +name+ and +value+ are subject to variable expansion
+	# (see Context#expand).
+	#
+	# For example:
+	#     set one "uno"
+	#     set two "${one} + ${one}"
+	#     echo "${two}"
+	#     # => this would print 'uno + uno'
+	#
+	# :category: Action Methods
+	def set(name, value)
+		@ctx.variables[name] = value
+	end
+end