capybara 2.7.0 → 3.35.3

data/lib/capybara/rspec/matchers/have_sibling.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'capybara/rspec/matchers/base'
+
+module Capybara
+  module RSpecMatchers
+    module Matchers
+      class HaveSibling < CountableWrappedElementMatcher
+        def element_matches?(el)
+          el.assert_sibling(*@args, **session_query_options, &@filter_block)
+        end
+
+        def element_does_not_match?(el)
+          el.assert_no_sibling(*@args, **session_query_options, &@filter_block)
+        end
+
+        def description
+          "have sibling #{query.description}"
+        end
+
+        def query
+          @query ||= Capybara::Queries::SiblingQuery.new(*session_query_args, **session_query_options, &@filter_block)
+        end
+      end
+    end
+  end
+end

data/lib/capybara/rspec/matchers/have_text.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'capybara/rspec/matchers/base'
+
+module Capybara
+  module RSpecMatchers
+    module Matchers
+      class HaveText < CountableWrappedElementMatcher
+        def element_matches?(el)
+          el.assert_text(*@args, **@kw_args)
+        end
+
+        def element_does_not_match?(el)
+          el.assert_no_text(*@args, **@kw_args)
+        end
+
+        def description
+          "have text #{format(text)}"
+        end
+
+        def format(content)
+          content.inspect
+        end
+
+      private
+
+        def text
+          @args[0].is_a?(Symbol) ? @args[1] : @args[0]
+        end
+      end
+    end
+  end
+end

data/lib/capybara/rspec/matchers/have_title.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'capybara/rspec/matchers/base'
+
+module Capybara
+  module RSpecMatchers
+    module Matchers
+      class HaveTitle < WrappedElementMatcher
+        def element_matches?(el)
+          el.assert_title(*@args, **@kw_args)
+        end
+
+        def element_does_not_match?(el)
+          el.assert_no_title(*@args, **@kw_args)
+        end
+
+        def description
+          "have title #{title.inspect}"
+        end
+
+      private
+
+        def title
+          @args.first
+        end
+      end
+    end
+  end
+end

data/lib/capybara/rspec/matchers/match_selector.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'capybara/rspec/matchers/have_selector'
+
+module Capybara
+  module RSpecMatchers
+    module Matchers
+      class MatchSelector < HaveSelector
+        def element_matches?(el)
+          el.assert_matches_selector(*@args, **session_query_options, &@filter_block)
+        end
+
+        def element_does_not_match?(el)
+          el.assert_not_matches_selector(*@args, **session_query_options, &@filter_block)
+        end
+
+        def description
+          "match #{query.description}"
+        end
+
+        def query
+          @query ||= Capybara::Queries::MatchQuery.new(*session_query_args, **session_query_options, &@filter_block)
+        end
+      end
+    end
+  end
+end

data/lib/capybara/rspec/matchers/match_style.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'capybara/rspec/matchers/base'
+
+module Capybara
+  module RSpecMatchers
+    module Matchers
+      class MatchStyle < WrappedElementMatcher
+        def initialize(styles = nil, **kw_args, &filter_block)
+          styles, kw_args = kw_args, {} if styles.nil?
+          super(styles, **kw_args, &filter_block)
+        end
+
+        def element_matches?(el)
+          el.assert_matches_style(*@args, **@kw_args)
+        end
+
+        def does_not_match?(_actual)
+          raise ArgumentError, 'The match_style matcher does not support use with not_to/should_not'
+        end
+
+        def description
+          'match style'
+        end
+      end
+    end
+  end
+end
+
+module Capybara
+  module RSpecMatchers
+    module Matchers
+      ##
+      # @deprecated
+      class HaveStyle < MatchStyle
+        def initialize(*args, **kw_args, &filter_block)
+          warn 'HaveStyle matcher is deprecated, please use the MatchStyle matcher instead'
+          super
+        end
+      end
+    end
+  end
+end

data/lib/capybara/rspec/matchers/spatial_sugar.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Capybara
+  module RSpecMatchers
+    module SpatialSugar
+      def above(el)
+        options[:above] = el
+        self
+      end
+
+      def below(el)
+        options[:below] = el
+        self
+      end
+
+      def left_of(el)
+        options[:left_of] = el
+        self
+      end
+
+      def right_of(el)
+        options[:right_of] = el
+        self
+      end
+
+      def near(el)
+        options[:near] = el
+        self
+      end
+
+    private
+
+      def options
+        # (@args.last.is_a?(Hash) ? @args : @args.push({})).last
+        @kw_args
+      end
+    end
+  end
+end

