watirloo 0.0.7

data/spec/label_spec.rb

@@ -0,0 +1,65 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+
+describe 'text field wrapped in label tag without for attribute defined' do
+  
+  include Watirloo::Page
+  face(:first) { text_field(:name, 'fn') }
+  face(:last) { text_field(:name, 'ln') }
+  
+  before do
+    browser.goto testfile('labels.html')
+  end
+  
+  it 'parent of text_field should be Watir Element' do
+    if browser.kind_of?(FireWatir::Firefox)
+      first.parent.should be_kind_of(String)
+      last.parent.should be_kind_of?(String)
+      flunk('FIXME Firefox returns String for parent and not Element')
+      
+    elsif browser.kind_of?(Watir::IE)
+      first.parent.should be_kind_of(Watir::Element)
+      last.parent.should be_kind_of(Watir::Element)
+    end
+    
+  end
+  
+  it 'parent tagName should be a LABEL' do
+    if browser.kind_of?(Watir::IE)
+      first.parent.document.tagName.should == "LABEL"
+      last.parent.document.tagName.should == "LABEL"
+
+    elsif browser.kind_of?(FireWatir::Firefox)
+      flunk('FIXME Firefox returns String for parent and not Element')
+    end
+  end
+  
+  it 'parent text returns text of label' do
+    if browser.kind_of?(Watir::IE)
+      first.parent.text.should == 'First Name'
+      last.parent.text.should == 'Last Name'
+
+    elsif browser.kind_of?(FireWatir::Firefox)
+      flunk('FIXME Firefox returns String for parent and not Element.')
+    end
+  end
+end
+
+
+
+describe 'label for text field not wrapped' do
+
+  # reopen the class and add more interfaces
+  include Watirloo::Page
+  face(:first_label) { label(:for, 'first_nm') }
+  face(:last_label) { label(:for, 'last_nm') }
+  
+  before do
+    browser.goto testfile('labels.html')
+  end
+  
+  it 'text value of label' do
+    first_label.text.should == 'FirstName For'
+    last_label.text.should == 'LastName For'
+  end
+end

data/spec/locker_spec.rb

@@ -0,0 +1,49 @@
+require File.dirname(__FILE__) + '/spec_helper'
+  
+
+describe "Locker" do
+
+  it "locker file does not exist. create it. mapping should return empty hash" do
+    Watirloo::Locker.mapping.clear
+    FileUtils.rm_f(Watirloo::Locker.locker) if FileTest.exist?(Watirloo::Locker.locker) #remove locker file
+    FileTest.exist?(Watirloo::Locker.locker).should be_false
+    Watirloo::Locker.mapping.should == {}
+  end
+
+  it "clear should create locker file and save empty mapping" do
+    Watirloo::Locker.clear
+    FileTest.exist?(Watirloo::Locker.locker).should be_true
+    Watirloo::Locker.mapping.should == {}
+  end
+
+  it 'add stores ie.hwnd with friendly name and adds it to mapping' do
+    ie = Watir::IE.new
+    Watirloo::Locker.add(ie, 'one')
+    Watirloo::Locker.add(ie, 'two')
+  end
+
+  it 'mapping holds what was added' do
+    Watirloo::Locker.mapping.keys.sort.should == ['one', 'two']
+    Watirloo::Locker.mapping['one'].should == Watirloo::Locker.mapping['two']
+  end
+
+  it 'remove deletes a key value record ' do
+    Watirloo::Locker.remove 'two'
+    Watirloo::Locker.mapping.keys.should_not include('two')
+  end
+
+  it 'browser reattaches to named browser based on windows handle' do
+    ie = Watirloo::Locker.browser 'one'
+    ie.should be_kind_of(Watir::IE)
+    ie.hwnd.should == Watirloo::Locker.mapping['one']
+    ie.should exist
+    ie.close
+    ie.should_not exist
+  end
+
+  it 'browser attach to nonexisting windows behaves like IE.attach, it raises error' do
+    sleep 6 # if previous test closes a browser we need to wait to ensure we don't reattach to a closing browser
+    (lambda {Watirloo::Locker.browser('one')}).should raise_error(Watir::Exception::NoMatchingWindowFoundException) #points to the same hwnd as 'one' but at this time does not exist any more
+  end
+  
+end

data/spec/page_spec.rb

