unobtainium-multifind 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b372724a026239958b189cca8eef2da19be56b32
+  data.tar.gz: 09e80f23d67eaa9038944a0d9b85eae6a04609c6
+SHA512:
+  metadata.gz: c593de1984c2fd92e32379caf34104037fd249c7349c590c60df58042b349d5e67577977146ad1e85d4bd7e036e9a7d7b74897f6d49f3b92f93ae0729e10ad3d
+  data.tar.gz: 008eb7a5e629f1cf95113287c18f60d861af673e68bc17c4a00665d8eae0595cccc0542d30987e4563b33f7204f830d69c581795d1d850d0291e6eb77e5a5a43

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: 89d15fbb64d0d6ed4ecc68d5fe9482efdccd047eb5a6b0266434d683115b848c

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,78 @@
+PATH
+  remote: .
+  specs:
+    unobtainium-multifind (0.1.0)
+      unobtainium (~> 0.5)
+
+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)
+    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-multifind!
+  yard (~> 0.8)
+
+BUNDLED WITH
+   1.12.1

data/LICENSE

@@ -0,0 +1,30 @@
+Copyright (c) Jens Finkhaeuser (http://finkhaeuser.de/) and other
+unobtainium-multifind 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,27 @@
+# unobtainium-multifind
+
+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-multifind.svg)](https://badge.fury.io/rb/unobtainium-multifind)
+[![Build status](https://travis-ci.org/jfinkhaeuser/unobtainium-multifind.svg?branch=master)](https://travis-ci.org/jfinkhaeuser/unobtainium-multifind)
+[![Code Climate](https://codeclimate.com/github/jfinkhaeuser/unobtainium-multifind/badges/gpa.svg)](https://codeclimate.com/github/jfinkhaeuser/unobtainium-multifind)
+[![Test Coverage](https://codeclimate.com/github/jfinkhaeuser/unobtainium-multifind/badges/coverage.svg)](https://codeclimate.com/github/jfinkhaeuser/unobtainium-multifind/coverage)
+
+To use it, require it after requiring unobtainium, then create the any driver
+with a Selenium API:
+
+```ruby
+require 'unobtainium'
+require 'unobtainium-multifind'
+
+include Unobtainium::World
+
+driver.navigate.to('http://finkhaeuser.de')
+
+elems = driver.multifind({ xpath: '//some-element' },
+                         { xpath: '//other-element' })
+
+# Entries will be nil if nothing is found by this xpath
+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-multifind.rb

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

data/lib/unobtainium-multifind/multifind.rb

@@ -0,0 +1,160 @@
+# coding: utf-8
+#
+# unobtainium-multifind
+# https://github.com/jfinkhaeuser/unobtainium-multifind
+#
+# Copyright (c) 2016 Jens Finkhaeuser and other unobtainium-multifind contributors.
+# All rights reserved.
+#
+
+require 'unobtainium'
+
+module Unobtainium
+  ##
+  # MultiFind namespace
+  module MultiFind
+    ##
+    # Driver module implementing multi find functionality.
+    module DriverModule
+
+      ##
+      # Default options. This hash is also used to detect if any of the Hashes
+      # passed to #multifind 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, all results are returned.
+        # If :first is specified, the first non-error result is
+        #   returned.
+        # If :last is specified, the last non-error result is
+        #   returned.
+        find: :all,
+      }.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 multifind
+      attr_accessor :multifind_options
+      @multifind_options = DEFAULT_OPTIONS
+
+      def multifind(*args)
+        # Parse options
+        options, selectors = multifind_parse_options(*args)
+
+        # Now find elements
+        results = []
+        selectors.each do |selector|
+          begin
+            results << find_element(selector)
+          rescue ::Selenium::WebDriver::Error::NoSuchElementError => err
+            if options[:raise_on_error]
+              raise
+            end
+            if options[:return_errors]
+              results << err
+              next
+            end
+            results << nil
+          end
+        end
+
+        # Filter results, if necessary
+        return multifind_filter_results(options, results)
+      end
+
+      alias find multifind
+
+      private
+
+      ##
+      # 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 multifind_parse_options(*args)
+        # Sanity
+        if @multifind_options.nil?
+          @multifind_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 = @multifind_options.merge(options)
+        options = DEFAULT_OPTIONS.merge(options)
+
+        # Ensure that the 'find' option contains correct
+        # values only.
+        if not [:all, :first, :last].include?(options[:find])
+          raise ArgumentError, ":find option must be one of :all, :first or "\
+            ":last, but is: #{options[:find]}"
+        end
+
+        return options, selectors
+      end
+
+      ##
+      # Filters results from multifind; this largely means honouring the
+      # :find option.
+      def multifind_filter_results(options, results)
+        # That was easy!
+        if options[:find] == :all
+          return results
+        end
+
+        # Filtering :first and :last is identical, except we go backwards
+        # through the results array for :last.
+        if options[:find] == :last
+          results.reverse!
+        end
+
+        # We now return the first non-nil, non-error result
+        results.each do |result|
+          if result.nil?
+            next
+          end
+          if result.is_a?(::Selenium::WebDriver::Error::NoSuchElementError)
+            next
+          end
+          return [result]
+        end
+
+        # If we're here then we have no results, but want :first
+        # or :last. An empty result is appropriate.
+        return []
+      end
+    end # module DriverModule
+  end # module MultiFind
+end # module Unobtainium
+
+::Unobtainium::Driver.register_module(
+    ::Unobtainium::MultiFind::DriverModule,
+    __FILE__)

data/lib/unobtainium-multifind/version.rb

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

data/spec/data/foo.html

@@ -0,0 +1,4 @@
+<foo>
+  <bar>
+    <something>else</something>
+<foo>

data/spec/module_spec.rb

@@ -0,0 +1,216 @@
+# coding: utf-8
+#
+# unobtainium-multifind
+# https://github.com/jfinkhaeuser/unobtainium-multifind
+#
+# Copyright (c) 2016 Jens Finkhaeuser and other unobtainium-multifind 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::MultiFind::DriverModule' do
+  before :each do
+    @tester = Tester.new
+  end
+
+  describe "module interface" do
+    it "passes unobtainium's interface checks" do
+      expect do
+        require 'unobtainium-multifind'
+      end.to_not raise_error(LoadError)
+    end
+
+    it "exposes find methods" do
+      drv = @tester.driver(DRIVER)
+      expect(drv.respond_to?(:find)).to be_truthy
+      expect(drv.respond_to?(:multifind)).to be_truthy
+    end
+  end
+
+  describe "find functionality" do
+    it "can find a single element" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      elem = drv.find(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 find multiple elements" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      # rubocop:disable Style/BracesAroundHashParameters
+      elem = drv.find({ 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 nil for elements not found" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      # rubocop:disable Style/BracesAroundHashParameters
+      elem = drv.find({ xpath: '//does-not-exist' },
+                      { xpath: '//foo' })
+      # 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]).to be_nil
+      expect(elem[1]).not_to be_nil
+    end
+
+    it "can return only the first element" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+
+      # rubocop:disable Style/BracesAroundHashParameters
+      elem = drv.find({ xpath: '//foo/bar' },
+                      { xpath: '//something' },
+                      { find: :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 "can return only the last element" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+
+      # rubocop:disable Style/BracesAroundHashParameters
+      elem = drv.find({ xpath: '//foo/bar' },
+                      { xpath: '//something' },
+                      { find: :last })
+      # 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 "can return only the last non-error element when nil is returned" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+
+      # rubocop:disable Style/BracesAroundHashParameters
+      elem = drv.find({ xpath: '//foo/bar' },
+                      { xpath: '//does-not-exist' },
+                      { find: :last })
+      # 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 "can return only the last non-error element when errors are returned" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+
+      # rubocop:disable Style/BracesAroundHashParameters
+      elem = drv.find({ xpath: '//foo/bar' },
+                      { xpath: '//does-not-exist' },
+                      { find: :last, return_errors: true })
+      # 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 "can return empty when no matches are found with :first" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+
+      # rubocop:disable Style/BracesAroundHashParameters
+      elem = drv.find({ xpath: '//does-not-exist' },
+                      { find: :first })
+      # rubocop:enable Style/BracesAroundHashParameters
+      expect(elem).not_to be_nil
+      expect(elem).to be_empty
+    end
+
+    it "passes non-hash arguments without touching them" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      expect do
+        drv.find(42) # not a valid selector for selenium
+      end.to raise_error
+    end
+  end
+
+  describe "find options" do
+    it "can throw on errors" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      # rubocop:disable Style/BracesAroundHashParameters
+      expect do
+        drv.find({ xpath: '//does-not-exist' },
+                 { xpath: '//foo' },
+                 { raise_on_error: true })
+      end.to raise_error(::Selenium::WebDriver::Error::NoSuchElementError)
+      # 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.find({ 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::NoSuchElementError)
+      expect(is_error).to be_truthy
+    end
+
+    it "can honour instance options" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+      drv.multifind_options = { raise_on_error: true }
+      expect do
+        drv.find(xpath: '//does-not-exist')
+      end.to raise_error(::Selenium::WebDriver::Error::NoSuchElementError)
+    end
+
+    it "validates :find" do
+      drv = @tester.driver(DRIVER)
+      drv.navigate.to(TEST_URL)
+
+      # Good option
+      drv.multifind_options = { find: :all }
+      expect do
+        drv.find(xpath: '//foo')
+      end.not_to raise_error
+
+      # Bad option
+      drv.multifind_options = { find: :bad }
+      expect do
+        drv.find(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-multifind.gemspec

@@ -0,0 +1,56 @@
+# coding: utf-8
+#
+# unobtainium-multifind
+# https://github.com/jfinkhaeuser/unobtainium-multifind
+#
+# Copyright (c) 2016 Jens Finkhaeuser and other unobtainium-multifind contributors.
+# All rights reserved.
+#
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'unobtainium-multifind/version'
+
+# rubocop:disable Style/UnneededPercentQ, Style/ExtraSpacing
+# rubocop:disable Style/SpaceAroundOperators
+Gem::Specification.new do |spec|
+  spec.name          = "unobtainium-multifind"
+  spec.version       = Unobtainium::MultiFind::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
+    finding (one of) multiple elements.
+
+    It requires a driver implementing the Selenium API, specifically the
+    #find_element method.
+  )
+  spec.summary       = %q(
+    This gem provides a driver module for unobtainium allowing for more easily
+    finding (one of) multiple elements.
+  )
+  spec.homepage      = "https://github.com/jfinkhaeuser/unobtainium-multifind"
+  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"
+end
+# rubocop:enable Style/SpaceAroundOperators
+# rubocop:enable Style/UnneededPercentQ, Style/ExtraSpacing

metadata

@@ -0,0 +1,195 @@
+--- !ruby/object:Gem::Specification
+name: unobtainium-multifind
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jens Finkhaeuser
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-05-04 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'
+description: "\n    This gem provides a driver module for unobtainium allowing for
+  more easily\n    finding (one of) multiple elements.\n\n    It requires a driver
+  implementing the Selenium API, specifically the\n    #find_element method.\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-multifind.rb
+- lib/unobtainium-multifind/multifind.rb
+- lib/unobtainium-multifind/version.rb
+- spec/data/foo.html
+- spec/module_spec.rb
+- spec/spec_helper.rb
+- unobtainium-multifind.gemspec
+homepage: https://github.com/jfinkhaeuser/unobtainium-multifind
+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
+  finding (one of) multiple elements.
+test_files:
+- spec/data/foo.html
+- spec/module_spec.rb
+- spec/spec_helper.rb
+has_rdoc: