watir-rspec 0.0.3 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: bbbc8f72cbcb8c30d1ae8d802de384282a811d42
+  data.tar.gz: 1b4866fceef13da65071c510b0363b26851599f6
+SHA512:
+  metadata.gz: 586f19b53415d428a7261704d4e4d8932dc7fe1c91ecdde8029a2402e0cfcce22218e928aa59a2ecf23dcc793ce6be506faad23d2293486b8fa19b5596f20199
+  data.tar.gz: 7ab92d211d77365d18218a8be6fd73cbf8663e3f1b103497ed9dd518aab0e89eea4ecc8ded1175ae58d9602b250c7570ffddabf39e9f33bcb85bcd0ec66faed5

data/.travis.yml

@@ -0,0 +1,11 @@
+rvm:
+ - 1.9.3
+ - 2.0.0
+ - ruby-head
+notifications:
+  recipients:
+    - jarmo.p@gmail.com
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+

data/CHANGES

@@ -0,0 +1,5 @@
+# 1.0.0 - 2013/09/21
+
+* add installation binary watir-rspec for easier installation of the gem
+* many internal changes
+* README revamp

data/Gemfile

@@ -1,3 +1,5 @@
 source 'https://rubygems.org'
 
 gemspec
+
+gem 'coveralls', require: false

data/README.md

@@ -1,7 +1,16 @@
 # Watir::RSpec
+[![Gem Version](https://badge.fury.io/rb/test-page.png)](http://badge.fury.io/rb/watir-rspec)
+[![Build Status](https://api.travis-ci.org/watir/watir-rspec.png)](http://travis-ci.org/watir/watir-rspec)
+[![Coverage](https://coveralls.io/repos/watir/watir-rspec/badge.png?branch=master)](https://coveralls.io/r/watir/watir-rspec)
 
 Use [Watir](http://watir.com) with [RSpec](http://rspec.info) with ease.
 
+* No need to use the `@browser` or `$browser` variables when executing browser methods.
+* No need to open the browser in your each test manually.
+* Easily test for asynchronous events by using `#within` matchers.
+* Easily test that something stays the same within some period by using `#during` matchers.
+* Get nice html reports with links to html, screenshots and other files generated during test.
+
 ## Installation
 
 Add these lines to your application's Gemfile:
@@ -12,128 +21,54 @@ group :test do
 end
 ````
 
-And add these lines to your spec\_helper.rb file:
-
-````ruby
-RSpec.configure do |config|
-  # Add Watir::RSpec::HtmlFormatter to get links to the screenshots, html and
-  # all other files created during the failing examples.
-  config.add_formatter('documentation')
-  config.add_formatter(Watir::RSpec::HtmlFormatter)
-
-  # Open up the browser for each example.
-  config.before :all do
-    @browser = Watir::Browser.new
-  end
-
-  # Close that browser after each example.
-  config.after :all do
-    @browser.close if @browser
-  end
-
-  # Include RSpec::Helper into each of your example group for making it possible to
-  # write in your examples instead of:
-  #   @browser.goto "localhost"
-  #   @browser.text_field(:name => "first_name").set "Bob"
-  #
-  # like this:
-  #   goto "localhost"
-  #   text_field(:name => "first_name").set "Bob"
-  #
-  # This needs that you've used @browser as an instance variable name in
-  # before :all block.
-    config.include Watir::RSpec::Helper
-  end
-````
-
-
-When using Rails and writing specs to requests directory, add an additional filter for RSpec:
+Or install it manually as:
 
-````ruby
-config.before :all, :type => :request do
-  @browser = Watir::Browser.new :chrome
-end
+    gem install watir-rspec
 
-config.after :all, :type => :request do
-  @browser.close if @browser
-end
+And execute the following command to add `watir-rspec` configuration into your `spec_helper`:
 
-config.include Watir::RSpec::Helper, :type => :request
-````
+    watir-rspec install
 
 ## Usage
 
-### Executing browser methods
-
-If you did include ````Watir::Rspec::Helper```` then it is possible to write code like this in your specs:
-
-````ruby
-text_field(:id => "something").set "foo"
-````
-
-If you did not include ````Watir::RSpec::Helper```` then you have to use browser variable:
-
-````ruby
-@browser.text_field(:id => "something").set "foo"
-````
-
-### Testing asynchronous functionality
-
-````Watir::RSpec```` adds convenience methods ````#within```` and ````#during```` to all of the RSpec matchers,
-which help to write better and more beautiful test code.
-
-Let us pretend that the following div will appear dynamically after some Ajax request.
-
-We can use the standard way:
+Check out the [documentation](http://rubydoc.info/gems/watir-rspec/frames) and the straight-forward fully working examples below.
 
 ````ruby
-Watir::Wait.until(5) { div(:id => "something").present? }
-````
-
-Or we can use ````#within```` method:
-
-````ruby
-div(:id => "something").should be_present.within(5)
-````
-
-````#during```` is the opposite of ````#within```` - it means that during the specified time something should be true/false.
+require "spec_helper"
 
-PS! There is one caveat when using ````#within```` or ````#during```` - it cannot be used in every possible situation.
-
-For example, this won't work as expected:
-
-````ruby
-div(:id => "something").text.should eq("foo").within(5)
+describe "Google" do
+  before { goto "http://google.com" }
+  
+  it "has search box" do
+   text_field(:name => "q").should be_present
+  end
+  
+  it "allows to search" do
+    text_field(:name => "q").set "watir"
+    button(:id => "gbqfb").click
+    results = div(:id => "ires")
+    results.should be_present.within(2)
+    results.lis(:class => "g").map(&:text).should be_any { |text| text =~ /watir/ }
+    results.should be_present.during(1)
+  end
+end
 ````
 
-The reason is that RSpec will check if value of ````#text```` will change to ````"foo"````, but it is just some ````String````,
-which won't change ever. The rule of thumb is that ````#should```` should be always called on an instance of
-the ````Element```` and ````#within/#duration```` on the matcher for that ````Element```` (e.g. ````be_present````, ````be_visible````, ````exist```` etc.).
-
 ### Files created during specs
 
-When creating/downloading/uploading files in your examples and using
-````Watir::RSpec::HtmlFormatter```` then you can generate links automatically to these files when example
-fails. To do that you need to use ````Watir::RSpec.file_path```` method for generating
-unique file name:
+You can use `Watir::RSpec.file_path` to have links automatically in the html report
+to the files created during tests.
 
-````ruby
+```ruby
 uploaded_file_path = Watir::RSpec.file_path("uploaded.txt")
 File.open(uploaded_file_path, "w") {|file| file.write "Generated File Input"}
-````
-
-### Rails support
-
-If you're using Rails, then you also need to install [watir-rails](https://github.com/watir/watir-rails) gem.
+file_field(:name => "upload-file").set uploaded_file_path
+```
 
-## Contributing
+### Rails
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Added some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+You need to use [rspec-rails](https://github.com/rspec/rspec-rails) and [watir-rails](https://github.com/watir/watir-rails) gems together with `watir-rspec` to achieve maximum satisfaction.
 
 ## License
 
-Copyright (c) Jarmo Pertman (jarmo.p@gmail.com). See LICENSE for details.
+Copyright (c) [Jarmo Pertman](https://github.com/jarmo) (jarmo.p@gmail.com). See LICENSE for details.

data/Rakefile

@@ -1,4 +1,10 @@
 require "bundler/gem_tasks"
 
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+task :release => :spec
+
 require "yard"
 YARD::Rake::YardocTask.new

data/bin/watir-rspec

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "watir/rspec/cli"
+Watir::RSpec::CLI.execute
+

data/lib/watir/rspec.rb

@@ -1,110 +1,11 @@
-require 'rspec'
-require File.expand_path("rspec/helper", File.dirname(__FILE__))
-require File.expand_path("rspec/html_formatter", File.dirname(__FILE__))
-
-if defined? ActiveRecord
-  require File.expand_path("rspec/active_record_shared_connection", File.dirname(__FILE__))
-end
-
 module Watir
   class RSpec
     class << self
-      # Add #within(timeout) and #during(timeout) methods for every matcher for allowing to wait until some condition is met.
-      #     div.click
-      #     another_div.should be_present.within(5)
-      #
-      #     expect {
-      #       div.click
-      #     }.to change {another_div.text}.from("before").to("after").within(5)
-      #
-      #     expect {
-      #       div.click
-      #     }.to make {another_div.present?}.within(5)
-      #
-      #     expect {
-      #       div.click
-      #     }.to change {another_div.text}.soon
-      #
-      # @private
-      def add_within_and_during_to_matcher const
-        const.class_eval do
-
-          inst_methods = instance_methods.map &:to_sym
-
-          if !(inst_methods.include?(:__matches?) || inst_methods.include?(:__does_not_match?)) && 
-            (inst_methods.include?(:matches?) || inst_methods.include?(:does_not_match?))
-
-            def within(timeout)
-              @within_timeout = timeout
-              self
-            end
-
-            def during(timeout)
-              @during_timeout = timeout
-              self
-            end
-
-            def soon 
-              within(30)
-            end      
-
-            def seconds
-              # for syntactic sugar
-              self
-            end
-
-            alias_method :second, :seconds
-
-            def minutes
-              @within_timeout *= 60 if @within_timeout
-              @during_timeout *= 60 if @during_timeout
-              self
-            end
-
-            alias_method :minute, :minutes
-          end
-
-          if inst_methods.include? :matches?
-            alias_method :__matches?, :matches? 
-
-            def matches?(actual)
-              match_with_wait {__matches?(actual)}
-            end
-          end
-
-          if inst_methods.include? :does_not_match?
-            alias_method :__does_not_match?, :does_not_match?
-
-            def does_not_match?(actual)
-              match_with_wait {__does_not_match?(actual)}
-            end
-          elsif inst_methods.include? :matches?
-            def does_not_match?(actual)
-              match_with_wait {!__matches?(actual)}
-            end
-          end
-
-          private
-
-          def match_with_wait
-            if @within_timeout
-              timeout = @within_timeout; @within_timeout = nil
-              Watir::Wait.until(timeout) {yield} rescue false
-            elsif @during_timeout
-              timeout = @during_timeout; @during_timeout = nil
-              Watir::Wait.while(timeout) {yield} rescue true        
-            else
-              yield
-            end
-          end
-        end
-      end
-
       # Generate unique file path for the current spec. If the file
       # will be created during that spec and spec fails then it will be
       # shown automatically in the html report.
       #
-      # @param [String] File name to be used for file.
+      # @param [String] file_name File name to be used for file.
       #   Will be used as a part of the complete name.
       # @return [String] Absolute path for the unique file name.
       # @raise [RuntimeError] when {Watir::RSpec::HtmlFormatter} is not in use.
@@ -112,6 +13,11 @@ module Watir
         formatter.file_path(file_name, description=nil)
       end
 
+      # @private
+      def active_record_loaded?
+        defined? ActiveRecord::Base
+      end
+
       private
 
       def formatter
@@ -131,38 +37,15 @@ module Watir
                          formatter
                        end
       end
-
-
     end
-
   end
 end
 
-# patch for #within(timeout) method
-# @private
-module ::RSpec::Matchers
-  class BuiltIn::Change
-    def matches?(event_proc)
-      raise_block_syntax_error if block_given?
+require "rspec"
 
-      # to make #change work with #in(timeout) method
-      unless defined? @actual_before
-        @actual_before = evaluate_value_proc
-        event_proc.call
-      end
-      @actual_after = evaluate_value_proc
-
-      (!change_expected? || changed?) && matches_before? && matches_after? && matches_expected_delta? && matches_min? && matches_max?
-    end
-  end
-
-  alias_method :make, :change
-end
-
-matchers = RSpec::Matchers::BuiltIn.constants.map(&:to_sym)
-matchers.delete :BaseMatcher
-matchers.each do |const|
-  Watir::RSpec.add_within_and_during_to_matcher RSpec::Matchers::BuiltIn.const_get const
-end
+require File.expand_path("rspec/active_record_shared_connection", File.dirname(__FILE__))
+require File.expand_path("rspec/helper", File.dirname(__FILE__))
+require File.expand_path("rspec/matchers/base_matcher", File.dirname(__FILE__))
+require File.expand_path("rspec/matchers", File.dirname(__FILE__))
+require File.expand_path("rspec/html_formatter", File.dirname(__FILE__))
 
-Watir::RSpec.add_within_and_during_to_matcher RSpec::Matchers::DSL::Matcher

data/lib/watir/rspec/active_record_shared_connection.rb

@@ -1,16 +1,20 @@
-RSpec.configuration.before(:suite) do
-  # Allow RSpec specs to use transactional fixtures when using Watir. 
-  #
-  # Tip from http://blog.plataformatec.com.br/2011/12/three-tips-to-improve-the-performance-of-your-test-suite/
-  class ::ActiveRecord::Base
-    mattr_accessor :shared_connection
-    @@shared_connection = nil
+if Watir::RSpec.active_record_loaded?
+  require "thread"
 
-    def self.connection
-      @@shared_connection || retrieve_connection
+  RSpec.configuration.before(:suite) do
+    # Allow RSpec specs to use transactional fixtures when using Watir. 
+    #
+    # Tip from http://blog.plataformatec.com.br/2011/12/three-tips-to-improve-the-performance-of-your-test-suite/
+    class ::ActiveRecord::Base
+      @shared_connection_semaphore = Mutex.new
+
+      class << self
+        def connection
+          @shared_connection_semaphore.synchronize do
+            @shared_connection ||= retrieve_connection
+          end
+        end
+      end
     end
   end
-
-  # Forces all threads to share the same connection. 
-  ::ActiveRecord::Base.shared_connection = ::ActiveRecord::Base.connection
 end

data/lib/watir/rspec/cli.rb

@@ -0,0 +1,125 @@
+require "optparse"
+
+module Watir
+  class RSpec
+    # @private
+    class CLI
+      class << self
+        def execute
+          @options = {}
+          parser = OptionParser.new do |opts|
+            opts.banner = "Install watir-rspec configuration into spec_helper file.
+
+Usage: watir-rspec [options] install"
+
+            opts.on("-r", "--[no-]rails", "Force to install watir-rspec for Rails application if the detection fails") do |v|
+              @options[:rails] = v
+            end
+          end
+
+          parser.parse!
+
+          if ARGV.size != 1 || ARGV.first != "install"
+            puts parser
+            exit
+          end
+
+          unless already_installed?
+            install 
+          else
+            puts "watir-rspec is already installed into #{spec_helper}... skipping."
+            exit
+          end
+        end
+
+        private
+
+        def install
+          puts "Rails application #{using_rails? ? "detected" : "not detected"}.
+Installing watir-rspec configuration into #{spec_helper}."
+
+          File.open(spec_helper, "a") do |file|
+            file.puts %Q[
+# Configuration for watir-rspec
+require "watir/rspec"
+
+RSpec.configure do |config|
+  # Use Watir::RSpec::HtmlFormatter to get links to the screenshots, html and
+  # all other files created during the failing examples.
+  config.add_formatter(:progress) if config.formatters.empty?
+  config.add_formatter(Watir::RSpec::HtmlFormatter)
+
+  # Open up the browser for each example.
+  config.before :all#{rails_filter} do
+    @browser = Watir::Browser.new
+  end
+
+  # Close that browser after each example.
+  config.after :all#{rails_filter} do
+    @browser.close if @browser
+  end
+
+  # Include RSpec::Helper into each of your example group for making it possible to
+  # write in your examples instead of:
+  #   @browser.goto "localhost"
+  #   @browser.text_field(:name => "first_name").set "Bob"
+  #
+  # like this:
+  #   goto "localhost"
+  #   text_field(:name => "first_name").set "Bob"
+  #
+  # This needs that you've used @browser as an instance variable name in
+  # before :all block.
+  config.include Watir::RSpec::Helper#{rails_filter}
+
+  # Include RSpec::Matchers into each of your example group for making it possible to
+  # use #within with some of RSpec matchers for easier asynchronous testing:
+  #   @browser.text_field(:name => "first_name").should exist.within(2)
+  #   @browser.text_field(:name => "first_name").should be_present.within(2)
+  #   @browser.text_field(:name => "first_name").should be_visible.within(2)
+  #
+  # You can also use #during to test if something stays the same during the specified period:
+  #   @browser.text_field(:name => "first_name").should exist.during(2)
+  config.include Watir::RSpec::Matchers#{rails_filter}
+end
+  ]
+          end
+        end
+
+        def already_installed?
+          File.exist?(spec_helper) && File.read(spec_helper) =~ /Watir::RSpec/
+        end
+
+        def spec_directory
+          specs = File.expand_path("spec")
+
+          unless File.directory? specs
+            puts %Q[#{specs} directory not found.
+Make sure you run the watir-rspec command within your projects' directory.]
+
+            exit 1
+          end
+
+          specs
+        end
+
+        def spec_helper
+          File.join(spec_directory, "spec_helper.rb")
+        end
+
+        def rails_filter
+          ", :type => :request" if using_rails?
+        end
+
+        def using_rails?
+          return @options[:rails] if @options.has_key? :rails
+
+          @using_rails ||= begin
+                             File.exists?("Gemfile.lock") && File.read("Gemfile.lock") =~ /rspec-rails/ ||
+                               File.exists?("Gemfile") && File.read("Gemfile") =~ /rspec-rails/
+                           end
+        end
+      end
+    end
+  end
+end

data/lib/watir/rspec/helper.rb

@@ -3,7 +3,7 @@ module Watir
     module Helper
       extend Forwardable
 
-      # @return [Watir::Browser] a latest browser instance if it is initialized with 
+      # @return [Watir::Browser] a current browser instance if it is initialized with 
       #   @browser or $browser variable name.
       def browser
         @browser || $browser

data/lib/watir/rspec/html_formatter.rb

@@ -55,7 +55,7 @@ module Watir
       # will be created during that spec and spec fails then it will be
       # shown automatically in the html report.
       #
-      # @param [String] File name to be used for file.
+      # @param [String] file_name File name to be used for file.
       #   Will be used as a part of the complete name.
       # @return [String] Absolute path for the unique file name.
       def file_path(file_name, description=nil)

data/lib/watir/rspec/matchers.rb

@@ -0,0 +1,38 @@
+module Watir
+  class RSpec
+    # All matchers defined in here have the ability to be used for asynchronous
+    # testing.
+    #
+    # There is #within matcher which means that the expected result should happen
+    # within the specified time period.
+    #
+    # There also exists less used #during matcher which means that the expected
+    # result should be true for the whole specified time period.
+    #
+    # @example Wait for 2 seconds until element is present (element exists and is visible)
+    #   text_field.should be_present.within(2)
+    #   
+    # @example Wait for 2 seconds until element is visible
+    #   text_field.should be_visible.within(2)
+    #
+    # @example Wait for 2 seconds until element exists
+    #   text_field.should exist.within(2)
+    #
+    # @example Make sure that container is visible for the whole time during 2 seconds
+    #   button.click
+    #   div.should be_visible.during(2)
+    module Matchers
+      def be_present
+        BaseMatcher.new :present?
+      end
+
+      def be_visible
+        BaseMatcher.new :visible?
+      end      
+
+      def exist
+        BaseMatcher.new :exist?
+      end
+    end
+  end
+end

data/lib/watir/rspec/matchers/base_matcher.rb

@@ -0,0 +1,76 @@
+require "timeout"
+
+module Watir
+  class RSpec
+    module Matchers
+      # @private
+      class BaseMatcher < ::RSpec::Matchers::BuiltIn::Be
+        def initialize(predicate)
+          @predicate = predicate
+        end
+
+        def matches?(target)
+          @target = target
+
+          if @within_seconds
+            match_with_timeout(@within_seconds, true) { target.send @predicate }
+          elsif @during_seconds
+            match_with_timeout(@during_seconds, false) { !target.send @predicate }
+          else
+            target.send(@predicate)
+          end
+        end
+
+        def does_not_match?(target)
+          @target = target
+
+          if @within_seconds
+            match_with_timeout(@within_seconds, true) { !target.send @predicate }
+          elsif @during_seconds
+            match_with_timeout(@during_seconds, false) { target.send @predicate }
+          else
+            !target.send(@predicate)
+          end
+        end
+
+        def failure_message_for_should
+          "expected #{@target.inspect} to #{be_prefix}#{@predicate.to_s[0..-2]}#{timeout_to_s}"
+        end
+
+        def failure_message_for_should_not
+          "expected #{@target.inspect} not to #{be_prefix}#{@predicate.to_s[0..-2]}#{timeout_to_s}"
+        end
+
+        def within(seconds)
+          @within_seconds = seconds
+          self
+        end
+
+        def during(seconds)
+          @during_seconds = seconds
+          self
+        end
+
+        private
+
+        def match_with_timeout(seconds, expected_result)
+          Timeout.timeout(seconds) { sleep 0.1 until (yield rescue false); expected_result } rescue !expected_result
+        end
+
+        def be_prefix
+          @predicate.to_s[0..-2] == "exist" ? "" : "be "
+        end
+
+        def timeout_to_s
+          if @within_seconds 
+            " within #{@within_seconds} second(s) "
+          elsif @during_seconds
+            " during #{@during_seconds} second(s) "
+          else
+            " "
+          end
+        end
+      end
+    end
+  end
+end

data/lib/watir/rspec/version.rb

@@ -1,5 +1,5 @@
 module Watir
   class RSpec
-    VERSION = "0.0.3"
+    VERSION = "1.0.0"
   end
 end

data/spec/spec_helper.rb

@@ -0,0 +1,18 @@
+require "simplecov"
+require 'coveralls'
+
+SimpleCov.formatter = Coveralls::SimpleCov::Formatter
+SimpleCov.start
+
+RSpec.configure do |c|
+  c.color = true
+  c.order = :random
+end
+
+# Make sure constants are defined
+module ::ActiveRecord
+  class Base
+  end
+end
+
+require "watir/rspec"

data/spec/watir/rspec/active_record_shared_connection_spec.rb

@@ -0,0 +1,24 @@
+require "spec_helper"
+
+describe ::ActiveRecord::Base do
+  before { described_class.instance_variable_set :@shared_connection, nil }
+
+  context ".connection" do
+    it "reuses the connection" do
+      described_class.should_receive(:retrieve_connection).once.and_return(:established_connection)
+
+      2.times { described_class.connection.should == :established_connection }
+    end
+
+    it "uses mutex" do
+      described_class.should_receive(:retrieve_connection).once { sleep 0.1; :established_connection }
+
+      thr = Thread.new { described_class.connection }
+
+      t = Time.now
+      described_class.connection
+      (Time.now - t).should be >= 0.1
+      thr.join
+    end
+  end
+end

data/spec/watir/rspec/helper_spec.rb

@@ -0,0 +1,56 @@
+require "spec_helper"
+
+describe Watir::RSpec::Helper do
+  before { self.send :extend, described_class }
+  after { $browser = @browser = nil }
+
+  context "#browser" do
+    it "delegates to @browser if exists" do
+      @browser = :browser
+      browser.should == @browser
+    end
+
+    it "delegates to @browser if @browser exists even if $browser exists" do
+      @browser = :browser
+      $browser = :global_browser
+      browser.should == @browser
+    end
+
+    it "delegates to $browser if @browser does not exist" do
+      $browser = :global_browser
+      browser.should == $browser
+    end
+  end
+
+  context "#method_missing" do
+    it "redirects missing methods to browser if method exists" do
+      @browser = double("browser", coolness_factor: :very)
+      coolness_factor.should == :very
+    end
+
+    it "raises error when browser does not have method" do
+      @browser = double("browser")
+      described_class.should_not be_method_defined :not_existing_method
+
+      expect do
+        self.not_existing_method
+      end.to raise_error(NoMethodError)
+
+      described_class.should_not be_method_defined :not_existing_method
+    end
+
+    it "adds browser methods to the helper" do
+      @browser = double("browser", method_to_be_defined: :done)
+      described_class.should_not be_method_defined :method_to_be_defined
+      method_to_be_defined.should == :done
+      described_class.should be_method_defined :method_to_be_defined
+    end
+  end
+
+  it "#p is delegated to the browser" do
+    @browser = double("browser", p: "#p")
+    described_class.should_not_receive(:method_missing)
+
+    p.should == "#p"
+  end
+end

data/spec/watir/rspec/matchers/base_matcher_spec.rb

@@ -0,0 +1,177 @@
+require "spec_helper"
+
+describe Watir::RSpec::Matchers::BaseMatcher do
+  before { self.class.send(:define_method, :be_foo) { described_class.new :foo? } }
+
+  it "#matches?" do
+    object = double("element", foo?: true)
+    object.should be_foo
+  end
+
+  it "#matches? with error" do
+    object = double("element", foo?: false)
+    expect {
+      object.should be_foo
+    }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+  end
+
+  it "#does_not_match?" do
+    object = double("element", foo?: false)
+    object.should_not be_foo
+  end
+
+  it "#does_not_match? with error" do
+    object = double("element", foo?: true)
+    expect {
+      object.should_not be_foo
+    }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+  end
+
+  context "#within" do
+    around { |example| should_take_at_least(0.1) { example.run }}
+
+    it "#matches?" do
+      object = double("element")
+      @result = false
+      object.stub(:foo?) { @result }
+      thr = Thread.new { sleep 0.1; @result = true }
+
+      object.should be_foo.within(1)
+      thr.join
+    end
+
+    it "#matches? with timeout error" do
+      object = double("element", foo?: false)
+
+      expect {
+        object.should be_foo.within(0.1)
+      }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+    end
+
+    it "#matches? with some other error" do
+      object = double("element")
+      raised = false
+      object.stub(:foo?) do
+        unless raised
+          raised = true
+          raise "Some unexpected exception"
+        else
+          sleep 0.1
+          true
+        end
+      end
+
+      object.should be_foo.within(1)
+    end
+
+    it "#does_not_match?" do
+      object = double("element")
+      @result = true
+      object.stub(:foo?) { @result }
+      thr = Thread.new { sleep 0.1; @result = false }
+
+      object.should_not be_foo.within(1)
+      thr.join
+    end    
+
+    it "#does_not_match? with timeout error" do
+      object = double("element", foo?: true)
+
+      expect {
+        object.should_not be_foo.within(0.1)
+      }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+    end
+
+    it "#does_not_match? with some other error" do
+      object = double("element")
+      raised = false
+      object.stub(:foo?) do
+        unless raised
+          raised = true
+          raise "Some unexpected exception"
+        else
+          sleep 0.1
+          false
+        end
+      end
+
+      object.should_not be_foo.within(1)
+    end
+  end
+
+  context "#during" do
+    around { |example| should_take_at_least(0.1) { example.run }}
+
+    it "#matches?" do
+      object = double("element", foo?: true)
+
+      object.should be_foo.during(0.1)
+    end
+
+    it "#matches? with timeout error" do
+      object = double("element")
+      @result = true
+      object.stub(:foo?) { @result }
+      thr = Thread.new { sleep 0.1; @result = false }
+
+      expect {
+        object.should be_foo.during(1)
+      }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+      thr.join
+    end
+
+    it "#matches? with some other error" do
+      object = double("element")
+      raised = false
+      object.stub(:foo?) do
+        unless raised
+          raised = true
+          raise "Some unexpected exception"
+        else
+          true
+        end
+      end
+
+      object.should be_foo.during(0.1)
+    end
+
+    it "#does_not_match?" do
+      object = double("element", foo?: false)
+
+      object.should_not be_foo.during(0.1)
+    end    
+
+    it "#does_not_match? with timeout error" do
+      object = double("element")
+      @result = false
+      object.stub(:foo?) { @result }
+      thr = Thread.new { sleep 0.1; @result = true }
+
+      expect {
+        object.should_not be_foo.during(1)
+      }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+      thr.join
+    end
+
+    it "#does_not_match? with some other error" do
+      object = double("element")
+      raised = false
+      object.stub(:foo?) do
+        unless raised
+          raised = true
+          raise "Some unexpected exception"
+        else
+          false
+        end
+      end
+
+      object.should_not be_foo.during(0.1)
+    end    
+  end
+
+  def should_take_at_least(seconds)
+    t = Time.now
+    yield
+    (Time.now - t).should be >= seconds
+  end
+end

data/spec/watir/rspec/matchers_spec.rb

@@ -0,0 +1,23 @@
+require "spec_helper"
+
+describe Watir::RSpec::Matchers do
+  before { self.send :extend, described_class }
+
+  it "#be_present" do
+    matcher = be_present
+    matcher.should == Watir::RSpec::Matchers::BaseMatcher
+    matcher.instance_variable_get(:@predicate).should == :present?
+  end
+
+  it "#be_visible" do
+    matcher = be_visible
+    matcher.should == Watir::RSpec::Matchers::BaseMatcher
+    matcher.instance_variable_get(:@predicate).should == :visible?
+  end
+
+  it "#exist" do
+    matcher = exist
+    matcher.should == Watir::RSpec::Matchers::BaseMatcher
+    matcher.instance_variable_get(:@predicate).should == :exist?
+  end  
+end

data/watir-rspec.gemspec

@@ -1,23 +1,23 @@
-# -*- encoding: utf-8 -*-
-require File.expand_path('../lib/watir/rspec/version', __FILE__)
-
-Gem::Specification.new do |gem|
-  gem.authors       = ["Jarmo Pertman"]
-  gem.email         = ["jarmo.p@gmail.com"]
-  gem.description   = %q{Use Watir with RSpec with ease.}
-  gem.summary       = %q{Use Watir with RSpec with ease.}
-  gem.homepage      = "http://github.com/watir/watir-rspec"
-
-  gem.files         = `git ls-files`.split($\)
-  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
-  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
-  gem.name          = "watir-rspec"
-  gem.require_paths = ["lib"]
-  gem.version       = Watir::RSpec::VERSION
-
-  gem.add_dependency "rspec", "~>2.0"
-
-  gem.add_development_dependency "yard"
-  gem.add_development_dependency "rake"
-  gem.add_development_dependency "redcarpet"
-end
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/watir/rspec/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Jarmo Pertman"]
+  gem.email         = ["jarmo.p@gmail.com"]
+  gem.description   = %q{Use Watir with RSpec with ease.}
+  gem.summary       = %q{Use Watir with RSpec with ease.}
+  gem.homepage      = "http://github.com/watir/watir-rspec"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "watir-rspec"
+  gem.require_paths = ["lib"]
+  gem.version       = Watir::RSpec::VERSION
+
+  gem.add_dependency "rspec", "~>2.0"
+
+  gem.add_development_dependency "yard"
+  gem.add_development_dependency "rake"
+  gem.add_development_dependency "redcarpet"
+end

metadata

@@ -1,20 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: watir-rspec
 version: !ruby/object:Gem::Version
-  version: 0.0.3
-  prerelease: 
+  version: 1.0.0
 platform: ruby
 authors:
 - Jarmo Pertman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-03 00:00:00.000000000 Z
+date: 2013-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -22,7 +20,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -30,93 +27,103 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 description: Use Watir with RSpec with ease.
 email:
 - jarmo.p@gmail.com
-executables: []
+executables:
+- watir-rspec
 extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .travis.yml
 - .yardopts
+- CHANGES
 - Gemfile
 - LICENSE
 - README.md
 - Rakefile
+- bin/watir-rspec
 - lib/watir/rspec.rb
 - lib/watir/rspec/active_record_shared_connection.rb
+- lib/watir/rspec/cli.rb
 - lib/watir/rspec/helper.rb
 - lib/watir/rspec/html_formatter.rb
+- lib/watir/rspec/matchers.rb
+- lib/watir/rspec/matchers/base_matcher.rb
 - lib/watir/rspec/version.rb
+- spec/spec_helper.rb
+- spec/watir/rspec/active_record_shared_connection_spec.rb
+- spec/watir/rspec/helper_spec.rb
+- spec/watir/rspec/matchers/base_matcher_spec.rb
+- spec/watir/rspec/matchers_spec.rb
 - watir-rspec.gemspec
 homepage: http://github.com/watir/watir-rspec
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.0.7
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Use Watir with RSpec with ease.
-test_files: []
+test_files:
+- spec/spec_helper.rb
+- spec/watir/rspec/active_record_shared_connection_spec.rb
+- spec/watir/rspec/helper_spec.rb
+- spec/watir/rspec/matchers/base_matcher_spec.rb
+- spec/watir/rspec/matchers_spec.rb
 has_rdoc: