RubyGems - capybara-page-object - Versions diffs - 0.3.0 → 0.5.0 - Mend

capybara-page-object 0.3.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (51) hide show

data/README.markdown +83 -0
data/VERSION +1 -1
data/capybara-page-object.gemspec +17 -10
data/lib/capybara-page-object.rb +4 -4
data/lib/collections.rb +11 -5
data/lib/delegators.rb +14 -0
data/lib/element.rb +14 -11
data/lib/element/TODO.md +11 -0
data/lib/element/anchor.rb +1 -5
data/lib/element/form.rb +6 -10
data/lib/element/form_field.rb +4 -9
data/lib/element/head.rb +15 -0
data/lib/element/image.rb +6 -11
data/lib/element/input.rb +8 -13
data/lib/element/list.rb +1 -15
data/lib/element/list_item.rb +7 -0
data/lib/element/meta.rb +2 -7
data/lib/element/select.rb +1 -13
data/lib/element/table.rb +11 -4
data/lib/element/table_header.rb +4 -0
data/lib/element/table_row.rb +7 -0
data/lib/element/text_based_input.rb +16 -0
data/lib/element/textarea.rb +5 -11
data/lib/html5_data.rb +3 -7
data/lib/key_value.rb +1 -1
data/lib/node.rb +9 -54
data/lib/page.rb +40 -0
data/spec/common_spec.rb +13 -21
data/spec/element/anchor_spec.rb +2 -2
data/spec/element/base_spec.rb +2 -2
data/spec/element/form_field_spec.rb +4 -4
data/spec/element/form_spec.rb +26 -25
data/spec/element/head_spec.rb +24 -0
data/spec/element/image_spec.rb +5 -5
data/spec/element/input_spec.rb +52 -17
data/spec/element/list_item_spec.rb +19 -0
data/spec/element/list_spec.rb +3 -20
data/spec/element/meta_spec.rb +3 -2
data/spec/element/select_spec.rb +4 -29
data/spec/element/table_row_spec.rb +19 -0
data/spec/element/table_spec.rb +35 -5
data/spec/element/textarea_spec.rb +14 -4
data/spec/node_spec.rb +14 -37
data/spec/page_spec.rb +37 -0
metadata +31 -24
data/README.rdoc +0 -18
data/lib/element/listitem.rb +0 -7
data/lib/extractor/common.rb +0 -42
data/lib/extractor/page_level.rb +0 -15
data/lib/navigation.rb +0 -16
data/spec/element/listitem_spec.rb +0 -25

data/spec/element/head_spec.rb ADDED

@@ -0,0 +1,24 @@
+require 'helper'
+describe "Head" do
+  context "#title" do
+    it "returns the page title" do
+      node = CapybaraPageObject::Head.from_string '<head><title>Hello World</title></head>', 'head'
+      node.title.should == 'Hello World'
+    end
+  end
+  context "#meta_description" do
+    it "returns the meta description" do
+      node = CapybaraPageObject::Head.from_string '<head><meta name="description" content="meta description"></head>', 'head'
+      node.meta_description.should == "meta description"
+    end
+  end
+  context "#meta_keywords" do
+    it "returns the meta keywords as an array" do
+      node = CapybaraPageObject::Head.from_string '<head><meta name="keywords" content="keyword 1, keyword 2"></head>', 'head'
+      node.meta_keywords.should == ["keyword 1", "keyword 2"]
+    end
+  end
+end

data/spec/element/image_spec.rb CHANGED

@@ -1,28 +1,28 @@
-require File.dirname(__FILE__) + '/../helper'
+require 'helper'
 describe "Image" do
   context "#alt" do
     it "returns the alt attribute" do
-      i = CapybaraPageObject::Image.from_string '<img alt="alt image">'
+      i = CapybaraPageObject::Image.from_string '<img alt="alt image">', 'img'
       i.alt.should == 'alt image'
     end
     it "strips whitespace" do
-      i = CapybaraPageObject::Image.from_string '<img alt="  alt image  ">'
+      i = CapybaraPageObject::Image.from_string '<img alt="  alt image  ">', 'img'
       i.alt.should == 'alt image'
     end
   end
   context "#key" do
     it "return the alt attribute" do
-      i = CapybaraPageObject::Image.from_string '<img alt="alt image">'
+      i = CapybaraPageObject::Image.from_string '<img alt="alt image">', 'img'
       i.key.should == 'alt image'
     end
   end
   context "#value" do
     it "return the source image as a URI object" do
