ruby_raider 0.4.8 → 0.4.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 904822acb4d07440328f3b619533a79374988766b0882f668f31e32f8636adb3
-  data.tar.gz: e64bfe97f99255eac84ee1f6e850b5ce02293b0bc0314e031d047ee67071e3f3
+  metadata.gz: 72809bc4815e52fc26dcd2986702462c2f80c58eea9d5d3ae4093b46b60497d3
+  data.tar.gz: 367da2b34c2cebb02ceef20c4bea7cd4928ed18be55f02bccfe6d6b41b73ba0e
 SHA512:
-  metadata.gz: c77b13d45b719d5ab8add012d22f9b2c1016d53877441dc7b6b1a9fde39553c1eac5f951d8c9f1e5d7012eb14b9da162fc12c0d08274eb24791cb0fefb462b48
-  data.tar.gz: 610e5101c0f09d3ba1898d03111745e0208705ad36a5337dce2fd44b381afa0116f1a050be4c19896f0a973ae36b26b81a65f0d009568821ea82fdfd162204d5
+  metadata.gz: a654e20f8320af80c083e7e4274ba18b4717a6ba070d858d0334ffae46785031b8e5098061fd54ca9d66562211dfedc797b17e34c81381bac7d4a388ad6e450f
+  data.tar.gz: 8209f8add377cae9e94ce8e2db3825cf1d6eb40f07432b49a5c1e098963e99d3cbd7086cf9a1e8109b41ea498772d875826d12486d0b83271fdc28668608c1d3

data/README.md

@@ -2,6 +2,7 @@
 
 [![Gem Version](https://badge.fury.io/rb/ruby_raider.svg)](https://badge.fury.io/rb/ruby_raider)
 [![Rubocop](https://github.com/RubyRaider/ruby_raider/actions/workflows/rspec.yml/badge.svg)](https://github.com/RubyRaider/ruby_raider/actions/workflows/rspec.yml)
+[![Gitter](https://badges.gitter.im/RubyRaider/community.svg)](https://gitter.im/RubyRaider/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
 
 <!-- PROJECT LOGO -->
 <br />
@@ -53,6 +54,8 @@ Ruby Raider is a generator and scaffolding gem to make UI test automation easier
 
 * Generating a visual testing framework with Rspec, Applitools and Selenium
 
+* Generating a visual testing framework with Rspec, Applitools and Watir
+
 ***In order to run the Appium tests, download the example [app](https://github.com/saucelabs/my-demo-app-rn).***
 
 ***In order to run the visual tests with applitools, you need to create an account and get your api key, you can read more [here](https://applitools.com/docs/topics/overview/obtain-api-key.html#:~:text=If%20you%20already%20have%20an,Your%20key%20will%20be%20displayed.).***

data/lib/generators/menu_generator.rb

@@ -67,18 +67,12 @@ class MenuGenerator
   private
 
   def framework_choice(framework, automation_type)
-    visual_automation = if automation_type == 'selenium' && framework == 'Rspec'
-                          choose_visual_automation
-                        end
+    visual_automation = choose_visual_automation if %w[selenium watir].include?(automation_type) && framework == 'Rspec'
 
     set_up_framework(automation_type, framework.downcase, visual_automation)
     prompt.say("You have chosen to use #{framework} with #{automation_type}")
   end
 
-  def error_handling(platform)
-    pp "#{platform} appium is coming soon. Thank you for the interest"
-  end
-
   def select_test_framework(automation)
     prompt.select('Please select your test framework') do |menu|
       menu.choice :Cucumber, -> { framework_choice('Cucumber', automation) }

data/lib/generators/templates/automation/app_page.tt

@@ -3,8 +3,10 @@
 require_relative '../abstract/abstract_page'
 
 class AppPage < AbstractPage
+<%- if automation == 'selenium' -%>
   using Raider::SeleniumHelper
 
+<%- end -%>
   def url(_page)
     'app.html#'
   end

data/lib/generators/templates/automation/login_page.tt

@@ -1,7 +1,7 @@
-<% if automation == 'selenium' && visual_automation == true %>
-<%= ERB.new(File.read(File.expand_path('./partials/visual_login.tt', __dir__))).result(binding) %>
+<% if %w[selenium watir].include?(automation) && visual_automation == true %>
+<%= ERB.new(File.read(File.expand_path('./partials/visual_login.tt', __dir__)), trim_mode: '-').result(binding) %>
 <% elsif automation == 'selenium' %>
-<%= ERB.new(File.read(File.expand_path('./partials/selenium_login.tt', __dir__))).result(binding) %>
+<%= ERB.new(File.read(File.expand_path('./partials/selenium_login.tt', __dir__)), trim_mode: '-').result(binding) %>
 <% elsif automation == 'watir' %>
-<%= ERB.new(File.read(File.expand_path('./partials/watir_login.tt', __dir__))).result(binding) %>
+<%= ERB.new(File.read(File.expand_path('./partials/watir_login.tt', __dir__)), trim_mode: '-').result(binding) %>
 <% end %>

data/lib/generators/templates/automation/partials/visual_login.tt

@@ -3,7 +3,9 @@
 require_relative '../abstract/abstract_page'
 
 class LoginPage < AbstractPage
+<%- if automation == 'selenium' -%>
   using Raider::SeleniumHelper
+<%- end -%>
 
   def url(_page)
     'index.html'
@@ -12,7 +14,11 @@ class LoginPage < AbstractPage
   # Actions
 
   def login
+  <%- if automation == 'watir' -%>
+    login_button.click
+    <%- else -%>
     login_button.click_when_present
+    <%- end -%>
   end
 
   private
@@ -20,6 +26,10 @@ class LoginPage < AbstractPage
   # Elements
 
   def login_button
+  <%- if automation == 'watir' -%>
+    browser.element(id: 'log-in')
+  <%- else -%>
     driver.find_element(:id, 'log-in')
+  <%- end -%>
   end
-end
+end

data/lib/generators/templates/common/gemfile.tt

@@ -10,6 +10,7 @@ gem 'allure-cucumber'
 <% end -%>
 <% if visual_automation -%>
 gem 'eyes_selenium'
+gem 'eyes_universal'
 <% end -%>
 <% unless visual_automation -%>
 gem 'parallel_split_test'

data/lib/generators/templates/common/read_me.tt

@@ -50,6 +50,8 @@ Ruby Raider is a generator and scaffolding gem to make UI test automation easier
 
 * Generating a visual testing framework with Rspec, Applitools and Selenium
 
+* Generating a visual testing framework with Rspec, Applitools and Watir
+
 ***In order to run the Appium tests, download the example [app](https://github.com/saucelabs/my-demo-app-rn).***
 
 ***In order to run the visual tests with applitools, you need to create an account and get your api key, you can read more [here](https://applitools.com/docs/topics/overview/obtain-api-key.html#:~:text=If%20you%20already%20have%20an,Your%20key%20will%20be%20displayed.).***

data/lib/generators/templates/helpers/raider_helper.tt

@@ -1,22 +1,22 @@
 # frozen_string_literal: true
 
 module Raider
-<% if framework == 'rspec' -%>
+<%- if framework == 'rspec' -%>
   require_relative 'spec_helper'
-<% end -%>
+<%- end -%>
   <%= ERB.new(File.read(File.expand_path('./partials/require_automation.tt', __dir__))).result(binding).strip! %>
-<% if automation == 'watir' -%>
+<%- if automation == 'watir' -%>
   require_relative 'browser_helper'
-<% else -%>
+<%- else -%>
   require_relative 'driver_helper'
-<% end -%>
-<% unless visual_automation -%>
+<%- end -%>
+<%- unless visual_automation -%>
   require_relative 'allure_helper'
-<% end -%>
-<% if automation == 'cross_platform' -%>
+<%- end -%>
+<%- if automation == 'cross_platform' -%>
   require_relative 'appium_helper'
-<% end -%>
-<% if visual_automation -%>
+<%- end -%>
+<%- if visual_automation -%>
   require_relative 'visual_helper'
-<% end -%>
+<%- end -%>
 end

data/lib/generators/templates/helpers/visual_helper.tt

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'active_support/inflector'
 require 'eyes_selenium'
 require 'yaml'
 

data/lib/generators/templates/helpers/visual_spec_helper.tt

@@ -2,20 +2,28 @@
 
 require 'rspec'
 require 'eyes_selenium'
+<%- if automation == 'selenium' -%>
 require_relative 'driver_helper'
+<%- else -%>
+require_relative 'browser_helper'
+<%- end -%>
 require_relative 'visual_helper'
 
 module Raider
   module SpecHelper
     RSpec.configure do |config|
-      config.include(DriverHelper)
+      config.include(<%- if automation == 'watir' -%>BrowserHelper<% else -%>DriverHelper<%- end -%>)
       config.include(VisualHelper)
       config.before(:each) do
         OpenSSL::SSL::VERIFY_PEER = OpenSSL::SSL::VERIFY_NONE
         @grid_runner = create_grid_runner
         @eyes = create_eyes(@grid_runner)
         configure_eyes @eyes
+        <%- if automation == 'selenium' -%>
         @driver = @eyes.open(driver: new_driver)
+        <%- else -%>
+        @driver = @eyes.open(driver: new_browser.driver)
+        <%- end -%>
       end
 
       config.after(:each) do

data/lib/generators/templates/rspec/spec.tt

@@ -1,4 +1,4 @@
-<% if automation == 'selenium' && visual_automation == true %>
+<% if %w[selenium watir].include?(automation) && visual_automation == true %>
 # frozen_string_literal: true
 
 require_relative 'base_spec'
@@ -6,10 +6,10 @@ require_relative '../page_objects/pages/login_page'
 require_relative '../page_objects/pages/app_page'
 
 describe 'Login Page' do
-  let(:app_page) { AppPage.new(@driver) }
-  let(:login_page) { LoginPage.new(@driver) }
+  let(:app_page) { AppPage.new(<% if automation == 'watir' -%>browser<% else -%>driver<% end -%>) }
+  let(:login_page) { LoginPage.new(<% if automation == 'watir' -%>browser<% else -%>driver<% end -%>) }
 
-  before(:example) do
+  before do
     login_page.visit
   end
 
@@ -19,17 +19,16 @@ describe 'Login Page' do
     check_page app_page
   end
 end
-
-<% elsif %w[selenium watir].include? automation -%>
+<%- elsif %w[selenium watir].include? automation -%>
 require_relative 'base_spec'
 require_relative '../page_objects/pages/login_page'
 
 describe 'Login' do
   let(:user_name) { 'aguspe' }
-  let(:login_page) { LoginPage.new(<% if automation == 'watir' -%>@browser<% else -%>@driver<% end -%>) }
+  let(:login_page) { LoginPage.new(<% if automation == 'watir' -%>browser<% else -%>driver<% end -%>) }
   subject { login_page.header.customer_name }
 
-  before(:example) do
+  before do
     login_page.visit
     login_page.login(user_name, password)
   end
@@ -50,7 +49,7 @@ describe 'Login' do
     end
   end
 end
-<% else -%>
+<%- else -%>
 require_relative '../page_objects/pages/home_page'
 require_relative 'base_spec'
 require_relative '../page_objects/pages/pdp_page'
@@ -67,4 +66,4 @@ class PdpSpec < BaseSpec
     end
   end
 end
-<% end -%>
+<%- end -%>

data/ruby_raider.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name        = 'ruby_raider'
-  s.version     = '0.4.8'
+  s.version     = '0.4.9'
   s.summary     = 'A gem to make setup and start of UI automation projects easier'
   s.description = 'This gem has everything you need to start working with test automation'
   s.authors     = ['Agustin Pequeno']

data/spec/automation_generator_spec.rb

@@ -36,12 +36,28 @@ describe AutomationGenerator do
     end
   end
 
+  shared_examples 'creates web visual automation files' do |name|
+    it 'creates a login page file' do
+      expect(File).to exist("#{name}/page_objects/pages/login_page.rb")
+    end
+
+    it 'creates an abstract page file' do
+      expect(File).to exist("#{name}/page_objects/abstract/abstract_page.rb")
+    end
+
+    it 'creates an app page file' do
+      expect(File).to exist("#{name}/page_objects/pages/app_page.rb")
+    end
+  end
+
   context 'with rspec and selenium' do
     include_examples 'creates web automation files', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}"
+    include_examples 'creates web visual automation files', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}_visual"
   end
 
   context 'with rspec and watir' do
     include_examples 'creates web automation files', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[3]}"
+    include_examples 'creates web visual automation files', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[3]}_visual"
   end
 
   context 'with cucumber and selenium' do

data/spec/common_generator_spec.rb

@@ -25,7 +25,7 @@ describe CommonGenerator do
   end
 
   shared_examples 'creates a capabilities file' do |name|
-    it 'creates a config file' do
+    it 'creates a capabilities file' do
       expect(File).to exist("#{name}/config/capabilities.yml")
     end
   end
@@ -36,6 +36,12 @@ describe CommonGenerator do
     end
   end
 
+  shared_examples 'creates an options file' do |name|
+    it 'creates an options file' do
+      expect(File).to exist("#{name}/config/options.yml")
+    end
+  end
+
   context 'with rspec and selenium' do
     include_examples 'creates common files', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}"
     include_examples 'creates a config file', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}"
@@ -46,6 +52,18 @@ describe CommonGenerator do
     include_examples 'creates a config file', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[3]}"
   end
 
+  context 'with rspec, selenium and applitools' do
+    include_examples 'creates common files', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}_visual"
+    include_examples 'creates a config file', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}_visual"
+    include_examples 'creates an options file', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}_visual"
+  end
+
+  context 'with rspec, watir and applitools' do
+    include_examples 'creates common files', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[3]}_visual"
+    include_examples 'creates a config file', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[3]}_visual"
+    include_examples 'creates an options file', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[3]}_visual"
+  end
+
   context 'with cucumber and selenium' do
     include_examples 'creates common files', "#{FRAMEWORKS.first}_#{AUTOMATION_TYPES[2]}"
     include_examples 'creates a config file', "#{FRAMEWORKS.first}_#{AUTOMATION_TYPES[2]}"

