celerity 0.0.1

data/spec/area_spec.rb

@@ -0,0 +1,79 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "P" do
+  
+  before :all do
+    @ie = IE.new
+    add_spec_checker(@ie)    
+  end
+
+  before :each do
+    @ie.goto(TEST_HOST + "/images.html")
+  end
+
+  # Exists method
+  describe "#exist?" do
+    it "should return true if the 'area' exists" do
+      @ie.area(:id, "NCE").should exist
+      @ie.area(:id, /NCE/).should exist
+      @ie.area(:name, "NCE").should exist
+      @ie.area(:name, /NCE/).should exist
+      @ie.area(:title, "Tables").should exist
+      @ie.area(:title, /Tables/).should exist
+      @ie.area(:url, "tables.html").should exist
+      @ie.area(:url, /tables/).should exist
+      @ie.area(:index, 1).should exist
+      @ie.area(:xpath, "//area[@id='NCE']").should exist
+    end
+    it "should return false if the 'area' doesn't exist" do
+      @ie.area(:id, "no_such_id").should_not exist
+      @ie.area(:id, /no_such_id/).should_not exist
+      @ie.area(:name, "no_such_id").should_not exist
+      @ie.area(:name, /no_such_id/).should_not exist
+      @ie.area(:title, "no_such_title").should_not exist
+      @ie.area(:title, /no_such_title/).should_not exist
+      @ie.area(:url, "no_such_href").should_not exist
+      @ie.area(:url, /no_such_href/).should_not exist
+      @ie.area(:index, 1337).should_not exist
+      @ie.area(:xpath, "//area[@id='no_such_id']").should_not exist
+    end
+    it "should raise ArgumentError when what argument is invalid" do
+      lambda { @ie.area(:id, 3.14).exists? }.should raise_error(ArgumentError)
+    end
+    it "should raise MissingWayOfFindingObjectException when how argument is invalid" do
+      lambda { @ie.area(:no_such_how, 'some_value').exists? }.should raise_error(MissingWayOfFindingObjectException)
+    end
+  end
+  
+  # Attribute methods
+  describe "#id" do
+    it "should return the id attribute" do
+      @ie.area(:index, 1).id.should == "NCE"
+    end
+    it "should return an empty string if the element exists and the attribute doesn't" do
+      @ie.area(:index, 3).id.should == ''
+    end
+    it "should raise UnknownObjectException if the p doesn't exist" do
+      lambda { @ie.area(:id, "no_such_id").id }.should raise_error(UnknownObjectException)
+      lambda { @ie.area(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  describe "#name" do
+    it "should return the name attribute" do
+      @ie.area(:index, 1).name.should == "NCE"
+    end
+    it "should return an empty string if the element exists and the attribute doesn't" do
+      @ie.area(:index, 3).name.should == ''
+    end
+    it "should raise UnknownObjectException if the p doesn't exist" do
+      lambda { @ie.area(:id, "no_such_id").name }.should raise_error(UnknownObjectException)
+      lambda { @ie.area(:index, 1337).name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  after :all do
+    @ie.close
+  end
+
+end

data/spec/areas_spec.rb

@@ -0,0 +1,41 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Areas" do
+  
+  before :all do
+    @ie = IE.new
+    add_spec_checker(@ie)    
+  end
+
+  before :each do
+    @ie.goto(TEST_HOST + "/images.html")
+  end
+
+  describe "#length" do
+    it "should return the number of areas" do
+      @ie.areas.length.should == 3
+    end
+  end
+  
+  describe "#[]" do
+    it "should return the p at the given index" do
+      @ie.areas[1].id.should == "NCE"
+    end
+  end
+
+  describe "#each" do
+    it "should iterate through areas correctly" do
+      @ie.areas.each_with_index do |a, index|
+        a.name.should == @ie.area(:index, index+1).name
+        a.id.should == @ie.area(:index, index+1).id
+        a.value.should == @ie.area(:index, index+1).value
+      end
+    end
+  end
+  
+  after :all do
+    @ie.close
+  end
+
+end
+

data/spec/button_spec.rb

@@ -0,0 +1,171 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Button" do
+
+  before :all do
+    @ie = IE.new
+    add_spec_checker(@ie)
+  end
+
+  before :each do
+    @ie.goto(TEST_HOST + "/forms_with_input_elements.html")
+  end
+  
+  # Exists method
+  describe "#exists?" do
+    it "should return true if the button exists" do
+      @ie.button(:id, "new_user_submit").should exist
+      @ie.button(:id, /new_user_submit/).should exist
+      @ie.button(:name, "new_user_reset").should exist
+      @ie.button(:name, /new_user_reset/).should exist
+      # we need to figure out what :text and :value/:caption means on input type="button" and <button /> elements
+      @ie.button(:value, "Button 2").should exist
+      @ie.button(:value, /Button 2/).should exist
+      @ie.button(:text, "Button 2").should exist
+      @ie.button(:text, /Button 2/).should exist
+      @ie.button(:class, "image").should exist
+      @ie.button(:class, /image/).should exist
+      @ie.button(:index, 1).should exist
+      @ie.button(:xpath, "//input[@id='new_user_submit']").should exist
+    end
+    it "should return true if the button exists (how = :caption)" do
+      # we need to figure out what :text and :value/:caption means on input type="button" and <button /> elements
+      @ie.button(:caption, "Button 2").should exist
+      @ie.button(:caption, /Button 2/).should exist
+    end
+    it "should return true if the button exists (default how = :value)" do
+      @ie.button("Submit").should exist
+    end
+    it "should return false if the button doesn't exist" do
+      @ie.button(:id, "no_such_id").should_not exist
+      @ie.button(:id, /no_such_id/).should_not exist
+      @ie.button(:name, "no_such_name").should_not exist
+      @ie.button(:name, /no_such_name/).should_not exist
+      # we need to figure out what :text and :value/:caption means on input type="button" and <button /> elements
+      @ie.button(:value, "no_such_value").should_not exist
+      @ie.button(:value, /no_such_value/).should_not exist
+      @ie.button(:text, "no_such_text").should_not exist
+      @ie.button(:text, /no_such_text/).should_not exist
+      @ie.button(:class, "no_such_class").should_not exist
+      @ie.button(:class, /no_such_class/).should_not exist
+      @ie.button(:index, 1337).should_not exist
+      @ie.button(:xpath, "//input[@id='no_such_id']").should_not exist
+    end
+    it "should raise ArgumentError when what argument is invalid" do
+      lambda { @ie.button(:id, 3.14).exists? }.should raise_error(ArgumentError)
+    end
+    it "should raise MissingWayOfFindingObjectException when how argument is invalid" do
+      lambda { @ie.button(:no_such_how, 'some_value').exists? }.should raise_error(MissingWayOfFindingObjectException)
+    end
+  end
+  
+  # Attribute methods
+  describe "#class_name" do
+    it "should return the class name of the button" do
+      @ie.button(:name, "new_user_image").class_name.should == "image"
+    end
+    it "should return an empty string if the button has no class name" do
+      @ie.button(:name, "new_user_submit").class_name.should == ""
+    end
+  end
+  
+  describe "#id" do
+    it "should return the id if the button exists" do
+      @ie.button(:index, 1).id.should == 'new_user_submit'
+      @ie.button(:index, 2).id.should == 'new_user_reset'
+      @ie.button(:index, 3).id.should == 'new_user_button'
+    end
+    it "should raise UnknownObjectException if button does not exist" do
+      lambda { @ie.button(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#name" do
+    it "should return the name if button exists" do
+      @ie.button(:index, 1).name.should == 'new_user_submit'
+      @ie.button(:index, 2).name.should == 'new_user_reset'
+      @ie.button(:index, 3).name.should == 'new_user_button'
+    end
+    it "should raise UnknownObjectException if button does not exist" do
+      lambda { @ie.button(:name, "no_such_name").name }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  describe "#title" do
+    it "should return the title of the button" do
+      @ie.button(:index, 1).title.should == 'Submit the form'
+    end
+    it "should return an empty string for button without title" do
+      @ie.button(:index, 2).title.should == ''
+    end
+  end
+
+  describe "#type" do
+    it "should return the type if button exists" do
+      @ie.button(:index, 1).type.should == 'submit'
+      @ie.button(:index, 2).type.should == 'reset'
+      @ie.button(:index, 3).type.should == 'button'
+    end
+    it "should raise UnknownObjectException if button does not exist" do
+      lambda { @ie.button(:name, "no_such_name").type }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#value" do
+    it "should return the value if button exists" do
+      @ie.button(:index, 1).value.should == 'Submit'
+      @ie.button(:index, 2).value.should == 'Reset'
+      @ie.button(:index, 3).value.should == 'Button'
+    end
+    it "should raise UnknownObjectException if button does not exist" do
+      lambda { @ie.button(:name, "no_such_name").value }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  # Access methods
+  describe "#enabled?" do
+    it "should return true if the button is enabled" do
+      @ie.button(:name, 'new_user_submit').should be_enabled
+    end
+    it "should return false if the button is disabled" do
+      @ie.button(:name, 'new_user_submit_disabled').should_not be_enabled
+    end
+    it "should raise UnknownObjectException if the button doesn't exist" do
+      lambda { @ie.button(:name, "no_such_name").enabled? }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#disabled?" do
+    it "should return false when button is enabled" do
+      @ie.button(:name, 'new_user_submit').should_not be_disabled
+    end
+    it "should return true when button is disabled" do
+      @ie.button(:name, 'new_user_submit_disabled').should be_disabled
+    end
+    it "should raise UnknownObjectException if button does not exist" do
+      lambda { @ie.button(:name, "no_such_name").disabled? }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  # Manipulation methods
+  describe "#click" do
+    it "should click the button if it exists" do
+      pending
+    end
+    it "should fire events" do
+      @ie.button(:id, 'new_user_button').click
+      @ie.button(:id, 'new_user_button').value.should == 'new_value_set_by_onclick_event'
+    end
+    it "should raise UnknownObjectException when clicking a button that doesn't exist" do
+      lambda { @ie.button(:value, "no_such_value").click }.should raise_error(UnknownObjectException)
+      lambda { @ie.button(:id, "no_such_id").click }.should raise_error(UnknownObjectException)
+    end
+    it "should raise ObjectDisabledException when clicking a disabled button" do
+      lambda { @ie.button(:value, "Disabled").click }.should raise_error(ObjectDisabledException)
+    end
+  end
+
+  after :all do
+    @ie.close
+  end
+end

data/spec/buttons_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Buttons" do
+  
+  before :all do
+    @ie = IE.new
+    add_spec_checker(@ie)    
+  end
+
+  before :each do
+    @ie.goto(TEST_HOST + "/forms_with_input_elements.html")
+  end
+
+  describe "#length" do
+    it "should return the number of buttons" do
+      @ie.buttons.length.should == 7
+    end
+  end
+  
+  describe "#[]" do
+    it "should return the button at the given index" do
+      @ie.buttons[1].title.should == "Submit the form"
+    end
+  end
+
+  describe "#each" do
+    it "should iterate through buttons correctly" do
+      @ie.buttons.each_with_index do |b, index|
+        b.name.should == @ie.button(:index, index+1).name
+        b.id.should == @ie.button(:index, index+1).id
+        b.value.should == @ie.button(:index, index+1).value
+      end
+    end
+  end
+  
+  after :all do
+    @ie.close
+  end
+
+end

data/spec/checkbox_spec.rb

@@ -0,0 +1,259 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Checkbox" do
+  
+  before :all do
+    @ie = IE.new
+    add_spec_checker(@ie)    
+  end
+
+  before :each do
+    @ie.goto(TEST_HOST + "/forms_with_input_elements.html")
+  end
+  
+  
+  # Exists method
+  
+  describe "#exists?" do
+    it "should return true if the checkbox button exists" do
+      @ie.checkbox(:id, "new_user_interests_books").should exist
+      @ie.checkbox(:id, /new_user_interests_books/).should exist
+      @ie.checkbox(:name, "new_user_interests").should exist
+      @ie.checkbox(:name, /new_user_interests/).should exist
+      @ie.checkbox(:value, "books").should exist
+      @ie.checkbox(:value, /books/).should exist
+      # unsure what :text is supposed to represent here
+      # @ie.checkbox(:text, "books").should exist
+      # @ie.checkbox(:text, /books/).should exist
+      @ie.checkbox(:class, "fun").should exist
+      @ie.checkbox(:class, /fun/).should exist
+      @ie.checkbox(:index, 1).should exist
+      @ie.checkbox(:xpath, "//input[@id='new_user_interests_books']").should exist
+    end
+    
+    it "should return true if the checkbox button exists (search by name and value)" do
+      @ie.checkbox(:name, "new_user_interests", 'cars').should exist
+      @ie.checkbox(:xpath, "//input[@name='new_user_interests' and @value='cars']").set
+    end
+    
+    it "should return false if the checkbox button does not exist" do
+      @ie.checkbox(:id, "no_such_id").should_not exist
+      @ie.checkbox(:id, /no_such_id/).should_not exist
+      @ie.checkbox(:name, "no_such_name").should_not exist
+      @ie.checkbox(:name, /no_such_name/).should_not exist
+      @ie.checkbox(:value, "no_such_value").should_not exist
+      @ie.checkbox(:value, /no_such_value/).should_not exist
+      @ie.checkbox(:text, "no_such_text").should_not exist
+      @ie.checkbox(:text, /no_such_text/).should_not exist
+      @ie.checkbox(:class, "no_such_class").should_not exist
+      @ie.checkbox(:class, /no_such_class/).should_not exist
+      @ie.checkbox(:index, 1337).should_not exist
+      @ie.checkbox(:xpath, "//input[@id='no_such_id']").should_not exist
+    end
+    
+    it "should return false if the checkbox button does not exist (search by name and value)" do
+      @ie.checkbox(:name, "new_user_interests", 'no_such_value').should_not exist
+      @ie.checkbox(:xpath, "//input[@name='new_user_interests' and @value='no_such_value']").should_not exist
+      @ie.checkbox(:name, "no_such_name", 'cars').should_not exist
+      @ie.checkbox(:xpath, "//input[@name='no_such_name' and @value='cars']").should_not exist
+    end
+    
+    it "should return true for checkboxs with a string value" do
+      @ie.checkbox(:name, 'new_user_interests', 'books').should exist
+      @ie.checkbox(:name, 'new_user_interests', 'cars').should exist
+    end
+    
+    it "should raise ArgumentError when what argument is invalid" do
+      lambda { @ie.checkbox(:id, 3.14).exists? }.should raise_error(ArgumentError)
+    end
+
+    it "should raise MissingWayOfFindingObjectException when how argument is invalid" do
+      lambda { @ie.checkbox(:no_such_how, 'some_value').exists? }.should raise_error(MissingWayOfFindingObjectException)
+    end
+  end
+  
+  
+  # Attribute methods
+  
+  describe "#class_name" do
+    it "should return the class name if the checkbox exists and has an attribute" do
+      @ie.checkbox(:id, "new_user_interests_dancing").class_name.should == "fun"
+    end
+    it "should return an emptry string if the checkbox exists and the attribute doesn't" do
+      @ie.checkbox(:id, "new_user_interests_books").class_name.should == ""
+    end
+    it "should raise UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @ie.checkbox(:id, "no_such_id").class_name }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  describe "#id" do
+    it "should return the id attribute if the checkbox exists and has an attribute" do
+      @ie.checkbox(:index, 1).id.should == "new_user_interests_books"
+    end
+    it "should return an emptry string if the checkbox exists and the attribute doesn't" do
+      @ie.checkbox(:index, 2).id.should == ""
+    end
+    it "should raise UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @ie.checkbox(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#name" do
+    it "should return the name attribute if the checkbox exists" do
+      @ie.checkbox(:id, 'new_user_interests_books').name.should == "new_user_interests"
+    end
+    it "should return an empty string if the checkbox exists and the attribute doesn't" do
+      @ie.checkbox(:id, 'new_user_interests_food').name.should == ""
+    end
+    it "should raise UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @ie.checkbox(:index, 1337).name }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  describe "#title" do
+    it "should return the title attribute if the checkbox exists" do
+      @ie.checkbox(:id, "new_user_interests_dancing").title.should == "Dancing is fun!"
+    end
+    it "should return an emptry string if the checkbox exists and the attribute doesn't" do
+      @ie.checkbox(:id, "new_user_interests_books").title.should == ""
+    end
+    it "should raise UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @ie.checkbox(:index, 1337).title }.should raise_error(UnknownObjectException)  
+    end
+  end
+
+  describe "#type" do
+    it "should return the type attribute if the checkbox exists" do
+      @ie.checkbox(:index, 1).type.should == "checkbox"
+    end
+    it "should raise UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @ie.checkbox(:index, 1337).type }.should raise_error(UnknownObjectException)  
+    end
+  end
+  
+  describe "#value" do
+    it "should return the value attribute if the checkbox exists" do
+      @ie.checkbox(:id, 'new_user_interests_books').value.should == 'books'
+    end
+    it "should raise UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @ie.checkbox(:index, 1337).value}.should raise_error(UnknownObjectException)  
+    end
+  end
+  
+  
+  # Access methods
+  
+  describe "#enabled?" do
+    it "should return true if the checkbox button is enabled" do
+      @ie.checkbox(:id, "new_user_interests_books").should be_enabled
+      @ie.checkbox(:xpath, "//input[@id='new_user_interests_books']").should be_enabled
+    end
+    it "should return false if the checkbox button is disabled" do
+      @ie.checkbox(:id, "new_user_interests_dentistry").should_not be_enabled
+      @ie.checkbox(:xpath,"//input[@id='new_user_interests_dentistry']").should_not be_enabled
+    end
+    it "should raise UnknownObjectException if the checkbox button doesn't exist" do
+      lambda { @ie.checkbox(:id, "no_such_id").enabled?  }.should raise_error(UnknownObjectException)  
+      lambda { @ie.checkbox(:xpath, "//input[@id='no_such_id']").enabled?  }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  describe "#disabled?" do
+    it "should return true if the checkbox is disabled" do
+      @ie.checkbox(:id, 'new_user_interests_dentistry').should be_disabled
+    end
+    it "should return false if the checkbox is enabled" do
+      @ie.checkbox(:id, 'new_user_interests_books').should_not be_disabled
+    end
+    it "should raise UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @ie.checkbox(:index, 1337).disabled? }.should raise_error(UnknownObjectException)  
+    end
+  end
+  
+  
+  # Manipulation methods
+  
+  describe "#clear" do
+    it "should raise ObjectDisabledException if the checkbox is disabled" do
+      @ie.checkbox(:id, "new_user_interests_dentistry").should_not be_set
+      lambda { @ie.checkbox(:id, "new_user_interests_dentistry").clear }.should raise_error(ObjectDisabledException)
+      lambda { @ie.checkbox(:xpath, "//input[@id='new_user_interests_dentistry']").clear }.should raise_error(ObjectDisabledException)
+    end
+    it "should clear the checkbox button if it is set" do
+      @ie.checkbox(:id, "new_user_interests_books").clear
+      @ie.checkbox(:id, "new_user_interests_books").should_not be_set
+    end
+    it "should clear the checkbox button when found by :xpath" do
+      @ie.checkbox(:xpath, "//input[@id='new_user_interests_books']").clear
+      @ie.checkbox(:xpath, "//input[@id='new_user_interests_books']").should_not be_set
+    end
+    it "should raise UnknownObjectException if the checkbox button doesn't exist" do
+      lambda { @ie.checkbox(:name, "no_such_id").clear }.should raise_error(UnknownObjectException)
+      lambda { @ie.checkbox(:xpath, "//input[@id='no_such_id']").clear  }.should raise_error(UnknownObjectException)  
+    end
+  end
+  
+  describe "#set" do
+    it "should set the checkbox button" do
+      @ie.checkbox(:id, "new_user_interests_cars").set
+      @ie.checkbox(:id, "new_user_interests_cars").should be_set
+    end
+    it "should set the checkbox button when found by :xpath" do
+      @ie.checkbox(:xpath, "//input[@id='new_user_interests_cars']").set
+      @ie.checkbox(:xpath, "//input[@id='new_user_interests_cars']").should be_set
+    end
+
+    it "should fire the onclick event"
+
+    it "should raise UnknownObjectException if the checkbox button doesn't exist" do
+      lambda { @ie.checkbox(:name, "no_such_name").set  }.should raise_error(UnknownObjectException)
+      lambda { @ie.checkbox(:xpath, "//input[@name='no_such_name']").set  }.should raise_error(UnknownObjectException)
+    end
+    it "should raise ObjectDisabledException if the checkbox is disabled" do
+      lambda { @ie.checkbox(:id, "new_user_interests_dentistry").set  }.should raise_error(ObjectDisabledException)
+      lambda { @ie.checkbox(:xpath, "//input[@id='new_user_interests_dentistry']").set  }.should raise_error(ObjectDisabledException )
+    end
+  end
+  
+  
+  # Other
+  
+  describe '#set?' do
+    it "should return true if the checkbox button is set" do
+      @ie.checkbox(:id, "new_user_interests_books").should be_set
+    end
+    it "should return false if the checkbox button unset" do
+      @ie.checkbox(:id, "new_user_interests_cars").should_not be_set
+    end
+    it "should return the state for checkboxs with string values" do
+      @ie.checkbox(:name, "new_user_interests", 'cars').should_not be_set
+      @ie.checkbox(:name, "new_user_interests", 'cars').set
+      @ie.checkbox(:name, "new_user_interests", 'cars').should be_set
+      @ie.checkbox(:name, "new_user_interests", 'cars').clear
+      @ie.checkbox(:name, "new_user_interests", 'cars').should_not be_set
+    end
+    it "should raise UnknownObjectException if the checkbox button doesn't exist" do
+      lambda { @ie.checkbox(:id, "no_such_id").set?  }.should raise_error(UnknownObjectException)  
+      lambda { @ie.checkbox(:xpath, "//input[@id='no_such_id']").set?  }.should raise_error(UnknownObjectException)
+    end    
+  end
+  
+  describe "#get_state" do
+    it "should return true if the checkbox is set" do
+      @ie.checkbox(:id, "new_user_interests_books").get_state.should be_true
+    end
+    it "should return false if the checkbox is unset" do
+      @ie.checkbox(:id, "new_user_interests_cars").get_state.should be_false
+    end
+    it "should raise UnknownObjectException if the checkbox doesn't exist" do
+      lambda {   @ie.checkbox(:name, "no_such_name").get_state  }.should raise_error(UnknownObjectException)
+      lambda {   @ie.checkbox(:xpath, "//input[@name='no_such_name']").get_state  }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  after :all do
+    @ie.close
+  end
+end
+