awetestlib 0.1.22-x86-mingw32 → 0.1.23-x86-mingw32

data/lib/awetestlib/regression/waits.rb

@@ -1,12 +1,14 @@
 module Awetestlib
   module Regression
-    # Methods for waiting until something has happened in the browser or DOM.
+    # Methods for waiting until something has happened, or waiting while a condition exists, in the browser or DOM.
     # sleep_for() is the basic technique. Its disadvantage is that it needs to be set for the longest likely wait time.
     # The wait methods take advantage of the Watir and Watir Webdriver wait functionality to pause only as long as necessary for
     # the element in question to be in the state needed.
     module Waits
 
-      # Sleep for +seconds+ seconds before continuing execution of the script.
+      # @!group Core
+
+      # Sleep for *seconds* seconds before continuing execution of the script.
       # A message is logged (but not reported) which, by default, includes a trace showing where in the script the sleep was invoked.
       # @param [Fixnum] seconds The number of seconds to wait.
       # @param [Boolean] dbg If true, includes a trace in the message
@@ -18,37 +20,7 @@ module Awetestlib
         sleep(seconds)
       end
 
-      # Wait for a specific text to appear in the +browser+.
-      # @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
-      # @param [String, Regexp] text A string or a regular expression to be found in the *how* attribute that uniquely identifies the element.
-      # @param [String] desc Contains a message or description intended to appear in the log and/or report output
-      # @param [Fixnum] threshold The number of seconds after which a warning is added to the report message.
-      # @param [Fixnum] interval The time between checks that the text exists.
-      # @return [Boolean] Returns true if the text appears before +how_long+ has expired.
-      def hold_for_text(browser, how_long, text, desc = '', threshold = 20, interval = 0.25)
-        countdown = how_long
-        while ((not browser.contains_text(text)) and countdown > 0)
-          sleep(interval)
-          countdown = countdown - interval
-        end
-        if countdown < how_long
-          waittime = how_long - countdown
-          passed_to_log("#{__method__}  '#{text}' found after #{waittime} second(s) #{desc}")
-          if waittime > threshold
-            failed_to_log("#{__method__}  '#{text}' took #{waittime} second(s). (threshold: #{threshold} seconds) #{desc}")
-          end
-          true
-        else
-          failed_to_log("#{__method__}  '#{text}' not found after #{how_long} second(s) #{desc}")
-          false
-        end
-      rescue
-        failed_to_log("Unable to #{__method__} '#{text}'. '#{$!}' #{desc}")
-      end
-
-      alias wait_for_text hold_for_text
-
-      # Wait while an element identified by attribute +how+ with value +what+ 1) exists, disappears, and exists again.
+      # Wait while an element identified by attribute *how* with value *what* 1) exists, disappears, and exists again.
       # @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
       # @param [Symbol] how The element attribute used to identify the specific element.
       #   Valid values depend on the kind of element.
@@ -56,66 +28,30 @@ module Awetestlib
       # @param [String, Regexp] what A string or a regular expression to be found in the *how* attribute that uniquely identifies the element.
       # @param [String] desc Contains a message or description intended to appear in the log and/or report output
       # @param [Fixnum] timeout
-      # @return [Boolean] Returns true if disappears and reappears, each within the +timeout+ limit
+      # @return [Boolean] Returns true if disappears and reappears, each within the *timeout* limit
       def wait_for_element_to_reappear(browser, how, what, desc = '', timeout = 20)
         msg = "Element #{how}=#{what} exists. #{desc}"
         wait_while(browser, "While: #{msg}", timeout) { browser.element(how, what).exists? }
         wait_until(browser, "Until: #{msg}", timeout) { browser.element(how, what).exists? }
       end
 
-      # how_long is integer, what_for is a browser object
-      def wait_for_exists(how_long, what_for)
-        wait_for(how_long, what_for)
-      end
-
-      def wait_for(how_long, what_for)
-        countdown = how_long
-        while ((not what_for.exists?) and countdown > 0)
-          sleep(1)
-          puts what_for.inspect+':'+countdown.to_s
-          countdown = countdown - 1
-        end
-        if countdown
-          puts 'found '+what_for.inspect
-          passed_tolog("wait_for (#{how_long} found "+what_for.inspect)
-        else
-          puts 'Did not find '+what_for.inspect
-          failed_tolog("wait_for (#{how_long} did not find "+what_for.inspect)
-        end
-        countdown
-      end
-
-      def wait_the_hard_way(browser, how, what, wait = 6, intvl = 0.25)
-        count = (wait / intvl).to_i + 1
-        tally = 0
-        ok    = (1 / intvl).to_i + 1
-        debug_to_log("#{__method__}: wait: #{wait} secs; intvl: #{intvl} secs; count; #{count}; thresh: #{ok}")
-        (1..count).each do |x|
-          begin
-            if browser.element(how, what).exists?
-              tally += 1
-              debug_to_log("#{x}: #{(x - 1) * intvl}: #{what} exists.")
-            else
-              tally = 0
-              debug_to_log("#{x}: #{(x - 1) * intvl}: #{what} does not exist.")
-            end
-          rescue
-            tally = 0
-            debug_to_log("#{x}: #{(x - 1) * intvl}: #{what} rescue: #{$!}")
-          end
-          if tally >= ok
-            return true
-          end
-          sleep(intvl)
-        end
-      end
-
+      # Wait until element of type *element*, identified by attribute *how* with value *what* exists on the page.
+      # Timeout is the default used by watir (60 seconds)
+      # @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
+      # @param [Symbol] element The kind of element to click. Must be one of the elements recognized by Watir.
+      #   Some common values are :link, :button, :image, :div, :span.
+      # @param [Symbol] how The element attribute used to identify the specific element.
+      #   Valid values depend on the kind of element.
+      #   Common values: :text, :id, :title, :name, :class, :href (:link only)
+      # @param [String, Regexp] what A string or a regular expression to be found in the *how* attribute that uniquely identifies the element.
+      # @param [String] desc Contains a message or description intended to appear in the log and/or report output
+      # @return [Boolean] True if element exists within timeout limit
       def wait_until_exists(browser, element, how, what, desc = '')
-        msg = "Wait until (#{element} :#{how}=>#{what}) exists."
-        msg << " #{desc}" if desc.length > 0
+        msg = build_message("Wait until (:#{element} :#{how}=>'#{what}') exists.", desc)
         start = Time.now.to_f
         # TODO: try Watir::Wait.until { browser.element(how, what).exists? } instead of this (cumbersome) case statement
         # TODO: above fails on frame
+        Watir::Wait.until { browser.exists? }
         begin
           case element
             when :link
@@ -147,7 +83,7 @@ module Awetestlib
           if e.class.to_s =~ /TimeOutException/
             failed_to_log("#{msg}: '#{$!}'")
             return false
-          elsif not rescue_me(e, __method__, "#{block.to_s}", "#{browser.class}")
+          elsif not rescue_me(e, __method__, rescue_me_command(element, how, what, :exists?), "#{browser.class}")
             raise e
           end
         end
@@ -160,10 +96,24 @@ module Awetestlib
         failed_to_log("Unable to complete #{msg}: '#{$!}'")
       end
 
+      # Wait _while_ expression in *&block* returns true.
+      # @example
+      #   wait_while(browser, 'Textfield is enabled.', 10) { browser.text_field(:id, 'this text field').enabled?}
+      #
+      # @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
+      # @param [String] desc Contains a message or description intended to appear in the log and/or report output
+      # @param [Fixnum] timeout Maximum time to wait, in seconds.
+      # @param [Proc] &block A ruby expression that evaluates to true or false. The expression
+      #  is usually a watir or watir-webdriver command like .exists?, enabled?, etc. on a
+      #  specific DOM element. Note that *&block* is listed as the last parameter inside the signature
+      #  parentheses, but is passed in curly braces outside the signature parentheses in the call.  This is
+      #  the way Ruby works.
+      # @return [Boolean] True if condition returns false within time limit.
       def wait_while(browser, desc, timeout = 45, &block)
         #TODO: Would like to be able to see the block code in the log message instead of the identification
         msg   = "Wait while #{desc}:"
         start = Time.now.to_f
+        Watir::Wait.until { browser.exists? }
         begin
           #Watir::Wait.until(timeout) { block.call(nil) }
           if block.call(nil)
@@ -188,10 +138,17 @@ module Awetestlib
 
       alias wait_while_true wait_while
 
+      # Wait _until_ expression in *&block* returns true.
+      # @example
+      #   wait_until(browser, 'Textfield is enabled.', 10) { browser.text_field(:id, 'this text field').exists?}
+      #
+      # @param (see #wait_while)
+      # @return [Boolean] True if condition in *&block* returns true within time limit.
       def wait_until(browser, desc, timeout = 45, skip_pass = false, &block)
         #TODO: Would like to be able to see the block code in the log message instead of the identification
         msg   = "Wait until #{desc}"
         start = Time.now.to_f
+        Watir::Wait.until { browser.exists? }
         begin
           Watir::Wait.until(timeout) { block.call(nil) }
         rescue => e
@@ -213,10 +170,18 @@ module Awetestlib
 
       alias wait_until_true wait_until
 
-      def wait_until_by_radio_value(browser, strg, desc = '')
-        wait_until_exists(browser, :radio, :value, strg, desc)
-      end
-
+      # Wait _until_ element, identified by attribute *how* and its value *what*, exists.
+      # If it exists within *timeout* seconds then wait _until_ it is enabled.
+      # @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
+      # @param [Symbol] how The element attribute used to identify the specific element.
+      #   Valid values depend on the kind of element.
+      #   Common values: :text, :id, :title, :name, :class, :href (:link only)
+      # @param [String, Regexp] what A string or a regular expression to be found in the *how* attribute that uniquely identifies the element.
+      # @param [String] desc Contains a message or description intended to appear in the log and/or report output
+      # @param [Fixnum] timeout Maximum time to wait, in seconds.
+      # @param [Boolean] verbose When set to true, more debug information is written to the log and
+      # all steps return pass/fail messages in the report.
+      # @return [Boolean] True if condition returns false within time limit.
       def wait_until_ready(browser, how, what, desc = '', timeout = 90, verbose = false)
         msg = "#{__method__.to_s.titleize}: element: #{how}='#{what}'"
         msg << " #{desc}" if desc.length > 0
@@ -240,6 +205,7 @@ module Awetestlib
           end
         else
           start = Time.now.to_f
+          Watir::Wait.until { browser.exists? }
           if Watir::Wait.until(timeout) { proc_exists.call(nil) }
             if Watir::Wait.until(timeout) { proc_enabled.call(nil) }
               stop = Time.now.to_f
@@ -257,6 +223,17 @@ module Awetestlib
         failed_to_log("Unable to #{msg}. '#{$!}'")
       end
 
+      # Wait _until_ element, identified by attribute *how* and its value *what*, exists.
+      # If it exists within *timeout* seconds then wait _until_ it is enabled.  Report only failures.
+      # @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
+      # @param [Symbol] how The element attribute used to identify the specific element.
+      #   Valid values depend on the kind of element.
+      #   Common values: :text, :id, :title, :name, :class, :href (:link only)
+      # @param [String, Regexp] what A string or a regular expression to be found in the *how* attribute that uniquely identifies the element.
+      # @param [String] desc Contains a message or description intended to appear in the log and/or report output
+      # @param [Fixnum] timeout Maximum time to wait, in seconds.
+      # @param [Boolean] quiet When set to true, only fail messages are logged and reported.
+      # @return [Boolean] True if condition returns false within time limit.
       def wait_until_ready_quiet(browser, how, what, desc = '', timeout = 45, quiet = true)
         msg = "#{__method__.to_s.titleize}: element: #{how}='#{what}'"
         msg << " #{desc}" if desc.length > 0
@@ -268,6 +245,8 @@ module Awetestlib
             proc_enabled = Proc.new { browser.link(how, what).enabled? }
         end
         start = Time.now.to_f
+        Watir::Wait.until { browser.exists? }
+        sleep_for(1)
         if Watir::Wait.until(timeout) { proc_exists.call(nil) }
           if Watir::Wait.until(timeout) { proc_enabled.call(nil) }
             stop = Time.now.to_f
@@ -293,13 +272,11 @@ module Awetestlib
 
       alias wait_until_by_text wait_until_text
 
-      def wait_until_by_link_text(browser, strg, desc = '')
-        wait_until_exists(browser, :link, :text, strg, desc)
-      end
-
       def wait_until_enabled(browser, what, how, value, desc = '')
         # TODO: This can be simplified
         start = Time.now.to_f
+        Watir::Wait.until { browser.exists? }
+        sleep_for(1)
         begin
           case what
             when :link
@@ -319,7 +296,7 @@ module Awetestlib
             when :table
               Watir::Wait.until { browser.table(how, value).enabled? }
             else
-              raise "#{__method__}: Element #{what} not supported."
+              Watir::Wait.until { browser.element(how, value).enabled? }
           end
         rescue => e
           if e.class.to_s =~ /TimeOutException/
@@ -340,6 +317,8 @@ module Awetestlib
 
       def wait_until_visible(browser, element, how, what, desc = '')
         start = Time.now.to_f
+        Watir::Wait.until { browser.exists? }
+        sleep_for(1)
         Watir::Wait.until(20) { browser.element(how, what).exists? }
         begin
           case element
@@ -365,7 +344,7 @@ module Awetestlib
           if e.class.to_s =~ /TimeOutException/
             failed_to_log("Wait until (#{what} :#{how}=>#{what}) visible. #{desc}: '#{$!}' #{desc}")
             return false
-          elsif not rescue_me(e, __method__, '', "#{browser.class}")
+          elsif not rescue_me(e, __method__, rescue_me_command(element, how, what, :visible?), "#{browser.class}")
             raise e
           end
         end
@@ -378,6 +357,113 @@ module Awetestlib
         failed_to_log("Unable to complete wait until (#{element} :#{how}=>#{what}) visible. #{desc}: '#{$!}'")
       end
 
+      # @!endgroup Core
+
+      # @!group  Altenatives
+
+      # Wait for a specific text to appear in the *browser*.
+      # @note This is a last resort method when other wait or wait until avenues have been exhausted.
+      # @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
+      # @param [String, Regexp] text A string or a regular expression to be found in the *how* attribute that uniquely identifies the element.
+      # @param [String] desc Contains a message or description intended to appear in the log and/or report output
+      # @param [Fixnum] threshold The number of seconds after which a warning is added to the report message.
+      # @param [Fixnum] interval The time between checks that the text exists.
+      # @return [Boolean] Returns true if the text appears before *how_long* has expired.
+      def hold_for_text(browser, how_long, text, desc = '', threshold = 20, interval = 0.25)
+        countdown = how_long
+        Watir::Wait.until { browser.exists? }
+        sleep_for(1)
+        while ((not browser.contains_text(text)) and countdown > 0)
+          sleep(interval)
+          countdown = countdown - interval
+        end
+        if countdown < how_long
+          waittime = how_long - countdown
+          passed_to_log("#{__method__}  '#{text}' found after #{waittime} second(s) #{desc}")
+          if waittime > threshold
+            failed_to_log("#{__method__}  '#{text}' took #{waittime} second(s). (threshold: #{threshold} seconds) #{desc}")
+          end
+          true
+        else
+          failed_to_log("#{__method__}  '#{text}' not found after #{how_long} second(s) #{desc}")
+          false
+        end
+      rescue
+        failed_to_log("Unable to #{__method__} '#{text}'. '#{$!}' #{desc}")
+      end
+
+      alias wait_for_text hold_for_text
+
+      # Wait up to *how_long* seconds for DOM element *what_for* to exist in the page.
+      # @note This is a last resort method when other wait or wait until avenues have been exhausted.
+      # @param [Fixnum] how_long Timeout limit
+      # @param [Watir::Element] what_for A reference to a Dom element to wait for.
+      def wait_for_exists(how_long, what_for)
+        wait_for(how_long, what_for)
+      end
+
+      # Wait up to *how_long* seconds for DOM element *what_for* to exist in the page.
+      # @note This is a last resort method when other wait or wait until avenues have
+      # been exhausted.
+      # @param [Fixnum] how_long Timeout limit
+      # @param [Watir::Element] what_for A reference to a Dom element to wait for.
+      def wait_for(how_long, what_for, interval = 0.25)
+        countdown = how_long
+        while ((not what_for.exists?) and countdown > 0)
+          sleep(interval)
+          puts what_for.inspect+':'+countdown.to_s
+          countdown = countdown - interval
+        end
+        if countdown
+          puts 'found '+what_for.inspect
+          passed_tolog("wait_for (#{how_long} found "+what_for.inspect)
+        else
+          puts 'Did not find '+what_for.inspect
+          failed_tolog("wait_for (#{how_long} did not find "+what_for.inspect)
+        end
+        countdown
+      end
+
+      # Wait up to *how_long* seconds for DOM element identified by attribute *how* and its value
+      # *what* to exist in the page.
+      # @note This is a last resort method when other wait or wait until avenues have been exhausted.
+      # @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
+      # @param [Symbol] how The element attribute used to identify the specific element.
+      #   Valid values depend on the kind of element.
+      #   Common values: :text, :id, :title, :name, :class, :href (:link only)
+      # @param [String, Regexp] what A string or a regular expression to be found in the *how* attribute that uniquely identifies the element.
+      # @param [Fixnum] wait Timeout limit.
+      # @param [Fixnum] interval How long to wait before checking again.
+      # @return [Boolean] True if element exists within *wait* time
+      def wait_the_hard_way(browser, how, what, wait = 6, interval = 0.25)
+        count = (wait / interval).to_i + 1
+        tally = 0
+        ok    = (1 / interval).to_i + 1
+        debug_to_log("#{__method__}: wait: #{wait} secs; interval: #{interval} secs; count; #{count}; thresh: #{ok}")
+        Watir::Wait.until { browser.exists? }
+        sleep_for(1)
+        (1..count).each do |x|
+          begin
+            if browser.element(how, what).exists?
+              tally += 1
+              debug_to_log("#{x}: #{(x - 1) * interval}: #{what} exists.")
+            else
+              tally = 0
+              debug_to_log("#{x}: #{(x - 1) * interval}: #{what} does not exist.")
+            end
+          rescue
+            tally = 0
+            debug_to_log("#{x}: #{(x - 1) * interval}: #{what} rescue: #{$!}")
+          end
+          if tally >= ok
+            return true
+          end
+          sleep(interval)
+        end
+      end
+
+      # @!endgroup Alternatives
+
     end
   end
 end

data/lib/awetestlib/runner.rb

@@ -1,5 +1,6 @@
 require 'open-uri'
 module Awetestlib
+  # Parent class. Each script type will have a Runner that inherits from this class.
   class Runner
     def initialize(options = {})
       build_class = "Awetestlib::#{check_script_type(options[:script_type])}::Runner".constantize

data/lib/awetestlib.rb

@@ -5,6 +5,7 @@ module Awetestlib
   ::USING_WINDOWS = !!((RUBY_PLATFORM =~ /(win|w)(32|64)$/) || (RUBY_PLATFORM=~ /mswin|mingw/))
   ::USING_OSX     = RUBY_PLATFORM =~ /darwin/
 
+  # @private
   BROWSER_MAP = {
       'FF' => 'Firefox',
       'IE' => 'Internet Explorer',
@@ -13,6 +14,7 @@ module Awetestlib
       'C'  => 'Chrome'
   }
 
+  # @private
   BROWSER_ALTERNATES = {
       'OSX'     => { 'IE' => 'S' },
       'Windows' => { 'S' => 'IE' }
@@ -20,7 +22,7 @@ module Awetestlib
 
   if USING_WINDOWS
     #require 'win32ole' <-- We'll load this later in Shamisen::AwetestLegacy::Runner. It has to be loaded after watir, see https://www.pivotaltracker.com/story/show/19249981
-    require 'win32/screenshot'  # triggering segmentation fault 10sep2012 pmn
+    #require 'win32/screenshot'  # triggering segmentation fault 10sep2012 pmn
   end
   #require 'active_support/inflector'
   #require 'active_support/core_ext/object'

data/lib/version.rb

@@ -1,4 +1,4 @@
 module Awetestlib
-  VERSION = "0.1.22"
-  VERSION_DATE = "2012-11-13"
+  VERSION = "0.1.23"
+  VERSION_DATE = "2012-11-15"
 end

data/test/create_zoho_account1.rb

@@ -28,7 +28,7 @@ module CreateZohoAccount1
   def create_account(browser)
     mark_testlevel('Create New Account', 1)
     sleep_for(3)
-    click_text(browser, 'New Account')
+    click(browser, :link, :text, 'New Account')
     wait_until_ready(browser, :name, /Account Name/)
     set_textfield_by_name(browser, /Account Name/, "Test Account #1")
     set_textfield_by_name(browser, /Phone/, "415-333-2311")

data/test/login_1.rb

@@ -0,0 +1,37 @@
+module Login1
+
+  def run
+
+    browser = open_browser
+
+    go_to_url(browser, 'www.yahoo.com')
+    wait_until_exists(browser, :link, :text, 'Sign In')
+    click(browser, :link, :text, 'Sign In')
+    wait_until_exists(browser, :text_field, :id, 'username')
+    set_textfield(browser, :id, 'username', 'awetesta@yahoo.com')
+    set_textfield(browser, :id, 'passwd', 'awetest001')
+    #wait_until_exists(browser, :button, :text, 'Sign In')
+    click(browser, :button, :text, 'Sign In')
+    sleep_for(8)
+    wait_until_text(browser, 'HI, A')
+    sleep_for(3)
+    click(browser, :link, :text, 'Sign Out')
+
+    go_to_url(browser, 'www.yahoo.com')
+    wait_until_exists(browser, :link, :text, 'Sign In')
+    click(browser, :link, :text, 'Sign In')
+    wait_until_exists(browser, :text_field, :id, 'username')
+    set_textfield(browser, :id, 'username', 'awetestt3@yahoo.com')
+    set_textfield(browser, :id, 'passwd', 'awetest001')
+    #wait_until_exists(browser, :button, :text, 'Sign In')
+    click(browser, :button, :text, 'Sign In')
+    sleep_for(8)
+    wait_until_text(browser, 'HI, T-THREE')
+    sleep_for(3)
+    click(browser, :link, :text, 'Sign Out')
+
+    browser.close
+
+  end
+
+end

data/test/login_1a.rb

@@ -0,0 +1,37 @@
+module Login1a
+
+  def run
+
+    browser = open_browser
+
+    go_to_url(browser, 'www.yahoo.com')
+    sleep(5)
+    click(browser, :link, :text, 'Sign In')
+    sleep(5)
+    set_textfield(browser, :id, 'username', 'awetesta@yahoo.com')
+    set_textfield(browser, :id, 'passwd', 'awetest001')
+    click(browser, :button, :text, 'Sign In')
+    sleep(8)
+    validate_text(browser, 'HI, A')
+    sleep(8)
+    click(browser, :link, :text, 'Sign Out')
+
+    sleep(8)
+
+    go_to_url(browser, 'www.yahoo.com')
+    sleep(5)
+    click(browser, :link, :text, 'Sign In')
+    sleep(5)
+    set_textfield(browser, :id, 'username', 'awetestt3@yahoo.com')
+    set_textfield(browser, :id, 'passwd', 'awetest001')
+    click(browser, :button, :text, 'Sign In')
+    sleep(8)
+    validate_text(browser, 'HI, T-THREE')
+    sleep(8)
+    click(browser, :link, :text, 'Sign Out')
+
+    browser.close
+
+  end
+
+end

data/test/login_2.rb

@@ -0,0 +1,32 @@
+module Login2
+
+  def run
+
+    if @xls_path
+
+      get_variables(@xls_path, :userid)
+
+      login_url = "https://accounts.zoho.com/login?serviceurl=https://www.zoho.com/&hide_signup=true&css=https://www.zoho.com/css/login.css"
+
+      browser = open_browser
+
+      @login.each_key do |key|
+        if @login[key]['enabled'] == 'Y'
+          userid    = key
+          password  = @login[key]['password']
+          name      = @login[key][name]
+
+          go_to_url(browser, login_url)
+          set_textfield(browser, :name, 'lid', userid)
+          set_textfield(browser, :name, 'pwd', password)
+          click(browser, :button, :value, 'Sign In')
+          go_to_url(browser, 'https://crm.zoho.com/crm/ShowHomePage.do')
+          validate_text(browser, "Welcome #{name} at Software")
+          click_link(browser, :text, 'sign out')
+
+        end
+      end
+    end
+  end
+
+end

data/test/zoho_exercise.rb

@@ -0,0 +1,21 @@
+module ZohoExercise
+  $watir_script = true
+
+  def run
+    browser = open_browser
+    go_to_url(browser, 'http://crm.zoho.com/crm/login.sas')
+    sleep_for(2)
+    logon_to_zoho(browser)
+    logout(browser)
+  end
+
+  def logon_to_zoho(browser)
+    mark_testlevel("#{__method__.to_s.humanize}", 8)
+    click(browser, :link, :text, 'Sign In')
+    sleep_for(2)
+    frame = get_frame(browser, :id, 'zohoiam')
+    set_text_field(frame, :id, 'lid', 'joeklienwatir@gmail.com')
+    set_text_field(frame, :name, 'pwd', 'watir001')
+    sleep(1)
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: awetestlib
 version: !ruby/object:Gem::Version 
-  hash: 55
+  hash: 53
   prerelease: 
   segments: 
   - 0
   - 1
-  - 22
-  version: 0.1.22
+  - 23
+  version: 0.1.23
 platform: x86-mingw32
 authors: 
 - Anthony Woo
@@ -16,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-11-13 00:00:00 Z
+date: 2012-11-15 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: watir-webdriver
@@ -309,6 +309,7 @@ extra_rdoc_files: []
 files: 
 - .gitattributes
 - .gitignore
+- .yardopts
 - AwetestLib Instructions.rtf
 - README.md
 - awetestlib.gemspec
@@ -389,6 +390,11 @@ files:
 - test/demo.rb
 - test/google_search1.rb
 - test/google_search2.rb
+- test/login.xls
+- test/login_1.rb
+- test/login_1a.rb
+- test/login_2.rb
+- test/zoho_exercise.rb
 - test/zoho_util.rb
 - test/zoho_variables.xls
 - tmp/placeholder.html