page_object_wrapper 0.0.6 → 1.0.0

data/lib/page_object_wrapper/Pagination.rb

@@ -1,59 +1,8 @@
-require 'Exceptions'
+require 'Dsl'
+class Pagination < DslElementWithLocator
 
-class Pagination
-
-	def initialize(page_object,pagination_div_args)
-		page_numbers=[]
-		link_pattern=''
-		@pagination_links=[]
-		@page_object=page_object
-		@accessor=@page_object.class.accessor
-		@base_url=@page_object.class.url
-		if @accessor.div(pagination_div_args).exists?
-			raise ArgumentError.new("Cant find ul list inside div #{pagination_div_args.inspect} on page #{@accessor.url}") if not @accessor.div(pagination_div_args).ul.exists?
-			raise ArgumentError.new("Pagination link not found inside div #{pagination_div_args.inspect} on page #{@accessor.url}") if @accessor.div(pagination_div_args).ul.links.to_a.empty?
-			@accessor.div(pagination_div_args).ul.links.each{|l| 
-				if l.text=~/\d/
-					page_numbers << l.text.to_i 
-					@link_pattern=l.href
-				end
-			}
-			page_numbers.collect(&:to_i).sort!
-			for i in page_numbers.first..page_numbers.last do
-				@pagination_links << @link_pattern.gsub(/=\d+/,"="+i.to_s)
-			end
-		else
-			# assuming that page has no pagination links
-			@pagination_links << @base_url
-			@link_pattern=@base_url
-		end
-	end
-
-	def number(n)
-		raise ArgumentError.new("Cant find pagination page number #{n} on Page #{@accessor.url}") if not @pagination_links.include?(@link_pattern.gsub(/=\d+/,"="+(n).to_s))
-		change_page(@pagination_links[n-1])
-	end
-
-	def first
-		change_page(@pagination_links.first)
-	end
-	def last
-		change_page(@pagination_links.last)
-	end
-	def reset
-		change_page(@base_url)
-	end
-	def each
-		@pagination_links.each{|link| 
-			p=change_page(link)
-			yield p
-		}
-	end
-		
-
-private
-	def change_page(link)
-		@page_object.class.url=link
-		@page_object.class.new(true)
-	end
+  def initialize(label)
+    super label
+  end
 end
+

data/lib/page_object_wrapper/Table.rb

@@ -1,50 +1,15 @@
-require 'Exceptions'
+require 'Dsl'
+class Table < DslElementWithLocator
+  dsl_attr_accessor :header
+  DEFAULT_HEADER_COLLUMNS_NUMBER = 100 
+  DEFAULT_HEADER_COLLUMNS_PREFIX = 'column_'
+  
 
-class Table < Watir::Table
-	def initialize(accessor,*args)
-		super(accessor, extract_selector(args).merge(:tag_name => "table"))
-		@cells=[]
-		self.rows.each{|row|
-			row.cells.each{|cell|
-				@cells << cell
-			}
-		}
-	end
-
-	def has_cell?(text)
-		@cells.collect(&:text).include?(text)
-	end
-	def cells
-		@cells
-	end
-	def select(column_name,where_hash)
-		######## TABLE ##############
-		# HEADER r0,c0 r0,c1,...,r0cN
-		# ROW    r1,c0,r1,c1,...,r1cN
-		return_column,find_by_column_name,find_by_column_value=nil
-		begin
-			return_column=Regexp.new(column_name)
-			find_by_column_name=Regexp.new(where_hash[:where].keys.first)
-			find_by_column_value=where_hash[:where].values.first
-		rescue
-			raise TableError.new('invalid parameters, check column names and parameters (must be Table#select(column_name_regexp,:where=>{column_name_regexp=>value_or_:any}))','select',column_name,where_hash) if not find_attrs_valid?(column_name,where_hash)
-		end
-		index=0
-		return_index=nil
-		find_by_index=nil
-		self.rows[0].cells.each{|header_cell|
-			return_index=index if return_column===header_cell.text
-			find_by_index=index if find_by_column_name===header_cell.text
-			index+=1
-		}
-		raise TableError.new("column not found",'select',column_name) if return_index.nil?
-		raise TableError.new("column not found",'select',where_hash) if find_by_index.nil?
-		return self.rows[1].cells[return_index] if find_by_column_value==:any
-		found=nil
-		self.rows.each{|row|
-			found=row.cells[return_index] if row.cells[find_by_index].text==find_by_column_value
-		}
-		raise TableError.new("value #{find_by_column_value} not found in column #{find_by_column_name}",'select',column_name,where_hash) if found.nil?
-		found
-	end
+  def initialize(label)
+    super label
+    h = []
+    DEFAULT_HEADER_COLLUMNS_NUMBER.times { |i| h << (DEFAULT_HEADER_COLLUMNS_PREFIX+i.to_s).to_sym }
+    @header = h
+  end
 end
