page-object 1.0.3 → 1.1.0

data/page-object.gemspec

@@ -6,8 +6,8 @@ Gem::Specification.new do |s|
   s.name = "page-object"
   s.version = PageObject::VERSION
   s.platform = Gem::Platform::RUBY
-  s.authors = ["Jeff Morgan"]
-  s.email = ["jeff.morgan@leandog.com"]
+  s.authors = ["Jeff Morgan", 'Dane Andersen']
+  s.email = ["jeff.morgan@leandog.com", 'dane.andersen@gmail.com']
   s.license       = 'MIT'
   s.homepage = "http://github.com/cheezy/page-object"
   s.summary = %q{Page Object DSL for browser testing}
@@ -24,7 +24,7 @@ Gem::Specification.new do |s|
   s.add_dependency 'selenium-webdriver', '>= 2.44.0'
   s.add_dependency 'page_navigation', '>= 0.9'
 
-  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'rspec', '~> 3.1.0'
   s.add_development_dependency 'cucumber', '>= 1.3.0'
   s.add_development_dependency 'yard', '>= 0.7.2'
   s.add_development_dependency 'rack', '>= 1.0'

data/spec/page-object/elements/button_spec.rb

@@ -44,6 +44,20 @@ describe PageObject::Elements::Button do
         button = PageObject::Elements::Button.new(button_element, :platform => :selenium_webdriver)
         expect(lambda { button.text }).to raise_error
       end
+
+      it "should return text for a button tag button" do
+        allow(button_element).to receive(:tag_name).and_return('button')
+        allow(button_element).to receive(:text).and_return('button?')
+        button = PageObject::Elements::Button.new(button_element, :platform => :selenium_webdriver)
+        expect(button.text).to eq 'button?'
+      end
+
+      it "should return text for an input tag button" do
+        allow(button_element).to receive(:tag_name).and_return('input')
+        allow(button_element).to receive(:attribute).with('value').and_return('button!')
+        button = PageObject::Elements::Button.new(button_element, :platform => :selenium_webdriver)
+        expect(button.text).to eq 'button!'
+      end
     end
   end
 

data/spec/page-object/elements/selenium_element_spec.rb

@@ -1,3 +1,4 @@
+require 'spec_helper'
 require 'page-object/elements'
 require 'selenium-webdriver'
 
@@ -46,6 +47,10 @@ describe "Element for Selenium" do
     expect(@selenium_element).to eq @selenium_element
   end
 
+  it "should know when it is not equal to another" do
+    expect(@selenium_element).not_to eq 'not an element'
+  end
+
   it "should return its tag name" do
     expect(@selenium_driver).to receive(:tag_name).and_return("h1")
     expect(@selenium_element.tag_name).to eql "h1"

data/spec/page-object/elements/watir_element_spec.rb

@@ -42,6 +42,10 @@ describe "Element for Watir" do
     expect(watir_element).to eq watir_element
   end
 
+  it "should know when it is not equal to another" do
+    expect(watir_element).not_to eq 'not an element'
+  end
+
   it "should return its tag name" do
     expect(watir_driver).to receive(:tag_name).and_return("h1")
     expect(watir_element.tag_name).to eql "h1"

data/spec/page-object/loads_platform_spec.rb

@@ -34,19 +34,19 @@ describe TestLoadsPlatform do
   end
 
   context "When an unknow object is passed in" do
-    let(:basic_message) { 'Unable to pick a platform for the provided browser.' }
+    let(:basic_message) { 'Unable to pick a platform for the provided browser or element:' }
     
     it "should throw an exception" do
       expect {
         subject.load_platform("browser", {})
-      }.to raise_error(basic_message)
+      }.to raise_error("#{basic_message} \"browser\".")
     end
 
     it "should notify when the browser is nil" do
       begin
         subject.load_platform(nil, {})
       rescue Exception => e
