RubyGems - bauxite - Versions diffs - 0.1.0 - Mend

bauxite 0.1.0

Files changed (124) hide show

checksums.yaml +7 -0
data/LICENSE +21 -0
data/Rakefile +69 -0
data/bin/bauxite +27 -0
data/doc/Bauxite/Action.html +1463 -0
data/doc/Bauxite/ActionModule.html +342 -0
data/doc/Bauxite/Context.html +1439 -0
data/doc/Bauxite/Errors/AssertionError.html +107 -0
data/doc/Bauxite/Errors/FileNotFoundError.html +107 -0
data/doc/Bauxite/Errors.html +100 -0
data/doc/Bauxite/Loggers/CompositeLogger.html +325 -0
data/doc/Bauxite/Loggers/EchoLogger.html +164 -0
data/doc/Bauxite/Loggers/FileLogger.html +215 -0
data/doc/Bauxite/Loggers/NullLogger.html +334 -0
data/doc/Bauxite/Loggers/TerminalLogger.html +586 -0
data/doc/Bauxite/Loggers/XtermLogger.html +287 -0
data/doc/Bauxite/Loggers.html +103 -0
data/doc/Bauxite/Selector.html +422 -0
data/doc/Bauxite/SelectorModule.html +283 -0
data/doc/Bauxite.html +98 -0
data/doc/created.rid +37 -0
data/doc/fonts/Lato-Light.ttf +0 -0
data/doc/fonts/Lato-LightItalic.ttf +0 -0
data/doc/fonts/Lato-Regular.ttf +0 -0
data/doc/fonts/Lato-RegularItalic.ttf +0 -0
data/doc/fonts/SourceCodePro-Bold.ttf +0 -0
data/doc/fonts/SourceCodePro-Regular.ttf +0 -0
data/doc/fonts.css +167 -0
data/doc/images/add.png +0 -0
data/doc/images/arrow_up.png +0 -0
data/doc/images/brick.png +0 -0
data/doc/images/brick_link.png +0 -0
data/doc/images/bug.png +0 -0
data/doc/images/bullet_black.png +0 -0
data/doc/images/bullet_toggle_minus.png +0 -0
data/doc/images/bullet_toggle_plus.png +0 -0
data/doc/images/date.png +0 -0
data/doc/images/delete.png +0 -0
data/doc/images/find.png +0 -0
data/doc/images/loadingAnimation.gif +0 -0
data/doc/images/macFFBgHack.png +0 -0
data/doc/images/package.png +0 -0
data/doc/images/page_green.png +0 -0
data/doc/images/page_white_text.png +0 -0
data/doc/images/page_white_width.png +0 -0
data/doc/images/plugin.png +0 -0
data/doc/images/ruby.png +0 -0
data/doc/images/tag_blue.png +0 -0
data/doc/images/tag_green.png +0 -0
data/doc/images/transparent.png +0 -0
data/doc/images/wrench.png +0 -0
data/doc/images/wrench_orange.png +0 -0
data/doc/images/zoom.png +0 -0
data/doc/index.html +111 -0
data/doc/js/darkfish.js +140 -0
data/doc/js/jquery.js +18 -0
data/doc/js/navigation.js +142 -0
data/doc/js/search.js +109 -0
data/doc/js/search_index.js +1 -0
data/doc/js/searcher.js +228 -0
data/doc/rdoc.css +580 -0
data/doc/table_of_contents.html +510 -0
data/lib/bauxite/actions/alias.rb +51 -0
data/lib/bauxite/actions/assert.rb +49 -0
data/lib/bauxite/actions/assertv.rb +40 -0
data/lib/bauxite/actions/break.rb +39 -0
data/lib/bauxite/actions/click.rb +35 -0
data/lib/bauxite/actions/debug.rb +99 -0
data/lib/bauxite/actions/echo.rb +36 -0
data/lib/bauxite/actions/exec.rb +46 -0
data/lib/bauxite/actions/js.rb +41 -0
data/lib/bauxite/actions/load.rb +49 -0
data/lib/bauxite/actions/open.rb +34 -0
data/lib/bauxite/actions/params.rb +40 -0
data/lib/bauxite/actions/replace.rb +37 -0
data/lib/bauxite/actions/reset.rb +37 -0
data/lib/bauxite/actions/return.rb +62 -0
data/lib/bauxite/actions/ruby.rb +58 -0
data/lib/bauxite/actions/set.rb +39 -0
data/lib/bauxite/actions/source.rb +44 -0
data/lib/bauxite/actions/store.rb +38 -0
data/lib/bauxite/actions/test.rb +61 -0
data/lib/bauxite/actions/tryload.rb +79 -0
data/lib/bauxite/actions/wait.rb +38 -0
data/lib/bauxite/actions/write.rb +40 -0
data/lib/bauxite/application.rb +150 -0
data/lib/bauxite/core/Action.rb +205 -0
data/lib/bauxite/core/Context.rb +575 -0
data/lib/bauxite/core/Errors.rb +36 -0
data/lib/bauxite/core/Logger.rb +86 -0
data/lib/bauxite/core/Selector.rb +156 -0
data/lib/bauxite/loggers/composite.rb +70 -0
data/lib/bauxite/loggers/echo.rb +36 -0
data/lib/bauxite/loggers/file.rb +45 -0
data/lib/bauxite/loggers/terminal.rb +130 -0
data/lib/bauxite/loggers/xterm.rb +79 -0
data/lib/bauxite/selectors/attr.rb +39 -0
data/lib/bauxite/selectors/default.rb +38 -0
data/lib/bauxite/selectors/frame.rb +60 -0
data/lib/bauxite.rb +29 -0
data/test/alias.bxt +6 -0
data/test/assertv.bxt +2 -0
data/test/delay/page.html +5 -0
data/test/delay.bxt +2 -0
data/test/exec.bxt +6 -0
data/test/format/page.html +7 -0
data/test/format.bxt +17 -0
data/test/frame/child_frame.html +7 -0
data/test/frame/grandchild_frame.html +5 -0
data/test/frame/page.html +5 -0
data/test/frame.bxt +6 -0
data/test/js.bxt +5 -0
data/test/load/child.bxt +13 -0
data/test/load.bxt +17 -0
data/test/ruby/custom.rb +5 -0
data/test/ruby.bxt +2 -0
data/test/selectors/page.html +7 -0
data/test/selectors.bxt +7 -0
data/test/stdin.bxt +1 -0
data/test/test/test1.bxt +2 -0
data/test/test/test2.bxt +3 -0
data/test/test/test3.bxt +2 -0
data/test/test.bxt.manual +4 -0
metadata +194 -0

