selenium-launcher 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 47064747dcd76f242df501b3316329097660ae37
-  data.tar.gz: caae88fe2c13bceeceb425264ba2a127febd0e50
+  metadata.gz: 60547600d5b222f4397bd73d87a84d2a55685675
+  data.tar.gz: 4cd1ece048ae683e5f7e7d493cde1c376fcaf7bb
 SHA512:
-  metadata.gz: c54ce10a41be5679d2d6346a1f437ad91aa32ffa723391e94a7f0482fb83c850f5a9c8ec09e0a58af396d03c7abe6bb587cbdf5228a51c216f494b6d0f7ccb74
-  data.tar.gz: 493f73d610c50b8873b1da8cdf17e5fbd1f55a408553533479ce4142a5245c513fb317de2ec0deea1f727d53d28ece4824dc769a5d6add54417838eae7288396
+  metadata.gz: a961633050e98d9700d8e33e4ab856a399966a88a8fb3388ff6f2a603f5255ca18d1712f87655c4cab1f13041ec1958ec24ec1012ddcb15831ec2c8eaa2d1d52
+  data.tar.gz: 96676a875187b351f944163f68a3b133f05af4b5c56cc95e5b004a1e36305b34ae402bc2270f8a3d45309a4ebb1f927115026751c3563e85a38f971dfdb52445

data/.gitignore

@@ -1,3 +1,4 @@
+*.swp
 /.bundle/
 /.yardoc
 /Gemfile.lock

data/Guardfile

@@ -1,4 +1,4 @@
 guard :rspec, cmd: 'bundle exec rspec' do
   watch(%r{^spec/*/.+_spec\.rb$})
-  watch(%r{^lib/selenium-connect/*/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^lib/selenium-launcher/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
 end

data/README.txt

@@ -4,42 +4,45 @@
 
 selenium-launcher provides a simple way to configure Selenium and launch a browser.
 
-Currently supported approachs include:
+Currently supported approaches include:
 1. Local browser execution with browser drivers (for easier test authoring)
 2. Remote execution (for a single node or a grid)
 
+NOTE: selenium-launcher will return a Selenium WebDriver object.
+
 == CONSIDERATIONS:
 
 + Will need to sort out the best way to handle browser driver downloads and configuration per OS. Will start by letting the user do the work and automate it later (in a separate gem).
 + Cloud execution will need to be added later, but that has additional considerations. So that will be deferred for now.
 + Mobile is also a consideration. Again, one to defer for now.
 
+== INSTALL:
+
+sudo gem install selenium-launcher
+
 == USAGE:
 
 === Environment Variables
 
 Configuration occurs through a small set of environment variables:
 
-SL_HOST (e.g., 'grid', or nothing)
-SL_HOST_URL (e.g., URL to Standalone Remote or Grid instance)
-SL_BROWSER (e.g., 'chrome', 'firefox', 'internet-explorer', 'safari')
+SE_HOST (e.g., 'grid', or nothing)
+SE_HOST_URL (e.g., URL to Standalone Remote or Grid instance)
+SE_BROWSER (e.g., 'chrome', 'firefox', 'internet-explorer', 'safari')
 
 If these values are not set properly, a RuntimeError will be returned along with a helpful message.
 
-
-selenium-launcher will return a Selenium WebDriver object.
-
 === Local
 
-ENV['SL_BROWSER'] = 'firefox'
+ENV['SE_BROWSER'] = 'firefox'
 driver = SeleniumLauncher.launch
 driver.quit
 
 === Grid
 
-ENV['SL_BROWSER'] = 'firefox'
-ENV['SL_HOST'] = 'grid'
-ENV['SL_HOST_URL'] = 'http://localhost:4444/wd/hub'
+ENV['SE_BROWSER'] = 'firefox'
+ENV['SE_HOST'] = 'grid'
+ENV['SE_HOST_URL'] = 'http://localhost:4444/wd/hub'
 driver = SeleniumLauncher.launch
 driver.quit
 

data/lib/selenium-launcher.rb

@@ -16,18 +16,18 @@ module SeleniumLauncher
 
     private
 
-      ERRORS = { NoBrowserSpecified: 'You need to specify a browser (e.g., SL_BROWSER).',
-                 NoGridURLSpecified: 'You need to specify a URL when using a Grid (e.g., SL_HOST_URL).' }
+      ERRORS = { NoBrowserSpecified: 'You need to specify a browser (e.g., SE_BROWSER).',
+                 NoGridURLSpecified: 'You need to specify a URL when using a Grid (e.g., SE_HOST_URL).' }
 
       def browser_check
-        if ENV['SL_BROWSER'].nil?
+        if ENV['SE_BROWSER'].nil?
           raise ERRORS[:NoBrowserSpecified]
         end
       end
 
       def grid_check
-        if ENV['SL_HOST'] == 'grid'
-          if ENV['SL_HOST_URL'].nil?
+        if ENV['SE_HOST'] == 'grid'
+          if ENV['SE_HOST_URL'].nil?
             raise ERRORS[:NoGridURLSpecified]
           end
         end

data/lib/selenium-launcher/browser.rb

@@ -9,7 +9,7 @@ module SeleniumLauncher
     attr_reader :name
 
     def match?
-      name == ENV['SL_BROWSER']
+      name == ENV['SE_BROWSER']
     end
 
     def capabilities

data/lib/selenium-launcher/launcher.rb

@@ -18,11 +18,11 @@ module SeleniumLauncher
     private
 
       def launch
-        case ENV['SL_HOST']
+        case ENV['SE_HOST']
         when 'grid'
           ::Selenium::WebDriver.for(
             :remote,
-            url: ENV['SL_HOST_URL'],
+            url: ENV['SE_HOST_URL'],
             desired_capabilities: browser.capabilities)
         else
           ::Selenium::WebDriver.for browser.name.to_sym

data/lib/selenium-launcher/version.rb

@@ -1,3 +1,3 @@
 module SeleniumLauncher
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

data/spec/browser_spec.rb

@@ -3,25 +3,25 @@ require_relative '../lib/selenium-launcher/browser'
 describe 'Browser returns', :unit do
 
   it 'Chrome' do
-    ENV['SL_BROWSER'] = 'chrome'
+    ENV['SE_BROWSER'] = 'chrome'
     browser = SeleniumLauncher::Browser.load
     expect(browser.class).to eql SeleniumLauncher::Browser::Chrome
   end
 
   it 'Firefox' do
-    ENV['SL_BROWSER'] = 'firefox'
+    ENV['SE_BROWSER'] = 'firefox'
     browser = SeleniumLauncher::Browser.load
     expect(browser.class).to eql SeleniumLauncher::Browser::Firefox
   end
 
   it 'Internet Explorer' do
-    ENV['SL_BROWSER'] = 'internet-explorer'
+    ENV['SE_BROWSER'] = 'internet-explorer'
     browser = SeleniumLauncher::Browser.load
     expect(browser.class).to eql SeleniumLauncher::Browser::InternetExplorer
   end
 
   it 'Safari' do
-    ENV['SL_BROWSER'] = 'safari'
+    ENV['SE_BROWSER'] = 'safari'
     browser = SeleniumLauncher::Browser.load
     expect(browser.class).to eql SeleniumLauncher::Browser::Safari
   end

data/spec/launcher_spec.rb

@@ -10,14 +10,14 @@ describe 'Launcher', :integration do
   context '-> Localhost -> ' do
 
     it 'Chrome' do
-      ENV['SL_BROWSER'] = 'chrome'
+      ENV['SE_BROWSER'] = 'chrome'
       @launcher = SeleniumLauncher::Launcher.new
       expect(@launcher.driver.class).to eql Selenium::WebDriver::Driver
       expect(@launcher.driver.browser).to eql :chrome
     end
 
     it 'Firefox' do
-      ENV['SL_BROWSER'] = 'firefox'
+      ENV['SE_BROWSER'] = 'firefox'
       @launcher = SeleniumLauncher::Launcher.new
       expect(@launcher.driver.class).to eql Selenium::WebDriver::Driver
       expect(@launcher.driver.browser).to eql :firefox
@@ -25,14 +25,14 @@ describe 'Launcher', :integration do
 
     it 'Internet Explorer' do
       pending 'Windows OS required' unless OS.windows?
-      ENV['SL_BROWSER'] = 'internet-explorer'
+      ENV['SE_BROWSER'] = 'internet-explorer'
       @launcher = SeleniumLauncher::Launcher.new
       expect(@launcher.driver.class).to eql Selenium::WebDriver::Driver
       expect(@launcher.driver.browser).to eql :"internet-explorer"
     end
 
     it 'Safari' do
-      ENV['SL_BROWSER'] = 'safari'
+      ENV['SE_BROWSER'] = 'safari'
       @launcher = SeleniumLauncher::Launcher.new
       expect(@launcher.driver.class).to eql Selenium::WebDriver::Driver
       expect(@launcher.driver.browser).to eql :safari
@@ -43,19 +43,21 @@ describe 'Launcher', :integration do
   context '-> Grid -> ' do
 
     before(:all) do
-      ENV['SL_HOST'] = 'grid'
-      ENV['SL_HOST_URL'] = 'http://localhost:4444/wd/hub'
+      ENV['SE_HOST'] = 'grid'
+      ENV['SE_HOST_URL'] = 'http://localhost:4444/wd/hub'
+      # Start Selenium Standalone Server
+      # For help downloading, see https://github.com/tourdedave/selenium-prep
     end
 
     it 'Chrome' do
-      ENV['SL_BROWSER'] = 'chrome'
+      ENV['SE_BROWSER'] = 'chrome'
       @launcher = SeleniumLauncher::Launcher.new
       expect(@launcher.driver.class).to eql Selenium::WebDriver::Driver
       expect(@launcher.driver.browser).to eql :chrome
     end
 
     it 'Firefox' do
-      ENV['SL_BROWSER'] = 'firefox'
+      ENV['SE_BROWSER'] = 'firefox'
       @launcher = SeleniumLauncher::Launcher.new
       expect(@launcher.driver.class).to eql Selenium::WebDriver::Driver
       expect(@launcher.driver.browser).to eql :firefox
@@ -63,14 +65,14 @@ describe 'Launcher', :integration do
 
     it 'Internet Explorer' do
       pending 'Windows OS required' unless OS.windows?
-      ENV['SL_BROWSER'] = 'internet-explorer'
+      ENV['SE_BROWSER'] = 'internet-explorer'
       @launcher = SeleniumLauncher::Launcher.new
       expect(@launcher.driver.class).to eql Selenium::WebDriver::Driver
       expect(@launcher.driver.browser).to eql :"internet-explorer"
     end
 
     it 'Safari' do
-      ENV['SL_BROWSER'] = 'safari'
+      ENV['SE_BROWSER'] = 'safari'
       @launcher = SeleniumLauncher::Launcher.new
       expect(@launcher.driver.class).to eql Selenium::WebDriver::Driver
       expect(@launcher.driver.browser).to eql :safari

data/spec/selenium-connect_spec.rb

@@ -3,7 +3,7 @@ require_relative '../lib/selenium-launcher'
 describe 'Selenium Launcher', :acceptance do
 
   it 'runs' do
-    ENV['SL_BROWSER'] = 'firefox'
+    ENV['SE_BROWSER'] = 'firefox'
     driver = SeleniumLauncher.launch
     expect(driver.class).to eql Selenium::WebDriver::Driver
     expect(driver.browser).to eql :firefox
@@ -13,23 +13,23 @@ describe 'Selenium Launcher', :acceptance do
   context '-> Config Checker -> ' do
 
     before(:each) do
-      ENV['SL_BROWSER'] = nil
-      ENV['SL_HOST'] = nil
-      ENV['SL_HOST_URL'] = nil
+      ENV['SE_BROWSER'] = nil
+      ENV['SE_HOST'] = nil
+      ENV['SE_HOST_URL'] = nil
     end
 
     it 'no browser' do
       expect { driver = SeleniumLauncher.launch }.to raise_error(
         RuntimeError,
-        'You need to specify a browser (e.g., SL_BROWSER).')
+        'You need to specify a browser (e.g., SE_BROWSER).')
     end
 
     it 'no Grid host URL' do
-      ENV['SL_BROWSER'] = 'firefox'
-      ENV['SL_HOST'] = 'grid'
+      ENV['SE_BROWSER'] = 'firefox'
+      ENV['SE_HOST'] = 'grid'
       expect { driver = SeleniumLauncher.launch }.to raise_error(
         RuntimeError,
-        'You need to specify a URL when using a Grid (e.g., SL_HOST_URL).')
+        'You need to specify a URL when using a Grid (e.g., SE_HOST_URL).')
     end
 
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: selenium-launcher
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Dave Haeffner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-11 00:00:00.000000000 Z
+date: 2014-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver