bauxite 0.1.0

data/lib/bauxite/core/Selector.rb

@@ -0,0 +1,156 @@
+#--
+# 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
+	# Selector common state and behavior.
+	module SelectorModule
+		
+		# Constructs a new test selector instance.
+		def initialize(ctx)
+			@ctx = ctx
+		end
+		
+		# Searches for elements using the specified selector string.
+		#
+		# For more information see Context#find.
+		#
+		# Selectors calling this method should forward their block as well.
+		#
+		# For example:
+		#     # === selectors/example.rb ======= #
+		#     class Selector
+		#         # :category: Selector Methods
+		#         def example(arg, &block)
+		#             find(arg, &block)
+		#         end
+		#     end
+		#     # === end selectors/example.rb === #
+		#
+		def find(selector, &block)
+			# I know I should be using Class scope operators to refer to class
+			# methods (i.e. Context::selectors), but for some reason RDoc
+			# refuses to document the Selector class (below) if any such
+			# operators appear in this method (quite strange). So for now, I'll
+			# just settle for using the old and trusty "."
+			
+			data = selector.split('=', 2)
+			type = data.length == 2 ? data[0] : "default"
+			raise ArgumentError, "Invalid selector type '#{type}'" unless Context.selectors.include? type
+			
+			arg  = data[-1]
+			custom_selectors = Context.selectors(false)
+			return send(type            , arg, &block) if custom_selectors.include? type
+			return send(type+'_selector', arg, &block) if custom_selectors.include? type+'_selector'
+			selenium_find(type, arg, &block)
+		end
+		
+	protected
+		# Searches for elements using standard Selenium selectors.
+		#
+		# Selectors calling this method should forward their block as well.
+		#
+		#     # === selectors/data.rb ======= #
+		#     class Selector
+		#         # :category: Selector Methods
+		#         def data(arg, &block)
+		#             # selector code goes here, for example:
+		#             selenium_find(:css, "[data='#{arg}']", &block)
+		#         end
+		#     end
+		#     # === end selectors/data.rb === #
+		#
+		def selenium_find(type, selector)
+			element = @ctx.driver.find_element(type, selector)
+			yield element if block_given?
+			element
+		end
+	end
+
+	# Selector class.
+	#
+	# Selectors represent different strategies for finding elements. Selenium
+	# provides a list of standard selectors (e.g. by id, by css expression, etc).
+	# 
+	# Additional selectors can be specified by defining custom methods in the
+	# Selector class.
+	#
+	# Each custom selector is defined in a separate file in the 'selectors/'
+	# directory.
+	# The name of the file must match the name of the selector. These files should
+	# avoid adding public methods other than the selector method itself.
+	# Also, no +attr_accessors+ should be added.
+	#
+	# Selector methods can use the +ctx+ attribute to refer to the current test
+	# Context. The protected method #selenium_find can also be used to locate elements
+	# using standard Selenium selectors.
+	#
+	# Selector methods should always take a block and forward that block to a call
+	# to either #find or #selenium_find.
+	#
+	# For example (new selector template):
+	#     # === selectors/data.rb ======= #
+	#     class Selector
+	#         # :category: Selector Methods
+	#         def data(arg, &block)
+	#             # selector code goes here, for example:
+	#             selenium_find(:css, "[data='#{arg}']", &block)
+	#         end
+	#     end
+	#     # === end selectors/data.rb === #
+	#
+	#     Context::selectors.include? 'data' # => true
+	#
+	# To avoid name clashing with Ruby reserved words, the '_selector' suffix can
+	# be included in the selector method name (this suffix will not be considered
+	# part of the selector name).
+	#
+	# For example (_selector suffix):
+	#     # === selectors/end.rb ======= #
+	#     class Selector
+	#         # :category: Selector Methods
+	#         def end_selector
+	#             # do something
+	#         end
+	#     end
+	#     # === end selector/end.rb === #
+	#
+	#     Context::selectors.include? 'end' # => true
+	#
+	# ---
+	#
+	# === Standard Selenium Selectors
+	#  
+	# [id=+targetValue+]                              {Locate elements whose +id+ attribute matches +targetValue+.}[http://docs.seleniumhq.org/docs/03_webdriver.jsp#by-id]
+	# [name=+targetValue+]                            {Locate elements whose +name+ attribute matches +targetValue+.}[http://docs.seleniumhq.org/docs/03_webdriver.jsp#by-name]
+	# [css=+cssSelectorSyntax+]                       {Locate elements using CSS selector syntax.}[http://docs.seleniumhq.org/docs/03_webdriver.jsp#by-css]
+	# [partial_link_text=+textFragment+]              {Locate A elements whose text includes +textFragment+.}[http://docs.seleniumhq.org/docs/03_webdriver.jsp#by-partial-link-text]
+	# [class=+className+ and class_name=+className+]  {Locate elements whose +class+ attribute matches +className+.}[http://docs.seleniumhq.org/docs/03_webdriver.jsp#by-class-name]
+	# [link=+exactText+ and link_text=+exactText+]    {Locate A elements whose text is exactly +exactText+.}[http://docs.seleniumhq.org/docs/03_webdriver.jsp#by-link-text]
+	# [tag_name=+targetValue+]                        {Locate elements whose tag name matches +targetValue+.}[http://docs.seleniumhq.org/docs/03_webdriver.jsp#by-tag-name]
+	# [xpath=+xpathExpression+]                       {Locate elements using XPATH expressions.}[http://docs.seleniumhq.org/docs/03_webdriver.jsp#by-xpath]
+	#
+	class Selector
+		include SelectorModule
+		
+		# :section: Selector Methods
+	end
+end

data/lib/bauxite/loggers/composite.rb

@@ -0,0 +1,70 @@
+#--
+# 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.
+#++
+
+# Composite logger.
+#
+# This composite logger forwards logging calls to each of its children.
+#
+# Set the +:loggers+ option to a comma-separated list of logger names
+#
+class Bauxite::Loggers::CompositeLogger
+	
+	# Constructs a new composite logger instance.
+	def initialize(options)
+		@loggers = options[:loggers].split(',').map do |l|
+			Bauxite::Context::load_logger(l, options)
+		end
+	end
+	
+	# Pretty prints action information and status.
+	#
+	# This implementation only yileds in the first logger.
+	# 
+	# Additional loggers are called after the block completed.
+	#
+	def log_cmd(action, &block)
+		ret = @loggers[0].log_cmd(action, &block)
+		@loggers[1..-1].each { |l| l.log_cmd(action) { ret } }
+		ret
+	end
+
+	# Returns a colorized debug prompt.
+	#
+	# This implementation returns the debug_prompt of the first logger.
+	#
+	def debug_prompt
+		@loggers[0].debug_prompt
+	end
+	
+	# Updates action progress.
+	def progress(value)
+		@loggers.each { |l| l.progress(value) }
+	end
+	
+	# Prints the specified string.
+	#
+	# See Bauxite::Loggers::NullLogger#print
+	#
+	def log(s, type = :info)
+		@loggers.each { |l| l.log(s, type) }
+	end
+end

data/lib/bauxite/loggers/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.
+#++
+
+# Echo logger.
+#
+# This logger outputs the raw action text for every action executed.
+#
+# Note that this logger does not include execution status information
+# (i.e. action succeeded, failed or was skipped).
+#
+class Bauxite::Loggers::EchoLogger < Bauxite::Loggers::NullLogger
+	# Echoes the raw action text.
+	def log_cmd(action)
+		puts action.text
+		yield
+	end
+end

data/lib/bauxite/loggers/file.rb

@@ -0,0 +1,45 @@
+#--
+# 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.
+#++
+
+# File logger.
+#
+# This logger outputs the raw action text for every action executed to
+# the file specified in the +file+ logger option.
+#
+class Bauxite::Loggers::FileLogger < Bauxite::Loggers::NullLogger
+	
+	# Constructs a new echo logger instance.
+	def initialize(options)
+		super(options)
+		@file = options[:file]
+		unless @file and @file != ''
+			raise ArgumentError, "FileLogger configuration error: Undefined 'file' option."
+		end
+		File.open(@file, "w") {} # truncate file
+	end
+	
+	# Echoes the raw action text.
+	def log_cmd(action)
+		File.open(@file, 'a+') { |f| f.write(action.text+"\n") }
+		yield
+	end
+end

data/lib/bauxite/loggers/terminal.rb

@@ -0,0 +1,130 @@
+#--
+# 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.
+#++
+
+# Terminal logger.
+#
+# This logger outputs text using basic text formatting for a terminal
+# window.
+#
+class Bauxite::Loggers::TerminalLogger < Bauxite::Loggers::NullLogger
+	# Constructs a new Terminal logger instance.
+	def initialize(options)
+		super(options)
+		@max_cmd_size = Bauxite::Context::max_action_name_size
+	end
+	
+	# Pretty prints action information and status.
+	def log_cmd(action)
+		width = _screen_width
+		cmd = action.cmd.downcase
+		color = _cmd_color(cmd)
+		cmd = cmd.ljust(@max_cmd_size)
+		max_args_size = width-cmd.size-1-6-1-1
+
+		print "#{_fmt(color, cmd)} "
+		s = action.args(true).join(' ')
+		s = s[0...max_args_size-3]+'...' if s.size > max_args_size
+		print s.ljust(max_args_size)
+		_save_cursor
+		color = :green
+		text  = 'OK'
+		ret = yield
+		if not ret
+			color = :yellow
+			text  = 'SKIP'
+		end
+		_restore_cursor
+		puts " #{_block(color, text, 5)}"
+		ret
+	rescue
+		_restore_cursor
+		puts " #{_block(:red, 'ERROR', 5)}"
+		raise
+	end
+
+	# Returns a colorized debug prompt.
+	def debug_prompt
+		_fmt(:white, super)
+	end
+	
+	# Updates action progress.
+	def progress(value)
+		if _restore_cursor
+			print " #{_block(:gray, value.to_s, 5)}"
+		end
+	end
+	
+	# Prints the specified string.
+	#
+	# See Bauxite::Loggers::NullLogger#print
+	#
+	def log(s, type = :info)
+		color = :gray
+		case type
+		when :error
+			color = :red
+		when :warning
+			color = :yellow
+		when :debug
+			color = :purple
+		end
+		super _fmt(color, s), type
+	end
+
+protected
+	# Centers +text+ to a fixed size with.
+	def _fmt(color, text, size = 0)
+		text.center(size)
+	end
+	
+	# Save the current cursor position,
+	def _save_cursor
+		false
+	end
+	
+	# Restores the cursor to the previously saved cursor position.
+	def _restore_cursor
+		false
+	end
+
+	# Prints +text+ centered inside a square-bracketed block.
+	def _block(color, text, size)
+		"#{_fmt(:white, '[')}#{_fmt(color, text, size)}#{_fmt(:white, ']')}"
+	end
+
+	# Get the color of +cmd+.
+	def _cmd_color(cmd)
+		case cmd
+		when 'load'
+			return :cyan
+		when 'test'
+			return :purple
+		else
+			return :blue
+		end
+	end
+	
+	# Returns the terminal screen width.
+	def _screen_width
+		80
+	end
+end

data/lib/bauxite/loggers/xterm.rb

@@ -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.
+#++
+
+require_relative 'terminal'
+
+# XTerm logger.
+#
+# This logger outputs colorized lines using xterm (VT100/2) escape
+# sequences.
+#
+class Bauxite::Loggers::XtermLogger < Bauxite::Loggers::TerminalLogger
+
+protected
+	COLORS = { # :nodoc:
+		:black        => '0;30',
+		:dark_blue    => '0;34',
+		:dark_green   => '0;32',
+		:dark_cyan    => '0;36',
+		:dark_red     => '0;31',
+		:dark_purple  => '0;35',
+		:dark_brown   => '0;33',
+		:dark_gray    => '1;30',
+		:gray         => '0;37',
+		:blue         => '1;34',
+		:green        => '1;32',
+		:cyan         => '1;36',
+		:red          => '1;31',
+		:purple       => '1;35',
+		:yellow       => '1;33',
+		:white        => '1;37'
+	}
+
+	def _fmt(color, text, size = 0)
+		text = super(color, text, size)
+		if @options[:nc] or @options[:color] == 'no'
+			text
+		else
+			"\033[#{COLORS[color]}m#{text}\033[0m"
+		end
+	end
+
+	def _save_cursor
+		print "\033[s"
+		true
+	end
+
+	def _restore_cursor
+		print "\033[u"
+		true
+	end
+	
+	def _screen_width
+		begin
+			require 'terminfo'
+			TermInfo.screen_size[1]
+		rescue Exception
+			super
+		end
+	end
+end

data/lib/bauxite/selectors/attr.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::Selector
+	# Select an element by attribute value.
+	#
+	# The attribute selector syntax is:
+	#     attr=name:value
+	#
+	# For example:
+	#     # assuming <div custom="true">foo</div>
+	#     assert attr=custom:true "foo"
+	#     # => matches the element above.
+	#
+	# :category: Selector Methods
+	def attr(arg, &block)
+		data = arg.split(':', 2)
+		selenium_find(:css, "[#{data[0]}='#{data[1]}']", &block)
+	end
+end

data/lib/bauxite/selectors/default.rb

@@ -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::Selector
+	# Select an element by id suffix.
+	#
+	# This is the default selector. Any selector strings that do not contain an
+	# equal sign (i.e. '=') will use this selector.
+	#
+	# For example:
+	#     # assuming <div id="strange_uuid_like_stuff_myDiv">foo</div>
+	#     assert myDiv "foo"
+	#     # => matches the element above.
+	#
+	# :category: Selector Methods
+	def default(arg, &block)
+		selenium_find(:css, "[id$='#{arg.gsub("'", "\\'")}']", &block)
+	end
+end

data/lib/bauxite/selectors/frame.rb

@@ -0,0 +1,60 @@
+#--
+# 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::Selector
+	# Change the selector scope to the given frame and finds an element in that
+	# frame.
+	#
+	# This is a composite selector. The frame selector syntax is:
+	#     frame=|frame_selector|child_selector
+	#
+	# Where +frame_selector+ is any selector available that matches the target
+	# frame, +child_selector+ is any selector available that matches the target
+	# element inside the target frame.
+	#
+	# Note that the '|' character can be replaced with any single-character
+	# delimiter.
+	#
+	# Also note that frame selectors can be embedded to select a frame inside
+	# a frame. To accompilish this, +child_selector+ can be a frame selector.
+	#
+	# For example:
+	#     # assuming <iframe class="myframe">
+	#     #            <div id="child">foo</div>
+	#     #          </iframe>
+	#     assert "frame=|css=.myframe|child" "foo"
+	#     # => matches the 'child' element above.
+	#
+	# :category: Selector Methods
+	def frame(arg, &block)
+		delimiter = arg[0]
+		items = arg[1..-1].split(delimiter, 2)
+		frame = find(items[0])
+		
+		begin
+			@ctx.driver.switch_to.frame frame
+			find(items[1], &block)
+		ensure
+			@ctx.driver.switch_to.default_content
+		end
+	end
+end

data/lib/bauxite.rb

@@ -0,0 +1,29 @@
+#--
+# 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
+	VERSION = "0.1.0"
+end
+#++
+
+require_relative 'bauxite/application'