The document provides information on testing web applications using Capybara including: - Setting up Rack Session Access to manage user sessions in tests - Using multiple Capybara sessions to test interactions between users - Accessing the test server directly to make assertions - Saving screenshots when tests fail - Testing on multiple domains and subdomains - Running background processes like web servers during tests

1. http://www.thinknetica.com
RSpec & Friends 3:
Acceptance Testing with
Capybara
1

2. http://www.thinknetica.com
Rack Session Access
# Gemfile
group :test do
gem 'rack-session-access'
end
# config/environments/test.rb
config.middleware.use RackSessionAccess::Middleware
2

3. http://www.thinknetica.com
Rack Session Access
# spec/support/login_helper.rb
# Devise version
def sign_in(user)
page.set_rack_session(
'warden.user.user.key' =>
User.serialize_into_session(user).unshift("User")
)
end
# Sorcery version
def sign_in(user)
page.set_rack_session(user_id: user.id)
end
3

4. http://www.thinknetica.com
Multiple sessions
scenario "all users see new answer in real-time" do
Capybara.using_session('author') do
sign_in(user)
visit question_path(question)
end
Capybara.using_session('guest') do
visit question_path(question)
end
Capybara.using_session('author') do
page.find("#add_answer_btn").trigger('click')
within "#new_answer_form" do
fill_in 'Body', with: 'test text'
click_on 'Save'
end
expect(page).to have_content "Your answer has been successfully created"
expect(page).to have_content "test text"
end
Capybara.using_session('guest') do
expect(page).to have_content "test text"
end
end
4

5. http://www.thinknetica.com
Test server access
scenario "creates answer" do
page.find("#add_answer_btn").trigger('click')
within "#new_answer_form" do
fill_in 'Body', with: 'test text'
click_on 'Save'
end
visit_server
expect(page).to have_content "Your answer has been
successfully created"
expect(page).to have_content "test text"
end
5

6. http://www.thinknetica.com
Test server access
# spec/support/acceptance_helper.rb
def visit_server(user: nil, wait: 2, path: '/')
url = "http://#{Capybara.server_host}:#{Capybara.server_port}"
if user.present?
url += "/dev/log_in/#{user.id}?redirect_to=#{path}"
else
url += path
end
p "Visit server on: #{url}"
Launchy.open(url)
if wait == 0
p "Type any key to continue..."
$stdin.gets
p "Done."
else
sleep wait
end
end
6

7. http://www.thinknetica.com
Bonus #1
7
dev_log_in
https://github.com/divineforest/dev_log_in

8. http://www.thinknetica.com
Screenshot autosave
8
# spec/shared_context/shared_feature.rb
shared_context "feature", type: :feature do
after(:each) do |example|
next unless example.exception
meta = example.metadata
next unless meta[:js] == true
filename = File.basename(meta[:file_path])
line_number = meta[:line_number]
screenshot_name = "screenshot-#{filename}-
#{line_number}.png"
save_screenshot(screenshot_name) # rubocop:disable
Lint/Debugger
puts meta[:full_description] + "n Screenshot:
#{screenshot_name}"
end
end

9. http://www.thinknetica.com
Multiple hosts testing
9
# spec/acceptance_helper.rb
Capybara.server_host = "0.0.0.0"
Capybara.server_port = 3001
Capybara.always_include_port = true
config.before(:each, type: :feature) do
Capybara.app_host = "http://#{Capybara.server_host}.xip.io"
end

10. http://www.thinknetica.com
Multiple hosts testing
10
# spec/support/acceptance_helper.rb
def switch_subdomain(name = "dev")
host = "#{name}.#{Capybara.server_host}.xip.io"
Capybara.app_host = "http://#{host}"
end
def switch_hostname(host)
Capybara.app_host = "http://#{host}"
end

11. http://www.thinknetica.com
Bonus #2
11
http://xip.io
http://nip.io

12. http://www.thinknetica.com
Background Processes
12
# spec/bg_helper.rb
hive_pid = nil
puts "Starting background processes..."
rout, wout = IO.pipe
hive_pid = Process.spawn('hivemind Procfile.spec', out: wout)
Timeout.timeout(10) do
loop do
output = rout.readline
break if output =~ /Listening on tcp://localhost:9292/
end
end
puts "Background processes have been started."
at_exit do
puts "Stopping background processes..."
Process.kill 'INT', hive_pid
Process.wait hive_pid
puts "Background processes have been stopped."
end

13. http://www.thinknetica.com
Background Processes
13
# Procfile.spec
pp: bundle exec rackup private_pub.ru -s puma -E production
# spec/acceptance/some_spec.rb
require 'bg_helper' unless Nenv.skip_bg?
# when background is already running
SKIP_BG=1 bundle exec spec

14. http://www.thinknetica.com
Bonus #3
14
hivemind
https://github.com/DarthSim/hivemind
nenv
https://github.com/e2/nenv