-        expect(e.message).to eql "#{basic_message}\nnil was passed to the PageObject constructor instead of a valid browser object."
+        expect(e.message).to eql "#{basic_message} nil.\nnil was passed to the PageObject constructor instead of a valid browser or element object."
       end
     end
   end

data/spec/page-object/page-object_spec.rb

@@ -169,6 +169,7 @@ describe PageObject do
     
     context "when using WatirPageObject" do
       it "should display the page text" do
+        expect(watir_browser).to receive(:element).and_return(watir_browser)
         expect(watir_browser).to receive(:text).and_return("browser text")
         expect(watir_page_object.text).to eql "browser text"
       end

data/spec/page-object/page_section_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+class Container
+  include PageObject
+end
+class SectionsPage
+  include PageObject
+
+  page_section(:container, Container, :id => 'blah')
+  page_sections(:containers, Container, :class => 'foo')
+end
+
+describe PageObject::Accessors do
+  context 'when using watir' do
+    let(:watir_browser) { mock_watir_browser }
+    let(:watir_page_object) { SectionsPage.new(watir_browser) }
+
+    it 'it should find a page section' do
+      expect(watir_browser).to receive(:element).with(:id => 'blah').and_return(watir_browser)
+      section = watir_page_object.container
+      expect(section).to be_instance_of Container
+    end
+    it 'it should find page sections' do
+      expect(watir_browser).to receive(:elements).with(:class => 'foo').and_return([watir_browser, watir_browser])
+      sections = watir_page_object.containers
+      expect(sections).to be_instance_of(PageObject::SectionCollection)
+      sections.each do |section|
+        expect(section).to be_instance_of(Container)
+      end
+    end
+  end
+  context 'when using selenium' do
+    let(:selenium_browser) { mock_selenium_browser }
+    let(:selenium_page_object) { SectionsPage.new(selenium_browser) }
+
+    it 'it should find a page section' do
+      expect(selenium_browser).to receive(:find_element).with(:id, 'blah').and_return(selenium_browser)
+      section = selenium_page_object.container
+      expect(section).to be_instance_of Container
+    end
+    it 'it should find page sections' do
+      expect(selenium_browser).to receive(:find_elements).with(:class, 'foo').and_return([selenium_browser, selenium_browser])
+      sections = selenium_page_object.containers
+      expect(sections).to be_instance_of(PageObject::SectionCollection)
+      sections.each do |section|
+        expect(section).to be_instance_of(Container)
+      end
+    end
+  end
+end
+describe PageObject::SectionCollection do
+  ContainedItem = Struct.new(:type, :name)
+  let(:section_collection) do
+    contained_items = [ContainedItem.new(:sandwich, :reuben), ContainedItem.new(:soup, :lobster_bisque), ContainedItem.new(:sandwich, :dagwood)]
+    PageObject::SectionCollection.new(contained_items)
+  end
+  it 'should be indexed to the sections' do
+    expect(section_collection[0]).to be_an_instance_of ContainedItem
+    expect(section_collection[-1]).to be_an_instance_of ContainedItem
+  end
+  it 'should be able to iterate over the sections' do
+    section_collection.each do |section|
+      expect(section).to be_an_instance_of ContainedItem
+    end
+  end
+  it 'should find a section by one of its values' do
+    expect(section_collection.find_by(name: :dagwood).name).to eq :dagwood
+  end
+  it 'should find all sections matching a value' do
+    expect(section_collection.select_by(type: :sandwich).map(&:type)).to eq [:sandwich, :sandwich]
+  end
+end

data/spec/spec_helper.rb

@@ -25,7 +25,7 @@ end
 
 def mock_selenium_browser
   selenium_browser = double('selenium')
-  allow(selenium_browser).to receive(:is_a?).with(Watir::Browser).and_return(false)
+  allow(selenium_browser).to receive(:is_a?).with(anything).and_return(false)
   allow(selenium_browser).to receive(:is_a?).with(Selenium::WebDriver::Driver).and_return(true)
   selenium_browser
 end
@@ -36,6 +36,8 @@ def mock_adapter(browser, page_object)
   allow(adapter).to receive(:is_for?).with(anything()).and_return false
   allow(adapter).to receive(:is_for?).with(browser).and_return true
   allow(adapter).to receive(:create_page_object).and_return page_object
+  allow(adapter).to receive(:root_element_for).and_return browser
+  allow(adapter).to receive(:browser_for).and_return browser
   adapter
 end
 

metadata

@@ -1,14 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: page-object
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.1.0
 platform: ruby
 authors:
 - Jeff Morgan
+- Dane Andersen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-09 00:00:00.000000000 Z
+date: 2015-05-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
@@ -56,16 +57,16 @@ dependencies:
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.1.0
 - !ruby/object:Gem::Dependency
   name: cucumber
   requirement: !ruby/object:Gem::Requirement
@@ -111,6 +112,7 @@ dependencies:
 description: Page Object DSL that works with both Watir and Selenium
 email:
 - jeff.morgan@leandog.com
+- dane.andersen@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -193,6 +195,7 @@ files:
 - features/sample-app/public/prototype-1.6.0.3.js
 - features/sample-app/public/prototype.html
 - features/sample-app/sample_app.rb
+- features/section.feature
 - features/select_list.feature
 - features/span.feature
 - features/step_definitions/accessor_steps.rb
@@ -227,6 +230,7 @@ files:
 - features/step_definitions/paragraph_steps.rb
 - features/step_definitions/radio_button_group_steps.rb
 - features/step_definitions/radio_button_steps.rb
+- features/step_definitions/section_steps.rb
 - features/step_definitions/select_list_steps.rb
 - features/step_definitions/span_steps.rb
 - features/step_definitions/table_cell_steps.rb
@@ -330,6 +334,7 @@ files:
 - lib/page-object/platforms/watir_webdriver/text_area.rb
 - lib/page-object/platforms/watir_webdriver/text_field.rb
 - lib/page-object/platforms/watir_webdriver/unordered_list.rb
+- lib/page-object/sections.rb
 - lib/page-object/version.rb
 - lib/page-object/widgets.rb
 - page-object.gemspec
@@ -371,6 +376,7 @@ files:
 - spec/page-object/page-object_spec.rb
 - spec/page-object/page_factory_spec.rb
 - spec/page-object/page_populator_spec.rb
+- spec/page-object/page_section_spec.rb
 - spec/page-object/platforms/selenium_webdriver/selenium_page_object_spec.rb
 - spec/page-object/platforms/selenium_webdriver_spec.rb
 - spec/page-object/platforms/watir_webdriver/watir_page_object_spec.rb
@@ -470,6 +476,7 @@ test_files:
 - features/sample-app/public/prototype-1.6.0.3.js
 - features/sample-app/public/prototype.html
 - features/sample-app/sample_app.rb
+- features/section.feature
 - features/select_list.feature
 - features/span.feature
 - features/step_definitions/accessor_steps.rb
@@ -504,6 +511,7 @@ test_files:
 - features/step_definitions/paragraph_steps.rb
 - features/step_definitions/radio_button_group_steps.rb
 - features/step_definitions/radio_button_steps.rb
+- features/step_definitions/section_steps.rb
 - features/step_definitions/select_list_steps.rb
 - features/step_definitions/span_steps.rb
 - features/step_definitions/table_cell_steps.rb
@@ -563,6 +571,7 @@ test_files:
 - spec/page-object/page-object_spec.rb
 - spec/page-object/page_factory_spec.rb
 - spec/page-object/page_populator_spec.rb
+- spec/page-object/page_section_spec.rb
 - spec/page-object/platforms/selenium_webdriver/selenium_page_object_spec.rb
 - spec/page-object/platforms/selenium_webdriver_spec.rb
 - spec/page-object/platforms/watir_webdriver/watir_page_object_spec.rb