-      i = CapybaraPageObject::Image.from_string '<img src="image.jpg">'
+      i = CapybaraPageObject::Image.from_string '<img src="image.jpg">', 'img'
       i.value.class.should == URI::Generic
       i.value.path.should == 'image.jpg'
     end

data/spec/element/input_spec.rb CHANGED

@@ -1,49 +1,84 @@
-require File.dirname(__FILE__) + '/../helper'
+require 'helper'
 describe "Input" do
   context "#key" do
     it "return the name attribute" do
-      i = CapybaraPageObject::Input.from_string '<input name="foo"/>'
+      i = CapybaraPageObject::Input.from_string '<input name="foo"/>', 'input'
       i.key.should == 'foo'
     end
   end
-  # TODO get this working
-  # context "#value" do
-  #   it "delegates to the the Capybara::Node::Simple" do
-  #     i = CapybaraPageObject::Input.from_string '<input name="foo" value="bar"/>'
-  #     i.value.should == 'bar'
-  #   end
-  # end
+  context "#value" do
+    it "returns the value attribute" do
+      input = CapybaraPageObject::Input.from_string '<input value="foo">', 'input'
+      input.value.should == 'foo'
+    end
+  end
+  context "#clear!" do
+    it "clears the value" do
+      input = CapybaraPageObject::Input.from_string '<input name="foo" value="bar">', 'input'
+      input.source.should_receive(:fill_in).with("foo", {:with => ''})
+      input.clear!
+    end
+  end
+  context "#blank?" do
+    it "is true if the value is an empty string" do
+      input = CapybaraPageObject::Input.from_string '<input name="foo" value="">', 'input'
+      input.should be_blank
+    end
+    it "is true if the value is not present" do
+      input = CapybaraPageObject::Input.from_string '<input name="foo">', 'input'
+      input.should be_blank
+    end
+    it "is true if the value is only whitespace" do
+      input = CapybaraPageObject::Input.from_string '<input name="foo" value="  \n \t ">', 'input'
+      input.should_not be_blank
+    end
+    it "is false if the value is an non-empty string" do
+      input = CapybaraPageObject::Input.from_string '<input name="foo" value="bar">', 'input'
+      input.should_not be_blank
+    end
+  end
+  context "#value=(value)" do
+    it "it allows the value to be set" do
+      input = CapybaraPageObject::Input.from_string '<input name="foo" value="old_bar">', 'input'
+      new_value = 'new_bar'
+      input.source.should_receive(:fill_in).with("foo", {:with => new_value})
+      input.value = new_value
+    end
+  end
   context "#untyped" do
     it "is true if the input has no type attribute" do
-      input = CapybaraPageObject::Input.from_string '<input type="text">'
+      input = CapybaraPageObject::Input.from_string '<input type="text">', 'input'
       input.should_not be_untyped
     end
     it "is true if the input has no type attribute" do
-      input = CapybaraPageObject::Input.from_string '<input>'
+      input = CapybaraPageObject::Input.from_string '<input>', 'input'
       input.should be_untyped
     end
   end
   context "#checkable?" do
     it "is true for a checkbox" do
       checkbox = '<input type="checkbox">'
-      CapybaraPageObject::Input.from_string(checkbox).should be_checkable
+      CapybaraPageObject::Input.from_string(checkbox, 'input').should be_checkable
     end
     it "is true for a radio button" do
       radio = '<input type="radio">'
-      CapybaraPageObject::Input.from_string(radio).should be_checkable
+      CapybaraPageObject::Input.from_string(radio, 'input').should be_checkable
     end
     it "is false an input with a blank type" do
       none = '<input type="">'
-      CapybaraPageObject::Input.from_string(none).should_not be_checkable
+      CapybaraPageObject::Input.from_string(none, 'input').should_not be_checkable
     end
     it "is false for other kinds of input" do
       text = '<input type="text">'
-      CapybaraPageObject::Input.from_string(text).should_not be_checkable
+      CapybaraPageObject::Input.from_string(text, 'input').should_not be_checkable
     end
   end
 end

data/spec/element/list_item_spec.rb ADDED

@@ -0,0 +1,19 @@
+require 'helper'
+describe "ListItem" do
+  before do
+    s = <<-EOF
+    <li id="foo">
+      <span class="description">iPhone</span>
+      <span class="price">$500</span>
+    </li>
+    EOF
+    @list_item = CapybaraPageObject::ListItem.from_string s, 'li'
+  end
+  context "#text" do
+    it "return the tag's innter HTML content stripped of whitespace" do
+      @list_item.text.should == "iPhone\n      $500"
+    end
+  end
+end

data/spec/element/list_spec.rb CHANGED

@@ -1,16 +1,13 @@
-require File.dirname(__FILE__) + '/../helper'
+require 'helper'
 module CapybaraPageObject
   class MyListItem < CapybaraPageObject::Node
-    def value
-      find('.description').text.strip
-    end
   end
 end
 describe "List" do
   before do
-    @list = CapybaraPageObject::List.from_string <<-EOF
+    html = <<-EOF
     <ul id="products">
       <li>
         <span class="description">iPhone</span>
@@ -22,26 +19,12 @@ describe "List" do
       </li>
     </ul>
     EOF
+    @list = CapybaraPageObject::List.from_string html, 'ul'
   end
   context "#items" do
     it "return the list items" do
       @list.should have(2).items
     end
-    it "accept a custom list item object" do
-      @list.items({:factory => CapybaraPageObject::MyListItem}).first.value.should == "iPhone"
-    end
-  end
-  context "#key" do
-    it "be the id" do
-      @list.key.should == 'products'
-    end
-    it "should handle ordered list (ol)" do
-      list = CapybaraPageObject::List.from_string '<ol id="ordered"></ol>'
-      list.key.should == 'ordered'
-    end
   end
 end

data/spec/element/meta_spec.rb CHANGED

@@ -1,11 +1,12 @@
-require File.dirname(__FILE__) + '/../helper'
+require 'helper'
 describe "Meta" do
   context "Meta" do
     before do
-      @meta = CapybaraPageObject::Meta.from_string <<-EOF
+      s = <<-EOF
       <meta name="description" content="my description">
       EOF
+      @meta = CapybaraPageObject::Meta.from_string s, 'meta'
     end
     context "#key" do

data/spec/element/select_spec.rb CHANGED

@@ -1,36 +1,11 @@
-require File.dirname(__FILE__) + '/../helper'
+require 'helper'
 describe "Select" do
   before do
-    @select = CapybaraPageObject::Select.from_string '<select name="foo"></textarea>'
-  end
-  context "#key" do
-    it "returns the name attribute" do
-      @select.key.should == 'foo'
-    end
+    @select = CapybaraPageObject::Select.from_string '<select name="foo"></select>', 'select'
   end
-  context "#value" do
-    it "returns an single item for a non-multiple select" do
-      s = CapybaraPageObject::Select.from_string <<-EOM
-      <select name="colour">
-        <option>red</option>
-        <option selected>blue</option>
-      </select>
-      EOM
-      s.value.should == 'blue'
-    end
-    it "returns an array for amultiple select" do
-      s = CapybaraPageObject::Select.from_string <<-EOM
-      <select name="countries" multiple>
-        <option>france</option>
-        <option selected>spain</option>
-        <option selected>germany</option>
-      </select>
-      EOM
-      s.value.should == ['spain', 'germany']
-    end
+  it "can be instantiated" do
+    @select.should_not be_nil
   end
 end

data/spec/element/table_row_spec.rb ADDED

@@ -0,0 +1,19 @@
+require 'helper'
+describe "CapybaraPageObject::TableRow" do
+  context "#header?" do
+    it "return true if the row contains a header cell" do
+      html = "<tr><th>a</th><td>b</td></tr>"
+      row = CapybaraPageObject::TableRow.from_string html, 'tr'
+      row.header?.should be_true
+    end
+  end
+  context "#header?" do
+    it "returns false if the row contains no header cells" do
+      html = "<tr><td>a</td><td>b</td></tr>"
+      row = CapybaraPageObject::TableRow.from_string html, 'tr'
+      row.header?.should be_false
+    end
+  end
+end

data/spec/element/table_spec.rb CHANGED

@@ -1,8 +1,8 @@
-require File.dirname(__FILE__) + '/../helper'
+require 'helper'
 describe "CapybaraPageObject::Table" do
   before do
-    @table = CapybaraPageObject::Table.from_string <<-EOF
+    s = <<-EOF
     <table id="table_1" class="table_1_class">
       <tr id="table_1_tr_1">
         <th id="table_1_th_1">TH1</th>
@@ -14,17 +14,47 @@ describe "CapybaraPageObject::Table" do
       </tr>
     </table>
     EOF
+    @table = CapybaraPageObject::Table.from_string s, 'table'
+    # TODO clean this up
+    s = <<-EOF
+    <table id="table_1" class="table_1_class">
+      <tr id="table_1_tr_1">
+        <td id="table_1_th_1">TH1</td>
+        <td id="table_1_th_2">TH2</td>
+      </tr>
+      <tr id="table_1_tr_2">
+        <td id="table_1_td_1">TD1</td>
+        <td id="table_1_td_2">TD2</td>
+      </tr>
+    </table>
+    EOF
+    @table_without_headers = CapybaraPageObject::Table.from_string s, 'table'
   end
   context "#rows" do
     it "return the table's rows" do
-      @table.rows(:keys => 'id').should =~ ['table_1_tr_1', 'table_1_tr_2']
+      @table.rows.keys.should =~ ['table_1_tr_2']
     end
   end
   context "#headers" do
     it "return the table's headers" do
-      @table.headers.collect(&:text).should =~ ["TH1", "TH2"]
+      @table.headers.keys.should =~ ["table_1_th_1", "table_1_th_2"]
+    end
+  end
+  context "#rows" do
+    context "for a table with a header row" do
+      it "returns all the table rows except header row" do
+        @table.should have(1).rows
+      end
+    end
+    context "for a table without a header row" do
+      it "returns all the table rows" do
+        @table_without_headers.should have(2).rows
+      end
     end
   end
 end

data/spec/element/textarea_spec.rb CHANGED

@@ -1,8 +1,9 @@
-require File.dirname(__FILE__) + '/../helper'
+require 'helper'
 describe "Textarea" do
   before do
-    @textarea = CapybaraPageObject::Textarea.from_string '<textarea name="foo">bar</textarea>'
+    @textarea = CapybaraPageObject::Textarea.from_string '<textarea name="foo">bar</textarea>', 'textarea'
+    @blank_textarea = CapybaraPageObject::Textarea.from_string '<textarea name="foo"></textarea>', 'textarea'
   end
   context "#key" do
@@ -10,10 +11,19 @@ describe "Textarea" do
       @textarea.key.should == 'foo'
     end
   end
   context "#value" do
-    it "return the content" do
+    it "returns the content" do
       @textarea.value.should == 'bar'
     end
   end
+  context "#blank?" do
+    it "is false is there is content" do
+      @textarea.should_not be_blank
+    end
+    it "is true if there is no content" do
+      @blank_textarea.should be_blank
+    end
+  end
 end

data/spec/node_spec.rb CHANGED

@@ -1,45 +1,22 @@
-require File.dirname(__FILE__) + '/helper'
+require 'helper'
 describe "Page" do
-  context "Using the example.html" do
-    context "#title" do
-      it "returns the page title" do
-        node = CapybaraPageObject::Node.from_string '<title>Hello World</title>'
-        node.title.should == 'Hello World'
-      end
+  context "#classes" do
+    it "returns an array of class names" do
+      anchor = CapybaraPageObject::Anchor.from_string '<a class="foo bar">', 'a'
+      anchor.classes.should =~ ['foo', 'bar']
     end
-    context "#meta_description" do
-      it "returns the meta description" do
-        node = CapybaraPageObject::Node.from_string '<meta name="description" content="meta description">'
-        node.meta_description.should == "meta description"
-      end
+    it "handles extraneous spacing" do
+      anchor = CapybaraPageObject::Anchor.from_string '<a class="  foo   bar  ">', 'a'
+      anchor.classes.should =~ ['foo', 'bar']
     end
-    context "#meta_keywords" do
-      it "returns the meta keywords as an array" do
-        node = CapybaraPageObject::Node.from_string '<meta name="keywords" content="keyword 1, keyword 2">'
-        node.meta_keywords.should == ["keyword 1", "keyword 2"]
-      end
+    it "returns an empty array classes is empty" do
+      anchor = CapybaraPageObject::Anchor.from_string '<a class="  ">', 'a'
+      anchor.classes.should be_empty
     end
-    context "#classes" do
-      it "returns an array of class names" do
-        anchor = CapybaraPageObject::Anchor.from_string '<a class="foo bar">'
-        anchor.classes.should =~ ['foo', 'bar']
-      end
-      it "handles extraneous spacing" do
-        anchor = CapybaraPageObject::Anchor.from_string '<a class="  foo   bar  ">'
-        anchor.classes.should =~ ['foo', 'bar']
-      end
-      it "returns an empty array classes is empty" do
-        anchor = CapybaraPageObject::Anchor.from_string '<a class="  ">'
-        anchor.classes.should be_empty
-      end
-      it "returns an empty array when the classes attribute is not present" do
-        anchor = CapybaraPageObject::Anchor.from_string '<a/>'
-        anchor.classes.should be_empty
-      end
+    it "returns an empty array when the classes attribute is not present" do
+      anchor = CapybaraPageObject::Anchor.from_string '<a/>', 'a'
+      anchor.classes.should be_empty
     end
   end
 end