capybara 2.5.0 → 2.18.0

data/lib/capybara/config.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+require 'forwardable'
+require 'capybara/session/config'
+
+module Capybara
+  class Config
+    extend Forwardable
+
+    OPTIONS = [:app, :reuse_server, :threadsafe, :default_wait_time, :server, :default_driver, :javascript_driver]
+
+    attr_accessor :app
+    attr_reader :reuse_server, :threadsafe
+    attr_reader :session_options
+    attr_writer :default_driver, :javascript_driver
+
+    SessionConfig::OPTIONS.each do |method|
+      def_delegators :session_options, method, "#{method}="
+    end
+
+    def initialize
+      @session_options = Capybara::SessionConfig.new
+    end
+
+    def reuse_server=(bool)
+      @reuse_server = bool
+    end
+
+    def threadsafe=(bool)
+      warn "Capybara.threadsafe == true is a BETA feature and may change in future minor versions" if bool
+      raise "Threadsafe setting cannot be changed once a session is created" if (bool != threadsafe) && Session.instance_created?
+      @threadsafe = bool
+    end
+
+    ##
+    #
+    # Return the proc that Capybara will call to run the Rack application.
+    # The block returned receives a rack app, port, and host/ip and should run a Rack handler
+    # By default, Capybara will try to run webrick.
+    #
+    def server(&block)
+      if block_given?
+        warn "DEPRECATED: Passing a block to Capybara::server is deprecated, please use Capybara::register_server instead"
+        @server = block
+      else
+        @server
+      end
+    end
+
+    ##
+    #
+    # Set the server to use.
+    #
+    #     Capybara.server = :webrick
+    #     Capybara.server = :puma, { Silent: true }
+    #
+    # @overload server=(name)
+    #   @param [Symbol] name     Name of the server type to use
+    # @overload server=([name, options])
+    #   @param [Symbol] name Name of the server type to use
+    #   @param [Hash] options Options to pass to the server block
+    # @see register_server
+    #
+    def server=(name)
+      name, options = *name if name.is_a? Array
+      @server = if name.respond_to? :call
+        name
+      else
+        if options
+          Proc.new { |app, port, host| Capybara.servers[name.to_sym].call(app,port,host,options) }
+        else
+          Capybara.servers[name.to_sym]
+        end
+      end
+    end
+
+    ##
+    #
+    # @return [Symbol]    The name of the driver to use by default
+    #
+    def default_driver
+      @default_driver || :rack_test
+    end
+
+    ##
+    #
+    # @return [Symbol]    The name of the driver used when JavaScript is needed
+    #
+    def javascript_driver
+      @javascript_driver || :selenium
+    end
+
+    # @deprecated Use default_max_wait_time instead
+    def default_wait_time
+      deprecate('default_wait_time', 'default_max_wait_time', true)
+      default_max_wait_time
+    end
+
+    # @deprecated Use default_max_wait_time= instead
+    def default_wait_time=(t)
+      deprecate('default_wait_time=', 'default_max_wait_time=')
+      self.default_max_wait_time = t
+    end
+
+    def deprecate(method, alternate_method, once=false)
+      @deprecation_notified ||= {}
+      warn "DEPRECATED: ##{method} is deprecated, please use ##{alternate_method} instead" unless once and @deprecation_notified[method]
+      @deprecation_notified[method]=true
+    end
+  end
+
+  # @api private
+  class ConfigureDeprecator
+    def initialize(config)
+      @config = config
+    end
+
+    def method_missing(m, *args, &block)
+      if @config.respond_to?(m)
+        @config.public_send(m, *args, &block)
+      elsif Capybara.respond_to?(m)
+        warn "Calling #{m} from Capybara.configure is deprecated - please call it on Capybara directly ( Capybara.#{m}(...) )"
+        Capybara.public_send(m, *args, &block)
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(m, include_private = false)
+      @config.respond_to?(m) || Capybara.respond_to?(m) || super
+    end
+  end
+end

data/lib/capybara/cucumber.rb

@@ -1,5 +1,7 @@
-require 'capybara'
+# frozen_string_literal: true
+require 'capybara/dsl'
 require 'capybara/rspec/matchers'
+require 'capybara/rspec/matcher_proxies'
 
 World(Capybara::DSL)
 World(Capybara::RSpecMatchers)

