bauxite 0.6.18 → 0.6.19

data/lib/bauxite/actions/wait.rb

@@ -1,38 +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
+#--
+# 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

@@ -1,44 +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
-	# 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|
-			begin
-				e.clear
-			rescue Selenium::WebDriver::Error::UnknownError # user-editable...
-				# do nothing (if this should fail, it will in the line below)
-			end
-			e.send_keys(text)
-		end
-	end
-end
+#--
+# 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|
+			begin
+				e.clear
+			rescue Selenium::WebDriver::Error::UnknownError # user-editable...
+				# do nothing (if this should fail, it will in the line below)
+			end
+			e.send_keys(text)
+		end
+	end
+end

data/lib/bauxite/application.rb

@@ -1,350 +1,350 @@
-#--
-# 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'
-
-module Bauxite
-	# +bauxite+ command-line program.
-	# 
-	# This program executes Bauxite tests and outputs the execution progress
-	# and tests results to the terminal.
-	#
-	# == Synopsis
-	#
-	#    bauxite [OPTIONS] file1 file2 ...
-	#    # => Executes file1, then file2, and so on.
-	#    
-	#    bauxite [OPTIONS] -d
-	#    # => Start Bauxite directly in the debug console.
-	#    
-	#    bauxite [OPTIONS]
-	#    # => Start Bauxite and read test actions from the standard input.
-	#
-	# == Options
-	# For a detailed list of options for your Bauxite version execute:
-	#    bauxite -h
-    #
-	#
-	# [-v, \--verbose]
-	#     Show verbose error messages (i.e. print exception names and
-	#     backtraces).
-	#
-	# [-t, \--timeout SECONDS]
-	#     Number of seconds to wait before issuing a timeout error. This
-	#     timeout applies only to Selectors. 
-	#
-	# [-o, \--open_timeout SECONDS]
-	#     Number of seconds to wait before issuing a timeout error. This
-	#     timeout applies only to page loading times (i.e. Net::HTTP).
-	#
-	# [-d, \--debug]
-	#     If an error occurs, break into the debug console. This mode is very
-	#     useful to try different selector combinations and debug
-	#     NoSuchElementError errors.
-	#
-	# [-p, \--provider DRIVER]
-	#     Selenium WebDriver provider. Defaults to +firefox+.
-	#
-	#     Other options include:
-	#     - +remote+
-	#     - +ie+
-	#     - +chrome+
-	#     - +android+
-	#     - +iphone+
-	#     - +opera+
-	#     - +phantomjs+
-	#     - +safari+
-	#
-	#     Driver availability dependes on the system running Bauxite.
-	# [-P, \--provider-option OPTION] 
-	#    A <tt>name=value</tt> pair of options that are directly forwarded to
-	#    the Selenium WebDriver provider. This option argument can appear
-	#    multiple times in the command line to specify multiple options.
-	#
-	# [-l, \--logger LOGGER]
-	#    Logger instance to use. Defaults to +xterm+ if the +TERM+ environment
-	#    variable is set to +xterm+, otherwise it defaults to +terminal+.
-	#
-	#    To see a complete list of the available loggers execute:
-	#        bauxite -h
-	#
-	#    Note that multiple instances of this option can be specified.
-	#
-	# [-L, \--logger-option OPTION]
-	#    A <tt>name=value</tt> pair of options that are directly forwarded to
-	#    the logger. This option argument can appear multiple times in the
-	#    command line to specify multiple options.
-	#
-	# [-r, \--reset]
-	#    Issue a Action#reset action between every test specified in
-	#    the command line. This option enforces test isolation by resetting
-	#    the test context before each test (this removes cookies, sessions,
-	#    etc. from the previous test).
-	#
-	# [-w, \--wait]
-	#    Wait for user input when the test completes instead of closing the
-	#    browser window.
-	#
-	# [-s, \--selector SELECTOR]
-	#    Default selector strategy. This strategy is applied if the selector
-	#    text does not contain an <tt>=</tt> sign.
-	#
-	#    To see a complete list of the available selectors execute:
-	#        bauxite -h
-	#
-	# [-c, \--capture]
-	#    If the test fails, capture a screenshot in the +output+ directory.
-	#    See the \--output option below.
-	#
-	# [\--csv-summary FILE]
-	#    Output a single-line CSV summary ideal to feed into the Plot Jenkins
-	#    plugin. If +FILE+ is not specified, defaults to +summary.csv+
-	#
-	# [\--output DIR]
-	#    Output directory for generated artifacts. Defaults to the current
-	#    working directory.
-	#
-	# [-u, \--url URL]
-	#    This option is an alias of:
-	#        -p remote -P url=URL
-	#    If +URL+ is not present <tt>http://localhost:4444/wd/hub</tt> will be
-	#    assumed.
-	#
-	# [\--jenkins DIR]
-	#    Configures default options for Jenkins integration. This option is an
-	#    alias of:
-	#         -p remote -P url=http://localhost:4444/wd/hub -l echo -l html
-	#         -L html_package=true -c --csv-summary
-	#         --output DIR
-	#    Note that any of the options above can be overridden by specifying the
-	#    option after the <tt>--jenkins</tt> option. For example:
-	#         --jenkins -u selenium.my-organization.com:4445
-	#
-	# [-e, \--extension DIR]
-	#    Loads every Ruby file (*.rb) inside +DIR+ (and subdirectories). This
-	#    option can be used to load custom Bauxite extensions (e.g. Actions, 
-	#    Selectors, Loggers, etc.) for a specific test run.
-	#
-	#    For example:
-	#        # === custom/my_selector.rb ======= #
-	#        class Bauxite::Selector
-	#            def by_attr(value)
-	#                attr "by_attr:#{value}"
-	#            end
-	#        end
-	#        # === end custom/my_selector.rb === #
-	#
-	#        # === custom/my_test.bxt ========== #
-	#        # ...
-	#        assert "by_attr=attr_value" hello
-	#        # ...
-	#        # === end custom/my_test.bxt ====== #
-	#
-	#        bauxite -e custom custom/my_test.bxt
-	#
-	# [\--version]
-	#     Shows the Bauxite version.
-	#
-	# == Exit Status
-	# The +bauxite+ program exits with +zero+ if every action in the test
-	# succeeded and +non-zero+ otherwise.
-	# 
-	# If the test run includes multiple Action#test actions, the exit status
-	# equals the number of failed test cases (again, +zero+ indicates success).
-	#
-	class Application
-		def self.start #:nodoc:
-			options = {
-				:logger       => [],
-				:verbose      => false,
-				:break        => false,
-				:driver       => 'firefox',
-				:debug        => false,
-				:timeout      => 10,
-				:open_timeout => 60,
-				:reset        => false,
-				:selector     => 'sid',
-				:driver_opt   => {},
-				:logger_opt   => {},
-				:extensions   => []
-			}
-			
-			default_logger = (ENV['TERM'] == 'xterm') ?  'xterm' : 'terminal'
-			
-			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.hash(*args)
-					on(*args[1..-1]) do |v|
-						n,v = v.split('=', 2)
-						@o[args[0]][n.to_sym] = v || true
-					end
-					self
-				end
-				def opts.multi(*args)
-					on(*args[1..-1]) do |v|
-						@o[args[0]] << v
-					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(:open_timeout, "-o",  "--open-timeout SECONDS", "Open timeout (#{options[:open_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")
-				.hash(  :driver_opt  , "-P",  "--provider-option OPTION", "Provider options (name=value)")
-				.multi( :logger      , "-l",  "--logger LOGGER"         , "Logger type ('#{default_logger}')")
-				.hash(  :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")
-				.single(:selector    , "-s",  "--selector SELECTOR"     , "Default selector ('#{options[:selector]}')")
-				.single(:capture     , "-c",  "--capture"               , "If the test fails, capture a screenshot")
-				.single(:output      , "--output DIR"                   , "Output directory for generated artifacts")
-				.multi( :extensions  , "-e",  "--extension DIR"         , "Load extensions from DIR")
-				
-				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("--csv-summary [FILE]", "Output a single-line CSV summary") { |v| options[:csv] = v || 'summary.csv' }
-				
-				opts.on("--jenkins DIR", "Configure default options for Jenkins integration") do |v|
-					options[:driver] = 'remote'
-					options[:driver_opt][:url] = 'http://localhost:4444/wd/hub'
-					options[:logger] = ['echo', 'html']
-					options[:output] = v
-					options[:logger_opt][:html_package] = true
-					options[:capture] = true
-					options[:csv] = 'summary.csv'
-				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!
-			
-			options[:logger] << default_logger unless options[:logger].size > 0
-			
-			ctx = nil
-			begin
-				ctx = Context.new(options)
-			rescue StandardError => e
-				puts e.message
-				if options[:verbose]
-					p e
-					puts e.backtrace
-				end
-				exit false
-			end
-
-			files = ARGV
-			files = ['stdin'] if files.size == 0 and not options[:debug]
-
-			actions = files.map { |f| "load \"#{f.gsub('"', '""')}\"" }
-
-			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)
-			rescue StandardError => e
-				exit false
-			ensure
-				if ctx.tests.any?
-
-					if (csv_file = options[:csv])
-						total  = ctx.tests.size
-						ok     = ctx.tests.inject(0) { |s,t| s + (t[:status] == 'OK' ? 1 : 0) }
-						failed = total - ok
-						time   = ctx.tests.inject(0) { |s,t| s + t[:time] }
-						File.open(ctx.output_path(csv_file), 'w') do |f|
-							f.write "Total,OK,Failed,Time\n#{total},#{ok},#{failed},#{time}\n"
-						end
-					end
-					
-					failed = 0
-					
-					puts
-					puts 'Test summary:'
-					puts '============='
-					puts 'Name'.ljust(40 ) + ' Time'.ljust(7 ) + ' Status'.ljust(7)+' Error'
-					puts ''.ljust(40, '-') + ' '.ljust(7, '-') + ' '.ljust(7, '-' )+' '.ljust(5, '-')
-					ctx.tests.each do |t|
-						error = t[:error]
-						error = error ? error.message : ''
-						puts t[:name].ljust(40) + ' ' + t[:time].round(2).to_s.rjust(6) + ' ' + t[:status].ljust(6) + ' ' + error
-						failed += 1 if t[:status] != 'OK'
-					end
-					exit failed if failed > 0
-				end
-			end
-		end
-	end
+#--
+# 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'
+
+module Bauxite
+	# +bauxite+ command-line program.
+	# 
+	# This program executes Bauxite tests and outputs the execution progress
+	# and tests results to the terminal.
+	#
+	# == Synopsis
+	#
+	#    bauxite [OPTIONS] file1 file2 ...
+	#    # => Executes file1, then file2, and so on.
+	#    
+	#    bauxite [OPTIONS] -d
+	#    # => Start Bauxite directly in the debug console.
+	#    
+	#    bauxite [OPTIONS]
+	#    # => Start Bauxite and read test actions from the standard input.
+	#
+	# == Options
+	# For a detailed list of options for your Bauxite version execute:
+	#    bauxite -h
+    #
+	#
+	# [-v, \--verbose]
+	#     Show verbose error messages (i.e. print exception names and
+	#     backtraces).
+	#
+	# [-t, \--timeout SECONDS]
+	#     Number of seconds to wait before issuing a timeout error. This
+	#     timeout applies only to Selectors. 
+	#
+	# [-o, \--open_timeout SECONDS]
+	#     Number of seconds to wait before issuing a timeout error. This
+	#     timeout applies only to page loading times (i.e. Net::HTTP).
+	#
+	# [-d, \--debug]
+	#     If an error occurs, break into the debug console. This mode is very
+	#     useful to try different selector combinations and debug
+	#     NoSuchElementError errors.
+	#
+	# [-p, \--provider DRIVER]
+	#     Selenium WebDriver provider. Defaults to +firefox+.
+	#
+	#     Other options include:
+	#     - +remote+
+	#     - +ie+
+	#     - +chrome+
+	#     - +android+
+	#     - +iphone+
+	#     - +opera+
+	#     - +phantomjs+
+	#     - +safari+
+	#
+	#     Driver availability dependes on the system running Bauxite.
+	# [-P, \--provider-option OPTION] 
+	#    A <tt>name=value</tt> pair of options that are directly forwarded to
+	#    the Selenium WebDriver provider. This option argument can appear
+	#    multiple times in the command line to specify multiple options.
+	#
+	# [-l, \--logger LOGGER]
+	#    Logger instance to use. Defaults to +xterm+ if the +TERM+ environment
+	#    variable is set to +xterm+, otherwise it defaults to +terminal+.
+	#
+	#    To see a complete list of the available loggers execute:
+	#        bauxite -h
+	#
+	#    Note that multiple instances of this option can be specified.
+	#
+	# [-L, \--logger-option OPTION]
+	#    A <tt>name=value</tt> pair of options that are directly forwarded to
+	#    the logger. This option argument can appear multiple times in the
+	#    command line to specify multiple options.
+	#
+	# [-r, \--reset]
+	#    Issue a Action#reset action between every test specified in
+	#    the command line. This option enforces test isolation by resetting
+	#    the test context before each test (this removes cookies, sessions,
+	#    etc. from the previous test).
+	#
+	# [-w, \--wait]
+	#    Wait for user input when the test completes instead of closing the
+	#    browser window.
+	#
+	# [-s, \--selector SELECTOR]
+	#    Default selector strategy. This strategy is applied if the selector
+	#    text does not contain an <tt>=</tt> sign.
+	#
+	#    To see a complete list of the available selectors execute:
+	#        bauxite -h
+	#
+	# [-c, \--capture]
+	#    If the test fails, capture a screenshot in the +output+ directory.
+	#    See the \--output option below.
+	#
+	# [\--csv-summary FILE]
+	#    Output a single-line CSV summary ideal to feed into the Plot Jenkins
+	#    plugin. If +FILE+ is not specified, defaults to +summary.csv+
+	#
+	# [\--output DIR]
+	#    Output directory for generated artifacts. Defaults to the current
+	#    working directory.
+	#
+	# [-u, \--url URL]
+	#    This option is an alias of:
+	#        -p remote -P url=URL
+	#    If +URL+ is not present <tt>http://localhost:4444/wd/hub</tt> will be
+	#    assumed.
+	#
+	# [\--jenkins DIR]
+	#    Configures default options for Jenkins integration. This option is an
+	#    alias of:
+	#         -p remote -P url=http://localhost:4444/wd/hub -l echo -l html
+	#         -L html_package=true -c --csv-summary
+	#         --output DIR
+	#    Note that any of the options above can be overridden by specifying the
+	#    option after the <tt>--jenkins</tt> option. For example:
+	#         --jenkins -u selenium.my-organization.com:4445
+	#
+	# [-e, \--extension DIR]
+	#    Loads every Ruby file (*.rb) inside +DIR+ (and subdirectories). This
+	#    option can be used to load custom Bauxite extensions (e.g. Actions, 
+	#    Selectors, Loggers, etc.) for a specific test run.
+	#
+	#    For example:
+	#        # === custom/my_selector.rb ======= #
+	#        class Bauxite::Selector
+	#            def by_attr(value)
+	#                attr "by_attr:#{value}"
+	#            end
+	#        end
+	#        # === end custom/my_selector.rb === #
+	#
+	#        # === custom/my_test.bxt ========== #
+	#        # ...
+	#        assert "by_attr=attr_value" hello
+	#        # ...
+	#        # === end custom/my_test.bxt ====== #
+	#
+	#        bauxite -e custom custom/my_test.bxt
+	#
+	# [\--version]
+	#     Shows the Bauxite version.
+	#
+	# == Exit Status
+	# The +bauxite+ program exits with +zero+ if every action in the test
+	# succeeded and +non-zero+ otherwise.
+	# 
+	# If the test run includes multiple Action#test actions, the exit status
+	# equals the number of failed test cases (again, +zero+ indicates success).
+	#
+	class Application
+		def self.start #:nodoc:
+			options = {
+				:logger       => [],
+				:verbose      => false,
+				:break        => false,
+				:driver       => 'firefox',
+				:debug        => false,
+				:timeout      => 10,
+				:open_timeout => 60,
+				:reset        => false,
+				:selector     => 'sid',
+				:driver_opt   => {},
+				:logger_opt   => {},
+				:extensions   => []
+			}
+			
+			default_logger = (ENV['TERM'] == 'xterm') ?  'xterm' : 'terminal'
+			
+			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.hash(*args)
+					on(*args[1..-1]) do |v|
+						n,v = v.split('=', 2)
+						@o[args[0]][n.to_sym] = v || true
+					end
+					self
+				end
+				def opts.multi(*args)
+					on(*args[1..-1]) do |v|
+						@o[args[0]] << v
+					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(:open_timeout, "-o",  "--open-timeout SECONDS", "Open timeout (#{options[:open_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")
+				.hash(  :driver_opt  , "-P",  "--provider-option OPTION", "Provider options (name=value)")
+				.multi( :logger      , "-l",  "--logger LOGGER"         , "Logger type ('#{default_logger}')")
+				.hash(  :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")
+				.single(:selector    , "-s",  "--selector SELECTOR"     , "Default selector ('#{options[:selector]}')")
+				.single(:capture     , "-c",  "--capture"               , "If the test fails, capture a screenshot")
+				.single(:output      , "--output DIR"                   , "Output directory for generated artifacts")
+				.multi( :extensions  , "-e",  "--extension DIR"         , "Load extensions from DIR")
+				
+				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("--csv-summary [FILE]", "Output a single-line CSV summary") { |v| options[:csv] = v || 'summary.csv' }
+				
+				opts.on("--jenkins DIR", "Configure default options for Jenkins integration") do |v|
+					options[:driver] = 'remote'
+					options[:driver_opt][:url] = 'http://localhost:4444/wd/hub'
+					options[:logger] = ['echo', 'html']
+					options[:output] = v
+					options[:logger_opt][:html_package] = true
+					options[:capture] = true
+					options[:csv] = 'summary.csv'
+				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!
+			
+			options[:logger] << default_logger unless options[:logger].size > 0
+			
+			ctx = nil
+			begin
+				ctx = Context.new(options)
+			rescue StandardError => e
+				puts e.message
+				if options[:verbose]
+					p e
+					puts e.backtrace
+				end
+				exit false
+			end
+
+			files = ARGV
+			files = ['stdin'] if files.size == 0 and not options[:debug]
+
+			actions = files.map { |f| "load \"#{f.gsub('"', '""')}\"" }
+
+			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)
+			rescue StandardError => e
+				exit false
+			ensure
+				if ctx.tests.any?
+
+					if (csv_file = options[:csv])
+						total  = ctx.tests.size
+						ok     = ctx.tests.inject(0) { |s,t| s + (t[:status] == 'OK' ? 1 : 0) }
+						failed = total - ok
+						time   = ctx.tests.inject(0) { |s,t| s + t[:time] }
+						File.open(ctx.output_path(csv_file), 'w') do |f|
+							f.write "Total,OK,Failed,Time\n#{total},#{ok},#{failed},#{time}\n"
+						end
+					end
+					
+					failed = 0
+					
+					puts
+					puts 'Test summary:'
+					puts '============='
+					puts 'Name'.ljust(40 ) + ' Time'.ljust(7 ) + ' Status'.ljust(7)+' Error'
+					puts ''.ljust(40, '-') + ' '.ljust(7, '-') + ' '.ljust(7, '-' )+' '.ljust(5, '-')
+					ctx.tests.each do |t|
+						error = t[:error]
+						error = error ? error.message : ''
+						puts t[:name].ljust(40) + ' ' + t[:time].round(2).to_s.rjust(6) + ' ' + t[:status].ljust(6) + ' ' + error
+						failed += 1 if t[:status] != 'OK'
+					end
+					exit failed if failed > 0
+				end
+			end
+		end
+	end
 end