celerity 0.0.1

data/spec/select_lists_spec.rb

@@ -0,0 +1,47 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "SelectLists" do
+  before :all do
+    @ie = Celerity::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 correct number of select lists on the page" do
+      @ie.select_lists.length.should == 4
+    end
+  end
+  
+  describe "#[]" do
+    it "should return the correct item" do
+      @ie.select_lists[1].value.should == "Norway"
+      @ie.select_lists[1].name.should == "new_user_country"
+      @ie.select_lists[1].type.should == "select-one"
+      @ie.select_lists[2].type.should == "select-multiple"
+    end
+  end
+  
+  describe "#each" do
+    it "should iterate through the select lists correctly" do
+      index=1
+      @ie.select_lists.each do |l|
+        @ie.select_list(:index, index).name.should == l.name 
+        @ie.select_list(:index, index).id.should ==  l.id 
+        @ie.select_list(:index, index).type.should == l.type 
+        @ie.select_list(:index, index).value.should == l.value 
+        index += 1
+      end
+      (index - 1).should == @ie.select_lists.length
+    end
+  end
+  
+  after :all do
+    @ie.close
+  end
+
+end
+

data/spec/span_spec.rb

@@ -0,0 +1,156 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Span" do
+  
+  before :all do
+    @ie = IE.new
+    add_spec_checker(@ie)    
+  end
+  
+  before :each do
+    @ie.goto(TEST_HOST + "/non_control_elements.html")
+  end
+
+  # Exists method
+  describe "#exist?" do
+    it "should return true if the 'p' exists" do
+      @ie.span(:id, "lead").should exist
+      @ie.span(:id, /lead/).should exist
+      @ie.span(:text, "Dubito, ergo cogito, ergo sum.").should exist
+      @ie.span(:text, /Dubito, ergo cogito, ergo sum/).should exist
+      @ie.span(:class, "lead").should exist
+      @ie.span(:class, /lead/).should exist
+      @ie.span(:index, 1).should exist
+      @ie.span(:xpath, "//span[@id='lead']").should exist
+    end
+    it "should return false if the 'p' doesn't exist" do
+      @ie.span(:id, "no_such_id").should_not exist
+      @ie.span(:id, /no_such_id/).should_not exist
+      @ie.span(:text, "no_such_text").should_not exist
+      @ie.span(:text, /no_such_text/).should_not exist
+      @ie.span(:class, "no_such_class").should_not exist
+      @ie.span(:class, /no_such_class/).should_not exist
+      @ie.span(:index, 1337).should_not exist
+      @ie.span(:xpath, "//span[@id='no_such_id']").should_not exist
+    end
+    it "should raise ArgumentError when what argument is invalid" do
+      lambda { @ie.span(:id, 3.14).exists? }.should raise_error(ArgumentError)
+    end
+    it "should raise MissingWayOfFindingObjectException when how argument is invalid" do
+      lambda { @ie.span(:no_such_how, 'some_value').exists? }.should raise_error(MissingWayOfFindingObjectException)
+    end
+  end
+  
+  # Attribute methods
+  describe "#class_name" do
+    it "should return the class attribute" do
+      @ie.span(:index, 1).class_name.should == 'lead'
+    end
+    it "should return an empty string if the element exists and the attribute doesn't" do
+      @ie.span(:index, 3).class_name.should == ''
+    end
+    it "should raise UnknownObjectException if the span doesn't exist" do
+      lambda { @ie.span(:id, 'no_such_id').class_name }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  describe "#id" do
+    it "should return the id attribute" do
+      @ie.span(:index, 1).id.should == "lead"
+    end
+    it "should return an empty string if the element exists and the attribute doesn't" do
+      @ie.span(:index, 3).id.should == ''
+    end
+    it "should raise UnknownObjectException if the span doesn't exist" do
+      lambda { @ie.span(:id, "no_such_id").id }.should raise_error(UnknownObjectException)
+      lambda { @ie.span(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  describe "#name" do
+    it "should return the name attribute" do
+      @ie.span(:index, 2).name.should == "invalid_attribute"
+    end
+    it "should return an empty string if the element exists and the attribute doesn't" do
+      @ie.span(:index, 3).name.should == ''
+    end
+    it "should raise UnknownObjectException if the span doesn't exist" do
+      lambda { @ie.span(:id, "no_such_id").name }.should raise_error(UnknownObjectException)
+      lambda { @ie.span(:index, 1337).name }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  describe "#title" do
+    it "should return the title attribute" do
+      @ie.span(:index, 1).title.should == 'Lorem ipsum'
+    end
+    it "should return an empty string if the element exists and the attribute doesn't" do
+      @ie.span(:index, 3).title.should == ''
+    end
+    it "should raise UnknownObjectException if the p doesn't exist" do
+      lambda { @ie.span(:id, 'no_such_id').title }.should raise_error( UnknownObjectException)
+      lambda { @ie.span(:xpath, "//span[@id='no_such_id']").title }.should raise_error( UnknownObjectException)
+    end
+  end
+  
+  describe "#text" do
+    it "should return the text of the p" do
+      @ie.span(:index, 2).text.should == 'Sed pretium metus et quam. Nullam odio dolor, vestibulum non, tempor ut, vehicula sed, sapien. Vestibulum placerat ligula at quam. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.'
+    end
+    it "should return an empty string if the element doesn't contain any text" do
+      @ie.span(:index, 5).text.should == ''
+    end
+    it "should raise UnknownObjectException if the p doesn't exist" do
+      lambda { @ie.span(:id, 'no_such_id').text }.should raise_error( UnknownObjectException)
+      lambda { @ie.span(:xpath , "//span[@id='no_such_id']").text }.should raise_error( UnknownObjectException)
+    end
+  end
+  
+  describe "#value" do
+    it "should return the value attribute" do
+      @ie.span(:index, 2).value.should == "invalid_attribute"
+    end
+    it "should return an empty string if the element exists and the attribute doesn't" do
+      @ie.span(:index, 3).value.should == ''
+    end
+    it "should raise UnknownObjectException if the p doesn't exist" do
+      lambda { @ie.span(:id , "no_such_id").value }.should raise_error(UnknownObjectException)
+      lambda { @ie.span(:index , 1337).value }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  # Other
+  describe "#click" do
+    it "should fire events" do
+      @ie.span(:id, 'footer').text.include?('Javascript').should_not be_true
+      @ie.span(:id, 'footer').click
+      @ie.span(:id, 'footer').text.include?('Javascript').should be_true
+    end
+    it "should raise UnknownObjectException if the span doesn't exist" do
+      lambda { @ie.span(:id, "no_such_id").click }.should raise_error(UnknownObjectException)
+      lambda { @ie.span(:title, "no_such_title").click }.should raise_error(UnknownObjectException)
+    end
+  end
+  
+  describe "#to_s" do
+    it "should return a human readable representation of the element" do
+      @ie.span(:index, 2).to_s.should == "tag:          span\n" + 
+                                      "  name:         invalid_attribute\n" +
+                                      "  value:        invalid_attribute\n" +
+                                      "  text:         Sed pretium metus et quam. Nullam odio dolor, vestibulum non, tempor ut, vehicula sed, sapien. Vestibulum placerat ligula at quam. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas."
+    end
+    it "should raise UnknownObjectException if the p doesn't exist" do
+      lambda { @ie.span(:xpath, "//span[@id='no_such_id']").to_s }.should raise_error( UnknownObjectException)
+    end
+  end
+
+
+  
+ 
+  
+  after :all do
+    @ie.close
+  end
+
+end
+

data/spec/spans_spec.rb

@@ -0,0 +1,65 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Spans" do
+  before :all do
+    @ie = IE.new
+    add_spec_checker(@ie)    
+  end
+
+  before :each do
+    @ie.goto(TEST_HOST + "/non_control_elements.html")
+  end
+
+
+  describe "#length" do
+    it "should return the number of spans" do
+      @ie.spans.length.should == 6
+    end
+  end
+  
+  describe "#[]" do
+    it "should return the p at the given index" do
+      @ie.spans[1].id.should == "lead"
+    end
+  end
+
+  describe "#each" do
+    it "should iterate through spans correctly" do
+      @ie.spans.each_with_index do |s, index|
+        s.name.should == @ie.span(:index, index+1).name
+        s.id.should == @ie.span(:index, index+1).id
+        s.value.should == @ie.span(:index, index+1).value
+      end
+    end
+  end
+  
+  describe "#to_s" do
+    it "should return a human readable representation of the collection" do
+      @ie.spans.to_s.should == "tag:          span\n" +
+                              "  id:           lead\n" +
+                              "  class:        lead\n" +
+                              "  title:        Lorem ipsum\n" +
+                              "  text:         Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Curabitur eu pede. Ut justo. Praesent feugiat, elit in feugiat iaculis, sem risus rutrum justo, eget fermentum dolor arcu non nunc.\n" +
+                              "tag:          span\n" + 
+                              "  name:         invalid_attribute\n" +
+                              "  value:        invalid_attribute\n" +
+                              "  text:         Sed pretium metus et quam. Nullam odio dolor, vestibulum non, tempor ut, vehicula sed, sapien. Vestibulum placerat ligula at quam. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.\n" + 
+                              "tag:          span\n" +
+                              "  text:         Suspendisse at ipsum a turpis viverra venenatis. Praesent ut nibh. Nullam eu odio. Donec tempor, elit ut lacinia porttitor, augue neque vehicula diam, in elementum ligula nisi a tellus. Aliquam vestibulum ultricies tortor. \n" + 
+                              "tag:          span\n" + 
+                              "  text:         Dubito, ergo cogito, ergo sum.\n" + 
+                              "tag:          span\n" + 
+                              "tag:          span\n" + 
+                              "  class:        footer\n" + 
+                              "  name:         footer\n" + 
+                              "  onclick:      this.innerHTML = 'This is a footer with text set by Javascript.'\n" + 
+                              "  text:         This is a footer."
+    end
+  end
+  
+  after :all do
+    @ie.close
+  end
+
+end
+

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour --format html

data/spec/spec_helper.rb

@@ -0,0 +1,90 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  gem 'rspec'
+  require 'spec'
+end
+
+# require "profile"
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+
+if RUBY_PLATFORM =~ /java/
+  require 'celerity'
+  include Celerity
+  include Celerity::Exception  
+elsif ENV['WATIR_SPEC']
+  require 'watir'
+  include Watir
+  include Watir::Exception  
+end
+
+# ============
+# = Debugger =
+# ============
+
+if ENV['DEBUGGER']
+  require "ruby-debug"
+  Debugger.start
+  Debugger.settings[:autoeval] = true
+  Debugger.settings[:autolist] = 1
+end
+
+# ===========
+# = WEBrick =
+# ===========
+
+if RUBY_PLATFORM =~ /java/ || ENV['WATIR_SPEC']
+  unless defined? WEBRICK_SERVER
+    require 'webrick'
+    doc_root = File.join(File.dirname(__FILE__), "html")
+    log_file = File.join(File.dirname(__FILE__), "..", "log", "webrick_log.txt")
+    server_port = 2000
+    tries = 0
+    begin
+      TEST_HOST = "http://localhost:#{server_port}"
+      server = WEBrick::HTTPServer.new(:Port => server_port,
+                                       :DocumentRoot => doc_root,
+                                       :Logger => WEBrick::Log.new(log_file, WEBrick::BasicLog::WARN),
+                                       :AccessLog => [])
+    rescue Errno::EADDRINUSE => e
+      server_port += 5
+      if tries < 3
+        tries += 1
+        retry 
+      else
+        raise e
+      end
+    end
+    
+    server.mount("/", WEBrick::HTTPServlet::FileHandler, doc_root, {:FancyIndexing=>true})
+    WEBRICK_SERVER = Thread.new { server.start }
+  end
+else
+  puts "Remember to run \"rake testserver\" before running these tests!"
+end
+
+# ===========================
+# = RubyCocoa CelerityViewer =
+# ===========================
+begin
+  if `uname`.chomp == "Darwin" && `ps ax`[/CelerityViewer/]
+    WEB_VIEWER = DRbObject.new_with_uri("druby://127.0.0.1:1337")
+  end
+rescue IOError
+end
+
+# ================
+# = Spec Checker =
+# ================
+
+# define a checker that is run on every page
+def add_spec_checker(ie)
+  if defined? WEB_VIEWER
+    ie.add_checker { WEB_VIEWER.render_html(ie.object.asXml, ie.base_url) }
+  end
+end
+
+
+

data/spec/table_bodies.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "TableBody" do
+  
+  before :all do
+    @ie = IE.new
+    add_spec_checker(@ie)
+  end
+
+  before :each do
+    @ie = IE.new
+    @ie.goto(TEST_HOST + "/tables.html")
+  end
+  
+  describe "#length" do
+    it "should return the number of table bodies" do
+      @ie.table(:index, 1).bodies.length.should == 2
+      @ie.table(:index, 2).bodies.length.should == 0
+    end
+  end
+  
+  describe "#[]n" do
+    it "should return the nth table body" do
+      pending
+    end
+  end
+
+  describe "#each" do
+    it "should iterate through table bodies correctly" do
+      #@ie.table(:index, 1).bodies.each_with_index do |body, index|
+      #end
+      pending
+    end
+  end
+  
+  after :all do
+    @ie.close
+  end
+  
+end

data/spec/table_bodies_spec.rb

@@ -0,0 +1,42 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "TableBodies" do
+  
+  before :all do
+    @ie = IE.new
+    add_spec_checker(@ie)
+  end
+
+  before :each do
+    @ie = IE.new
+    @ie.goto(TEST_HOST + "/tables.html")
+  end
+  
+  describe "#length" do
+    it "should return the correct number of table bodies" do
+      @ie.table(:index, 1).bodies.length.should == 2
+    end
+  end
+  
+  describe "#[]" do
+    it "should return the row at the given index" do
+      @ie.table(:index, 1).bodies[1].id.should == "first"
+      @ie.table(:index, 1).bodies[2].name.should == "second"
+    end
+  end
+  
+  describe "#each" do
+      it "should iterate through table bodies correctly" do
+        table = @ie.table(:index, 1)
+        table.bodies.each_with_index do |body, index|
+          body.name.should == table.body(:index, index+1).name
+          body.id.should == table.body(:index, index+1).id
+        end
+      end      
+    end
+  
+  after :all do
+    @ie.close
+  end
+  
+end