Selenium 1.0.0

data/lib/selenium/selenium_server.rb

@@ -0,0 +1,55 @@
+require 'net/http'
+
+module Selenium
+
+# Selenium server driver that provides API to start/stop server and check if 
+# server is running.
+# NOTE: The start does not return until the server shuts down.
+class SeleniumServer
+  def SeleniumServer::run(argv)
+    jar_file = SeleniumServer.jar_file
+    command = "java -jar #{jar_file} #{argv.join(' ')}"
+    puts command
+    system(command)
+  end
+  
+  private
+  def SeleniumServer::jar_file
+    File.join(File.dirname(__FILE__), 'openqa', 'selenium-server.jar.txt')
+  end
+  
+  public
+  attr_reader :port_number
+
+  # Initialize the server driver with an opitonal port number (default to 4444)
+  def initialize(port_number = 4444)
+    @port_number = port_number
+  end
+  
+  # Starts the Selenium server.  This does not return until the server is shutdown.
+  def start
+    SeleniumServer.run(['-port', port_number.to_s])
+  end
+  
+  # Stops the Selenium server
+  def stop
+    Net::HTTP.get('localhost', '/selenium-server/driver/?cmd=shutDown', @port_number)
+  end
+  
+  # Check if the Selenium is running by sending a test_complete command with invalid session ID
+  def running?
+    url = URI.parse("http://localhost:#{@port_number}/selenium-server/driver/?cmd=testComplete&sessionId=smoketest")
+    request = Net::HTTP::Get.new(url.path)
+    begin
+      res = Net::HTTP.start(url.host, url.port) {|http|
+        http.read_timeout=5
+        http.request(request)
+      }
+      puts "response: #{res}"
+    rescue Errno::EBADF => e
+      return false
+    end 
+    return true      
+  end
+end
+end

data/lib/selenium/server_manager.rb

@@ -0,0 +1,82 @@
+module Selenium
+# The class that can manages the server driver classes.
+# This class is copied from the BuildMaster project.
+# You can setup your build task to start the server before 
+# the tests and shutdown when it is finished
+#   manager = Selenium::ServerManager.new(Selenium::Server.new)
+#   begin
+#     manager.start
+#     tests.run # run your tests here
+#   ensure
+#     manager.stop
+#   end
+class ServerManager
+  # The status of the server.  Values are
+  # * stopped
+  # * starting
+  # * started
+  # * stopping
+  # * error
+  attr_reader :status
+  
+  def initialize(server)
+    @server = server
+    @status = 'stopped'
+  end
+  
+  # Starts the server, returns when the server is up and running
+  def start
+    starting_server
+    wait_for_condition {@server.running?}
+    @status = 'started'
+  end
+  
+  # Stops the server, returns when the server is no longer running
+  def stop
+    stopping_server
+    wait_for_condition {not @server.running?}
+    @status = 'stopped'
+  end
+
+  private
+  def starting_server
+    @status = 'starting'
+    ['INT', 'TERM'].each { |signal|
+         trap(signal){ @server.stop} 
+    }  
+    start_thread {@server.start}
+  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

data/lib/selenium/text_field.rb

@@ -0,0 +1,18 @@
+module Selenium
+class TextField
+  attr_reader :browser
+  
+  def initialize(browser, locator)
+    @browser = browser
+    @locator = locator
+  end
+  
+  def type(value)
+    @browser.type(@locator, value)
+  end
+  
+  def value
+    @browser.get_value(@locator)
+  end
+end
+end

data/lib/selenium/version

@@ -0,0 +1 @@
+1.0.0

data/test/selenium/download_page.rb

@@ -0,0 +1,13 @@
+$:.unshift File.dirname(__FILE__)
+require 'menu'
+
+module Selenium
+class DownloadPage
+  include Menu
+  attr_reader :browser
+  
+  def initialize(browser)
+    @browser = browser
+  end
+end  
+end