data/lib/capybara/driver/base.rb

@@ -1,4 +1,7 @@
+# frozen_string_literal: true
 class Capybara::Driver::Base
+  attr_writer :session
+
   def current_url
     raise NotImplementedError
   end
@@ -7,6 +10,10 @@ class Capybara::Driver::Base
     raise NotImplementedError
   end
 
+  def refresh
+    raise NotImplementedError
+  end
+
   def find_xpath(query)
     raise NotImplementedError
   end
@@ -27,14 +34,18 @@ class Capybara::Driver::Base
     raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#go_forward'
   end
 
-  def execute_script(script)
+  def execute_script(script, *args)
     raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#execute_script'
   end
 
-  def evaluate_script(script)
+  def evaluate_script(script, *args)
     raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#evaluate_script'
   end
 
+  def evaluate_async_script(script, *args)
+    raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#evaluate_script_asnyc'
+  end
+
   def save_screenshot(path, options={})
     raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#save_screenshot'
   end
@@ -47,8 +58,12 @@ class Capybara::Driver::Base
     raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#status_code'
   end
 
-  def within_frame(frame_handle)
-    raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#within_frame'
+  ##
+  #
+  # @param frame [Capybara::Node::Element, :parent, :top]  The iframe element to switch to
+  #
+  def switch_to_frame(frame)
+    raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#switch_to_frame'
   end
 
   def current_window_handle
@@ -90,8 +105,8 @@ class Capybara::Driver::Base
   def no_such_window_error
     raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#no_such_window_error'
   end
-  
-  
+
+
   ##
   #
   # Execute the block, and then accept the modal opened.
@@ -134,7 +149,13 @@ class Capybara::Driver::Base
     false
   end
 
+  def session_options
+    (@session && @session.config) || Capybara.session_options
+  end
+
+  # @deprecated This method is being removed
   def browser_initialized?
+    warn "DEPRECATED: #browser_initialized? is deprecated and will be removed in the next version of Capybara"
     true
   end
 end

data/lib/capybara/driver/node.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 module Capybara
   module Driver
     class Node
@@ -41,23 +42,23 @@ module Capybara
       def click
         raise NotImplementedError
       end
-      
+
       def right_click
         raise NotImplementedError
       end
-      
+
       def double_click
         raise NotImplementedError
       end
-      
+
       def send_keys(*args)
         raise NotImplementedError
       end
-      
+
       def hover
         raise NotImplementedError
       end
-      
+
       def drag_to(element)
         raise NotImplementedError
       end
@@ -82,6 +83,14 @@ module Capybara
         raise NotImplementedError
       end
 
+      def readonly?
+        !!self[:readonly]
+      end
+
+      def multiple?
+        !!self[:multiple]
+      end
+
       def path
         raise NotSupportedByDriverError, 'Capybara::Driver::Node#path'
       end

data/lib/capybara/dsl.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 require 'capybara'
 
 module Capybara
@@ -20,12 +21,10 @@ module Capybara
       Capybara.using_session(name, &block)
     end
 
-    ##
-    #
     # Shortcut to using a different wait time.
     #
     def using_wait_time(seconds, &block)
-      Capybara.using_wait_time(seconds, &block)
+      page.using_wait_time(seconds, &block)
     end
 
     ##

data/lib/capybara/helpers.rb

@@ -1,4 +1,5 @@
 # encoding: UTF-8
+# frozen_string_literal: true
 
 module Capybara
 
@@ -27,8 +28,14 @@ module Capybara
     # @param [String] text Text to escape
     # @return [String]     Escaped text
     #
-    def to_regexp(text)
-      text.is_a?(Regexp) ? text : Regexp.new(Regexp.escape(normalize_whitespace(text)))
+    def to_regexp(text, regexp_options=nil, exact=false)
+      if text.is_a?(Regexp)
+        text
+      else
+        escaped = Regexp.escape(normalize_whitespace(text))
+        escaped = "\\A#{escaped}\\z" if exact
+        Regexp.new(escaped, regexp_options)
+      end
     end
 
     ##
@@ -39,76 +46,17 @@ module Capybara
     # @param [String] html     HTML code to inject into
     # @return [String]         The modified HTML code
     #
