bdd-helper 0.0.1 → 1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 8e59073ed71889646cb4829a643aab0438ddab30
-  data.tar.gz: 884b1a964d59a4d697d9fec07ae15d67d9645e84
+SHA256:
+  metadata.gz: 7a2f6404fb5d8c81b9e9537f34038036725ee9f8081cc336b6656efb23d14418
+  data.tar.gz: c219637921c7e57893839c417ee330a3dae119bc2363c518ca3cfe9373d842ed
 SHA512:
-  metadata.gz: 67c4c3012d2541f4dc87d51678dd7f2b4c043e3b0c767ae8d874d6e61585a8608b672560d894867adc521ed3da64dc15bec3ed3d8bf783de08d2a9a4e2924cde
-  data.tar.gz: 92ca80b4171db51531b3c3e0c501a8568a3f8b2559b5895223fc9b3baf2804dee29eefb88b4339b2116711d18adbf68685471bc3cb9d64a4f4b9d9b4ad455f93
+  metadata.gz: 1f03a9b36f0e1e47104df4672db7295f24a66832c184478468cf3f15bcc66a9daaf0d44e5f89227e4187df7215f1dbed5f30ca2671bbc1704afbb5a134d44de7
+  data.tar.gz: 9739cee85ca0997bafa0e52ddd0da7c111bbbc7a894e608ba267f80c90448d91a1aa9f2d1ea8b6174752a4be38741a5f17b779656026e5f59f74913d8ac690b3

data/lib/bdd-helper.rb

@@ -1,5 +1,23 @@
-class BddHelper
-  def self.version
-    puts "0.0.1"
-  end
-end
+require 'capybara'
+require 'capybara/rspec'
+require 'rspec'
+require 'rspec/expectations'
+require 'rspec/matchers'
+require 'selenium/webdriver'
+require 'selenium/webdriver/common/wait'
+require 'faker'
+
+
+require 'steps/action/check_steps'
+require 'steps/action/choose_steps'
+require 'steps/action/click_steps'
+require 'steps/action/fill_steps'
+require 'steps/action/key_action_steps'
+require 'steps/action/select_steps'
+require 'steps/assertion/assertion_steps'
+require 'steps/customized/customized_steps'
+require 'steps/util/browser_util_steps'
+require 'steps/util/browser_util_methods'
+require 'steps/config'
+require 'steps/global/global_context'
+require 'steps/config'

data/lib/demo.feature

@@ -0,0 +1,141 @@
+Feature: demo features
+
+
+  Scenario: steps
+    ####################################
+    # BROWSER UTIL
+    When visit base page
+    When visit "http://www.example.com" url
+    When get current url
+    When get window title
+
+    When scroll top of the page
+    When scroll bottom of the page
+    When scroll 250 px up the page
+    When scroll 250 px down the page
+
+    When focus to element by "Agree Button" text
+
+    When go back
+    When go forward
+    When refresh the page
+
+    When accept alert
+    When dismiss alert
+
+    When open a new window
+    When switch to first window
+    When switch to last window
+    When switch to first window
+    When open a new tab
+    When switch to first tab
+    When switch to last tab
+    When switch to window by "Welcome" title
+
+    When close window
+    When maximize window
+    When get window size
+    When resize window to 123 width 123 height
+    # BROWSER UTIL
+    ####################################
+
+    ########################################################################
+
+    ####################################
+    # ASSERTION
+    Then verify below texts are displayed:
+      | Welcome   |
+      | Thank you |
+    Then verify below texts are not displayed:
+      | Welcome   |
+      | Thank you |
+    Then verify "text" text is displayed
+    Then verify "text" text is not displayed
+
+
+    Then verify ".success-message" element has "Welcome" text
+    Then verify ".fail-message" element has not "Welcome" text
+
+    Then verify "Login" button is displayed
+    Then verify "Sign In " button is not displayed
+
+    Then verify "Login" button is enabled
+    Then verify "Logout" button is disabled
+
+    Then verify current url is "http:www.example.com"
+    Then verify current path is "/login"
+
+    Then verify page title is "Welcome"
+    Then verify page title contains "Welcome"
+
+    Then verify "Successful Login" alert message is displayed
+    Then verify "Incorrect login or password." alert message is not displayed
+
+
+    Then verify "Terms & Conditions" checkbox is checked
+    Then verify "Terms & Conditions" checkbox is unchecked
+
+    Then verify "Male" radio button is selected
+    Then verify "Female" radio button is not selected
+    Then verify "cars" dropdown contains "audi" option
+    Then verify "cars" dropdown does not contain "audi" option
+    Then verify "cars" dropdown contains the options below:
+      | au |
+      | bm |
+
+    Then verify "audi" options is selected from "cars" dropdown
+    Then verify "audi" options is not selected from "cars" dropdown
+    # ASSERTION
+    ####################################
+
+    ########################################################################
+
+    ####################################
+    # ACTION
+    When fill "Username" with "value"
+    When fill "First Name" with random first name
+    When fill "Last Name" with random last name
+    When fill "Email" with random email
+    When fill "Phone Number" with random phone number
+    When fill "Address" with random address
+    When fill "Zip Code" with random zip code
+
+    When fill inputs:
+      | username   | test user |
+      | password   | pas123    |
+
+    When click "Contact Us" link
+    When click "Sign In" button
+
+    When check "Terms & Conditions" checkbox
+    When uncheck "Privacy Policy" checkbox
+
+    When choose "Male" radio button
+
+    When clear "First Name" input
+    When select "audi" from "cars" dropdown
+
+    When press "#login" enter
+    When press "#username" delete
+    When press ".list-selector" down
+    When press ".list-selector" up
+    When press ".list-selector" left
+    When press ".list-selector" right
+
+    When click "Logout" under ".account-menu"
+    When click "Logout" item 0 under ".account-menu" menu item 0
+
+    When hover over "Account"
+    # ACTION
+    ####################################
+
+    ########################################################################
+
+    ####################################
+    # CUSTOMIZED
+    When hover to "css" value ".list_item" web element
+    When wait 2 seconds
+    When generate 10 char random string and type into type "css" value ".username"
+    When execute javascript code "window.location.reload()"
+    # CUSTOMIZED
+    ####################################

data/lib/steps/action/check_steps.rb

@@ -0,0 +1,19 @@
+begin
+  When(/^check "([^"]*)" checkbox$/) do |checkbox_name_id_or_label|
+    "
+      Checkbox can be name, id and label text
+    "
+    # E.g : And check "Terms & Conditions" checkbox
+    check(checkbox_name_id_or_label, wait: BddHelper.timeout)
+  end
+
+  When(/^uncheck "([^"]*)" checkbox$/) do |checkbox_name_id_or_label|
+    "
+      Checkbox can be name, id and label text
+    "
+    # E.g : And uncheck "Privacy Policy" checkbox
+    uncheck(checkbox_name_id_or_label, wait: BddHelper.timeout)
+  end
+rescue StandardError => e
+  puts e
+end

data/lib/steps/action/choose_steps.rb

@@ -0,0 +1,11 @@
+begin
+  When(/^choose "([^"]*)" radio button$/) do |radio_button_id_name_or_label|
+    "
+      Radio Button can be name, id and label text
+    "
+    # E.g : And choose "Male" radio button
+    choose(radio_button_id_name_or_label, wait: BddHelper.timeout)
+  end
+rescue StandardError => e
+  puts e
+end

data/lib/steps/action/click_steps.rb

@@ -0,0 +1,37 @@
+begin
+  When(/^click "([^"]*)" button$/) do |button_id_title_or_text|
+    "
+      Button can be name, id, value or title
+    "
+    # E.g : And click "Sign In" button
+    click_button(button_id_title_or_text, wait: BddHelper.timeout)
+  end
+
+  When(/^click "([^"]*)" link$/) do |link_id_title_or_text|
+    "
+      Link can be id, text or title
+    "
+    # E.g : And click "Contact Us" link
+    click_link(link_id_title_or_text, wait: BddHelper.timeout)
+  end
+
+  When(/^click "([^"]*)" under "([^"]*)"$/) do |link, menu|
+    "
+      Finds a element with capybara default_selector, link can be id, text or title
+    "
+    # E.g : And click "Logout" under ".account-menu"
+    find(menu, wait: BddHelper.timeout).hover
+    click_link(link, wait: BddHelper.timeout)
+  end
+
+  When(/^click "([^"]*)" item (\d+) under "([^"]*)" menu item (\d+)$/) do |link, link_item, menu, menu_item|
+    "
+      Link can be id, text or title, menu can be text content
+    "
+    # E.g : And click "Logout" item 2 under "Account" menu item 1
+    (page.all(:xpath, "//*[text()='#{menu}']", wait: BddHelper.timeout)[menu_item]).hover
+    (page.all(:link, link, wait: BddHelper.timeout)[link_item]).click
+  end
+rescue StandardError => e
+  puts e
+end

data/lib/steps/action/fill_steps.rb

@@ -0,0 +1,77 @@
+begin
+  When(/^fill "([^"]*)" with "([^"]*)"$/) do |locator, text|
+    "
+      Fillable field can be name, id, placeholder or label text
+    "
+    # E.g : And fill "Name" with "John"
+    fill_in(locator, with: text, wait: BddHelper.timeout)
+  end
+
+  When(/^fill inputs:$/) do |table|
+    "
+      Fillable field can be name, id, placeholder or label text
+    "
+    # E.g : And fill inputs:
+    #      | username | test user |
+    #      | password | pass123 |
+    table.raw.each { |raw| fill_in(raw[0], with: raw[1], wait: BddHelper.timeout) }
+  end
+
+  When(/^fill "([^"]*)" with random (first name)$/) do |locator, arg|
+    "
+      Fillable field can be name, id, placeholder or label text
+    "
+    # E.g : And fill "First Name" with random first name
+    fill_in(locator, with: Faker::Name.first_name, wait: BddHelper.timeout)
+  end
+
+  When(/^fill "([^"]*)" with random (last name)$/) do |locator, arg|
+    "
+      Fillable field can be name, id, placeholder or label text
+    "
+    # E.g : And fill "Last Name" with random last name
+    fill_in(locator, with: Faker::Name.last_name, wait: BddHelper.timeout)
+  end
+
+  When(/^fill "([^"]*)" with random (email)$/) do |locator, arg|
+    "
+      Fillable field can be name, id, placeholder or label text
+    "
+    # E.g : And fill "Email" with random email
+    fill_in(locator, with: Faker::Internet.safe_email, wait: BddHelper.timeout)
+  end
+
+  When(/^fill "([^"]*)" with random (phone number)$/) do |locator, arg|
+    "
+      Fillable field can be name, id, placeholder or label text
+    "
+    # E.g : And fill "Phone Number" with random phone number
+    fill_in(locator, with: Array.new(7) { Array(0..9).sample }.join, wait: BddHelper.timeout)
+  end
+
+  When(/^fill "([^"]*)" with random (address)$/) do |locator, arg|
+    "
+      Fillable field can be name, id, placeholder or label text
+    "
+    # E.g : And fill "Address" with random address
+    fill_in(locator, with: Faker::Address.full_address, wait: BddHelper.timeout)
+  end
+
+  When(/^fill "([^"]*)" with random (zip code)$/) do |locator, arg|
+    "
+      Fillable field can be name, id, placeholder or label text
+    "
+    # E.g : And fill "Zip Code" with random zip code
+    fill_in(locator, with: Faker::Address.zip_code, wait: BddHelper.timeout)
+  end
+
+  When(/^clear "([^"]*)" input$/) do |locator|
+    "
+      Fillable field can be name, id, placeholder or label text
+    "
+    # E.g : And clear "Name" input
+    fill_in(locator, with: '', fill_options: { clear: :backspace }, wait: BddHelper.timeout)
+  end
+rescue StandardError => e
+  puts e
+end

data/lib/steps/action/key_action_steps.rb

@@ -0,0 +1,59 @@
+begin
+  When(/^press "([^"]*)" (enter)$/) do |locator, arg|
+    "
+       Locator should be capybara default_selector
+    "
+    # E.g : And press "#login" enter
+    find(locator, wait: BddHelper.timeout).native.send_keys(:return)
+  end
+
+  When(/^press "([^"]*)" (down)$/) do |locator, arg|
+    "
+       Locator should be capybara default_selector
+    "
+    # E.g : And press ".list-selector" down
+    find(locator, wait: BddHelper.timeout).native.send_keys(:down)
+  end
+
+  When(/^press "([^"]*)" (up)$/) do |locator, arg|
+    "
+       Locator should be capybara default_selector
+    "
+    # E.g : And press ".list-selector" up
+    find(locator, wait: BddHelper.timeout).native.send_keys(:up)
+  end
+
+  When(/^press "([^"]*)" (delete)$/) do |locator, arg|
+    "
+      Locator should be capybara default_selector
+    "
+    # E.g : And press "#username" delete
+    find(locator, wait: BddHelper.timeout).native.clear
+  end
+
+  When(/^press "([^"]*)" (left)$/) do |locator, arg|
+    "
+      Locator should be capybara default_selector
+    "
+    # E.g : And press ".list-selector" left
+    find(locator, wait: BddHelper.timeout).native.send_keys(:left)
+  end
+
+  When(/^press "([^"]*)" (right)$/) do |locator, arg|
+    "
+      Locator should be capybara default_selector
+    "
+    # E.g : And press ".list-selector" right
+    find(locator, wait: BddHelper.timeout).native.send_keys(:right)
+  end
+
+  When(/^hover over "([^"]*)"$/) do |text|
+    # E.g : And hover over "Account"
+    find(:xpath, "//*[text()='#{text}']", wait: BddHelper.timeout).hover
+  end
+
+rescue StandardError => e
+  puts e
+
+end
+

data/lib/steps/action/select_steps.rb

@@ -0,0 +1,16 @@
+begin
+  When(/^select "([^"]*)" from "([^"]*)" dropdown$/) do |option, dropdown_id_name_or_label_text|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : And select "United States" from "Country" dropdown
+    unless has_select?(dropdown_id_name_or_label_text)
+      raise "#{dropdown_id_name_or_label_text} is not a select box."
+    end
+    select(option, from: dropdown_id_name_or_label_text, wait: BddHelper.timeout)
+    page.should have_select(dropdown_id_name_or_label_text, selected: option)
+  end
+
+rescue StandardError => e
+  puts e
+end

data/lib/steps/assertion/assertion_steps.rb

@@ -0,0 +1,202 @@
+# frozen_string = true
+begin
+  Then(/^verify "([^"]*)" text is displayed$/) do |text|
+    # E.g : Then verify "Thank you for filling in the form" text is displayed
+    page.should have_text(text, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" text is not displayed$/) do |text|
+    # E.g : Then verify "Thank you for filling in the form" text is not displayed
+    page.should_not have_text(text, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" element has "([^"]*)" text$/) do |selector, text|
+    "
+      Selector should be a css selector
+    "
+    # E.g : Then verify ".success-message" element has "Welcome" text
+    page.should have_selector(selector, text: text, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" element has not "([^"]*)" text$/) do |selector, text|
+    "
+      Selector should be a css selector
+    "
+    # E.g : Then verify ".success-message" element has not "Welcome" text
+    page.should_not have_selector(selector, text: text, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" button is displayed$/) do |button|
+    "
+      Button can be id, name, value, or title
+    "
+    # E.g : Then verify "Login" button is displayed
+    page.should have_button(button, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" button is not displayed$/) do |button|
+    "
+      Button can be id, name, value, or title
+    "
+    # E.g : Then verify "Login" button is not displayed
+    page.should_not have_button(button, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" button is enabled$/) do |button|
+    "
+      Button can be id, name, value, or title
+    "
+    # E.g : Then verify "Login" button is enabled
+    page.should have_button(button, disabled: false, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" button is disabled$/) do |button|
+    "
+      Button can be id, name, value, or title
+    "
+    # E.g : Then verify "Login" button is disabled
+    page.should have_button(button, disabled: true, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify current url is "([^"]*)"$/) do |expected_url|
+    "
+      Expected url should be fully URL of the current page
+    "
+    # E.g : Then verify current url is "http:www.example.com"
+    current_url.should == expected_url
+  end
+
+  Then(/^verify current path is "([^"]*)"$/) do |current_path|
+    "
+      Path should be path+query of the current page
+    "
+    # E.g : Then verify current path is "/login"
+    assert_current_path(current_path)
+  end
+
+  Then(/^verify page title is "([^"]*)"$/) do |page_title|
+    "
+      Title should be title of the current page
+    "
+    # E.g : Then verify page title is "Welcome"
+    assert_title(page_title, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify page title contains "([^"]*)"$/) do |text|
+    "
+      Title should be contains of the current page title
+    "
+    # E.g : Then verify page title contains "Welcome"
+    title.should include(text)
+  end
+
+  Then(/^verify below texts are displayed:$/) do |table|
+    # E.g : Then verify below texts are displayed:
+    #       | Welcome   |
+    #       | Thank you |
+    table.raw.each { |raw| page.should have_text(raw[0], wait: BddHelper.timeout) }
+  end
+
+  Then(/^verify below texts are not displayed:$/) do |table|
+    # E.g : Then verify below texts are not displayed:
+    #       | Welcome   |
+    #       | Thank you |
+    table.raw.each { |raw| page.should_not have_text(raw[0], wait: BddHelper.timeout) }
+  end
+
+  Then(/^verify "([^"]*)" alert message is displayed$/) do |text|
+    # E.g : Then verify "Successful" alert message is displayed
+    text.should == page.driver.browser.switch_to.alert.text
+  end
+
+  Then(/^verify "([^"]*)" alert message is not displayed$/) do |text|
+    # E.g : Then verify "Successful" alert message is not displayed
+    text.should_not == page.driver.browser.switch_to.alert.text
+  end
+
+  Then(/^verify "([^"]*)" checkbox is checked$/) do |checkbox|
+    "
+      Checkbox can be name, id and label text
+    "
+    # E.g : Then verify "Terms & Conditions" checkbox is checked
+    expect(page).to have_field(checkbox, checked: true, visible: true, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" checkbox is unchecked/) do |checkbox|
+    "
+      Checkbox can be name, id and label text
+    "
+    # E.g : Then verify "Terms & Conditions" checkbox is unchecked
+    expect(page).to have_field(checkbox, checked: false, visible: true, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" radio button is selected$/) do |radio_button|
+    "
+      Radio Button can be name, id and label text
+    "
+    # E.g : Then verify "Male" radio button is selected
+    expect(page).to have_field(radio_button, checked: true, visible: true, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" radio button is not selected$/) do |radio_button|
+    "
+      Radio Button can be name, id and label text
+    "
+    # E.g : Then verify "Female" radio button is not selected
+    expect(page).to have_field(radio_button, checked: false, visible: true, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" dropdown contains "([^"]*)" option$/) do |dropdown, option_text|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "Country" dropdown contains "United States" option
+    page.should have_select(dropdown, with_options: [option_text], wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" dropdown does not contain "([^"]*)" option$/) do |dropdown, option_text|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "Country" dropdown does not contain "United States" option
+    page.should_not have_select(dropdown, with_options: [option_text], wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" dropdown contains the options below:$/) do |dropdown, table|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "Country" dropdown contains the options below:
+    #       |United States|
+    #       |Turkey       |
+    table.raw.each { |raw| page.should have_select(dropdown, with_options: [raw[0]], wait: BddHelper.timeout) }
+  end
+
+  Then(/^verify "([^"]*)" dropdown does not contain the options below:$/) do |dropdown, table|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "Country" dropdown does not contain the options below:
+    #       |United States|
+    #       |Turkey       |
+    table.raw.each { |raw| page.should_not have_select(dropdown, with_options: [raw[0]], wait: BddHelper.timeout) }
+  end
+
+  Then(/^verify "([^"]*)" options is selected from "([^"]*)" dropdown$/) do |option, dropdown|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "United States" options is selected from "Country" dropdown
+    page.should have_select(dropdown, selected: option, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" options is not selected from "([^"]*)" dropdown$/) do |option, dropdown|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "United States" options is not selected from "Country" dropdown
+    page.should_not have_select(dropdown, selected: option, wait: BddHelper.timeout)
+  end
+rescue StandardError => e
+  puts e
+end

data/lib/steps/config.rb

@@ -0,0 +1,20 @@
+module BddHelper
+  class << self
+    attr_accessor :timeout, :base_url
+
+    def timeout
+      @timeout || 20
+    end
+
+    def base_url
+      unless @base_url.nil? || @base_url.match?(URI::DEFAULT_PARSER.make_regexp)
+        raise ArgumentError, "BddHelper.base_url should be set to a url (http://www.example.com). Attempted to set #{@base_url.inspect}."
+      end
+      @base_url || nil
+    end
+
+    def configure
+      yield self
+    end
+  end
+end

data/lib/steps/customized/customized_steps.rb

@@ -0,0 +1,37 @@
+begin
+  When(/^hover to "([^"]*)" value "([^"]*)" web element$/) do |web_element_type, web_element|
+    "
+      Web element type can be css, xpath, id, field, link, button, link_or_button or label
+    "
+    # E.g: And hover to "css" value ".list_item" web element
+    find(:"#{web_element_type}".to_sym, web_element).hover
+  end
+
+  When(/^wait (\d+) (?:second|seconds)$/) do |sec_value|
+    "
+      Second's value should be integer
+    "
+    # E.g: And wait 2 seconds
+    sleep sec_value.to_i
+  end
+
+  And(/^generate (\d+) char random string and type into type "([^"]*)" value "([^"]*)"$/) do |count, web_element_type, web_element|
+    "
+      Web element type can be css, xpath, id, field, fillable_field or label
+    "
+    # E.g: And generate "10" char random string and type into type "id" value "mobile"
+    charset = (0...count).map { rand(65..90).chr }.join
+    find(:"#{web_element_type}".to_sym, web_element, wait: BddHelper.timeout).set(charset)
+  end
+
+  And(/^execute javascript code "([^"]*)"/) do |code|
+    "
+      Code should be javascript code
+    "
+    # E.g : And execute javascript code "window.location.reload()"
+    page.execute_script(code)
+  end
+
+rescue StandardError => e
+  puts e
+end

data/lib/steps/global/global_context.rb

@@ -0,0 +1,9 @@
+class GlobalContext
+
+  # Resets global variables for each scenario in an execution
+  def initialize
+    $page_title = nil
+    $current_url = nil
+    $window_size =nil
+  end
+end