bdd-helper 0.0.4 → 1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 6a9e8061724a7fb3583ee4a68f1ce2091760e3e7
-  data.tar.gz: 146ed89fce2589ef73b93950869a76f1ad21233e
+SHA256:
+  metadata.gz: 7a2f6404fb5d8c81b9e9537f34038036725ee9f8081cc336b6656efb23d14418
+  data.tar.gz: c219637921c7e57893839c417ee330a3dae119bc2363c518ca3cfe9373d842ed
 SHA512:
-  metadata.gz: 40719aaef3cd0d06e955c4b5af1939bb7426ed425fc320b6164374b945708f0dbdab9770d8d999a2f35457798d01e4db94ddcf7e0007c39cb22faa2196debec3
-  data.tar.gz: 1065251038130380666ef0a5a24d5b6e2a84a2ccecc87cb331a6bef9a4310b4bae48be01ef1f3b9dc8000aea387613d38fc1b8ede5871778fb62a3f04906db4c
+  metadata.gz: 1f03a9b36f0e1e47104df4672db7295f24a66832c184478468cf3f15bcc66a9daaf0d44e5f89227e4187df7215f1dbed5f30ca2671bbc1704afbb5a134d44de7
+  data.tar.gz: 9739cee85ca0997bafa0e52ddd0da7c111bbbc7a894e608ba267f80c90448d91a1aa9f2d1ea8b6174752a4be38741a5f17b779656026e5f59f74913d8ac690b3

data/lib/bdd-helper.rb

@@ -1,17 +1,23 @@
 require 'capybara'
-require 'capybara/cucumber'
-require 'capybara/dsl'
 require 'capybara/rspec'
 require 'rspec'
 require 'rspec/expectations'
 require 'rspec/matchers'
 require 'selenium/webdriver'
 require 'selenium/webdriver/common/wait'
+require 'faker'
 
-require 'steps/assertion'
-require 'steps/browser'
-require 'steps/check'
-require 'steps/click'
-require 'steps/fill'
-require 'steps/select'
-require 'steps/unclassified'
+
+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

@@ -1,5 +1,20 @@
-module BaseConstants
+module BddHelper
+  class << self
+    attr_accessor :timeout, :base_url
 
-  $timeout = 20
+    def timeout
+      @timeout || 20
+    end
 
-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

data/lib/steps/util/browser_util_methods.rb

@@ -0,0 +1,12 @@
+ class BrowserUtilMethods
+
+   def scroll_to(element)
+     script = <<-JS
+      arguments[0].scrollIntoView(true);
+     JS
+     page.execute_script(script, element.native)
+   end
+
+ rescue StandardError => e
+   puts e
+  end

data/lib/steps/util/browser_util_steps.rb

@@ -0,0 +1,178 @@
+begin
+  When(/^scroll (\d+) px (down) the page$/) do |pixel, arg|
+    "
+      This scrolls down the page by the given amount of pixel.
+    "
+    # E.g : And scroll 500 px down the page
+    page.execute_script("window.scrollBy(0,#{pixel})")
+  end
+
+  When(/^scroll (\d+) px (up) the page$/) do |pixel, arg|
+    "
+      This scrolls up the page by the given amount of pixel.
+    "
+    # E.g : And scroll 500 px up the page
+    page.execute_script("window.scrollBy(0,#{-pixel})")
+  end
+
+  When(/^scroll (bottom) of the page$/) do |arg|
+    "
+      This scrolls the page to the bottom
+    "
+    # E.g : And scroll bottom of the page
+    page.execute_script('window.scrollTo(0, document.body.scrollHeight)')
+  end
+
+  When(/^scroll (top) of the page$/) do |arg|
+    "
+      This scrolls the page to the top
+    "
+    # E.g : And scroll top of the page
+    page.execute_script('window.scrollTo(document.body.scrollHeight,0)')
+  end
+
+  When(/^focus to element by "([^"]*)" text$/) do |text|
+    # E.g : And focus to element by "Agree Button" text
+    scroll_to(find(xpath: "//*[contains(text(), '#{text}')]"))
+  end
+
+  When(/^refresh the page$/) do
+    "
+      This refreshes the current page
+    "
+    # E.g : And refresh the page
+    page.evaluate_script('window.location.reload()')
+  end
+
+  When(/^open a (new window)$/) do |args|
+    # E.g : And open a new window
+    open_new_window(:window)
+  end
+
+  When(/^open a (new tab)$/) do |args|
+    # E.g : And open a new tab
+    open_new_window
+  end
+
+  When(/^switch to (last window|last tab)$/) do |arg|
+    # E.g : And switch to last window
+    # E.g : And switch to last tab
+    page.driver.browser.switch_to.window(page.driver.browser.window_handles.last)
+  end
+
+  When(/^switch to (first window|first tab)$/) do |arg|
+    # E.g : And switch to first window
+    # E.g : And switch to first tab
+    page.driver.browser.switch_to.window(page.driver.browser.window_handles.first)
+  end
+
+  When(/^switch to window by "([^"]*)" title$/) do |window_title|
+    "
+      Window title should be title of the target window
+    "
+    # E.g : And switch to window by "Welcome" title
+    switch_to_window { title == window_title }
+  end
+
+  When(/^resize window to (\d+) width (\d+) height$/) do |width, height|
+    "
+      This resize to the current window by the given width and height
+    "
+    # E.g : And resize window to 1280 width 720 height
+    page.driver.browser.manage.window.resize_to(width, height)
+  end
+
+  When(/^get window size$/) do
+    "
+       This gets the current window's size then defines it to the global variable
+    "
+    # E.g : And get window size
+    $window_size = page.driver.browser.manage.window.size
+  end
+
+  When(/^close window$/) do
+    "
+      This closes the current window
+    "
+    # E.g : And close window
+    page.driver.browser.close
+  end
+
+  When(/^get current url$/) do
+    "
+      This get full URL of the current page then defines it to the global variable
+    "
+    # E.g : And get current url
+    $current_url = current_url
+  end
+
+  When(/^go back$/) do
+    "
+      This move back a single entry in the browser's history
+    "
+    # E.g : And go back
+    go_back
+  end
+
+  When(/^go forward$/) do
+    "
+      This move forward a single entry in the browser's history
+    "
+    # E.g : And go forward
+    go_forward
+  end
+
+  When(/^visit base page$/) do
+    "
+      Should configure base_url from bdd-helper config
+    "
+    # E.g : And visit base page
+    visit BddHelper.base_url
+  end
+
+  When(/^visit "([^"]*)" url$/) do |url|
+    "
+      The URL can either be a relative URL or an absolute URL
+    "
+    # E.g : And visit "http://www.example.com" url
+    visit url
+  end
+
+  When(/^visit relative url "([^"]*)"$/) do |url|
+    "
+      The URL can be a relative URL
+    "
+    # E.g : And visit relative url '/login'
+    visit BddHelper.base_url + url
+  end
+
+  When(/^maximize window$/) do
+    "
+      This maximizes the current window
+    "
+    # E.g : And maximize window
+    page.driver.browser.manage.window.maximize
+  end
+
+  When(/^accept alert$/) do
+    # E.g : And accept alert
+    page.driver.browser.switch_to.alert.accept
+  end
+
+  When(/^dismiss alert$/) do
+    # E.g : And dismiss alert
+    page.driver.browser.switch_to.alert.dismiss
+  end
+
+  When(/^get window title$/) do
+    "
+       This gets title of the current page then defines it to the global variable
+    "
+    # E.g : And get window title
+    $page_title = title
+  end
+
+rescue StandardError => e
+  puts e
+end
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bdd-helper
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: '1.0'
 platform: ruby
 authors:
 - kloia
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-04-02 00:00:00.000000000 Z
+date: 2022-02-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -16,94 +16,101 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.11'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.11.0
+        version: '3.36'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.11'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.11.0
+        version: '3.36'
 - !ruby/object:Gem::Dependency
   name: cucumber
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: '7.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: '7.1'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.5'
+        version: '3.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+- !ruby/object:Gem::Dependency
+  name: selenium-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.5.0
+        version: 4.0.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.5'
+        version: '4.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.5.0
+        version: 4.0.3
 - !ruby/object:Gem::Dependency