@@ -0,0 +1,91 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "Page class with face definitions" do
+  class Page1
+    include Watirloo::Page
+  end
+  
+  it 'has face method as singleton' do
+    Page1.singleton_methods.should include('face')
+  end
+
+  it 'face class method defines method' do
+    Page1.face(:bla) do
+      "hello"
+    end
+    page = Page1.new
+    page.should respond_to(:bla)
+    page.bla.should == 'hello'
+  end
+
+  it 'face accepts args used by method body' do
+    Page1.face(:foo) do |x|
+      x * 2
+    end
+    page = Page1.new
+    page.foo(2).should == 4
+    page.foo("bla").should == "blabla"
+  end
+
+  it "when optional args not supplied provide default arg in method" do
+    # this is a strange design decision. I want to provide method arg with default
+    # example def bar(x=0) 
+    Page1.face(:bar) do |*x|
+      x = x[0] || 0
+      x
+    end
+    page = Page1.new
+    page.bar.should == 0
+    page.bar(3).should == 3
+  end
+end
+
+describe "Page faces included in rspec" do
+
+  include Watirloo::Page
+  face(:last1) { text_field(:name, 'last_name0')}
+  face(:last) {|nbr| text_field(:name, "last_name#{nbr+1}")}
+
+  before do
+    browser.goto testfile('census.html')
+  end
+
+
+  it 'face defines a watir element access' do
+    last1.set "Zippididuda"
+    last1.value.should == 'Zippididuda'
+  end
+
+  it 'faces with arguments' do
+    last(1).set "Zorro"
+    last(1).value.should == "Zorro"
+  end
+
+
+end
+
+
+describe "Page doc provides access to frame in frameset browser" do
+
+  include Watirloo::Page
+  face(:last1) {text_field(:name, 'last_name0')}
+  face(:last) {|nbr| text_field(:name, "last_name#{nbr+1}")}
+
+  before do
+    browser.goto testfile('frameset1.html')
+    self.page = browser.frame(:name,'census_frame')
+  end
+
+
+  it 'face defines a watir element access' do
+    last1.set "Zippididuda"
+    last1.value.should == 'Zippididuda'
+  end
+
+  it 'faces with arguments' do
+    last(1).set "Zorro"
+    last(1).value.should == "Zorro"
+  end
+
+
+end

data/spec/person_def_wrappers_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "Person Page interfaces defined by def wrappers and class definitions" do
+
+  include Watirloo::Page
+  # declare accessing elements
+  face(:first) { text_field(:name, 'first_nm') }
+  face(:street) { text_field(:name, 'addr1') }
+
+  # def wrapper helper with suggested semantic name returns dom element
+  def last
+    browser.text_field(:name, 'last_nm')
+  end
+
+  def dob
+    browser.text_field(:name, 'dob')
+  end
+  
+  before :each do
+    browser.goto testfile('person.html')
+  end
+  
+  it 'calling face when there is wrapper method' do
+    last.set 'Wonkatonka'
+    last.value.should == 'Wonkatonka'
+  end
+  
+  it 'calling interface when there is definition and no method' do
+    first.set 'Oompaloompa'
+    first.value.should == 'Oompaloompa'
+  end
+  
+  it 'spray method by convetion has keys correspondig to interface names for watir elements' do
+    datamap = {:street => '13 Sad Enchiladas Lane', :dob => '02/03/1977'}
+    spray datamap
+    street.value.should == datamap[:street]
+    dob.value.should == datamap[:dob]
+  end
+  
+end

data/spec/radio_group_spec.rb

