page_object_wrapper 0.0.1 → 0.0.2

data/spec/page_object_spec.rb

@@ -0,0 +1,173 @@
+# -*- encoding : utf-8 -*-
+require 'spec_helper'
+
+describe "Page object" do
+  describe "PageObjectWrapper" do
+    let(:google_search_page_class){
+      class GoogleSearchPage < PageObjectWrapper::Page
+        attr_accessor :find_form
+        @url="/"
+        def initialize visit=false 
+          super visit
+        end
+      end
+      GoogleSearchPage
+    }
+
+    it "has .start_browser method which puts Watir::Browser.new to Page.accessor by default", :code => 19..20 do
+      PageObjectWrapper.stop_browser # stoping browser of (before :suite) hook
+      PageObjectWrapper.start_browser
+      PageObjectWrapper::Page.accessor.should be_a(Watir::Browser)
+      PageObjectWrapper.stop_browser
+    end
+
+    it "has .stop_browser method which closes browser", :code => 26..27 do
+      PageObjectWrapper.start_browser
+      PageObjectWrapper.stop_browser
+      PageObjectWrapper::Page.accessor.should_not exist
+    end
+
+    it "has .restart_browser method which restart current browser", :code => 31..33 do
+      PageObjectWrapper.start_browser
+      PageObjectWrapper.restart_browser
+      PageObjectWrapper::Page.accessor.should be_a(Watir::Browser)
+      PageObjectWrapper.stop_browser
+    end
+
+    it "has .domain= method which reprsents the domain of DUT", :code => 39..41 do
+      PageObjectWrapper.start_browser
+      PageObjectWrapper.domain = 'www.google.com'
+      google_search_page_class.new(true)
+      PageObjectWrapper::Page.accessor.title.should eq('Google')
+      PageObjectWrapper.stop_browser
+    end
+
+    it "has .timeout= method which sets implicit timeout for webdriver (default is 5 sec)" do
+      pending "not working yet"
+    end
+  end
+
+  describe "PageObject class and instance in general", :code => 51..60 do
+    let(:page_object){
+      class GoogleSearchPage < PageObjectWrapper::Page
+        attr_accessor :find_form
+        @url="/"
+        def initialize visit=false 
+          super visit
+        end
+      end
+      GoogleSearchPage
+    }
+
+    it "PageObject class has @url class variable which can be treated as Page specific path inside current domain", :code => 63 do
+        page_object.url.should eq('/')
+    end
+
+    it "init with \'true\' is similar to openning page in browser", :code => 68..69 do
+      PageObjectWrapper.start_browser
+      google_search_page = page_object.new(true)
+      page_object.accessor.title.should eq('Google')
+    end
+
+    it "init with \'false\' just returns new instanse, but does not opens browser on that page", :code => 74..75 do
+      PageObjectWrapper.restart_browser
+      google_search_page = page_object.new(false)
+      page_object.accessor.title.should_not eq('Google')
+    end
+  end
+
+  describe "expected element", :code => 80..103 do
+  let(:google_search_with_wrong_expected_element_page_class){
+    class NotGoogleSearchPage < PageObjectWrapper::Page
+      attr_accessor :find_form
+      @url="/"
+      expected_element :text_field, :name => 'some element that does not exist on the page' 
+
+      def initialize visit=false 
+        super visit
+      end
+    end
+    NotGoogleSearchPage
+  }
+  let(:google_search_with_correct_expected_element_page_class){
+    class GoogleSearchPage < PageObjectWrapper::Page
+      attr_accessor :find_form
+      @url="/"
+      expected_element :text_field, :name => 'q'
+
+      def initialize visit=false 
+        super visit
+      end
+    end
+    GoogleSearchPage
+  }
+
+    it "should raise error when trying to init google_search_with_wrong_expected_element_page_class", :code => 106..113 do
+      begin
+      gsearch_page = google_search_with_wrong_expected_element_page_class.new(true) 
+      rescue PageError => e
+        e.should be_a(PageError)
+        e.message.should =~ /PROBLEM:/
+        e.message.should =~ /PAGE:/
+        e.message.should =~ /URL:/
+      end
+    end
+
+    it "should init google_search_with_correct_expected_element_page_class successfully", :code => 117..118 do
+      gsearch_page = google_search_with_correct_expected_element_page_class.new(true)
+      gsearch_page.should be_a(google_search_with_correct_expected_element_page_class)
+    end
+  end
+
+  describe "creation of a PageObject method", :code => 123..163 do
+    let(:pages_definition){
+      class GoogleAdvancedSearchPage < PageObjectWrapper::Page
+        attr_accessor :as_form
+        @url="/advanced_search"
+        expected_element :text_field, :name => 'as_q'
+        def initialize visit=false
+          super visit
+          @as_form = form(GoogleResultsPage, {:name => 'f'})
+          @as_form.editable(:text_field, {:name => 'as_q'}, :with_words, 'with_words default value', true)
+          @as_form.editable(:text_field, {:name => 'as_epq'}, :with_phrase, 'with_phrase default value', true)
+          @as_form.editable(:text_field, {:name => 'as_oq'}, :with_any_word, 'with_any_word default value', false)
+          @as_form.submitter(:input, {:type => 'submit'})
+        end
+      end
+
+      class GoogleResultsPage < PageObjectWrapper::Page
+        @url="/"
+        expected_element :button, :name => 'btnG'
+        def initialize visit=false 
+          super visit
+        end
+
+        def open_advanced_search
+          @@accessor.span(:id => 'ab_opt_icon').when_present.click 
+          @@accessor.a(:id => 'ab_as').when_present.click
+          GoogleAdvancedSearchPage.new 
+        end
+      end
+
+      class GoogleSearchPage < PageObjectWrapper::Page
+        attr_accessor :find_form
+        @url="/"
+        expected_element :text_field, :name => 'q' 
+        def initialize visit=false 
+          super visit
+          @find_form = form(GoogleResultsPage, {:action => '/search'}) 
+          @find_form.editable(:text_field, {:name => 'q'}, :seach_what, '@find_form default value', true) 
+        end
+      end
+      {:gsearch_page_class => GoogleSearchPage, :gresults_page => GoogleResultsPage, :gadv_page => GoogleAdvancedSearchPage}
+    }
+
+    it "return value should be another PageObject instance", :code => 166..170 do
+      gsearch_page = pages_definition[:gsearch_page_class].new(true)
+      gsearch_page.find_form.fill_required 
+      gresults_page = gsearch_page.find_form.submit(true) 
+      gadv_page = gresults_page.open_advanced_search
+      gadv_page.should be_a(pages_definition[:gadv_page])
+    end
+  end
+end

