selenium-connect 1.8.1 → 1.9.0

data/.gitignore

@@ -1,9 +1,12 @@
+*.gem
 *.lock
 *.swp
 profiles/
 *.jar
 *.gem
 *.rbc
+*.log
+*.out
 .bundle
 .config
 coverage

data/README.md

@@ -1,6 +1,6 @@
 #selenium-connect [![Code Climate](https://codeclimate.com/github/arrgyle/selenium-connect.png)](https://codeclimate.com/github/arrgyle/selenium-connect)
 
-A stupid simple way to run your Selenium tests on your computer, against a Selenium Grid, or in the cloud (e.g. SauceLabs).  
+A stupid simple way to run your Selenium tests on your computer, against a Selenium Grid, or in the cloud (e.g. SauceLabs).
 
 ## Getting Started
 ```ruby
@@ -14,21 +14,30 @@ end
 @driver = SeleniumConnect.start
 @driver.get "http://www.google.com"
 SeleniumConnect.finish
-```  
+```
 
 ## Helpful bits
 
-### Start  
-If host is set to "localhost", it will download the latest selenium-standalone-server.jar (unless it already has) and run it. Or, you can specify your own jar (if you have one you prefer to use). If no additional parameters are set, it will be exected in the background, with logging disabled. This functionality is driven using the [Selenium Rake Server Task](http://selenium.googlecode.com/svn/trunk/docs/api/rb/Selenium/Rake/ServerTask.html). 
+### Start
+If host is set to "localhost", it will download the latest selenium-standalone-server.jar (unless it already has) and run it. Or, you can specify your own jar (if you have one you prefer to use). If no additional parameters are set, it will be exected in the background, with logging disabled. This functionality is driven using the [Selenium Rake Server Task](http://selenium.googlecode.com/svn/trunk/docs/api/rb/Selenium/Rake/ServerTask.html).
 
-### Finish  
-Issues a quit command to the driver (and stops the local server if your host is set to "localhost").  
+### Finish
+Issues a quit command to the driver (and stops the local server if your host is set to "localhost").
 
-### Support  
+### Support
 - Firefox (standard, profile by path, profile by name, browser binary)
 - Internet Explorer
 - Chrome
 - SauceLabs
 
-### Versioning  
-This project follows [Semantic Versioning](http://semver.org/).
+## Contributing
+
+This project conforms to the [neverstopbuilding/craftsmanship](https://github.com/neverstopbuilding/craftsmanship) guidelines. Specifically related to the branching model and versioning. Please see the guidelines for details.
+
+### Install Dependencies
+
+    bundle install
+
+### Run the Tests
+
+    bundle exec rspec

data/Rakefile

@@ -0,0 +1,14 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+task :default => [:build]
+
+desc 'Runs standard build activities.'
+task :build => [:clean, :spec]
+
+desc 'Removes the build directory.'
+task :clean do
+  FileUtils.rm_rf('build');
+end
+
+RSpec::Core::RakeTask.new(:spec)

data/lib/selenium-connect/configuration.rb

@@ -12,6 +12,9 @@ module SeleniumConnect
     attr_accessor :sauce_username, :sauce_api_key,
                   :os, :browser_version, :description
 
+    #Logging
+    #attr_accessor :logs
+
     def config_file=(file)
       set_config_values_from_file(get_config_values_from_file(file))
     end

data/lib/selenium-connect/rake.task

@@ -5,5 +5,5 @@ require 'selenium/rake/server_task'
          t.background
          t.log = false
          t.port = 4444
-         t.opts = '-Dwebdriver.chrome.driver=/Users/more/Dropbox/_dev/Arrgyle/selenium-connect/lib/selenium-connect/../../bin/chromedriver'
+         
        end

data/lib/selenium-connect/runner.rb

@@ -1,6 +1,7 @@
 require 'selenium-connect/runners/firefox'
 require 'selenium-connect/runners/ie'
 require 'selenium-connect/runners/chrome'
+require 'selenium-connect/runners/phantomjs'
 require 'selenium-connect/runners/no_browser'
 require 'selenium-connect/runners/saucelabs'
 
@@ -39,9 +40,10 @@ module SeleniumConnect
       firefox     = Firefox.new(config)
       ie          = InternetExplorer.new(config)
       chrome      = Chrome.new(config)
+      phantomjs   = PhantomJS.new(config)
       no_browser  = NoBrowser.new(config)
 
-      browsers = [ firefox, ie, chrome, no_browser ]
+      browsers = [ firefox, ie, chrome, phantomjs, no_browser ]
     end
 
   end #Runner

data/lib/selenium-connect/runners/firefox.rb

@@ -22,12 +22,15 @@ module SeleniumConnect
           Selenium::WebDriver::Firefox::Profile.new config.profile_path
         elsif config.profile_name
           Selenium::WebDriver::Firefox::Profile.from_name config.profile_name
+        else
+          Selenium::WebDriver::Firefox::Profile.new
         end
       end
 
       def config_browser
         profile = get_profile
         profile.assume_untrusted_certificate_issuer = false unless profile.nil?
+        profile.log_file = File.join(config.log, 'firefox.log') if config.log
         browser = Selenium::WebDriver::Remote::Capabilities.firefox
         browser[:firefox_binary] = config.browser_path if config.browser_path
         browser[:firefox_profile] = profile

data/lib/selenium-connect/runners/phantomjs.rb

@@ -0,0 +1,38 @@
+module SeleniumConnect
+  class Runner
+    class PhantomJS
+      attr_reader :config
+
+      def initialize(config)
+        @config = config
+      end
+
+      def match?
+        config.browser == "phantomjs"
+      end
+
+      def launch
+        init_browser
+      end
+
+      private
+
+      def get_executable_path
+        current_dir_path = File.join(File.dirname(File.expand_path(__FILE__)))
+        current_dir_path + "/../../../bin/phantomjs"
+      end
+
+      def config_browser
+        executable_path = get_executable_path
+        browser = Selenium::WebDriver::Remote::Capabilities.phantomjs
+        browser['phantomjs.binary.path'] = executable_path
+        return browser
+      end
+
+      def init_browser
+        config_browser
+      end
+
+    end #Chrome
+  end #Runner
+end #SeleniumConnect

data/lib/selenium-connect/server.rb

@@ -8,7 +8,11 @@ module SeleniumConnect
     end
 
     def start
-      rake "start"
+#      if configuration.browser == 'ghostdriver'
+#        start_phantomjs
+#      else
+        rake "start"
+#      end
     end
 
     def stop
@@ -35,7 +39,7 @@ module SeleniumConnect
          t.background
          #{
           if configuration.log
-            "t.log = '#{configuration.log}'"
+            "t.log = '#{configuration.log}/server.log'"
           else
             "t.log = false"
           end
@@ -61,5 +65,9 @@ module SeleniumConnect
       system "rake -f #{get_rake_file} server:#{task}"
     end
 
+#    def start_phantomjs
+#      system "#{current_dir_path} + '/../../bin/phantomjs --webdriver=#{configuration.port}"
+#    end
+
   end #Server
 end #SeleniumConnect

data/selenium-connect.gemspec

@@ -1,12 +1,12 @@
 Gem::Specification.new do |s|
   s.name          = 'selenium-connect'
-  s.version       = '1.8.1'
+  s.version       = '1.9.0'
   s.platform      = Gem::Platform::RUBY
   s.authors       = ['Dave Haeffner']
   s.email         = ['dave@arrgyle.com']
   s.homepage      = 'https://github.com/arrgyle/selenium-connect'
   s.summary       = 'A stupid simple way to run your Selenium tests on localhost, against a Selenium Grid, or in the cloud (e.g. SauceLabs).'
-  s.description   = 'Locking in the sauce gem version to pre-version 3 since there are breaking changes that need to be tested.'
+  s.description   = 'Changed the log option so all you need to provide is a directory. The selenium log and browser specific logs will then show up there. Also added GhostDriver support.'
   s.license       = 'MIT'
 
   s.files         = `git ls-files`.split($/)

data/spec/acceptance/firefox_spec.rb

@@ -0,0 +1,60 @@
+require 'selenium-connect'
+require_relative 'helper'
+
+describe "Firefox" do
+
+  let(:google)  { Google.new(SeleniumConnect.start) }
+  let(:quit)    { SeleniumConnect.finish }
+
+  it "blank config" do
+    SeleniumConnect.configure do end
+    google.visit
+    google.page_title.should include("Google")
+    quit
+  end
+
+  it "localhost" do
+    SeleniumConnect.configure do |c|
+      c.host  = "localhost"
+    end
+    google.visit
+    google.page_title.should include("Google")
+    quit
+  end
+
+  it "local jar file specified" do
+    SeleniumConnect.configure do |c|
+      c.host  = "localhost"
+      c.jar   = "#{Dir.pwd}/selenium-server-standalone-2.33.0.jar"
+    end
+    google.visit
+    google.page_title.should include("Google")
+    quit
+  end
+
+  it "profile name" do
+    pending "requires machine setup to run, and need a public example"
+    SeleniumConnect.configure do |c|
+      c.profile_name  = "YourProfileNameGoesHere"
+    end
+  end
+
+  it "profile path" do
+    pending "need to add a profile to the repo"
+    SeleniumConnect.configure do |c|
+      c.profile_path  = "#{Dir.pwd}/path/to/profile"
+    end
+  end
+
+  it "browser path" do
+    #example only works on Mac
+    SeleniumConnect.configure do |c|
+      c.browser = "firefox"
+      c.browser_path = "/Applications/Firefox.app/Contents/MacOS/firefox"
+    end
+    google.visit
+    google.page_title.should include("Google")
+    quit
+  end
+
+end

data/spec/acceptance/headless_spec.rb

@@ -0,0 +1,27 @@
+require 'selenium-connect'
+require_relative 'helper'
+
+describe "Headless" do
+
+  let(:google)  { Google.new(SeleniumConnect.start) }
+  let(:quit)    { SeleniumConnect.finish }
+
+  it "should run a basic test with phantom js" do
+    SeleniumConnect.configure do |c|
+      c.browser = "phantomjs"
+    end
+    google.visit
+    google.page_title.should include("Google")
+    quit
+  end
+
+  it "should not find something on a page" do
+    SeleniumConnect.configure do |c|
+      c.browser = "phantomjs"
+    end
+    google.visit
+    google.page_title.should_not include("Poogle")
+    quit
+  end
+
+end

data/spec/acceptance/helper.rb

@@ -0,0 +1,15 @@
+class Google
+  attr_accessor :page
+
+  def initialize(driver)
+    @page = driver
+  end
+
+  def visit
+    page.get "http://www.google.com"
+  end
+
+  def page_title
+    page.title
+  end
+end

data/spec/acceptance/ie_spec.rb

@@ -0,0 +1,19 @@
+require 'selenium-connect'
+require_relative 'helper'
+
+describe "IE" do
+
+  let(:google)  { Google.new(SeleniumConnect.start) }
+  let(:quit)    { SeleniumConnect.finish }
+
+  it "with Selenium Grid" do
+    pending
+    SeleniumConnect.configure do |c|
+      c.host = "192.168.1.139"
+      c.browser = "ie"
+    end
+    driver.get 'https://mashup.ic.mantech.com/ispace'
+    quit
+  end
+end
+

data/spec/acceptance/logging_spec.rb

@@ -0,0 +1,24 @@
+require 'selenium-connect'
+require_relative 'helper'
+
+describe "Logging" do
+  let(:google)    { Google.new(SeleniumConnect.start) }
+  let(:logs_dir)  { File.join(Dir.pwd, 'build') }
+
+  it "logging" do
+    SeleniumConnect.configure do |c|
+      c.log = logs_dir
+    end
+
+    google.visit
+    SeleniumConnect.finish
+
+    server_log = File.read(logs_dir+'/server.log')
+    server_log.empty?.should be false
+
+    browser_log = File.read(logs_dir+'/firefox.log')
+    browser_log.empty?.should be false
+
+#    File.delete('runner.out')
+  end
+end

data/spec/runners/phantomjs_spec.rb

@@ -0,0 +1,26 @@
+require 'selenium-connect/configuration'
+require 'selenium-connect/runners/phantomjs'
+require 'selenium-webdriver'
+
+describe "phantomjs runner" do
+  it "should match against phantomjs if configured as such" do
+    config = SeleniumConnect::Configuration.new
+    config.browser = 'phantomjs'
+    runner = SeleniumConnect::Runner::PhantomJS.new(config)
+    runner.match?.should be_true
+  end
+
+  it "should not match if there is a different browser specified" do
+    config = SeleniumConnect::Configuration.new
+    config.browser = 'chrome'
+    runner = SeleniumConnect::Runner::PhantomJS.new(config)
+    runner.match?.should be_false
+  end
+
+  it "should return a browser capabilities object for the browser on launch" do
+    config = SeleniumConnect::Configuration.new
+    config.browser = 'phantomjs'
+    runner = SeleniumConnect::Runner::PhantomJS.new(config)
+    runner.launch.is_a?(Selenium::WebDriver::Remote::Capabilities).should be true
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: selenium-connect
 version: !ruby/object:Gem::Version
-  version: 1.8.1
+  version: 1.9.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-09 00:00:00.000000000 Z
+date: 2013-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -75,8 +75,9 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: Locking in the sauce gem version to pre-version 3 since there are breaking
-  changes that need to be tested.
+description: Changed the log option so all you need to provide is a directory. The
+  selenium log and browser specific logs will then show up there. Also added GhostDriver
+  support.
 email:
 - dave@arrgyle.com
 executables: []
@@ -85,10 +86,13 @@ extra_rdoc_files: []
 files:
 - .gitignore
 - .rvmrc
+- CHANGELOG.md
 - Gemfile
 - README.md
+- Rakefile
 - bin/chromedriver
-- chromedriver.log
+- bin/phantomjs
+- build/.gitkeep
 - lib/selenium-connect.rb
 - lib/selenium-connect/configuration.rb
 - lib/selenium-connect/rake.task
@@ -97,11 +101,17 @@ files:
 - lib/selenium-connect/runners/firefox.rb
 - lib/selenium-connect/runners/ie.rb
 - lib/selenium-connect/runners/no_browser.rb
+- lib/selenium-connect/runners/phantomjs.rb
 - lib/selenium-connect/runners/saucelabs.rb
 - lib/selenium-connect/server.rb
 - selenium-connect.gemspec
-- spec/acceptance_spec.rb
+- spec/acceptance/firefox_spec.rb
+- spec/acceptance/headless_spec.rb
+- spec/acceptance/helper.rb
+- spec/acceptance/ie_spec.rb
+- spec/acceptance/logging_spec.rb
 - spec/example.yaml
+- spec/runners/phantomjs_spec.rb
 - spec/sauce_spec.rb
 - spec/yaml_spec.rb
 homepage: https://github.com/arrgyle/selenium-connect

data/chromedriver.log

@@ -1,56 +0,0 @@
-[0.001][INFO]:      ChromeDriver 26.0.1383.0 /Users/more/Dropbox/_dev/Arrgyle/selenium-connect/bin/chromedriver
-[1.019][FINE]:      Initializing session with capabilities {
-   "browserName": "chrome",
-   "cssSelectorsEnabled": true,
-   "javascriptEnabled": true,
-   "nativeEvents": false,
-   "platform": "ANY",
-   "rotatable": false,
-   "takesScreenshot": false,
-   "version": ""
-}
-
-[1.019][INFO]:      Launching chrome: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome --disable-hang-monitor --disable-prompt-on-repost --dom-automation --full-memory-crash-report --no-default-browser-check --no-first-run --disable-background-networking --disable-sync --disable-translate --disable-web-resources --safebrowsing-disable-auto-update --safebrowsing-disable-download-protection --disable-client-side-phishing-detection --disable-component-update --disable-default-apps --enable-logging --log-level=1 --use-mock-keychain --ignore-certificate-errors about:blank
-[2.960][INFO]:      Connected to Chrome successfully. Version: 27.0.1453.93
-[3.044][FINE]:      Command received (/session/d84d6ebf341008c58eee63695f329969)
-[3.045][FINE]:      Command finished (/session/d84d6ebf341008c58eee63695f329969) with response {
-   "sessionId": "d84d6ebf341008c58eee63695f329969",
-   "status": 0,
-   "value": {
-      "acceptSslCerts": false,
-      "applicationCacheEnabled": false,
-      "browserConnectionEnabled": false,
-      "browserName": "chrome",
-      "chrome.chromedriverVersion": "26.0.1383.0",
-      "cssSelectorsEnabled": true,
-      "databaseEnabled": false,
-      "handlesAlerts": true,
-      "javascriptEnabled": true,
-      "locationContextEnabled": false,
-      "nativeEvents": true,
-      "platform": "mac",
-      "rotatable": false,
-      "takesScreenshot": true,
-      "version": "27.0.1453.93",
-      "webStorageEnabled": true
-   }
-}
-
-[3.338][FINE]:      Command received (/session/d84d6ebf341008c58eee63695f329969/url) with params {
-   "url": "http://google.com"
-}
-
-[3.338][FINER]:     Waiting for all views to stop loading...
-[3.339][FINER]:     Done waiting for all views to stop loading
-[3.997][FINER]:     Waiting for all views to stop loading...
-[3.999][FINER]:     Done waiting for all views to stop loading
-[3.999][FINE]:      Command finished (/session/d84d6ebf341008c58eee63695f329969/url) with response {
-   "sessionId": "d84d6ebf341008c58eee63695f329969",
-   "status": 0,
-   "value": {
-
-   }
-}
-
-[4.011][FINE]:      Command received (/session/d84d6ebf341008c58eee63695f329969)
-[4.156][INFO]:      Chrome shutdown

data/spec/acceptance_spec.rb

@@ -1,109 +0,0 @@
-require 'selenium-connect'
-
-describe "Acceptance Tests" do
-
-  let(:google)  { Google.new(SeleniumConnect.start) }
-  let(:driver)  { SeleniumConnect.start }
-  let(:quit)    { SeleniumConnect.finish }
-
-  context "Common" do
-    it "logging" do
-      SeleniumConnect.configure do |c|
-        c.log = "#{Dir.pwd}/runner.out"
-      end
-      google.visit
-      SeleniumConnect.finish
-      log = File.read('runner.out')
-      log.empty?.should == false
-      File.delete('runner.out')
-    end
-  end
-
-  context "Firefox" do
-    it "blank config" do
-      SeleniumConnect.configure do end
-      google.visit
-      google.page_title.should include("Google")
-      quit
-    end
-
-    it "localhost" do
-      SeleniumConnect.configure do |c|
-        c.host  = "localhost"
-      end
-      google.visit
-      google.page_title.should include("Google")
-      quit
-    end
-
-    it "local jar file" do
-      SeleniumConnect.configure do |c|
-        c.host  = "localhost"
-        c.jar   = "#{Dir.pwd}/selenium-server-standalone-2.32.0.jar"
-      end
-      google.visit
-      google.page_title.should include("Google")
-      quit
-    end
-
-    it "profile name" do
-      pending "requires machine setup to run, and need a public example"
-      SeleniumConnect.configure do |c|
-        c.profile_name  = "YourProfileNameGoesHere"
-      end
-    end
-
-    it "profile path" do
-      pending "need to add a profile to the repo"
-      SeleniumConnect.configure do |c|
-        c.profile_path  = "#{Dir.pwd}/path/to/profile"
-      end
-    end
-
-    it "browser path" do
-      #only works with Firefox
-      SeleniumConnect.configure do |c|
-        c.host  = "localhost"
-        c.jar   = "#{Dir.pwd}/selenium-server-standalone-2.32.0.jar"
-        c.browser = "firefox"
-        c.browser_path = "/Applications/Firefox.app/Contents/MacOS/firefox"
-      end
-      google.visit
-      google.page_title.should include("Google")
-      quit
-    end
-
-  end #Context//Firefox
-
-  context "IE" do
-
-    it "grid" do
-      pending
-      SeleniumConnect.configure do |c|
-#        c.host = "at-xp1.dodiis-aspace.local"
-        c.host = "192.168.1.139"
-        c.browser = "ie"
-      end
-      driver.get 'https://mashup.ic.mantech.com/ispace'
-      quit
-    end
-
-  end #Context//IE
-
-end #Describe
-
-class Google
-  attr_accessor :page
-
-  def initialize(driver)
-    @page = driver
-  end
-
-  def visit
-    page.get "http://www.google.com"
-  end
-
-  def page_title
-    page.title
-  end
-end