+

data/lib/page_object_wrapper/known_elements.rb

@@ -0,0 +1,31 @@
+KNOWN_ELEMENTS = [
+  'a', 'abbr', 'abbrs', 'address', 'addresses', 'area', 
+  'areas', 'article', 'articles', 'as', 'aside', 'asides', 
+  'audio', 'audios', 'b', 'base', 'bases', 'bdi', 'bdis', 
+  'bdo', 'bdos', 'blockquote', 'blockquotes', 'body', 'bodys', 
+  'br', 'brs', 'bs', 'button', 'buttons', 'canvas', 'canvases', 
+  'caption', 'captions', 'checkbox', 'checkboxes', 'cite', 
+  'cites', 'code', 'codes', 'col', 'colgroup', 'colgroups', 
+  'cols', 'command', 'commands', 'datalist', 'datalists', 
+  'dd', 'dds', 'del', 'dels', 'details', 'dfn', 'dfns', 'div', 
+  'divs', 'dl', 'dls', 'dt', 'dts', 'element', 'elements', 
+  'em', 'embed', 'embeds', 'ems', 'fieldset', 'fieldsets', 'figcaption', 
+  'figcaptions', 'figure', 'figures', 'file_field', 'file_fields', 'font', 
+  'fonts', 'footer', 'footers', 'form', 'forms', 'frame', 'frames', 
+  'h1', 'h1s', 'h2', 'h2s', 'h3', 'h3s', 'h4', 'h4s', 'h5', 'h5s', 'h6', 
+  'h6s', 'head', 'header', 'headers', 'heads', 'hgroup', 'hgroups', 
+  'hidden', 'hiddens', 'hr', 'hrs', 'html', 'htmls', 'i', 'iframe', 
+  'iframes', 'img', 'imgs', 'input', 'inputs', 'ins', 'inses', 
+  'is', 'kbd', 'kbds', 'keygen', 'keygens', 'label', 'labels', 'legend', 
+  'legends', 'li', 'link', 'lis', 'map', 'maps', 'mark', 'marks', 'menu', 'menus', 
+  'meta', 'metas', 'meter', 'meters', 'nav', 'navs', 'noscript', 'noscripts', 
+  'object', 'objects', 'ol', 'ols', 'optgroup', 'optgroups', 'option', 'options', 
+  'output', 'outputs', 'p', 'param', 'params', 'pre', 'pres', 'progress', 'progresses', 
+  'ps', 'q', 'qs', 'radio', 'radios', 'rp', 'rps', 'rt', 'rts', 'rubies', 'ruby', 's', 
+  'samp', 'samps', 'script', 'scripts', 'section', 'sections', 'select', 'selects', 'small', 
+  'smalls', 'source', 'sources', 'span', 'spans', 'ss', 'strong', 'strongs', 'style', 'styles', 
+  'sub', 'subs', 'summaries', 'summary', 'sup', 'sups', 'table', 'tables', 'tbody', 'tbodys', 'td', 
+  'tds', 'text_field', 'text_fields', 'textarea', 'textareas', 'tfoot', 'tfoots', 'th', 'thead', 
+  'theads', 'ths', 'time', 'times', 'title', 'titles', 'tr', 'track', 'tracks', 'trs', 'ul', 
+  'uls', 'var', 'vars', 'video', 'videos', 'wbr', 'wbrs'
+]

data/lib/page_object_wrapper/version.rb

@@ -1,3 +1,3 @@
 module PageObjectWrapper
-  VERSION = "0.0.6"
+  VERSION = "1.0.0"
 end

data/spec/define_page_object_spec.rb

