hardbap-webrat 0.5.1

data/lib/webrat/core/matchers/have_content.rb

@@ -0,0 +1,73 @@
+module Webrat
+  module Matchers
+
+    class HasContent #:nodoc:
+      def initialize(content)
+        @content = content
+      end
+
+      def matches?(stringlike)
+        if Webrat.configuration.parse_with_nokogiri?
+          @document = Webrat.nokogiri_document(stringlike)
+        else
+          @document = Webrat.hpricot_document(stringlike)
+        end
+
+        @element = Webrat::XML.inner_text(@document)
+
+        case @content
+        when String
+          @element.include?(@content)
+        when Regexp
+          @element.match(@content)
+        end
+      end
+
+      # ==== Returns
+      # String:: The failure message.
+      def failure_message
+        "expected the following element's content to #{content_message}:\n#{squeeze_space(@element)}"
+      end
+
+      # ==== Returns
+      # String:: The failure message to be displayed in negative matches.
+      def negative_failure_message
+        "expected the following element's content to not #{content_message}:\n#{squeeze_space(@element)}"
+      end
+
+      def squeeze_space(inner_text)
+        inner_text.gsub(/^\s*$/, "").squeeze("\n")
+      end
+
+      def content_message
+        case @content
+        when String
+          "include \"#{@content}\""
+        when Regexp
+          "match #{@content.inspect}"
+        end
+      end
+    end
+
+    # Matches the contents of an HTML document with
+    # whatever string is supplied
+    def contain(content)
+      HasContent.new(content)
+    end
+
+    # Asserts that the body of the response contain
+    # the supplied string or regexp
+    def assert_contain(content)
+      hc = HasContent.new(content)
+      assert hc.matches?(response_body), hc.failure_message
+    end
+
+    # Asserts that the body of the response
+    # does not contain the supplied string or regepx
+    def assert_not_contain(content)
+      hc = HasContent.new(content)
+      assert !hc.matches?(response_body), hc.negative_failure_message
+    end
+
+  end
+end

data/lib/webrat/core/matchers/have_selector.rb

@@ -0,0 +1,74 @@
+require "webrat/core/matchers/have_xpath"
+
+module Webrat
+  module Matchers
+
+    class HaveSelector < HaveXpath #:nodoc:
+      # ==== Returns
+      # String:: The failure message.
+      def failure_message
+        "expected following output to contain a #{tag_inspect} tag:\n#{@document}"
+      end
+
+      # ==== Returns
+      # String:: The failure message to be displayed in negative matches.
+      def negative_failure_message
+        "expected following output to omit a #{tag_inspect}:\n#{@document}"
+      end
+
+      def tag_inspect
+        options = @options.dup
+        count = options.delete(:count)
+        content = options.delete(:content)
+
+        html = "<#{@expected}"
+        options.each do |k,v|
+          html << " #{k}='#{v}'"
+        end
+
+        if content
+          html << ">#{content}</#{@expected}>"
+        else
+          html << "/>"
+        end
+
+        html
+      end
+
+      def query
+        Nokogiri::CSS.parse(@expected.to_s).map do |ast|
+          ast.to_xpath
+        end.first
+      end
+
+    end
+
+    # Matches HTML content against a CSS 3 selector.
+    #
+    # ==== Parameters
+    # expected<String>:: The CSS selector to look for.
+    #
+    # ==== Returns
+    # HaveSelector:: A new have selector matcher.
+    def have_selector(name, attributes = {}, &block)
+      HaveSelector.new(name, attributes, &block)
+    end
+    alias_method :match_selector, :have_selector
+
+
+    # Asserts that the body of the response contains
+    # the supplied selector
+    def assert_have_selector(name, attributes = {}, &block)
+      matcher = HaveSelector.new(name, attributes, &block)
+      assert matcher.matches?(response_body), matcher.failure_message
+    end
+
+    # Asserts that the body of the response
+    # does not contain the supplied string or regepx
+    def assert_have_no_selector(name, attributes = {}, &block)
+      matcher = HaveSelector.new(name, attributes, &block)
+      assert !matcher.matches?(response_body), matcher.negative_failure_message
+    end
+
+  end
+end

data/lib/webrat/core/matchers/have_tag.rb

@@ -0,0 +1,21 @@
+require "webrat/core/matchers/have_selector"
+
+module Webrat
+  module HaveTagMatcher
+
+    def have_tag(*args, &block)
+      have_selector(*args, &block)
+    end
+
+    alias_method :match_tag, :have_tag
+
+    def assert_have_tag(*args, &block)
+      assert_have_selector(*args, &block)
+    end
+
+    def assert_have_no_tag(*args, &block)
+      assert_have_no_selector(*args, &block)
+    end
+
+  end
+end

data/lib/webrat/core/matchers/have_xpath.rb

@@ -0,0 +1,147 @@
+require "webrat/core/xml/nokogiri"
+require "webrat/core/xml/rexml"
+
+module Webrat
+  module Matchers
+
+    class HaveXpath #:nodoc:
+      def initialize(expected, options = {}, &block)
+        @expected = expected
+        @options  = options
+        @block    = block
+      end
+
+      def matches?(stringlike, &block)
+        @block ||= block
+        matched = matches(stringlike)
+
+        if @options[:count]
+          matched.size == @options[:count] && (!@block || @block.call(matched))
+        else
+          matched.any? && (!@block || @block.call(matched))
+        end
+      end
+
+      def matches(stringlike)
+        if Webrat.configuration.parse_with_nokogiri?
+          nokogiri_matches(stringlike)
+        else
+          rexml_matches(stringlike)
+        end
+      end
+
+      def rexml_matches(stringlike)
+        if REXML::Node === stringlike || Array === stringlike
+          @query = query.map { |q| q.gsub(%r'^//', './/') }
+        else
+          @query = query
+        end
+
+        add_options_conditions_to(@query)
+
+        @document = Webrat.rexml_document(stringlike)
+
+        @query.map do |q|
+          if @document.is_a?(Array)
+            @document.map { |d| REXML::XPath.match(d, q) }
+          else
+            REXML::XPath.match(@document, q)
+          end
+        end.flatten.compact
+      end
+
+      def nokogiri_matches(stringlike)
+        if Nokogiri::XML::NodeSet === stringlike
+          @query = query.gsub(%r'^//', './/')
+        else
+          @query = query
+        end
+
+        add_options_conditions_to(@query)
+
+        @document = Webrat::XML.document(stringlike)
+        @document.xpath(*@query)
+      end
+
+      def add_options_conditions_to(query)
+        add_attributes_conditions_to(query)
+        add_content_condition_to(query)
+      end
+
+      def add_attributes_conditions_to(query)
+        attribute_conditions = []
+
+        @options.each do |key, value|
+          next if [:content, :count].include?(key)
+          attribute_conditions << "@#{key} = #{xpath_escape(value)}"
+        end
+
+        if attribute_conditions.any?
+          query << "[#{attribute_conditions.join(' and ')}]"
+        end
+      end
+
+      def add_content_condition_to(query)
+        if @options[:content]
+          query << "[contains(., #{xpath_escape(@options[:content])})]"
+        end
+      end
+
+      def query
+        @expected
+      end
+
+      # ==== Returns
+      # String:: The failure message.
+      def failure_message
+        "expected following text to match xpath #{@expected}:\n#{@document}"
+      end
+
+      # ==== Returns
+      # String:: The failure message to be displayed in negative matches.
+      def negative_failure_message
+        "expected following text to not match xpath #{@expected}:\n#{@document}"
+      end
+
+    protected
+
+      def xpath_escape(string)
+        if string.include?("'") && string.include?('"')
+          parts = string.split("'").map do |part|
+            "'#{part}'"
+          end
+
+          "concat(" + parts.join(", \"'\", ") + ")"
+        elsif string.include?("'")
+          "\"#{string}\""
+        else
+          "'#{string}'"
+        end
+      end
+
+    end
+
+    # Matches HTML content against an XPath query
+    #
+    # ==== Parameters
+    # expected<String>:: The XPath query to look for.
+    #
+    # ==== Returns
+    # HaveXpath:: A new have xpath matcher.
+    def have_xpath(expected, options = {}, &block)
+      HaveXpath.new(expected, options, &block)
+    end
+    alias_method :match_xpath, :have_xpath
+
+    def assert_have_xpath(expected, options = {}, &block)
+      hs = HaveXpath.new(expected, options, &block)
+      assert hs.matches?(response_body), hs.failure_message
+    end
+
+    def assert_have_no_xpath(expected, options = {}, &block)
+      hs = HaveXpath.new(expected, options, &block)
+      assert !hs.matches?(response_body), hs.negative_failure_message
+    end
+
+  end
+end

data/lib/webrat/core/matchers.rb

@@ -0,0 +1,4 @@
+require "webrat/core/matchers/have_xpath"
+require "webrat/core/matchers/have_selector"
+require "webrat/core/matchers/have_tag"
+require "webrat/core/matchers/have_content"

data/lib/webrat/core/methods.rb

@@ -0,0 +1,63 @@
+module Webrat
+  module Methods #:nodoc:
+
+    def self.delegate_to_session(*meths)
+      meths.each do |meth|
+        self.class_eval <<-RUBY
+          def #{meth}(*args, &blk)
+            webrat_adapter.#{meth}(*args, &blk)
+          end
+        RUBY
+      end
+    end
+
+    def webrat
+      webrat_session
+    end
+
+    def webrat_session
+      @_webrat_session ||= ::Webrat::Session.new(webrat_adapter)
+    end
+
+    def webrat_adapter
+      @_webrat_adapter ||= Webrat.session_class.new(self)
+    end
+
+    # all of these methods delegate to the @session, which should
+    # be created transparently.
+    #
+    # Note that when using Webrat, #request also uses @session, so
+    # that #request and webrat native functions behave interchangably
+
+    delegate_to_session \
+      :visits, :visit,
+      :within,
+      :header, :http_accept, :basic_auth,
+      :save_and_open_page,
+      :fills_in, :fill_in,
+      :checks, :check,
+      :unchecks, :uncheck,
+      :chooses, :choose,
+      :selects, :select,
+      :attaches_file, :attach_file,
+      :current_page,
+      :current_url,
+      :clicks_link, :click_link,
+      :clicks_area, :click_area,
+      :clicks_button, :click_button,
+      :reload, :reloads,
+      :clicks_link_within, :click_link_within,
+      :field_labeled,
+      :select_option,
+      :set_hidden_field, :submit_form,
+      :request_page, :current_dom,
+      :response_body,
+      :selects_date, :selects_time, :selects_datetime,
+      :select_date, :select_time, :select_datetime,
+      :field_by_xpath,
+      :field_with_id,
+      :selenium,
+      :simulate, :automate,
+      :field_named
+  end
+end

data/lib/webrat/core/mime.rb

@@ -0,0 +1,18 @@
+module Webrat #:nodoc:
+  module MIME #:nodoc:
+    MIME_TYPES = Rack::Mime::MIME_TYPES.dup.merge(
+      ".multipart_form"   => "multipart/form-data",
+      ".url_encoded_form" => "application/x-www-form-urlencoded"
+    ).freeze
+
+    def mime_type(type)
+      return type if type.nil? || type.to_s.include?("/")
+      type = ".#{type}" unless type.to_s[0] == ?.
+      MIME_TYPES.fetch(type) { |type|
+        raise ArgumentError.new("Invalid Mime type: #{type}")
+      }
+    end
+
+    module_function :mime_type
+  end
+end

data/lib/webrat/core/save_and_open_page.rb

@@ -0,0 +1,48 @@
+module Webrat
+  module SaveAndOpenPage
+    # Saves the page out to RAILS_ROOT/tmp/ and opens it in the default
+    # web browser if on OS X. Useful for debugging.
+    #
+    # Example:
+    #   save_and_open_page
+    def save_and_open_page
+      return unless File.exist?(saved_page_dir)
+
+      filename = "#{saved_page_dir}/webrat-#{Time.now.to_i}.html"
+
+      File.open(filename, "w") do |f|
+        f.write rewrite_css_and_image_references(response_body)
+      end
+
+      open_in_browser(filename)
+    end
+
+    def open_in_browser(path) # :nodoc
+      require "launchy"
+      Launchy::Browser.run(path)
+    rescue LoadError
+      warn "Sorry, you need to install launchy to open pages: `gem install launchy`"
+    end
+
+    def rewrite_css_and_image_references(response_html) # :nodoc:
+      return response_html unless doc_root
+      response_html.gsub(/("|')\/(stylesheets|images)/, '\1' + doc_root + '/\2')
+    end
+
+    def saved_page_dir #:nodoc:
+      File.expand_path(".")
+    end
+
+    def doc_root #:nodoc:
+      nil
+    end
+
+  private
+
+    # accessor for testing
+    def ruby_platform
+      RUBY_PLATFORM
+    end
+
+  end
+end