unobtainium-multiwait 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4c0be5b0d21564f39c671a3ce93b033694a1be33
+  data.tar.gz: edcd6536595cce853ebf59d5cbdb7dffb9a1ee38
+SHA512:
+  metadata.gz: b61d7186397ad199a2d9ce591d3ccb3f03943cb15a3ef9b32799cf6921a66d0ca730cd715d7f46755bcba1993f0bc701f6ad8ddd3f5f1e4e0db62f7c0a7e4499
+  data.tar.gz: 8b76fb36e10b0382d8df528cb163a1e8c86e86f980615b7f773971374fcf47b17c380b8d2e5cde99303e1ed109856e5cf4ca56deb1becaa72136bc234f38168f

data/.codeclimate.yml

@@ -0,0 +1,28 @@
+---
+engines:
+  bundler-audit:
+    enabled: true
+  duplication:
+    enabled: true
+    config:
+      languages:
+      - ruby
+      - javascript
+      - python
+      - php
+  fixme:
+    enabled: true
+  rubocop:
+    enabled: true
+ratings:
+  paths:
+  - Gemfile.lock
+  - "**.inc"
+  - "**.js"
+  - "**.jsx"
+  - "**.module"
+  - "**.php"
+  - "**.py"
+  - "**.rb"
+exclude_paths:
+- spec/

data/.gitignore

@@ -0,0 +1,42 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# Editor files
+.*.sw*
+
+# Firefox driver
+C:\\nppdf32Log\\debuglog.txt

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,72 @@
+AllCops:
+  TargetRubyVersion: 2.2
+
+# Metrics
+
+Metrics/LineLength:
+  Max: 83
+  Details: >-
+    Line length of 80 is ideal for readability and compatibility; we'll accept
+    an extra 3 for minor edge cases.
+
+Metrics/MethodLength:
+  Max: 35
+
+Metrics/BlockNesting:
+  Max: 5
+
+Metrics/AbcSize:
+  Max: 50
+
+Metrics/PerceivedComplexity:
+  Max: 15
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/ClassLength:
+  Max: 300
+
+Metrics/ModuleLength:
+  Max: 300
+
+# Style
+
+Style/StringLiterals:
+  Enabled: false
+
+Style/ConditionalAssignment:
+  Enabled: false
+
+Style/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+Style/AndOr:
+  Enabled: false
+
+Style/Not:
+  Enabled: false
+
+Style/NegatedIf:
+  Enabled: false
+
+Style/RedundantReturn:
+  Enabled: false
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/TrailingCommaInLiteral:
+  Enabled: false
+
+Style/FirstParameterIndentation:
+  Enabled: false
+
+Style/TrailingUnderscoreVariable:
+  Enabled: false
+
+Style/NumericLiterals:
+  Enabled: false
+
+Style/FileName:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 2.0
+  - 2.1
+  - 2.2
+addons:
+  code_climate:
+    repo_token: 80dc28586def5dc07809b4f5171d54d9087f446ca85092046258618eb27c814e

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in unobtainium-multiwait.gemspec
+gemspec
+
+gem "codeclimate-test-reporter", group: :test, require: nil

data/Gemfile.lock

@@ -0,0 +1,81 @@
+PATH
+  remote: .
+  specs:
+    unobtainium-multiwait (0.1.0)
+      unobtainium (~> 0.5)
+      unobtainium-multifind (~> 0.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.2.0)
+    childprocess (0.5.9)
+      ffi (~> 1.0, >= 1.0.11)
+    codeclimate-test-reporter (0.5.0)
+      simplecov (>= 0.7.1, < 1.0.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    ffi (1.9.10)
+    json (1.8.3)
+    parser (2.3.1.0)
+      ast (~> 2.2)
+    phantomjs (2.1.1.0)
+    powerpack (0.1.1)
+    rainbow (2.1.0)
+    rake (11.1.2)
+    rspec (3.4.0)
+      rspec-core (~> 3.4.0)
+      rspec-expectations (~> 3.4.0)
+      rspec-mocks (~> 3.4.0)
+    rspec-core (3.4.4)
+      rspec-support (~> 3.4.0)
+    rspec-expectations (3.4.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-mocks (3.4.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-support (3.4.1)
+    rubocop (0.39.0)
+      parser (>= 2.3.0.7, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.0, >= 1.0.1)
+    ruby-progressbar (1.8.0)
+    rubyzip (1.2.0)
+    selenium-webdriver (2.53.0)
+      childprocess (~> 0.5)
+      rubyzip (~> 1.0)
+      websocket (~> 1.0)
+    simplecov (0.11.2)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    sys-proctable (1.0.0)
+    unicode-display_width (1.0.5)
+    unobtainium (0.5.0)
+      sys-proctable (~> 1.0)
+    unobtainium-multifind (0.2.0)
+      unobtainium (~> 0.5)
+    websocket (1.2.3)
+    yard (0.8.7.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.12)
+  codeclimate-test-reporter
+  phantomjs
+  rake (~> 11.1)
+  rspec (~> 3.4)
+  rubocop (~> 0.39)
+  selenium-webdriver
+  simplecov (~> 0.11)
+  unobtainium-multiwait!
+  yard (~> 0.8)
+
+BUNDLED WITH
+   1.12.1

data/LICENSE

@@ -0,0 +1,30 @@
+Copyright (c) Jens Finkhaeuser (http://finkhaeuser.de/) and other
+unobtainium-multiwait contributors. All rights not covered below are reserved.
+
+The MIT +no-false-attribs License (MITNFA)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+Distributions of all or part of the Software intended to be used by the
+recipients as they would use the unmodified Software, containing modifications
+that substantially alter, remove, or disable functionality of the Software,
+outside of the documented configuration mechanisms provided by the Software,
+shall be modified such that the Original Author's bug reporting email addresses
+and urls are either replaced with the contact information of the parties
+responsible for the changes, or removed entirely.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,29 @@
+# unobtainium-multiwait
+
+This gem provides a driver module for [unobtainium](https://github.com/jfinkhaeuser/unobtainium)
+allowing for more easily finding (one of) multiple elements.
+
+[![Gem Version](https://badge.fury.io/rb/unobtainium-multiwait.svg)](https://badge.fury.io/rb/unobtainium-multiwait)
+[![Build status](https://travis-ci.org/jfinkhaeuser/unobtainium-multiwait.svg?branch=master)](https://travis-ci.org/jfinkhaeuser/unobtainium-multiwait)
+[![Code Climate](https://codeclimate.com/github/jfinkhaeuser/unobtainium-multiwait/badges/gpa.svg)](https://codeclimate.com/github/jfinkhaeuser/unobtainium-multiwait)
+[![Test Coverage](https://codeclimate.com/github/jfinkhaeuser/unobtainium-multiwait/badges/coverage.svg)](https://codeclimate.com/github/jfinkhaeuser/unobtainium-multiwait/coverage)
+
+To use it, require it after requiring unobtainium, then create the any driver
+with a Selenium API:
+
+```ruby
+require 'unobtainium'
+require 'unobtainium-multiwait'
+
+include Unobtainium::World
+
+driver.navigate.to('http://finkhaeuser.de')
+
+elems = driver.multiwait({ xpath: '//some-element' },
+                         { xpath: '//other-element' },
+                         timeout: 10)
+
+# Entries will be nil if nothing is found by these xpaths before the
+# timeout expires.
+puts elems.length # => 2
+```

data/Rakefile

@@ -0,0 +1,25 @@
+# Rubocop
+require 'rubocop/rake_task'
+RuboCop::RakeTask.new(:rubocop)
+
+# Rspec
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:rspec)
+
+# Documentation
+require 'yard'
+YARD::Rake::YardocTask.new do |t|
+  t.files = ['lib/**/*.rb']
+  t.options = ['-m', 'markdown']
+  t.stats_options = ['--list-undoc']
+end
+
+# Combined test task
+desc "Test all the things!"
+task :test do
+  Rake::Task[:rubocop].invoke
+  Rake::Task[:rspec].invoke
+end
+
+# Default is the test task
+task default: :test

data/lib/unobtainium-multiwait/multiwait.rb

@@ -0,0 +1,186 @@
+# coding: utf-8
+#
+# unobtainium-multiwait
+# https://github.com/jfinkhaeuser/unobtainium-multiwait
+#
+# Copyright (c) 2016 Jens Finkhaeuser and other unobtainium-multiwait contributors.
+# All rights reserved.
+#
+
+require 'unobtainium'
+require 'unobtainium-multifind'
+
+module Unobtainium
+  module MultiWait
+    ##
+    # Driver module implementing multi wait functionality.
+    module DriverModule
+      ##
+      # Default options. This hash is also used to detect if any of the Hashes
+      # passed to #multiwait is an options Hash; it is considered one if it
+      # contains any of the keys specified here.
+      DEFAULT_OPTIONS = {
+        # If true, raises on error instead of returning nil
+        raise_on_error: false,
+        # If true, returns the error object instead of nil
+        return_errors: false,
+        # If :all is specified, the method waits for all elements to
+        #   appear or times out.
+        # If :first is specified, the method returns when the first
+        #   element appears.
+        wait_for: :all,
+        # Defaults to only finding :displayed? elements. You can use any method
+        # that Selenium::WebDriver::Element responds to, or :exists? if you only
+        # care whether the element exists.
+        check_element: :displayed?,
+        # The default wait timeout in seconds.
+        timeout: 10,
+      }.freeze
+
+      class << self
+        ##
+        # Returns true if the implementation has `#find_element`, false
+        # otherwise.
+        def matches?(impl)
+          return impl.respond_to?(:find_element)
+        end
+      end # class << self
+
+      ##
+      # Current options for multiwait
+      attr_accessor :multiwait_options
+      @multiwait_options = DEFAULT_OPTIONS
+
+      ##
+      # Wait for multiple elements. Each argument is a Hash of selector options
+      # that are passed to #find_element. If one argument contains keys from
+      # the DEFAULT_OPTIONS Hash, it is instead treated as an options Hash for
+      # the #multiwait method.
+      # @return Array of found elements or nil entries if no matching element
+      #   was found.
+      #   FIXME: recheck this!
+      def multiwait(*args)
+        # Parse options
+        options, selectors = multiwait_parse_options(*args)
+
+        # Pass some options to multifind
+        multifind_opts = {
+          raise_on_error: options[:raise_on_error],
+          return_errors: options[:return_error],
+          check_element: options[:check_element],
+        }
+
+        # Wait for elements
+        results = []
+        wait = ::Selenium::WebDriver::Wait.new(timeout: options[:timeout])
+        begin
+          wait.until do
+            results = multifind(*selectors, multifind_opts)
+            got_it, results = multiwait_filter_results(options, results)
+            if got_it
+              return results
+            end
+          end
+        rescue ::Selenium::WebDriver::Error::TimeOutError => err
+          if options[:raise_on_error]
+            raise
+          end
+          if options[:return_errors]
+            results.map! { |result| result.nil? ? err : result }
+          end
+        end
+
+        return results
+      end
+
+      alias wait multiwait
+
+      private
+
+      def multiwait_filter_results(options, results)
+        if options[:wait_for] != :first
+          got_it = true
+          results.each do |result|
+            # rubocop:disable Style/Next
+            if result.nil? or
+               result.is_a?(::Selenium::WebDriver::Error::NoSuchElementError)
+              got_it = false
+              break
+            end
+            # rubocop:enable Style/Next
+          end
+          return got_it, results
+        end
+
+        # If we want to exit on the first found result, we'll have to go and
+        # find non-error results here.
+        results.each do |result|
+          if not result.nil? and
+             not result.is_a?(::Selenium::WebDriver::Error::NoSuchElementError)
+            return true, [result]
+          end
+        end
+
+        return false, []
+      end
+
+      ##
+      # Distinguishes between option hashes and selectors by detecting Hash
+      # arguments with keys from DEFAULT_OPTIONS. Those are considered to be
+      # options, and merged with any preceding option hashes, where latter
+      # occurrences overwrite earlier ones.
+      def multiwait_parse_options(*args)
+        # Sanity
+        if @multiwait_options.nil?
+          @multiwait_options = DEFAULT_OPTIONS
+        end
+
+        # Distinguish between options and selectors
+        options = {}
+        selectors = []
+        args.each do |arg|
+          # Let the underlying API handle all non-Hashes
+          if not arg.is_a?(Hash)
+            selectors << arg
+            next
+          end
+
+          # See if it contains any of the keys we care about
+          option_keys = DEFAULT_OPTIONS.keys
+          diff = option_keys - arg.keys
+          if diff != option_keys
+            options.merge!(arg)
+            next
+          end
+
+          selectors << arg
+        end
+        options = @multiwait_options.merge(options)
+        options = DEFAULT_OPTIONS.merge(options)
+
+        # Ensure that the 'wait_for' option contains correct
+        # values only.
+        if not [:all, :first].include?(options[:wait_for])
+          raise ArgumentError, ":wait_for option must be either :all or :first, "\
+            "but is: #{options[:wait_for]}"
+        end
+
+        # Ensure that 'check_element' contains only valid options.
+        elem_klass = ::Selenium::WebDriver::Element
+        if options[:check_element] != :exists? and
+           not elem_klass.instance_methods.include?(options[:check_element])
+          raise ArgumentError, ":check_element must either be :exists? or "\
+            "a boolean method that ::Selenium::WebDriver::Element responds to, "\
+            "but got: #{options[:check_element]}"
+        end
+
+        return options, selectors
+      end
+
+    end # module DriverModule
+  end # module MultiWait
+end # module Unobtainium
+
+::Unobtainium::Driver.register_module(
+    ::Unobtainium::MultiWait::DriverModule,
+    __FILE__)

data/lib/unobtainium-multiwait/version.rb

@@ -0,0 +1,14 @@
+# coding: utf-8
+#
+# unobtainium-multiwait
+# https://github.com/jfinkhaeuser/unobtainium-multiwait
+#
+# Copyright (c) 2016 Jens Finkhaeuser and other unobtainium-multiwait contributors.
+# All rights reserved.
+#
+module Unobtainium
+  module MultiWait
+    # The current release version
+    VERSION = "0.1.0".freeze
+  end # module MultiWait
+end # module Unobtainium

data/lib/unobtainium-multiwait.rb

@@ -0,0 +1,10 @@
+# coding: utf-8
+#
+# unobtainium-multiwait
+# https://github.com/jfinkhaeuser/unobtainium-multiwait
+#
+# Copyright (c) 2016 Jens Finkhaeuser and other unobtainium-multiwait contributors.
+# All rights reserved.
+#
+
+require 'unobtainium-multiwait/multiwait'

data/spec/data/foo.html

@@ -0,0 +1,15 @@
+<foo>
+  <bar>
+    <something>else</something></bar>
+  <hidden style="display: none"></hidden>
+  <appears id="appears" style="display: none">boo!</appears>
+  <appears-too-late id="late" style="display: none">aah!</appears-too-late>
+  <script>
+    setTimeout(function() {
+      document.getElementById("appears").style.display = "block";
+    }, 3000);
+    setTimeout(function() {
+      document.getElementById("late").style.display = "block";
+    }, 12000);
+  </script>
+<foo>

data/spec/module_spec.rb

@@ -0,0 +1,212 @@
+# coding: utf-8
+#
+# unobtainium-multiwait
+# https://github.com/jfinkhaeuser/unobtainium-multiwait
+#
+# Copyright (c) 2016 Jens Finkhaeuser and other unobtainium-multiwait contributors.
+# All rights reserved.
+#
+require 'spec_helper'
+
+require 'unobtainium'
+
+DRIVER = :headless
+# DRIVER = :firefox
+TEST_URL = 'file://' + Dir.pwd + '/spec/data/foo.html'
+
+class Tester
+  include ::Unobtainium::World
+end # class Tester
+
+describe 'Unobtainium::MultiWait::DriverModule' do
+  before :each do
+    @tester = Tester.new
+  end
+
+  describe "module interface" do
+    it "passes unobtainium's interface checks" do
+      expect do
+        require 'unobtainium-multiwait'
+      end.to_not raise_error(LoadError)
+    end
+
+    it "exposes wait methods" do
+      drv = @tester.driver(DRIVER)
+      expect(drv.respond_to?(:wait)).to be_truthy
+      expect(drv.respond_to?(:multiwait)).to be_truthy
+    end
+  end
+
+  describe "wait functionality" do
+    before do
+      require 'unobtainium-multiwait'
+    end
+
+    it "can wait for single element that already exists" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      drv.navigate.refresh
+      elem = drv.wait(xpath: '//foo/bar')
+      expect(elem).not_to be_nil
+      expect(elem).not_to be_empty
+      expect(elem.length).to eql 1
+      expect(elem[0]).not_to be_nil
+    end
+
+    it "can wait for multiple elements that already exist" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      drv.navigate.refresh
+      # rubocop:disable Style/BracesAroundHashParameters
+      elem = drv.wait({ xpath: '//foo/bar' },
+                      { xpath: '//something' })
+      # rubocop:enable Style/BracesAroundHashParameters
+      expect(elem).not_to be_nil
+      expect(elem).not_to be_empty
+      expect(elem.length).to eql 2
+      expect(elem[0]).not_to be_nil
+      expect(elem[1]).not_to be_nil
+    end
+
+    it "returns an element if it appears on time" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      drv.navigate.refresh
+      elem = drv.wait(xpath: '//foo/appears')
+      expect(elem).not_to be_nil
+      expect(elem).not_to be_empty
+      expect(elem.length).to eql 1
+      expect(elem[0]).not_to be_nil
+    end
+
+    it "times out when an element can't be found in time" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      drv.navigate.refresh
+      elem = drv.wait(xpath: '//foo/appears-too-late')
+      expect(elem).not_to be_nil
+      expect(elem).not_to be_empty
+      expect(elem.length).to eql 1
+      expect(elem[0]).to be_nil
+    end
+
+    it "returns all elements that can be found on time" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      drv.navigate.refresh
+      # rubocop:disable Style/BracesAroundHashParameters
+      elem = drv.wait({ xpath: '//foo/bar' },
+                      { xpath: '//foo/appears' },
+                      { xpath: '//foo/appears-too-late' })
+      # rubocop:enable Style/BracesAroundHashParameters
+      expect(elem).not_to be_nil
+      expect(elem).not_to be_empty
+      expect(elem.length).to eql 3
+      expect(elem[0]).not_to be_nil
+      expect(elem[1]).not_to be_nil
+      expect(elem[2]).to be_nil
+    end
+
+    it "returns the first found element if :wait_for == :first" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      drv.navigate.refresh
+      # rubocop:disable Style/BracesAroundHashParameters
+      elem = drv.wait({ xpath: '//foo/appears' },
+                      { xpath: '//foo/appears-too-late' },
+                      { wait_for: :first })
+      # rubocop:enable Style/BracesAroundHashParameters
+      expect(elem).not_to be_nil
+      expect(elem).not_to be_empty
+      expect(elem.length).to eql 1
+      expect(elem[0]).not_to be_nil
+    end
+
+    it "passes non-hash arguments without touching them" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      expect do
+        drv.wait(42) # not a valid selector for selenium
+      end.to raise_error
+    end
+  end
+
+  describe "wait options" do
+    before do
+      require 'unobtainium-multiwait'
+    end
+
+    it "can throw on errors" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      # rubocop:disable Style/BracesAroundHashParameters
+      expect do
+        drv.wait({ xpath: '//does-not-exist' },
+                 { xpath: '//foo' },
+                 { raise_on_error: true })
+      end.to raise_error(::Selenium::WebDriver::Error::TimeOutError)
+      # rubocop:enable Style/BracesAroundHashParameters
+    end
+
+    it "can return errors" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      # rubocop:disable Style/BracesAroundHashParameters
+      elems = drv.wait({ xpath: '//does-not-exist' },
+                       { xpath: '//foo' },
+                       { return_errors: true })
+      # rubocop:enable Style/BracesAroundHashParameters
+      expect(elems).not_to be_nil
+      expect(elems).not_to be_empty
+      expect(elems.length).to eql 2
+      expect(elems[0]).not_to be_nil
+      expect(elems[1]).not_to be_nil
+      is_error = elems[0].is_a?(
+       ::Selenium::WebDriver::Error::TimeOutError)
+      expect(is_error).to be_truthy
+    end
+
+    it "can honour instance options" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      drv.multiwait_options = { raise_on_error: true }
+      expect do
+        drv.wait(xpath: '//does-not-exist')
+      end.to raise_error(::Selenium::WebDriver::Error::TimeOutError)
+    end
+
+    it "validates :wait_for" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+
+      # Good option
+      drv.multiwait_options = { wait_for: :all }
+      expect do
+        drv.wait(xpath: '//foo')
+      end.not_to raise_error
+
+      # Bad option
+      drv.multiwait_options = { wait_for: :bad }
+      expect do
+        drv.wait(xpath: '//foo')
+      end.to raise_error
+    end
+
+    it "validates :check_element" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+
+      # Good option
+      drv.multiwait_options = { check_element: :exists? }
+      expect do
+        drv.wait(xpath: '//foo')
+      end.not_to raise_error
+
+      # Bad option
+      drv.multiwait_options = { check_element: :foobar }
+      expect do
+        drv.wait(xpath: '//foo')
+      end.to raise_error
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+# Only start CodeClimate from travis
+if ENV['CODECLIMATE_REPO_TOKEN']
+  require 'codeclimate-test-reporter'
+  CodeClimate::TestReporter.start
+end
+
+# Always start SimpleCov
+require 'simplecov'
+SimpleCov.start do
+  # add_filter 'unobtainium/drivers'
+end

data/unobtainium-multiwait.gemspec

@@ -0,0 +1,56 @@
+# coding: utf-8
+#
+# unobtainium-multiwait
+# https://github.com/jfinkhaeuser/unobtainium-multiwait
+#
+# Copyright (c) 2016 Jens Finkhaeuser and other unobtainium-multiwait contributors.
+# All rights reserved.
+#
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'unobtainium-multiwait/version'
+
+# rubocop:disable Style/UnneededPercentQ, Style/ExtraSpacing
+# rubocop:disable Style/SpaceAroundOperators
+Gem::Specification.new do |spec|
+  spec.name          = "unobtainium-multiwait"
+  spec.version       = Unobtainium::MultiWait::VERSION
+  spec.authors       = ["Jens Finkhaeuser"]
+  spec.email         = ["jens@finkhaeuser.de"]
+  spec.description   = %q(
+    This gem provides a driver module for unobtainium allowing for more easily
+    waiting for (one of) multiple elements to change state.
+
+    It is based on the unobtainium-multifind gem.
+  )
+  spec.summary       = %q(
+    This gem provides a driver module for unobtainium allowing for more easily
+    waiting for (one of) multiple elements to change state.
+  )
+  spec.homepage      = "https://github.com/jfinkhaeuser/unobtainium-multiwait"
+  spec.license       = "MITNFA"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = '>= 2.0'
+
+  spec.requirements  = "Unobtainium driver implementing the Selenium API"
+
+  spec.add_development_dependency "bundler", "~> 1.12"
+  spec.add_development_dependency "rubocop", "~> 0.39"
+  spec.add_development_dependency "rake", "~> 11.1"
+  spec.add_development_dependency "rspec", "~> 3.4"
+  spec.add_development_dependency "simplecov", "~> 0.11"
+  spec.add_development_dependency "yard", "~> 0.8"
+  spec.add_development_dependency "selenium-webdriver"
+  spec.add_development_dependency "phantomjs"
+
+  spec.add_dependency "unobtainium", "~> 0.5"
+  spec.add_dependency "unobtainium-multifind", "~> 0.2"
+end
+# rubocop:enable Style/SpaceAroundOperators
+# rubocop:enable Style/UnneededPercentQ, Style/ExtraSpacing

metadata

@@ -0,0 +1,209 @@
+--- !ruby/object:Gem::Specification
+name: unobtainium-multiwait
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jens Finkhaeuser
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-05-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.39'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.39'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: selenium-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: phantomjs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: unobtainium
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: unobtainium-multifind
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: "\n    This gem provides a driver module for unobtainium allowing for
+  more easily\n    waiting for (one of) multiple elements to change state.\n\n    It
+  is based on the unobtainium-multifind gem.\n  "
+email:
+- jens@finkhaeuser.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".codeclimate.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/unobtainium-multiwait.rb
+- lib/unobtainium-multiwait/multiwait.rb
+- lib/unobtainium-multiwait/version.rb
+- spec/data/foo.html
+- spec/module_spec.rb
+- spec/spec_helper.rb
+- unobtainium-multiwait.gemspec
+homepage: https://github.com/jfinkhaeuser/unobtainium-multiwait
+licenses:
+- MITNFA
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- Unobtainium driver implementing the Selenium API
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: This gem provides a driver module for unobtainium allowing for more easily
+  waiting for (one of) multiple elements to change state.
+test_files:
+- spec/data/foo.html
+- spec/module_spec.rb
+- spec/spec_helper.rb
+has_rdoc: