webdrone 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ce1ac20c62a89e4f9432d957bd6939f8e522888c
-  data.tar.gz: 42e14188457d80576e548a5c15636caf45efafd4
+  metadata.gz: cb888344d4b82d0c3747d3812b275d13313accc0
+  data.tar.gz: 1b373f581493ed391fc44e82fa1040909ac037cc
 SHA512:
-  metadata.gz: 3f87bd8257def21f12b14499c8103514e9dff4a752e7f207456729f3aaec49f633b8dad8056d25ebf4e442b283bf26a880115314cd3380dd30a8d42ee6cbb81e
-  data.tar.gz: c43aa6c3d7036b06a7fc62d99e974ce7bc04acb2ef888c73d254c22a57c263185770de02fbe2e4242da2059ba9a22117cb5e5313769b6fa0cc0e9f6c40cca7dc
+  metadata.gz: 545229f0fa9da4eff8a7e477810e37bb10112a1684cccde6c210e861ea9e1d0ec43c31eecbf17d7e886ec7094ed0ea0ba0890b6d60cf6c0d104082623b4e88d1
+  data.tar.gz: 384975fb4517f9a7bf2923798e94db24c0a3686d92d77cfa0110777ddfe89b05f8e481adc2556ba713a6199809791006c316005d30781f43392d5111db3db5f7

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015 Aldrin Martoq
+Copyright (c) 2015 Servicios A0 SpA
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -2,6 +2,8 @@
 
 Yet another selenium webdriver wrapper, ruby version.
 
+There is a groovy version available, at https://github.com/a0/a0-webdrone-groovy.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -26,53 +28,69 @@ Create a browser:
 require 'webdrone'
 
 a0 = Webdrone.create
-a0.open.url    'http://www.google.com/'
+a0.open.url         'http://www.google.com/'
 a0.quit
 
 # or
 Webdrone.create do |a0|
-  a0.open.url    'http://www.google.com/'
+  a0.open.url       'http://www.google.com/'
 end
 ```
 
 Take a screenshot:
 
 ```ruby
-require 'webdrone'
-
-Webdrone.create do |a0|
-  a0.open.url    'http://www.google.com/'
-  a0.shot.name   'start page'
-end
+a0.shot.name        'login'        # saves to screenshot-0001-login.png
+a0.shot.name        'home'         # saves to screenshot-0002-home.png
 ```
 
-Filling a form:
+Working with forms:
 
 ```ruby
-require 'webdrone'
-
-Webdrone.create do |a0|
-  a0.open.url    'http://www.google.com/'
-  a0.form.set    'q', 'A0::WebDrone'
-  a0.form.submit
+a0.form.set         'q', 'A0::WebDrone'
+a0.form.submit
 end
 
 # or
-a0.open.url    'http://www.google.com/'
 a0.form.with_xpath '//label[contains(.,"%s")]/following-sibling::*/*[self::input | self::textarea | self::select]' do
-  set   'label', 'value'
-  xlsx  sheet: 'ejemplo'
+  set               'label', 'value'
+  xlsx              sheet: 'ejemplo'
 end
 a0.form.submit
 ```
 
+Filling a form from an xlsx spreadsheet:
+```ruby
+a0.conf.timeout   10
+```
+
+
+
 Config:
 
 ```ruby
 a0.conf.timeout   10
 ```
 
-Context, text and verification:
+Saving screenshots and downloaded files to a directory:
+
+```ruby
+a0 = Webdrone.create create_outdir: true
+print a0.conf.outdir            # <= default is webdrone_output_%date%_%time%
+
+a0.open.url     'http://www.google.cl/'
+a0.form.set     'q', "Download sample file filetype:xls\n"
+a0.shot.screen  'homepage'      # screenshot is saved in output directory
+a0.clic.xpath   '//h3'          # xls file is saved in output directory
+
+# or specify directory yourself
+a0 = Webdrone.create outdir: '/tmp/evidences'
+print a0.conf.outdir            # <= "/tmp/evidences"
+```
+
+
+
+Creating tabs and switching iframes:
 
 ```ruby
 a0.ctxt.create_tab
