whirlwind 0.1.0

data/lib/whirlwind.rb

@@ -0,0 +1,39 @@
+base = File.expand_path(File.dirname(__FILE__) + '/..')
+
+require 'RMagick'
+require 'platform_helpers'
+require base + '/lib/cucumber'
+require 'watir-webdriver'
+require base + '/lib/watir'
+require base + '/lib/rspec'
+require 'wait_for'
+require base + '/lib/cucumber/formatter/html_image'
+require 'rspec'
+require 'find'
+require 'win32screenshot' if RUBY_PLATFORM =~ /win/i
+
+Before do |i|
+  load_fixtures
+
+  if $browser_type
+    @browser = Watir::Browser.new $browser_type
+  else 
+    if @test_data[$site_name].has_key?(:browser)
+      @browser = Watir::Browser.new @test_data[$site_name][:browser][:browser]
+    else
+      raise ArgumentError
+    end 
+  end
+  site_requires
+  site_objects
+end
+
+After do
+  @browser.close if @browser.kind_of?(Watir::Browser)
+end
+
+
+class Whirlwind
+  include RSpec::Core::DSL
+  VERSION = '0.1.0'
+end

data/sites/demo/conf/base_urls.yml

@@ -0,0 +1,6 @@
+:test:
+  :demo_home: http://127.0.0.1:9090
+:development:
+  :demo_home: http://127.0.0.1:9090
+:production:
+  :demo_home: http://127.0.0.1:9090

data/sites/demo/conf/browser.yaml

@@ -0,0 +1 @@
+:browser: chrome

data/sites/demo/conf/html_elements.yaml

@@ -0,0 +1,22 @@
+--- 
+:some_page:
+  :page_element1:
+    :type: text_field
+    :what: "watir's what parameter"
+    :what: "watir's how parameter"
+  :page_element2:
+    :type: text_field
+    :what: "watir's what parameter"
+    :what: "watir's how parameter"
+:another_page:
+  :page_element1:
+    :type: text_field
+    :what: "watir's what parameter"
+    :what: "watir's how parameter"
+  :page_element2:
+    :type: text_field
+    :what: "watir's what parameter"
+    :what: "watir's how parameter"
+
+
+

data/sites/demo/conf/remote_machine.yaml

@@ -0,0 +1,12 @@
+:test:
+  :ssh_ip: 127.0.0.1
+  :ssh_user: cliff
+  :ssh_password:
+:development:
+  :ssh_ip: 127.0.0.1
+  :ssh_user: cliff
+  :ssh_password: 
+:production:
+  :ssh_ip: 127.0.0.1
+  :ssh_user: cliff
+  :ssh_password: 

data/sites/demo/conf/users.yaml

@@ -0,0 +1,21 @@
+:development:
+  :manager: 
+    :user: 'user1'
+    :password: 'user1_password'
+  :employee: 
+    :user: 'user2'
+    :password: 'user2_password'
+:test:
+  :manager: 
+    :user: 'user1'
+    :password: 'user1_password'
+  :employee: 
+    :user: 'user2'
+    :password: 'user2_password'
+:production:
+  :manager: 
+    :user: 'user1'
+    :password: 'user1_password'
+  :employee: 
+    :user: 'user2'
+    :password: 'user2_password'

data/sites/demo/elements/demo_common_elements.rb

@@ -0,0 +1,42 @@
+module Demo
+  module Elements
+    class Tabs
+      include RSpec::Core::DSL
+      def initialize
+        define_me(:base) {@browser.link(:href, '#tab_base')}
+        define_me(:registration) {@browser.link(:href, '#tab_user_reg')}
+      end
+    end
+
+    class Dialogs
+      include RSpec::Core::DSL
+      def initialize
+        define_me(:modal_dialog) { @browser.div(:id => 'test_modal_dialog') }
+        define_me(:dialog) { @browser.div(:id => 'test_dialog') }
+        define_me(:close_modal_dialog) { @browser.link(:class => /ui-dialog-titlebar-close/) }
+        define_me(:close_dialog) { @browser.links(:class => /ui-dialog-titlebar-close/).last }
+        define_me(:close_modal_dialog) { @browser.links(:class => /ui-dialog-titlebar-close/).first }
+      end
+    end
+
+    class Menu
+      include RSpec::Core::DSL
+      def initialize
+        define_me(:full_menu_div) {@browser.div(:id, 'main_menu')}
+        define_me(:actions) { full_menu_div.link(:text, 'Actions') }
+        define_me(:test_alert) {
+          actions.mouseover
+          full_menu_div.link(:text, 'Test Alert')
+        }
+        define_me(:test_dialog) {
+          actions.mouseover
+          full_menu_div.link(:text, 'Test Dialog')
+        }
+        define_me(:test_modal_dialog) {
+          actions.mouseover
+          full_menu_div.link(:text, 'Test Modal Dialog')
+        }
+      end
+    end
+  end
+end

