Webdrone

Yet another selenium webdriver wrapper, ruby version.

There is a groovy version available, at https://github.com/a0/a0-webdrone-groovy.

Installation

Add this line to your application's Gemfile:

gem 'webdrone'

And then execute:

$ bundle

Or install it yourself as:

$ gem install webdrone

Check for updates:

$ gem update webdrone

Usage

Create a browser:

require 'webdrone'

a0 = Webdrone.create timeout: 5
a0.open.url         'http://www.google.com/'
a0.quit

# or
Webdrone.create timeout: 5 do |a0|
  a0.open.url       'http://www.google.com/'
end

Take a screenshot:

a0.shot.screen        'login'        # saves to screenshot-0001-login.png
a0.shot.screen        'home'         # saves to screenshot-0002-home.png

Working with forms:

Webdrone.create do |a0|
  a0.open.url       'http://www.google.com/'
  a0.form.set         'q', 'A0::WebDrone'
  a0.form.submit
end


# or
a0.form.with_xpath '//label[contains(.,"%s")]/following-sibling::*/*[self::input | self::textarea | self::select]' do
  set               'label', 'value'
  xlsx              sheet: 'ejemplo'
end
a0.form.submit

Filling a form from an xlsx spreadsheet:

TODO

Config:

TODO

Saving screenshots and downloaded files to a directory:

a0 = Webdrone.create create_outdir: true
print a0.conf.outdir            # <= default is webdrone_output_%date%_%time%

a0.open.url     'http://www.google.cl/'
a0.form.set     'q', "Download sample file filetype:xls\n"
a0.shot.screen  'homepage'      # screenshot is saved in output directory
a0.clic.xpath   '//h3'          # xls file is saved in output directory

# or specify directory yourself
a0 = Webdrone.create outdir: '/tmp/evidences'
print a0.conf.outdir            # <= "/tmp/evidences"

Creating tabs and switching iframes:

a0.ctxt.create_tab
a0.open.url     'http:://example.com/'
a0.ctxt.with_frame 'iframe_name' do 
  a0.find.on  'Some link or button'
end

Getting text:

puts  a0.text.id        'some_id'
puts  a0.text.xpath     'some_xpath'

Verifying text and HTML attributes

a0.vrfy.id    'some_id', contains: 'SOME TEXT'
a0.vrfy.xpath 'some_xpath', eq: 'EXACT TEXT'
a0.vrfy.link  'link', attr: 'disabled', eq: 'true'
a0.vrfy.link  'link', attr: 'sample', contains: 'something'

Documentation

Docs can be found here.

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/a0/a0-webdrone-ruby.

License

The gem is available as open source under the terms of the MIT License.