rlicker 1.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NDcyY2FkODQ2NzRkYjZjZTRhOGRhY2FkZTI3ZDQyOGU0YjExN2YwOQ==
+  data.tar.gz: !binary |-
+    MGM1YjlmMDQyMWY1YTRkYjE1ZDA3YWQxNmNmOGI1M2M2ZDZhMjY5OA==
+SHA512:
+  metadata.gz: !binary |-
+    Y2ViZWEwYTU5MDUwNmQwMGUwZDgwMWRiOTQwYWEzOWRlZDdkZWNhMjEwNmFm
+    YWQ0ZTdkMTAwYmFjNmYxZDgxYTNmNGFkYzRjYTg5YTMzMDlkMmNkZDhkZjVj
+    NzgzYzA0Mzk2YTA4OGVmZGVlZWQzNDFhNjI4NjRjMjk5YTg4Yjc=
+  data.tar.gz: !binary |-
+    MzYyMWFhYjQ4ZmJjNTZhMzBiZmJhMGIxMTg5ZjljMzI3N2U5MWU0MzVmODVm
+    ZTE0YTViZWNiYzQxMjZhMjVjMmIwM2JjMzI1YzJmMzdmODM5ZDRlOWJjM2M1
+    YzY4YjA0ZTc5MmJlMzMzNGVjOTA2ZTA3NTBhMjRjZjYyOTBlMzQ=

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+branches:
+  only:
+    - master
+gemfile: Gemfile
+notifications:
+  recipients:
+    - ben.biddington@gmail.com
+before_script:
+  - "export DISPLAY=:99.0"
+  - "sh -e /etc/init.d/xvfb start"

data/Gemfile

@@ -0,0 +1,19 @@
+source "https://rubygems.org" 
+
+group :development do
+  gem "bundler", "~> 1.0"
+  gem "jeweler", "~> 1.8.7"
+end
+
+gem "sauce"
+gem "sauce-connect"
+gem "audible"
+gem "watir-webdriver"
+gem "capybara"
+gem "capybara-webkit", "0.14.2"
+
+group :test do
+  gem "rake"
+  gem "rspec"
+  gem "travis-lint"
+end

data/Gemfile.lock

@@ -0,0 +1,131 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (3.2.1)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    addressable (2.3.5)
+    audible (0.1.0)
+    builder (3.2.2)
+    capybara (2.2.0)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      xpath (~> 2.0)
+    capybara-webkit (0.14.2)
+      capybara (~> 2.0, >= 2.0.2)
+      json
+    childprocess (0.3.9)
+      ffi (~> 1.0, >= 1.0.11)
+    cmdparse (2.0.5)
+    diff-lcs (1.1.3)
+    faraday (0.8.8)
+      multipart-post (~> 1.2.0)
+    ffi (1.9.3)
+    git (1.2.6)
+    github_api (0.10.1)
+      addressable
+      faraday (~> 0.8.1)
+      hashie (>= 1.2)
+      multi_json (~> 1.4)
+      nokogiri (~> 1.5.2)
+      oauth2
+    hashie (2.0.5)
+    hashr (0.0.19)
+    highline (1.6.19)
+    httpauth (0.2.0)
+    i18n (0.6.0)
+    jeweler (1.8.8)
+      builder
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      github_api (= 0.10.1)
+      highline (>= 1.6.15)
+      nokogiri (= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (0.1.8)
+      multi_json (>= 1.5)
+    mime-types (2.0)
+    multi_json (1.8.2)
+    multi_xml (0.5.5)
+    multipart-post (1.2.0)
+    net-http-persistent (2.9)
+    net-ssh (2.7.0)
+    net-ssh-gateway (1.2.0)
+      net-ssh (>= 2.6.5)
+    nokogiri (1.5.10)
+    oauth2 (0.9.2)
+      faraday (~> 0.8)
+      httpauth (~> 0.2)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    parallel (0.8.2)
+    parallel_tests (0.15.0)
+      parallel
+    rack (1.5.2)
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rake (0.9.2.2)
+    rdoc (4.0.1)
+      json (~> 1.4)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    rubyzip (1.0.0)
+    sauce (3.1.3)
+      childprocess (>= 0.1.6)
+      cmdparse (>= 2.0.2)
+      highline (>= 1.5.0)
+      json (>= 1.2.0)
+      net-http-persistent
+      net-ssh
+      net-ssh-gateway
+      parallel_tests (= 0.15.0)
+      rest-client
+      sauce_whisk (~> 0.0.8)
+      selenium-webdriver (>= 0.1.2)
+    sauce-connect (3.1.0)
+      sauce (~> 3.1)
+    sauce_whisk (0.0.10)
+      rest-client
+    selenium-webdriver (2.37.0)
+      childprocess (>= 0.2.5)
+      multi_json (~> 1.0)
+      rubyzip (~> 1.0.0)
+      websocket (~> 1.0.4)
+    travis-lint (1.0.0)
+      activesupport (~> 3.2.0)
+      hashr (>= 0.0.19)
+    watir-webdriver (0.6.4)
+      selenium-webdriver (>= 2.18.0)
+    websocket (1.0.7)
+    xpath (2.0.0)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  audible
+  bundler (~> 1.0)
+  capybara
+  capybara-webkit (= 0.14.2)
+  jeweler (~> 1.8.7)
+  rake
+  rspec
+  sauce
+  sauce-connect
+  travis-lint
+  watir-webdriver

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Ben Biddington
+
+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.
+
+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,12 @@
+# RLicker
+[![Build Status](https://secure.travis-ci.org/ben-biddington/rlicker.png)](http://travis-ci.org/ben-biddington/rlicker)
+
+Why should I have to subscribe to one particular browser driver? Each seems to have incompatible DSLs and different ideas about abstraction. Changing from one to the other is a non-trivial exercise. 
+
+RLicker aims to perform a kind of [dependency inversion](http://www.objectmentor.com/resources/articles/Principles_and_Patterns.pdf), providing an abstraction to program against, enabling the implementation to be switched easily -- even at runtime. 
+
+I am starting with [capybara webkit](https://github.com/thoughtbot/capybara-webkit) as a reference implementation because it rules.
+
+# References
+* [Continuous Delivery](http://martinfowler.com/books.html#continuousDelivery)
+* [GOOS](http://www.growing-object-oriented-software.com)

data/README.rdoc

@@ -0,0 +1,19 @@
+= rlicker
+
+Description goes here.
+
+== Contributing to rlicker
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2013 Ben Biddington. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,40 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  gem.name = "rlicker"
+  gem.homepage = "http://github.com/ben-biddington/rlicker"
+  gem.license = "MIT"
+  gem.summary = %Q{}
+  gem.description = %Q{}
+  gem.email = "ben.biddington@gmail.com"
+  gem.authors = ["Ben Biddington"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core/rake_task'
+
+task :default => :ci
+
+desc "Run all tests"
+RSpec::Core::RakeTask.new
+
+desc "Run just the tests suitable for CI"
+RSpec::Core::RakeTask.new do |t|
+  t.name = :ci
+  t.pattern = "spec/integration/capybara_webkit_spec.rb"
+end

data/VERSION

@@ -0,0 +1 @@
+1.1.0

data/lib/rlicker.rb

@@ -0,0 +1,5 @@
+lib = File.expand_path(File.join(File.dirname(__FILE__), "rlicker"))
+
+$:.unshift lib
+
+Dir.glob(File.join(lib, "**", "*.rb")).each {|file| require file}

data/lib/rlicker/capybara_webkit_licker.rb

@@ -0,0 +1,36 @@
+module RLicker
+  module Lickers
+    class CapybaraWebkitLicker
+      def initialize
+        require "capybara-webkit"
+        connection = Capybara::Webkit::Connection.new       
+        @browser = Capybara::Webkit::Driver.new Capybara::Webkit::Browser.new connection 
+      end
+
+      def goto(earl)
+        @browser.visit earl
+      end
+      
+      def url; @browser.current_url; end
+      def close; end
+      
+      def find_by_id(id)
+        find :id => id
+      end
+
+      def find(selector = {})
+        attribute_name = selector.keys.first
+        attribute_value = selector[attribute_name]
+        @browser.find("//*[@#{attribute_name}='#{attribute_value}']").first
+      end
+
+      def evaluate_script(what)
+        @browser.evaluate_script what 
+      end
+
+      def execute_script(what)
+        @browser.execute_script what 
+      end
+    end
+  end
+end

data/lib/rlicker/chrome_licker.rb

@@ -0,0 +1,83 @@
+module RLicker
+  module Lickers
+    class ChromeLicker
+      require "audible"; include Audible
+
+      def visit(earl)
+        browser.goto ChromeEarl.new(earl).to_s
+      end
+  
+      alias :goto :visit
+    
+      def find_by_id(id)
+        find(:id => id)
+      end
+
+      def find(selector = {})
+        return nil if selector.empty?
+
+        attribute_name = selector.keys.first
+        attribute_value = selector[attribute_name]
+        
+        all.each do |tag_name|
+          begin
+            found_thing = browser.send(tag_name, selector)
+            return found_thing if found_thing && found_thing.exists?
+          rescue Watir::Exception::UnknownObjectException => e
+            
+          end
+        end
+        
+        fail "Could not locate an element with selector <#{selector}>. Searched elements #{all.inspect}."
+      end
+
+      def screenshot; fail "Not supported."; end
+
+      def close; @browser.close if @browser; end
+
+      def evaluate_script(what)
+        execute_script what
+      end
+
+      def execute_script(what)
+        browser.execute_script "javascript:#{what}"
+      end
+      
+      def url; browser.url; end
+    
+      private
+    
+      def browser
+        require 'watir-webdriver'
+        
+        @browser ||= new_browser
+      end 
+    
+      def new_browser
+        #See: http://chromedriver.storage.googleapis.com/index.html for chromedriver executable
+        @browser = Watir::Browser.new :chrome
+      end
+
+      def all
+        [:text_field, :button, :form, :link, :div, :span, :h1, :h2, :h3, :h4, :h5, :input, :password]
+      end
+    end
+
+    class ChromeEarl
+      def initialize(value)
+        @value = value
+      end
+
+      def to_s
+        return "file://#{@value}" unless starts_with_scheme
+        @value
+      end
+
+      private
+
+      def starts_with_scheme
+        @value.start_with? "http"
+      end
+    end
+  end
+end

data/lib/rlicker/sauce_labs_licker.rb

@@ -0,0 +1,75 @@
+module RLicker
+  module Lickers
+    class SauceLabsSettings
+      class << self
+        def username; setting_called "sauce_labs_username"; end
+        def access_key; setting_called "sauce_labs_accesskey"; end
+        def job_name; setting_called "sauce_labs_job_name"; end
+
+        private
+
+        def setting_called(name)
+          ENV[name].tap{fail "You must supply the <#{name}> environment variable." unless exists?(name)}
+        end
+
+        def exists?(name) ENV.include? name; end
+      end
+    end
+
+    # For config: https://github.com/saucelabs/sauce_ruby/wiki/Configuration----The-(in)Complete-Guide
+    class SauceLabsLicker
+      require "audible"; include Audible
+
+      def initialize
+        require "capybara"
+        require "sauce/capybara"
+
+        ENV["SAUCE_USERNAME"]   = SauceLabsSettings.username
+        ENV["SAUCE_ACCESS_KEY"] = SauceLabsSettings.access_key
+
+        Sauce.config do |c|
+          c[:job_name] = SauceLabsSettings.job_name
+          c[:start_local_application] = false
+          c[:browser] = "Chrome"
+          c[:browser_version] = nil
+          c[:record_screenshots] = false
+          c[:command_timeout] = 15
+          c[:max_duration] = 300
+        end
+
+        Capybara.default_driver = :sauce
+
+        notify :initialized, Sauce.get_config.opts 
+      end
+
+      def find_by_id(id)
+        find(:id => id)
+      end
+
+      def find(selector = {})
+        attribute_name = selector.keys.first
+        attribute_value = selector[attribute_name]
+        
+        driver.find(:xpath, "//*[@#{attribute_name}='#{attribute_value}']")
+      end
+
+      def goto(earl); driver.visit earl; end
+      
+      def close; end
+  
+      def status_code; driver.status_code; end
+
+      def url; driver.current_url; end
+
+      def evaluate_script(script); driver.evaluate_script script; end
+  
+      def execute_script(script); driver.execute_script script; end
+
+      def body; driver.body; end
+
+      private
+
+      def driver; Capybara.current_session; end
+    end
+  end
+end

data/rlicker.gemspec

@@ -0,0 +1,83 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: rlicker 1.1.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "rlicker"
+  s.version = "1.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors = ["Ben Biddington"]
+  s.date = "2015-01-28"
+  s.description = ""
+  s.email = "ben.biddington@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".travis.yml",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/rlicker.rb",
+    "lib/rlicker/capybara_webkit_licker.rb",
+    "lib/rlicker/chrome_licker.rb",
+    "lib/rlicker/sauce_labs_licker.rb",
+    "rlicker.gemspec",
+    "spec/integration/capybara_webkit_spec.rb",
+    "spec/integration/chrome_licker_spec.rb",
+    "spec/integration/given.rb",
+    "spec/integration/samples/.gitkeep",
+    "spec/integration/sauce_labs_spec.rb",
+    "spec/integration/shared_examples/window_licker.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/ben-biddington/rlicker"
+  s.licenses = ["MIT"]
+  s.rubygems_version = "2.4.3"
+  s.summary = ""
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<sauce>, [">= 0"])
+      s.add_runtime_dependency(%q<sauce-connect>, [">= 0"])
+      s.add_runtime_dependency(%q<audible>, [">= 0"])
+      s.add_runtime_dependency(%q<watir-webdriver>, [">= 0"])
+      s.add_runtime_dependency(%q<capybara>, [">= 0"])
+      s.add_runtime_dependency(%q<capybara-webkit>, ["= 0.14.2"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.7"])
+    else
+      s.add_dependency(%q<sauce>, [">= 0"])
+      s.add_dependency(%q<sauce-connect>, [">= 0"])
+      s.add_dependency(%q<audible>, [">= 0"])
+      s.add_dependency(%q<watir-webdriver>, [">= 0"])
+      s.add_dependency(%q<capybara>, [">= 0"])
+      s.add_dependency(%q<capybara-webkit>, ["= 0.14.2"])
+      s.add_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
+    end
+  else
+    s.add_dependency(%q<sauce>, [">= 0"])
+    s.add_dependency(%q<sauce-connect>, [">= 0"])
+    s.add_dependency(%q<audible>, [">= 0"])
+    s.add_dependency(%q<watir-webdriver>, [">= 0"])
+    s.add_dependency(%q<capybara>, [">= 0"])
+    s.add_dependency(%q<capybara-webkit>, ["= 0.14.2"])
+    s.add_dependency(%q<bundler>, ["~> 1.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
+  end
+end
+

data/spec/integration/capybara_webkit_spec.rb

@@ -0,0 +1,8 @@
+require "spec_helper"
+require "integration/shared_examples/window_licker"
+
+describe "The capybara-webkit implementation" do
+  let(:licker) { RLicker::Lickers::CapybaraWebkitLicker.new }
+  it_behaves_like "a window licker"
+  it_behaves_like "a window licker that can locate elements"
+end

data/spec/integration/chrome_licker_spec.rb

@@ -0,0 +1,26 @@
+require "spec_helper"
+require "integration/shared_examples/window_licker"
+
+describe "The chrome implementation" do
+  include Given
+  let(:licker) { RLicker::Lickers::ChromeLicker.new }
+  it_behaves_like "a window licker"
+  it_behaves_like "a window licker that can locate elements"
+
+  it "when there are two elements with the same tag name and id it only returns one of them" do
+    earl = File.expand_path File.join(".", "spec/integration/samples/licker_test.html")
+    
+    given earl => <<-HTML
+      <div id="a">An element with id "a"</div>
+      <div id="a">Another element with id "a"</div>
+    HTML
+
+    licker.goto earl
+    
+    licker.find_by_id("a").text.must === "An element with id \"a\""
+  end
+
+  after do
+    licker.close
+  end
+end

data/spec/integration/given.rb

@@ -0,0 +1,7 @@
+module Given
+  def given(name_and_value)
+    File.open(File.expand_path(name_and_value.keys.first),"w+") do |file|
+      file.puts name_and_value[name_and_value.keys.first]
+    end
+  end
+end

data/spec/integration/sauce_labs_spec.rb

@@ -0,0 +1,24 @@
+require "spec_helper"
+require "integration/shared_examples/window_licker"
+
+describe "The saucelabs implementation" do
+  let(:licker) { RLicker::Lickers::SauceLabsLicker.new }
+
+  it_behaves_like "a window licker that can execute javascript"
+
+  it "handles multiples with the same id by returning the first" do
+    licker.goto "https://login.xero.com"
+    licker.find_by_id("email").must_not be_an Array
+    licker.find_by_id("email").must_not be_nil
+  end
+
+  it "can find elements by other attributes like class for example" do
+    licker.goto "https://login.xero.com/"
+    licker.find(:href => "http://www.xero.com/about/").must_not be_nil
+  end
+
+  it "returns things that are clickable" do
+    licker.goto "https://login.xero.com/"
+    licker.find(:href => "http://www.xero.com/about/").must respond_to :click
+  end
+end

data/spec/integration/shared_examples/window_licker.rb

@@ -0,0 +1,90 @@
+require "spec_helper"
+require "integration/given"
+
+include RLicker
+
+shared_examples_for "a window licker that can execute javascript" do
+  it "can EXECUTE javascript with a return statement" do
+    earl = "https://www.google.com/"
+
+    licker.goto earl
+
+    result = licker.execute_script "return document.title"
+    
+    result.must match /Google/
+  end
+
+  it "can EVALUATE javascript" do
+    earl = "https://www.google.com/"
+
+    licker.goto earl
+
+    result = licker.evaluate_script "document.title"
+
+    result.must match /Google/
+  end
+end
+
+shared_examples_for "a window licker that can locate elements" do
+  include Given
+
+  let(:earl) do
+    File.expand_path File.join(".", "spec/integration/samples/licker_test.html")
+  end
+  
+  it "can locate an element by id" do
+    given earl => <<-HTML
+      <div id="phils-bike-seat"></div>
+    HTML
+      
+    licker.goto earl
+    licker.find_by_id("phils-bike-seat").must_not be_nil
+  end
+
+  it "returns things that are clickable" do
+    given earl => <<-HTML
+      <button id="phils-bike-seat"></button>
+    HTML
+  
+    licker.goto earl
+    licker.find_by_id("phils-bike-seat").click
+  end
+  
+  it "can locate elements by other attributes like href for example" do
+    given earl => <<-HTML
+      <div id="one">
+        <a href="http://example.com"></a>
+      </div>
+    HTML
+      
+    licker.goto earl
+    licker.find(:href => "http://example.com").must_not be_nil
+  end
+
+  it "can locate my regex matching attribute values"
+  it "returns nil when attribute does not exist"
+
+  it "when multiple elements have the same id it returns the first one" do
+    given earl => <<-HTML
+      <div id="phils-bike-seat"></div>
+      <span id="phils-bike-seat"></span>
+    HTML
+      
+    licker.goto earl
+    licker.find_by_id("phils-bike-seat").must_not be_an Array
+  end
+end
+
+shared_examples_for "a window licker" do 
+  include Given
+
+  let(:earl) do
+    File.expand_path File.join(".", "spec/integration/samples/licker_test.html")
+  end
+
+  it "can open an earl" do
+    given earl => ""
+
+    lambda{licker.goto "spec/integration/samples/licker_test.html"}.must_not raise_error
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require "rspec"
+
+Object.class_eval do
+  alias :must :should 
+  alias :must_not :should_not 
+end
+
+require "rlicker"

metadata

@@ -0,0 +1,185 @@
+--- !ruby/object:Gem::Specification
+name: rlicker
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+platform: ruby
+authors:
+- Ben Biddington
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-01-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sauce
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sauce-connect
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: audible
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: watir-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: capybara-webkit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: !binary |-
+          MC4xNC4y
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: !binary |-
+          MC4xNC4y
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: !binary |-
+          MS4w
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: !binary |-
+          MS4w
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: !binary |-
+          MS44Ljc=
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: !binary |-
+          MS44Ljc=
+description: ''
+email: ben.biddington@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+- README.rdoc
+files:
+- .document
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/rlicker.rb
+- lib/rlicker/capybara_webkit_licker.rb
+- lib/rlicker/chrome_licker.rb
+- lib/rlicker/sauce_labs_licker.rb
+- rlicker.gemspec
+- spec/integration/capybara_webkit_spec.rb
+- spec/integration/chrome_licker_spec.rb
+- spec/integration/given.rb
+- spec/integration/samples/.gitkeep
+- spec/integration/sauce_labs_spec.rb
+- spec/integration/shared_examples/window_licker.rb
+- spec/spec_helper.rb
+homepage: http://github.com/ben-biddington/rlicker
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.3
+signing_key: 
+specification_version: 4
+summary: ''
+test_files: []