data/sites/demo/elements/demo_elements.rb

@@ -0,0 +1,18 @@
+module Demo
+  module Elements
+    class HomePage
+      include RSpec::Core::DSL
+      attr_accessor :tabs, :menu, :dialogs
+      def initialize
+        @tabs = Demo::Elements::Tabs.new
+        @menu = Demo::Elements::Menu.new
+        @dialogs = Demo::Elements::Dialogs.new
+        define_me(:file_status) {@browser.div(:id, 'create_file_status')}
+        define_me(:create_file_text_field) {@browser.text_field(:id, 'create_file_name')}
+        define_me(:submit_create_file) {@browser.button(:id, 'create_file')}
+        define_me(:link_with_id) {@browser.link(:id, 'link_with_id_and_no_name')}
+        define_me(:link_with_name) {@browser.link(:name, 'link_with_no_id_but_has_name')}
+      end
+    end
+  end
+end

data/sites/demo/elements/demo_registration_elements.rb

@@ -0,0 +1,27 @@
+module Demo
+  module Elements
+    class RegistrationPage
+      include RSpec::Core::DSL
+      attr_accessor :tabs, :menu, :dialogs
+      def initialize
+        @tabs = Demo::Elements::Tabs.new
+        @menu = Demo::Elements::Menu.new
+        @dialogs = Demo::Elements::Dialogs.new
+        define_me(:email) { @browser.text_field(:id, 'email') }
+        define_me(:email_error) { @browser.div(:id, 'email_error') }
+        define_me(:password) { @browser.text_field(:id, 'password') }
+        define_me(:password_error) { @browser.div(:id, 'password_error') }
+        define_me(:password) { @browser.text_field(:id, 'password') }
+        define_me(:step_1_div) { @browser.div(:id => 'step_1') }
+        define_me(:step_2_div) { @browser.div(:id => 'step_2') }
+        define_me(:step_1_displayed?) { step_1_div.html.grep(/ui-accordion-content-active/).length > 0 }
+        define_me(:step_2_displayed?) { step_2_div.html.grep(/ui-accordion-content-active/).length > 0 }
+        define_me(:step_navigation_div) { @browser.div(:id, 'step_navigation_left') }
+        define_me(:step_1_next) { step_1_div.link(:title => 'Move on to Step 2') }
+        define_me(:step_2_next) { step_2_div.link(:title => 'Move on to Step 3') }
+        define_me(:step_2_prev) { step_2_div.link(:title => 'Go back to Step 1') }
+      end
+    end 
+  end 
+end 
+

data/sites/demo/features/click_links.feature

@@ -0,0 +1,21 @@
+Feature: Menu links should take an appropriate action
+  from all pages requiring the main menu
+
+  Scenario: Click Home Page Menu Links
+    Given a user navigates to the home page
+    Then the user clicks on the Test Alert link
+    Then the user closes the Test Alert box
+    Then the user clicks on the Test Modal Dialog link
+    Then the user closes the Test Modal Dialog
+    Then the user clicks on the Test Dialog link
+    Then the user closes the Test Dialog
+
+  Scenario: Click Registration Page Menu Links
+    Given a user navigates to the registration page
+    Then the user clicks on the Test Alert link
+    Then the user closes the Test Alert box
+    Then the user clicks on the Test Modal Dialog link
+    Then the user closes the Test Modal Dialog
+    Then the user clicks on the Test Dialog link
+    Then the user closes the Test Dialog
+

data/sites/demo/features/register_user.feature

@@ -0,0 +1,27 @@
+Feature: In order to charge a customer for services
+  the user must be able
+  to complete registration
+
+  Scenario: Invalid Email
+    Given a user navigates to the registration page
+    Then the user enters an invalid entry in the email field
+    Then the user enters blah into the password field
+    And tries to move to step 2
+    # using a instead of an for a common step definition
+    Then a email error is displayed
+
+  Scenario: Invalid Password
+    Given a user navigates to the registration page
+    Then the user enters blah into the email field
+    Then the user enters an invalid entry in the password field
+    And tries to move to step 2
+    Then a password error is displayed
+
+  Scenario: Invalid Email and Password
+    Given a user navigates to the registration page
+    Then the user enters an invalid entry in the email field
+    Then the user enters an invalid entry in the password field
+    And tries to move to step 2
+    Then a email error is displayed
+    Then a password error is displayed
+

data/sites/demo/features/step_defn/demo.rb

@@ -0,0 +1,62 @@
+base = File.expand_path(File.dirname(__FILE__) + '/../../../..')
+require base + '/lib/whirlwind'
+
+Given /a user navigates to the (.+) page/ do |page|
+  @demo_homepage.send(page)
+end
+
+Then /menu items should exists/ do
+  @demo_homepage.elements.menu.actions.exists?.should == true
+  @demo_homepage.elements.menu.test_alert.exists?.should == true
+  @demo_homepage.elements.menu.test_modal_dialog.exists?.should == true
+  @demo_homepage.elements.menu.test_dialog.exists?.should == true
+end
+
+Then /the user clicks on the Test Alert link/ do
+  @demo_homepage.elements.menu.test_alert.click
+  wait_for(2) { @browser.alert_box.text == 'QA Robusta Test Alert' }
+  screen_shot('Test Alert menu item clicked')
+  @browser.alert_box.text.should == 'QA Robusta Test Alert'
+end
+
+Then /the user closes the Test Alert box/ do
+  @browser.alert_box.dismiss
+end
+
+Then /the user clicks on the Test Modal Dialog link/ do
+  @demo_homepage.elements.menu.test_modal_dialog.click
+  wait_for(2) { @demo_homepage.elements.dialogs.modal_dialog.text == 'Test some modal dialog actions' }
+  screen_shot('Test Modal Dialog menu item clicked')
+  @demo_homepage.elements.dialogs.modal_dialog.text.should == 'Test some modal dialog actions'
+end
+
+Then /the user clicks on the Test Dialog link/ do
+  @demo_homepage.elements.menu.test_dialog.click
+  wait_for(2) { @demo_homepage.elements.dialogs.dialog.text == 'Test some dialog actions' }
+  screen_shot('Test Dialog menu item clicked')
+  @demo_homepage.elements.dialogs.dialog.text.should == 'Test some dialog actions'
+end
+
+Then /the user closes the Test Dialog/ do
+  @demo_homepage.elements.dialogs.close_dialog.click
+end
+
+Then /the user closes the Test Modal Dialog/ do
+  @demo_homepage.elements.dialogs.close_modal_dialog.click
+end
+
+Then /the user enters (.+) into the (.+) field/ do |val, field|
+  @demo_registrationpage.elements.send(field).set(val)
+end
+
+Then /the user enters an invalid entry in the (.+) field/ do |field|
+end
+
+Then /tries to move to step (\d+)/ do |step_n|
+  @demo_registrationpage.elements.send("step_#{step_n.to_i-1}_next").click
+end
+
+Then /a (.+) error is displayed/ do |field|
+  @demo_registrationpage.elements.send("#{field}_error").text.should == 'Enter a value'
+  screen_shot("#{field} error")
+end

data/sites/demo/flows/home_flows.rb

@@ -0,0 +1,25 @@
+module Demo
+  class HomePage
+    include RSpec::Core::DSL
+    attr_reader :elements
+    def initialize
+      @elements = Demo::Elements::HomePage.new
+    end
+
+    def home
+      @browser.goto(@test_data['demo'][:base_urls][$environment][:demo_home])
+      @elements.tabs.registration.wait_until_present
+      screen_shot('Landed on Home Page')
+    end
+
+    def registration
+      home
+      @elements.tabs.registration.wait_until_present
+      @elements.tabs.registration.click
+      @demo_registrationpage.elements.step_1_next.wait_until_present
+      screen_shot('Landed on Registration Page')
+    end
+
+  end
+end
+

data/sites/demo/flows/registration_flows.rb

@@ -0,0 +1,21 @@
+module Demo
+  class RegistrationPage
+    include RSpec::Core::DSL
+    attr_reader :elements
+    def initialize
+      @elements = Demo::Elements::RegistrationPage.new
+    end
+
+    def step_1(params={})
+      params[:submit] ||= 'true'
+      params[:submit] = params[:submit].to_bool
+      params[:email] ||= ''
+      params[:password] ||= ''
+      @elements.email.set(params[:email]) if params[:email] != ''
+      @elements.password.set(params[:password]) if params[:password] != ''
+      @elements.step_1_next.click if params[:submit]
+    end
+
+  end
+end
+

data/test/features/browser_types.feature

@@ -0,0 +1,22 @@
+Feature: Supported Browsers
+  In order to release supported browsers are allowed
+  @skip
+  Scenario Outline: Is Supported
+    Given a supported browser <supported_browsers>
+    Then the browser is allowed
+
+    Examples:
+      | supported_browsers |
+      | firefox            |
+      | ff                 |
+      | chrome             |
+      | ie                 |
+
+  @run
+  Scenario Outline: Is Not Supported
+    Given an unsupported browser <unsupported_browsers>
+    Then the browser is not allowed
+
+    Examples:
+      | unsupported_browsers |
+      | opera                |

data/test/features/open_browser.feature

@@ -0,0 +1,20 @@
+Feature: Open Browser
+  In order to test a web application one needs to open a browser
+  #  Scenario: No block provided
+  #  Given I have not provided a block to the browser
+  #  Then the result should be a browser is not opened
+
+  Scenario Outline: Block provided
+    Given I have provided a block to the site with <browser_type>
+    Then the result should be the browser instances it returned and available inside of the block
+  Scenario Outline: No Block provided
+    Given I have not provided a block to the site with <browser_type>
+    Then the result should be the browser instances it returned as a variable
+
+
+    Examples:
+      |browser_type|
+      |chrome|
+      |ff|
+      |firefox|
+

data/test/features/resource_size.feature

@@ -0,0 +1,13 @@
+Feature: Download elements from source html
+  In order to release all images, external javascript and 
+  css files must download and be the correct size
+
+  Scenario Outline: Download
+    Given a user has landed on a <page>
+    Then all resource elements should download with the correct size
+
+    Examples:
+      |page                  |
+      |http://slashdot.org   |
+      |http://yahoo.com      |
+      |http://github.com     |

data/test/features/step_defn/browser.rb

@@ -0,0 +1,61 @@
+base = File.expand_path(File.dirname(__FILE__) + '/../../..')
+require base + '/lib/whirlwind'
+require base + '/elements/demo_elements'
+
+
+Before do
+  @__cucumber_step_mother.delete_images
+  @b = nil
+end
+
+After do
+  puts "BLAH: #{@blah}"
+  @b.close if @b.kind_of?(Watir::Browser)
+end
+
+
+Given /a supported browser (.+)/ do |browser|
+  @b = browser
+end
+Then /the browser is allowed/ do
+  screen_shot
+  Constants::ALLOWED_BROWSERS.should include(@b.to_sym)
+end
+
+Given /an unsupported browser (.+)/ do |browser|
+  screen_shot
+  screen_shot
+  #require 'ruby-debug';debugger
+  @b = browser
+end
+Then /the browser is not allowed/ do
+  Constants::ALLOWED_BROWSERS.should_not include(@b)
+end
+
+
+Given /a user has landed on a (.+)/ do |url|
+  @element_info = HTTP::Validator.run(url)
+end
+
+Then /all resource elements should download with the correct size/ do
+  @element_info.each_pair { |resource, values|
+    values.each { |item| 
+      puts "Verifying #{resource} downloaded size #{item[:actual_size]} matches Content-Length #{item[:expected_size]}\n"
+      item[:actual_size].should equal item[:expected_size] 
+    }
+  }
+end
+
+Given /I have provided a block to the site with (.+)/ do |browser|
+ Site.browser(:browser => browser) { |b| @b = b } 
+end
+Then /the result should be the browser instances it returned and available inside of the block/ do
+  @b.should be_a_kind_of(Watir::Browser)
+end
+
+Given /I have not provided a block to the site with (.+)/ do |browser|
+ @b = Site.browser(:browser => browser)
+end
+Then /the result should be the browser instances it returned as a variable/ do
+  @b.should be_a_kind_of(Watir::Browser)
+end

data/test/test_whirlwind.rb

@@ -0,0 +1,8 @@
+require "test/unit"
+require "whirlwind"
+
+class TestWhirlwind < Test::Unit::TestCase
+  def test_sanity
+    flunk "write tests or I will kneecap you"
+  end
+end