data/lib/capybara/rspec/matchers.rb

@@ -1,303 +1,202 @@
 # frozen_string_literal: true
+
+require 'capybara/rspec/matchers/have_selector'
+require 'capybara/rspec/matchers/have_ancestor'
+require 'capybara/rspec/matchers/have_sibling'
+require 'capybara/rspec/matchers/match_selector'
+require 'capybara/rspec/matchers/have_current_path'
+require 'capybara/rspec/matchers/match_style'
+require 'capybara/rspec/matchers/have_text'
+require 'capybara/rspec/matchers/have_title'
+require 'capybara/rspec/matchers/become_closed'
+
 module Capybara
   module RSpecMatchers
-    class Matcher
-      include ::RSpec::Matchers::Composable if defined?(::RSpec::Expectations::Version) && (Gem::Version.new(RSpec::Expectations::Version::STRING) >= Gem::Version.new('3.0'))
-
-      def wrap(actual)
-        if actual.respond_to?("has_selector?")
-          actual
-        else
-          Capybara.string(actual.to_s)
-        end
-      end
+    # RSpec matcher for whether the element(s) matching a given selector exist.
+    #
+    # @see Capybara::Node::Matchers#assert_selector
+    def have_selector(*args, **kw_args, &optional_filter_block)
+      Matchers::HaveSelector.new(*args, **kw_args, &optional_filter_block)
     end
 
-    class HaveSelector < Matcher
-      attr_reader :failure_message, :failure_message_when_negated
-
-      def initialize(*args)
-        @args = args
-      end
-
-      def matches?(actual)
-        wrap(actual).assert_selector(*@args)
-      rescue Capybara::ExpectationNotMet => e
-        @failure_message = e.message
-        return false
-      end
-
-      def does_not_match?(actual)
-        wrap(actual).assert_no_selector(*@args)
-      rescue Capybara::ExpectationNotMet => e
-        @failure_message_when_negated = e.message
-        return false
-      end
-
-      def description
-        "have #{query.description}"
-      end
-
-      def query
-        @query ||= Capybara::Queries::SelectorQuery.new(*@args)
-      end
-
-      # RSpec 2 compatibility:
-      alias_method :failure_message_for_should, :failure_message
-      alias_method :failure_message_for_should_not, :failure_message_when_negated
+    # RSpec matcher for whether the element(s) matching a group of selectors exist.
+    #
+    # @see Capybara::Node::Matchers#assert_all_of_selectors
+    def have_all_of_selectors(*args, **kw_args, &optional_filter_block)
+      Matchers::HaveAllSelectors.new(*args, **kw_args, &optional_filter_block)
     end
 
-    class HaveText < Matcher
-      attr_reader :type, :content, :options
-
-      attr_reader :failure_message, :failure_message_when_negated
-
-      def initialize(*args)
-        @args = args.dup
-
-        # are set just for backwards compatability
-        @type = args.shift if args.first.is_a?(Symbol)
-        @content = args.shift
-        @options = (args.first.is_a?(Hash))? args.first : {}
-      end
-
-      def matches?(actual)
-        wrap(actual).assert_text(*@args)
-      rescue Capybara::ExpectationNotMet => e
-        @failure_message = e.message
-        return false
-      end
-
-      def does_not_match?(actual)
-        wrap(actual).assert_no_text(*@args)
-      rescue Capybara::ExpectationNotMet => e
-        @failure_message_when_negated = e.message
-        return false
-      end
-
-      def description
-        "text #{format(content)}"
-      end
-
-      def format(content)
-        content = Capybara::Helpers.normalize_whitespace(content) unless content.is_a? Regexp
-        content.inspect
-      end
-
-      # RSpec 2 compatibility:
-      alias_method :failure_message_for_should, :failure_message
-      alias_method :failure_message_for_should_not, :failure_message_when_negated
+    # RSpec matcher for whether no element(s) matching a group of selectors exist.
+    #
+    # @see Capybara::Node::Matchers#assert_none_of_selectors
+    def have_none_of_selectors(*args, **kw_args, &optional_filter_block)
+      Matchers::HaveNoSelectors.new(*args, **kw_args, &optional_filter_block)
     end
 
-    class HaveTitle < Matcher
-      attr_reader :title
-
-      attr_reader :failure_message, :failure_message_when_negated
-
-      def initialize(*args)
-        @args = args
-
-        # are set just for backwards compatability
-        @title = args.first
-      end
-
-      def matches?(actual)
-        wrap(actual).assert_title(*@args)
-      rescue Capybara::ExpectationNotMet => e
-        @failure_message = e.message
-        return false
-      end
-
-      def does_not_match?(actual)
-        wrap(actual).assert_no_title(*@args)
-      rescue Capybara::ExpectationNotMet => e
-        @failure_message_when_negated = e.message
-        return false
-      end
-
-      def description
-        "have title #{title.inspect}"
-      end
-
-      # RSpec 2 compatibility:
-      alias_method :failure_message_for_should, :failure_message
-      alias_method :failure_message_for_should_not, :failure_message_when_negated
+    # RSpec matcher for whether the element(s) matching any of a group of selectors exist.
+    #
+    # @see Capybara::Node::Matchers#assert_any_of_selectors
+    def have_any_of_selectors(*args, **kw_args, &optional_filter_block)
+      Matchers::HaveAnySelectors.new(*args, **kw_args, &optional_filter_block)
     end
 
-    class HaveCurrentPath < Matcher
-      attr_reader :current_path
-
-      attr_reader :failure_message, :failure_message_when_negated
-
-      def initialize(*args)
-        @args = args
-
-        # are set just for backwards compatability
-        @current_path = args.first
-      end
-
-      def matches?(actual)
-        wrap(actual).assert_current_path(*@args)
-      rescue Capybara::ExpectationNotMet => e
-        @failure_message = e.message
-        return false
-      end
-
-      def does_not_match?(actual)
-        wrap(actual).assert_no_current_path(*@args)
-      rescue Capybara::ExpectationNotMet => e
-        @failure_message_when_negated = e.message
-        return false
-      end
-
-      def description
-        "have current path #{current_path.inspect}"
-      end
-
-      # RSpec 2 compatibility:
-      alias_method :failure_message_for_should, :failure_message
-      alias_method :failure_message_for_should_not, :failure_message_when_negated
+    # RSpec matcher for whether the current element matches a given selector.
+    #
+    # @see Capybara::Node::Matchers#assert_matches_selector
+    def match_selector(*args, **kw_args, &optional_filter_block)
+      Matchers::MatchSelector.new(*args, **kw_args, &optional_filter_block)
     end
 
-    class BecomeClosed
-      def initialize(options)
-        @wait_time = Capybara::Queries::SelectorQuery.new(options).wait
+    %i[css xpath].each do |selector|
+      define_method "have_#{selector}" do |expr, **options, &optional_filter_block|
+        Matchers::HaveSelector.new(selector, expr, **options, &optional_filter_block)
       end
 
-      def matches?(window)
-        @window = window
-        start_time = Capybara::Helpers.monotonic_time
-        while window.exists?
-          return false if (Capybara::Helpers.monotonic_time - start_time) > @wait_time
-          sleep 0.05
-        end
-        true
+      define_method "match_#{selector}" do |expr, **options, &optional_filter_block|
+        Matchers::MatchSelector.new(selector, expr, **options, &optional_filter_block)
       end
-
-      def failure_message
-        "expected #{@window.inspect} to become closed after #{@wait_time} seconds"
-      end
-
-      def failure_message_when_negated
-        "expected #{@window.inspect} not to become closed after #{@wait_time} seconds"
-      end
-
-      # RSpec 2 compatibility:
-      alias_method :failure_message_for_should, :failure_message
-      alias_method :failure_message_for_should_not, :failure_message_when_negated
     end
 
-    class MatchSelector < Matcher
-      attr_reader :failure_message, :failure_message_when_negated
+    # @!method have_xpath(xpath, **options, &optional_filter_block)
+    #   RSpec matcher for whether elements(s) matching a given xpath selector exist.
+    #
+    #   @see Capybara::Node::Matchers#has_xpath?
 
