@@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="UTF-8"?> -<buildpath> - <buildpathentry kind="src" path="spec"/> - <buildpathentry kind="src" path="lib"/> -</buildpath> +<?xml version="1.0" encoding="UTF-8"?> +<buildpath> + <buildpathentry kind="src" path="spec"/> + <buildpathentry kind="src" path="lib"/> +</buildpath> .buildpath @@ -1,23 +1,23 @@ -<?xml version="1.0" encoding="UTF-8"?> -<projectDescription> - <name>selenium</name> - <comment></comment> - <projects> - </projects> - <buildSpec> - <buildCommand> - <name>org.eclipse.dltk.core.scriptbuilder</name> - <arguments> - </arguments> - </buildCommand> - <buildCommand> - <name>org.rubypeople.rdt.core.rubybuilder</name> - <arguments> - </arguments> - </buildCommand> - </buildSpec> - <natures> - <nature>org.rubypeople.rdt.core.rubynature</nature> - <nature>org.eclipse.dltk.ruby.core.nature</nature> - </natures> -</projectDescription> +<?xml version="1.0" encoding="UTF-8"?> +<projectDescription> + <name>selenium</name> + <comment></comment> + <projects> + </projects> + <buildSpec> + <buildCommand> + <name>org.eclipse.dltk.core.scriptbuilder</name> + <arguments> + </arguments> + </buildCommand> + <buildCommand> + <name>org.rubypeople.rdt.core.rubybuilder</name> + <arguments> + </arguments> + </buildCommand> + </buildSpec> + <natures> + <nature>org.rubypeople.rdt.core.rubynature</nature> + <nature>org.eclipse.dltk.ruby.core.nature</nature> + </natures> +</projectDescription> .project @@ -1,17 +1,17 @@ -= Selenium Ruby[http://selenium.rubyforge.org] - Object-oriented testing with selenium - -Homepage:: http://selenium.rubyforge.org -Author:: Shane -Copyright:: (c) 2006 Selenium-Ruby on rubyforge -License:: Apache License 2.0 (http://www.apache.org/licenses/LICENSE-2.0.txt) - -Selenium Ruby[http://selenium.rubyforge.org] is a project that wraps selenium-rc[http://www.openqa.org/selenium-rc/] -into an object-oriented way, and wraps it into a RubyGem. - -This rDoc is intended for you the check out the available methods on the objects. For a full -document of what Selenium can do for you, please check out the home page: -http://selenium.rubyforge.org - -For document on the Selenium project and its RC, see Selenium homepage: http://www.openqa.org/selenium - += Selenium Ruby[http://selenium.rubyforge.org] - Object-oriented testing with selenium + +Homepage:: http://selenium.rubyforge.org +Author:: Shane +Copyright:: (c) 2006 Selenium-Ruby on rubyforge +License:: Apache License 2.0 (http://www.apache.org/licenses/LICENSE-2.0.txt) + +Selenium Ruby[http://selenium.rubyforge.org] is a project that wraps selenium-rc[http://www.openqa.org/selenium-rc/] +into an object-oriented way, and wraps it into a RubyGem. + +This rDoc is intended for you the check out the available methods on the objects. For a full +document of what Selenium can do for you, please check out the home page: +http://selenium.rubyforge.org + +For document on the Selenium project and its RC, see Selenium homepage: http://www.openqa.org/selenium + Please post your question at mailing-list. \ No newline at end of file README @@ -1,5 +1,5 @@ -#!/usr/bin/env ruby -$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + "/../lib")) -require 'selenium' - +#!/usr/bin/env ruby +$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + "/../lib")) +require 'selenium' + Selenium::SeleniumServer.run(ARGV) \ No newline at end of file bin/selenium @@ -1,15 +1,15 @@ -module Selenium - class Alert - def initialize(webpage) - @webpage = webpage - end - - def present? - @webpage.alert_present? - end - - def message - @webpage.alert_message - end - end +module Selenium + class Alert + def initialize(webpage) + @webpage = webpage + end + + def present? + @webpage.alert_present? + end + + def message + @webpage.alert_message + end + end end \ No newline at end of file lib/selenium/alert.rb @@ -1,4 +1,4 @@ -require 'win32ole' -require 'selenium/auto_it_driver' -require 'selenium/auto_it_window' -require 'selenium/file_upload' +require 'win32ole' +require 'selenium/auto_it_driver' +require 'selenium/auto_it_window' +require 'selenium/file_upload' lib/selenium/auto_it.rb @@ -1,45 +1,45 @@ -module Selenium - class AutoIt - @@autoit = nil - - def self.load - begin - @@autoit = load_instance - rescue WIN32OLERuntimeError - registerAutoItDll - @@autoit = load_instance - end - @@autoit - end - - def self.load_instance - @@autoit = WIN32OLE.new('AutoItX3.Control') unless @@autoit - @@autoit - end - - def self.reset - if @@autoit - @@autoit.ole_free - @@autoit =nil - system("regsvr32.exe /s /u #{dll}") - end - end - - def self.registerAutoItDll - system("regsvr32.exe /s #{dll}") - end - - def self.dll - File.join(File.dirname(__FILE__), 'autoit', 'AutoItX3.dll') - end - - def initialize - @autoit = AutoIt.load - end - - def on_window_active(title, text = nil) - @autoit.WinWaitActive(title, text, 30) - yield @@autoit - end - end +module Selenium + class AutoIt + @@autoit = nil + + def self.load + begin + @@autoit = load_instance + rescue WIN32OLERuntimeError + registerAutoItDll + @@autoit = load_instance + end + @@autoit + end + + def self.load_instance + @@autoit = WIN32OLE.new('AutoItX3.Control') unless @@autoit + @@autoit + end + + def self.reset + if @@autoit + @@autoit.ole_free + @@autoit =nil + system("regsvr32.exe /s /u #{dll}") + end + end + + def self.registerAutoItDll + system("regsvr32.exe /s #{dll}") + end + + def self.dll + File.join(File.dirname(__FILE__), 'autoit', 'AutoItX3.dll') + end + + def initialize + @autoit = AutoIt.load + end + + def on_window_active(title, text = nil) + @autoit.WinWaitActive(title, text, 30) + yield @@autoit + end + end end \ No newline at end of file lib/selenium/auto_it_driver.rb @@ -1,82 +1,82 @@ -class AutoItWindow - def initialize(autoit, title, text=nil) - @autoit = autoit - @title = title - @text = text - end - - def self.wait_for(autoit, title, text = nil) - window = self.new(autoit, title, text) - window.wait_for_appear - window - end - - def self.on_activation(autoit, title, text = nil) - window = wait_for(autoit, title, text) - yield window - end - - def wait_for_activation - @autoit.WinWaitActive(@title, @text, 30) - end - - def wait_for_appear - @autoit.WinWait(@title, @text, 30) - end - - def activate - @autoit.WinActivate(@title, @text) - end - - def active? - 1 == @autoit.WinActive(@title, @text) - end - - def state - AutoItWindowState.new(@autoit.WinGetState(@title, @text)) - end - - def send_keys(keys) - activate_if_needed - @autoit.Send(keys) - end - - def close - @autoit.WinClose(@title) - end - - def activate_if_needed - winstate = state - activate unless winstate.active? - end -end - -class AutoItWindowState - def initialize(state) - @state = state - end - - def exists? - @state & 1 > 0 - end - - def visible? - @state & 2 > 0 - end - - def enabled? - @state & 4 > 0 - end - - def active? - @state & 8 > 0 - end - - def minimized? - @state & 16 > 0 - end - - def maxmized? - @state & 32 > 0 - end -end +class AutoItWindow + def initialize(autoit, title, text=nil) + @autoit = autoit + @title = title + @text = text + end + + def self.wait_for(autoit, title, text = nil) + window = self.new(autoit, title, text) + window.wait_for_appear + window + end + + def self.on_activation(autoit, title, text = nil) + window = wait_for(autoit, title, text) + yield window + end + + def wait_for_activation + @autoit.WinWaitActive(@title, @text, 30) + end + + def wait_for_appear + @autoit.WinWait(@title, @text, 30) + end + + def activate + @autoit.WinActivate(@title, @text) + end + + def active? + 1 == @autoit.WinActive(@title, @text) + end + + def state + AutoItWindowState.new(@autoit.WinGetState(@title, @text)) + end + + def send_keys(keys) + activate_if_needed + @autoit.Send(keys) + end + + def close + @autoit.WinClose(@title) + end + + def activate_if_needed + winstate = state + activate unless winstate.active? + end +end + +class AutoItWindowState + def initialize(state) + @state = state + end + + def exists? + @state & 1 > 0 + end + + def visible? + @state & 2 > 0 + end + + def enabled? + @state & 4 > 0 + end + + def active? + @state & 8 > 0 + end + + def minimized? + @state & 16 > 0 + end + + def maxmized? + @state & 32 > 0 + end +end lib/selenium/auto_it_window.rb @@ -1,12 +1,12 @@ -module Selenium - class FileUpload - def initialize(webpage, locator) - @webpage = webpage - @locator = locator - end - - def enter(file) - @webpage.upload(@locator, file) - end - end +module Selenium + class FileUpload + def initialize(webpage, locator) + @webpage = webpage + @locator = locator + end + + def enter(file) + @webpage.upload(@locator, file) + end + end end \ No newline at end of file lib/selenium/file_upload.rb @@ -1,16 +1,16 @@ -module Selenium - class Key - def initialize(webpage, key) - @webpage = webpage - @key = key - end - - def up - @webpage.key_up(@key) - end - - def down - @webpage.key_down(@key) - end - end +module Selenium + class Key + def initialize(webpage, key) + @webpage = webpage + @key = key + end + + def up + @webpage.key_up(@key) + end + + def down + @webpage.key_down(@key) + end + end end \ No newline at end of file lib/selenium/key.rb @@ -1,15 +1,15 @@ -module Selenium - module Locator - def by_name(name) - name - end - - def by_id(id) - "id=#{id}" - end - - def by_text(text) - "link=#{text}" - end - end +module Selenium + module Locator + def by_name(name) + name + end + + def by_id(id) + "id=#{id}" + end + + def by_text(text) + "link=#{text}" + end + end end \ No newline at end of file lib/selenium/locator.rb @@ -1,5 +1,5 @@ -All the files in this foler are from the "Selenium" project on OpenQA (http://www.openqa.org/selenium-rc/), under the -Apache License (http://www.openqa.org/selenium-rc/license.action) - -The selenium-server.jar was renamed to have a txt extension because somehow ruby gem does not like jar extension (Installation +All the files in this foler are from the "Selenium" project on OpenQA (http://www.openqa.org/selenium-rc/), under the +Apache License (http://www.openqa.org/selenium-rc/license.action) + +The selenium-server.jar was renamed to have a txt extension because somehow ruby gem does not like jar extension (Installation will fail on buffer error. \ No newline at end of file lib/selenium/openqa/README @@ -1,120 +1,120 @@ -module Selenium -# The class that can manages the server driver classes. -# This class is originally copied from the BuildMaster project. -# You can setup your build task to start the server before -# the tests and shutdown when it is finished -# server = Selenium::Server.new() -# begin -# server.start -# tests.run # run your tests here -# ensure -# server.stop -# end -class Server - # The status of the server. Values are - # * stopped - # * starting - # * started - # * stopping - # * error - attr_reader :status - - # The timeout setting for selenium in seconds - attr_reader :timeout - - def Server::on_port(port) - Server.new(SeleniumServer.new(port)) - end - - # Create a selenium server that can be controlled directly - def initialize(port_number, timeout=60) - if port_number.is_a? SeleniumServer - # backward compatibility, to be removed in 2.0 - @server = port_number - else - @server = SeleniumServer.new(port_number, timeout) - end - @status = 'stopped' - end - - def print_log=(value) - @server.print_log = value - end - - # Starts the server, returns when the server is up and running - def start(*argv) - puts "starting selenium server..." - starting_server(*argv) - wait_for_condition {@server.running?} - puts "started selenium server" - @status = 'started' - end - - def driver(browser_start_command, browser_url) - SeleniumDriver.new('localhost', @server.port_number, browser_start_command, browser_url, @server.request_timeout * 1000) - end - - def open(browser_start_command, browser_url) - url = URI.parse(browser_url) - browser = driver(browser_start_command, URI::Generic::new(url.scheme, url.userinfo, url.host, url.port, nil, nil, nil, nil, nil)) - browser.start - browser.open(url.request_uri) - WebPage.new(browser) - end - - # Starts the server, does not return until the server shuts down - def run(*argv) - @server.start(*argv) - end - - # Stops the server, returns when the server is no longer running - def stop - puts "stopping selenium server..." - stopping_server - wait_for_condition {not @server.running?} - puts "stopped selenium server." - @status = 'stopped' - end - - private - def starting_server(*argv) - @status = 'starting' - ['INT', 'TERM'].each { |signal| - trap(signal){ @server.stop} - } - start_thread {run(*argv)} - end - - def stopping_server - @status = 'stopping' - start_thread {@server.stop} - end - - def start_thread - Thread.new do - begin - yield - rescue Exception => exception - @exception = exception - end - end - end - - def wait_for_condition - count = 0 - sleep 1 - while not (result = yield) - if (@exception) - error = @exception - @exception = nil - @status = 'error' - raise error - end - count = count + 1 - raise 'wait timed out' unless count < 10 - sleep 1 - end - end - -end +module Selenium +# The class that can manages the server driver classes. +# This class is originally copied from the BuildMaster project. +# You can setup your build task to start the server before +# the tests and shutdown when it is finished +# server = Selenium::Server.new() +# begin +# server.start +# tests.run # run your tests here +# ensure +# server.stop +# end +class Server + # The status of the server. Values are + # * stopped + # * starting + # * started + # * stopping + # * error + attr_reader :status + + # The timeout setting for selenium in seconds + attr_reader :timeout + + def Server::on_port(port) + Server.new(SeleniumServer.new(port)) + end + + # Create a selenium server that can be controlled directly + def initialize(port_number, timeout=60) + if port_number.is_a? SeleniumServer + # backward compatibility, to be removed in 2.0 + @server = port_number + else + @server = SeleniumServer.new(port_number, timeout) + end + @status = 'stopped' + end + + def print_log=(value) + @server.print_log = value + end + + # Starts the server, returns when the server is up and running + def start(*argv) + puts "starting selenium server..." + starting_server(*argv) + wait_for_condition {@server.running?} + puts "started selenium server" + @status = 'started' + end + + def driver(browser_start_command, browser_url) + SeleniumDriver.new('localhost', @server.port_number, browser_start_command, browser_url, @server.request_timeout * 1000) + end + + def open(browser_start_command, browser_url) + url = URI.parse(browser_url) + browser = driver(browser_start_command, URI::Generic::new(url.scheme, url.userinfo, url.host, url.port, nil, nil, nil, nil, nil)) + browser.start + browser.open(url.request_uri) + WebPage.new(browser) + end + + # Starts the server, does not return until the server shuts down + def run(*argv) + @server.start(*argv) + end + + # Stops the server, returns when the server is no longer running + def stop + puts "stopping selenium server..." + stopping_server + wait_for_condition {not @server.running?} + puts "stopped selenium server." + @status = 'stopped' + end + + private + def starting_server(*argv) + @status = 'starting' + ['INT', 'TERM'].each { |signal| + trap(signal){ @server.stop} + } + start_thread {run(*argv)} + end + + def stopping_server + @status = 'stopping' + start_thread {@server.stop} + end + + def start_thread + Thread.new do + begin + yield + rescue Exception => exception + @exception = exception + end + end + end + + def wait_for_condition + count = 0 + sleep 1 + while not (result = yield) + if (@exception) + error = @exception + @exception = nil + @status = 'error' + raise error + end + count = count + 1 + raise 'wait timed out' unless count < 10 + sleep 1 + end + end + +end end \ No newline at end of file lib/selenium/server.rb @@ -1,11 +1,11 @@ -module Selenium - class TextArea < HtmlElement - def enter(value) - @webpage.enter(@locator, value) - end - - def value - @webpage.value(@locator) - end - end +module Selenium + class TextArea < HtmlElement + def enter(value) + @webpage.enter(@locator, value) + end + + def value + @webpage.value(@locator) + end + end end \ No newline at end of file lib/selenium/text_area.rb @@ -1,209 +1,209 @@ -module Selenium - # Error that is thrown when a key is not supported - class NoKeyError < NameError - def initialize(key) - super(key) - end - end - - # Class that models a web page with a title - class WebPage - attr_reader :browser - attr_accessor :timeout, :interval_millis - - def initialize(browser, expected_title = nil) - @browser = browser - @expected_title = expected_title - @timeout = 60 - @interval_millis = 100 - end - - def title - raise 'nil as browser' unless @browser - @browser.get_title - end - - def present? - title == @expected_title - end - - def ensure_present - title.should == @expected_title - end - - def html - @browser.get_html_source - end - - def speed=(value) - @browser.set_speed(value) - end - - def speed - @browser.get_speed.to_i - end - - def wait_for_load - @browser.wait_for_page_to_load - end - - def wait_until(message, &block) - Timeout::timeout(timeout, "Timeout waiting for : #{message}") do - while(not yield message) - sleep interval_millis / 1000.0 - end - end - end - - def alert - Alert.new(self) - end - - def link(how, what=nil) - if (how == :text) - locator = "link=#{what}" - elsif (how == :href) - locator = "xpath=//a[@href='#{what}']" - else - locator = element_locator(how, what) - end - Link.new(self, locator) - end - - def text_field(how, what=nil) - TextField.new(self, element_locator(how, what)) - end - - def text_area(how, what=nil) - TextArea.new(self, element_locator(how, what)) - end - - def element(how, what=nil) - HtmlElement.new(self, element_locator(how,what)) - end - - def element_locator(how, what=nil) - locator = how - if (not what.nil?) - if (how == :xpath or how == :name or how == :id) - locator = "#{how}=#{what}" - else - raise "couldn't understand how to build locator using #{how} with #{what}" - end - end - locator - end - - def file_upload(how, what) - FileUpload.new(self, element_locator(how, what)) - end - - def open_page(url) - @browser.open(url) - end - - def close - @browser.stop - end - - def click(locator) - @browser.click(locator) - end - - def text(locator) - @browser.get_text(locator) - end - - def button(how, what=nil) - Button.new(self, element_locator(how, what)) - end - - def key(key) - Key.new(self, key) - end - - def element_present?(locator) - @browser.is_element_present(locator) - end - - def alert_present? - @browser.is_alert_present - end - - def text_present?(text) - @browser.is_text_present(text) - end - - def double_click(locator) - @browser.double_click(locator) - end - - def click_wait(locator) - click(locator) - wait_for_load - end - - # enter the text to the element found by locator - def enter(locator, text) - @browser.type(locator, text) - end - - def value(locator) - @browser.get_value(locator) - end - - def alert_message - @browser.get_alert - end - - def context_menu(locator) - @browser.context_menu(locator) - end - - def fire_event(locator, event) - @browser.fire_event(locator, event) - end - - def key_down(key) - message = "#{key}_key_down" - raise NoKeyError.new(key.to_s) unless @browser.respond_to? message - @browser.send message - end - - def key_up(key) - message = "#{key}_key_up" - raise NoKeyError.new(key.to_s) unless @browser.respond_to? message - @browser.send message - end - - def key_press(locator, key) - @browser.key_press(locator, key) - end - - def focus(locator) - @browser.focus(locator) - end - - def upload(locator, file) -# @browser.attach_file(locator, file) - @browser.click(locator) - require 'auto_it' - autoit = AutoIt.load - window = AutoItWindow.wait_for(autoit, 'File Upload') - puts window - end - - def capture_page(file) - @browser.capture_entire_page_screenshot(file) - end - - def capture_screen(file) - @browser.capture_screenshot(file) - end - - def to_s - "#{self.class}('#{@expected_title}') - #{browser.to_s}" - end - - end +module Selenium + # Error that is thrown when a key is not supported + class NoKeyError < NameError + def initialize(key) + super(key) + end + end + + # Class that models a web page with a title + class WebPage + attr_reader :browser + attr_accessor :timeout, :interval_millis + + def initialize(browser, expected_title = nil) + @browser = browser + @expected_title = expected_title + @timeout = 60 + @interval_millis = 100 + end + + def title + raise 'nil as browser' unless @browser + @browser.get_title + end + + def present? + title == @expected_title + end + + def ensure_present + title.should == @expected_title + end + + def html + @browser.get_html_source + end + + def speed=(value) + @browser.set_speed(value) + end + + def speed + @browser.get_speed.to_i + end + + def wait_for_load + @browser.wait_for_page_to_load + end + + def wait_until(message, &block) + Timeout::timeout(timeout, "Timeout waiting for : #{message}") do + while(not yield message) + sleep interval_millis / 1000.0 + end + end + end + + def alert + Alert.new(self) + end + + def link(how, what=nil) + if (how == :text) + locator = "link=#{what}" + elsif (how == :href) + locator = "xpath=//a[@href='#{what}']" + else + locator = element_locator(how, what) + end + Link.new(self, locator) + end + + def text_field(how, what=nil) + TextField.new(self, element_locator(how, what)) + end + + def text_area(how, what=nil) + TextArea.new(self, element_locator(how, what)) + end + + def element(how, what=nil) + HtmlElement.new(self, element_locator(how,what)) + end + + def element_locator(how, what=nil) + locator = how + if (not what.nil?) + if (how == :xpath or how == :name or how == :id) + locator = "#{how}=#{what}" + else + raise "couldn't understand how to build locator using #{how} with #{what}" + end + end + locator + end + + def file_upload(how, what) + FileUpload.new(self, element_locator(how, what)) + end + + def open_page(url) + @browser.open(url) + end + + def close + @browser.stop + end + + def click(locator) + @browser.click(locator) + end + + def text(locator) + @browser.get_text(locator) + end + + def button(how, what=nil) + Button.new(self, element_locator(how, what)) + end + + def key(key) + Key.new(self, key) + end + + def element_present?(locator) + @browser.is_element_present(locator) + end + + def alert_present? + @browser.is_alert_present + end + + def text_present?(text) + @browser.is_text_present(text) + end + + def double_click(locator) + @browser.double_click(locator) + end + + def click_wait(locator) + click(locator) + wait_for_load + end + + # enter the text to the element found by locator + def enter(locator, text) + @browser.type(locator, text) + end + + def value(locator) + @browser.get_value(locator) + end + + def alert_message + @browser.get_alert + end + + def context_menu(locator) + @browser.context_menu(locator) + end + + def fire_event(locator, event) + @browser.fire_event(locator, event) + end + + def key_down(key) + message = "#{key}_key_down" + raise NoKeyError.new(key.to_s) unless @browser.respond_to? message + @browser.send message + end + + def key_up(key) + message = "#{key}_key_up" + raise NoKeyError.new(key.to_s) unless @browser.respond_to? message + @browser.send message + end + + def key_press(locator, key) + @browser.key_press(locator, key) + end + + def focus(locator) + @browser.focus(locator) + end + + def upload(locator, file) +# @browser.attach_file(locator, file) + @browser.click(locator) + require 'auto_it' + autoit = AutoIt.load + window = AutoItWindow.wait_for(autoit, 'File Upload') + puts window + end + + def capture_page(file) + @browser.capture_entire_page_screenshot(file) + end + + def capture_screen(file) + @browser.capture_screenshot(file) + end + + def to_s + "#{self.class}('#{@expected_title}') - #{browser.to_s}" + end + + end end \ No newline at end of file lib/selenium/web_page.rb @@ -1,79 +1,79 @@ -$:.unshift File.dirname(__FILE__) - -require 'rubygems' -Gem::manage_gems -require 'rake' -require 'spec/rake/spectask' -require 'rake/gempackagetask' -require 'rake/rdoctask' -require 'rcov/rcovtask' -require 'specs' -require 'buildmaster/project/server_manager' -require 'lib/selenium' - -rcov_dir = SITE_SPEC.output_dir.dir('rcov') -rspec_dir = SITE_SPEC.output_dir.dir('rspec') - -task :init do - rcov_dir.mkdirs - rspec_dir.mkdirs -end - -#desc "Run all specifications" -Spec::Rake::SpecTask.new(:coverage) do |t| - t.spec_files = FileList['spec/**/tc_*.rb'] - t.rcov = true - t.rcov_dir = rcov_dir.path - t.spec_opts = ["--format", "html:#{rspec_dir.file('index.html').path}", "--diff"] - t.fail_on_error = true -end - -Rake::RDocTask.new(:rdoc) do |rdoc| - rdoc.main = "README" - rdoc.rdoc_files.include("README", "lib/**/*.rb") - rdoc.options << "--all" - rdoc.rdoc_dir = SITE_SPEC.output_dir.dir('rdoc').path.to_s -end - -task :default => [:coverage, :build_site, :rdoc, :package] -task :coverage => [:init] - -# ??? if we use the rakt gem task, it will somehow be built multiple times and fail??? -task :package do - Gem::manage_gems - Gem::Builder.new(SPEC).build -end - -task :local_install do - gem_file = SPEC.full_name + ".gem" - puts "Insalling #{gem_file}..." - Gem::Installer.new(gem_file).install -end - -task :build_site do - BuildMaster::Site.new(SITE_SPEC).build -end - -task :publish_site do - svn = BuildMaster::SvnDriver.from_path(BuildMaster::Cotta.new.file(__FILE__).parent) - output_dir = SITE_SPEC.output_dir - raise 'output dir needs to be called the same as the project name for one copy action to work' unless output_dir.name == 'selenium' - BuildMaster::PscpDriver.new("#{svn.user}@selenium.rubyforge.org").copy(output_dir.path, '/var/www/gforge-projects') -end - -task :test_site do - BuildMaster::Site.new(SITE_SPEC).test -end - -task :serve do - BuildMaster::Site.new(SITE_SPEC).server -end - -task :setup_site do - BuildMaster::Site.setup(SITE_SPEC) -end - -task :selenium do - server = Selenium::SeleniumServer.new(BuildMaster::Cotta.new, 4444) - server.start -end +$:.unshift File.dirname(__FILE__) + +require 'rubygems' +Gem::manage_gems +require 'rake' +require 'spec/rake/spectask' +require 'rake/gempackagetask' +require 'rake/rdoctask' +require 'rcov/rcovtask' +require 'specs' +require 'buildmaster/project/server_manager' +require 'lib/selenium' + +rcov_dir = SITE_SPEC.output_dir.dir('rcov') +rspec_dir = SITE_SPEC.output_dir.dir('rspec') + +task :init do + rcov_dir.mkdirs + rspec_dir.mkdirs +end + +#desc "Run all specifications" +Spec::Rake::SpecTask.new(:coverage) do |t| + t.spec_files = FileList['spec/**/tc_*.rb'] + t.rcov = true + t.rcov_dir = rcov_dir.path + t.spec_opts = ["--format", "html:#{rspec_dir.file('index.html').path}", "--diff"] + t.fail_on_error = true +end + +Rake::RDocTask.new(:rdoc) do |rdoc| + rdoc.main = "README" + rdoc.rdoc_files.include("README", "lib/**/*.rb") + rdoc.options << "--all" + rdoc.rdoc_dir = SITE_SPEC.output_dir.dir('rdoc').path.to_s +end + +task :default => [:coverage, :build_site, :rdoc, :package] +task :coverage => [:init] + +# ??? if we use the rakt gem task, it will somehow be built multiple times and fail??? +task :package do + Gem::manage_gems + Gem::Builder.new(SPEC).build +end + +task :local_install do + gem_file = SPEC.full_name + ".gem" + puts "Insalling #{gem_file}..." + Gem::Installer.new(gem_file).install +end + +task :build_site do + BuildMaster::Site.new(SITE_SPEC).build +end + +task :publish_site do + svn = BuildMaster::SvnDriver.from_path(BuildMaster::Cotta.new.file(__FILE__).parent) + output_dir = SITE_SPEC.output_dir + raise 'output dir needs to be called the same as the project name for one copy action to work' unless output_dir.name == 'selenium' + BuildMaster::PscpDriver.new("#{svn.user}@selenium.rubyforge.org").copy(output_dir.path, '/var/www/gforge-projects') +end + +task :test_site do + BuildMaster::Site.new(SITE_SPEC).test +end + +task :serve do + BuildMaster::Site.new(SITE_SPEC).server +end + +task :setup_site do + BuildMaster::Site.setup(SITE_SPEC) +end + +task :selenium do + server = Selenium::SeleniumServer.new(BuildMaster::Cotta.new, 4444) + server.start +end rakefile.rb @@ -1,29 +1,29 @@ -$:.unshift File.dirname(__FILE__) - -require 'buildmaster/cotta' -require 'buildmaster/project' -require 'specs' - -root = BuildMaster::Cotta.file(__FILE__).parent -svn = BuildMaster::SvnDriver.from_path(root) - -release = BuildMaster::Release.new -release.task('version') do - VERSION_NUMBER.increase_build - SPEC.version = VERSION_NUMBER.version_number -end -release.task("rake") {load('rake')} -release.task('commit') {svn.commit('committing before release')} -release.task('tagging') do - tag = "selenium-#{SPEC.version}" - puts "tagging with #{tag}" - svn.tag(tag) -end - -release.task("upload") do - gem = "#{SPEC.name}-#{SPEC.version}" - target_path = "/var/www/gforge-projects/selenium/builds/#{gem}.gem" - BuildMaster::PscpDriver.new("#{svn.user}@selenium.rubyforge.org").copy(root.file("#{gem}.gem").to_s, target_path) -end - +$:.unshift File.dirname(__FILE__) + +require 'buildmaster/cotta' +require 'buildmaster/project' +require 'specs' + +root = BuildMaster::Cotta.file(__FILE__).parent +svn = BuildMaster::SvnDriver.from_path(root) + +release = BuildMaster::Release.new +release.task('version') do + VERSION_NUMBER.increase_build + SPEC.version = VERSION_NUMBER.version_number +end +release.task("rake") {load('rake')} +release.task('commit') {svn.commit('committing before release')} +release.task('tagging') do + tag = "selenium-#{SPEC.version}" + puts "tagging with #{tag}" + svn.tag(tag) +end + +release.task("upload") do + gem = "#{SPEC.name}-#{SPEC.version}" + target_path = "/var/www/gforge-projects/selenium/builds/#{gem}.gem" + BuildMaster::PscpDriver.new("#{svn.user}@selenium.rubyforge.org").copy(root.file("#{gem}.gem").to_s, target_path) +end + release.command(ARGV) \ No newline at end of file release.rb @@ -1,20 +1,20 @@ ---- -Contribute ---- -This project is created so that we can share our experiences using ruby and Selenium to test our web applications. -You can start by joining the "selenium-ruby":http://groups.google.com/group/selenium-ruby google group. This project -will be constantly updated on the following area: - -h1. Testing API - -* Creating more wrapper classes that presents HTML elements with behaviors. -* Re-design the API to leverage Ruby language and remove duplication - -h1. Testing Patterns - -* Share your experience of using Selenium with Ruby. What is good, what is bad. -* Share the patterns that you have built in your porject to make test easy and fun. - -h1. Write about it - +--- +Contribute +--- +This project is created so that we can share our experiences using ruby and Selenium to test our web applications. +You can start by joining the "selenium-ruby":http://groups.google.com/group/selenium-ruby google group. This project +will be constantly updated on the following area: + +h1. Testing API + +* Creating more wrapper classes that presents HTML elements with behaviors. +* Re-design the API to leverage Ruby language and remove duplication + +h1. Testing Patterns + +* Share your experience of using Selenium with Ruby. What is good, what is bad. +* Share the patterns that you have built in your porject to make test easy and fun. + +h1. Write about it + * Love it, hate it? Write about it \ No newline at end of file site/contribute.txt @@ -1,367 +1,367 @@ -body { - padding: 0px; - margin: 0px; - border: 0px; - font-family: helvetica, arial, sans-serif; - background-color: white; - color: black; -} - -h1, h2, h3, h4, h5, h6 { - margin: 0px; - border: 0px; - padding: 0px; - font-weight: normal; -} - -a:link { color: #00a; } -a:active { color: red; } -a:hover { color: darkred; } -a:visited { color: black; } - -#logo { - padding: 10px; -} - -img { - border: 0px; - padding: 0px; - margin: 0px; -} - -p { - border: 0px; - padding: 0px; - margin: 0px; - margin-bottom: 10px; -} - -blockquote { - margin-bottom: 10px; -} - -td { - padding: 2px; -} - -th { - font-weight: normal; - white-space: nowrap; - padding: 2px; - color: white; -} - -th.Row { - text-align: left; - vertical-align: top; -} - -ul, ol { - border: 0px; - padding: 0px; - margin-top: 0px; - margin-bottom: 12px; - margin-left: 20px; -} - -div.header { - top: 0px; - left: 0px; - right: 0px; - width: 100%; - height: 70px; - margin: 0px; - border: 0px; - background-color: #CC9999; - border-bottom: 1px solid #825C47; - padding-left: 0px; - padding-right: 0px; - padding-top: 0px; - padding-bottom: 4px; -} - -h1.header { - padding:0; - margin:0; -} - -a.header { border: 0px; text-decoration: none;} -a.header:visited { color: #00a; } -a.header:hover { color: red; } -a.header:active { color: red; } - -div.left { - float:left; - width:180px; - background-color: white; - padding: 8px; - font-size: small; - font-style: normal; - margin-top: 16px; -} - -div.left h1{ - margin: 0px; - border: 0px; - padding: 4px; - color: #663333; - font-size: small; - font-weight: bold; -} - -div.MenuGroup a { text-decoration: none; } -div.MenuGroup a:link { color: #894926; } -div.MenuGroup a:visited { color: #894926; } -div.MenuGroup a:active { color: red; } -div.MenuGroup a:hover { color: white; background-color:#894926;width:160px;} - -/*--------------------------------------------------------------------------- - * Menus - */ -.MenuGroup { - border-left: 1px solid #825C47; - border-top: 1px solid #825C47; - border-bottom: 1px solid white; /* IE work-around */ - - margin-bottom: 8px; - background-color: white; - color: #894926; -} - -.MenuGroup ul { - margin: 0px; - padding-left: 4px; - list-style-type: none; -} - -.MenuGroup li { - padding: 2px; -} - -.More { - width: 100%; - text-align: right; -} -/*------------------------------------------------------------------------------*/ - -/*------------------------------------------------- - * Right Panel - */ -div.right { - float:right; - width:184px; - margin:0; - background-color: white; - padding: 8px; - font-size: small; - font-style: normal; - margin-top: 16px; -} - -div.right h1{ - margin: 0px; - border: 0px; - padding: 4px; - color: #663333; - font-size: small; - font-weight: bold; -} - -div.right a { text-decoration: none; } -div.right a:link { color: #894926; } -div.right a:visited { color: #894926; } -div.right a:active { color: red; } -div.right a:hover { color: red; } - - -/*--------------------------------------------------------------------------- - * News panel - */ -.NewsGroup { - border-left: 1px solid #825C47; - border-top: 1px solid #825C47; - border-bottom: 1px solid white; /* IE workaround */ - margin-bottom: 8px; - - color: #663333; -} -.NewsItem { - margin: 4px; -} -.NewsTitle { - font-weight: bold; - margin: 0px; - padding: 0px; -} -.NewsDate { - margin: 0px; - padding: 0px; - font-size: smaller; -} -.NewsText { - padding: 0px; - margin: 0px; - margin-bottom: 8px; -} -.NewsText a { text-decoration: underline; } -.NewsText a:link { color: #894926; } -.NewsText a:visited { color: #894926; } -.NewsText a:active { color: red; } -.NewsText a:hover { color: red; } -.NewsMore { - font-size: small; - margin: 4px; - margin-top: 12px; - text-align: left; -} -.NewsGroup td { - font-size: 12px; -} - -/*-------------------------------------------------------------------------*/ - -/*--------------------------------------------------------------------------- - * Document meta-information - */ - -.Meta { - margin-top: 64px; - font-size: smaller; - color: #C0C0C0; - text-align: right; -} - -.Meta a { text-decoration: underline; } -.Meta a:link { color: #C0C0C0; } -.Meta a:visited { color: #C0C0C0; } -.Meta a:active { color: red; } -.Meta a:hover { color: red; } -/*--------------------------------------------------------------------------*/ - -div.Content3Column { - margin-left:200px; - margin-right:216px; -} - -div.Content2Column { - margin-left:200px; - margin-right:16px; -} - -div.content h1 { - width: 100%; - font-size: Larger; - background-color: #663333; - color: white; - padding: 2px; - padding-left: 6px; - margin-top: 24px; - margin-bottom: 12px; -} - -div.content a { text-decoration: underline; } -div.content a:link { color: #894926; } -div.content a:visited { color: #894926; } -div.content a:active { color: green; } -div.content a:hover { color: red; } -div.content h2 { - margin-top: 24px; - margin-bottom: 16px; - font-weight: bold; - font-size: Larger; -} - -div.content li { - margin-bottom: 6px; -} -div.content th { - background-color: #825C47; - color: white; -} -div.content td { - background-color: #D7B19C; -} - -div.Shaded pre { - padding: 4px; - font-family: courier new, monospace; - font-size: smaller; - border: 1px solid #008; - background-color: #CCCC99; - color: black; -} - -div.Shaded:before { - margin: 0px; - padding: 0px; - border: 0px; - font-size: inherit; - /*line-spacing: 100%;*/ -} - -pre.code { - padding: 4px; - font-family: courier new, monospace; - font-size: smaller; - border: 1px solid #008; - background-color: #CCCC99; - color: black; -} - -div.Code { - white-space: pre; - padding: 4px; - font-family: courier new, monospace; - font-size: smaller; - border: 1px solid #008; - background-color: #CCCC99; - color: black; -} - -div.Code:before { - margin: 0px; - padding: 0px; - border: 0px; - font-size: inherit; -} - -div.footer { - color: #894926; - padding:0.5em; - clear:both; - text-align:center; - font-size:75%; -} - -div.footer a { - color:#894926; - font-size:inherit; -} - -div.bottomshadow { - width:100%; - height: 12px; - background-image: url("/border_bottom.gif"); - background-repeat: repeat-x; - padding: 12px; -} - -div#content .Float { - float: right; - margin-left: 8px; - margin-right: 0px; - margin-top: 8px; - margin-bottom: 8px; -} - -div#content .Diagram { - display: block; - margin-left: auto; - margin-right: auto; - margin-top: 8px; - margin-bottom: 8px; -} - -div#content .Inline { - display: inline; -} +body { + padding: 0px; + margin: 0px; + border: 0px; + font-family: helvetica, arial, sans-serif; + background-color: white; + color: black; +} + +h1, h2, h3, h4, h5, h6 { + margin: 0px; + border: 0px; + padding: 0px; + font-weight: normal; +} + +a:link { color: #00a; } +a:active { color: red; } +a:hover { color: darkred; } +a:visited { color: black; } + +#logo { + padding: 10px; +} + +img { + border: 0px; + padding: 0px; + margin: 0px; +} + +p { + border: 0px; + padding: 0px; + margin: 0px; + margin-bottom: 10px; +} + +blockquote { + margin-bottom: 10px; +} + +td { + padding: 2px; +} + +th { + font-weight: normal; + white-space: nowrap; + padding: 2px; + color: white; +} + +th.Row { + text-align: left; + vertical-align: top; +} + +ul, ol { + border: 0px; + padding: 0px; + margin-top: 0px; + margin-bottom: 12px; + margin-left: 20px; +} + +div.header { + top: 0px; + left: 0px; + right: 0px; + width: 100%; + height: 70px; + margin: 0px; + border: 0px; + background-color: #CC9999; + border-bottom: 1px solid #825C47; + padding-left: 0px; + padding-right: 0px; + padding-top: 0px; + padding-bottom: 4px; +} + +h1.header { + padding:0; + margin:0; +} + +a.header { border: 0px; text-decoration: none;} +a.header:visited { color: #00a; } +a.header:hover { color: red; } +a.header:active { color: red; } + +div.left { + float:left; + width:180px; + background-color: white; + padding: 8px; + font-size: small; + font-style: normal; + margin-top: 16px; +} + +div.left h1{ + margin: 0px; + border: 0px; + padding: 4px; + color: #663333; + font-size: small; + font-weight: bold; +} + +div.MenuGroup a { text-decoration: none; } +div.MenuGroup a:link { color: #894926; } +div.MenuGroup a:visited { color: #894926; } +div.MenuGroup a:active { color: red; } +div.MenuGroup a:hover { color: white; background-color:#894926;width:160px;} + +/*--------------------------------------------------------------------------- + * Menus + */ +.MenuGroup { + border-left: 1px solid #825C47; + border-top: 1px solid #825C47; + border-bottom: 1px solid white; /* IE work-around */ + + margin-bottom: 8px; + background-color: white; + color: #894926; +} + +.MenuGroup ul { + margin: 0px; + padding-left: 4px; + list-style-type: none; +} + +.MenuGroup li { + padding: 2px; +} + +.More { + width: 100%; + text-align: right; +} +/*------------------------------------------------------------------------------*/ + +/*------------------------------------------------- + * Right Panel + */ +div.right { + float:right; + width:184px; + margin:0; + background-color: white; + padding: 8px; + font-size: small; + font-style: normal; + margin-top: 16px; +} + +div.right h1{ + margin: 0px; + border: 0px; + padding: 4px; + color: #663333; + font-size: small; + font-weight: bold; +} + +div.right a { text-decoration: none; } +div.right a:link { color: #894926; } +div.right a:visited { color: #894926; } +div.right a:active { color: red; } +div.right a:hover { color: red; } + + +/*--------------------------------------------------------------------------- + * News panel + */ +.NewsGroup { + border-left: 1px solid #825C47; + border-top: 1px solid #825C47; + border-bottom: 1px solid white; /* IE workaround */ + margin-bottom: 8px; + + color: #663333; +} +.NewsItem { + margin: 4px; +} +.NewsTitle { + font-weight: bold; + margin: 0px; + padding: 0px; +} +.NewsDate { + margin: 0px; + padding: 0px; + font-size: smaller; +} +.NewsText { + padding: 0px; + margin: 0px; + margin-bottom: 8px; +} +.NewsText a { text-decoration: underline; } +.NewsText a:link { color: #894926; } +.NewsText a:visited { color: #894926; } +.NewsText a:active { color: red; } +.NewsText a:hover { color: red; } +.NewsMore { + font-size: small; + margin: 4px; + margin-top: 12px; + text-align: left; +} +.NewsGroup td { + font-size: 12px; +} + +/*-------------------------------------------------------------------------*/ + +/*--------------------------------------------------------------------------- + * Document meta-information + */ + +.Meta { + margin-top: 64px; + font-size: smaller; + color: #C0C0C0; + text-align: right; +} + +.Meta a { text-decoration: underline; } +.Meta a:link { color: #C0C0C0; } +.Meta a:visited { color: #C0C0C0; } +.Meta a:active { color: red; } +.Meta a:hover { color: red; } +/*--------------------------------------------------------------------------*/ + +div.Content3Column { + margin-left:200px; + margin-right:216px; +} + +div.Content2Column { + margin-left:200px; + margin-right:16px; +} + +div.content h1 { + width: 100%; + font-size: Larger; + background-color: #663333; + color: white; + padding: 2px; + padding-left: 6px; + margin-top: 24px; + margin-bottom: 12px; +} + +div.content a { text-decoration: underline; } +div.content a:link { color: #894926; } +div.content a:visited { color: #894926; } +div.content a:active { color: green; } +div.content a:hover { color: red; } +div.content h2 { + margin-top: 24px; + margin-bottom: 16px; + font-weight: bold; + font-size: Larger; +} + +div.content li { + margin-bottom: 6px; +} +div.content th { + background-color: #825C47; + color: white; +} +div.content td { + background-color: #D7B19C; +} + +div.Shaded pre { + padding: 4px; + font-family: courier new, monospace; + font-size: smaller; + border: 1px solid #008; + background-color: #CCCC99; + color: black; +} + +div.Shaded:before { + margin: 0px; + padding: 0px; + border: 0px; + font-size: inherit; + /*line-spacing: 100%;*/ +} + +pre.code { + padding: 4px; + font-family: courier new, monospace; + font-size: smaller; + border: 1px solid #008; + background-color: #CCCC99; + color: black; +} + +div.Code { + white-space: pre; + padding: 4px; + font-family: courier new, monospace; + font-size: smaller; + border: 1px solid #008; + background-color: #CCCC99; + color: black; +} + +div.Code:before { + margin: 0px; + padding: 0px; + border: 0px; + font-size: inherit; +} + +div.footer { + color: #894926; + padding:0.5em; + clear:both; + text-align:center; + font-size:75%; +} + +div.footer a { + color:#894926; + font-size:inherit; +} + +div.bottomshadow { + width:100%; + height: 12px; + background-image: url("/border_bottom.gif"); + background-repeat: repeat-x; + padding: 12px; +} + +div#content .Float { + float: right; + margin-left: 8px; + margin-right: 0px; + margin-top: 8px; + margin-bottom: 8px; +} + +div#content .Diagram { + display: block; + margin-left: auto; + margin-right: auto; + margin-top: 8px; + margin-bottom: 8px; +} + +div#content .Inline { + display: inline; +} site/cotta.css @@ -1,60 +1,60 @@ ---- -Domain Based Web Testing ---- -Domain based web testing is a style of writing and organizing testing scripts so that they can: - -* Express the intent of the test. -* Avoid duplication in the test. - -This is crucial especially for a large scale web application. - -h1. Example - -Domain based web testing focusing on the intent of the test rather than the action of the test. - -h2. Watir Style - -The simplest domain based web testing wraps the browser object (the one that provides the API to drive the browser) into a page object that provides API that returns the HTML element object based on what you can do at the current page. This is the style that "watir":http://wtr.rubyforge.org provides. These HTML element object classes are simply wrappers that wraps the action command and delegate to the browser driver class as action based command. - -<template:code source="example.rb" tag="basic" syntax="ruby"/> - -h2. Page Object with Behaviors - -When the user comes to a page, they normally wants to do a certain task that involves a group of actions. The page objects should provide those APIs so that the test is clear on what the test is doing rather than how it is doing it. - -<template:code source="example.rb" tag="login" syntax="ruby"/> - -h1. Benefit on Testing Quality - -Domain based web testing requires extra work to design and implement the page and HTML element objects. However, experiences have shown that they pay off quickly. - -With the shared code, each tests only need to write the code that is special about the test. This makes it easy to understand the tests and maintain them. For example, with each page provide the way to locate the HTML elements on the page, it is easy to find the code and change it when the element id or name changes. - -The following are the patterns that have been proved to be useful. Try them out and see if they are useful to your project as well. - -h2. Shared Steps - -You can wrap common steps into the behavior of the component (page or HTML element). - -For example, you can create the @login@ method on the login page. This method will enter the user name and password, click on the submit button and make sure that the login was successful. You can even create different user on the fly and login as the user so that different tests will work on different sets of data and won't affect each other. - -h2. Widgets - -Some HTML element does form submission upon change automatically and some doesn't. You can design your HTML element object so that it knows when the value changes, it needs to wait for the page load. - -Some HTML element has Javascript associated with it so that some other part of the page will change, even when there is no page load. You can also design the element to wait for the condition. For example, for a check box that shows and hides a comment filed, it can be designed as following: - -<template:code source="example.rb" tag="check" syntax="ruby"/> - -In this way, the test code will remain the same and all the work that making sure the test dose what it intends to do is encapsulated into the place where it should be. - -h2. Speed Up Data Setup - -It is always best to exercise the web application during the tests. However, for a large application with lots of tests, it might not be feasible to run everything through browser. You would still want each page to be fully tested but for some of the tests, it is a good idea to create the test data directly into the database. This will speed up your tests and give you better test coverage. - -With the domain based web testing, your tests only concentrate on what kind of data to generate and delegate the generation detail to the page objects. When performance becomes a concern for your tests, you can add additional behavior on those page objects so that for most of the test it delegates the data creation to a back-end API that inserts the data directly into the database. - -h1. Benefit on Communication - -With your domain based testing code expressing the intent of the test, you have created a "domain specific language" for testing of your web application. It would not be hard to go from here and match that language to your domain language. For detail on domain driven design, see "Domain Driven Design":http://domaindrivendesign.org/index.htm - +--- +Domain Based Web Testing +--- +Domain based web testing is a style of writing and organizing testing scripts so that they can: + +* Express the intent of the test. +* Avoid duplication in the test. + +This is crucial especially for a large scale web application. + +h1. Example + +Domain based web testing focusing on the intent of the test rather than the action of the test. + +h2. Watir Style + +The simplest domain based web testing wraps the browser object (the one that provides the API to drive the browser) into a page object that provides API that returns the HTML element object based on what you can do at the current page. This is the style that "watir":http://wtr.rubyforge.org provides. These HTML element object classes are simply wrappers that wraps the action command and delegate to the browser driver class as action based command. + +<template:code source="example.rb" tag="basic" syntax="ruby"/> + +h2. Page Object with Behaviors + +When the user comes to a page, they normally wants to do a certain task that involves a group of actions. The page objects should provide those APIs so that the test is clear on what the test is doing rather than how it is doing it. + +<template:code source="example.rb" tag="login" syntax="ruby"/> + +h1. Benefit on Testing Quality + +Domain based web testing requires extra work to design and implement the page and HTML element objects. However, experiences have shown that they pay off quickly. + +With the shared code, each tests only need to write the code that is special about the test. This makes it easy to understand the tests and maintain them. For example, with each page provide the way to locate the HTML elements on the page, it is easy to find the code and change it when the element id or name changes. + +The following are the patterns that have been proved to be useful. Try them out and see if they are useful to your project as well. + +h2. Shared Steps + +You can wrap common steps into the behavior of the component (page or HTML element). + +For example, you can create the @login@ method on the login page. This method will enter the user name and password, click on the submit button and make sure that the login was successful. You can even create different user on the fly and login as the user so that different tests will work on different sets of data and won't affect each other. + +h2. Widgets + +Some HTML element does form submission upon change automatically and some doesn't. You can design your HTML element object so that it knows when the value changes, it needs to wait for the page load. + +Some HTML element has Javascript associated with it so that some other part of the page will change, even when there is no page load. You can also design the element to wait for the condition. For example, for a check box that shows and hides a comment filed, it can be designed as following: + +<template:code source="example.rb" tag="check" syntax="ruby"/> + +In this way, the test code will remain the same and all the work that making sure the test dose what it intends to do is encapsulated into the place where it should be. + +h2. Speed Up Data Setup + +It is always best to exercise the web application during the tests. However, for a large application with lots of tests, it might not be feasible to run everything through browser. You would still want each page to be fully tested but for some of the tests, it is a good idea to create the test data directly into the database. This will speed up your tests and give you better test coverage. + +With the domain based web testing, your tests only concentrate on what kind of data to generate and delegate the generation detail to the page objects. When performance becomes a concern for your tests, you can add additional behavior on those page objects so that for most of the test it delegates the data creation to a back-end API that inserts the data directly into the database. + +h1. Benefit on Communication + +With your domain based testing code expressing the intent of the test, you have created a "domain specific language" for testing of your web application. It would not be hard to go from here and match that language to your domain language. For detail on domain driven design, see "Domain Driven Design":http://domaindrivendesign.org/index.htm + site/doc/domain-based-web-testing.txt @@ -1,51 +1,51 @@ -require 'spec' - -context 'domain based web testing example' do - specify 'basic' do - # START basic - login_page = LoginPage.new(@browser) - login_page.username_field.enter('user') - login_page.password_field.enter('password') - login_page.login_button.click - # END basic - end - - specify 'login' do - # START login - login_page = LoginPage.new(@browser) - login_page.login('user', 'wrongpassword') - work_items_page = WorkItemsPage.new(@browser) - work_item_page.fill_in(data_fixture.create_full_work_item_data) - work_item_page.due_date_field.enter_yesterday - work_item_page.submit_buttoc.click - work_item_page.should be_present - work_item_page.error.should be_visible - work_item_page.error.text.should == 'Due date should be after today' - # END login - end -end - -# START check -class CommentCheckBox - attr_reader :browser, :locator - - def initialize(browser, locator, comment_span) - @browser = browser - @locator = locator - @comment_span = comment_span - end - - def selected - browser.get_value(locator) == 'on' - end - - def click - old_value = selected -<<<<<<< HEAD:site/doc/example.rb - browser.wait_for_condition(@comment_span.script_check_visible((not old_value)), 5000) -======= - browser.wait_for_condition(@comment_span.script_check_visible(not old_value), 5000) ->>>>>>> a3598e23fd3d746137b3a82b575d68ed060b1d4b:site/doc/example.rb - end -end -# END check +require 'spec' + +context 'domain based web testing example' do + specify 'basic' do + # START basic + login_page = LoginPage.new(@browser) + login_page.username_field.enter('user') + login_page.password_field.enter('password') + login_page.login_button.click + # END basic + end + + specify 'login' do + # START login + login_page = LoginPage.new(@browser) + login_page.login('user', 'wrongpassword') + work_items_page = WorkItemsPage.new(@browser) + work_item_page.fill_in(data_fixture.create_full_work_item_data) + work_item_page.due_date_field.enter_yesterday + work_item_page.submit_buttoc.click + work_item_page.should be_present + work_item_page.error.should be_visible + work_item_page.error.text.should == 'Due date should be after today' + # END login + end +end + +# START check +class CommentCheckBox + attr_reader :browser, :locator + + def initialize(browser, locator, comment_span) + @browser = browser + @locator = locator + @comment_span = comment_span + end + + def selected + browser.get_value(locator) == 'on' + end + + def click + old_value = selected +<<<<<<< HEAD:site/doc/example.rb + browser.wait_for_condition(@comment_span.script_check_visible((not old_value)), 5000) +======= + browser.wait_for_condition(@comment_span.script_check_visible(not old_value), 5000) +>>>>>>> a3598e23fd3d746137b3a82b575d68ed060b1d4b:site/doc/example.rb + end +end +# END check site/doc/example.rb @@ -1,24 +1,24 @@ ---- -Document ---- -Please don't forget to check out the "getting started":getting-started.html page - -h1. Selenium Server - -Besides giving you the ability to launch Selenium server with "selenium" command, Selenium Ruby also provides a driver -class, "SeleniumDriver":rdoc/classes/Selenium/SeleniumServer.html, that allows you to start server, check if server is running, -and stop server through ruby program. - -<template:code source="rakefile.rb" tag="RAKE" syntax="ruby"/> - -h1. Testing with Selenium - -h2. Action Based Testing - -This is provided by "Selenium":http://www.openqa.org/selenium-rc/ project itself. The "SeleniumDriver":rdoc/classes/Selenium/SeleniumDriver.html is bundled -with Selenium ruby gem. There is a more Ruby friendly class "WebPage":rdoc/classes/Selenium/WebPage.html that you can check out as well. - -h2. Object Based Testing - -Selenium Ruby provides a set of commonly used classes like "Link":rdoc/classes/Selenium/Link.html, "Button":rdoc/classes/Selenium/Button.html and +--- +Document +--- +Please don't forget to check out the "getting started":getting-started.html page + +h1. Selenium Server + +Besides giving you the ability to launch Selenium server with "selenium" command, Selenium Ruby also provides a driver +class, "SeleniumDriver":rdoc/classes/Selenium/SeleniumServer.html, that allows you to start server, check if server is running, +and stop server through ruby program. + +<template:code source="rakefile.rb" tag="RAKE" syntax="ruby"/> + +h1. Testing with Selenium + +h2. Action Based Testing + +This is provided by "Selenium":http://www.openqa.org/selenium-rc/ project itself. The "SeleniumDriver":rdoc/classes/Selenium/SeleniumDriver.html is bundled +with Selenium ruby gem. There is a more Ruby friendly class "WebPage":rdoc/classes/Selenium/WebPage.html that you can check out as well. + +h2. Object Based Testing + +Selenium Ruby provides a set of commonly used classes like "Link":rdoc/classes/Selenium/Link.html, "Button":rdoc/classes/Selenium/Button.html and "TextField":rdoc/classes/Selenium/TextField.html that can help you build an object model that present your web application. \ No newline at end of file site/document.txt @@ -1,21 +1,21 @@ ---- -Download ---- -h2. RubyGem <template:text property="release"/> - -The easiest way to install the published builds is using the following command through "RubyGem":http://rubygems.org/: - -<div class="code">gem install selenium</div> - -h2. RubyForge - -You can also download the files from "Rubyforge":http://rubyforge.org/frs/?group_id=2789 - -h2. Snapshot <template:text property="snapshot"/> - -You can take the latest snapshot from the "build page":builds/ - -h1. Textmate Bundle - -You can download textmate bundle for Selenium driver from "Project Files":http://rubyforge.org/frs/?group_id=2789&release_id=9004 - +--- +Download +--- +h2. RubyGem <template:text property="release"/> + +The easiest way to install the published builds is using the following command through "RubyGem":http://rubygems.org/: + +<div class="code">gem install selenium</div> + +h2. RubyForge + +You can also download the files from "Rubyforge":http://rubyforge.org/frs/?group_id=2789 + +h2. Snapshot <template:text property="snapshot"/> + +You can take the latest snapshot from the "build page":builds/ + +h1. Textmate Bundle + +You can download textmate bundle for Selenium driver from "Project Files":http://rubyforge.org/frs/?group_id=2789&release_id=9004 + site/download.txt @@ -1,29 +1,29 @@ -------- -Getting Started -------- -Selenium-Ruby bundles the selenium server and Ruby classes in the gem so that you can use them right away. - -h1. Selenium Server - -Selenium-ruby installs the executable at the ruby/bin directory so you can launch the server through command: - -<div class="Shaded"> -<pre>selenium</pre> -</div> - -h1. Selenium RC - -You can use Selenium RC that is installed as a gem, so that your existing action based web testing still works. The following -example is using "RSpec":http://rspec.rubyforge.org: - -<template:code source="../spec/selenium/tc_interaction_example.rb" tag="INTERACTION" syntax="ruby"/> - -h1. Selenium Ruby - -You can use classes that come with Selenium ruby to write object based web testing. - -<template:code source="../spec/selenium/tc_domain_example.rb" tag="DOMAIN" syntax="ruby"/> - -The class that described Google home page is defined as following - -<template:code source="../spec/selenium/tc_domain_example.rb" tag="GOOGLEHOME" syntax="ruby"/> +------- +Getting Started +------- +Selenium-Ruby bundles the selenium server and Ruby classes in the gem so that you can use them right away. + +h1. Selenium Server + +Selenium-ruby installs the executable at the ruby/bin directory so you can launch the server through command: + +<div class="Shaded"> +<pre>selenium</pre> +</div> + +h1. Selenium RC + +You can use Selenium RC that is installed as a gem, so that your existing action based web testing still works. The following +example is using "RSpec":http://rspec.rubyforge.org: + +<template:code source="../spec/selenium/tc_interaction_example.rb" tag="INTERACTION" syntax="ruby"/> + +h1. Selenium Ruby + +You can use classes that come with Selenium ruby to write object based web testing. + +<template:code source="../spec/selenium/tc_domain_example.rb" tag="DOMAIN" syntax="ruby"/> + +The class that described Google home page is defined as following + +<template:code source="../spec/selenium/tc_domain_example.rb" tag="GOOGLEHOME" syntax="ruby"/> site/getting-started.txt @@ -1,13 +1,13 @@ -------------------------------- -Home -------------------------------- -Selenium Ruby is a ruby project that aim to make the popular "Selemium RC":http://www.openqa.org/selenium-rc/ available on rubyforge. - -With Selenium Ruby: -* You can install selenium gem available on rubyforge, which includes the selenium server and SeleniumDriver from Selenium RC project. -* Selenium's action based API is wrapped into a object based API. ("Object based web testing":doc/domain-based-web-testing.html) - -h1. Getting Started - -* "Download it":download.html +------------------------------- +Home +------------------------------- +Selenium Ruby is a ruby project that aim to make the popular "Selemium RC":http://www.openqa.org/selenium-rc/ available on rubyforge. + +With Selenium Ruby: +* You can install selenium gem available on rubyforge, which includes the selenium server and SeleniumDriver from Selenium RC project. +* Selenium's action based API is wrapped into a object based API. ("Object based web testing":doc/domain-based-web-testing.html) + +h1. Getting Started + +* "Download it":download.html * "Use it":getting-started.html \ No newline at end of file site/index.txt @@ -1,19 +1,19 @@ ----------------------------------- -License ----------------------------------- -<div class="Shaded"> -<pre>Copyright Selenium-Ruby project - -Licensed under the Apache License, Version 2.0 (the "License"); -you may not use this file except in compliance with the License. -You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - -Unless required by applicable law or agreed to in writing, software -distributed under the License is distributed on an "AS IS" BASIS, -WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -See the License for the specific language governing permissions and -limitations under the License.</pre> -</div> +---------------------------------- +License +---------------------------------- +<div class="Shaded"> +<pre>Copyright Selenium-Ruby project + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License.</pre> +</div> \ No newline at end of file site/license.txt @@ -1,65 +1,65 @@ -body { - font-family: Times, serif; - font-size: 12pt; - float: none !important; -} - -div.header { - display: none; -} - -div.left { - display:none; -} - -div.bottomshadow { - display:none; -} - -div.poweredby { - display: none; -} - -div.source { - display: none; -} - -div.right { - display:none; -} - -div.content { - font-family: Times, serif; - font-size: 12pt; - width: 100%; -} - -div.Content3Column { - width: 100%; - font-family: Times, serif; - font-size: 12pt; - margin-left: 0px; - margin-right: 0px; -} - -div.Content2Column { - width: 100%; - font-family: Times, serif; - font-size: 12pt; - margin-left: 0px; - margin-right: 0px; -} - -a:link, a:visited { - color: #520; - background: transparent; - font-weight: bold; - text-decoration: underline; - font-size: 12pt; - font-family: Times, serif; -} - -#content a:link:after, #content a:visited:after { - content: " (" attr(href) ") "; - font-size: 90%; +body { + font-family: Times, serif; + font-size: 12pt; + float: none !important; +} + +div.header { + display: none; +} + +div.left { + display:none; +} + +div.bottomshadow { + display:none; +} + +div.poweredby { + display: none; +} + +div.source { + display: none; +} + +div.right { + display:none; +} + +div.content { + font-family: Times, serif; + font-size: 12pt; + width: 100%; +} + +div.Content3Column { + width: 100%; + font-family: Times, serif; + font-size: 12pt; + margin-left: 0px; + margin-right: 0px; +} + +div.Content2Column { + width: 100%; + font-family: Times, serif; + font-size: 12pt; + margin-left: 0px; + margin-right: 0px; +} + +a:link, a:visited { + color: #520; + background: transparent; + font-weight: bold; + text-decoration: underline; + font-size: 12pt; + font-family: Times, serif; +} + +#content a:link:after, #content a:visited:after { + content: " (" attr(href) ") "; + font-size: 90%; } \ No newline at end of file site/print.css @@ -1,36 +1,36 @@ -$:.unshift File.join(File.dirname(__FILE__), '..') - -# Example usage of server manager and selenium server -# Thanks to http://svn.caldersphere.net/svn/main/rspec_selenium_rc/trunk/Rakefile -# - -# START RAKE -require 'lib/selenium' -require 'rake' -require 'spec/rake/spectask' - -manager = Selenium::ServerManager.new(Selenium::SeleniumServer.new) - -task :default => [:acceptance_cycle] - -task :start_server do - manager.start -end - -task :stop_server do - manager.stop -end - -Spec::Rake::SpecTask.new('example') do |t| - t.spec_files = FileList['selenium*example.rb'] -end - -task :acceptance_cycle do - begin - Rake::Task['start_server'].invoke - Rake::Task['example'].invoke - ensure - Rake::Task['stop_server'].invoke - end -end -# END RAKE +$:.unshift File.join(File.dirname(__FILE__), '..') + +# Example usage of server manager and selenium server +# Thanks to http://svn.caldersphere.net/svn/main/rspec_selenium_rc/trunk/Rakefile +# + +# START RAKE +require 'lib/selenium' +require 'rake' +require 'spec/rake/spectask' + +manager = Selenium::ServerManager.new(Selenium::SeleniumServer.new) + +task :default => [:acceptance_cycle] + +task :start_server do + manager.start +end + +task :stop_server do + manager.stop +end + +Spec::Rake::SpecTask.new('example') do |t| + t.spec_files = FileList['selenium*example.rb'] +end + +task :acceptance_cycle do + begin + Rake::Task['start_server'].invoke + Rake::Task['example'].invoke + ensure + Rake::Task['stop_server'].invoke + end +end +# END RAKE site/rakefile.rb @@ -1,5 +1,5 @@ ---- -References ---- -This page contains the useful references for anyone who wants to use Selenium with Ruby. You can help making it better by +--- +References +--- +This page contains the useful references for anyone who wants to use Selenium with Ruby. You can help making it better by "contributing to it":contribute.html. \ No newline at end of file site/references.txt @@ -1,14 +1,14 @@ -pre.code span { - font-family: courier new, monospace; -} - -span.keyword, .namespace, .tag { font-weight: bold; font-family: monospace; color: #8B0000;} -.constant, .attribute, .global, .class, .module { font-family: monospace; color: black;} -.string { font-family: monospace; color: #00008B; } -.ident, .method { font-family: monospace; } -.number, .char { font-family: monospace; color: #888800; } -.comment { font-family: monospace; color: #006400; } -.symbol { font-family: monospace; color: #884400; } -.regex { font-family: monospace; color: #808080; } -.punct { font-family: monospace; color: black; } +pre.code span { + font-family: courier new, monospace; +} + +span.keyword, .namespace, .tag { font-weight: bold; font-family: monospace; color: #8B0000;} +.constant, .attribute, .global, .class, .module { font-family: monospace; color: black;} +.string { font-family: monospace; color: #00008B; } +.ident, .method { font-family: monospace; } +.number, .char { font-family: monospace; color: #888800; } +.comment { font-family: monospace; color: #006400; } +.symbol { font-family: monospace; color: #884400; } +.regex { font-family: monospace; color: #808080; } +.punct { font-family: monospace; color: black; } .escape, .interp, .expr { font-family: monospace; color: purple; } \ No newline at end of file site/ruby.css @@ -1,12 +1,12 @@ ---- -Team ---- -|_.ID|_.Name|_.Information| -|wolfdance|Shane Duan|"Home Page":http://www.shaneduan.com| - -h1. Contributors - -First of all, many thanks to the ThoughtWorks and its friends for creating such a wonderful project, "Selenium":http://www.openqa.com/selenium. - -|_.Name|_.Information|_.Contribution| -|Brian Yamabe|n/a|"Selenium Textmate bundle":http://rubyforge.org/frs/?group_id=2789&release_id=9004| +--- +Team +--- +|_.ID|_.Name|_.Information| +|wolfdance|Shane Duan|"Home Page":http://www.shaneduan.com| + +h1. Contributors + +First of all, many thanks to the ThoughtWorks and its friends for creating such a wonderful project, "Selenium":http://www.openqa.com/selenium. + +|_.Name|_.Information|_.Contribution| +|Brian Yamabe|n/a|"Selenium Textmate bundle":http://rubyforge.org/frs/?group_id=2789&release_id=9004| site/team.txt @@ -1,21 +1,21 @@ -<html> - <head><title>Test Main Page</title></head> -<body> -<h1>Testing</h1> -<p>This is the main test page for selenium-ruby testing</p> -<h2>Action Tests</h2> -This section test all the action methods. -<form action="index.html"> -<h2>Double Click</h2> - <textarea id="doubleclickid" name="doubleclick" - onDblClick="alert('double clicked with value ' + this.form.doubleclick.value)" - onBlur="alert('blurred with value ' + this.form.doubleclick.value)" - rows="10">test</textarea> -<h2>Events</h2> -<input name="events" onblur="alert('blurred with value ' + this.form.events.value)" - onfocus="this.form.events.value = 'default'"/> -</form> - -<a href="../license.txt">License</a> -</body> -</html> +<html> + <head><title>Test Main Page</title></head> +<body> +<h1>Testing</h1> +<p>This is the main test page for selenium-ruby testing</p> +<h2>Action Tests</h2> +This section test all the action methods. +<form action="index.html"> +<h2>Double Click</h2> + <textarea id="doubleclickid" name="doubleclick" + onDblClick="alert('double clicked with value ' + this.form.doubleclick.value)" + onBlur="alert('blurred with value ' + this.form.doubleclick.value)" + rows="10">test</textarea> +<h2>Events</h2> +<input name="events" onblur="alert('blurred with value ' + this.form.events.value)" + onfocus="this.form.events.value = 'default'"/> +</form> + +<a href="../license.txt">License</a> +</body> +</html> site/test/index.html @@ -1,109 +1,109 @@ -<html xmlns="http://www.w3.org/1999/xhtml" - xmlns:template="http://buildmaster.rubyforge.org/xtemplate/1.0"> - <head> - <title>Selenium Ruby - <template:include elements="/html/head/title/text()"/></title> - <link rel="stylesheet" type="text/css"><template:href url="cotta.css"/></link> - <link rel="stylesheet" type="text/css"><template:href url="ruby.css"/></link> - <template:include elements="/html/head/*[not(name()='title')]"/> - </head> - - <body> - <div class="header"><a id="home" class="header"><template:href url="."/><img id="logo" alt="cotta"><template:href url="logo1.gif"/></img></a></div> - - <div class="left"> - <div class="MenuGroup"> - <h1>Software</h1> - <ul> - <li><a><template:href url="download.html"/>Download</a></li> - <li><a><template:attribute name="href" eval="source_url"/>Source Repository</a></li> - <li><a><template:href url="license.html"/>License</a></li> - </ul> - </div> - - <div class="MenuGroup"> - <h1>Documentation</h1> - <ul> - <li><a><template:href url="getting-started.html"/>Getting Started</a></li> - <li><a><template:href url="document.html"/>Document</a></li> - <li><a><template:href url="references.html"/>References</a></li> - </ul> - </div> - - <div class="MenuGroup"> - <h1>User Support</h1> - <ul> - <li><a><template:href url="http://groups.google.com/group/selenium-ruby"/>Mailing List</a></li> - <li><a><template:href url="http://rubyforge.org/tracker/?group_id=2789"/>Bug Tracker</a></li> - </ul> - </div> - - <div class="MenuGroup"> - <h1>Development</h1> - <ul> - <li><a><template:href url="contribute.html"/>How to Contribute</a></li> - <li><a><template:href url="team.html"/>Development Team</a></li> - </ul> - </div> - <div class="logo"> - <a href="http://rubyforge.org/projects/selenium/"> - <img alt="Rubyforge Logo" src="http://rubyforge.org/themes/osx/images/logohover.png" width="170"/> - </a> - </div> - </div> - - <template:when test="index_file?"> - <div class="right"> - <div class="NewsGroup"> - <h1>Latest Versions</h1> - <table> - <tr> - <td><a><template:href url="download.html#stable"/>Stable:</a></td> - <td><a><template:href url="download.html#stable"/><template:text property="release"/></a></td> - </tr> - <tr> - <td><a><template:href url="download.html#prerelease"/>Prerelease:</a></td> - <td><a><template:href url="download.html#prerelease"/><template:text property="prerelease"/></a></td> - </tr> - <tr> - <td><a><template:href url="download.html#snapshot"/>Snapshot:</a></td> - <td><a><template:href url="download.html#snapshot"/><template:text property="snapshot"/></a></td> - </tr> - </table> - <p class="NewsMore"><a><template:href url="http://rubygems.org/read/chapter/7"/>About gem version numbers...</a></p> - </div> - <div class="NewsGroup"> - <h1>Recent News</h1> - <template:each source="news-rss2.xml" select="/rss/channel/item" count="3"> - <div class="NewsItem"> - <p class="NewsTitle"><template:include elements="./title/text()"/></p> - <p class="NewsDate"><template:include elements="./pubDate/text()"/></p> - <p class="NewsText"><template:include elements="./xhtml:div/node()"/></p> - </div> - </template:each> - - <p class="NewsMore"><a href="/news-rss2.xml">News feed (RSS 2.0)</a></p> - </div> - </div> - </template:when> - - <div> - <template:attribute name="class" eval="center_class"/> - <div class="content"> - <h1><template:include elements="/html/head/title/text()"/></h1> - <template:include elements="/html/body/*"/> - </div> - </div> - - <div class="footer"> - <div class="bottomshadow"/> - <div class="poweredby"> - Powered by <a href="http://buildmaster.rubyforge.org" class="footer">BuildMaster</a> - (Version <template:text property="buildmaster_version"/>) - - - <a href="http://rubyforge.org/tracker/?group_id=1680" class="footer">Bug/feature request</a> - <br/> - </div> - </div> - - </body> -</html> +<html xmlns="http://www.w3.org/1999/xhtml" + xmlns:template="http://buildmaster.rubyforge.org/xtemplate/1.0"> + <head> + <title>Selenium Ruby - <template:include elements="/html/head/title/text()"/></title> + <link rel="stylesheet" type="text/css"><template:href url="cotta.css"/></link> + <link rel="stylesheet" type="text/css"><template:href url="ruby.css"/></link> + <template:include elements="/html/head/*[not(name()='title')]"/> + </head> + + <body> + <div class="header"><a id="home" class="header"><template:href url="."/><img id="logo" alt="cotta"><template:href url="logo1.gif"/></img></a></div> + + <div class="left"> + <div class="MenuGroup"> + <h1>Software</h1> + <ul> + <li><a><template:href url="download.html"/>Download</a></li> + <li><a><template:attribute name="href" eval="source_url"/>Source Repository</a></li> + <li><a><template:href url="license.html"/>License</a></li> + </ul> + </div> + + <div class="MenuGroup"> + <h1>Documentation</h1> + <ul> + <li><a><template:href url="getting-started.html"/>Getting Started</a></li> + <li><a><template:href url="document.html"/>Document</a></li> + <li><a><template:href url="references.html"/>References</a></li> + </ul> + </div> + + <div class="MenuGroup"> + <h1>User Support</h1> + <ul> + <li><a><template:href url="http://groups.google.com/group/selenium-ruby"/>Mailing List</a></li> + <li><a><template:href url="http://rubyforge.org/tracker/?group_id=2789"/>Bug Tracker</a></li> + </ul> + </div> + + <div class="MenuGroup"> + <h1>Development</h1> + <ul> + <li><a><template:href url="contribute.html"/>How to Contribute</a></li> + <li><a><template:href url="team.html"/>Development Team</a></li> + </ul> + </div> + <div class="logo"> + <a href="http://rubyforge.org/projects/selenium/"> + <img alt="Rubyforge Logo" src="http://rubyforge.org/themes/osx/images/logohover.png" width="170"/> + </a> + </div> + </div> + + <template:when test="index_file?"> + <div class="right"> + <div class="NewsGroup"> + <h1>Latest Versions</h1> + <table> + <tr> + <td><a><template:href url="download.html#stable"/>Stable:</a></td> + <td><a><template:href url="download.html#stable"/><template:text property="release"/></a></td> + </tr> + <tr> + <td><a><template:href url="download.html#prerelease"/>Prerelease:</a></td> + <td><a><template:href url="download.html#prerelease"/><template:text property="prerelease"/></a></td> + </tr> + <tr> + <td><a><template:href url="download.html#snapshot"/>Snapshot:</a></td> + <td><a><template:href url="download.html#snapshot"/><template:text property="snapshot"/></a></td> + </tr> + </table> + <p class="NewsMore"><a><template:href url="http://rubygems.org/read/chapter/7"/>About gem version numbers...</a></p> + </div> + <div class="NewsGroup"> + <h1>Recent News</h1> + <template:each source="news-rss2.xml" select="/rss/channel/item" count="3"> + <div class="NewsItem"> + <p class="NewsTitle"><template:include elements="./title/text()"/></p> + <p class="NewsDate"><template:include elements="./pubDate/text()"/></p> + <p class="NewsText"><template:include elements="./xhtml:div/node()"/></p> + </div> + </template:each> + + <p class="NewsMore"><a href="/news-rss2.xml">News feed (RSS 2.0)</a></p> + </div> + </div> + </template:when> + + <div> + <template:attribute name="class" eval="center_class"/> + <div class="content"> + <h1><template:include elements="/html/head/title/text()"/></h1> + <template:include elements="/html/body/*"/> + </div> + </div> + + <div class="footer"> + <div class="bottomshadow"/> + <div class="poweredby"> + Powered by <a href="http://buildmaster.rubyforge.org" class="footer">BuildMaster</a> + (Version <template:text property="buildmaster_version"/>) + - + <a href="http://rubyforge.org/tracker/?group_id=1680" class="footer">Bug/feature request</a> + <br/> + </div> + </div> + + </body> +</html> site_template.html @@ -1,20 +1,20 @@ -require File.expand_path(File.join(File.dirname(__FILE__), "..", "spec_helper")) - -if RUBY_PLATFORM =~ /^rwin/ - require 'selenium/auto_it' - require 'spec' - - module Selenium - describe AutoIt do - it 'should control notepad' do - autoit = AutoIt.load - autoit.Run('Notepad.exe') - autoit.WinWaitActive('Untitled - Notepad') - autoit.Send('some text') - autoit.WinClose('Untitled - Notepad') - autoit.WinWaitActive('Notepad', 'Do you want to save') - autoit.Send('!n') - end - end - end -end +require File.expand_path(File.join(File.dirname(__FILE__), "..", "spec_helper")) + +if RUBY_PLATFORM =~ /^rwin/ + require 'selenium/auto_it' + require 'spec' + + module Selenium + describe AutoIt do + it 'should control notepad' do + autoit = AutoIt.load + autoit.Run('Notepad.exe') + autoit.WinWaitActive('Untitled - Notepad') + autoit.Send('some text') + autoit.WinClose('Untitled - Notepad') + autoit.WinWaitActive('Notepad', 'Do you want to save') + autoit.Send('!n') + end + end + end +end spec/selenium/auto_it/tc_auto_it.rb @@ -1,19 +1,19 @@ -require File.expand_path(File.join(File.dirname(__FILE__), "..", "spec_helper")) - -if RUBY_PLATFORM =~ /^rwin/ - require 'selenium/auto_it' - module Selenium - describe AutoItWindow do - it 'should control notepad' do - autoit = AutoIt.load - autoit.Run('Notepad.exe') - window = AutoItWindow.new(autoit, 'Untitled - Notepad') - window.wait_for_activation - window.send_keys('some text') - window.close - confirm = AutoItWindow.wait_for(autoit, 'Notepad', 'Do you want to save') - confirm.send_keys('!n') - end - end - end -end +require File.expand_path(File.join(File.dirname(__FILE__), "..", "spec_helper")) + +if RUBY_PLATFORM =~ /^rwin/ + require 'selenium/auto_it' + module Selenium + describe AutoItWindow do + it 'should control notepad' do + autoit = AutoIt.load + autoit.Run('Notepad.exe') + window = AutoItWindow.new(autoit, 'Untitled - Notepad') + window.wait_for_activation + window.send_keys('some text') + window.close + confirm = AutoItWindow.wait_for(autoit, 'Notepad', 'Do you want to save') + confirm.send_keys('!n') + end + end + end +end spec/selenium/auto_it/tc_auto_it_window.rb @@ -1,11 +1,11 @@ -dir = File.dirname(__FILE__) -selenium_dir = File.expand_path(File.join(dir, '..', '..', '..', 'lib')) -$:.unshift(selenium_dir) unless $:.include?(selenium_dir) - -require "selenium" -require "#{dir}/selenium_ruby/selenium_ruby_page" -require "#{dir}/selenium_ruby/home_page" -require "#{dir}/selenium_ruby/directory_listing_page" -require "#{dir}/selenium_ruby/download_page" -require "#{dir}/selenium_ruby/license_page" -require "#{dir}/selenium_ruby/menu" +dir = File.dirname(__FILE__) +selenium_dir = File.expand_path(File.join(dir, '..', '..', '..', 'lib')) +$:.unshift(selenium_dir) unless $:.include?(selenium_dir) + +require "selenium" +require "#{dir}/selenium_ruby/selenium_ruby_page" +require "#{dir}/selenium_ruby/home_page" +require "#{dir}/selenium_ruby/directory_listing_page" +require "#{dir}/selenium_ruby/download_page" +require "#{dir}/selenium_ruby/license_page" +require "#{dir}/selenium_ruby/menu" spec/selenium/examples/selenium_ruby.rb @@ -1,7 +1,7 @@ -module Selenium - class LicensePage < SeleniumRubyPage - def initialize(browser) - super(browser, 'Selenium Ruby - License') - end - end +module Selenium + class LicensePage < SeleniumRubyPage + def initialize(browser) + super(browser, 'Selenium Ruby - License') + end + end end \ No newline at end of file spec/selenium/examples/selenium_ruby/license_page.rb @@ -1,23 +1,23 @@ -module Selenium - class Menu - attr_reader :webpage - def initialize(webpage) - @webpage = webpage - end - - def home_link - # todo there should be a way to alter this instance so that the click returns the directory listing page - webpage.link(:id, 'home').with_target(DirectoryListingPage) - end - - #MENU START - def download_link - webpage.link(:text, 'Download') - end - - def license_link - webpage.link(:text, 'License').with_target(LicensePage) - end -#MENU END - end +module Selenium + class Menu + attr_reader :webpage + def initialize(webpage) + @webpage = webpage + end + + def home_link + # todo there should be a way to alter this instance so that the click returns the directory listing page + webpage.link(:id, 'home').with_target(DirectoryListingPage) + end + + #MENU START + def download_link + webpage.link(:text, 'Download') + end + + def license_link + webpage.link(:text, 'License').with_target(LicensePage) + end +#MENU END + end end \ No newline at end of file spec/selenium/examples/selenium_ruby/menu.rb @@ -1,17 +1,17 @@ -module Selenium - class SeleniumRubyPage < WebPage - attr_reader :menu - - def initialize(browser, expected_title) - super(browser, expected_title) - end - - def assert_page - title.should == @expected_title - end - - def menu - Menu.new(@browser) - end - end +module Selenium + class SeleniumRubyPage < WebPage + attr_reader :menu + + def initialize(browser, expected_title) + super(browser, expected_title) + end + + def assert_page + title.should == @expected_title + end + + def menu + Menu.new(@browser) + end + end end \ No newline at end of file spec/selenium/examples/selenium_ruby/selenium_ruby_page.rb @@ -1,52 +1,52 @@ -$:.unshift File.join(File.dirname(__FILE__), '..', '..') - -require 'lib/selenium/auto_it' -require 'lib/selenium' -require 'spec' - -module Selenium - describe FileUpload do - before(:all) do - @server = Server.on_port(4440) -# @server.print_log = true - @server.start - end - - after(:all) do - @server.stop - end - - before do - @page = @server.open(BROWSER, 'http://www.rubyforge.org/projects/selenium') - end - - after do - file = File.join(File.dirname(__FILE__), 'screenshot.png') - puts "image at #{file}" - @page.capture_screen(file) - @page.close - end - - # this requires the user to manually enter the login information on rubyforge, and can only be run by selenium admin - it 'should handle firefox' do - login_link = @page.link(:text, 'Log In') - autoit = AutoIt.load - login_link.click if login_link.present? - AutoItWindow.wait_for(autoit, 'Website Certified by an Unknown Authority').send_keys(' ') - @page.wait_for_load - @page.wait_until('manual login for test') do |message| - puts message - not login_link.present? - end - @page.wait_for_load - selenium_project_link = @page.link(:text, 'Selenium') - selenium_project_link.should be_present - selenium_project_link.click_wait - @page.link(:text, 'Files').click_wait - @page.link(:href, '/frs/admin/?group_id=2789').click_wait - @page.link(:xpath, "//a[@href='qrs.php?package_id=3298&group_id=2789']").click_wait - @page.file_upload(:name, 'userfile').enter("file:///#{__FILE__}") -# @page.file_upload('userfile').enter("file:///#{__FILE__}") - end - end +$:.unshift File.join(File.dirname(__FILE__), '..', '..') + +require 'lib/selenium/auto_it' +require 'lib/selenium' +require 'spec' + +module Selenium + describe FileUpload do + before(:all) do + @server = Server.on_port(4440) +# @server.print_log = true + @server.start + end + + after(:all) do + @server.stop + end + + before do + @page = @server.open(BROWSER, 'http://www.rubyforge.org/projects/selenium') + end + + after do + file = File.join(File.dirname(__FILE__), 'screenshot.png') + puts "image at #{file}" + @page.capture_screen(file) + @page.close + end + + # this requires the user to manually enter the login information on rubyforge, and can only be run by selenium admin + it 'should handle firefox' do + login_link = @page.link(:text, 'Log In') + autoit = AutoIt.load + login_link.click if login_link.present? + AutoItWindow.wait_for(autoit, 'Website Certified by an Unknown Authority').send_keys(' ') + @page.wait_for_load + @page.wait_until('manual login for test') do |message| + puts message + not login_link.present? + end + @page.wait_for_load + selenium_project_link = @page.link(:text, 'Selenium') + selenium_project_link.should be_present + selenium_project_link.click_wait + @page.link(:text, 'Files').click_wait + @page.link(:href, '/frs/admin/?group_id=2789').click_wait + @page.link(:xpath, "//a[@href='qrs.php?package_id=3298&group_id=2789']").click_wait + @page.file_upload(:name, 'userfile').enter("file:///#{__FILE__}") +# @page.file_upload('userfile').enter("file:///#{__FILE__}") + end + end end \ No newline at end of file spec/selenium/manual_tc_file_upload.rb @@ -1,37 +1,37 @@ -require "spec" - -$:.unshift File.join(File.dirname(__FILE__), '..', '..', 'lib') - -require 'selenium' - -describe 'Time Out Control' do - - before(:each) do - end - - after(:each) do - end - - - it "should honor the time out argument" do - link_list=["http://www.myantel.net.mm", - "http://www.khitlunge.net.mm", - "http://www.mrtv4.net.mm", - "http://www.mpt.net.mm", - "http://www.yatanarponteleport.net.mm", - "http://www.net.mm", - "http://www.mwdtv.net.mm", - "http://ns1.net.mm", - "http://www.isy.net.mm", - "http://www.mptmail.net.mm", - "http://www.mrtv3.net.mm" - - ] - - selenium=Selenium::SeleniumDriver.new("localhost",4444,"*chrome", link_list.first, 600000) - selenium.start - selenium.set_timeout(600000) - link_list.each {|url| selenium.open(url) } - end - -end +require "spec" + +$:.unshift File.join(File.dirname(__FILE__), '..', '..', 'lib') + +require 'selenium' + +describe 'Time Out Control' do + + before(:each) do + end + + after(:each) do + end + + + it "should honor the time out argument" do + link_list=["http://www.myantel.net.mm", + "http://www.khitlunge.net.mm", + "http://www.mrtv4.net.mm", + "http://www.mpt.net.mm", + "http://www.yatanarponteleport.net.mm", + "http://www.net.mm", + "http://www.mwdtv.net.mm", + "http://ns1.net.mm", + "http://www.isy.net.mm", + "http://www.mptmail.net.mm", + "http://www.mrtv3.net.mm" + + ] + + selenium=Selenium::SeleniumDriver.new("localhost",4444,"*chrome", link_list.first, 600000) + selenium.start + selenium.set_timeout(600000) + link_list.each {|url| selenium.open(url) } + end + +end spec/selenium/manual_tc_timout.rb @@ -1,22 +1,22 @@ -require File.join(File.dirname(__FILE__), "spec_helper") - -module Selenium -describe 'basic operation with selenium' do - before do - port = 4567 - @server = Selenium::Server.on_port(port) - @server.start - @webpage = @server.open(BROWSER, 'http://localhost:2000/test/index.html') - @browser = @webpage.browser - end - - after do - @browser.stop - @webpage.close - @server.stop - end - - it 'should click through menus' do - end -end +require File.join(File.dirname(__FILE__), "spec_helper") + +module Selenium +describe 'basic operation with selenium' do + before do + port = 4567 + @server = Selenium::Server.on_port(port) + @server.start + @webpage = @server.open(BROWSER, 'http://localhost:2000/test/index.html') + @browser = @webpage.browser + end + + after do + @browser.stop + @webpage.close + @server.stop + end + + it 'should click through menus' do + end +end end \ No newline at end of file spec/selenium/tc_basic_operation.rb @@ -1,55 +1,55 @@ -require File.join(File.dirname(__FILE__), "spec_helper") - -#START GOOGLEHOME -class GoogleHomPage < Selenium::WebPage - def initialize(browser) - super(browser, 'Google') - end - - def title - browser.get_title - end - - def search_field - text_field(:name, 'q') - end - - def search_button - button(:name, 'btnG') - end - -end -#END GOOGLEHOME - -context 'Test goole search' do - before(:all) do - port = 4567 - @server = Selenium::Server.on_port(port) - @server.start - end - - before(:each) do - @webpage = @server.open(Selenium::BROWSER, 'http://www.google.com/webhp') - end - - after(:each) do - @webpage.close if @webpage - end - - after(:all) do - puts "stopping server" - @server.stop - end - -#START DOMAIN - specify'searh hello world with google using docmain based script' do - page = GoogleHomPage.new(@webpage.browser) - page.should be_present - page.search_field.enter('hello world') - page.search_button.click_wait - page.title.should == 'hello world - Google Search' - page.search_field.value.should == 'hello world' - end -#END DOMAIN - -end +require File.join(File.dirname(__FILE__), "spec_helper") + +#START GOOGLEHOME +class GoogleHomPage < Selenium::WebPage + def initialize(browser) + super(browser, 'Google') + end + + def title + browser.get_title + end + + def search_field + text_field(:name, 'q') + end + + def search_button + button(:name, 'btnG') + end + +end +#END GOOGLEHOME + +context 'Test goole search' do + before(:all) do + port = 4567 + @server = Selenium::Server.on_port(port) + @server.start + end + + before(:each) do + @webpage = @server.open(Selenium::BROWSER, 'http://www.google.com/webhp') + end + + after(:each) do + @webpage.close if @webpage + end + + after(:all) do + puts "stopping server" + @server.stop + end + +#START DOMAIN + specify'searh hello world with google using docmain based script' do + page = GoogleHomPage.new(@webpage.browser) + page.should be_present + page.search_field.enter('hello world') + page.search_button.click_wait + page.title.should == 'hello world - Google Search' + page.search_field.value.should == 'hello world' + end +#END DOMAIN + +end spec/selenium/tc_domain_example.rb @@ -1,30 +1,30 @@ -require File.join(File.dirname(__FILE__), "spec_helper") - -module Selenium - describe HtmlElement do - before(:all) do - @server = Server.new(4445) - @server.start - @webpage = @server.open(BROWSER, 'http://localhost:2000/test/index.html') - end - - before do - @webpage.open_page('/test/index.html') - end - - after(:all) do - @webpage.close if @webpage - @server.stop - end - - it 'should support double click and key press' do - text_area = @webpage.text_area(:name, 'doubleclick') - text_area.enter 'html double click' - text_area.double_click - @webpage.alert.should be_present - @webpage.alert.message.should == 'double clicked with value html double click' - text_area.key_press('b') - text_area.value.should == 'html double clickb' - end - end +require File.join(File.dirname(__FILE__), "spec_helper") + +module Selenium + describe HtmlElement do + before(:all) do + @server = Server.new(4445) + @server.start + @webpage = @server.open(BROWSER, 'http://localhost:2000/test/index.html') + end + + before do + @webpage.open_page('/test/index.html') + end + + after(:all) do + @webpage.close if @webpage + @server.stop + end + + it 'should support double click and key press' do + text_area = @webpage.text_area(:name, 'doubleclick') + text_area.enter 'html double click' + text_area.double_click + @webpage.alert.should be_present + @webpage.alert.message.should == 'double clicked with value html double click' + text_area.key_press('b') + text_area.value.should == 'html double clickb' + end + end end \ No newline at end of file spec/selenium/tc_html_element.rb @@ -1,26 +1,26 @@ -require File.join(File.dirname(__FILE__), "spec_helper") - -context 'Test goole search' do - before do - port = 4567 - @server = Selenium::Server.on_port(port) - @server.start - @page = @server.open(Selenium::BROWSER, 'http://www.google.com') - end - - after do - @page.close - @server.stop - end - - specify 'search hello world with google using interaction based script' do - @page.open_page("/") - @page.title.should == 'Google' - @page.enter("q", "hello world") - @page.click("btnG") - @page.wait_for_load - @page.title.should == 'hello world - Google Search' - end - -end -#END INTERACTION +require File.join(File.dirname(__FILE__), "spec_helper") + +context 'Test goole search' do + before do + port = 4567 + @server = Selenium::Server.on_port(port) + @server.start + @page = @server.open(Selenium::BROWSER, 'http://www.google.com') + end + + after do + @page.close + @server.stop + end + + specify 'search hello world with google using interaction based script' do + @page.open_page("/") + @page.title.should == 'Google' + @page.enter("q", "hello world") + @page.click("btnG") + @page.wait_for_load + @page.title.should == 'hello world - Google Search' + end + +end +#END INTERACTION spec/selenium/tc_interaction_example.rb @@ -1,20 +1,20 @@ -require File.join(File.dirname(__FILE__), "spec_helper") - -module Selenium -describe 'server manager' do - it 'supports starting and stopping server on specified port' do - server = Server.on_port(4321) - server.start - server.status.should == "started" - server.stop - server.status.should == "stopped" - end - - it 'should support arguments through start method' do - server = Server.on_port(3333) - server.start('-timeout 800') - server.stop - end -end - +require File.join(File.dirname(__FILE__), "spec_helper") + +module Selenium +describe 'server manager' do + it 'supports starting and stopping server on specified port' do + server = Server.on_port(4321) + server.start + server.status.should == "started" + server.stop + server.status.should == "stopped" + end + + it 'should support arguments through start method' do + server = Server.on_port(3333) + server.start('-timeout 800') + server.stop + end +end + end \ No newline at end of file spec/selenium/tc_server.rb @@ -1,109 +1,109 @@ -require File.join(File.dirname(__FILE__), "spec_helper") - -module Selenium - describe WebPage do - before(:all) do - @server = Server.new(2344) - @server.start - @@webpage = nil - end - - before do - @@webpage.open_page('/') if @@webpage - end - - after(:all) do - @server.stop - end - - def webpage - @@webpage = @server.open(BROWSER, 'http://localhost:2000/') unless @@webpage - @@webpage - end - - it 'should have meaningful to_s support' do - webpage = WebPage.new(SeleniumDriver.new('localhost', 2222, '*chrome', 'http://www.example.com', 60000), 'expected title') - webpage.to_s.should == 'Selenium::WebPage(\'expected title\') - SeleniumDriver' - end - - it 'should create link based on text' do - webpage = WebPage.new('browser') - webpage.link(:text, 'text').locator.should == 'link=text' - end - - it 'should create link based on href' do - webpage = WebPage.new('browser') - webpage.link(:href, 'a.html').locator.should == "xpath=//a[@href='a.html']" - end - - it 'should convert how and what to locator for selenium driver' do - webpage.element_locator('name').should == 'name' - webpage.element_locator(:id, 'id').should == 'id=id' - webpage.element_locator(:name, 'name').should == 'name=name' - webpage.element_locator(:xpath, '//a').should == 'xpath=//a' - end - - it 'should support elements by passing in name directly' do - webpage.open_page('/test/index.html') - text_field = webpage.text_field('doubleclick') - text_field.locator.should == 'doubleclick' - text_field.enter('webpage') - webpage.text_area('doubleclick').enter('webpage') - webpage.text_area('doubleclick').double_click - webpage.should be_alert_present - webpage.alert_message.should == 'double clicked with value webpage' - webpage.text_area('doubleclick').key_press('a') - webpage.text_area('doubleclick').value.should == 'webpagea' - end - - it 'should support double click and key press' do - webpage.open_page('/test/index.html') - webpage.enter('doubleclick', 'webpage') - webpage.double_click('doubleclick') - webpage.should be_alert_present - webpage.alert_message.should == 'double clicked with value webpage' - webpage.key_press('doubleclick', 'a') - webpage.value('doubleclick').should == 'webpagea' - end - - it 'should support context menu' do - webpage.open_page('/test/index.html') - webpage.context_menu('link=License') - webpage.capture_screen(File.join(File.dirname(__FILE__), 'screenshot.png')) - end - - it 'should support focus event and fire blur event' do - webpage.open_page('/test/index.html') - webpage.focus('events') - webpage.enter('events', 'value') - webpage.value('events').should == 'value' - webpage.fire_event('events', 'blur') - webpage.should be_alert_present - webpage.alert_message.should == 'blurred with value value' - webpage.fire_event('events', 'focus') -# webpage.focus('events') - webpage.value('events').should == 'default' - end - - it 'should support key event and check if it is supported' do - webpage.open_page('/test/index.httml') - webpage.key_down(:shift) - webpage.key_up(:shift) - [:shift, :meta, :alt, :control].each do |key| - key = webpage.key(key) - key.down - key.up - end - webpage.key(:alt).down - - Proc.new {webpage.key_up(:command)}.should raise_error(NoKeyError) - Proc.new {webpage.key_down(:command)}.should raise_error(NoKeyError) - end - - it 'should have speed as attribute' do - webpage.speed = 500 - webpage.speed.should == 500 - end - - end -end +require File.join(File.dirname(__FILE__), "spec_helper") + +module Selenium + describe WebPage do + before(:all) do + @server = Server.new(2344) + @server.start + @@webpage = nil + end + + before do + @@webpage.open_page('/') if @@webpage + end + + after(:all) do + @server.stop + end + + def webpage + @@webpage = @server.open(BROWSER, 'http://localhost:2000/') unless @@webpage + @@webpage + end + + it 'should have meaningful to_s support' do + webpage = WebPage.new(SeleniumDriver.new('localhost', 2222, '*chrome', 'http://www.example.com', 60000), 'expected title') + webpage.to_s.should == 'Selenium::WebPage(\'expected title\') - SeleniumDriver' + end + + it 'should create link based on text' do + webpage = WebPage.new('browser') + webpage.link(:text, 'text').locator.should == 'link=text' + end + + it 'should create link based on href' do + webpage = WebPage.new('browser') + webpage.link(:href, 'a.html').locator.should == "xpath=//a[@href='a.html']" + end + + it 'should convert how and what to locator for selenium driver' do + webpage.element_locator('name').should == 'name' + webpage.element_locator(:id, 'id').should == 'id=id' + webpage.element_locator(:name, 'name').should == 'name=name' + webpage.element_locator(:xpath, '//a').should == 'xpath=//a' + end + + it 'should support elements by passing in name directly' do + webpage.open_page('/test/index.html') + text_field = webpage.text_field('doubleclick') + text_field.locator.should == 'doubleclick' + text_field.enter('webpage') + webpage.text_area('doubleclick').enter('webpage') + webpage.text_area('doubleclick').double_click + webpage.should be_alert_present + webpage.alert_message.should == 'double clicked with value webpage' + webpage.text_area('doubleclick').key_press('a') + webpage.text_area('doubleclick').value.should == 'webpagea' + end + + it 'should support double click and key press' do + webpage.open_page('/test/index.html') + webpage.enter('doubleclick', 'webpage') + webpage.double_click('doubleclick') + webpage.should be_alert_present + webpage.alert_message.should == 'double clicked with value webpage' + webpage.key_press('doubleclick', 'a') + webpage.value('doubleclick').should == 'webpagea' + end + + it 'should support context menu' do + webpage.open_page('/test/index.html') + webpage.context_menu('link=License') + webpage.capture_screen(File.join(File.dirname(__FILE__), 'screenshot.png')) + end + + it 'should support focus event and fire blur event' do + webpage.open_page('/test/index.html') + webpage.focus('events') + webpage.enter('events', 'value') + webpage.value('events').should == 'value' + webpage.fire_event('events', 'blur') + webpage.should be_alert_present + webpage.alert_message.should == 'blurred with value value' + webpage.fire_event('events', 'focus') +# webpage.focus('events') + webpage.value('events').should == 'default' + end + + it 'should support key event and check if it is supported' do + webpage.open_page('/test/index.httml') + webpage.key_down(:shift) + webpage.key_up(:shift) + [:shift, :meta, :alt, :control].each do |key| + key = webpage.key(key) + key.down + key.up + end + webpage.key(:alt).down + + Proc.new {webpage.key_up(:command)}.should raise_error(NoKeyError) + Proc.new {webpage.key_down(:command)}.should raise_error(NoKeyError) + end + + it 'should have speed as attribute' do + webpage.speed = 500 + webpage.speed.should == 500 + end + + end +end spec/selenium/tc_web_page.rb @@ -1,4 +1,4 @@ -root = File.join(File.dirname(__FILE__)) -Dir.glob("#{root}/**/tc_*.rb") do |file| - require "#{file}" -end +root = File.join(File.dirname(__FILE__)) +Dir.glob("#{root}/**/tc_*.rb") do |file| + require "#{file}" +end spec/ts_selenium.rb @@ -1,42 +1,42 @@ -$:.unshift File.dirname(__FILE__) - -require 'rubygems' -Gem::manage_gems -require 'rake' -require 'buildmaster/project' -require 'buildmaster/project/ruby_forge_project' -require 'buildmaster/site' -require 'buildmaster/cotta' - -VERSION_NUMBER = BuildMaster::VersionNumberFile.new(BuildMaster::Cotta.parent_of(__FILE__).file('lib/selenium/version')) -PROJECT = BuildMaster::RubyForgeProject.new('selenium', '2789') - -SITE_SPEC = BuildMaster::SiteSpec.new(__FILE__) do |spec| - spec.content_dir = 'site' - spec.output_dir = 'build/website/selenium' - spec.template_file = 'site_template.html' - spec.add_property('release', '1.0.7') - spec.add_property('prerelease', 'n/a') - spec.add_property('snapshot', VERSION_NUMBER.version_number) - spec.add_property('source_url', PROJECT.source_repository) - spec.add_property('download_url', PROJECT.release_download_url) -end - -SPEC = Gem::Specification.new do |spec| - spec.name = 'Selenium' - spec.version = VERSION_NUMBER.version_number - spec.author = 'Shane Duan' - spec.email = 'selenium-ruby@googlegroups.com' - spec.homepage = 'http://selenium.rubyforge.org/' - spec.platform = Gem::Platform::RUBY - spec.summary = 'A project that wraps selenium API into object-oriented testing style and packages it into a RubyGem.' - spec.files = FileList["{bin,docs,lib,spec}/**/*"].exclude("rdoc").to_a - spec.require_path = 'lib' - spec.autorequire = 'selenium' - spec.has_rdoc = true - spec.extra_rdoc_files = ["README"] - spec.bindir = 'bin' - spec.executables = ['selenium'] - spec.default_executable = 'selenium' - spec.rubyforge_project = "selenium" -end +$:.unshift File.dirname(__FILE__) + +require 'rubygems' +Gem::manage_gems +require 'rake' +require 'buildmaster/project' +require 'buildmaster/project/ruby_forge_project' +require 'buildmaster/site' +require 'buildmaster/cotta' + +VERSION_NUMBER = BuildMaster::VersionNumberFile.new(BuildMaster::Cotta.parent_of(__FILE__).file('lib/selenium/version')) +PROJECT = BuildMaster::RubyForgeProject.new('selenium', '2789') + +SITE_SPEC = BuildMaster::SiteSpec.new(__FILE__) do |spec| + spec.content_dir = 'site' + spec.output_dir = 'build/website/selenium' + spec.template_file = 'site_template.html' + spec.add_property('release', '1.0.7') + spec.add_property('prerelease', 'n/a') + spec.add_property('snapshot', VERSION_NUMBER.version_number) + spec.add_property('source_url', PROJECT.source_repository) + spec.add_property('download_url', PROJECT.release_download_url) +end + +SPEC = Gem::Specification.new do |spec| + spec.name = 'Selenium' + spec.version = VERSION_NUMBER.version_number + spec.author = 'Shane Duan' + spec.email = 'selenium-ruby@googlegroups.com' + spec.homepage = 'http://selenium.rubyforge.org/' + spec.platform = Gem::Platform::RUBY + spec.summary = 'A project that wraps selenium API into object-oriented testing style and packages it into a RubyGem.' + spec.files = FileList["{bin,docs,lib,spec}/**/*"].exclude("rdoc").to_a + spec.require_path = 'lib' + spec.autorequire = 'selenium' + spec.has_rdoc = true + spec.extra_rdoc_files = ["README"] + spec.bindir = 'bin' + spec.executables = ['selenium'] + spec.default_executable = 'selenium' + spec.rubyforge_project = "selenium" +end specs.rb 635238d4604375c9e44dfc9e2c4fc5dae6c49fe3 wolfdancer wolfdancer@gmail.com http://github.com/wolfdancer/selenium/commit/6307194fe1aaee672b5121e6c5b2040349c93dd6 6307194fe1aaee672b5121e6c5b2040349c93dd6 2008-08-28T21:26:09-07:00 2008-08-28T21:26:09-07:00 line ending fix probably done by git e3749528a1b0595b2752fe293d38203824b4d348 wolfdancer wolfdancer@gmail.com