@@ -0,0 +1,95 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe 'RadioGroup class access in watir browser' do
+  include Watirloo::Page
+
+  before :each do
+    browser.goto testfile('radio_group.html')
+  end
+  
+  it 'browser responds to radio_group' do
+    browser.should respond_to(:radio_group)
+  end
+  
+  it 'radio group needs :what value with implicit :how=name' do
+    rg = browser.radio_group('food')
+    rg.size.should == 3
+    rg.values.should == %w[hotdog burger tofu]
+  end
+end
+
+
+describe 'RadioGroup class interface in watirloo' do
+  
+  include Watirloo::Page
+  face :meals_to_go do
+    radio_group('food')
+  end
+
+  before do
+    browser.goto testfile('radio_group.html')
+  end
+  
+  it 'container radio_group method returns RadioGroup class' do
+    # verify browser namespace explicitly
+    if browser.kind_of?(FireWatir::Firefox)
+      meals_to_go.should be_kind_of(FireWatir::RadioGroup)
+    elsif browser.kind_of?(Watir::IE)
+      meals_to_go.should be_kind_of(Watir::RadioGroup)
+    end
+  end
+  
+  it 'size or count returns how many radios in a group' do
+    meals_to_go.size.should == 3
+    meals_to_go.count.should == 3
+  end
+  
+  it 'values returns value attributes text items as an array' do
+    meals_to_go.values.should == ["hotdog", "burger", "tofu"]
+  end
+  
+  it 'selected_value returns internal option value for selected radio item in a group' do 
+    meals_to_go.selected.should == 'burger'
+    meals_to_go.selected_value.should == 'burger'
+    meals_to_go.selected_values.should == ['burger'] # matches select_list api
+  end
+  
+  it 'set selects radio by position in a group' do
+    meals_to_go.set 3
+    meals_to_go.selected.should == 'tofu'
+    meals_to_go.selected_value.should == 'tofu'
+    meals_to_go.selected_values.should == ['tofu']
+    meals_to_go.selected.should_not == 'hotdog'
+
+    meals_to_go.set 1
+    meals_to_go.selected.should == 'hotdog'
+    meals_to_go.selected_value.should == 'hotdog'
+    meals_to_go.selected_values.should == ['hotdog']
+    meals_to_go.selected.should_not == 'tofu'
+  end
+  
+  it 'set selects radio by value in a group. selected returns value' do
+    meals_to_go.set 'hotdog'
+    meals_to_go.selected.should == 'hotdog'
+    meals_to_go.selected.should_not == 'tofu'
+
+    meals_to_go.set 'tofu'
+    meals_to_go.selected_value.should == 'tofu'
+    meals_to_go.selected.should_not == 'hotdog'
+  end
+  
+  it 'set position throws exception if number not within the range of group size' do
+    lambda{ meals_to_go.set 7 }.should raise_error(Watir::Exception::WatirException)
+  end
+  
+  it 'set value throws exception if value not found in options' do
+    lambda{ meals_to_go.set 'banannnanna' }.should raise_error(Watir::Exception::WatirException)
+  end
+  
+  # TODO do I want to provide mapping of human generated semantic values for radios 
+  # to actual values here in the radio_group or at the Watirllo level only? 
+  it 'set throws exception if sybmol is used. it should accept Fixnum or String element only' do
+    lambda{ meals_to_go.set :yes }.should raise_error(Watir::Exception::WatirException)
+  end
+
+end

data/spec/radio_groups_spec.rb

@@ -0,0 +1,55 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe 'RadioGroup class access in watir browser' do
+  include Watirloo::Page
+
+  before :each do
+    browser.goto testfile('radio_group.html')
+  end
+  
+  it 'browser responds to radio_group' do
+    browser.should respond_to(:radio_groups)
+  end
+  
+  it 'returns RadioGroups class' do
+    browser.radio_groups.should be_kind_of(Watir::RadioGroups)
+  end
+  
+  it 'lenght returns integer count of groups' do
+    browser.radio_groups.length.should == 2
+  end
+  
+  it 'each iterator returns RadioGroup' do
+    browser.radio_groups.each do |rg|
+      rg.class.should == Watir::RadioGroup #single
+    end
+  end
+  
+  it 'each accesses the group and returns name' do
+    names =[]
+    browser.radio_groups.each do |rg|
+      names << rg.name
+    end
+    names.should == ['food', 'fooda']
+  end
+  
+  it 'bracket access[] returns 1-based indexed group' do
+    browser.radio_groups[1].class.should == Watir::RadioGroup
+    browser.radio_groups[1].values.should == ["hotdog", "burger", "tofu"]
+    browser.radio_groups[2].name.should == 'fooda'
+  end
+  
+  it 'if radio group does not exists it returns size 0 or name nil (or should it blow up? or respond to exists? method' do
+    browser.radio_groups[6].size.should == 0 # does not exist. let's not blow up. suggestions?
+    browser.radio_groups[6].name.should == nil #suggestions?
+  end
+  
+  it 'groups contained by a form element' do
+    browser.forms[1].radio_groups.length.should == 1
+    names =[]
+    browser.forms[1].radio_groups.each do |rg|
+      names << rg.name
+    end 
+    names.should == ['food']
+  end
+end

data/spec/reflector_spec.rb

@@ -0,0 +1,82 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+
+#each collection can reflect the accessors and specs for its own members
+describe 'reflext :text_fields' do
+
+  include Watirloo::Page
+
+  before do
+    browser.goto testfile('person.html')
+  end
+  
+  it 'text_fields.reflect each :text_field' do
+    expected = ["face(:last_nm) {text_field(:name, \"last_nm\")}",
+      "last_nm.value.should == \"Begoodnuffski\"",
+      "face(:first_nm) {text_field(:name, \"first_nm\")}",
+      "first_nm.value.should == \"Joanney\"",
+      "face(:dob) {text_field(:name, \"dob\")}",
+      "dob.value.should == \"05/09/1964\"",
+      "face(:addr1) {text_field(:name, \"addr1\")}",
+      "addr1.value.should == \"1600 Transylavnia Ave.\""]
+
+    browser.text_fields.reflect.should == expected
+  end
+end
+
+
+
+describe 'reflect :radio_groups' do
+
+  include Watirloo::Page
+
+  before do
+    browser.goto testfile('radio_group.html')
+  end
+  
+  it 'reflects each radio group' do
+
+    expected = ["face(:food) {radio_group(\"food\")}",
+      "food.values.should == [\"hotdog\", \"burger\", \"tofu\"]",
+      "food.selected.should == \"burger\"",
+      "face(:fooda) {radio_group(\"fooda\")}",
+      "fooda.values.should == [\"hotdoga\", \"burgera\", \"tofua\", \"hotdoga_t\", \"burgera_t\", \"tofua_t\"]",
+      "fooda.selected.should == \"tofua\""]
+
+    # here the radio_group pics up the same named elemnets in two distinct form containers
+    # this would be a bug if container is browser
+    browser.radio_groups.reflect.should == expected
+
+  end
+end
+
+
+
+
+describe 'reflect :checkbox_groups' do
+
+  include Watirloo::Page
+
+  before do
+    browser.goto testfile('checkbox_group1.html')
+  end
+  
+  it 'reflects each checkbox_group' do
+
+    expected = ["face(:pets) {checkbox_group(\"pets\")}",
+      "pets.values.should == [\"cat\", \"dog\", \"zook\", \"zebra\", \"wumpa\"]",
+      "pets.selected.should == nil",
+      "face(:single_indicator) {checkbox_group(\"singleIndicator\")}",
+      "single_indicator.values.should == [\"on\"]",
+      "single_indicator.selected.should == nil",
+      "face(:petsa) {checkbox_group(\"petsa\")}",
+      "petsa.values.should == [\"cata\", \"doga\", \"zooka\", \"zebraa\", \"wumpaa\"]",
+      "petsa.selected.should == nil",
+      "face(:single_indicatora) {checkbox_group(\"singleIndicatora\")}",
+      "single_indicatora.values.should == [\"on\"]",
+      "single_indicatora.selected.should == nil"]
+        
+    browser.checkbox_groups.reflect.should == expected
+  end
+
+end

data/spec/select_list_options_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "SelectList options as visible items and values as hidden to the user attributes" do
+  
+  include Watirloo::Page
+
+  face(:pets) { select_list(:name, 'animals') }
+  face(:gender) { select_list(:name, 'sex_cd') }
+  face(:toys) { select_list(:name, 'bubel') }
+  
+  before :each do
+    browser.goto testfile('select_lists.html')
+  end
+  
+  it 'values of options by facename method' do
+    gender.values.should == ['', 'm', 'f']
+    pets.values.should == ['o1', 'o2', 'o3', 'o4', 'o5']
+  end
+  
+  it 'options with no value attribute' do
+    # in case of IE it will return all blanks
+    if browser.kind_of?(Watir::IE)
+      toys.values.should == ["", "", "", "", ""]
+    elsif browser.kind_of?(FireWatir::Firefox)
+      toys.values.should == ["", "foobel", "barbel", "bazbel", "chuchu"]
+      # for Firfox it returns actual items
+    end
+  end
+  
+  it 'items method returns visible contents as array of text items' do
+    toys.items.should == ["", "foobel", "barbel", "bazbel", "chuchu"]
+  end
+  
+  it 'items returns visible text items as array' do
+    pets.items.should == ['cat', 'dog', 'zook', 'zebra', 'wumpa']
+    gender.items.should == ["", "M", "F"]
+  end
+  
+  
+end

data/spec/select_lists_spec.rb

