0.06
The project is in a healthy, maintained state
Easy installation and use of geckodriver, that provides the HTTP API described by the WebDriver protocol to communicate with Gecko browsers, such as Firefox.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
 Dependencies

Development

~> 3.0
~> 10.0
~> 3.0

Runtime

 Project Readme

geckodriver-bin

Note: This is a maintained fork of the abandoned gem geckodriver-helper

Build status Gem Version

Easy installation and use of geckodriver, that provides the HTTP API described by the WebDriver protocol to communicate with Gecko browsers, such as Firefox.

Description

geckodriver-bin installs an executable, geckodriver, in your gem path.

This script will, if necessary, download the appropriate binary for your platform and install it into ~/.geckodriver-bin, then exec it.

Usage

If you're using Bundler and Capybara, it's as easy as:

# Gemfile
gem 'geckodriver-bin'

then, in spec/rails_helper.rb or spec/support/capybara.rb:

Capybara.register_driver :selenium do |app|
  options = ::Selenium::WebDriver::Firefox::Options.new
  # Uncomment line below to run firefox in headless mode
  # options.args << '--headless'

  Capybara::Selenium::Driver.new(app, browser: :firefox, options: options)
end

Updating Geckodriver

If you'd like to force-upgrade to the latest version of geckodriver, run the script gecko_updater

License

MIT licensed, see LICENSE.txt for full details.

Credit

This is a maintained fork of the gem geckodriver-helper.

The idea and some features comes from @flavorjones's project chromedriver-helper. That saves setup time and works pretty good from the box.