webdrone 0.7.6 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4430bada120a35c96df53fdff1f8ad3433fb9e3f
-  data.tar.gz: 8d977ffec647ef6780cf14ac160a89d380325476
+  metadata.gz: 95fbea40c3e54989776ca05aa1c2b6d263432fd3
+  data.tar.gz: 77b81600dd93c3d2802529511ecfce22915325da
 SHA512:
-  metadata.gz: 426f0f149aee865b1e39bc1cb1bc98fc0af3d4feb32a8e130792a5b16d77e446fe83468be0bd91ebdfd590f1de608e0268cf247d4d0b2201818e3f9c2e4e113c
-  data.tar.gz: df461609398cfadff2da8cd86f8c0690c918ae79c4e428aa6d36b087ca1d8587ab8599aedb0661ba71a9e249d0e52f8e4bec41bb1e215d608b8fa347fc86dd2f
+  metadata.gz: e87fd8253681279f843a56e3ef2a170949dca72f29c84ed75e0c98715bf395f7c74ecfae5dd1dc8c3bfe55700ae8845bb4c4129b0928b0033e9889ea9cdee882
+  data.tar.gz: 0fd5df47de47f19941cff84b2b250a3be22a9c2f9bfd5b37b612a3ffedf4c360d8afac928631a54d46c3ea4b7844de450c289f294abe25468de729eb72104308

data/README.md

@@ -27,12 +27,12 @@ Create a browser:
 ```ruby
 require 'webdrone'
 
-a0 = Webdrone.create
+a0 = Webdrone.create timeout: 5
 a0.open.url         'http://www.google.com/'
 a0.quit
 
 # or
-Webdrone.create do |a0|
+Webdrone.create timeout: 5 do |a0|
   a0.open.url       'http://www.google.com/'
 end
 ```
@@ -40,17 +40,21 @@ end
 Take a screenshot:
 
 ```ruby
-a0.shot.name        'login'        # saves to screenshot-0001-login.png
-a0.shot.name        'home'         # saves to screenshot-0002-home.png
+a0.shot.screen        'login'        # saves to screenshot-0001-login.png
+a0.shot.screen        'home'         # saves to screenshot-0002-home.png
 ```
 
 Working with forms:
 
 ```ruby
-a0.form.set         'q', 'A0::WebDrone'
-a0.form.submit
+
+Webdrone.create do |a0|
+  a0.open.url       'http://www.google.com/'
+  a0.form.set         'q', 'A0::WebDrone'
+  a0.form.submit
 end
 
+
 # or
 a0.form.with_xpath '//label[contains(.,"%s")]/following-sibling::*/*[self::input | self::textarea | self::select]' do
   set               'label', 'value'
@@ -61,7 +65,7 @@ a0.form.submit
 
 Filling a form from an xlsx spreadsheet:
 ```ruby
-a0.conf.timeout   10
+TODO
 ```
 
 
@@ -69,7 +73,7 @@ a0.conf.timeout   10
 Config:
 
 ```ruby
