capybara 2.12.1 → 2.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 366aecdcbfc57f6102bd9216645cfdb69dea2f0e
-  data.tar.gz: 989edd37eea1f619de795362350584f25af60b17
+  metadata.gz: 266938107d80bacdd4f95cc21e79fe6b7af2e131
+  data.tar.gz: dac8ea7395988fc218da8a556df246db661125b0
 SHA512:
-  metadata.gz: ccd1760a40ac203ebf7ba2b38104e64e9eea0446ccc596898b8467f5c0471f37e003ca84616c82843426928b6997d7be3b748beb85aa00e34a70573551027427
-  data.tar.gz: 7d51a1a4fc3c405774710bd4eae7d922fa1957d5900f50c68a5f58c70f762d73d11ac00964654c7408320c10c4b401dea588e3eec35f9cc3f13482a42aca1362
+  metadata.gz: a548da527db279933776ebd86daa6ddf1d7e714bc9b22225959d58b67bbecfa8458f503cde377fc262f0d4442ef6d0f47a88a1bcf66efd58bc5014d80b80f87d
+  data.tar.gz: f040e322ba5e591dbc3546b0e5c7672f21b6e9eab99ff848780f42e1e1d9e5ce87bdfe242ae0dbb7a45b4ecb37611d3c1c1a202cedcc1e16cc00040114422213

data/History.md

@@ -1,3 +1,15 @@
+#Version 2.13.0
+Release date: 2017-03-16
+
+### Added
+
+* Selenium driver supports returning element(s) from evaluate_script [Thomas Walpole]
+* rack_test driver supports click on checkboxes and radio buttons to change their states [Thomas Walpole]
+* Support RSpec equivalent assertions and expectations for MiniTest [Thomas Walpole]
+
+### Foxed
+* Editing of content editable children with selenium
+
 #Version 2.12.1
 Release date: 2017-02-16
 

data/README.md

@@ -36,7 +36,8 @@ You can read more about the missing features [here](https://github.com/teamcapyb
 - [Using Capybara with Cucumber](#using-capybara-with-cucumber)
 - [Using Capybara with RSpec](#using-capybara-with-rspec)
 - [Using Capybara with Test::Unit](#using-capybara-with-testunit)
-- [Using Capybara with MiniTest::Spec](#using-capybara-with-minitestspec)
+- [Using Capybara with Minitest](#using-capybara-with-minitest)
+- [Using Capybara with Minitest::Spec](#using-capybara-with-minitestspec)
 - [Drivers](#drivers)
     - [Selecting the Driver](#selecting-the-driver)
     - [RackTest](#racktest)
@@ -242,14 +243,37 @@ end
 
 ## <a name="using-capybara-with-testunit"></a>Using Capybara with Test::Unit
 
+* If you are using `Test::Unit`, define a base class for your Capybara tests
+  like so:
+
+    ```ruby
+    require 'capybara/dsl'
+
+    class CapybaraTestCase < Test::Unit::TestCase
+      include Capybara::DSL
+
+      def teardown
+        Capybara.reset_sessions!
+        Capybara.use_default_driver
+      end
+    end
+    ```
+
+## <a name="using-capybara-with-minitest"></a>Using Capybara with Minitest
+
 * If you are using Rails, add the following code in your `test_helper.rb`
     file to make Capybara available in all test cases deriving from
     `ActionDispatch::IntegrationTest`:
 
     ```ruby
+    require 'capybara/rails'
+    require 'capybara/minitest'
+
     class ActionDispatch::IntegrationTest
       # Make the Capybara DSL available in all integration tests
       include Capybara::DSL
+      # Make `assert_*` methods behave like Minitest assertions
+      include Capybara::Minitest::Assertions
 
       # Reset sessions and driver between tests
       # Use super wherever this method is redefined in your individual test classes
@@ -264,8 +288,11 @@ end
   so:
 
     ```ruby
-    class CapybaraTestCase < Test::Unit::TestCase
+    require 'capybara/minitest'
+
+    class CapybaraTestCase < Minitest::Test
       include Capybara::DSL
+      include Capybara::Minitest::Assertions
 
       def teardown
         Capybara.reset_sessions!
@@ -291,14 +318,9 @@ class BlogTest < ActionDispatch::IntegrationTest
 end
 ```
 
-## <a name="using-capybara-with-minitestspec"></a>Using Capybara with MiniTest::Spec
-
-Set up your base class as with Test::Unit. (On Rails, the right base class
-could be something other than ActionDispatch::IntegrationTest.)
+## <a name="using-capybara-with-minitestspec"></a>Using Capybara with Minitest::Spec
 
-The capybara_minitest_spec gem ([GitHub](https://github.com/ordinaryzelig/capybara_minitest_spec),
-[rubygems.org](https://rubygems.org/gems/capybara_minitest_spec)) provides MiniTest::Spec
-expectations for Capybara. For example:
+Follow the above instructions for Minitest and additionally require capybara/minitest/spec
 
 ```ruby
 page.must_have_content('Important!')

data/lib/capybara/minitest.rb

@@ -0,0 +1,297 @@
+# frozen_string_literal: true
+require 'minitest'
+require 'capybara/dsl'
+
+module Capybara
+  module Minitest
+    module Assertions
+      ## Assert text exists
+      #  see {Capybara::Node::Matchers#assert_text}
+      def assert_text(*args)
+        self.assertions += 1
+        subject, *args = determine_subject(args)
+        subject.assert_text(*args)
+      rescue Capybara::ExpectationNotMet => e
+        raise ::Minitest::Assertion, e.message
+      end
+      alias_method :assert_content, :assert_text
+
+      ## Assert text does not exist
+      #  see {Capybara::Node::Matchers#assert_no_text}
+      def assert_no_text(*args)
+        self.assertions += 1
+        subject, *args = determine_subject(args)
+        subject.assert_no_text(*args)
+      rescue Capybara::ExpectationNotMet => e
+        raise ::Minitest::Assertion, e.message
+      end
+      alias_method :refute_text, :assert_no_text
+      alias_method :refute_content, :refute_text
+      alias_method :assert_no_content, :refute_text
+
+      ## Assert selector exists on page
+      #  see {Capybara::Node::Matchers#assert_selector}
+      def assert_selector(*args, &optional_filter_block)
+        self.assertions +=1
+        subject, *args = determine_subject(args)
+        subject.assert_selector(*args, &optional_filter_block)
+      rescue Capybara::ExpectationNotMet => e
+        raise ::Minitest::Assertion, e.message
+      end
+
+      ## Assert selector does not exist on page
+      #  see {Capybara::Node::Matchers#assert_no_selector}
+      def assert_no_selector(*args, &optional_filter_block)
+        self.assertions +=1
+        subject, *args = determine_subject(args)
+        subject.assert_no_selector(*args, &optional_filter_block)
+      rescue Capybara::ExpectationNotMet => e
+        raise ::Minitest::Assertion, e.message
+      end
+      alias_method :refute_selector, :assert_no_selector
+
+      ## Assert element matches selector
+      #  see {Capybara::Node::Matchers#assert_matches_selector}
+      def assert_matches_selector(*args, &optional_filter_block)
+        self.assertions += 1
+        subject, *args = determine_subject(args)
+        subject.assert_matches_selector(*args, &optional_filter_block)
+      rescue Capybara::ExpectationNotMet => e
+        raise ::Minitest::Assertion, e.message
+      end
+
+      ## Assert element does not match selector
+      #  see {Capybara::Node::Matchers#assert_not_matches_selector}
+      def assert_not_matches_selector(*args, &optional_filter_block)
+        self.assertions += 1
+        subject, *args = determine_subject(args)
+        subject.assert_not_matches_selector(*args, &optional_filter_block)
+      rescue Capybara::ExpectationNotMet => e
+        raise ::Minitest::Assertion, e.message
+      end
+      alias_method :refute_matches_selector, :assert_not_matches_selector
+
+      %w(title current_path).each do |selector_type|
+        define_method "assert_#{selector_type}" do |*args|
+          begin
+            self.assertions += 1
+            subject, *args = determine_subject(args)
+            subject.public_send("assert_#{selector_type}",*args)
+          rescue Capybara::ExpectationNotMet => e
+            raise ::Minitest::Assertion, e.message
+          end
+        end
+
+        define_method "assert_no_#{selector_type}" do |*args|
+          begin
+            self.assertions += 1
+            subject, *args = determine_subject(args)
+            subject.public_send("assert_no_#{selector_type}",*args)
+          rescue Capybara::ExpectationNotMet => e
+            raise ::Minitest::Assertion, e.message
+          end
+        end
+        alias_method "refute_#{selector_type}", "assert_no_#{selector_type}"
+      end
+
+      %w(xpath css link button field select table).each do |selector_type|
+        define_method "assert_#{selector_type}" do |*args, &optional_filter_block|
+          subject, *args = determine_subject(args)
+          locator, options = *args, {}
+          locator, options = nil, locator if locator.is_a? Hash
+          assert_selector(subject, selector_type.to_sym, locator, options, &optional_filter_block)
+        end
+
+        define_method "assert_no_#{selector_type}" do |*args, &optional_filter_block|
+          subject, *args = determine_subject(args)
+          locator, options = *args, {}
+          locator, options = nil, locator if locator.is_a? Hash
+          assert_no_selector(subject, selector_type.to_sym, locator, options, &optional_filter_block)
+        end
+        alias_method "refute_#{selector_type}", "assert_no_#{selector_type}"
+      end
+
+      %w(xpath css).each do |selector_type|
+        define_method "assert_matches_#{selector_type}" do |*args, &optional_filter_block|
+          subject, *args = determine_subject(args)
+          assert_matches_selector(subject, selector_type.to_sym, *args, &optional_filter_block)
+        end
+
+        define_method "assert_not_matches_#{selector_type}" do |*args, &optional_filter_block|
+          subject, *args = determine_subject(args)
+          assert_not_matches_selector(subject, selector_type.to_sym, *args, &optional_filter_block)
+        end
+        alias_method "refute_matches_#{selector_type}", "assert_not_matches_#{selector_type}"
+      end
+
+      %w(checked unchecked).each do |field_type|
+        define_method "assert_#{field_type}_field" do |*args, &optional_filter_block|
+          subject, *args = determine_subject(args)
+          locator, options = *args, {}
+          locator, options = nil, locator if locator.is_a? Hash
+          assert_selector(subject, :field, locator, options.merge(field_type.to_sym => true), &optional_filter_block)
+        end
+
+        define_method "assert_no_#{field_type}_field" do |*args, &optional_filter_block|
+          subject, *args = determine_subject(args)
+          locator, options = *args, {}
+          locator, options = nil, locator if locator.is_a? Hash
+          assert_no_selector(subject, :field, locator, options.merge(field_type.to_sym => true), &optional_filter_block)
+        end
+        alias_method "refute_#{field_type}_field", "assert_no_#{field_type}_field"
+      end
+
+      ##
+      # Assertion that there is xpath
+      #
+      # @!method assert_xpath
+      #   see Capybara::Node::Matchers#has_xpath?
+
+      ##
+      # Assertion that there is no xpath
+      #
+      # @!method refute_xpath
+      # @!method assert_no_xpath
+      #   see Capybara::Node::Matchers#has_no_xpath?
+
+      ##
+      # Assertion that there is css
+      #
+      # @!method assert_css
+      #   see Capybara::Node::Matchers#has_css?
+
+      ##
+      # Assertion that there is no css
+      #
+      # @!method refute_css
+      # @!method assert_no_css
+      #   see Capybara::Node::Matchers#has_no_css?
+
+      ##
+      # Assertion that there is link
+      #
+      # @!method assert_link
+      #   see {Capybara::Node::Matchers#has_link?}
+
+      ##
+      # Assertion that there is no link
+      #
+      # @!method assert_no_link
+      # @!method refute_link
+      # see {Capybara::Node::Matchers#has_no_link?}
+
+      ##
+      # Assertion that there is button
+      #
+      # @!method assert_button
+      #   see {Capybara::Node::Matchers#has_button?}
+
+      ##
+      # Assertion that there is no button
+      #
+      # @!method refute_button
+      # @!method assert_no_button
+      #   see {Capybara::Node::Matchers#has_no_button?}
+
+      ##
+      # Assertion that there is field
+      #
+      # @!method assert_field
+      #   see {Capybara::Node::Matchers#has_field?}
+
+      ##
+      # Assertion that there is no field
+      #
+      # @!method refute_field
+      # @!method assert_no_field
+      #   see {Capybara::Node::Matchers#has_no_field?}
+
+      ##
+      # Assertion that there is checked_field
+      #
+      # @!method assert_checked_field
+      #   see {Capybara::Node::Matchers#has_checked_field?}
+
+      ##
+      # Assertion that there is no checked_field
+      #
+      # @!method assert_no_checked_field
+      # @!method refute_chceked_field
+
+      ##
+      # Assertion that there is unchecked_field
+      #
+      # @!method assert_unchecked_field
+      #   see {Capybara::Node::Matchers#has_unchecked_field?}
+
+      ##
+      # Assertion that there is no unchecked_field
+      #
+      # @!method assert_no_unchecked_field
+      # @!method refute_unchceked_field
+
+      ##
+      # Assertion that there is select
+      #
+      # @!method assert_select
+      #   see {Capybara::Node::Matchers#has_select?}
+
+      ##
+      # Assertion that there is no select
+      #
+      # @!method refute_select
+      # @!method assert_no_select
+      #   see {Capybara::Node::Matchers#has_no_select?}
+
+      ##
+      # Assertion that there is table
+      #
+      # @!method assert_table
+      #   see {Capybara::Node::Matchers#has_table?}
+
+      ##
+      # Assertion that there is no table
+      #
+      # @!method refute_table
+      # @!method assert_no_table
+      #   see {Capybara::Node::Matchers#has_no_table?}
+
+      ##
+      # Assertion that page title does match
+      #
+      # @!method assert_title
+      #   see {Capybara::Node::DocumentMatchers#assert_title}
+
+      ##
+      # Assertion that page title does not match
+      #
+      # @!method refute_title
+      # @!method assert_no_title
+      #   see {Capybara::Node::DocumentMatchers#assert_no_title}
+
+      ##
+      # Assertion that current path matches
+      #
+      # @!method assert_current_path
+      #   see {Capybara::SessionMatchers#assert_current_path}
+
+      ##
+      # Assertion that current page does not match
+      #
+      # @!method refute_current_path
+      # @!method assert_no_current_path
+      #   see {Capybara::SessionMatchers#assert_no_current_path}
+
+      private
+
+      def determine_subject(args)
+        case args.first
+        when Capybara::Session, Capybara::Node::Base, Capybara::Node::Simple
+          args
+        else
+          [page, *args]
+        end
+      end
+    end
+  end
+end

data/lib/capybara/minitest/spec.rb

@@ -0,0 +1,200 @@
+require 'minitest/spec'
+
+module Capybara
+  module Minitest
+    module Expectations
+      %w(text content title current_path).each do |assertion|
+        infect_an_assertion "assert_#{assertion}", "must_have_#{assertion}", :reverse
+        infect_an_assertion "refute_#{assertion}", "wont_have_#{assertion}", :reverse
+      end
+
+      # Unfortunately infect_an_assertion doesn't pass through the optional filter block so we can't use it for these
+      %w(selector xpath css link button field select table checked_field unchecked_field).each do |assertion|
+        self.class_eval <<-EOM
+          def must_have_#{assertion} *args, &optional_filter_block
+            ::Minitest::Expectation.new(self, ::Minitest::Spec.current).must_have_#{assertion}(*args, &optional_filter_block)
+          end
+
+          def wont_have_#{assertion} *args, &optional_filter_block
+            ::Minitest::Expectation.new(self, ::Minitest::Spec.current).wont_have_#{assertion}(*args, &optional_filter_block)
+          end
+        EOM
+
+        ::Minitest::Expectation.class_eval <<-EOM, __FILE__, __LINE__ + 1
+          def must_have_#{assertion} *args, &optional_filter_block
+            ctx.assert_#{assertion}(target, *args, &optional_filter_block)
+          end
+
+          def wont_have_#{assertion} *args, &optional_filter_block
+            ctx.refute_#{assertion}(target, *args, &optional_filter_block)
+          end
+        EOM
+      end
+
+      %w(selector xpath css).each do |assertion|
+        self.class_eval <<-EOM
+          def must_match_#{assertion} *args, &optional_filter_block
+            ::Minitest::Expectation.new(self, ::Minitest::Spec.current).must_match_#{assertion}(*args, &optional_filter_block)
+          end
+
+          def wont_match_#{assertion} *args, &optional_filter_block
+            ::Minitest::Expectation.new(self, ::Minitest::Spec.current).wont_match_#{assertion}(*args, &optional_filter_block)
+          end
+        EOM
+
+        ::Minitest::Expectation.class_eval <<-EOM, __FILE__, __LINE__ + 1
+          def must_match_#{assertion} *args, &optional_filter_block
+            ctx.assert_matches_#{assertion}(target, *args, &optional_filter_block)
+          end
+
+          def wont_match_#{assertion} *args, &optional_filter_block
+            ctx.refute_matches_#{assertion}(target, *args, &optional_filter_block)
+          end
+        EOM
+      end
+
+      ##
+      # Expectation that there is xpath
+      #
+      # @!method must_have_xpath
+      #   see Capybara::Node::Matchers#has_xpath?
+
+      ##
+      # Expectation that there is no xpath
+      #
+      # @!method wont_have_xpath
+      #   see Capybara::Node::Matchers#has_no_xpath?
+
+      ##
+      # Expectation that there is css
+      #
+      # @!method must_have_css
+      #   see Capybara::Node::Matchers#has_css?
+
+      ##
+      # Expectation that there is no css
+      #
+      # @!method wont_have_css
+      #   see Capybara::Node::Matchers#has_no_css?
+
+      ##
+      # Expectation that there is link
+      #
+      # @!method must_have_link
+      #   see {Capybara::Node::Matchers#has_link?}
+
+      ##
+      # Expectation that there is no link
+      #
+      # @!method wont_have_link
+      # see {Capybara::Node::Matchers#has_no_link?}
+
+      ##
+      # Expectation that there is button
+      #
+      # @!method must_have_button
+      #   see {Capybara::Node::Matchers#has_button?}
+
+      ##
+      # Expectation that there is no button
+      #
+      # @!method wont_have_button
+      #   see {Capybara::Node::Matchers#has_no_button?}
+
+      ##
+      # Expectation that there is field
+      #
+      # @!method must_have_field
+      #   see {Capybara::Node::Matchers#has_field?}
+
+      ##
+      # Expectation that there is no field
+      #
+      # @!method wont_have_field
+      #   see {Capybara::Node::Matchers#has_no_field?}
+
+      ##
+      # Expectation that there is checked_field
+      #
+      # @!method must_have_checked_field
+      #   see {Capybara::Node::Matchers#has_checked_field?}
+
+      ##
+      # Expectation that there is no checked_field
+      #
+      # @!method wont_have_chceked_field
+
+      ##
+      # Expectation that there is unchecked_field
+      #
+      # @!method must_have_unchecked_field
+      #   see {Capybara::Node::Matchers#has_unchecked_field?}
+
+      ##
+      # Expectation that there is no unchecked_field
+      #
+      # @!method wont_have_unchceked_field
+
+      ##
+      # Expectation that there is select
+      #
+      # @!method must_have_select
+      #   see {Capybara::Node::Matchers#has_select?}
+
+      ##
+      # Expectation that there is no select
+      #
+      # @!method wont_have_select
+      #   see {Capybara::Node::Matchers#has_no_select?}
+
+      ##
+      # Expectation that there is table
+      #
+      # @!method must_have_table
+      #   see {Capybara::Node::Matchers#has_table?}
+
+      ##
+      # Expectation that there is no table
+      #
+      # @!method wont_have_table
+      #   see {Capybara::Node::Matchers#has_no_table?}
+
+      ##
+      # Expectation that page title does match
+      #
+      # @!method must_have_title
+      #   see {Capybara::Node::DocumentMatchers#assert_title}
+
+      ##
+      # Expectation that page title does not match
+      #
+      # @!method wont_have_title
+      #   see {Capybara::Node::DocumentMatchers#assert_no_title}
+
+      ##
+      # Expectation that current path matches
+      #
+      # @!method must_have_current_path
+      #   see {Capybara::SessionMatchers#assert_current_path}
+
+      ##
+      # Expectation that current page does not match
+      #
+      # @!method wont_have_current_path
+      #   see {Capybara::SessionMatchers#assert_no_current_path}
+
+    end
+  end
+end
+
+class Capybara::Session
+  include Capybara::Minitest::Expectations unless ENV["MT_NO_EXPECTATIONS"]
+end
+
+class Capybara::Node::Base
+  include Capybara::Minitest::Expectations unless ENV["MT_NO_EXPECTATIONS"]
+end
+
+class Capybara::Node::Simple
+  include Capybara::Minitest::Expectations unless ENV["MT_NO_EXPECTATIONS"]
+end