page_object_wrapper 0.0.6 → 1.0.0

data/spec/fire_event_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+require 'shared_examples'
+
+describe "page_object.fire_xxx" do
+  context "browser is closed" do
+    it "raises PageObjectWrapper::BrowserNotFound" do
+      begin
+        PageObjectWrapper.browser.quit if not PageObjectWrapper.browser.nil?
+        PageObjectWrapper.load('./good_pages')
+      rescue
+      end
+      tp = PageObjectWrapper.receive_page(:some_test_page)
+      expect{ tp.fire_press_cool_button }.to raise_error(PageObjectWrapper::BrowserNotFound)
+    end
+  end
+  context "browser is opened" do
+    before(:all){
+      @b = Watir::Browser.new
+      PageObjectWrapper.use_browser @b
+      begin
+        PageObjectWrapper.load('./good_pages')
+      rescue
+      end
+    }
+    after(:all){ PageObjectWrapper.browser.close }
+
+    context "xxx not found among current_page actions" do
+      it "raises NoMethodError" do
+        tp = PageObjectWrapper.current_page
+        expect{tp.fire_nonexistent_action}.to raise_error(NoMethodError)
+      end
+    end
+    
+    it "executes fire_block in Watir::Browser context" do
+      tp = PageObjectWrapper.open_page(:some_test_page)
+      tp.fire_fill_textarea
+      @b.textarea(:id => 'f2').value.should eq('Default data')
+    end
+
+    it "can be invoked with parameters" do
+      tp = PageObjectWrapper.current_page
+      tp.fire_fill_textarea('User defined data')
+      @b.textarea(:id => 'f2').value.should eq('User defined data')
+    end
+
+    it "returns next_page" do
+      tp = PageObjectWrapper.current_page
+      np = tp.fire_press_cool_button
+      np.should be_a(PageObject)
+      np.label_value.should eq(:test_page_with_table)
+    end
+  end
+end

data/spec/generate_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe "PageObjectWrapper.generate" do
+  it "accepts two arguments - a path_to_an_html file and an optional array which defines what types of elements to generate" do
+  end
+
+  describe "generation of a PageObject definition" do
+    it "generates element_sets for the forms on the page" do
+    end
+
+    it "generates tables found on the page" do
+    end
+
+    it "tries to find and generate pagination on the page" do
+    end
+  end
+
+  it "outputs generated data to STDOUT" do
+  end
+end

data/spec/load_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+
+describe "PageObjectWrapper.load" do
+  it "accepts path to the \'pages\' folder" do
+    expect{ PageObjectWrapper.load('unknown/dir')}.to raise_error(PageObjectWrapper::Load)
+  end
+
+  describe "page load" do
+    it "raises PageObjectWrapper::Load error with all errors described" do
+      begin
+        PageObjectWrapper.load(File.dirname(__FILE__)+'/../bad_pages')
+      rescue Exception => e
+        #puts e.message
+        e.should be_a(PageObjectWrapper::Load)
+        e.message.should == 'page_object("some_page_with_lost_of_errors"):
+	label "some_page_with_lost_of_errors" not a Symbol
+	locator "" not a meaningful String
+elements_set("some elements_set label"):
+	label "some elements_set label" not a Symbol
+	element(""):
+		label "" not a Symbol
+		locator nil not a meaningful Hash
+	element(:e):
+		element :e already defined
+		locator ":e element locator" not a meaningful Hash
+	element(:e):
+		element :e already defined
+		locator {} not a meaningful Hash
+action(""):
+	label "" not a Symbol
+	next_page nil not a Symbol
+	next_page nil unknown page_object
+table(""):
+	label "" not a Symbol
+	locator nil not a meaningful Hash
+table(:some_table):
+	locator nil not a meaningful Hash
+	header [] not a meaningful Array
+pagination(""):
+	label "" not a Symbol
+	locator "pagination locator" not a meaningful Hash
+'
+      end
+    end
+  end
+end

data/spec/open_spec.rb

@@ -0,0 +1,70 @@
+require 'spec_helper'
+
+describe "PageObjectWrapper.open_page" do
+  let(:define_page_object){
+    PageObjectWrapper.define_page(:google_page) do
+      locator 'google.com'
+      uniq_input :id => 'gbqfq'
+    end
+  }
+  let(:define_wrong_page_object){
+    PageObjectWrapper.define_page(:wrong_google_page) do
+      locator 'google.com'
+      uniq_element :id => 'foobar'
+    end
+  }
+  let(:define_page_object_with_local_path){
+    PageObjectWrapper.define_page(:google_as_page) do
+      locator '/advanced_search'
+      uniq_text_field :name => 'as_q' 
+    end
+  }
+
+  context "browser is closed" do
+    it "raises PageObjectWrapper::BrowserNotFound" do
+      define_page_object
+      PageObject.browser = nil
+      expect{ PageObjectWrapper.open_page(:google_page) }.to raise_error(PageObjectWrapper::BrowserNotFound)
+    end
+  end
+
+  context "browser is opened" do
+    
+    before(:all){ 
+      @b = Watir::Browser.new
+      PageObjectWrapper.use_browser @b 
+      define_page_object
+      define_wrong_page_object
+      define_page_object_with_local_path
+    }
+
+    after(:all){ PageObjectWrapper.browser.close }
+
+    it "raises errors" do        
+      expect{ PageObjectWrapper.open_page(:first_arg, :second_arg) }.to raise_error(ArgumentError)
+      expect{ PageObjectWrapper.open_page(:unknown_page) }.to raise_error(PageObjectWrapper::UnknownPageObject)
+      expect{ PageObjectWrapper.open_page(:wrong_google_page) }.to raise_error(PageObjectWrapper::UnmappedPageObject)
+    end
+
+    it "returns opened PageObject instance" do
+      p = PageObjectWrapper.open_page(:google_page)
+      p.should be_an_instance_of(PageObject)
+      p.label_value.should eq(:google_page)
+    end
+
+    context "domain is not specified" do
+      it "opens browser on the page.locator" do
+        gp = PageObjectWrapper.open_page(:google_page)
+        @b.url.should =~/www\.google/
+      end
+    end
+
+    context "domain is specified" do
+      it "opens browser on domain+page.locator" do
+        PageObjectWrapper.domain = 'google.com'
+        PageObjectWrapper.open_page(:google_as_page)        
+        @b.url.should =~/\/advanced_search/
+      end
+    end
+  end
+end

data/spec/select_from_spec.rb

@@ -0,0 +1,84 @@
+require 'spec_helper'
+require 'shared_examples'
+
+describe "page_object.select_from_xxx" do
+  context "browser is closed" do
+    it "raises PageObjectWrapper::BrowserNotFound" do
+      begin
+        PageObjectWrapper.load('./good_pages')
+      rescue
+      end
+      PageObject.browser = nil
+      tp = PageObjectWrapper.receive_page(:some_test_page)
+      expect{ tp.select_from_table_without_header(:column_1, {:column_2 => ''}) }.to raise_error(PageObjectWrapper::BrowserNotFound)
+    end
+  end
+  context "browser is opened" do
+    before(:all){
+      @b = Watir::Browser.new
+      PageObjectWrapper.use_browser @b
+      begin
+        PageObjectWrapper.load('./good_pages')
+      rescue
+      end
+    }
+    after(:all){ PageObjectWrapper.browser.close }
+    let!(:tp){ PageObjectWrapper.open_page(:some_test_page)}
+
+    context "wrong arguments" do
+      it "raises ArgumentError if first_arg not a Symbol" do
+        expect{ tp.select_from_table_without_header(nil,{}) }.to raise_error ArgumentError, "nil not a Symbol"
+      end
+      it "raises ArgumentError if first_arg not included in table_header" do
+        expect{ tp.select_from_table_without_header(:nonexistent_column, {}) }.to raise_error ArgumentError, ":nonexistent_column not in table header"
+      end
+      it "raises ArgumentError if second_arg not a meaningful Hash" do
+        expect{ tp.select_from_table_without_header(:column_1, 'a string') }.to raise_error ArgumentError, '"a string" not a meaningful Hash'
+      end
+      it "raises ArgumentError if second_arg has more than 1 keys" do
+        expect{ tp.select_from_table_without_header(:column_1, {:column_1 => 'foo', :column_2 => 'bar'})}.to raise_error ArgumentError, '{:column_1=>"foo", :column_2=>"bar"} has more than 1 keys'
+      end
+      it "raises ArgumentError if second_arg's key not included in table_header" do
+        expect{ tp.select_from_table_without_header(:column_1, { :nonexistent_column => 'some value' }) }.to raise_error ArgumentError, ":nonexistent_column not in table header"
+      end
+      it "raises ArgumentError if second_arg's value not meaningful a String or Regexp" do
+        expect{ tp.select_from_table_without_header(:column_1, { :column_2 => Array.new }) }.to raise_error ArgumentError, "[] not a String or Regexp"
+      end
+      it "raises Watir::Exception::UnknownObjectException if requested for non existing column" do
+        expect{ tp.select_from_table_without_header(:column_3).text }.to raise_error(Watir::Exception::UnknownObjectException)
+      end
+    end
+
+    context "where == nil" do
+      it "returns last row value from provided column" do
+        tp.select_from_table_without_header(:column_0).text.should eq 'Sweden'
+        tp.select_from_table_without_header(:column_1).text.should eq '449,964'
+        tp.select_from_table_without_header(:column_2).text.should eq '410,928'
+      end
+    end
+
+    context "where not nil" do
+      context "found by String" do
+        it "returns found cells" do
+          tp.select_from_table_without_header(:column_0, :column_1 => '103,000').text.should eq 'Iceland'
+          tp.select_from_table_with_header(:country, :total_area => '337,030').text.should eq 'Finland'
+        end
+        it "returns nil" do
+          tp.select_from_table_without_header(:column_0, :column_1 => '123').should eq nil
+          tp.select_from_table_with_header(:country, :total_area => '123').should eq nil
+        end
+      end
+      context "found by Regexp" do
+        it "returns found cells" do
+          tp.select_from_table_without_header(:column_0, :column_1 => /103/).text.should eq 'Iceland'
+          tp.select_from_table_with_header(:country, :total_area => /337/).text.should eq 'Finland'
+        end
+        it "returns nil" do
+          tp.select_from_table_without_header(:column_0, :column_1 => /123/).should eq nil
+          tp.select_from_table_with_header(:country, :total_area => /123/).should eq nil
+        end
+      end
+    end
+  end
+end
+

data/spec/shared_examples.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+
+shared_examples_for "a label" do 
+  it { should respond_to(:label)}
+  it { should respond_to(:label_value)}
+  specify { subject.label_value.should be_a(Symbol)}
+end
+
+shared_examples_for "a locator" do 
+  it { should respond_to(:locator) }
+  it { should respond_to(:locator_value)}
+end

data/spec/spec_helper.rb

@@ -1,15 +1,2 @@
-# -*- encoding : utf-8 -*-
-require "rspec"
-require 'page_object_wrapper'
-
-RSpec.configure do |config|
-config.before(:suite) {
-	PageObjectWrapper.start_browser
-	PageObjectWrapper.domain = 'http://google.com'
-}
-
-config.after(:suite) {    
-	PageObjectWrapper.stop_browser
-}
-end
-
+require "page_object_wrapper"
+Selenium::WebDriver::Firefox.path='/opt/firefox/firefox'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: page_object_wrapper
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-03 00:00:00.000000000 Z
+date: 2012-12-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
-  requirement: &8651860 !ruby/object:Gem::Requirement
+  requirement: &11659160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *8651860
+  version_requirements: *11659160
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &8651340 !ruby/object:Gem::Requirement
+  requirement: &11658620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,7 +32,7 @@ dependencies:
         version: 2.0.0
   type: :development
   prerelease: false
-  version_requirements: *8651340
+  version_requirements: *11658620
 description: Wraps watir-webdriver with convenient testing interface, based on PageObjects
   automation testing pattern. Simplifies resulting automated test understanding.
 email:
@@ -42,28 +42,33 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
-- Gemfile
-- LICENSE.txt
 - README.md
-- Rakefile
+- bad_pages/bad_page.rb
+- good_pages/another_test_page.rb
+- good_pages/some_test_page.rb
+- good_pages/test_table_page.rb
+- img/scheme.png
 - lib/page_object_wrapper.rb
-- lib/page_object_wrapper/Distribution.rb
-- lib/page_object_wrapper/DynamicClass.rb
-- lib/page_object_wrapper/Editable.rb
+- lib/page_object_wrapper/Action.rb
+- lib/page_object_wrapper/Dsl.rb
+- lib/page_object_wrapper/Element.rb
+- lib/page_object_wrapper/ElementsSet.rb
 - lib/page_object_wrapper/Exceptions.rb
-- lib/page_object_wrapper/Form.rb
+- lib/page_object_wrapper/PageObject.rb
 - lib/page_object_wrapper/Pagination.rb
-- lib/page_object_wrapper/Submitter.rb
 - lib/page_object_wrapper/Table.rb
+- lib/page_object_wrapper/known_elements.rb
 - lib/page_object_wrapper/version.rb
-- page_object_wrapper.gemspec
-- spec/example_spec.rb
-- spec/form_spec.rb
-- spec/page_object_spec.rb
-- spec/pagination_spec.rb
+- spec/define_page_object_spec.rb
+- spec/defined_elements_spec.rb
+- spec/feed_elements_spec.rb
+- spec/fire_event_spec.rb
+- spec/generate_spec.rb
+- spec/load_spec.rb
+- spec/open_spec.rb
+- spec/select_from_spec.rb
+- spec/shared_examples.rb
 - spec/spec_helper.rb
-- spec/table_spec.rb
-- spec/test_data_spec.rb
 homepage: https://github.com/evgeniy-khatko/page_object_wrapper
 licenses: []
 post_install_message: 
@@ -90,10 +95,13 @@ signing_key:
 specification_version: 3
 summary: Wraps watir-webdriver with convenient testing interface.
 test_files:
-- spec/example_spec.rb
-- spec/form_spec.rb
-- spec/page_object_spec.rb
-- spec/pagination_spec.rb
+- spec/define_page_object_spec.rb
+- spec/defined_elements_spec.rb
+- spec/feed_elements_spec.rb
+- spec/fire_event_spec.rb
+- spec/generate_spec.rb
+- spec/load_spec.rb
+- spec/open_spec.rb
+- spec/select_from_spec.rb
+- spec/shared_examples.rb
 - spec/spec_helper.rb
-- spec/table_spec.rb
-- spec/test_data_spec.rb

data/Gemfile

@@ -1,4 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in page_object_wrapper.gemspec
-gemspec

data/LICENSE.txt

@@ -1,22 +0,0 @@
-Copyright (c) 2012 ekhatko
-
-MIT License
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.