@@ -80,11 +98,22 @@ a0.open.url     'http:://example.com/'
 a0.ctxt.with_frame 'iframe_name' do 
   a0.find.on  'Some link or button'
 end
-puts  a0.text.id('something')
+```
+
+Getting text:
 
-a0.vrfy.id    'another', contains: 'SOME TEXT'
-a0.vrfy.id    'another', eq: 'EXACT TEXT'
+```ruby
+puts  a0.text.id        'some_id'
+puts  a0.text.xpath     'some_xpath'
+```
+
+Verifying text and HTML attributes
+
+```ruby
+a0.vrfy.id    'some_id', contains: 'SOME TEXT'
+a0.vrfy.xpath 'some_xpath', eq: 'EXACT TEXT'
 a0.vrfy.link  'link', attr: 'disabled', eq: 'true'
+a0.vrfy.link  'link', attr: 'sample', contains: 'something'
 ```
 
 
@@ -97,7 +126,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/a0/webdrone-ruby.
+Bug reports and pull requests are welcome on GitHub at https://github.com/a0/a0-webdrone-ruby.
 
 
 ## License

data/lib/webdrone.rb

@@ -17,6 +17,7 @@ require 'selenium-webdriver'
 require 'xpath'
 require 'rubyXL'
 require 'irb'
+require 'fileutils'
 
 module Webdrone
   def self.create(*args)
@@ -26,7 +27,7 @@ module Webdrone
         yield a0
       ensure
         a0.quit
-      end    
+      end
     else
       a0
     end

data/lib/webdrone/browser.rb

@@ -2,8 +2,24 @@ module Webdrone
   class Browser
     attr_accessor :driver
 
-    def initialize(browser: 'chrome')
-      @driver = Selenium::WebDriver.for browser.to_sym
+    def initialize(browser: 'chrome', create_outdir: false, outdir: nil)
+      if create_outdir or outdir
+        outdir ||= "webdrone_output_#{Time.new.strftime('%Y%m%d_%H%M')}"
+        self.conf.outdir = outdir
+      end
+      if outdir != nil and browser.to_sym == :chrome
+        prefs = { download: { prompt_for_download: false, default_directory: outdir } }
+        @driver = Selenium::WebDriver.for browser.to_sym, prefs: prefs
+      elsif outdir != nil and browser.to_sym == :firefox
+        profile = Selenium::WebDriver::Firefox::Profile.new
+        profile['browser.download.dir'] = outdir
+        profile['browser.download.folderList'] = 2
+        profile['browser.download.manager.showWhenStarting'] = false
+        profile['browser.helperApps.neverAsk.saveToDisk'] = "images/jpeg, application/pdf, application/octet-stream"
+        @driver = Selenium::WebDriver.for browser.to_sym, profile: profile
+      else
+        @driver = Selenium::WebDriver.for browser.to_sym
+      end
     end
 
     def quit

data/lib/webdrone/clic.rb

@@ -12,8 +12,8 @@ module Webdrone
       @a0 = a0
     end
 
-    def id(id)
-      @a0.find.id(id).click
+    def id(text)
+      @a0.find.id(text).click
     end
 
     def link(text, n: 1, all: false, visible: true)
@@ -28,6 +28,10 @@ module Webdrone
       @a0.find.on(text, n: n, all: all, visible: visible).click
     end
 
+    def option(text, n: 1, all: false, visible: true)
+      @a0.find.option(text, n: n, all: all, visible: visible).click
+    end
+
     def xpath(text, n: 1, all: false, visible: true)
       @a0.find.xpath(text, n: n, all: all, visible: visible).click
     end

data/lib/webdrone/conf.rb

@@ -6,15 +6,21 @@ module Webdrone
   end
 
   class Conf
-    attr_accessor :a0, :timeout
+    attr_accessor :a0, :timeout, :outdir
 
     def initialize(a0)
       @a0 = a0
+      @outdir = "."
     end
 
     def timeout=(val)
       @timeout = val
       @a0.driver.manage.timeouts.implicit_wait = val
     end
+
+    def outdir=(val)
+      @outdir = val
+      FileUtils.mkdir_p val
+    end
   end
 end

data/lib/webdrone/ctxt.rb

@@ -28,7 +28,7 @@ module Webdrone
       @current_frame = name
       if block_given?
         yield
-        @a0.driver.switch_to.parent_frame
+        @a0.driver.switch_to.frame old_frame
         @current_frame = old_frame
       end
       @current_frame

data/lib/webdrone/find.rb

@@ -12,9 +12,9 @@ module Webdrone
       @a0 = a0
     end
 
-    def id(id)
+    def id(text)
       @a0.wait.for do
-        @a0.driver.find_element :id, id
+        @a0.driver.find_element :id, text
       end
     end
 
@@ -30,6 +30,10 @@ module Webdrone
       self.xpath XPath::HTML.link_or_button(text).to_s, n: n, all: all, visible: visible
     end
 
+    def option(text, n: 1, all: false, visible: true)
+      self.xpath XPath::HTML.option(text).to_s, n: n, all: all, visible: visible
+    end
+
     def xpath(text, n: 1, all: false, visible: true)
       @a0.wait.for do
         items = @a0.driver.find_elements :xpath, text

data/lib/webdrone/mark.rb

@@ -12,8 +12,8 @@ module Webdrone
       @a0 = a0
     end
 
-    def id(id, color: 'red')
-      flash @a0.find.id(id), color: color
+    def id(text, color: 'red')
+      flash @a0.find.id(text), color: color
     end
 
     def link(text, color: 'red', n: 1, all: false, visible: true)
@@ -28,24 +28,28 @@ module Webdrone
       flash @a0.find.on(text, n: n, all: all, visible: visible), color: color
     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
+    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
     end
 
     def flash(item, color: 'red')
       3.times do
-        border 'white', item
+        border item, 'white'
         sleep 0.1
-        border 'blue', item
+        border item, 'blue'
         sleep 0.1
-        border color, item
+        border item, color
         sleep 0.1
       end
       item
     end
 
     protected
-      def border(color, item)
+      def border(item, color)
         if item.is_a? Array
           item.each do |item|
             @a0.exec.script("arguments[0].style.border = '2px solid #{color}'", item)

data/lib/webdrone/shot.rb

@@ -15,6 +15,7 @@ module Webdrone
     def screen(name)
       @counter = (@counter || 0) + 1
       filename = sprintf "screenshot-%04d-%s.png", @counter, name
+      filename = File.join(@a0.conf.outdir, filename)
       @a0.driver.save_screenshot filename
     end
   end

data/lib/webdrone/text.rb

@@ -12,8 +12,8 @@ module Webdrone
       @a0 = a0
     end
 
-    def id(id)
-      @a0.find.id(id).text
+    def id(text)
+      @a0.find.id(text).text
     end
 
     def link(text, n: 1, all: false, visible: true)
@@ -28,6 +28,10 @@ module Webdrone
       @a0.find.on(text, n: n, all: all, visible: visible).text
     end
 
+    def option(text, n: 1, all: false, visible: true)
+      @a0.find.option(text, n: n, all: all, visible: visible).text
+    end
+
     def xpath(text, n: 1, all: false, visible: true)
       @a0.find.xpath(text, n: n, all: all, visible: visible).text
     end

data/lib/webdrone/version.rb

@@ -1,3 +1,3 @@
 module Webdrone
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/webdrone/vrfy.rb

@@ -12,8 +12,8 @@ module Webdrone
       @a0 = a0
     end
 
-    def id(id, attr: nil, eq: nil, contains: nil)
-      vrfy @a0.find.id(id), attr: attr, eq: eq, contains: contains
+    def id(text, attr: nil, eq: nil, contains: nil)
+      vrfy @a0.find.id(text), attr: attr, eq: eq, contains: contains
     end
 
     def link(text, n: 1, visible: true, attr: nil, eq: nil, contains: nil)
@@ -28,6 +28,10 @@ module Webdrone
       vrfy @a0.find.on(text, n: n, visible: visible), attr: attr, eq: eq, contains: contains
     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
+    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
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: webdrone
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Aldrin Martoq
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-09-08 00:00:00.000000000 Z
+date: 2015-10-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler