easy-automation 0.0.1 → 0.0.2

data/README.markdown

@@ -56,6 +56,41 @@ You have a lot of [actions](http://selenium.rubyforge.org/rdoc/classes/Selenium/
 
 More Reference: http://selenium.rubyforge.org/rdoc/classes/Selenium/
 
+Runner - Configuring your tests
+------
+You can change any behaviour using EasyAutomation::Runner.config helper, options:
+    EasyAutomation::Runner.configure do |config|
+      # Selenium Configurations
+      config.url = "http://www.google.com"
+      config.browser = "*safari" # "*firefox", "*chrome"
+      config.selenium_port = 4444
+      config.selenium_timeout = 1000
+      #if specified, it won't start selenium RC and will attempt to connect to remote selenium server
+      config.selenium_host = "localhost"
+
+      # Hooks
+      config.before :all do
+        puts 'Starting Tests'
+      end
+      config.after :all do
+        puts 'Tests finished, halting'
+      end
+
+      config.before :each_test do
+        # Do something
+      end
+      config.after :each_test do
+        # Do something
+      end
+
+      config.before :each_suite do
+        # Do something
+      end
+      config.after :each_suite do
+        # Do something
+      end
+    end
+
 Example
 -------
 Structure:
@@ -129,6 +164,8 @@ Find some working code under examples folder, to see it search exmple on action,
 Roadmap
 -------
 * More hooks [before|after] [:all|:each] [:test|:suite]
+* Update Selenium gem to use latest selenium-RC and fix weird firefox crashes.
+* Multi browser
 * Wait for element to be loaded event
 * Rake integration
 * Retry on failed tests
@@ -140,6 +177,21 @@ Roadmap
 
 Order may matter
 
+
+Version Changes
+--------
+
+From 0.0.1 to 0.0.2
+--------
+* Multiple browsers support
+* [before|after] [:all|:each] [:test|:suite] hooks
+* Remote Selenium RC
+
+From 0.0.2 to 0.1.0
+-------
+* Retry failed tests
+* Selenium Grid integration
+
 Contributing
 ------------
 

data/lib/easy-automation.rb

@@ -5,7 +5,9 @@ require 'easy_automation/data_elements'
 require 'easy_automation/load_data'
 require 'easy_automation/page'
 require 'easy_automation/runner'
+require 'easy_automation/remote_server'
 require 'easy_automation/server'
+require 'easy_automation/selenium'
 require 'easy_automation/suite'
 require 'easy_automation/test'
 require 'easy_automation/version'

data/lib/easy_automation/config.rb

@@ -8,21 +8,40 @@ module EasyAutomation
   class Config
     attr_accessor :selenium_port
     attr_accessor :selenium_timeout
-    attr_accessor :browser
+    attr_accessor :selenium_host
     attr_accessor :url
+    attr_accessor :current_browser
+    attr_accessor :browsers
     attr_reader :hooks
 
+
     #
     # Default settings for selenium RC
     #
     def initialize
+      @browsers = []
       @selenium_port = 4444
-      @selenium_timeout = 1000
-      @browser = "Firefox"
+      @selenium_timeout = 4000
       @url = "http://www.google.com"
       @hooks = {:before => {}, :after =>{}}
     end
 
+    def browser=(browser)
+      @browsers = [browser]
+    end
+
+    def add_browser browser
+      @browsers << browser
+    end
+
+    def browsers
+      @browsers.empty? ? ["* firefox"] : @browsers
+    end
+
+    def current_browser
+      @current_browser || @browsers.first
+    end
+
     def before hook, &block
       @hooks[:before].merge!({hook.to_sym => block}) if block_given?
     end
@@ -35,9 +54,5 @@ module EasyAutomation
       @hooks[type.to_sym][hook_name.to_sym].call if @hooks[type.to_sym][hook_name.to_sym]
     end
 
-    def load_files pattern
-      puts '888888888888 ENTRE!!!'
-      Dir[pattern].each { |f| require f }
-    end
   end
-end
+end

data/lib/easy_automation/data_elements.rb

@@ -6,15 +6,15 @@
 #
 module EasyAutomation
   class DataElements
-    @elements = {}
 
     #
     # Builds magic functions to handle elements
     # @params hash key => value
     #
     def initialize(elements)
-      @elements = elements
-      elements.each do |key, value|
+      @elements = {}
+      @elements.merge!(elements || {})
+      @elements.each do |key, value|
         if (value.class.to_s == "Array" || value.class.to_s == "Hash")
           eval (%{
             def #{key}

data/lib/easy_automation/remote_server.rb

@@ -0,0 +1,26 @@
+module EasyAutomation
+  class RemoteServer
+    def driver(browser_start_command, browser_url, port, timeout)
+      ::Selenium::SeleniumDriver.new('localhost', port, browser_start_command, browser_url, 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),
+                       Runner.configuration.selenium_port,
+                       Runner.configuration.selenium_timeout)
+      browser.start
+      browser.open(url.request_uri)
+      page = ::Selenium::WebPage.new(browser)
+      page.wait_for_load
+      page
+    end
+
+    def start
+    end
+
+    def stop
+    end
+  end
+end

data/lib/easy_automation/runner.rb

@@ -26,10 +26,6 @@ module EasyAutomation
         @configuration
       end
 
-      def server
-        @selenium_server ||= Server.new
-      end
-
       def configure
         yield configuration
       end
@@ -38,7 +34,10 @@ module EasyAutomation
         raise RunnerSuiteException.new('Wrong test suite class') unless test_suite.is_a?(Suite)
         Server.rc.start
         configuration.execute :before, :all
-        ::Test::Unit::UI::Console::TestRunner.run test_suite
+        configuration.browsers.each do |browser|
+          configuration.current_browser = browser
+          ::Test::Unit::UI::Console::TestRunner.run test_suite
+        end
         configuration.execute :after, :all
         Server.rc.stop
       end

data/lib/easy_automation/selenium.rb

@@ -0,0 +1,17 @@
+require 'net/http'
+# Original code is found on Selenium gem, I just have to modify stop command and specify a newer version of selenium-RC
+#   it changed in selenium 1.0.3
+# All credit is thanks to Selenium gem authors
+module Selenium
+  class SeleniumServer
+    # Stops the Selenium server
+    def stop
+      Net::HTTP.get('localhost', '/selenium-server/driver/?cmd=shutDownSeleniumServer', @port_number)
+    end
+
+    private
+    def SeleniumServer::jar_file
+      File.join(File.dirname(__FILE__), '..', 'openqa', 'selenium-server.jar.txt')
+    end
+  end
+end

data/lib/easy_automation/server.rb

@@ -1,8 +1,22 @@
 module EasyAutomation
   class Server
-    def self.rc
-      @selenium ||= Selenium::Server.new(Runner.configuration.selenium_port,
-                                       Runner.configuration.selenium_timeout)
+    class << self
+      def rc force_reload = false
+        if force_reload
+          @selenium = build_server
+        else
+          @selenium ||= build_server
+        end
+      end
+
+      def build_server
+        if Runner.configuration.selenium_host.nil?
+          Selenium::Server.new(Runner.configuration.selenium_port,
+                               Runner.configuration.selenium_timeout)
+        else
+          EasyAutomation::RemoteServer.new
+        end
+      end
     end
   end
 end

data/lib/easy_automation/test.rb

@@ -25,7 +25,8 @@ module EasyAutomation
     #   or use a global one.
     #
     def setup
-      @webpage             = Server.rc.open(Runner.configuration.browser,
+      Runner.configuration.execute :before, :each_test
+      @webpage             = Server.rc.open(Runner.configuration.current_browser,
                                                             Runner.configuration.url)
       @data                = LoadData::load_test_data(self.class.to_s, @method_name, @path)
     end
@@ -35,6 +36,7 @@ module EasyAutomation
     #
     def teardown
       @webpage.close
+      Runner.configuration.execute :after, :each_test
     end
   end
 end

data/lib/easy_automation/version.rb

@@ -1,3 +1,3 @@
 module EasyAutomation
-    VERSION = "0.0.1"
+    VERSION = "0.0.2"
 end

data/lib/openqa/README

@@ -0,0 +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
+will fail on buffer error.

data/spec/lib/easy-automation/config_spec.rb

@@ -4,7 +4,7 @@ require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
 describe EasyAutomation::Config do
   subject {Config}
 
-  context "before hooks" do
+  context "#hooks" do
     context "when specifying any hook" do
       before :each do
         @config = EasyAutomation::Config.new
@@ -21,4 +21,23 @@ describe EasyAutomation::Config do
       end
     end
   end
+
+  context "#browsers" do
+    context "single browser" do
+      it "should allow single browser assignment, backward compatibility" do
+        config = EasyAutomation::Config.new
+        config.browser = "* chrome"
+        config.browsers.size.should == 1
+        config.current_browser.should == config.browsers.first
+      end
+      it "should allow to specify multiples browsers" do
+        config = EasyAutomation::Config.new
+        config.add_browser "* chrome"
+        config.browsers << "* firefox"
+        config.add_browser "* safari"
+        config.browsers.size.should == 3
+        config.current_browser.should == config.browsers.first
+      end
+    end
+  end
 end

data/spec/lib/easy-automation/runner_spec.rb

@@ -9,7 +9,7 @@ describe EasyAutomation::Runner do
       it "should default params" do
         EasyAutomation::Runner.configuration.selenium_port.should be(4444)
         EasyAutomation::Runner.configuration.selenium_timeout.should be(1000)
-        EasyAutomation::Runner.configuration.browser.should == "Firefox"
+        EasyAutomation::Runner.configuration.browsers.should == ["* firefox"]
         EasyAutomation::Runner.configuration.url.should == "http://www.google.com"
       end
 
@@ -22,7 +22,7 @@ describe EasyAutomation::Runner do
         end
         EasyAutomation::Runner.configuration.selenium_port.should be(44444)
         EasyAutomation::Runner.configuration.selenium_timeout.should be(40000)
-        EasyAutomation::Runner.configuration.browser.should == "Chrome"
+        EasyAutomation::Runner.configuration.browsers.should == ["Chrome"]
         EasyAutomation::Runner.configuration.url.should == "http://www.yahoo.com"
       end
     end
@@ -32,33 +32,103 @@ describe EasyAutomation::Runner do
     before :each do
       @rc = mock(EasyAutomation::Server)
       EasyAutomation::Server.stub(:rc).and_return(@rc)
-      Test::Unit::UI::Console::TestRunner.stub(:run).and_return(true)      
-      @rc.should_receive(:start)
-      @rc.should_receive(:stop)
+      Test::Unit::UI::Console::TestRunner.stub(:run).and_return(true)
+      @rc.should_receive(:start).at_least(1).times()
+      @rc.should_receive(:stop).at_least(1).times()
+      EasyAutomation::Runner.configuration.selenium_host = ''
     end
     it "should accept EasyAutomation::Suite classes" do
       suite = EasyAutomation::Suite.new
       lambda { EasyAutomation::Runner.run suite }.should_not raise_error(EasyAutomation::RunnerSuiteException)
     end
-    context "before and after all hooks" do
-      it "should call before all hook when running suites" do
-        TestBlockClass.should_receive(:return_the_true)
-        EasyAutomation::Runner.configure do |config|
-          config.before :all do
-            TestBlockClass.return_the_true
-          end
+    it "should call before all hook when running suites" do
+      TestBlockClass.should_receive(:before_each_suite)
+      EasyAutomation::Runner.configure do |config|
+        config.before :all do
+          TestBlockClass.before_each_suite
+        end
+      end
+      EasyAutomation::Runner.run EasyAutomation::Suite.new('test')
+    end
+    it "should call after all hook when running suites" do
+      TestBlockClass.should_receive(:after_each_suite).at_least(1).times()
+      EasyAutomation::Runner.configure do |config|
+        config.after :all do
+          TestBlockClass.after_each_suite
+        end
+      end
+      EasyAutomation::Runner.run EasyAutomation::Suite.new('test')
+    end
+  end
+
+  context "before and after each test hooks" do
+    before :each do
+      EasyAutomation::Runner.configure do |config|
+        config.before :each_test do
+          TestBlockClass.before_each_test
+        end
+        config.after :each_test do
+          TestBlockClass.after_each_test
         end
-        EasyAutomation::Runner.run EasyAutomation::Suite.new('test')
       end
-      it "should call after all hook when running suites" do
-        TestBlockClass.should_receive(:return_the_true).at_least(2).times()
+      @suite = EasyAutomation::Suite.new('test')
+      @suite.add(HomeTest)
+      rc = mock(EasyAutomation::Server)
+      webpage = mock(Selenium::Server)
+      EasyAutomation::Server.stub(:rc).and_return(rc)
+      rc.should_receive(:start)
+      rc.should_receive(:stop)
+      rc.should_receive(:open).and_return(webpage)
+      webpage.should_receive(:close).any_number_of_times
+    end
+    it "should call :before_each_test before any test" do
+      TestBlockClass.should_receive(:before_each_test)
+      EasyAutomation::Runner.run @suite
+    end
+    it "should call :after_each_test after any test" do
+      TestBlockClass.should_receive(:after_each_test)
+      EasyAutomation::Runner.run @suite
+    end
+  end
+
+  context "Remote Selenium server" do
+    context "when specifying selenium_host" do
+      it "should not start selenium server locally" do
+        rc = mock(EasyAutomation::RemoteServer)
+        rc.should_receive(:start)
+        rc.should_receive(:stop)
         EasyAutomation::Runner.configure do |config|
-          config.after :all do
-            TestBlockClass.return_the_true
-          end
+          config.selenium_host = "remote_host"
         end
+        EasyAutomation::RemoteServer.should_receive(:new).and_return(rc)
+        EasyAutomation::Server.rc true
+        Selenium::Server.should_not_receive(:new)
         EasyAutomation::Runner.run EasyAutomation::Suite.new('test')
       end
     end
   end
+
+  context "multiple browsers" do
+    before :each do
+      rc = mock(EasyAutomation::RemoteServer)
+      webpage = mock(Selenium::Server)
+      rc.should_receive(:start)
+      rc.should_receive(:stop)
+      rc.should_receive(:open).any_number_of_times().and_return(webpage)
+      webpage.should_receive(:close).any_number_of_times()
+      EasyAutomation::RemoteServer.should_receive(:new).and_return(rc)
+    end
+    it "should run all tests against every single browser specified on config" do
+      EasyAutomation::Runner.configure do |config|
+        config.selenium_host = "localhost"
+        config.add_browser "*firefox"
+        config.add_browser "*safari"
+      end
+      EasyAutomation::Server.rc true
+      test_suite = EasyAutomation::Suite.new('test')
+      Test::Unit::UI::Console::TestRunner.should_receive(:run).at_least(2).times()
+      test_suite.add(HomeTest)
+      EasyAutomation::Runner.run test_suite
+    end
+  end
 end

data/spec/lib/easy-automation/suite_spec.rb

@@ -16,14 +16,6 @@ describe EasyAutomation::Suite do
       lambda{my_suite.add(WrongTest)}.should raise_error(EasyAutomation::SuiteException)
     end
     it "should accept suites if they extend from EasyAutomation::Test" do
-      class TestClass < EasyAutomation::Test
-        def suite
-          true
-        end
-        def method_name
-          true
-        end
-      end
       my_suite = EasyAutomation::Suite.new
       my_suite.add(TestClass)
       my_suite.suite.size.should be(1)

data/spec/spec_helper.rb

@@ -1,6 +1,7 @@
 require 'rubygems'
 require 'bundler'
 
+puts File.dirname(__FILE__)
 require File.join(File.dirname(__FILE__), '..', 'lib/easy-automation')
 
 Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
@@ -17,4 +18,16 @@ class TestBlockClass
   def self.return_the_true
     true
   end
+  def self.before_each_suite
+    true
+  end
+  def self.before_each_test
+    true
+  end
+  def self.after_each_suite
+    true
+  end
+  def self.after_each_test
+    true
+  end
 end

data/spec/support/home_test.rb

@@ -9,4 +9,8 @@ class HomeTest < EasyAutomation::Test
 
   def two
   end
+
+  def test_hooks
+    true
+  end
 end

data/spec/support/test_class.rb

@@ -0,0 +1,9 @@
+class TestClass < EasyAutomation::Test
+  def suite
+    true
+  end
+
+  def method_name
+    true
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: easy-automation
 version: !ruby/object:Gem::Version 
-  hash: 29
+  hash: 27
   prerelease: 
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - Edwin Cruz
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-14 00:00:00 -07:00
+date: 2011-03-24 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -69,11 +69,16 @@ files:
 - lib/easy_automation/data_elements.rb
 - lib/easy_automation/load_data.rb
 - lib/easy_automation/page.rb
+- lib/easy_automation/remote_server.rb
 - lib/easy_automation/runner.rb
+- lib/easy_automation/selenium.rb
 - lib/easy_automation/server.rb
 - lib/easy_automation/suite.rb
 - lib/easy_automation/test.rb
 - lib/easy_automation/version.rb
+- lib/openqa/README
+- lib/openqa/selenium-server.jar.txt
+- lib/openqa/sslSupport/cybervillainsCA.cer
 - spec/lib/easy-automation/config_spec.rb
 - spec/lib/easy-automation/page_spec.rb
 - spec/lib/easy-automation/runner_spec.rb
@@ -85,6 +90,7 @@ files:
 - spec/support/elements/homepage.yml
 - spec/support/home_page.rb
 - spec/support/home_test.rb
+- spec/support/test_class.rb
 has_rdoc: true
 homepage: http://rubygems.org/gems/easy-automation
 licenses: []
@@ -131,3 +137,4 @@ test_files:
 - spec/support/elements/homepage.yml
 - spec/support/home_page.rb
 - spec/support/home_test.rb
+- spec/support/test_class.rb