data/spec/pagination_spec.rb

@@ -0,0 +1,14 @@
+# -*- encoding : utf-8 -*-
+require 'spec_helper'
+describe "Pagination wrapper" do
+  describe "pagination definition" do
+    it "TODO" do
+      pending "Needs to be reimplemented. Current realization is fo rails apps only"
+    end	
+  end
+  describe "pagination usage" do
+    it "TODO" do
+      pending "Needs to be reimplemented. Current realization is fo rails apps only"
+    end	
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+# -*- 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
+

data/spec/table_spec.rb

@@ -0,0 +1,52 @@
+# -*- encoding : utf-8 -*-
+require 'spec_helper'
+
+describe "Table wrapper", :code => 5..19 do
+  before :all do
+    PageObjectWrapper.domain = 'http://wiki.openqa.org'
+  end
+  let(:page_object){
+    class WatirPage < PageObjectWrapper::Page
+      attr_accessor :some_table
+      @url="/display/WTR/HTML+Elements+Supported+by+Watir"
+      expected_element :a, :text => 'HTML Elements Supported by Watir'
+      def initialize visit=false 
+        super visit
+        @some_table = table(:class => 'confluenceTable')
+      end
+    end
+    WatirPage
+  }
+
+  describe "table definition" do
+    it "has #table(how_find_hash) method to define a table on the page", :code => 15 do
+      page = page_object.new(true)
+      page.some_table.should be_a(Table)
+    end
+  end
+  describe "table usage" do
+    it "has #cells method which returns all Watir table cells", :code => 29..30 do
+      page = page_object.new(true)
+      page.some_table.cells.first.should be_a(Watir::TableCell)
+    end
+    
+    it "has #has_cell?(text) method wich returns true if the table has a cell with specified text", :code => 34..35 do
+      page = page_object.new(true)
+      page.some_table.should have_cell('<td>')
+    end
+
+    it "has #select(column_name, where_hash) method wich returns cell inside specified column wich corresponds to a specified where_hash", :code => 39..42 do
+      page = page_object.new(true)
+      cell = page.some_table.select('HTML tag', :where => {'Watir method' => 'cell'})
+      cell.should be_a(Watir::TableCell)
+      cell.text.should eq '<td>'
+    end
+
+    it "is possible to specify just parts of column names in #select method", :code => 47 do
+      page = page_object.new(true)
+      cell = page.some_table.select('HTML', :where => {'Watir met' => 'cell'})
+      cell.should be_a(Watir::TableCell)
+      cell.text.should eq '<td>'
+    end
+  end
+end