data/lib/bauxite/actions/source.rb ADDED Viewed

@@ -0,0 +1,44 @@
+#--
+# 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 page source matches +text+.
+	#
+	# +text+ can be a regular expression. See #assert for more details.
+	#
+	# For example:
+	#     # assuming <html><body>Hello World!</body></html>
+	#     source "Hello.*!"
+	#     # => this assertion would pass
+	#
+	# :category: Action Methods
+	def source(text)
+		@ctx.with_timeout Bauxite::Errors::AssertionError do
+			actual = @ctx.driver.page_source
+			verbose = @ctx.options[:verbose] ? "\nPage source:\n#{actual}" : ''
+			unless actual =~ _pattern(text)
+				raise Bauxite::Errors::AssertionError, "Assertion failed: page source does not match '#{text}'#{verbose}"
+			end
+			true
+		end
+	end
+end

data/lib/bauxite/actions/store.rb ADDED Viewed

@@ -0,0 +1,38 @@
+#--
+# 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 of the selected element.
+	#
+	# +name+ is subject to variable expansion (see Context#expand).
+	#
+	# For example:
+	#     # assuming <span id="name">John</span>
+	#     store id=name firstName
+	#     echo "${firstName}
+	#     # => this would print 'John'
+	#
+	# :category: Action Methods
+	def store(selector, name)
+		@ctx.find(selector) { |e| @ctx.variables[name] = @ctx.get_value(e) }
+	end
+end

data/lib/bauxite/actions/test.rb ADDED Viewed

@@ -0,0 +1,61 @@
+#--
+# 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 +file+ using the #load action into a new test context.
+	#
+	# If +name+ is specified, it will be used as the test name.
+	#
+	# If any action in the test context fails, the whole test context fails,
+	# and the execution continues with the next test context (if any).
+	#
+	# For example:
+	#     test mytest.bxt "My Test"
+	#     # => this would load mytest.bxt into a new test context
+	#     #    named "My Test"
+	#
+	# :category: Action Methods
+	def test(file, name = nil)
+		delayed = load(file)
+		lambda do
+			begin
+				t = Time.new
+				status = 'ERROR'
+				error = nil
+				@ctx.with_vars({ '__RAISE_ERROR__' => true }) do
+					delayed.call
+					status = 'OK'
+				end
+			rescue StandardError => e
+				error = e
+			ensure
+				@ctx.tests << {
+					:name => name || file,
+					:status => status,
+					:time => Time.new - t,
+					:error => error
+				}
+			end
+		end
+	end
+end

data/lib/bauxite/actions/tryload.rb ADDED Viewed

@@ -0,0 +1,79 @@
+#--
+# 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 skips.
+	# See #load for a similar action that fails 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:
+	#     tryload other_test.bxt
+	#     tryload nonexistent_file.bxt
+	#     # => this would load and execute other_test.bxt, then silently fail
+	#     #    to execute nonexistent_file.bxt without failing the test.
+	#
+	# :category: Action Methods
+	def tryload(file, *vars)
+		_load_file_action(file, *vars) do |f|
+			@ctx.parse_file(f)
+		end
+	end
+private
+	def _load_file_action(file, *vars)
+		unless file == 'stdin' or  File.exists? file
+			current = @ctx.variables['__FILE__']
+			current = (File.exists? current) ? File.dirname(current) : Dir.pwd
+			file = File.join(current, file)
+			return nil unless File.exists? file
+		end
+		var_hash = vars.inject({}) do |h,v|
+			data = v.split('=', 2)
+			h[data[0]] = data[1]
+			h
+		end
+		lambda do
+			ret_vars = nil
+			@ctx.with_vars var_hash do
+				yield file
+				rets = @ctx.variables['__RETURN__']
+				if rets == ['*']
+					ret_vars = @ctx.variables
+				elsif rets != nil
+					ret_vars = @ctx.variables.select { |k,v| rets.include? k }
+				end
+			end
+			@ctx.variables.merge!(ret_vars) if ret_vars
+		end
+	end
+end

data/lib/bauxite/actions/wait.rb ADDED Viewed

@@ -0,0 +1,38 @@
+#--
+# 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
+	# Wait for the specified number of +seconds+.
+	#
+	# For example:
+	#     wait 5
+	#     # => this would wait for 5 seconds and then continue
+	#
+	# :category: Action Methods
+	def wait(seconds)
+		seconds = seconds.to_i
+		seconds.times do |i|
+			@ctx.logger.progress(seconds-i)
+			sleep(1.0)
+		end
+	end
+end

data/lib/bauxite/actions/write.rb ADDED Viewed

@@ -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
+	# Sets the value of the selected element to +text+.
+	#
+	# +text+ is subject to variable expansion (see Context#expand).
+	#
+	# For example:
+	#     # assuming <input type="text" name="username" />
+	#     write name=username "John"
+	#     # => this would type the word 'John' in the username textbox
+	#
+	# :category: Action Methods
+	def write(selector, text)
+		@ctx.find(selector) do |e|
+			e.clear
+			e.send_keys(text)
+		end
+	end
+end

data/lib/bauxite/application.rb ADDED Viewed

