rspec-html-matchers 0.2.2

data/rspec-html-matchers.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "rspec-html-matchers"
+  s.version     = '0.2.2'
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["kucaahbe"]
+  s.email       = ["kucaahbe@ukr.net"]
+  s.homepage    = "http://github.com/kucaahbe/rspec-html-matchers"
+  s.summary     = %q{Nokogiri based 'have_tag' and 'with_tag' matchers for rspec 2.x.x}
+  s.description = <<DESC
+#{s.summary}. Does not depend on assert_select matcher, provides useful error messages.
+DESC
+
+  s.rubyforge_project = "rspec-html-matchers"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'rspec', '>= 2.0.0'
+  s.add_dependency 'nokogiri', '>= 1.4.4'
+
+  s.add_development_dependency 'simplecov'
+  s.add_development_dependency 'rake'
+end

data/script/assets.rb

@@ -0,0 +1,38 @@
+class Asset
+  @@assets = {}
+
+  PATH = File.expand_path(File.join(File.dirname(__FILE__),'..','assets','*.html'))
+
+  def self.[] name
+    @@assets[name.to_s]
+  end
+
+  def self.<< asset
+    @@assets.merge! asset.name => asset
+  end
+
+  def self.list
+    @@assets.keys
+  end
+
+  attr_reader :name
+
+  def initialize name, path
+    @name = name
+    @path = path
+  end
+
+  def content
+    @content ||= IO.read(@path)
+    puts @content
+    return @content
+  end
+  alias_method :c, :content
+end
+
+puts 'assets list:'
+Dir[Asset::PATH].each do |asset_path|
+  asset_name = File.basename(asset_path,'.html')
+  puts asset_name
+  Asset << Asset.new(asset_name,asset_path)
+end

data/script/console

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'bundler/setup'
+require 'nokogiri'
+require File.join(File.dirname(__FILE__),'assets.rb')
+require 'irb'
+
+IRB.start

data/spec/matchers/form_matchers_spec.rb

@@ -0,0 +1,310 @@
+require 'spec_helper'
+
+describe "have_form" do
+  let(:rendered) { IO.read(File.dirname(__FILE__)+"/../../assets/form.html") }
+
+  context "without &block" do
+    it "should find form" do
+      rendered.should have_form("/books", :post)
+      self.should_receive(:have_tag).with("form#new_book", :with => { :method => "post", :action => "/books", :class => %w(book formtastic) })
+      rendered.should have_form("/books", "post", :with => { :id => "new_book", :class => %w(book formtastic) })
+    end
+
+    it "should not find form" do
+      rendered.should_not have_form("/some_url", :post)
+      rendered.should_not have_form("/books", :get)
+    end
+  end
+
+  context "with &block" do
+    context "with_select" do
+      it "should find select" do
+        rendered.should have_form("/books", :post) do
+          with_select("book[publisher_id]", :with => { :id => "book_publisher_id" })
+          self.should_receive(:have_tag).with("select#book_publisher_id", :with => { :name => "book[publisher_id]" })
+          with_select("book[publisher_id]", :with => { :id => "book_publisher_id" })
+        end
+      end
+
+      it "should not find select" do
+        rendered.should have_form("/books", :post) do
+          without_select("book[publisher_id]", :with => { :id => "other_id" })
+          self.should_receive(:have_tag).with("select#book_publisher_id", :with => { :name => "koob[publisher_id]" })
+          without_select("koob[publisher_id]", :with => { :id => "book_publisher_id" })
+        end
+      end
+
+      context "with_option" do
+        it "should find options" do
+          rendered.should have_form("/books", :post) do
+            with_select("book[publisher_id]") do
+              with_option(nil)
+              with_option("The Pragmatic Bookshelf", :selected => true)
+              with_option(/sitepoint/,2)
+              self.should_receive(:have_tag).with('option', :with => { :value => '3' }, :text => "O'Reilly")
+              with_option("O'Reilly", 3, :selected => false)
+            end
+          end
+        end
+
+        it "should not find options" do
+          rendered.should have_form("/books", :post) do
+            with_select("book[publisher_id]") do
+              without_option("blah blah")
+              without_option("O'Reilly", 3, :selected => true)
+              without_option("O'Reilly", 100500)
+            end
+          end
+        end
+      end
+
+      context "with_button" do
+        it "should find button" do
+          rendered.should have_form("/books", :post) do
+            self.should_receive(:have_tag).with('button', :with => {}, :text => "Cancel Book")
+            with_button("Cancel Book")
+          end
+        end
+
+        it "should not find button" do
+          rendered.should have_form("/books", :post) do
+            without_button("Cancel Book")
+          end
+        end
+      end
+    end
+
+    context "with_hidden_field" do
+      it "should find hidden field" do
+        rendered.should have_form("/books", :post) do
+          with_hidden_field("authenticity_token")
+          self.should_receive(:have_tag).with('input', :with => {
+            :name => 'authenticity_token',
+            :type => 'hidden',
+            :value => '718WaH76RAbIVhDlnOidgew62ikn8IUCOyWLEqjw1GE='
+          })
+          with_hidden_field("authenticity_token", '718WaH76RAbIVhDlnOidgew62ikn8IUCOyWLEqjw1GE=')
+        end
+      end
+
+      it "should not find hidden field" do
+        rendered.should have_form("/books", :post) do
+          without_hidden_field('user_id')
+          without_hidden_field('authenticity_token', 'blabla')
+        end
+      end
+    end
+
+    context "with_text_field" do
+      it "should find text field" do
+        rendered.should have_form("/books", :post) do
+          with_text_field('book[title]')
+          with_text_field('book[title]',nil)
+          with_text_field('book[author]','Authorname')
+        end
+      end
+
+      it "should not find text field" do
+        rendered.should have_form("/books", :post) do
+          without_text_field('book[title]','title does not exist')
+          without_text_field('book[authoRR]')
+          without_text_field('book[blabla]')
+        end
+      end
+    end
+
+    context "with_email_field" do
+      it "should find email field" do
+        rendered.should have_form("/books", :post) do
+          with_email_field('user[email]')
+          with_email_field('user[email]', 'email@example.com')
+          with_email_field('user[email_confirmation]', nil)
+        end
+      end
+
+      it "should not find email field" do
+        rendered.should have_form("/books", :post) do
+          without_email_field('book[author]','Authorname')
+          without_email_field('user[emaiL]')
+          without_email_field('user[apocalyptiq]')
+        end
+      end
+    end
+
+    context "with_url_field" do
+      it "should find url field" do
+        rendered.should have_form("/books", :post) do
+          with_url_field('user[url]')
+          with_url_field('user[url]', 'http://user.com')
+        end
+      end
+
+      it "should not find url field" do
+        rendered.should have_form("/books", :post) do
+          without_url_field('user[url]','Authorname')
+          without_url_field('user[emaiL]')
+          without_url_field('user[apocalyptiq]')
+        end
+      end
+    end
+
+    context "with_number_field" do
+      it "should find number field" do
+        rendered.should have_form("/books", :post) do
+          with_number_field('number')
+          with_number_field('number_defined', 3)
+          with_number_field('number_defined', '3')
+        end
+      end
+
+      it "should not find number field" do
+        rendered.should have_form("/books", :post) do
+          without_number_field('number',400)
+          without_number_field('number','400')
+          without_number_field('user[emaiL]')
+          without_number_field('user[apocalyptiq]')
+        end
+      end
+    end
+
+    context "with_range_field" do
+      it "should find range field" do
+        rendered.should have_form("/books", :post) do
+          with_range_field('range1', 1, 3)
+          with_range_field('range1','1','3')
+          with_range_field('range2', 1, 3, :with => { :value => 2 } )
+          with_range_field('range2', 1, 3, :with => { :value => '2' } )
+        end
+      end
+
+      it "should not find range field" do
+        rendered.should have_form("/books", :post) do
+          without_range_field('number')
+          without_range_field('range1', 1, 5)
+          without_range_field('range2', 1, 3, :with => { :value => 5 } )
+        end
+      end
+    end
+
+    context "with_date_field" do
+      it "should find date field" do
+        rendered.should have_form("/books", :post) do
+          with_date_field(:date)
+          with_date_field(:date, 'book_date')
+          with_date_field(:month, 'book_month', :with => { :value => 5 })
+          with_date_field(:week,'book_week')
+          with_date_field(:time, 'book_time')
+          with_date_field(:datetime, 'book_datetime')
+          with_date_field('datetime-local', 'book_datetime_local')
+        end
+      end
+
+      it "should not find date field" do
+        rendered.should have_form("/books", :post) do
+          without_date_field(:date, 'book_something')
+          without_date_field(:month, 'book_month', :with => { :value => 100500 })
+        end
+      end
+
+      it "should raise exception if wrong date field type specified" do
+        expect do
+          rendered.should have_form("/books", :post) do
+            without_date_field(:unknown, 'book_something')
+          end
+        end.to raise_error('unknown type `unknown` for date picker')
+        expect do
+          rendered.should have_form("/books", :post) do
+            with_date_field(:unknown, 'book_something')
+          end
+        end.to raise_error('unknown type `unknown` for date picker')
+      end
+    end
+
+    context "with_password_field" do
+      it "should find password field" do
+        rendered.should have_form("/books", :post) do
+          with_password_field('user[password]')
+        end
+      end
+
+      it "should not find password field" do
+        rendered.should have_form("/books", :post) do
+          without_password_field('account[password]')
+        end
+      end
+    end
+
+    context "with_file_field" do
+      it "should find file field" do
+        rendered.should have_form("/books", :post) do
+          with_file_field('form[file]')
+        end
+      end
+
+      it "should not find file field" do
+        rendered.should have_form("/books", :post) do
+          without_file_field('user[file]')
+        end
+      end
+    end
+
+    context "with_text_area" do
+      it "should find text area" do
+        rendered.should have_form("/books", :post) do
+          with_text_area('book[description]')
+        end
+      end
+
+      it "should not find text area" do
+        rendered.should have_form("/books", :post) do
+          without_text_area('user[bio]')
+        end
+      end
+    end
+
+    context "with_check_box" do
+      it "should find check box" do
+        rendered.should have_form("/books", :post) do
+          with_checkbox("book[still_in_print]")
+          with_checkbox("book[still_in_print]","1")
+        end
+      end
+
+      it "should not find check box" do
+        rendered.should have_form("/books", :post) do
+          without_checkbox("book[book]")
+          without_checkbox("book[still_in_print]","500")
+        end
+      end
+    end
+
+    context "with_radio_button" do
+      it "should find radio button" do
+        rendered.should have_form("/books", :post) do
+          with_radio_button("form[name]","true")
+        end
+      end
+
+      it "should not find radio button" do
+        rendered.should have_form("/books", :post) do
+          without_radio_button("form[name]","100500")
+          without_radio_button("form[item]","false")
+        end
+      end
+    end
+
+    context "with_submit" do
+      it "should find submit" do
+        rendered.should have_form("/books", :post) do
+          with_submit("Create Book")
+        end
+      end
+
+      it "should not find submit" do
+        rendered.should have_form("/books", :post) do
+          without_submit("Destroy Book")
+        end
+      end
+    end
+  end
+end

data/spec/matchers/have_tag_spec.rb

@@ -0,0 +1,346 @@
+require 'spec_helper'
+
+describe 'have_tag' do
+  context "through css selector" do
+    let(:rendered) { asset('search_and_submit') }
+
+    it "should find tags" do
+      rendered.should have_tag('div')
+      rendered.should have_tag(:div)
+      rendered.should have_tag('div#div')
+      rendered.should have_tag('p.paragraph')
+      rendered.should have_tag('div p strong')
+    end
+
+    it "should not find tags" do
+      rendered.should_not have_tag('span')
+      rendered.should_not have_tag(:span)
+      rendered.should_not have_tag('span#id')
+      rendered.should_not have_tag('span#class')
+      rendered.should_not have_tag('div div span')
+    end
+
+    it "should not find tags and display appropriate message" do
+      expect { rendered.should have_tag('span') }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto have at least 1 element matching "span", found 0.}
+      )
+      expect { rendered.should have_tag('span#some_id') }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto have at least 1 element matching "span#some_id", found 0.}
+      )
+      expect { rendered.should have_tag('span.some_class') }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto have at least 1 element matching "span.some_class", found 0.}
+      )
+    end
+
+    it "should find unexpected tags and display appropriate message" do
+      expect { rendered.should_not have_tag('div') }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto NOT have element matching "div", found 2.}
+      )
+      expect { rendered.should_not have_tag('div#div') }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto NOT have element matching "div#div", found 1.}
+      )
+      expect { rendered.should_not have_tag('p.paragraph') }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto NOT have element matching "p.paragraph", found 1.}
+      )
+    end
+
+    context "with additional HTML attributes(:with option)" do
+      it "should find tags" do
+        rendered.should have_tag('input#search',:with => {:type => "text"})
+        rendered.should have_tag(:input ,:with => {:type => "submit", :value => "Save"})
+      end
+
+      it "should find tags that have classes specified via array(or string)" do
+        rendered.should have_tag('div',:with => {:class => %w(class-one class-two)})
+        rendered.should have_tag('div',:with => {:class => 'class-two class-one'})
+      end
+
+      it "should not find tags that have classes specified via array" do
+        rendered.should_not have_tag('div',:with => {:class => %w(class-other class-two)})
+      end
+
+      it "should not find tags that have classes specified via array and display appropriate message" do
+        expect do
+          rendered.should have_tag('div',:with => {:class => %w(class-other class-two)})
+        end.should raise_spec_error(
+          %Q{expected following:\n#{rendered}\nto have at least 1 element matching "div.class-other.class-two", found 0.}
+        )
+        expect do
+          rendered.should have_tag('div',:with => {:class => 'class-other class-two'})
+        end.should raise_spec_error(
+          %Q{expected following:\n#{rendered}\nto have at least 1 element matching "div.class-other.class-two", found 0.}
+        )
+      end
+
+      it "should not find tags" do
+        rendered.should_not have_tag('input#search',:with => {:type => "some_other_type"})
+        rendered.should_not have_tag(:input, :with => {:type => "some_other_type"})
+      end
+
+      it "should not find tags and display appropriate message" do
+        expect { rendered.should have_tag('input#search',:with => {:type => "some_other_type"}) }.should raise_spec_error(
+          %Q{expected following:\n#{rendered}\nto have at least 1 element matching "input#search[type='some_other_type']", found 0.}
+        )
+      end
+
+      it "should find unexpected tags and display appropriate message" do
+        expect { rendered.should_not have_tag('input#search',:with => {:type => "text"}) }.should raise_spec_error(
+          %Q{expected following:\n#{rendered}\nto NOT have element matching "input#search[type='text']", found 1.}
+        )
+      end
+
+    end
+
+  end
+
+  context "by count" do
+    let(:rendered) { asset('paragraphs') }
+
+    it "should find tags" do
+      rendered.should have_tag('p', :count => 3)
+      rendered.should have_tag('p', :count => 2..3)
+    end
+
+    it "should find tags when :minimum specified" do
+      rendered.should have_tag('p', :min      => 3)
+      rendered.should have_tag('p', :minimum  => 2)
+    end
+
+    it "should find tags when :maximum specified" do
+      rendered.should have_tag('p', :max      => 4)
+      rendered.should have_tag('p', :maximum  => 3)
+    end
+
+    it "should not find tags(with :count, :minimum or :maximum specified)" do
+      rendered.should_not have_tag('p', :count   => 10)
+      rendered.should_not have_tag('p', :count   => 4..8)
+      rendered.should_not have_tag('p', :min     => 11)
+      rendered.should_not have_tag('p', :minimum => 10)
+      rendered.should_not have_tag('p', :max     => 2)
+      rendered.should_not have_tag('p', :maximum => 2)
+    end
+
+    it "should not find tags and display appropriate message(with :count)" do
+      expect { rendered.should have_tag('p', :count => 10) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto have 10 element(s) matching "p", found 3.}
+      )
+
+      expect { rendered.should have_tag('p', :count => 4..8) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto have at least 4 and at most 8 element(s) matching "p", found 3.}
+      )
+    end
+
+    it "should find unexpected tags and display appropriate message(with :count)" do
+      expect { rendered.should_not have_tag('p', :count => 3) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto NOT have 3 element(s) matching "p", but found.}
+      )
+
+      expect { rendered.should_not have_tag('p', :count => 1..3) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto NOT have at least 1 and at most 3 element(s) matching "p", but found 3.}
+      )
+    end
+
+    it "should not find tags and display appropriate message(with :minimum)" do
+      expect { rendered.should have_tag('p', :min => 100) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto have at least 100 element(s) matching "p", found 3.}
+      )
+      expect { rendered.should have_tag('p', :minimum => 100) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto have at least 100 element(s) matching "p", found 3.}
+      )
+    end
+
+    it "should find unexpected tags and display appropriate message(with :minimum)" do
+      expect { rendered.should_not have_tag('p', :min => 2) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto NOT have at least 2 element(s) matching "p", but found 3.}
+      )
+      expect { rendered.should_not have_tag('p', :minimum => 2) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto NOT have at least 2 element(s) matching "p", but found 3.}
+      )
+    end
+
+    it "should not find tags and display appropriate message(with :maximum)" do
+      expect { rendered.should have_tag('p', :max => 2) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto have at most 2 element(s) matching "p", found 3.}
+      )
+      expect { rendered.should have_tag('p', :maximum => 2) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto have at most 2 element(s) matching "p", found 3.}
+      )
+    end
+
+    it "should find unexpected tags and display appropriate message(with :maximum)" do
+      expect { rendered.should_not have_tag('p', :max => 5) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto NOT have at most 5 element(s) matching "p", but found 3.}
+      )
+      expect { rendered.should_not have_tag('p', :maximum => 5) }.should raise_spec_error(
+        %Q{expected following:\n#{rendered}\nto NOT have at most 5 element(s) matching "p", but found 3.}
+      )
+    end
+
+    it "should raise error when wrong params specified" do
+      expect { rendered.should have_tag('div', :count => 'string') }.should raise_error(/wrong :count/)
+      wrong_params_error_msg_1 = ':count with :minimum or :maximum has no sence!'
+      expect { rendered.should have_tag('div', :count => 2, :minimum => 1) }.should raise_error(wrong_params_error_msg_1)
+      expect { rendered.should have_tag('div', :count => 2, :min     => 1) }.should raise_error(wrong_params_error_msg_1)
+      expect { rendered.should have_tag('div', :count => 2, :maximum => 1) }.should raise_error(wrong_params_error_msg_1)
+      expect { rendered.should have_tag('div', :count => 2, :max     => 1) }.should raise_error(wrong_params_error_msg_1)
+      wrong_params_error_msg_2 = ':minimum shold be less than :maximum!'
+      expect { rendered.should have_tag('div', :minimum => 2, :maximum => 1) }.should raise_error(wrong_params_error_msg_2)
+      [ 4..1, -2..6, 'a'..'z', 3..-9 ].each do |range|
+        expect { rendered.should have_tag('div', :count => range ) }.should raise_error("Your :count range(#{range.to_s}) has no sence!")
+      end
+    end
+  end
+
+  context "with content specified" do
+    let(:rendered) { asset('quotes') }
+
+    it "should find tags" do
+      rendered.should have_tag('div',  :text => 'sample text')
+      rendered.should have_tag('p',    :text => 'one')
+      rendered.should have_tag('div',  :text => /SAMPLE/i)
+      rendered.should have_tag('span', :text => "sample with 'single' quotes")
+      rendered.should have_tag('span', :text => %Q{sample with 'single' and "double" quotes})
+
+      rendered.should have_tag('p',    :text => 'content with ignored spaces around')
+      rendered.should have_tag('p',    :text => 'content with ignored spaces in')
+      rendered.should have_tag('p',    :text => 'content with nbsp')
+      rendered.should have_tag('p',    :text => 'content with nbsp  and  spaces   around')
+      rendered.should have_tag('pre',  :text => " 1. bla   \n 2. bla ")
+    end
+
+    it "should map a string argument to :text => string" do
+      rendered.should have_tag('div',  'sample text')
+    end
+
+    it "should not find tags" do
+      rendered.should_not have_tag('p',      :text => 'text does not present')
+      rendered.should_not have_tag('strong', :text => 'text does not present')
+      rendered.should_not have_tag('p',      :text => /text does not present/)
+      rendered.should_not have_tag('strong', :text => /text does not present/)
+
+      rendered.should_not have_tag('p',      :text => 'content with ignoredspaces around')
+      rendered.should_not have_tag('p',      :text => 'content with ignored  spaces around')
+      rendered.should_not have_tag('p',      :text => 'content withignored spaces in')
+      rendered.should_not have_tag('p',      :text => 'contentwith nbsp')
+      rendered.should_not have_tag('p',      :text => 'content with nbsp  and  spaces  around')
+      rendered.should_not have_tag('pre',    :text => "1. bla\n2. bla")
+    end
+
+    it "should invoke #to_s method for :text" do
+      expect {
+        rendered.should_not have_tag('p', :text => 100500 )
+        rendered.should have_tag('p', :text => 315 )
+      }.to_not raise_exception
+    end
+
+    it "should not find tags and display appropriate message" do
+      # TODO make diffable,maybe...
+      expect { rendered.should have_tag('div', :text => 'SAMPLE text') }.should raise_spec_error(
+        %Q{"SAMPLE text" expected within "div" in following template:\n#{rendered}}
+      )
+      expect { rendered.should have_tag('div', :text => /SAMPLE tekzt/i) }.should raise_spec_error(
+        %Q{/SAMPLE tekzt/i regexp expected within "div" in following template:\n#{rendered}}
+      )
+    end
+
+    it "should find unexpected tags and display appropriate message" do
+      expect { rendered.should_not have_tag('div', :text => 'sample text') }.should raise_spec_error(
+        %Q{"sample text" unexpected within "div" in following template:\n#{rendered}\nbut was found.}
+      )
+      expect { rendered.should_not have_tag('div', :text => /SAMPLE text/i) }.should raise_spec_error(
+        %Q{/SAMPLE text/i regexp unexpected within "div" in following template:\n#{rendered}\nbut was found.}
+      )
+    end
+
+  end
+
+  context "mixed matching" do
+    let(:rendered) { asset('special') }
+
+    it "should find tags by count and exact content" do
+      rendered.should have_tag("td", :text => 'a', :count => 3)
+    end
+
+    it "should find tags by count and rough content(regexp)" do
+      rendered.should have_tag("td", :text => /user/, :count => 3)
+    end
+
+    it "should find tags with exact content and additional attributes" do
+      rendered.should have_tag("td", :text => 'a', :with => { :id => "special" })
+      rendered.should_not have_tag("td", :text => 'a', :with => { :id => "other-special" })
+    end
+
+    it "should find tags with rough content and additional attributes" do
+      rendered.should have_tag("td", :text => /user/, :with => { :id => "other-special" })
+      rendered.should_not have_tag("td", :text => /user/, :with => { :id => "special" })
+    end
+
+    it "should find tags with count and additional attributes" do
+      rendered.should have_tag("div", :with => { :class => "one" }, :count => 6)
+      rendered.should have_tag("div", :with => { :class => "two" }, :count => 3)
+    end
+
+    it "should find tags with count, exact text and additional attributes" do
+      rendered.should have_tag("div", :with => { :class => "one" }, :count => 3, :text => 'text')
+      rendered.should_not have_tag("div", :with => { :class => "one" }, :count => 5, :text => 'text')
+      rendered.should_not have_tag("div", :with => { :class => "one" }, :count => 3, :text => 'other text')
+      rendered.should_not have_tag("div", :with => { :class => "two" }, :count => 3, :text => 'text')
+    end
+
+    it "should find tags with count, regexp text and additional attributes" do
+      rendered.should have_tag("div", :with => { :class => "one" }, :count => 2, :text => /bla/)
+      rendered.should have_tag("div", :with => { :class => "two" }, :count => 1, :text => /bla/)
+      rendered.should_not have_tag("div", :with => { :class => "one" }, :count => 5, :text => /bla/)
+      rendered.should_not have_tag("div", :with => { :class => "one" }, :count => 6, :text => /other bla/)
+    end
+  end
+
+  context "nested matching:" do
+    let(:rendered) { asset('ordered_list') }
+
+    it "should find tags" do
+      rendered.should have_tag('ol') {
+        with_tag('li', :text  => 'list item 1')
+        with_tag('li', :text  => 'list item 2')
+        with_tag('li', :text  => 'list item 3')
+        with_tag('li', :count => 3)
+        with_tag('li', :count => 2..3)
+        with_tag('li', :min   => 2)
+        with_tag('li', :max   => 6)
+      }
+    end
+
+    it "should not find tags" do
+      rendered.should have_tag('ol') {
+        without_tag('div')
+        without_tag('li', :count => 2)
+        without_tag('li', :count => 4..8)
+        without_tag('li', :min => 100)
+        without_tag('li', :max => 2)
+        without_tag('li', :text => 'blabla')
+        without_tag('li', :text => /list item (?!\d)/)
+      }
+    end
+
+    it "should handle do; end" do
+      expect do
+        rendered.should have_tag('ol') do
+          with_tag('div')
+        end
+      end.should raise_spec_error(/have at least 1 element matching "div", found 0/)
+    end
+
+    it "should not find tags and display appropriate message" do
+      ordered_list_regexp = rendered[/<ol.*<\/ol>/m].gsub(/(\n?\s{2,}|\n\s?)/,'\n*\s*')
+      expect {
+        rendered.should have_tag('ol') { with_tag('li'); with_tag('div') }
+      }.should raise_spec_error(/expected following:\n#{ordered_list_regexp}\n\s*to have at least 1 element matching "div", found 0/)
+      expect {
+        rendered.should have_tag('ol') { with_tag('li'); with_tag('li', :count => 10) }
+      }.should raise_spec_error(/expected following:\n#{ordered_list_regexp}\n\s*to have 10 element\(s\) matching "li", found 3/)
+      expect {
+        rendered.should have_tag('ol') { with_tag('li'); with_tag('li', :text => /SAMPLE text/i) }
+      }.should raise_spec_error(/\/SAMPLE text\/i regexp expected within "li" in following template:\n#{ordered_list_regexp}/)
+    end
+  end
+end