howitzer 2.0.2 → 2.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d72a5c40224b791c09af55a7f96a85783dd9bbec
-  data.tar.gz: 5c06f66b976b7fe0d389ebd516aa99b7ec60b7a5
+  metadata.gz: bb8410811f708378094fa35c54437e100e62efc6
+  data.tar.gz: 9b2fa233a0ccc0ce63c8a4f410a053228dd6bace
 SHA512:
-  metadata.gz: e6540a619b0d5d157703116803ed3e3a032ce4570367c1e2dff77fcf97daf516c81fa2220c27cd2ec4a3e788768b2001cf7409d28508b6d5085e26b246652722
-  data.tar.gz: 46d599bfd49cb004da4b7ddb3fe79d8b765df77ae9e4ac4a4c42eb7c02aae385b1b712c22d565cb002e2742b1bc4be33b0418c4d29850ea7a620d16c070f65f0
+  metadata.gz: 2ec55c0135ef0929e65808aa5a1d61aa62b96b40f29ab0ce13fb57b6c0dd14ff5730358d3a7812e66c999f758f3c9b4b6aeeb3c5b62b1547a6fbbe0e096c2e45
+  data.tar.gz: 7f02cc2ba7ffe493e812b84fa2167c120af2bd7f2238e88c334e70dd5fced7d5b9f8f1c0f0057dd47f3d944e0ae0e3f4b54cb2bc6dd5e9aceefadd20d9a9d126

data/.rubocop.yml

@@ -17,6 +17,9 @@ Style/EmptyElse:
 Lint/AmbiguousRegexpLiteral:
   Enabled: false
 
+Lint/AmbiguousBlockAssociation:
+  Enabled: false  
+
 Style/CaseEquality:
   Enabled: false
 

data/.travis.yml

@@ -2,6 +2,6 @@ language: ruby
 before_install:
   - gem install bundler
 rvm:
-  - 2.2.6
-  - 2.3.3
-  - 2.4.0
+  - 2.2.7
+  - 2.3.4
+  - 2.4.1

data/CHANGELOG.md

@@ -1,9 +1,19 @@
-## [In git](https://github.com/strongqa/howitzer/compare/v2.0.2...master)
+## [In git](https://github.com/strongqa/howitzer/compare/v2.0.3...master)
 
 ### New Features
 
 ### Bugfixes
 
+## [v2.0.3](https://github.com/strongqa/howitzer/compare/v2.0.2...v2.0.3)
+
+### New Features
+- Integrate Google Chrome Headless
+- Stop supported **mailgun_idle_timeout** deprecated setting
+- Added maintenance instructions for releasing
+
+### Bugfixes
+- [#222](https://github.com/strongqa/howitzer/issues/222) fix issue with incorrect iframe scope identifying
+
 ## [v2.0.2](https://github.com/strongqa/howitzer/compare/v2.0.1...v2.0.2)
 
 ### New Features

data/MAINTENANCE.md

@@ -0,0 +1,32 @@
+# Howitzer Maintenance
+
+This guide provides detailed instructions how to release a new Howitzer version
+
+To release a new Howitzer version:
+
+* Make sure all pull requests have been merged to master branch
+* Make sure last build is passed in [TravisCI](https://travis-ci.org/strongqa/howitzer)
+* Make sure the code is covered 100% in [Coveralls](https://coveralls.io/github/strongqa/howitzer?branch=master)
+* Make sure all gem dependencies are up-to-date with [Gemnasium](https://gemnasium.com/strongqa/howitzer)
+* Make sure the code is documented 100% with following command:
+```
+rake yard
+```
+* [Upgrade](https://github.com/strongqa/howitzer/wiki/Migration-to-new-version) Howitzer examples [Cucumber](https://github.com/strongqa/howitzer_example_cucumber), [Rspec](https://github.com/strongqa/howitzer_example_rspec) and [Turnip](https://github.com/strongqa/howitzer_example_turnip) to last version of code from master and make sure all builds are green
+* Bump [version](lib/howitzer/version.rb). Please note howitzer uses [semantic versioning](http://semver.org/)
+* Verify and actualize [ChangeLog](CHANGELOG.md)
+* Commit all changes and push to origin master
+* Specify credentials for Rubygems.org (once only) with following commands:
+```bash
+curl https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials
+chmod 0600 ~/.gem/credentials
+```
+* Release Gem with following command:
+```bash
+rake release
+```
+* Verify successful release on [Rubygems](https://rubygems.org/gems/howitzer)
+* Force API documentation indexing for the new version on [Rubygems](https://rubygems.org/gems/howitzer)
+* Update new link to documentation on [web site](https://github.com/romikoops/howitzer-framework.io/tree/gh-pages) Note: The web site will be updated automatically after pushing code to Github
+* Update [Howitzer Guides](https://github.com/strongqa/docs.howitzer-framework.io/blob/gh-pages/README.md) regarding new changes
+* Notify Community (Gitter, Twitter, Google Group) about the new release

data/README.md

@@ -44,11 +44,11 @@ You can also find the Rdoc documentation on [Rubygems](https://rubygems.org/gems
 * [Ruby](https://www.ruby-lang.org/en/downloads/) 2.2.2+
 * [DevKit](https://github.com/oneclick/rubyinstaller/wiki/Development-Kit#installation-instructions) (For **Windows** only)
 * [PhantomJS](http://phantomjs.org/download.html) (For **phantomjs** and **poltergeist** drivers only)
-* [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/) (For **chrome** selenium browser)
+* [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/) (For **chrome** selenium browser, 2.29+ for headless mode)
 * [GeckoDriver](https://github.com/mozilla/geckodriver/releases) (For **firefox** selenium browser)
 * [SafariDriver](https://webkit.org/blog/6900/webdriver-support-in-safari-10/) (For **safari** selenium browser)
 * [QT](https://github.com/thoughtbot/capybara-webkit/wiki/Installing-Qt-and-compiling-capybara-webkit) (For **webkit** driver only)
-
+* [Chrome](https://www.google.com/chrome/browser/desktop/index.html) v.59+ (For **headless chrome** support)
 ## Setup
 To install, type
 
@@ -141,7 +141,7 @@ community](https://github.com/strongqa/howitzer/graphs/contributors).
 License
 -------
 
-howitzer is Copyright © 2012-2016 Roman Parashchenko and StrongQA Ltd. It is free
+howitzer is Copyright © 2012-2017 Roman Parashchenko and StrongQA Ltd. It is free
 software, and may be redistributed under the terms specified in the
 [LICENSE](LICENSE) file.
 

data/Rakefile

@@ -19,4 +19,4 @@ YARD::Rake::YardocTask.new { |_t| }
 
 RuboCop::RakeTask.new
 
-task default: %i(rubocop spec cucumber)
+task default: %i[rubocop spec cucumber]

data/bin/howitzer

@@ -13,13 +13,13 @@ module HowitzerCli
   arg_name '<PROJECT NAME>'
   command :new do |c|
     c.desc 'Integrate Cucumber'
-    c.switch %i(c cucumber), negatable: false
+    c.switch %i[c cucumber], negatable: false
 
     c.desc 'Integrate Rspec'
-    c.switch %i(r rspec), negatable: false
+    c.switch %i[r rspec], negatable: false
 
     c.desc 'Integrate Turnip'
-    c.switch %i(t turnip), negatable: false
+    c.switch %i[t turnip], negatable: false
 
     c.action do |_global_options, options, args|
       if !args.empty?

data/generators/config/templates/capybara.rb

@@ -1,4 +1,4 @@
-HOWITZER_KNOWN_DRIVERS = %i(
+HOWITZER_KNOWN_DRIVERS = %i[
   selenium
   selenium_grid
   webkit
@@ -7,7 +7,8 @@ HOWITZER_KNOWN_DRIVERS = %i(
   sauce
   testingbot
   browserstack
-).freeze
+  headless_chrome
+].freeze
 
 unless HOWITZER_KNOWN_DRIVERS.include?(Howitzer.driver.to_s.to_sym)
   raise Howitzer::UnknownDriverError, "Unknown '#{Howitzer.driver}' driver." \
@@ -52,6 +53,16 @@ Capybara.register_driver :selenium do |app|
   Capybara::Selenium::Driver.new app, params
 end
 
+# :headless_chrome driver
+
+Capybara.register_driver :headless_chrome do |app|
+  startup_flags = ['--headless']
+  startup_flags << '-start-maximized' if Howitzer.maximized_window
+  startup_flags.concat(Howitzer.headless_chrome_flags.split(/\s*,\s*/)) if Howitzer.headless_chrome_flags
+  params = { browser: :chrome, switches: startup_flags }
+  Capybara::Selenium::Driver.new app, params
+end
+
 # :webkit driver
 
 if Howitzer.driver.to_sym == :webkit
@@ -151,6 +162,9 @@ Capybara.save_path = Howitzer.log_dir
 Capybara::Screenshot.register_driver(:phantomjs) do |driver, path|
   driver.browser.save_screenshot path
 end
+Capybara::Screenshot.register_driver(:headless_chrome) do |driver, path|
+  driver.browser.save_screenshot path
+end
 Capybara::Screenshot.append_timestamp = false
 Capybara::Screenshot.register_filename_prefix_formatter(:default) do
   "capybara-screenshot-#{Gen.serial}"

data/generators/config/templates/default.yml

@@ -21,13 +21,17 @@
  maximized_window: true # Specify maximized browser window size
 
  # Specify one of the following drivers: selenium, selenium_grid, webkit, poltergeist, phantomjs, sauce,
- # testingbot, browserstack
+ # testingbot, browserstack, headless_chrome
  driver: phantomjs
 
  # -Selenium-
  # specify one of next browsers: iexplore (ie), firefox (ff), chrome, safari
  selenium_browser: ff
 
+ # -Headless Chrome-
+ # List of available flags (http://peter.sh/experiments/chromium-command-line-switches/)
+ headless_chrome_flags: "--window-size=1920x1080, --disable-gpu"
+
  # -Selenium Grid-
  selenium_hub_url: "http://example.com:4444/wd/hub"
 

data/generators/cucumber/templates/env.rb

@@ -1,5 +1,4 @@
 require 'cucumber'
-require 'capybara-screenshot/cucumber'
 require_relative '../../config/boot'
 require_relative '../../config/capybara'
 

data/generators/emails/templates/example_email.rb

@@ -3,6 +3,6 @@ class TestEmail < Howitzer::Email
   subject 'Test email'
 
   def addressed_to?(new_user)
-    /Hi #{new_user}/ === plain_text_body
+    plain_text_body =~ /Hi #{new_user}/ ? true : false
   end
 end

data/generators/root/templates/.rubocop.yml

@@ -19,6 +19,9 @@ Style/EmptyElse:
 Lint/AmbiguousRegexpLiteral:
   Enabled: false
 
+Lint/AmbiguousBlockAssociation:
+  Enabled: false  
+
 Style/CaseEquality:
   Enabled: false
 
@@ -29,4 +32,4 @@ Style/FrozenStringLiteralComment:
   Enabled: false
 
 Metrics/ModuleLength:
-  Max: 150  
+  Max: 150

data/lib/howitzer/capybara_helpers.rb

@@ -10,7 +10,7 @@ module Howitzer
     #   Testingbot or Browserstack cloud service
 
     def cloud_driver?
-      %i(sauce testingbot browserstack).include?(Howitzer.driver.to_sym)
+      %i[sauce testingbot browserstack].include?(Howitzer.driver.to_sym)
     end
 
     # @return [Boolean] whether or not current browser is

data/lib/howitzer/version.rb

@@ -1,4 +1,4 @@
 # This module holds howitzer version
 module Howitzer
-  VERSION = '2.0.2'.freeze #:nodoc:
+  VERSION = '2.0.3'.freeze #:nodoc:
 end

data/lib/howitzer/web/capybara_methods_proxy.rb

@@ -1,4 +1,6 @@
 require 'capybara'
+require 'active_support'
+require 'active_support/core_ext'
 
 # Remove this monkey patch after fixing the bugs in selenium-webdriver / capybara
 #:nocov:
@@ -20,7 +22,7 @@ class Capybara::Selenium::Driver # rubocop:disable Style/ClassAndModuleChildren
   private
 
   def within_frame?
-    !(@frame_handles.empty? || @frame_handles[browser.window_handle].empty?)
+    !(@frame_handles.blank? || @frame_handles[browser.window_handle].blank?)
   end
 end
 #:nocov:
@@ -31,7 +33,7 @@ module Howitzer
     module CapybaraMethodsProxy
       PROXIED_CAPYBARA_METHODS = Capybara::Session::SESSION_METHODS + #:nodoc:
                                  Capybara::Session::MODAL_METHODS +
-                                 %i(driver text)
+                                 %i[driver text]
 
       # Capybara form dsl methods are not compatible with page object pattern and Howitzer gem.
       # Instead of including Capybara::DSL module, we proxy most interesting Capybara methods and
@@ -44,7 +46,7 @@ module Howitzer
       # @param flag [Boolean] Determines accept or decline alert box
 
       def click_alert_box(flag)
-        if %w(selenium sauce).include? Howitzer.driver
+        if %w[selenium sauce].include? Howitzer.driver
           alert = driver.browser.switch_to.alert
           flag ? alert.accept : alert.dismiss
         else

data/lib/howitzer/web/page.rb

@@ -153,7 +153,7 @@ module Howitzer
 
       def initialize
         check_validations_are_defined!
-        current_window.maximize if Howitzer.maximized_window
+        current_window.maximize if Howitzer.maximized_window && Howitzer.driver != 'headless_chrome'
       end
 
       # Reloads current page in a browser

data/spec/config/custom.yml

@@ -7,4 +7,3 @@ capybara_wait_time: 5
 cloud_http_idle_timeout: 10
 hide_datetime_from_log: true
 maximized_window: false
-mailgun_idle_timeout: 0.5

data/spec/unit/generators/root_generator_spec.rb

@@ -15,7 +15,7 @@ RSpec.describe 'Generators' do
     let(:expected_result) do
       [
         { name: '/.gitignore', is_directory: false, size: 196 },
-        { name: '/.rubocop.yml', is_directory: false, size: 584 },
+        { name: '/.rubocop.yml', is_directory: false, size: 634 },
         { name: '/Gemfile', is_directory: false, size: 625 },
         { name: '/Rakefile', is_directory: false, size: template_file_size('root', 'Rakefile') }
       ]

data/spec/unit/lib/cache_spec.rb

@@ -70,7 +70,7 @@ RSpec.describe Howitzer::Cache do
       it { expect(described_class.data).to eq(cloud: { status: false }, foo: {}, bar: {}, baz: {}) }
     end
     context 'when custom argument' do
-      let(:exception_list) { %i(foo bar) }
+      let(:exception_list) { %i[foo bar] }
       before { described_class.clear_all_ns(exception_list) }
       it do
         expect(described_class.data).to eq(

data/spec/unit/lib/howitzer_spec.rb

@@ -35,6 +35,6 @@ RSpec.describe 'Howitzer' do
         "WARNING! 'mailgun_idle_timeout' setting is deprecated. Please replace with 'mail_wait_time' setting."
       )
     end
-    it { is_expected.to eq(0.5) }
+    it { is_expected.to be_nil }
   end
 end

data/spec/unit/lib/web/page_spec.rb

@@ -296,6 +296,16 @@ RSpec.describe Howitzer::Web::Page do
         subject
       end
     end
+    context 'when maximized_window is true and driver is headless_chrome' do
+      before do
+        allow(Howitzer).to receive(:maximized_window) { true }
+        allow(Howitzer).to receive(:driver) { 'headless_chrome' }
+      end
+      it do
+        expect_any_instance_of(described_class).not_to receive('current_window.maximize')
+        subject
+      end
+    end
     context 'when maximized_window is false' do
       before { allow(Howitzer).to receive(:maximized_window) { false } }
       it do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: howitzer
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.0.3
 platform: ruby
 authors:
 - Roman Parashchenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-03-27 00:00:00.000000000 Z
+date: 2017-06-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -232,6 +232,7 @@ files:
 - CONTRIBUTING.md
 - Gemfile
 - LICENSE
+- MAINTENANCE.md
 - README.md
 - Rakefile
 - bin/howitzer
@@ -294,6 +295,7 @@ files:
 - lib/howitzer/log.rb
 - lib/howitzer/mail_adapters.rb
 - lib/howitzer/mail_adapters/abstract.rb
+- lib/howitzer/mail_adapters/debugmail.rb
 - lib/howitzer/mail_adapters/mailgun.rb
 - lib/howitzer/mailgun_api.rb
 - lib/howitzer/mailgun_api/client.rb
@@ -375,7 +377,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.10
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
 summary: Ruby based framework for acceptance testing