browza 0.0.2.beta2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 58d7a048ff31099323ddbe6b22a0960e4e7d554c
-  data.tar.gz: 49a4e1ee2cb8145b8c6b5c509dc42816c271961f
+  metadata.gz: 9be45cff4eee8f679be47ac85f127f5031ed9338
+  data.tar.gz: 8d1f2adb8fdf39e2050bd909f8f6b56dec29981f
 SHA512:
-  metadata.gz: 10a3f291df8bf8615146bb526f8ba6cb68eb1e05057d1a70c2b4e3cf3a119f29f3542b98508cd3d791953cedb05038079a93638ef1e750c8d1816b9ac466dd11
-  data.tar.gz: 777b465d8950e7f3208c2658007509ec0291b4dc82e21e0af4aab7cca072c2d906cee23896c7e9f53f32afee4bd9382d8368b3575bfcc3789f5b13a23dd33254
+  metadata.gz: ee4d7640add30d9f0f067e0b841c0d6c488d4b740bf431f4facf2208e4f8a91fe341d82a7004fc3628297e67817b1dcef7de45b203a8e5bdad6b22ef3f5fc554
+  data.tar.gz: 225b1e0fc62b853f1e345fc63c568622e9f9636f0fbb8b797b95f705b2172d2764b772266577d87a01001d591e614842fd4eb50929d3c8f8f3afb649edc840e4

data/README.md

@@ -1,2 +1,104 @@
 
 # Browza
+
+## Description
+
+Very simple, yet reliable, Selenium-Webdriver3, command module.  Simple set of commands to automate your browser
+without having to code.
+
+Browza also supports and easily integrates with Ruby Gem *appmodel* which supports modeling (e.g. simplify pageObjects).
+
+## APIs
+
+### click(<locator>)
+
+### Browser Creation
+1. createBrowser
+* createBrowser(:chrome)
+* createBrowser(:firefox)
+1. start()
+  * Run locally
+    1. SELENIUM_RUN=local
+    1. SELENIUM_PLATFORM=local
+    1. SELENIUM_BROWSER=[ chrome | firefox | ie | edge ]
+    1. SELENIUM_RESOLUTION=[widthxheight]
+       * 1024x768
+  * Run on SauceLabs
+    1. SELENIUM_PLATFORM=[ Windows 8.1 | Windows 10 | linux | osx* ]
+    1. SELENIUM_BROWSER=[ chrome | firefox | ie | edge ]
+    1. SELENIUM_VERSION=[ version of browser ]
+       * 11.0  (for IE)
+       * 57.0  (for Chrome)
+       * 52.0  (for Chrome/Firefox)
+       * etc
+    1. SELENIUM_RESOLUTION=[widthxheight] 
+
+
+### displayed?(<locator>)
+
+Returns true if the locator is displayed (visible).
+
+### focusedText
+
+Returns the text of the currently focused element.
+
+### focusedValue
+
+Returns the value of the currently focused element.
+
+### highlight(<locator>)
+
+Highlight the provided locator.
+
+### hover(<locator>)
+
+Mouseover the provided locator.
+
+### isFocused(<locator>)
+
+Returns true if the currently focused element matches the locator.
+
+### navigate
+
+### press(<key>)
+
+Press the keyboard key.
+
+
+### setTimeout
+
+Sets the default explicit default timeout (30 sec.)
+
+### addModel(<path to model file>)
+
+Add a model specified by a file (e.g. JSON).  The model is a superset of a page object.
+
+### setDimension(width, height)
+
+Set/resize browser viewport.
+
+### maximize
+
+Maximize the browser.
+
+### quit
+
+Quit browser (quit & close)
+
+### title
+
+Get the title from the currently loaded page.
+
+### isChrome?
+
+Returns true, if the browser under test is Chrome.
+
+
+### isTitle?(<regex>)
+
+Returns a boolean - based on whether the current title matches the provided regEx.
+
+### selected?(<locator>)
+Returns true, if the locator is 'selected' (e.g. radio/checkbox button)
+
+### type(<locator>, <text>)

data/browza.gemspec

@@ -19,10 +19,11 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.11"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "bundler", "~> 1.14.6"
+  spec.add_development_dependency "rake", "~> 12.0.0"
+  spec.add_development_dependency "rspec", "~> 3.5.0"
   spec.add_development_dependency "appmodel", "~> 0.1.2"
-  spec.add_development_dependency "selenium-webdriver"
+  spec.add_development_dependency "selenium-webdriver", "~> 3.4.0"
   spec.add_development_dependency "logging", "~> 2.2"
+  spec.add_development_dependency "sauce_whisk", "~> 0.1.0"
 end

data/examples/ex1.rb

