rwebunit 0.9.4 → 1.0.3

data/lib/rwebunit/itest_plugin.rb

@@ -0,0 +1,47 @@
+require 'socket'
+
+module RWebUnit
+  module ITestPlugin
+
+    def connect_to_itest(message_type, body)
+      begin
+        the_message = message_type + "|" + body
+        if @last_message == the_message then
+          return
+        end
+        itest_port = $ITEST2_TRACE_PORT || 7025
+        itest_socket = Socket.new(Socket::AF_INET,Socket::SOCK_STREAM,0)
+        itest_socket.connect(Socket.pack_sockaddr_in(itest_port, 'localhost'))
+        itest_socket.puts(the_message)
+        @last_message = the_message
+        itest_socket.close
+      rescue => e
+      end
+    end
+
+    def debug(message)
+      connect_to_itest(" DEBUG", message + "\r\n") if $RUN_IN_ITEST
+    end
+
+    # find out the line (and file) the execution is on, and notify iTest via Socket
+    def dump_caller_stack
+      return unless $ITEST2_TRACE_EXECUTION
+      begin
+        caller.each_with_index do |position, idx|
+          next unless position =~ /\A(.*?):(\d+)/
+          file = $1
+          # TODO: send multiple trace to be parse with pages.rb
+          # next if file =~ /example\/example_methods\.rb$/ or file =~ /example\/example_group_methods\.rb$/ or file =~ /driver\.rb$/ or file =~ /timeout\.rb$/ # don't include rspec or ruby trace
+
+          if file.include?("_spec.rb") || file.include?("_test.rb") || file.include?("_cmd.rb")
+            connect_to_itest(" TRACE", position)
+          end
+
+          break if idx > 4 or file =~ /"_spec\.rb$/
+        end
+      rescue => e
+        puts "failed to capture log: #{e}"
+      end
+    end
+  end
+end

data/lib/rwebunit/matchers/contains_text.rb

@@ -0,0 +1,37 @@
+class ContainsText
+
+  # this is what the matcher is called on.
+  # In this case:
+  #   foo.should contains(:bars)
+  # foo would be passed to the +initialize+
+  def initialize(expected)
+    @expected = expected
+  end
+
+  def matches?(actual)
+    @actual = actual
+    return actual && actual.include?(@expected)
+  end
+
+  def actual_text
+    @actual.to_s.length > 1000000 ? @actual[0, 1000] : @actual
+  end
+
+  # error message for should
+  def failure_message
+    "expected #{actual_text} not to contains #{@expected}, but it did't"
+  end
+
+  # error message for should_not
+  def negative_failure_message
+    "expected #{actual_text} not to contains #{@expected}, but it did"
+  end
+
+end
+
+
+# This method is the one you use with should/should_not
+def contains_text?(expected)
+  ContainsText.new(expected)
+end
+alias contains? contains_text?

data/lib/rwebunit/rspec_helper.rb

@@ -1,128 +1,140 @@
-require 'uri'
-
-# ZZ patches to RSpec 1.1.2
-#  - add to_s method to example_group
-module Spec
-  module Example
-    class ExampleGroup
-      def to_s
-        @_defined_description
-      end
-    end
-  end
-end
-
-# example
-#   should link_by_text(text, options).size > 0
-
-module RWebUnit
-  module RSpecHelper
-    include RWebUnit::Driver
-    include RWebUnit::Utils
-    include RWebUnit::Assert
-
-    def browser
-      @web_tester
-    end
-
-    # open a browser, and set base_url via hash, but does not acually
-    #
-    # example:
-    #   open_browser :base_url => http://localhost:8080
-    def open_browser(base_url = nil, options = {})
-      base_url ||= ENV['ITEST_PROJECT_BASE_URL']
-      raise "base_url must be set" if base_url.nil?
-      
-      default_options = {:speed => "fast",
-        :visible => true,
-        :highlight_colour => 'yellow',
-        :close_others => true,
-        :start_new => false, 	# start a new browser always
-        :go => true}
-
-      options = default_options.merge options
-      options[:firefox] = true if "Firefox" == ENV['ITEST_BROWSER']
-      (ENV['ITEST_HIDE_BROWSER'] == "true") ? $HIDE_IE = true : $HIDE_IE = false
-
-      uri = URI.parse(base_url)
-      uri_base = "#{uri.scheme}://#{uri.host}:#{uri.port}"
-      if options[:start_new] || @web_tester.nil?
-        @web_tester = WebTester.new(uri_base, options)
-      end
-
-      if options[:go]
-        (uri.path.length == 0) ?  begin_at("/") :  begin_at(uri.path)
-      end
-      return @web_tester
-    end
-    alias open_browser_with open_browser
-
-    # --
-    #  Content
-    # --
-    def page_title
-      @web_tester.page_title
-    end
-
-    def page_source
-      @web_tester.page_source
-    end
-
-    def table_source(table_id)
-      elem = @@browser.document.getElementById(table_id)
-      raise "The element '#{table_id}' is not a table or there are multple elements with same id" unless elem.name.uppercase == "TABLE"
-      elem.innerHTML
-    end
-    alias table_source_by_id table_source
-
-    def element_text(elem_id)
-      @web_tester.element_value(elem_id)
-    end
-    alias element_text_by_id element_text
-
-    #TODO: is it working?
-    def element_source(elem_id)
-      @web_tester.get_html_in_element(elem_id)
-    end
-
-    def element_by_id(elem_id)
-      @web_tester.element_by_id(elem_id)
-    end
-
-    def button_by_id(button_id)
-      button(:id, button_id)
-    end
-
-    def buttons_by_caption(text)
-      button(:text, text)
-    end
-    alias buttons_by_text buttons_by_caption
-
-    def link_by_id(link_id)
-      link(:id, link_id)
-    end
-
-    # default options: exact => true
-    def links_by_text(link_text, options = {})
-      options.merge!({:exact=> true})
-      matching_links = []
-      links.each { |link|
-        matching_links << link if (options[:exact] ? link.text == link_text :  link.text.include?(link_text))
-      }
-      return matching_links
-    end
-    alias links_with_text links_by_text
-
-    def save_page(file_name = nil)
-      @web_tester.save_page(file_name)
-    end
-    
-    def save_content_to_file(content, file_name = nil)      
-      file_name ||= Time.now.strftime("%Y%m%d%H%M%S") + ".html"
-      puts "about to save page: #{File.expand_path(file_name)}"
-      File.open(file_name, "w").puts content
-    end
-
-  end
-
-end
+require 'uri'
+
+# ZZ patches to RSpec 1.1.2 - 1.1.4
+#  - add to_s method to example_group
+module Spec
+  module Example
+    class ExampleGroup
+      def to_s
+        @_defined_description
+      end
+    end
+  end
+end
+
+# example
+#   should link_by_text(text, options).size > 0
+
+module RWebUnit
+  module RSpecHelper
+    include RWebUnit::Driver
+    include RWebUnit::Utils
+    include RWebUnit::Assert
+
+    # open a browser, and set base_url via hash, but does not acually
+    #
+    # example:
+    #   open_browser :base_url => http://localhost:8080
+    #
+    # There are 3 ways to set base url 
+    #   1. pass as first argument
+    #   2. If running using iTest2, used as confiured
+    #   3. Use default value set
+    def open_browser(base_url = nil, options = {})
+      base_url ||= $ITEST2_PROJECT_BASE_URL
+      base_url ||= $BASE_URL 
+      raise "base_url must be set" if base_url.nil?
+      
+      default_options = {:speed => "fast",
+        :visible => true,
+        :highlight_colour => 'yellow',
+        :close_others => true,
+        :start_new => false, 	# start a new browser always
+        :go => true}
+
+      options = default_options.merge options
+      options[:firefox] = true if "Firefox" == $ITEST2_BROWSER || "Firefox" == $BROWSER
+      ($ITEST2_HIDE_BROWSER) ? $HIDE_IE = true : $HIDE_IE = false
+
+      uri = URI.parse(base_url)
+      uri_base = "#{uri.scheme}://#{uri.host}:#{uri.port}"
+      if options[:start_new]
+        @web_browser = WebBrowser.new(uri_base, nil, options)
+      else 
+        # Reuse existing browser
+        @web_browser = WebBrowser.reuse(uri_base, options)
+      end
+
+      if options[:go]
+        (uri.path.length == 0) ?  begin_at("/") :  begin_at(uri.path)
+      end
+      return @web_browser
+    end
+    alias open_browser_with open_browser
+
+    # --
+    #  Content
+    # --
+
+    def page_title
+      @web_browser.page_title
+    end
+
+    def page_source
+      @web_browser.page_source
+    end
+
+    def table_source(table_id)
+      table(:id, table_id).innerHTML
+      # elem = @web_browser.document.getElementById(table_id)
+      # raise "The element '#{table_id}' is not a table or there are multple elements with same id" unless elem.name.uppercase == "TABLE"
+      # elem.innerHTML
+    end
+    alias table_source_by_id table_source
+
+    def element_text(elem_id)
+      @web_browser.element_value(elem_id)
+    end
+    alias element_text_by_id element_text
+
+    #TODO: is it working?
+    def element_source(elem_id)
+      @web_browser.get_html_in_element(elem_id)
+    end
+
+    def element_by_id(elem_id)
+      @web_browser.element_by_id(elem_id)
+    end
+
+    def button_by_id(button_id)
+      button(:id, button_id)
+    end
+
+    def buttons_by_caption(text)
+      button(:text, text)
+    end
+    alias buttons_by_text buttons_by_caption
+
+    def link_by_id(link_id)
+      link(:id, link_id)
+    end
+
+    # default options: exact => true
+    def links_by_text(link_text, options = {})
+      options.merge!({:exact=> true})
+      matching_links = []
+      links.each { |link|
+        matching_links << link if (options[:exact] ? link.text == link_text :  link.text.include?(link_text))
+      }
+      return matching_links
+    end
+    alias links_with_text links_by_text
+
+    def save_page(file_name = nil)
+      @web_browser.save_page(file_name)
+    end
+    
+    def save_content_to_file(content, file_name = nil)      
+      file_name ||= Time.now.strftime("%Y%m%d%H%M%S") + ".html"
+      puts "about to save page: #{File.expand_path(file_name)}"
+      File.open(file_name, "w").puts content
+    end
+
+    # When running 
+    def debugging?
+      $ITEST2_DEBUGGING && $ITEST2_RUNNING_AS == "test_case"
+    end
+    
+  end
+
+end

data/lib/rwebunit/test_utils.rb

@@ -1,88 +1,98 @@
-#***********************************************************
-#* Copyright (c) 2006, Zhimin Zhan.
-#* Distributed open-source, see full license in MIT-LICENSE
-#***********************************************************
-
-# useful hekoer methods for testing
-#
-module RWebUnit
-  module Utils
-
-    # default date format returned is 29/12/2007.
-    # if supplied parameter is not '%m/%d/%Y' -> 12/29/2007
-    # Otherwise, "2007-12-29", which is most approiate date format
-    def today(format = '%d/%m/%y')
-      if format.downcase == '%d/%m/%y'
-        format_date(Time.now, "%02d/%02d/%04d")
-      elsif format.downcase == '%m/%d/%y'
-        sprintf("%02d/%02d/%04d", Time.now.month, Time.now.day, Time.now.year)
-      else
-        sprintf("%04d-%02d-%02d", Time.now.year, Time.now.month, Time.now.day)
-      end
-    end
-    alias getToday_AU today
-    alias getToday_US today
-    alias getToday today
-
-
-    def days_before(days)
-      nil if !(days.instance_of?(Fixnum))
-      format_date(Time.now - days * 24 * 3600)
-    end
-
-    def yesterday
-      days_before(1)
-    end
-
-    def days_from_now(days)
-      nil if !(days.instance_of?(Fixnum))
-      format_date(Time.now + days * 24 * 3600)
-    end
-    alias days_after days_from_now
-
-    def tomorrow
-      days_from_now(1)
-    end
-
-    # return a random number >= min, but <= max
-    def random_number(min, max)
-      rand(max-min+1)+min
-    end
-
-    def random_boolean
-      return random_number(0, 1) == 1
-    end
-
-    def random_char(lowercase = true)
-      sprintf("%c", random_number(97, 122)) if lowercase
-      sprintf("%c", random_number(65, 90)) unless lowercase
-    end
-
-    def random_digit()
-      sprintf("%c", random_number(48, 57))
-    end
-
-    def random_str(length, lowercase = true)
-      randomStr = ""
-      length.times {
-        randomStr += random_char(lowercase)
-      }
-      randomStr
-    end
-
-    # Return a random string in a rangeof pre-defined strings
-    def random_string_in(arr)
-      return nil if arr.empty?
-      index = random_number(0, arr.length-1)
-      arr[index]
-    end
-    alias random_string_in_collection random_string_in
-
-    private
-    def format_date(date, date_format = nil)
-      date_format ||=  "%02d/%02d/%04d"
-      sprintf(date_format, date.day, date.month, date.year)
-    end
-
-  end
-end
+#***********************************************************
+#* Copyright (c) 2006, Zhimin Zhan.
+#* Distributed open-source, see full license in MIT-LICENSE
+#***********************************************************
+
+# useful hekoer methods for testing
+#
+module RWebUnit
+  module Utils
+
+    # default date format returned is 29/12/2007.
+    # if supplied parameter is not '%m/%d/%Y' -> 12/29/2007
+    # Otherwise, "2007-12-29", which is most approiate date format
+    def today(format = '%d/%m/%y')
+      if format.downcase == '%d/%m/%y'
+        format_date(Time.now, "%02d/%02d/%04d")
+      elsif format.downcase == '%m/%d/%y'
+        sprintf("%02d/%02d/%04d", Time.now.month, Time.now.day, Time.now.year)
+      else
+        sprintf("%04d-%02d-%02d", Time.now.year, Time.now.month, Time.now.day)
+      end
+    end
+    alias getToday_AU today
+    alias getToday_US today
+    alias getToday today
+
+
+    def days_before(days)
+      nil if !(days.instance_of?(Fixnum))
+      format_date(Time.now - days * 24 * 3600)
+    end
+
+    def yesterday
+      days_before(1)
+    end
+
+    def days_from_now(days)
+      nil if !(days.instance_of?(Fixnum))
+      format_date(Time.now + days * 24 * 3600)
+    end
+    alias days_after days_from_now
+
+    def tomorrow
+      days_from_now(1)
+    end
+
+    # return a random number >= min, but <= max
+    def random_number(min, max)
+      rand(max-min+1)+min
+    end
+
+    def random_boolean
+      return random_number(0, 1) == 1
+    end
+
+    def random_char(lowercase = true)
+      sprintf("%c", random_number(97, 122)) if lowercase
+      sprintf("%c", random_number(65, 90)) unless lowercase
+    end
+
+    def random_digit()
+      sprintf("%c", random_number(48, 57))
+    end
+
+    def random_str(length, lowercase = true)
+      randomStr = ""
+      length.times {
+        randomStr += random_char(lowercase)
+      }
+      randomStr
+    end
+
+    # Return a random string in a rangeof pre-defined strings
+    def random_string_in(arr)
+      return nil if arr.empty?
+      index = random_number(0, arr.length-1)
+      arr[index]
+    end
+    alias random_string_in_collection random_string_in
+
+    def this_file
+      __FILE__
+    end
+    alias current_file this_file
+    
+    def this_directory
+      File.dirname(this_file)
+    end
+    alias current_directory this_directory
+    
+    private
+    def format_date(date, date_format = nil)
+      date_format ||=  "%02d/%02d/%04d"
+      sprintf(date_format, date.day, date.month, date.year)
+    end
+
+  end
+end