data/spec/helpers_generator_spec.rb

@@ -44,6 +44,20 @@ describe HelpersGenerator do
     end
   end
 
+  shared_examples 'creates common visual helpers' do |name|
+    it 'does not create an allure helper file' do
+      expect(File).not_to exist("#{name}/helpers/allure_helper.rb")
+    end
+
+    it 'creates a raider file' do
+      expect(File).to exist("#{name}/helpers/raider.rb")
+    end
+
+    it 'creates a visual helper file' do
+      expect(File).to exist("#{name}/helpers/visual_helper.rb")
+    end
+  end
+
   context 'with rspec and selenium' do
     include_examples 'creates common helpers', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}"
     include_examples 'creates selenium helpers', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}"
@@ -56,6 +70,18 @@ describe HelpersGenerator do
     include_examples 'creates rspec helpers', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[3]}"
   end
 
+  context 'with rspec, selenium and applitools' do
+    include_examples 'creates common visual helpers', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}_visual"
+    include_examples 'creates selenium helpers', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}_visual"
+    include_examples 'creates rspec helpers', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[2]}_visual"
+  end
+
+  context 'with rspec, watir and applitools' do
+    include_examples 'creates common visual helpers', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[3]}_visual"
+    include_examples 'creates watir helpers', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[3]}_visual"
+    include_examples 'creates rspec helpers', "#{FRAMEWORKS.last}_#{AUTOMATION_TYPES[3]}_visual"
+  end
+
   context 'with cucumber and selenium' do
     include_examples 'creates common helpers', "#{FRAMEWORKS.first}_#{AUTOMATION_TYPES[2]}"
     include_examples 'creates selenium helpers', "#{FRAMEWORKS.first}_#{AUTOMATION_TYPES[2]}"

data/spec/spec_helper.rb

@@ -12,13 +12,17 @@ RSpec.configure do |config|
     FRAMEWORKS.each do |framework|
       AUTOMATION_TYPES.each do |automation|
         MenuGenerator.new("#{framework}_#{automation}").generate_framework(automation, framework, false)
+        MenuGenerator.new("#{framework}_#{automation}_visual").generate_framework(automation, framework, true)
       end
     end
   end
 
   config.after(:all) do
     FRAMEWORKS.each do |framework|
-      AUTOMATION_TYPES.each { |automation| FileUtils.rm_rf("#{framework}_#{automation}") }
+      AUTOMATION_TYPES.each do |automation|
+        FileUtils.rm_rf("#{framework}_#{automation}")
+        FileUtils.rm_rf("#{framework}_#{automation}_visual")
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_raider
 version: !ruby/object:Gem::Version
-  version: 0.4.8
+  version: 0.4.9
 platform: ruby
 authors:
 - Agustin Pequeno
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-22 00:00:00.000000000 Z
+date: 2023-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake