Compare commits
3 Commits
master
...
rspec-cucu
Author | SHA1 | Date | |
---|---|---|---|
|
02b1e7553e | ||
|
5e205ea347 | ||
|
fdeb1b9eb5 |
42
README.md
42
README.md
@ -1,5 +1,3 @@
|
|||||||
# Persistent Selenium
|
|
||||||
|
|
||||||
Now you can keep that precious browser window open when doing continuous integration testing.
|
Now you can keep that precious browser window open when doing continuous integration testing.
|
||||||
Save seconds, and sanity, with every test re-run!
|
Save seconds, and sanity, with every test re-run!
|
||||||
|
|
||||||
@ -9,7 +7,7 @@ fix your tests and/or code.
|
|||||||
Start an instance:
|
Start an instance:
|
||||||
|
|
||||||
``` bash
|
``` bash
|
||||||
persistent_selenium [ --port 9854 ] [ --browser firefox ] [ --chrome-extensions <file.crx> ... ]
|
persistent_selenium [ --port 9854 ] [ --browser firefox ]
|
||||||
```
|
```
|
||||||
|
|
||||||
Tell Capybara to use it:
|
Tell Capybara to use it:
|
||||||
@ -38,45 +36,11 @@ these two differences:
|
|||||||
The browser's cache is disabled, and cookies are reset before the next test runs, so you still get the state
|
The browser's cache is disabled, and cookies are reset before the next test runs, so you still get the state
|
||||||
cleared out before your next set of tests.
|
cleared out before your next set of tests.
|
||||||
|
|
||||||
### .persistent_selenium
|
### Under the hood
|
||||||
|
|
||||||
Configure everything in your app with a `.persistent_selenium` file:
|
|
||||||
|
|
||||||
``` ruby
|
|
||||||
# .persistent_selenium
|
|
||||||
PersistentSelenium.configure do |c|
|
|
||||||
c.browser = :chrome
|
|
||||||
c.chrome_extensions = %w{AngularJS-Batarang.crx}
|
|
||||||
end
|
|
||||||
```
|
|
||||||
|
|
||||||
### Chrome Extensions
|
|
||||||
|
|
||||||
If, for example, you do a lot with AngularJS and want to use [Batarang](https://chrome.google.com/webstore/detail/angularjs-batarang/ighdmehidhipcmcojjgiloacoafjmpfk?hl=en),
|
|
||||||
download the extension, put it in your project's folder somewhere, and call `persistent_selenium` with the path
|
|
||||||
to the extension:
|
|
||||||
|
|
||||||
``` bash
|
|
||||||
persistent_selenium --browser chrome --chrome-extensions AngularJS-Batarang.crx
|
|
||||||
```
|
|
||||||
|
|
||||||
## Best practice
|
|
||||||
|
|
||||||
Use it with Foreman and Guard. Start up your test suite via Guard, configure your test suite to
|
|
||||||
use persistent_selenium, and run persistent_selenium alongside it:
|
|
||||||
|
|
||||||
``` yaml
|
|
||||||
guard: guard -g wip
|
|
||||||
ps: persistent_selenium
|
|
||||||
```
|
|
||||||
|
|
||||||
It's an integral part of my [integration testing setup](http://github.com/johnbintz/bintz-integration_testing_setup).
|
|
||||||
|
|
||||||
## Under the hood
|
|
||||||
|
|
||||||
It's DRb, which mostly Just Works (tm), and has a little reshuffling of the default Capybara Selenium driver's code.
|
It's DRb, which mostly Just Works (tm), and has a little reshuffling of the default Capybara Selenium driver's code.
|
||||||
|
|
||||||
### When DRb doesn't Just Work (tm)
|
#### When DRb doesn't Just Work (tm)
|
||||||
|
|
||||||
You're most likely using `all` and invoking an action on one of the nodes within, I'd wager. If you need to find a node
|
You're most likely using `all` and invoking an action on one of the nodes within, I'd wager. If you need to find a node
|
||||||
to perform an action on, it's best to stick with `find`, since it's less likely that node will go out of
|
to perform an action on, it's best to stick with `find`, since it's less likely that node will go out of
|
||||||
|
@ -2,10 +2,6 @@
|
|||||||
|
|
||||||
$: << File.expand_path('../../lib', __FILE__)
|
$: << File.expand_path('../../lib', __FILE__)
|
||||||
|
|
||||||
require 'persistent_selenium'
|
|
||||||
|
|
||||||
PersistentSelenium.load_dotfile
|
|
||||||
|
|
||||||
require 'persistent_selenium/cli'
|
require 'persistent_selenium/cli'
|
||||||
|
|
||||||
GC.disable
|
GC.disable
|
||||||
|
@ -3,7 +3,7 @@ require 'selenium-webdriver'
|
|||||||
|
|
||||||
module PersistentSelenium
|
module PersistentSelenium
|
||||||
class << self
|
class << self
|
||||||
attr_writer :port, :browser, :timeout, :chrome_extensions
|
attr_writer :port, :browser
|
||||||
|
|
||||||
def port
|
def port
|
||||||
@port ||= 9854
|
@port ||= 9854
|
||||||
@ -13,14 +13,6 @@ module PersistentSelenium
|
|||||||
@browser ||= :firefox
|
@browser ||= :firefox
|
||||||
end
|
end
|
||||||
|
|
||||||
def timeout
|
|
||||||
@timeout ||= 120
|
|
||||||
end
|
|
||||||
|
|
||||||
def chrome_extensions
|
|
||||||
@chrome_extensions ||= []
|
|
||||||
end
|
|
||||||
|
|
||||||
def url
|
def url
|
||||||
"druby://localhost:#{port}"
|
"druby://localhost:#{port}"
|
||||||
end
|
end
|
||||||
@ -28,11 +20,5 @@ module PersistentSelenium
|
|||||||
def configure
|
def configure
|
||||||
yield self
|
yield self
|
||||||
end
|
end
|
||||||
|
|
||||||
def load_dotfile(file = '.persistent_selenium')
|
|
||||||
if File.file?(file)
|
|
||||||
load file
|
|
||||||
end
|
|
||||||
end
|
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
@ -6,7 +6,6 @@ module PersistentSelenium
|
|||||||
class Browser < Capybara::Selenium::Driver
|
class Browser < Capybara::Selenium::Driver
|
||||||
def initialize(browser_type)
|
def initialize(browser_type)
|
||||||
@browser_type = browser_type.to_s.to_sym
|
@browser_type = browser_type.to_s.to_sym
|
||||||
@frame_handles = {}
|
|
||||||
@__found_elements__ = []
|
@__found_elements__ = []
|
||||||
end
|
end
|
||||||
|
|
||||||
@ -21,13 +20,7 @@ module PersistentSelenium
|
|||||||
|
|
||||||
options = { :profile => profile }
|
options = { :profile => profile }
|
||||||
when :chrome
|
when :chrome
|
||||||
switches = %w{--disk-cache-size=1 --media-cache-size=1}
|
options = { :switches => %w{--disk-cache-size=1 --media-cache-size=1} }
|
||||||
|
|
||||||
PersistentSelenium.chrome_extensions.each do |extension|
|
|
||||||
switches.push("--load-extension=#{extension}")
|
|
||||||
end
|
|
||||||
|
|
||||||
options = { switches: switches }
|
|
||||||
end
|
end
|
||||||
|
|
||||||
@browser ||= Selenium::WebDriver.for(@browser_type, options)
|
@browser ||= Selenium::WebDriver.for(@browser_type, options)
|
||||||
|
@ -10,19 +10,14 @@ module PersistentSelenium
|
|||||||
end
|
end
|
||||||
|
|
||||||
desc "start", "Start the server"
|
desc "start", "Start the server"
|
||||||
method_options :port => PersistentSelenium.port,
|
method_options :port => PersistentSelenium.port, :browser => PersistentSelenium.browser
|
||||||
:browser => PersistentSelenium.browser,
|
|
||||||
:timeout => PersistentSelenium.timeout
|
|
||||||
method_option :chrome_extensions, :type => :array, :default => []
|
|
||||||
def start
|
def start
|
||||||
require 'persistent_selenium/browser'
|
require 'persistent_selenium/browser'
|
||||||
require 'persistent_selenium/drb'
|
require 'drb'
|
||||||
|
|
||||||
PersistentSelenium.configure do |c|
|
PersistentSelenium.configure do |c|
|
||||||
c.port = options[:port]
|
c.port = options[:port]
|
||||||
c.browser = options[:browser] if options[:browser]
|
c.browser = options[:browser]
|
||||||
c.timeout = options[:timeout]
|
|
||||||
c.chrome_extensions = options[:chrome_extensions] if !options[:chrome_extensions].empty?
|
|
||||||
end
|
end
|
||||||
|
|
||||||
puts "Starting persistent_selenium on #{PersistentSelenium.port} with #{PersistentSelenium.browser}"
|
puts "Starting persistent_selenium on #{PersistentSelenium.port} with #{PersistentSelenium.browser}"
|
||||||
|
@ -1,17 +0,0 @@
|
|||||||
require 'drb'
|
|
||||||
|
|
||||||
module DRb
|
|
||||||
class DRbTCPSocket
|
|
||||||
alias :_set_sockopt :set_sockopt
|
|
||||||
|
|
||||||
def set_sockopt(soc)
|
|
||||||
_set_sockopt(soc)
|
|
||||||
|
|
||||||
optval = [ PersistentSelenium.timeout, 0 ].pack("l_2")
|
|
||||||
|
|
||||||
soc.setsockopt Socket::SOL_SOCKET, Socket::SO_RCVTIMEO, optval
|
|
||||||
soc.setsockopt Socket::SOL_SOCKET, Socket::SO_SNDTIMEO, optval
|
|
||||||
end
|
|
||||||
end
|
|
||||||
end
|
|
||||||
|
|
@ -1,12 +1,9 @@
|
|||||||
require 'persistent_selenium'
|
require 'persistent_selenium'
|
||||||
require 'persistent_selenium/browser'
|
|
||||||
require 'capybara/selenium/driver'
|
require 'capybara/selenium/driver'
|
||||||
|
|
||||||
# make sure these classes exist on this end
|
# make sure these classes exist on this end
|
||||||
[ Selenium::WebDriver::Error::StaleElementReferenceError, Selenium::WebDriver::Error::UnhandledError, Selenium::WebDriver::Error::ElementNotVisibleError ]
|
[ Selenium::WebDriver::Error::StaleElementReferenceError, Selenium::WebDriver::Error::UnhandledError, Selenium::WebDriver::Error::ElementNotVisibleError ]
|
||||||
|
|
||||||
require 'persistent_selenium/drb'
|
|
||||||
|
|
||||||
Capybara.register_driver :persistent_selenium do |app|
|
Capybara.register_driver :persistent_selenium do |app|
|
||||||
require 'drb'
|
require 'drb'
|
||||||
|
|
||||||
@ -19,7 +16,6 @@ Capybara.register_driver :persistent_selenium do |app|
|
|||||||
end
|
end
|
||||||
|
|
||||||
DRb.start_service
|
DRb.start_service
|
||||||
|
|
||||||
browser = DRbObject.new nil, PersistentSelenium.url
|
browser = DRbObject.new nil, PersistentSelenium.url
|
||||||
|
|
||||||
server = Capybara::Server.new(app)
|
server = Capybara::Server.new(app)
|
||||||
|
@ -1,3 +1,3 @@
|
|||||||
module PersistentSelenium
|
module PersistentSelenium
|
||||||
VERSION = "0.1.1"
|
VERSION = "0.0.2"
|
||||||
end
|
end
|
||||||
|
Loading…
Reference in New Issue
Block a user