@@ -0,0 +1,25 @@
+
+
+
+require_relative '../lib/browza'
+
+
+puts "Creating Chrome Browser!"
+
+
+ENV['SELENIUM_BROWSER']='firefox'
+Browza::Manager.instance.createBrowser()
+
+
+puts "Navigate to playground"
+Browza::Manager.instance.navigate('https://stark-bastion-95510.herokuapp.com/playground')
+
+Browza::Manager.instance.click("//button[text()='Van Halen']")
+
+Browza::Manager.instance.highlight("//button[text()='Van Halen']", 'red')
+
+
+puts "PRESS ENTER to Continue .."
+STDIN.gets
+
+Browza::Manager.instance.quit()

data/examples/ex2.rb

@@ -0,0 +1,23 @@
+
+
+
+require_relative '../lib/browza'
+
+
+puts "Creating Chrome Browser!"
+
+
+Browza::Manager.instance.createBrowser(:chrome)
+Browza::Manager.instance.createBrowser(:chrome)
+
+
+puts "Navigate to playground"
+Browza::Manager.instance.navigate('https://stark-bastion-95510.herokuapp.com/playground')
+
+Browza::Manager.instance.click("//button[text()='Van Halen']")
+
+Browza::Manager.instance.highlight("//button[text()='Van Halen']", 'red')
+
+
+puts "PRESS ENTER to Continue .."
+STDIN.gets

data/examples/parms.rb

@@ -0,0 +1,45 @@
+
+
+
+def press(k, n=1)
+
+end
+
+def pressIt(*p)
+
+   puts "[pressIt]: length: #{p.length}   p => #{p}   0:#{p[0]}   1:#{p[1]}"
+
+end
+
+def foo(*p)
+
+
+  puts __FILE__ + (__LINE__).to_s + p.class.to_s
+
+  if p.is_a?(Array)
+
+    puts __FILE__ + (__LINE__).to_s + " SZ : #{p.size.to_s}"
+    i=0
+    p.each do |elt|
+      puts "   #{i}. #{elt.class} : #{elt.to_s}"
+    end
+  end
+
+end
+
+
+
+puts "START"
+
+foo(:chrome)
+
+foo( 100 )
+
+foo( {:name => 'Peter'}, {:age => 'ThritySix'})
+
+
+
+pressIt('one')
+
+
+pressIt('page(one)', 'tab')

data/lib/browza/base/browza_mgr.rb

@@ -0,0 +1,110 @@
+
+require 'logging'
+
+module Browza
+
+
+
+  class BrowzaMgr
+    attr_accessor :driverList
+
+
+    def initialize
+      @logger = Logging.logger(STDOUT)
+      @logger.level = :debug
+      @driverList = []
+    end
+
+    def clear
+      @driverList=[]
+    end
+
+    def getBrowsers()
+      @driverList
+    end
+
+    def add(device)
+
+      if !device.is_a?(Hash)
+        @driverList << { :is_sauce => false, :drv => device }
+      else
+        @driverList << device
+      end
+
+      @driverList.last
+    end
+
+    def set(id, prop, val)
+      get(id)[prop] = val
+
+    end
+
+    def get(id)
+      @driverList.each do |elt|
+        if elt.has_key?(:id) && elt[:id] == id
+          return elt
+        end
+      end
+
+      nil
+    end
+
+    def getDriver(id=nil)
+
+      if id.nil? && @driverList.length > 0
+        return @driverList.first
+      elsif @driverList.length > 0
+        @driverList.each do |b|
+          if b.has_key?(:id) && b[:id] == id
+            return b[:drv]
+          end
+        end
+      end
+
+      nil
+    end
+
+
+    def setSauceStatus(id, status)
+      @driverList.each do |b|
+        if b.has_key?(:id) && b[:id]==id
+          b[:status] = status
+        end
+      end
+    end
+
+
+    # Set innerWidth and innerHeight
+    def setDimension(width = 1035, height = 768)
+
+      begin
+        @driverList.each do |b|
+          target_size = Selenium::WebDriver::Dimension.new(width, height)
+          b[:drv].manage.window.size = target_size
+        end
+      rescue => ex
+        @logger.warn __FILE__ + (__LINE__).to_s + " #{ex.class}"
+        @logger.warn "Error during processing: #{$!}"
+        @logger.warn "Backtrace:\n\t#{ex.backtrace.join("\n\t")}"
+      end
+    end
+
+    def maximize()
+      begin
+        @driverList.each do |b|
+          target_size = Selenium::WebDriver::Dimension.new(width, height)
+          b[:drv].manage.window.maximize
+        end
+      rescue => ex
+        @logger.warn __FILE__ + (__LINE__).to_s + " #{ex.class}"
+        @logger.warn "Error during processing: #{$!}"
+        @logger.warn "Backtrace:\n\t#{ex.backtrace.join("\n\t")}"
+      end
+
+    end
+
+  end
+
+
+
+end