data/test/selenium/home_page.rb

@@ -0,0 +1,18 @@
+$:.unshift File.dirname(__FILE__)
+require 'menu'
+
+$:.unshift File.join(File.dirname(__FILE__), '..', '..', 'lib', 'selenium')
+
+require 'link'
+
+module Selenium
+class HomePage
+  include Menu
+  attr_reader :browser
+
+  def initialize(browser)
+    @browser = browser
+  end
+  
+end
+end

data/test/selenium/menu.rb

@@ -0,0 +1,18 @@
+module Selenium
+module Menu
+  def home_link
+    # todo there should be a way to alter this instance so that the click returns the directory listing page
+    Link.by_id(browser, 'home')
+  end
+  
+#MENU START
+  def download_link
+    Link.by_text(browser, 'Download')
+  end
+  
+  def license_link
+    Link.by_text(browser, 'License')
+  end
+#MENU END
+end
+end

data/test/selenium/tc_basic_operation.rb

@@ -0,0 +1,33 @@
+require 'spec'
+
+$:.unshift File.join(File.dirname(__FILE__), '..', '..')
+
+require 'lib/selenium'
+require 'test/selenium/home_page'
+require 'test/selenium/download_page'
+
+module Selenium
+context 'basic operation with selenium' do
+  context_setup do
+    @browser = Selenium::SeleniumDriver.new("localhost", 4444, "*iexplore", "http://localhost:2000", 10000)
+    @browser.start
+  end
+  
+  setup do
+    @browser.open('http://localhost:2000/index.html')
+  end
+  
+  specify 'click through menus' do
+#TEST START
+    page = HomePage.new(@browser)
+    page.download_link.click_wait
+    page = DownloadPage.new(@browser)
+    page.home_link.click_wait
+    page = DirectoryListingPage.new(@browser)
+    page.link_to_entry('index.txt').click_wait
+    page = HomePage.new(@browser)
+    page.license_link.click_wait
+#TEST END
+  end
+end
+end

data/test/selenium/tc_selenium_server.rb

@@ -0,0 +1,19 @@
+require 'spec'
+require 'buildmaster/cotta'
+require 'buildmaster/project/server_manager'
+
+$:.unshift File.join(File.dirname(__FILE__), '..', '..', 'lib', 'selenium')
+
+require 'selenium_server'
+
+module Selenium
+context 'selenium server' do
+  specify 'start and stop server' do
+    server = BuildMaster::ServerManager.new(SeleniumServer.new(4321))
+    puts 'starting server...'
+    server.start
+    puts 'stopping server...'
+    server.stop
+  end
+end
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: Selenium
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+date: 2007-01-01 00:00:00 -08:00
+summary: A project that wraps selenium API into object-oriented testing style and packages it into a RubyGem.
+require_paths: 
+- lib
+email: selenium@gmail.com
+homepage: http://selenium.rubyforge.org/
+rubyforge_project: selenium
+description: 
+autorequire: selenium
+default_executable: selenium
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Shane Duan
+files: 
+- bin/selenium
+- lib/selenium
+- lib/selenium.rb
+- lib/selenium/button.rb
+- lib/selenium/directory_listing_page.rb
+- lib/selenium/link.rb
+- lib/selenium/locator.rb
+- lib/selenium/openqa
+- lib/selenium/selenium_server.rb
+- lib/selenium/server_manager.rb
+- lib/selenium/text_field.rb
+- lib/selenium/version
+- lib/selenium/openqa/README
+- lib/selenium/openqa/selenium-server.jar.txt
+- lib/selenium/openqa/selenium.rb
+- test/selenium
+- test/selenium/download_page.rb
+- test/selenium/home_page.rb
+- test/selenium/menu.rb
+- test/selenium/tc_basic_operation.rb
+- test/selenium/tc_selenium_server.rb
+- README
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+executables: 
+- selenium
+extensions: []
+
+requirements: []
+
+dependencies: []
+