-      def initialize(*args)
-        @args = args
-      end
+    # @!method have_css(css, **options, &optional_filter_block)
+    #   RSpec matcher for whether elements(s) matching a given css selector exist
+    #
+    #   @see Capybara::Node::Matchers#has_css?
 
-      def matches?(actual)
-        actual.assert_matches_selector(*@args)
-      rescue Capybara::ExpectationNotMet => e
-        @failure_message = e.message
-        return false
-      end
+    # @!method match_xpath(xpath, **options, &optional_filter_block)
+    #   RSpec matcher for whether the current element matches a given xpath selector.
+    #
+    #   @see Capybara::Node::Matchers#matches_xpath?
 
-      def does_not_match?(actual)
-        actual.assert_not_matches_selector(*@args)
-      rescue Capybara::ExpectationNotMet => e
-        @failure_message_when_negated = e.message
-        return false
-      end
-
-      def description
-        "match #{query.description}"
-      end
+    # @!method match_css(css, **options, &optional_filter_block)
+    #   RSpec matcher for whether the current element matches a given css selector.
+    #
+    #   @see Capybara::Node::Matchers#matches_css?
 
-      def query
-        @query ||= Capybara::Queries::MatchQuery.new(*@args)
+    %i[link button field select table].each do |selector|
+      define_method "have_#{selector}" do |locator = nil, **options, &optional_filter_block|
+        Matchers::HaveSelector.new(selector, locator, **options, &optional_filter_block)
       end
-
-      # RSpec 2 compatibility:
-      alias_method :failure_message_for_should, :failure_message
-      alias_method :failure_message_for_should_not, :failure_message_when_negated
     end
 
-    def have_selector(*args)
-      HaveSelector.new(*args)
-    end
+    # @!method have_link(locator = nil, **options, &optional_filter_block)
+    #   RSpec matcher for links.
+    #
+    #   @see Capybara::Node::Matchers#has_link?
 
-    def match_selector(*args)
-      MatchSelector.new(*args)
-    end
-    # defined_negated_matcher was added in RSpec 3.1 - it's syntactic sugar only since a user can do
-    # expect(page).not_to match_selector, so not sure we really need to support not_match_selector for prior to RSpec 3.1
-    ::RSpec::Matchers.define_negated_matcher :not_match_selector, :match_selector if defined?(::RSpec::Expectations::Version) && (Gem::Version.new(RSpec::Expectations::Version::STRING) >= Gem::Version.new('3.1'))
+    # @!method have_button(locator = nil, **options, &optional_filter_block)
+    #   RSpec matcher for buttons.
+    #
+    #   @see Capybara::Node::Matchers#has_button?
 
+    # @!method have_field(locator = nil, **options, &optional_filter_block)
+    #   RSpec matcher for form fields.
+    #
+    #   @see Capybara::Node::Matchers#has_field?
 
-    def have_xpath(xpath, options={})
-      HaveSelector.new(:xpath, xpath, options)
-    end
+    # @!method have_select(locator = nil, **options, &optional_filter_block)
+    #   RSpec matcher for select elements.
+    #
+    #   @see Capybara::Node::Matchers#has_select?
 
-    def match_xpath(xpath, options={})
-      MatchSelector.new(:xpath, xpath, options)
-    end
+    # @!method have_table(locator = nil, **options, &optional_filter_block)
+    #   RSpec matcher for table elements.
+    #
+    #   @see Capybara::Node::Matchers#has_table?
 
-    def have_css(css, options={})
-      HaveSelector.new(:css, css, options)
+    %i[checked unchecked].each do |state|
+      define_method "have_#{state}_field" do |locator = nil, **options, &optional_filter_block|
+        Matchers::HaveSelector.new(:field, locator, **options.merge(state => true), &optional_filter_block)
+      end
     end
 
-    def match_css(css, options={})
-      MatchSelector.new(:css, css, options)
-    end
+    # @!method have_checked_field(locator = nil, **options, &optional_filter_block)
+    #   RSpec matcher for checked fields.
+    #
+    #   @see Capybara::Node::Matchers#has_checked_field?
 
-    def have_text(*args)
-      HaveText.new(*args)
-    end
-    alias_method :have_content, :have_text
+    # @!method have_unchecked_field(locator = nil, **options, &optional_filter_block)
+    #   RSpec matcher for unchecked fields.
+    #
+    #   @see Capybara::Node::Matchers#has_unchecked_field?
 
-    def have_title(title, options = {})
-      HaveTitle.new(title, options)
+    # RSpec matcher for text content.
+    #
+    # @see Capybara::Node::Matchers#assert_text
+    def have_text(text_or_type, *args, **options)
+      Matchers::HaveText.new(text_or_type, *args, **options)
     end
+    alias_method :have_content, :have_text
 
-    def have_current_path(path, options = {})
-      HaveCurrentPath.new(path, options)
+    def have_title(title, **options)
+      Matchers::HaveTitle.new(title, **options)
     end
 
-    def have_link(locator, options={})
-      HaveSelector.new(:link, locator, options)
+    # RSpec matcher for the current path.
+    #
+    # @see Capybara::SessionMatchers#assert_current_path
+    def have_current_path(path, **options, &optional_filter_block)
+      Matchers::HaveCurrentPath.new(path, **options, &optional_filter_block)
     end
 
-    def have_button(locator, options={})
-      HaveSelector.new(:button, locator, options)
+    # RSpec matcher for element style.
+    #
+    # @see Capybara::Node::Matchers#matches_style?
+    def match_style(styles = nil, **options)
+      styles, options = options, {} if styles.nil?
+      Matchers::MatchStyle.new(styles, **options)
     end
 
-    def have_field(locator, options={})
-      HaveSelector.new(:field, locator, options)
+    ##
+    # @deprecated
+    #
+    def have_style(styles = nil, **options)
+      Capybara::Helpers.warn "DEPRECATED: have_style is deprecated, please use match_style : #{Capybara::Helpers.filter_backtrace(caller)}"
+      match_style(styles, **options)
     end
 
-    def have_checked_field(locator, options={})
-      HaveSelector.new(:field, locator, options.merge(:checked => true))
+    %w[selector css xpath text title current_path link button
+       field checked_field unchecked_field select table
+       sibling ancestor].each do |matcher_type|
+      define_method "have_no_#{matcher_type}" do |*args, **kw_args, &optional_filter_block|
+        Matchers::NegatedMatcher.new(send("have_#{matcher_type}", *args, **kw_args, &optional_filter_block))
+      end
     end
+    alias_method :have_no_content, :have_no_text
 
-    def have_unchecked_field(locator, options={})
-      HaveSelector.new(:field, locator, options.merge(:unchecked => true))
+    %w[selector css xpath].each do |matcher_type|
+      define_method "not_match_#{matcher_type}" do |*args, **kw_args, &optional_filter_block|
+        Matchers::NegatedMatcher.new(send("match_#{matcher_type}", *args, **kw_args, &optional_filter_block))
+      end
     end
 
-    def have_select(locator, options={})
-      HaveSelector.new(:select, locator, options)
+    # RSpec matcher for whether sibling element(s) matching a given selector exist.
+    #
+    # @see Capybara::Node::Matchers#assert_sibling
+    def have_sibling(*args, **kw_args, &optional_filter_block)
+      Matchers::HaveSibling.new(*args, **kw_args, &optional_filter_block)
     end
 
-    def have_table(locator, options={})
-      HaveSelector.new(:table, locator, options)
+    # RSpec matcher for whether ancestor element(s) matching a given selector exist.
+    #
+    # @see Capybara::Node::Matchers#assert_ancestor
+    def have_ancestor(*args, **kw_args, &optional_filter_block)
+      Matchers::HaveAncestor.new(*args, **kw_args, &optional_filter_block)
     end
 
     ##
     # Wait for window to become closed.
+    #
     # @example
     #   expect(window).to become_closed(wait: 0.8)
-    # @param options [Hash] optional param
-    # @option options [Numeric] :wait (Capybara.default_max_wait_time) Maximum wait time
-    def become_closed(options = {})
-      BecomeClosed.new(options)
+    #
+    # @option options [Numeric] :wait   Maximum wait time. Defaults to {Capybara.configure default_max_wait_time}
+    def become_closed(**options)
+      Matchers::BecomeClosed.new(options)
     end
   end
 end