-a0.conf.timeout   10
+TODO
 ```
 
 Saving screenshots and downloaded files to a directory:

data/lib/webdrone.rb

@@ -1,4 +1,5 @@
 require 'webdrone/version'
+require 'webdrone/error'
 require 'webdrone/browser'
 require 'webdrone/open'
 require 'webdrone/shot'
@@ -21,6 +22,7 @@ require 'fileutils'
 require 'binding_of_caller'
 require 'pathname'
 
+
 module Webdrone
   def self.create(*args)
     a0 = Webdrone::Browser.new *args

data/lib/webdrone/clic.rb

@@ -14,30 +14,44 @@ module Webdrone
 
     def id(text)
       @a0.find.id(text).click
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def css(text, n: 1, all: false, visible: true)
       @a0.find.css(text, n: n, all: all, visible: visible).click
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def link(text, n: 1, all: false, visible: true)
       @a0.find.link(text, n: n, all: all, visible: visible).click
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def button(text, n: 1, all: false, visible: true)
       @a0.find.button(text, n: n, all: all, visible: visible).click
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def on(text, n: 1, all: false, visible: true)
       @a0.find.on(text, n: n, all: all, visible: visible).click
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def option(text, n: 1, all: false, visible: true)
       @a0.find.option(text, n: n, all: all, visible: visible).click
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def xpath(text, n: 1, all: false, visible: true)
       @a0.find.xpath(text, n: n, all: all, visible: visible).click
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
   end
 end

data/lib/webdrone/conf.rb

@@ -16,11 +16,15 @@ module Webdrone
     def timeout=(val)
       @timeout = val
       @a0.driver.manage.timeouts.implicit_wait = val
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def outdir=(val)
       @outdir = val
       FileUtils.mkdir_p val
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
   end
 end

data/lib/webdrone/ctxt.rb

@@ -16,11 +16,15 @@ module Webdrone
     def create_tab
       @a0.exec.script "function a0_ctx_create_tab() { var w = window.open(); w.document.open(); w.document.write('A0 CTXT CREATE TAB'); w.document.close(); } a0_ctx_create_tab();"
       @a0.driver.switch_to.window @a0.driver.window_handles.last
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
     
     def close_tab
       @a0.driver.close
       @a0.driver.switch_to.window @a0.driver.window_handles.last
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def with_frame(name)
@@ -36,21 +40,29 @@ module Webdrone
         end
       end
       name
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
     
     def reset
       @a0.driver.switch_to.default_content
       @ramestack = []
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
     
     def with_alert
       @a0.wait.for do
         yield @a0.driver.switch_to.alert
       end
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def ignore_alert
       @a0.exec.script 'alert = function(message){return true;};'
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
   end
 end

data/lib/webdrone/error.rb

@@ -0,0 +1,110 @@
+module Webdrone
+  class WebdroneError < StandardError
+    attr_reader :original, :a0, :caller_locations
+    def initialize(msg, original = $!, a0, caller_locations)
+      super(msg)
+      @original = original;
+      @a0 = a0
+      @caller_locations = caller_locations
+      @buffer = []
+
+      # find location of user error
+      @caller_locations[1..-1].each do |location|
+        if not location.path.include? 'lib/webdrone/'
+          @location = location
+          break
+        end
+      end      
+
+      report_script
+      report_screenshot
+      report_exception
+      report_time
+    end
+
+    def write_line(line)
+      line = "#{line.chomp}\r\n"
+      @buffer << line
+      puts line
+    end
+
+    def write_title(title)
+      title = "#{title} " if title.length % 2 != 0
+      title = "== #{title} =="
+      filler = "="
+      length = (80 - title.length) / 2
+      title = "#{filler*length}#{title}#{filler*length}\n" if length > 1
+      write_line title
+    end
+
+    def dump_error_report
+      File.open(File.join(@a0.conf.outdir, "a0_webdrone_error_report.txt"), "a") do |file|
+        file.write(@buffer.join)
+      end
+      @buffer = []
+    end
+
+    def report_script
+      begin
+        ini, fin = [@location.lineno - 10 - 1, @location.lineno + 10 - 1]
+        ini = 0 if ini < 0
+
+        write_title "#{@location.path} AT LINE #{sprintf '%3d', @location.lineno}"
+        File.readlines(@location.path)[ini..fin].each_with_index do |line, index|
+          lno = index + ini + 1
+          if lno == @location.lineno
+            write_line sprintf "%3d ==> %s", lno, line
+          else
+            write_line sprintf "%3d     %s", lno, line
+          end
+        end
+
+        dump_error_report
+      rescue
+      end
+    end
+
+    def report_screenshot
+      begin
+        write_title "AUTOMATIC SCREENSHOT"
+        file = @a0.shot.screen 'a0_webdrone_error_report'
+        write_line "Saved: #{file.path}"
+
+        dump_error_report
+      rescue
+      end
+    end
+
+    def report_exception
+      begin
+        write_title "EXCEPTION DUMP"
+
+        write_line "#{@original.class}: #{@original.message}"
+        @original.backtrace_locations.each do |location|
+          if location.path == @location.path and location.lineno == @location.lineno
+            write_line sprintf " ==> from %s", location
+          else
+            write_line sprintf "     from %s", location
+          end
+        end
+
+        dump_error_report
+      rescue
+      end
+    end
+
+    def report_time
+      write_title "#{Time.new}"
+
+      dump_error_report
+    end
+  end
+
+  def self.report_error(a0, exception, caller_locations)
+    if exception.class == WebdroneError
+      raise exception
+    end
+
+    raise WebdroneError.new(exception.message, exception, a0, caller_locations)
+  end
+end

data/lib/webdrone/exec.rb

@@ -14,6 +14,8 @@ module Webdrone
 
     def script(script, *more)
       @a0.driver.execute_script(script, *more)
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
   end
 end

data/lib/webdrone/find.rb

@@ -16,6 +16,8 @@ module Webdrone
       @a0.wait.for do
         @a0.driver.find_element :id, text
       end
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def css(text, n: 1, all: false, visible: true)
@@ -23,22 +25,32 @@ module Webdrone
         items = @a0.driver.find_elements :css, text
         choose(items, n, all, visible)
       end
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def link(text, n: 1, all: false, visible: true)
       self.xpath XPath::HTML.link(text).to_s, n: n, all: all, visible: visible
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def button(text, n: 1, all: false, visible: true)
       self.xpath XPath::HTML.button(text).to_s, n: n, all: all, visible: visible
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def on(text, n: 1, all: false, visible: true)
       self.xpath XPath::HTML.link_or_button(text).to_s, n: n, all: all, visible: visible
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def option(text, n: 1, all: false, visible: true)
       self.xpath XPath::HTML.option(text).to_s, n: n, all: all, visible: visible
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def xpath(text, n: 1, all: false, visible: true)
@@ -46,6 +58,8 @@ module Webdrone
         items = @a0.driver.find_elements :xpath, text
         choose(items, n, all, visible)
       end
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     protected

data/lib/webdrone/form.rb

@@ -15,6 +15,8 @@ module Webdrone
     def with_xpath(xpath, &block)
       @xpath = xpath
       instance_eval &block
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def set(key, val)
@@ -26,29 +28,41 @@ module Webdrone
         item.clear
         item.send_keys(val)
       end
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def get(key)
       self.find_item(key)[:value]
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def clic(key)
       self.find_item(key).click
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def mark(key, color: 'red')
       @a0.mark.flash self.find_item(key), color: color
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def submit(key = nil)
       self.find_item(key) if key
       @lastitem.submit
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def xlsx(sheet: nil, filename: nil)
       @a0.xlsx.dict(sheet: sheet, filename: filename).each do |k, v|
         self.set k, v
       end
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     protected

data/lib/webdrone/mark.rb

@@ -14,30 +14,44 @@ module Webdrone
 
     def id(text, color: 'red')
       flash @a0.find.id(text), color: color
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def css(text, color: 'red', n: 1, all: false, visible: true)
       flash @a0.find.css(text, n: n, all: all, visible: visible), color: color
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def link(text, color: 'red', n: 1, all: false, visible: true)
       flash @a0.find.link(text, n: n, all: all, visible: visible), color: color
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def button(text, color: 'red', n: 1, all: false, visible: true)
       flash @a0.find.button(text, n: n, all: all, visible: visible), color: color
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def on(text, color: 'red', n: 1, all: false, visible: true)
       flash @a0.find.on(text, n: n, all: all, visible: visible), color: color
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def option(text, color: 'red', n: 1, all: false, visible: true)
       flash @a0.find.option(text, n: n, all: all, visible: visible), color: color
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def xpath(text, color: 'red', n: 1, all: false, visible: true)
       flash @a0.find.xpath(text, n: n, all: all, visible: visible), color: color
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def flash(item, color: 'red')

data/lib/webdrone/open.rb

@@ -14,6 +14,8 @@ module Webdrone
 
     def url(url)
       @a0.driver.get url
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
   end
 end

data/lib/webdrone/shot.rb

@@ -17,6 +17,8 @@ module Webdrone
       filename = sprintf "screenshot-%04d-%s.png", @counter, name
       filename = File.join(@a0.conf.outdir, filename)
       @a0.driver.save_screenshot filename
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
   end
 end

data/lib/webdrone/text.rb

@@ -14,34 +14,50 @@ module Webdrone
 
     def id(text)
       @a0.find.id(text).text
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def css(text)
       @a0.find.css(text).text
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def link(text, n: 1, all: false, visible: true)
       @a0.find.link(text, n: n, all: all, visible: visible).text
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def button(text, n: 1, all: false, visible: true)
       @a0.find.button(text, n: n, all: all, visible: visible).text
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def on(text, n: 1, all: false, visible: true)
       @a0.find.on(text, n: n, all: all, visible: visible).text
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def option(text, n: 1, all: false, visible: true)
       @a0.find.option(text, n: n, all: all, visible: visible).text
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def xpath(text, n: 1, all: false, visible: true)
       @a0.find.xpath(text, n: n, all: all, visible: visible).text
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
     
     def page_title
       @a0.driver.title
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
   end
 end

data/lib/webdrone/version.rb

@@ -1,3 +1,3 @@
 module Webdrone
-  VERSION = "0.7.6"
+  VERSION = "0.8.0"
 end

data/lib/webdrone/vrfy.rb

@@ -14,30 +14,44 @@ module Webdrone
 
     def id(text, attr: nil, eq: nil, contains: nil)
       vrfy @a0.find.id(text), attr: attr, eq: eq, contains: contains
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def css(text, attr: nil, eq: nil, contains: nil)
       vrfy @a0.find.css(text), attr: attr, eq: eq, contains: contains
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def link(text, n: 1, visible: true, attr: nil, eq: nil, contains: nil)
       vrfy @a0.find.link(text, n: n, visible: visible), attr: attr, eq: eq, contains: contains
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def button(text, n: 1, visible: true, attr: nil, eq: nil, contains: nil)
       vrfy @a0.find.button(text, n: n, visible: visible), attr: attr, eq: eq, contains: contains
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def on(text, n: 1, visible: true, attr: nil, eq: nil, contains: nil)
       vrfy @a0.find.on(text, n: n, visible: visible), attr: attr, eq: eq, contains: contains
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def option(text, n: 1, visible: true, attr: nil, eq: nil, contains: nil)
       vrfy @a0.find.option(text, n: n, visible: visible), attr: attr, eq: eq, contains: contains
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def xpath(text, n: 1, visible: true, attr: nil, eq: nil, contains: nil)
       vrfy @a0.find.xpath(text, n: n, visible: visible), attr: attr, eq: eq, contains: contains
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def vrfy(item, attr: nil, eq: nil, contains: nil)

data/lib/webdrone/wait.rb

@@ -25,10 +25,14 @@ module Webdrone
       else
         yield
       end
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def time(val)
       sleep val
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
   end
 end

data/lib/webdrone/xlsx.rb

@@ -29,6 +29,8 @@ module Webdrone
         end
       end
       @dict
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def rows(sheet: nil, filename: nil)
@@ -44,6 +46,8 @@ module Webdrone
         end
       end
       @rows
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def both(sheet: nil, filename: nil)
@@ -67,6 +71,8 @@ module Webdrone
         end
       end
       @both
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
 
@@ -110,10 +116,14 @@ module Webdrone
       end
       k = workbook.write(@filename)
       reset
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     def reset()
       @dict = @rows = @both = nil
+    rescue => exception
+      Webdrone.report_error(@a0, exception, Kernel.caller_locations)
     end
 
     protected

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: webdrone
 version: !ruby/object:Gem::Version
-  version: 0.7.6
+  version: 0.8.0
 platform: ruby
 authors:
 - Aldrin Martoq
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-12-17 00:00:00.000000000 Z
+date: 2016-02-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -159,6 +159,7 @@ files:
 - lib/webdrone/clic.rb
 - lib/webdrone/conf.rb
 - lib/webdrone/ctxt.rb
+- lib/webdrone/error.rb
 - lib/webdrone/exec.rb
 - lib/webdrone/find.rb
 - lib/webdrone/form.rb