The document discusses RSpec and Capybara, which are the most popular and stable tools for web UI automation testing in Ruby. RSpec is a BDD framework that serves as a testing and assertion tool. Capybara is a web driver wrapper that allows automating interactions like visiting pages, filling forms, and clicking elements. The document provides examples of setting up RSpec and Capybara and matching common interactions and selectors.

1. Capybara + RSpec – Ruby DSL based
Web UI QA Automation
Иван Соболевский
DPI.Solutions
Issoft / Coherent Solutions

2. О себе
Иван Соболевский
• IT consultant
DPI.Solutions
• QA Automation Engineer
ISsoft / Coherent Solutions

3. Testing tools:
• Rspec (22M downloads from rubygems.org)
• Cucumber (7,5 M
https://rubygems.org/search?utf8=%E2%9C%9
3&query=Cucumber)
• TestUnit (2,6 M
https://rubygems.org/search?utf8=%E2%9C%9
3&query=test-unit)

4. Rspec is:
BDD framework:
• BDD Engine
• Test runner
• Assertion tool
• Output generator
• Mocking tool

5. Project structure example

6. Notes:
Rules:
1) spec_helper.rb – entry point
2) *_spec.rb – Test name
pattern
Must read:
http://betterspecs.org/
“rspec --init” command will create “spec_helper.rb”
and “.rspec”
.rspec file example:
--color
--require spec_helper
--format documentation
--format h --out report/index.html
spec_helper.rb – tests, tools, webdriver
Initialization; entry point

7. Reporting:
2) gem ‘allure-rspec’ or other
gems
3) Monkey patch – the way to override code.
Usually “support” directory contains patches.
If you you want to add something to default
rspec report – just patch it!
1) Using default rspec html-report

8. “Monkey patch” example:

9. WebDriver Ruby wrappers
• Capybara (10,9 M downloads from rubygems.org)
• Watir (0,4 M https://rubygems.org/search?utf8=%E2%9C%93&query=Watir)

10. Capybara is:
visit ‘/session/new'
fill_in('First Name', :with => 'John')
choose('A Radio Button')
check('A Checkbox')
require ‘capybara/rspec’
browser = ENV.fetch('BROWSER', :firefox).to_sym
Capybara.register_driver browser do |app|
Capybara::Selenium::Driver.new(app, :browser => browser)
end
Capybara.javascript_driver = browser
Capybara.current_driver= browser
Capybara.app_host = 'http://google.com'
Capybara.default_selector = :css
Capybara.default_wait_time = 5
WebDriver wrapper
Configuration (in spec_helper.rb):

11. Capybara features:
visit ‘/session/new'
fill_in('First Name', :with => 'John')
fill_in('Password', :with => 'Seekrit')
fill_in('Description', :with => 'Really Long Text...')
choose('A Radio Button')
check('A Checkbox')
uncheck('A Checkbox')
attach_file('Image', '/path/to/image.jpg')
select('Option', :from => 'Select Box')
first(:xpath, ‘//a').click
all(:xpath, ‘//a').last.click
accept_alert do
click_link('Show Alert')
end
WebDriver calls:
page.driver.execute_script(“js body”)
page.driver.browser.find_element(:xpath, “//div”)
page.driver.browser.manage.window.maximize

12. Capybara Rspec matchers
expect(page).to have_title(‘My title’)
expect(page).to have_content(‘My content’)
expect(page).to have_xpath(‘My xpath’)
expect(page).to have_css(‘My css’)
expect(page).to have_link(‘My link’)
expect(page).to have_field(‘My field’)
…

13. Useful links:
• https://github.com/jnicklas/capybara - General description
• http://www.rubydoc.info/github/jnicklas/capybara/Capybara/ -
Documentation

14. Summary:
Rspec + Capybara
The most:
-popular,
-functional,
-stable,
-supportable tools for automation on Ruby

15. Спасибо! Вопросы!
Иван Соболевский
DPI.Solutions
www.dpi.solutions
Belarus QA Automation
Community
www.comaqa.by