html_matchers 0.0.1

data/spec/table_body_matcher_spec.rb

@@ -0,0 +1,77 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe 'table_body_matcher' do
+  describe 'with <tbody> element' do
+    it 'should find body rows' do
+      response = mock_model(Object, :body => '<table id="my_id"><tbody><tr><td>c1</td><td>c2</td></tr></tbody></table>')
+      response.should have_table_body('my_id', [['c1', 'c2']])
+    end
+  end
+
+  describe 'without <tbody> element' do
+    it 'should not require <tbody>' do
+      response = mock_model(Object, :body => '<table id="my_id"><tr><td>c1</td><td>c2</td></tr></table>')
+      response.should have_table_body('my_id', [['c1', 'c2']])
+    end
+
+    describe 'with extraneous multiline whitespace' do
+      it 'should remove extraneous whitespace' do
+        response = mock_model(Object, :body => "<table id='my_id'><tr><td>\n  c1a\n   \t<br/>   \tc1b</td><td>c2</td></tr></table>")
+        response.should have_table_body('my_id', [["c1a\nc1b", 'c2']])
+      end
+    end
+
+    it 'should ignore header row' do
+      response = mock_model(Object, :body => '<table id="my_id"><tr><th>h1</th><th>h2</th></tr><tr><td>c1</td><td>c2</td></tr></table>')
+      response.should have_table_body('my_id', [['c1', 'c2']])
+    end
+  end
+
+  it 'can be called without a table_id' do
+    response = mock_model(Object, :body => '<table><tr><td>c1</td><td>c2</td></tr></table>')
+    response.should have_table_body([['c1', 'c2']])
+  end
+
+  it 'matches multiple body rows' do
+    response = mock_model(Object, :body => '<table><tr><td>c1</td><td>c2</td></tr><tr><td>c3</td><td>c4</td></tr></table>')
+    response.should have_table_body([['c1', 'c2'], ['c3', 'c4']])
+  end
+
+  describe 'passed wrong id' do
+    it 'should not match' do
+      response = mock_model(Object, :body => '<table id="my_id"><tr><td>c1</td><td>c2</td></tr></table>')
+      response.should_not have_table_body('wrong_id', [['c1', 'c2']])
+    end
+  end
+
+  describe 'passed non-matching expected' do
+    it 'should not match' do
+      response = mock_model(Object, :body => '<table id="my_id"><tr><td>c1</td><td>c2</td></tr></table>')
+      response.should_not have_table_body('my_id', [['c3', 'c2']])
+    end
+  end
+
+  describe 'with normal failure' do
+    it 'should raise ExpectationNotMetError with correct message' do
+      response = mock_model Object, :body => 'Some non-matching HTML'
+      lambda do
+        response.should have_table_body('my_id', [['c1', 'c2']])
+      end.should raise_error(Spec::Expectations::ExpectationNotMetError, "\nWrong table body contents.\nexpected: [[\"c1\", \"c2\"]]\n   found: []\n\n")
+    end
+  end
+
+  describe 'with negative failure' do
+    it 'should raise ExpectationNotMetError' do
+      response = mock_model Object, :body => '<table id="my_id"><tr><td>c1</td><td>c2</td></tr></table>'
+      lambda{response.should_not have_table_body('my_id', [['c1', 'c2']])}.should raise_error(Spec::Expectations::ExpectationNotMetError,
+        "\nTable body should not have matched: [[\"c1\", \"c2\"]]\n")
+    end
+  end
+
+  describe 'passed nil expected' do
+    it 'should raise error' do
+      response = mock_model(Object, :body => '<table id="my_id"><tr><td>c1</td><td>c2</td></tr></table>')
+      lambda{ response.should have_table_body('my_id', nil)}.should raise_error(RuntimeError, 'Invalid "expected" argument')
+    end
+  end
+end

data/spec/table_header_matcher_spec.rb

@@ -0,0 +1,111 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe 'table_header_matcher' do
+  describe 'with <thead> element' do
+    it 'should have headers' do
+      verify_table_header_match 'my_id', '<table id="my_id"><thead><tr><th>h1</th><th>h2</th></tr></thead></table>', [['h1', 'h2']]
+    end
+  end
+
+  describe 'without <thead> element' do
+    it 'should not require <thead>' do
+      verify_table_header_match 'my_id', '<table id="my_id"><tr><th>h1</th><th>h2</th></tr></table>', [['h1', 'h2']]
+    end
+
+    it 'should ignore regular row' do
+      verify_table_header_match 'my_id',
+                                '<table id="my_id"><tr><th>h1</th><th>h2</th></tr><tr><td>"regular"</td><td>"row"</td></tr></table>',
+                                [['h1', 'h2']]
+    end
+
+    it 'should handle multiple header rows' do
+      verify_table_header_match 'my_id',
+        '<table id="my_id"><tr><th>h1</th><th>h2</th></tr><tr><th>h3</th><th>h4</th></tr><tr><td>"regular"</td><td>"row"</td></tr></table>',
+        [['h1', 'h2'], ['h3', 'h4']]
+    end
+
+    it 'should match "<br/>" to "\n"' do
+      verify_table_header_match 'my_id',
+        '<table id="my_id"><tr><th>h1 - row 1<br/>h1 - row 2</th></tr></table>',
+        [["h1 - row 1\nh1 - row 2"]]
+    end
+
+    it 'should match "<br />" to "\n"' do
+      verify_table_header_match 'my_id',
+        "<table id='my_id'><tr><th>h1 - row 1<br />h1 - row 2</th></tr></table>",
+        [["h1 - row 1\nh1 - row 2"]]
+    end
+
+    it 'should throw away any amount of white space around a br element' do
+      verify_table_header_match 'my_id',
+        "<table id='my_id'><tr><th>h1 - row 1    <br/>\t\th1 - row 2</th></tr></table>",
+        [["h1 - row 1\nh1 - row 2"]]
+    end
+
+    it 'should throw away any amount of white space spanning new lines' do
+      verify_table_header_match 'my_id',
+        "<table id='my_id'><tr><th>h1 - row 1 \n   <br/>\n      \t\th1 - row 2</th></tr></table>",
+        [["h1 - row 1\nh1 - row 2"]]
+    end
+  end
+
+  describe 'passed wrong id' do
+    it 'should not have header' do
+      verify_no_header_match 'wrong_id', '<table id="my_id"><tr><th>h1</th><th>h2</th></tr></table>', [['h1', 'h2']]
+    end
+  end
+
+  describe 'with normal failure' do
+    it 'should raise ExpectationNotMetError with correct message' do
+      response = mock_model Object, :body => 'Some non-matching HTML'
+      lambda do
+        response.should have_table_header('id', [['h1', 'h2']])
+      end.should raise_error(Spec::Expectations::ExpectationNotMetError, "\nWrong table header contents.\nexpected: [[\"h1\", \"h2\"]]\n   found: []\n\n")
+    end
+  end
+
+  describe 'with negative failure' do
+    it 'should raise ExpectationNotMetError' do
+      response = mock_model Object, :body => '<table id="my_id"><tr><th>h1</th><th>h2</th></tr></table>'
+      lambda{response.should_not have_table_header('my_id', [['h1', 'h2']])}.should raise_error(Spec::Expectations::ExpectationNotMetError,
+        "\nTable header should not have matched: [[\"h1\", \"h2\"]]\n")
+    end
+  end
+
+  describe 'passed nil expected' do
+    it 'should raise error' do
+      response = mock_model(Object, :body => '<table id="my_id"><tr><th>h1</th><th>h2</th></tr></table>')
+      lambda{ response.should have_table_header('my_id', nil)}.should raise_error(RuntimeError, 'Invalid "expected" argument')
+    end
+  end
+
+  describe 'called from nil response object' do
+    it 'should raise error' do
+      lambda{ nil.should have_table_header('my_id', [['h1', 'h2']]) }.should raise_error(NoMethodError,
+        "You have a nil object when you didn't expect it!\nThe error occurred while evaluating nil.body")
+    end
+  end
+
+  describe 'when headers don\'t match' do
+    it 'should not match' do
+      verify_no_header_match 'my_id', '<table id="my_id"><tr><th>h1</th><th>h2</th></tr></table>', [['h1', 'h3']]
+    end
+  end
+
+  it "doesn't require table_id" do
+    response = mock_model Object, :body => '<table id="my_id"><tr><th>h1</th><th>h2</th></tr></table>'
+    response.should have_table_header([['h1', 'h2']])
+  end
+
+  private
+
+  def verify_table_header_match id, html, expected
+    response = mock_model Object, :body => html
+    response.should have_table_header(id, expected)
+  end
+
+  def verify_no_header_match id, html, expected
+    response = mock_model Object, :body => html
+    response.should_not have_table_header(id, expected)
+  end
+end

data/spec/table_matcher_spec.rb

@@ -0,0 +1,117 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe 'table_matcher' do
+  describe 'with <thead> and <tbody> elements' do
+    it 'should find header and body rows' do
+      response = mock_model(Object, :body => '<table id="my_id"><thead><tr><th>h1</th><th>h2</th></tr></thead><tbody><tr><td>c1</td><td>c2</td></tr></tbody></table>')
+      response.should have_table('#my_id', [['h1', 'h2'], ['c1', 'c2']])
+    end
+  end
+
+  describe 'without <thead> and <tbody> elements' do
+    it 'should work' do
+      response = mock_model(Object, :body => '<table id="my_id"><tr><th>h1</th><th>h2</th></tr><tr><td>c1</td><td>c2</td></tr></table>')
+      response.should have_table('#my_id', [['h1', 'h2'], ['c1', 'c2']])
+    end
+
+    describe 'with extraneous multiline whitespace' do 
+      it 'should remove extraneous whitespace' do
+        response = mock_model(Object, :body => "<table id=\"my_id\"><tr><th>h1</th><th>h2</th></tr><tr><td>\n  c1a\n   \t<br/>   \tc1b</td><td>c2</td></tr></table>")
+        response.should have_table('#my_id', [['h1', 'h2'], ["c1a\nc1b", 'c2']])
+      end
+    end
+
+    describe 'with inline script tags in a header cell' do
+      it "should suppress script content" do
+        response = mock_model(Object, :body => '<table id="my_id"><tr><th>h1</th><th>h2a<script type="text/javascript">
+          //<![CDATA[
+          x = 1;
+          //]]>
+          </script>
+          h2b</th></tr><tr><td>c1</td><td>c2</td></tr></table>')
+        response.should have_table('#my_id', [['h1', "h2a\nh2b"], ["c1", "c2"]])
+      end
+    end
+
+    describe 'with inline script tags in a cell' do
+      it "should suppress script content" do
+        response = mock_model(Object, :body => '<table id="my_id"><tr><th>h1</th><th>h2</th></tr><tr><td>c1a<script type="text/javascript">
+          //<![CDATA[
+          x = 1;
+          //]]>
+          </script>
+          c1b</td></tr></table>')
+        response.should have_table('#my_id', [['h1', 'h2'], ["c1a\nc1b"]])
+      end
+    end
+  end
+
+  it 'can be called without a table_id' do
+    response = mock_model(Object, :body => '<table><tr><td>c1</td><td>c2</td></tr></table>')
+    response.should have_table([['c1', 'c2']])
+  end
+
+  it 'matches multiple body rows' do
+    response = mock_model(Object, :body => '<table><tr><td>c1</td><td>c2</td></tr><tr><td>c3</td><td>c4</td></tr></table>')
+    response.should have_table([['c1', 'c2'], ['c3', 'c4']])
+  end
+
+  describe 'passed wrong id' do
+    it 'should not match' do
+      response = mock_model(Object, :body => '<table id="my_id"><tr><td>c1</td><td>c2</td></tr></table>')
+      response.should_not have_table('#wrong_id', [['c1', 'c2']])
+    end
+  end
+
+  describe 'passed non-matching expected' do
+    it 'should not match' do
+      response = mock_model(Object, :body => '<table id="my_id"><tr><td>c1</td><td>c2</td></tr></table>')
+      response.should_not have_table('#my_id', [['c3', 'c2']])
+    end
+  end
+
+  describe 'with normal failure' do
+    it 'should raise ExpectationNotMetError with correct message' do
+      response = mock_model Object, :body => 'Some non-matching HTML'
+      lambda do
+        response.should have_table('#my_id', [['c1', 'c2']])
+      end.should raise_error(Spec::Expectations::ExpectationNotMetError, "\nWrong table contents.\nexpected: [[\"c1\", \"c2\"]]\n   found: []\n\n")
+    end
+  end
+
+  describe 'with negative failure' do
+    it 'should raise ExpectationNotMetError' do
+      response = mock_model Object, :body => '<table id="my_id"><tr><td>c1</td><td>c2</td></tr></table>'
+      lambda{
+        response.should_not have_table('#my_id', [['c1', 'c2']])
+      }.should raise_error(Spec::Expectations::ExpectationNotMetError,
+        "\nTable should not have matched: [[\"c1\", \"c2\"]]\n")
+    end
+  end
+
+  describe 'passed nil expected' do
+    it 'should raise error' do
+      response = mock_model(Object, :body => '<table id="my_id"><tr><td>c1</td><td>c2</td></tr></table>')
+      lambda{ response.should have_table('#my_id', nil)}.should raise_error(RuntimeError, 'Invalid "expected" argument')
+    end
+  end
+
+  describe "using non-id selectors" do
+    describe "class" do
+      it "matches with class" do
+        response = mock_model(Object, :body => '<table class="my_class"><tr><th>h1</th><th>h2</th></tr><tr><td>c1</td><td>c2</td></tr></table>')
+        response.should have_table('.my_class', [['h1', 'h2'], ['c1', 'c2']])
+      end
+      it "does not match when class do not match" do
+        response = mock_model(Object, :body => '<table class="my_class_2"><tr><th>h1</th><th>h2</th></tr><tr><td>c1</td><td>c2</td></tr></table>')
+        response.should_not have_table('.my_class', [['h1', 'h2'], ['c1', 'c2']])
+      end
+      it 'should raise ExpectationNotMetError with correct message' do
+        response = mock_model Object, :body => 'Some non-matching HTML'
+        lambda do
+          response.should have_table('.my_id', [['c1', 'c2']])
+        end.should raise_error(Spec::Expectations::ExpectationNotMetError, "\nWrong table contents.\nexpected: [[\"c1\", \"c2\"]]\n   found: []\n\n")
+      end
+    end
+  end
+end

data/tasks/.gitignore

@@ -0,0 +1 @@
+.svn

data/tasks/html_matchers_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :html_matchers do
+#   # Task goes here
+# end

data/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification 
+name: html_matchers
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- bendycode, helabed, listrophy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-24 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: HTML entity matchers for RSpec
+email: stephen@bendyworks.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- .gitignore
+- MIT-LICENSE
+- README
+- Rakefile
+- VERSION
+- init.rb
+- install.rb
+- lib/.gitignore
+- lib/html_matchers.rb
+- lib/matchers/.gitignore
+- lib/matchers/button_matcher.rb
+- lib/matchers/check_box_group_matcher.rb
+- lib/matchers/drop_down_matcher.rb
+- lib/matchers/image_matcher.rb
+- lib/matchers/options_matcher.rb
+- lib/matchers/radio_group_matcher.rb
+- lib/matchers/span_text_matcher.rb
+- lib/matchers/table_body_matcher.rb
+- lib/matchers/table_header_matcher.rb
+- lib/matchers/table_matcher.rb
+- lib/matchers/td_link_matcher.rb
+- spec/button_matcher_spec.rb
+- spec/check_box_group_matcher_spec.rb
+- spec/drop_down_matcher_spec.rb
+- spec/image_matcher_spec.rb
+- spec/radio_group_matcher_spec.rb
+- spec/span_text_matcher_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/table_body_matcher_spec.rb
+- spec/table_header_matcher_spec.rb
+- spec/table_matcher_spec.rb
+- tasks/.gitignore
+- tasks/html_matchers_tasks.rake
+- uninstall.rb
+has_rdoc: true
+homepage: http://github.com/bendyworks/html_matchers
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: HTML entity matchers for RSpec
+test_files: 
+- spec/button_matcher_spec.rb
+- spec/check_box_group_matcher_spec.rb
+- spec/drop_down_matcher_spec.rb
+- spec/image_matcher_spec.rb
+- spec/radio_group_matcher_spec.rb
+- spec/span_text_matcher_spec.rb
+- spec/spec_helper.rb
+- spec/table_body_matcher_spec.rb
+- spec/table_header_matcher_spec.rb
+- spec/table_matcher_spec.rb