@@ -0,0 +1,150 @@
+#--
+# 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.
+#++
+require 'optparse'
+require_relative  'core/Context.rb'
+module Bauxite
+	class Application
+		def self.start
+			options = {
+				:logger     => (ENV['TERM'] == 'xterm') ?  'xterm' : 'terminal',
+				:verbose    => false,
+				:break      => false,
+				:driver     => 'firefox',
+				:debug      => false,
+				:timeout    => 10,
+				:reset      => false,
+				:driver_opt => {},
+				:logger_opt => {}
+			}
+			OptionParser.new do |opts|
+				opts.banner = "Usage: bauxite [options] [files...]"
+				def opts.o=(o)
+					@o = o
+				end
+				def opts.single(*args)
+					on(*args[1..-1]) do |v|
+						@o[args[0]] = v
+					end
+					self
+				end
+				def opts.multi(*args)
+					on(*args[1..-1]) do |v|
+						n,v = v.split('=', 2)
+						@o[args[0]][n.to_sym] = v || true
+					end
+					self
+				end
+				opts.o = options
+				opts.separator ""
+				opts.separator "Options: "
+				opts
+				.single(:verbose   , "-v",  "--verbose", "Show verbose errors")
+				.single(:timeout   , "-t",  "--timeout SECONDS", "Selector timeout (#{options[:timeout]}s)")
+				.single(:debug     , "-d",  "--debug", "Break to debug on error. "+
+													"Start the debug console if no input files given.")
+				.single(:driver    , "-p",  "--provider PROVIDER"     , "Driver provider")
+				.multi( :driver_opt, "-P",  "--provider-option OPTION", "Provider options (name=value)")
+				.single(:logger    , "-l",  "--logger LOGGER"         , "Logger type ('#{options[:logger]}')")
+				.multi( :logger_opt, "-L",  "--logger-option OPTION"  , "Logger options (name=value)")
+				.single(:reset     , "-r",  "--reset"                 , "Reset driver between tests")
+				.single(:wait      , "-w",  "--wait"                  , "Wait for ENTER before exiting")
+				opts.on("-u", "--url [URL]", "Configure the remote provider listening in the given url.") do |v|
+					v = 'localhost:4444' unless v
+					v = 'http://'+v unless v.match /^https?:\/\//
+					v = v + '/wd/hub' unless v.end_with? '/wd/hub'
+					options[:driver] = 'remote'
+					options[:driver_opt][:url] = v
+				end
+				opts.on("--version", "Show version") do
+					puts "bauxite #{Bauxite::VERSION}"
+					exit
+				end
+				opts.separator ""
+				opts.separator "Loggers:"
+				Context::loggers.sort.each do |s|
+					opts.separator "    #{s}"
+				end
+				opts.separator ""
+				opts.separator "Selectors:".ljust(32)+" Actions:"
+				max_action_size = Context::max_action_name_size
+				selectors = Context::selectors.sort
+				actions   = Context::actions.sort
+				[selectors.size, actions.size].max.times.zip(selectors, actions).each do |idx,s,a|
+					a = a ? "#{a.ljust(max_action_size)} #{Context.action_args(a).join(' ')}" : ''
+					s = '' unless s
+					opts.separator "    #{s.ljust(28)}     #{a}"
+				end
+				opts.separator ""
+			end.parse!
+			ctx = Context.new(options)
+			files = ARGV
+			files = ['stdin'] if files.size == 0 and not options[:debug]
+			actions = ctx.handle_errors do
+				files.each_with_index.map do |file,idx|
+					{
+						:text => "load \"#{file.gsub('"', '""')}\"",
+						:file => 'command-line-args',
+						:line => idx
+					}
+				end
+			end
+			if options[:reset] and files.size > 1
+				actions = actions.map { |a| [a] }.inject do |sum,a|
+					sum += ['reset']
+					sum + a
+				end.flatten
+			end
+			if options[:debug] and actions.size == 0
+				actions = ['debug']
+			end
+			begin
+				ctx.start(actions)
+			ensure
+				if ctx.tests.any?
+					puts
+					puts 'Test summary:'
+					puts '============='
+					puts 'Name'.ljust(60) + 'Time'.ljust(6) + 'Status'.ljust(7)+'Error'
+					ctx.tests.each do |t|
+						error = t[:error]
+						error = error ? error.message : ''
+						puts t[:name].ljust(60) + t[:time].round(3).to_s.ljust(6) + t[:status].ljust(7) + error
+					end
+				end
+			end
+		end
+	end
+end

data/lib/bauxite/core/Action.rb ADDED Viewed

@@ -0,0 +1,205 @@
+#--
+# 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.
+#++
+module Bauxite
+	# Action common state and behavior.
+	module ActionModule
+		# Parsed action command (i.e. action name)
+		attr_reader :cmd
+		# Raw action text.
+		attr_reader :text
+		# File where the action was defined.
+		attr_reader :file
+		# Line in the #file where the action was defined.
+		attr_reader :line
+		# Constructs a new test action instance.
+		def initialize(ctx, cmd, args, text, file, line)
+			@ctx  = ctx
+			@cmd  = cmd
+			@args = args
+			@text = text
+			@file = file
+			@line = line
+			@cmd_real = (respond_to? cmd+'_action') ? (cmd+'_action') : cmd
+			unless respond_to? @cmd_real and Context::actions.include? @cmd
+				raise "#{file} (line #{line+1}): Unknown command #{cmd}."
+			end
+		end
+		# Returns the action arguments after applying variable expansion.
+		#
+		# See Context#expand.
+		#
+		# If +quote+ is +true+, the arguments are surrounded by quote
+		# characters (") and every quote inside an argument is doubled.
+		#
+		# For example:
+		#     # assuming
+		#     #     action.new(ctx, cmd,
+		#     #         [ 'dude', 'say "hi"', '${myvar} ], # args
+		#     #         text, file, line)
+		#     #     ctx.variables = { 'myvar' => 'world' }
+		#
+		#     action.args
+		#     # => [ 'dude', 'say "hi"', 'world' ]
+		#
+		#     action.args(true)
+		#     # => [ '"dude"', '"say ""hi"""', '"world"' ]
+		#
+		def args(quote = false)
+			ret = @args.map { |a| @ctx.expand(a) }
+			ret = ret.map { |a| '"'+a.gsub('"', '""')+'"' } if quote
+			ret
+		end
+		# Executes the action evaluating the arguments in the current context.
+		#
+		# Note that #execute calls #args to expand variables. This means that
+		# two calls to #execute on the same instance might yield different results.
+		#
+		# For example:
+		#     action = ctx.parse_action('echo ${message}')
+		#
+		#     ctx.variables = { 'message' => 'hi!' }
+		#     action.execute()
+		#     # => outputs 'hi!'
+		#
+		#     ctx.variables['message'] = 'hello world'
+		#     action.execute()
+		#     # => outputs 'hello world!' yet the instance of action is same!
+		#
+		def execute()
+			send(@cmd_real, *args)
+		end
+	private
+		def _pattern(s)
+			if s =~ /^\/.*\/[imxo]*$/
+				eval(s)
+			else
+				/#{s}/
+			end
+		end
+	end
+	# Test action class.
+	#
+	# Test actions are basic test operations that can be combined to create a test
+	# case.
+	#
+	# Test actions are implemented as public methods of the Action class.
+	#
+	# Each test action is defined in a separate file in the 'actions/' directory.
+	# The name of the file must match the name of the action. Ideally, these files
+	# should avoid adding public methods other than the action method itself.
+	# Also, no +attr_accessors+ should be added.
+	#
+	# Action methods can use the +ctx+ attribute to refer to the current test
+	# Context.
+	#
+	# For example (new action template):
+	#     # === actions/print_source.rb ======= #
+	#     class Action
+	#         # :category: Action Methods
+	#         def print_source
+	#             # action code goes here, for example:
+	#             puts @ctx.driver.page_source.
+	#         end
+	#     end
+	#     # === end actions/print_source.rb === #
+	#
+	#     Context::actions.include? 'print_source' # => true
+	#
+	# To avoid name clashing with Ruby reserved words, the '_action' suffix can be
+	# included in the action method name (this suffix will not be considered part
+	# of the action name).
+	#
+	# For example (_action suffix):
+	#     # === actions/break.rb ======= #
+	#     class Action
+	#         # :category: Action Methods
+	#         def break_action
+	#             # do something
+	#         end
+	#     end
+	#     # === end actions/break.rb === #
+	#
+	#     Context::actions.include? 'break' # => true
+	#
+	# If the action requires additional attributes or private methods, the name
+	# of the action should be used as a prefix to avoid name clashing with other
+	# actions.
+	#
+	# For example (private attributes and methods):
+	#     # === actions/debug.rb ======= #
+	#     class Action
+	#         # :category: Action Methods
+	#         def debug
+	#             _debug_do_stuff
+	#         end
+	#     private
+	#         @@debug_line = 0
+	#         def _debug_do_stuff
+	#             @@debug_line += 1
+	#         end
+	#     end
+	#     # === end actions/debug.rb === #
+	#
+	#     Context::actions.include? 'debug' # => true
+	#
+	# Action methods support delayed execution of the test action. Delayed
+	# execution is useful in cases where the action output would break the
+	# standard logging interface.
+	#
+	# Delayed execution is implemented by returning a lambda from the action
+	# method.
+	#
+	# For example (delayed execution):
+	#     # === actions/break.rb ======= #
+	#     class Action
+	#         # :category: Action Methods
+	#         def break_action
+	#             lambda { Context::wait }
+	#         end
+	#     end
+	#     # === end actions/break.rb === #
+	#
+	#     Context::actions.include? 'debug' # => true
+	#
+	# Executing this action would yield something like the following:
+	#     break                         [ OK  ]
+	#     Press ENTER to continue
+	#
+	# While calling Context::wait directly would yield:
+	#     break                        Press EN
+	#     TER to continue
+	#                                   [ OK  ]
+	#
+	class Action
+		include ActionModule
+	end
+end