data/spec/test_data_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+require 'yaml'
+
+describe "TestData class", :code => 5..16 do
+	let(:user1){
+"login: user1
+email: user1@example.com
+password: secret1
+etc: other data"
+	}
+	let(:user2){
+"login: user2
+email: user2@example.com
+password: secret2
+etc: other data"
+	}
+	it "is initialized with hash and generates dynamic attributes for an instance", :code => 18..22 do
+		dynamically_defined_user = PageObjectWrapper::TestData.new(YAML.load(user1))
+		dynamically_defined_user.login.should eq 'user1'
+		dynamically_defined_user.email.should eq 'user1@example.com'
+		dynamically_defined_user.password.should eq 'secret1'
+		dynamically_defined_user.etc.should eq 'other data'
+	end
+
+	it "has .find method which allows finding dynamically defined objects", :code => 26..29 do
+		dynamically_defined_user1 = PageObjectWrapper::TestData.new(YAML.load(user1))
+		dynamically_defined_user2 = PageObjectWrapper::TestData.new(YAML.load(user2))
+		user1 = PageObjectWrapper::TestData.find(:login,'user1')
+		user1.email.should eq 'user1@example.com'
+	end
+	it "has .each method which allows navigating between objects", :code => 32..36 do
+		dynamically_defined_user1 = PageObjectWrapper::TestData.new(YAML.load(user1))
+		dynamically_defined_user2 = PageObjectWrapper::TestData.new(YAML.load(user2))
+		PageObjectWrapper::TestData.each{|user|
+			user.etc.should eq 'other data'
+		}
+	end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: page_object_wrapper
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-19 00:00:00.000000000 Z
+date: 2012-11-25 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
-  requirement: &23713920 !ruby/object:Gem::Requirement
+  requirement: &10599620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,7 +21,18 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *23713920
+  version_requirements: *10599620
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &10598840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *10598840
 description: Wraps watir-webdriver with convenient testing interface, based on PageObjects
   automation testing pattern. Simplifies resulting automated test understanding.
 email:
@@ -36,14 +47,30 @@ files:
 - README.md
 - Rakefile
 - 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/Exceptions.rb
+- lib/page_object_wrapper/Form.rb
+- lib/page_object_wrapper/Pagination.rb
+- lib/page_object_wrapper/Submitter.rb
+- lib/page_object_wrapper/Table.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/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: 
 rdoc_options: []
 require_paths:
 - lib
+- lib/page_object_wrapper
 required_ruby_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -62,4 +89,11 @@ rubygems_version: 1.8.15
 signing_key: 
 specification_version: 3
 summary: Wraps watir-webdriver with convenient testing interface.
-test_files: []
+test_files:
+- spec/example_spec.rb
+- spec/form_spec.rb
+- spec/page_object_spec.rb
+- spec/pagination_spec.rb
+- spec/spec_helper.rb
+- spec/table_spec.rb
+- spec/test_data_spec.rb