-  name: selenium-webdriver
+  name: faker
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.4.0
+        version: '2.19'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.4.0
-description: Package of helper step definitions for BDD testing with Gherkin and Cucumber
-email: ping@kloia.co.uk
+        version: '2.19'
+description: Package of helper steps for BDD testing with Cucumber
+email: burak@kloia.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - lib/bdd-helper.rb
-- lib/steps/assertion.rb
-- lib/steps/browser.rb
-- lib/steps/check.rb
-- lib/steps/click.rb
+- lib/demo.feature
+- lib/steps/action/check_steps.rb
+- lib/steps/action/choose_steps.rb
+- lib/steps/action/click_steps.rb
+- lib/steps/action/fill_steps.rb
+- lib/steps/action/key_action_steps.rb
+- lib/steps/action/select_steps.rb
+- lib/steps/assertion/assertion_steps.rb
 - lib/steps/config.rb
-- lib/steps/fill.rb
-- lib/steps/select.rb
-- lib/steps/unclassified.rb
+- lib/steps/customized/customized_steps.rb
+- lib/steps/global/global_context.rb
+- lib/steps/util/browser_util_methods.rb
+- lib/steps/util/browser_util_steps.rb
 homepage: http://rubygems.org/gems/bdd-helper
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -118,9 +125,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.12
-signing_key: 
+rubygems_version: 3.2.22
+signing_key:
 specification_version: 4
-summary: Helper step definitions for Gherkin
+summary: Helper steps for client-based automation testing
 test_files: []

data/lib/steps/assertion.rb

@@ -1,92 +0,0 @@
-require_relative 'config'
-
-include BaseConstants
-
-Then(/^page (should|should_not) contain "([^"]*)" content$/) do |condition, content|
-  # E.g. : page should contain "Test" content
-  # E.g. : page should_not contain "Test" content
-  # page.should have_content(content, count: count, wait: $timeout)
-  sleep 1
-  if condition == 'should'
-    page.should have_content(content, wait: $timeout)
-
-  elsif condition == 'should_not'
-    page.should_not have_content(content, wait: $timeout)
-  end
-end
-
-Then(/^page (should|should_not) contain the following contents:$/) do |condition, table|
-  sleep 1
-  values = table.raw
-  values.each {|raw|
-    if condition == 'should'
-      page.should have_content(raw[0], wait: $timeout)
-    elsif condition == 'should_not'
-      page.should_not have_content(raw[0], wait: $timeout)
-    end
-  }
-end
-
-Then(/^page (should|should_not) contain "([^"]*)" "([^"]*)" web element/) do |condition, web_element_type, web_element|
-  # E.g. : page should contain "css" "#test .form" web element
-  sleep 1
-  if condition == 'should'
-    page.should have_selector(:"#{web_element_type}", web_element, wait: $timeout)
-
-  elsif condition == 'should_not'
-    page.should_not have_selector(:"#{web_element_type}", web_element, wait: $timeout)
-  end
-end
-
-Then(/^page (should|should_not) contain "([^"]*)" button$/) do |condition, button|
-  # E.g. : page should contain "Save" button
-  # E.g. : page should_not contain "Save" button
-  # page.should have_content(content, count: count, wait: $timeout)
-  sleep 1
-  if condition == 'should'
-    page.should have_button(button, wait: $timeout)
-
-  elsif condition == 'should_not'
-    page.should_not have_button(button, wait: $timeout)
-  end
-end
-
-Then(/^"([^"]*)" button (should|should_not) be disabled$/) do |button, condition|
-  sleep 1
-  if condition == 'should'
-    find_button button, disabled: true
-
-  elsif condition == 'should_not'
-    find_button button, disabled: false
-  end
-end
-
-When(/^"([^"]*)" checkbox should be (checked|unchecked)$/) do |checkbox, condition|
-  # E.g. : "Agree" checkbox should be checked
-  # checkbox can be label, value or id
-  if condition == 'checked'
-    expect(page).to have_field(checkbox, checked: true, visible: true)
-  elsif condition == 'unchecked'
-    expect(page).to have_field(checkbox, checked: false, visible: true)
-  end
-end
-
-When(/^"([^"]*)" radio button should be (selected|unselected)$/) do |radio_button, condition|
-  # E.g. : "Yes" radio button should be selected
-  # radio_button can be name, id or label
-  if condition == 'checked'
-    expect(page).to have_field(radio_button, checked: true, visible: true)
-  elsif condition == 'unchecked'
-    expect(page).to have_field(radio_button, checked: false, visible: true)
-  end
-end
-
-Then(/^validation message should be "([^"]*)" about "([^"]*)" field$/) do |expected_message, element_value|
-  sleep 1.5
-  if page.has_css?(element_value)
-    expected_message.should == page.execute_script("return document.querySelector('#{element_value}').innerHTML.trim();")
-
-  elsif page.has_no_css?(element_value)
-    expected_message.should == ''
-  end
-end

data/lib/steps/browser.rb

@@ -1,35 +0,0 @@
-require_relative 'config'
-
-include BaseConstants
-
-And(/^refresh the page$/) do
-  page.evaluate_script('window.location.reload()')
-  sleep 1
-end
-
-When(/^navigate browser to "([^"]*)" url$/) do |url|
-  visit url
-end
-
-And(/^switch window to (first|last) opened$/) do |condition|
-  if condition == 'first'
-    page.driver.browser.switch_to.window(page.driver.browser.window_handles.first)
-  elsif condition == 'last'
-    page.driver.browser.switch_to.window(page.driver.browser.window_handles.last)
-  end
-end
-
-Then(/^user should redirected to "([^"]*)" path$/) do |path|
-  page.should have_current_path(path, wait: $timeout)
-end
-
-Then(/^alert message (should|should_not) be "([^"]*)"$/) do |condition, message|
-  if condition == 'should'
-    resp = page.driver.browser.switch_to.alert.text
-    resp.should == message
-
-  elsif condition == 'should_not'
-    resp = page.driver.browser.switch_to.alert.text
-    resp.should_not == message
-  end
-end

data/lib/steps/check.rb

@@ -1,24 +0,0 @@
-require_relative 'config'
-
-include BaseConstants
-
-When(/^(check|uncheck) "([^"]*)" checkbox$/) do |condition, checkbox|
-  # E.g. : check "Agree" checkbox
-  # checkbox can be name, id or label
-  if condition == 'check'
-    check(checkbox)
-  elsif condition == 'uncheck'
-    uncheck(checkbox)
-  end
-end
-
-When(/^choose "([^"]*)" radio button$/) do |radio_button|
-  # E.g. : choose "Yes" radio button
-  # radio_button can be name, id or label
-  choose(radio_button)
-end
-
-And(/^check type "([^"]*)" value "([^"]*)" web element$/) do |web_element_type, web_element|
-  page.should have_selector(:"#{web_element_type}", web_element, wait: $timeout)
-  find(:"#{web_element_type}", web_element).set(true)
-end

data/lib/steps/click.rb

@@ -1,26 +0,0 @@
-When(/^click "([^"]*)" (link|button) by (id|title|text)$/) do |identifier, identifier_type, condition|
-  # E.g: click "Save" button by text
-  Capybara.ignore_hidden_elements = false
-
-  if condition == 'title' || condition == 'text'
-    page.should have_content(identifier)
-
-  elsif condition == 'id'
-    page.should have_selector(:id, identifier)
-  end
-
-  if identifier_type == 'link'
-    # link can be id, title or text
-    click_link(identifier)
-
-  elsif identifier_type == 'button'
-    # button can be id, title or text
-    click_button(identifier)
-  end
-end
-
-Then(/^click type "([^"]*)" value "([^"]*)" web element$/) do |web_element_type, web_element|
-  # E.g: click type "id" value "save" web element
-  page.should have_selector(:"#{web_element_type}", web_element)
-  find(:"#{web_element_type}", web_element).click
-end

data/lib/steps/fill.rb

@@ -1,44 +0,0 @@
-require_relative 'config'
-
-include BaseConstants
-
-And(/^fill "([^"]*)" with "([^"]*)"$/) do |field, value|
-  # E.g : fill "Phone Number" with "5555555555"
-  # field can be name, id or label
-  fill_in(field, with: value)
-end
-
-And(/^fill input boxes with these values:$/) do |table|
-  values = table.raw
-  values.each {|raw| fill_in(raw[0], with: raw[1])}
-end
-
-Then(/^fill type "([^"]*)" value "([^"]*)" web element with "([^"]*)"$/) do |web_element_type, web_element, value|
-  # E.g: fill type "id" value "mobilePhone" web element with "5555555555"
-  page.should have_selector(:"#{web_element_type}", web_element, wait: $timeout)
-  find(:"#{web_element_type}", web_element).set(value)
-end
-
-And(/^fill "([^"]*)" with random (email|password|name|gsm)$/) do |field, condition|
-  def generate_code(number, condition)
-    if condition == 'email'
-      charset = Array('A'..'Z') + Array('a'..'z') + Array(0..9)
-      Array.new(number) {charset.sample}.join + "@gmail.com"
-
-    elsif condition == 'password'
-      charset = Array('A'..'Z') + Array('a'..'z') + Array(0..9)
-      Array.new(number) {charset.sample}.join
-
-    elsif condition == 'name'
-      charset = Array('A'..'Z') + Array('a'..'z')
-      Array.new(number) {charset.sample}.join
-
-    elsif condition == 'gsm'
-      charset = Array(0..9)
-      Array.new(7) {charset.sample}.join
-    end
-  end
-
-  var = generate_code(10, condition)
-  fill_in(field, with: var)
-end

data/lib/steps/select.rb

@@ -1,38 +0,0 @@
-And(/^select "([^"]*)" as "([^"]*)" from dropdown$/) do |dropdown, option|
-  # E.g : select "Country" as "United States" from dropdown
-  # E.g : select "United States", from: "Country", :match => :first ===>> to select first matched option
-  # dropdown can be id, name, label text
-  select(option, from: dropdown) # OR ==>> find('#select_id').select('value')
-end
-
-Then /^"([^"]*)" (should|should_not) be selected for "([^"]*)" dropdown$/ do |selected_option, condition, dropdown|
-  # E.g : "United States" should be selected for "Country" dropdown
-  if condition == 'should'
-    page.should have_select(dropdown, selected: selected_option)
-
-  elsif condition == 'should_not'
-    page.should_not have_select(dropdown, selected: selected_option)
-  end
-end
-
-Then /^"([^"]*)" dropdown (should|should_not) contain "([^"]*)" option$/ do |dropdown, condition, option_text|
-  # E.g : "Country" dropdown should contain "United States" option
-  if condition == 'should'
-    page.should have_select(dropdown, with_options: [option_text])
-
-  elsif condition == 'should_not'
-    page.should_not have_select(dropdown, with_options: [option_text])
-  end
-end
-
-Then /^"([^"]*)" dropdown (should|should_not) contain following options:$/ do |dropdown, condition, table|
-  values = table.raw
-  sleep 1
-  values.each {|raw|
-    if condition == 'should'
-      page.should have_select(dropdown, with_options: [raw[0]])
-
-    elsif condition == 'should_not'
-      page.should_not have_select(dropdown, with_options: [raw[0]])
-    end}
-end

data/lib/steps/unclassified.rb

@@ -1,19 +0,0 @@
-When(/^hover to "([^"]*)" value "([^"]*)" web element$/) do |web_element_type, web_element|
-  # E.g: hover to "css" value ".map" web element
-  find(:"#{web_element_type}", web_element).trigger(:mouseover)
-end
-
-When(/^wait "([^"]*)" seconds$/) do |sec_value|
-  sleep sec_value.to_i
-end
-
-And(/^generate "([^"]*)" char random string and type into type "([^"]*)" value "([^"]*)"$/) do |count, web_element_type, web_element|
-  # E.g: generate "10" char random string and type into type "id" value "mobile"
-  charset = (0...count).map {(65 + rand(26)).chr}.join
-  find(:"#{web_element_type}", web_element).set(charset)
-end
-
-And(/^execute javascript code "([^"]*)"/) do |code|
-  page.execute_script(code)
-  sleep 2
-end