@@ -0,0 +1,151 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+
+# testing single select and multiselect controls
+describe "SelectList selections" do
+
+  include Watirloo::Page
+
+  face(:pets) {select_list(:name, 'animals')}
+  face(:gender) {select_list(:name, 'sex_cd')}
+
+
+  before do
+    browser.goto testfile('select_lists.html')
+  end
+
+  it 'selected returns preselected item in single select' do
+    gender.selected.should == '' # in single select "" is preselected
+    gender.selected_item.should == '' # in single select "" is preselected
+    gender.selected_items.should == ['']
+  end
+  
+  it 'selected returns preselected value in single select' do
+    gender.selected_value.should == '' # in single select "" is preselected
+    gender.selected_values.should == ['']
+  end
+
+  
+  it 'selected returns nil for none selected items in multi select' do
+    pets.selected.should == nil # in multiselect noting is selected
+    pets.selected_item.should == nil
+    pets.selected_items.should == [] # as array
+  end
+
+  it 'selected returns nil for none selected values in multi select' do
+    pets.selected_value.should == nil
+    pets.selected_values.should == [] # as array
+  end
+  
+  it 'set item text and find selected item and text for multiselect' do
+    pets.set 'dog'
+    pets.selected.should == 'dog' #multi select one item selected
+    pets.selected_item.should == 'dog' #multi select one item selected
+    pets.selected_items.should == ['dog']
+  end
+  
+  it 'set value and find selected item and value for multiselect' do
+    pets.set_value 'o2'
+    pets.selected.should == 'dog' #multi select one item selected
+    pets.selected_value.should == 'o2' #multi select one item selected
+    pets.selected_values.should == ['o2']
+  end
+
+  it 'set and query option by text for single select' do
+    gender.set 'F'
+    gender.selected.should == 'F' # single select one item
+    gender.selected_item.should == 'F' # single select one item
+    gender.selected_items.should == ['F'] # single select one item
+  end
+
+  it 'set and query option by value for single select' do
+    gender.set_value 'f'
+    gender.selected.should == 'F'
+    gender.selected_value.should == 'f' # single select one item
+    gender.selected_values.should == ['f'] # single select one item
+  end
+
+  
+  it 'set by text multple items for multiselect selects each item' do
+    pets.set ['cat', 'dog']
+    pets.selected.should == ['cat','dog']
+    pets.selected_item.should == ['cat','dog'] # bypass filter when more than one item
+    pets.selected_items.should == ['cat','dog']
+  end
+
+  it 'set by value multple items for multiselect selects each item' do
+    pets.set_value ['o1', 'o2']
+    pets.selected.should == ['cat','dog']
+    pets.selected_value.should == ['o1','o2'] # bypass filter when more than one item
+    pets.selected_value.should == ['o1','o2']
+  end
+
+  # this is not practical for single select but can be done for testing
+  # conditions arising from switching items in a batch approach
+  it 'set items array for single select selects each in turn. selected is the last item in array' do
+    gender.set ['M', 'F', '','F']
+    gender.selected.should == 'F'
+  end
+  
+  it 'set item after multiple items were set returns all values selected for multiselect' do
+    pets.set ['cat','zook']
+    pets.set 'zebra'
+    pets.selected.should == ['cat', 'zook', 'zebra']
+    pets.selected_values.should == ['o1', 'o3', 'o4']
+  end
+  
+  it 'set using position for multiselect' do
+    pets.set 3
+    pets.selected.should == 'zook'
+    pets.set_value 2 # translate to second text item
+    pets.selected.should == ['dog', 'zook']
+    pets.set [1,4,5]
+    pets.selected.should == ['cat','dog','zook', 'zebra','wumpa']
+  end
+  
+  it 'set using position and item for multiselect' do
+    pets.set [1,'zebra', 'zook', 2, 4] #select already selected
+    pets.selected.should == ['cat','dog','zook','zebra']
+  end
+  
+  it 'set using position for single select' do
+    gender.set 2
+    gender.selected.should == 'M'
+    gender.selected_value.should == 'm'
+  end
+  
+  it 'clear removes selected attribute for all selected items in multiselect' do
+    pets.selected.should == nil
+    pets.set ['zook', 'cat']
+    pets.selected.should == ['cat','zook']
+    pets.clear
+    pets.selected.should == nil
+  end
+
+  it 'clear removes selected attribute for item in single select list' do
+    gender.selected.should == ''
+    gender.set 'F'
+    gender.selected.should == 'F'
+
+    # This fails on IE in single select list.
+    # The test passes in Firefox
+    # option item select = false does not set false like it does in multiselect
+    gender.clear
+    gender.selected.should_not == 'F'
+  end
+  
+  it 'set_value selects value atribute text' do
+    gender.set_value 'm'
+    gender.selected.should == 'M'
+    gender.selected_value.should == 'm' #when you know there is only one item expected
+    gender.selected_values.should == ['m'] # array of items
+  end
+  
+  it 'set_value for multiselect returns selected and selected_values' do
+    pets.set_value 'o2'
+    pets.set_value 'o4'
+    pets.selected.should == ['dog', 'zebra']
+    pets.selected_value.should == ['o2', 'o4'] # if array then bypass filter
+    pets.selected_values.should == ['o2', 'o4'] # plural
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'watirloo'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+
+end
+
+module WatirlooSpecHelper
+  def testfile(filename)
+    path = File.expand_path(File.dirname(__FILE__))
+    uri = "file://#{path}/html/" + filename
+    return uri
+  end
+end
+
+include WatirlooSpecHelper
+