@@ -0,0 +1,162 @@
+require 'spec_helper'
+require 'shared_examples'
+
+describe "define_page_object" do
+  let!(:page_object){
+    begin
+      PageObjectWrapper.load('./good_pages')
+    rescue
+    end
+    PageObjectWrapper.receive_page(:some_test_page)
+  }
+
+  context "page_object" do
+    subject { page_object }
+    it { should be_a(PageObject)}
+    specify {page_object.class.pages.should include(subject)}
+
+    describe "page_object label" do
+      it_should_behave_like "a label"
+    end
+
+    describe "page_object locator" do
+      it_should_behave_like "a locator"
+      its(:locator_value) { should be_a String }
+    end
+
+    describe "page_object uniq_element" do
+      its(:uniq_element_type) { should eq :h1 }
+      its(:uniq_element_hash) { should == {:text => 'Testing display of HTML elements'} }
+    end
+
+    specify { subject.esets.collect(&:label_value).should include(:test_elements)}
+    it { should respond_to(:test_elements) }
+    it { should respond_to(:feed_test_elements) }
+
+    specify { subject.elements.collect(&:label_value).should include(:tf)}
+    it { should respond_to(:tf) }
+
+    specify { subject.actions.collect(&:label_value).should include(:press_cool_button)}
+    it { should respond_to(:fire_press_cool_button) }
+
+    specify { subject.tables.collect(&:label_value).should include(:table_without_header)}
+    it { should respond_to(:select_from_table_without_header) }
+    it { should respond_to(:select_from_table_with_header) }
+
+    specify { subject.paginations.collect(&:label_value).should include(:some_pagination)}
+    it { should respond_to(:some_pagination_each) }
+    it { should respond_to(:some_pagination_open) }
+  end
+
+
+  context "elements_set" do
+    subject { page_object.esets[page_object.esets.collect(&:label_value).index(:test_elements)] }
+    
+    it { should be_a(ElementsSet) }
+
+    describe "elements_set label" do
+      it_should_behave_like "a label"
+    end
+  end
+
+  context "element" do
+    subject { page_object.elements[page_object.elements.collect(&:label_value).index(:tf)] }
+    
+    it { should be_a(Element) }
+
+    describe "element label" do
+      it_should_behave_like "a label"
+    end
+    
+    describe "element locator" do
+      it_should_behave_like "a locator"
+      its(:locator_value) { should be_a Hash }
+    end
+
+    describe "element food" do
+      it { should respond_to(:fresh_food) }
+      it { should respond_to(:fresh_food_value) }
+      it { should respond_to(:missing_food) }
+      it { should respond_to(:missing_food_value) }
+
+      its(:fresh_food_value) { should be_a String}
+      its(:missing_food_value) { should be_a String}
+
+      describe "food default values" do
+        its(:fresh_food_value){ should eq('some fresh food') }
+      end
+
+      describe "food user defined values" do
+        its(:missing_food_value){ should eq('some missing food') }
+      end
+    end
+  end
+    
+  context "action" do
+    subject { page_object.actions[page_object.actions.collect(&:label_value).index(:press_cool_button)] }
+
+    it { should be_a(Action) }
+
+    describe "action label" do
+      it_should_behave_like "a label"
+    end
+
+    describe "action next_page" do
+      it { should respond_to(:next_page_value) }
+      it { should respond_to(:fire_block_value) }
+
+      its(:next_page_value){ should eq(:test_page_with_table) }
+      its(:fire_block_value) { should be_a Proc }
+    end
+  end
+
+  context "table" do
+    subject { page_object.tables[page_object.tables.collect(&:label_value).index(:table_without_header)] }
+
+    it { should be_a(Table) }
+
+    describe "table label" do
+      it_should_behave_like "a label"
+    end
+  
+    describe "element locator" do
+      it_should_behave_like "a locator"
+      its(:locator_value) { should be_a Hash }
+    end
+
+    describe "table header" do
+      it { should respond_to(:header) }
+      it { should respond_to(:header_value) }
+
+      its(:header_value) { should be_a Array}
+
+      describe "default header" do
+        subject { page_object.tables[page_object.tables.collect(&:label_value).index(:table_without_header)] }
+        let(:default_header){
+          h = []
+          100.times {|i| h << ('column_'+i.to_s).to_sym}
+          h
+        }
+        its(:header_value) { should eq(default_header)}
+      end
+
+      describe "user defined header" do
+      end
+    end
+  end
+
+  describe "pagination" do
+    subject { page_object.paginations[page_object.paginations.collect(&:label_value).index(:some_pagination)] }
+
+    it { should be_a(Pagination) }
+
+    describe "pagination label" do
+      it_should_behave_like "a label"
+    end
+  
+    describe "pagination locator" do
+      it_should_behave_like "a locator"
+      its(:locator_value) { should be_a Hash }
+    end
+  end
+end

data/spec/defined_elements_spec.rb