-    def inject_asset_host(html)
-      if Capybara.asset_host && Nokogiri::HTML(html).css("base").empty?
+    def inject_asset_host(html, asset_host = Capybara.asset_host)
+      if asset_host && Nokogiri::HTML(html).css("base").empty?
         match = html.match(/<head[^<]*?>/)
         if match
-          return html.clone.insert match.end(0), "<base href='#{Capybara.asset_host}' />"
+          return html.clone.insert match.end(0), "<base href='#{asset_host}' />"
         end
       end
 
       html
     end
 
-    ##
-    #
-    # Checks if the given count matches the given count options.
-    # Defaults to true if no options are specified. If multiple
-    # options are provided, it tests that all conditions are met;
-    # however, if :count is supplied, all other options are ignored.
-    #
-    # @param [Integer] count     The actual number. Should be coercible via Integer()
-    # @option [Range] between    Count must be within the given range
-    # @option [Integer] count    Count must be exactly this
-    # @option [Integer] maximum  Count must be smaller than or equal to this value
-    # @option [Integer] minimum  Count must be larger than or equal to this value
-    #
-    def matches_count?(count, options={})
-      return (Integer(options[:count]) == count)     if options[:count]
-      return false if options[:maximum] && (Integer(options[:maximum]) < count)
-      return false if options[:minimum] && (Integer(options[:minimum]) > count)
-      return false if options[:between] && !(options[:between] === count)
-      return true
-    end
-
-    ##
-    #
-    # Checks if a count of 0 is valid for the given options hash.
-    # Returns false if options hash does not specify any count options.
-    #
-    def expects_none?(options={})
-      if [:count, :maximum, :minimum, :between].any? { |k| options.has_key? k }
-        matches_count?(0,options)
-      else
-        false
-      end
-    end
-
-    ##
-    #
-    # Generates a failure message given a description of the query and count
-    # options.
-    #
-    # @param [String] description   Description of a query
-    # @option [Range] between       Count should have been within the given range
-    # @option [Integer] count       Count should have been exactly this
-    # @option [Integer] maximum     Count should have been smaller than or equal to this value
-    # @option [Integer] minimum     Count should have been larger than or equal to this value
-    #
-    def failure_message(description, options={})
-      message = "expected to find #{description}"
-      if options[:count]
-        message << " #{options[:count]} #{declension('time', 'times', options[:count])}"
-      elsif options[:between]
-        message << " between #{options[:between].first} and #{options[:between].last} times"
-      elsif options[:maximum]
-        message << " at most #{options[:maximum]} #{declension('time', 'times', options[:maximum])}"
-      elsif options[:minimum]
-        message << " at least #{options[:minimum]} #{declension('time', 'times', options[:minimum])}"
-      end
-      message
-    end
-
     ##
     #
     # A poor man's `pluralize`. Given two declensions, one singular and one
@@ -129,7 +77,7 @@ module Capybara
 
     if defined?(Process::CLOCK_MONOTONIC)
       def monotonic_time
-       Process.clock_gettime Process::CLOCK_MONOTONIC
+        Process.clock_gettime Process::CLOCK_MONOTONIC
       end
     else
       def monotonic_time

data/lib/capybara/minitest/spec.rb

@@ -0,0 +1,177 @@
+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
+
+      (%w(selector xpath css link button field select table checked_field unchecked_field).flat_map do |assertion|
+        [["assert_#{assertion}", "must_have_#{assertion}"],
+         ["refute_#{assertion}", "wont_have_#{assertion}"]]
+      end + [["assert_all_of_selectors", "must_have_all_of_selectors"],
+             ["assert_none_of_selectors", "must_have_none_of_selectors"]] +
+      %w(selector xpath css).flat_map do |assertion|
+        [["assert_matches_#{assertion}", "must_match_#{assertion}"],
+         ["refute_matches_#{assertion}", "wont_match_#{assertion}"]]
+      end).each do |(meth, new_name)|
+        self.class_eval <<-EOM, __FILE__, __LINE__ + 1
+          def #{new_name} *args, &block
+            ::Minitest::Expectation.new(self, ::Minitest::Spec.current).#{new_name}(*args, &block)
+          end
+        EOM
+
+        ::Minitest::Expectation.class_eval <<-EOM, __FILE__, __LINE__ + 1
+          def #{new_name} *args, &block
+            ctx.#{meth}(target, *args, &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