@@ -0,0 +1,77 @@
+require 'spec_helper'
+require 'shared_examples'
+
+describe "page_object.xxx" do
+  context "page is opened in browser" do
+
+    before(:all){
+      @b = Watir::Browser.new
+      PageObjectWrapper.use_browser @b
+      begin
+        PageObjectWrapper.load('./good_pages')
+      rescue
+      end
+    }
+    after(:all){ PageObjectWrapper.browser.close }
+
+    subject{ PageObjectWrapper.open_page(:some_test_page) }
+
+    context "xxx is an element" do
+      its(:tf){ should be_a(Watir::TextField) }
+      its("tf.id"){ should eq 'f1' }
+
+      its(:ta){ should be_a(Watir::TextArea) }
+      its("ta.id"){ should eq 'f2' }
+
+      its(:s1){ should be_a(Watir::Select) }
+      its("s1.id"){ should eq 'f10' }
+
+      its(:s2){ should be_a(Watir::Select) }
+      its("s2.id"){ should eq 'f11' }
+
+      its(:cb){ should be_a(Watir::CheckBox) }
+      its("cb.id"){ should eq 'f5' }
+
+      its(:rb){ should be_a(Watir::Radio) }
+      its("rb.id"){ should eq 'f3' }
+    end
+
+    context "xxx is an elements_set" do
+      its(:test_elements){ should be_a Array }
+    end
+
+    context "xxx is not defined in page_object" do
+      it "raises NoMethodError" do
+        expect{subject.undefined_element}.to raise_error(NoMethodError)
+      end
+    end
+  end
+
+  context "page is not opened in a browser" do
+    before(:all){
+      @b = Watir::Browser.new
+      PageObjectWrapper.use_browser @b
+      begin
+        PageObjectWrapper.load('./good_pages')
+      rescue
+      end
+    }
+    after(:all){ PageObjectWrapper.browser.close }
+
+    subject{ PageObjectWrapper.receive_page(:some_test_page) }
+    
+    context "xxx is an element" do
+      its("tf.present?"){ should be_false }
+
+      it "raises Watir::Exception::UnknownObjectException when working with element" do
+        expect{ subject.tf.set 'qqq' }.to raise_error(Watir::Exception::UnknownObjectException)
+      end
+    end
+
+    context "xxx is an elements_set" do
+      its(:test_elements){ should be_a Array }
+    end
+  end
+end
+
+

data/spec/feed_elements_spec.rb

@@ -0,0 +1,95 @@
+require 'spec_helper'
+require 'shared_examples'
+
+describe "page_object.feed_xxx" do
+  context "browser is closed" do
+    before(:all){
+      begin
+        PageObjectWrapper.browser.quit if not PageObjectWrapper.browser.nil?
+        PageObjectWrapper.load('./good_pages')
+      rescue
+      end
+    }
+
+    it "raises PageObjectWrapper::BrowserNotFound" do
+      tp = PageObjectWrapper.receive_page(:some_test_page)
+      expect{ tp.feed_test_elements }.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}
+
+    it "returns current page object" do
+      tp = PageObjectWrapper.open_page(:some_test_page)
+      tp.feed_test_elements.should eq(tp)
+    end
+    
+    context "xxx not found among current_page element_sets" do
+      it "raises NoMethodError" do
+        tp = PageObjectWrapper.current_page
+        expect{tp.feed_empty_set}.to raise_error(NoMethodError)
+      end
+    end
+
+    context "argument = :fresh_food" do
+      it "populates all xxx elements with :fresh_food" do
+        tp = PageObjectWrapper.current_page
+        tp.feed_test_elements(:fresh_food)
+        @b.text_field(:id=>'f1').value.should eq 'some fresh food'
+        @b.textarea(:id=>'f2').value.should eq 'default fresh food'
+        @b.select(:id=>'f10').value.should eq "one\n"
+        @b.select(:id=>'f11').value.should eq "one\n"
+        @b.checkbox(:id=>'f5').should be_set
+        @b.radio(:id=>'f3').should be_set
+      end
+    end
+
+    context "argument = nil" do
+      it "populates all xxx elements with :fresh_food" do
+        tp = PageObjectWrapper.current_page
+        tp.feed_test_elements
+        @b.text_field(:id=>'f1').value.should eq 'some fresh food'
+        @b.textarea(:id=>'f2').value.should eq 'default fresh food'
+        @b.select(:id=>'f10').value.should eq "one\n"
+        @b.select(:id=>'f11').value.should eq "one\n"
+        @b.checkbox(:id=>'f5').should be_set
+        @b.radio(:id=>'f3').should be_set
+      end
+    end
+
+    context "argument = :missing_food" do
+      it "populates all xxx elements with :missing_food" do
+        tp = PageObjectWrapper.open_page(:some_test_page)
+        tp.feed_test_elements(:missing_food)
+        @b.text_field(:id=>'f1').value.should eq 'some missing food'
+        @b.textarea(:id=>'f2').value.should eq 'default missing food'
+        @b.select(:id=>'f10').value.should eq "three\n"
+        @b.select(:id=>'f11').value.should eq "two (default)\n"
+        @b.checkbox(:id=>'f5').should be_set
+        @b.radio(:id=>'f3').should be_set
+      end
+    end
+
+    context "fresh food is not found in select list" do
+      it "raises Watir Watir::Exception::NoValueFoundException" do
+        atp = PageObjectWrapper.open_page(:another_test_page)
+        expect{atp.feed_test_elements}.to raise_error(Watir::Exception::NoValueFoundException)
+      end
+    end
+    context "missing food is not found in select list" do
+      it "continues execution" do
+        atp = PageObjectWrapper.current_page
+        atp.feed_test_elements(:missing_food).should eq(atp)
+      end
+    end
+  end
+end