Integration Testing With Cucumber How To Test Anything J A O O 2009

Integration testing
with Cucumber:
How to test anything
Dr Nic Williams
mocra.com
drnicwilliams.com
@drnic

$ sudo gem install tweettail
$ tweettail jaoo -f

Ruby on Rails scenarios

Scenario: Login via OpenID
Given I am on the home page
And OpenID "http://drnicwilliams.com" maps to "Dr Nic"
When I follow "login"
And I fill-in "OpenID" with "http://drnicwilliams.com"
And I press "Login"
Then I should see "Welcome, Dr Nic"

Not just Rails
newgem - package + deploy RubyGems
tabtab - DSL for tab completions
choctop - package + deploy Cocoa apps

Scenario: Build a DMG with default custom DMG config
Given a Cocoa app with choctop installed called 'SampleApp'
When task 'rake dmg' is invoked
Then file 'appcast/build/SampleApp-0.1.0.dmg' is created

tweettail
$ sudo gem install tweettail
$ tweettail jaoo
mattnhodges: Come speak with me at JAOO next week - http://jaoo.dk/
Steve_Hayes: @VenessaP I think they went out for noodles. #jaoo
theRMK: Come speak with Matt at JAOO next week
drnic: reading my own abstract for JAOO presentation

New Gem in 2min
newgem tweet-tail
cd tweet-tail
script/generate executable tweettail
rake manifest
rake install_gem

Rakeﬁle
$hoe = Hoe.new('tweettail', TweetTail::VERSION) do |p|
p.developer('FIXME full name', 'FIXME email')
...
end

$hoe = Hoe.new('tweettail', TweetTail::VERSION) do |p|
p.developer('Dr Nic', 'drnicwilliams@gmail.com')
...
end

README.rdoc
= tweet-tail

* FIX (url)

= tweet-tail

* http://github.com/drnic/tweet-tail

New Gem in 2min
cont...
newgem tweet-tail
cd tweet-tail
script/generate executable tweettail
rake manifest
rake install_gem
tweettail
SUCCESS!! To update this executable,
look in lib/tweet-tail/cli.rb

User story
Feature: Live twitter search results
on the command line

In order to reduce cost of getting
live search results
As a twitter user

I want twitter search results
appearing in the console

Describe behaviour in plain text
Write a step deﬁnition in Ruby
Run and watch it fail
Fix code
Run and watch it pass!

Install cucumber

sudo gem install cucumber
script/generate install_cucumber
cp story_text features/command_line_app.feature

features/cli.feature
Feature: Live twitter search results on command line
In order to reduce cost of getting live search results
As a twitter user
I want twitter search results appearing in the console

Scenario: Display current search results
Given twitter has some search results for "jaoo"
When I run local executable "tweettail" with arguments "jaoo"
Then I should see
"""
mattnhodges: Come speak with me at JAOO next week...
Steve_Hayes: @VenessaP I think they went out for...
theRMK: Come speak with Matt at JAOO next week...
drnic: reading my own abstract for JAOO presentation...
"""

Running scenario
$ cucumber features/command_line_app.feature
...
1 scenario
2 skipped steps
1 undefined step

You can implement step definitions for missing steps
with these snippets:

Given /^twitter has some search results for "([^"]*)"$/ do |arg1|
pending
end

features/step_deﬁnitions/
twitter_data_steps.rb

Given /^twitter has some search results for "([^"]*)"$/ do |query|
FakeWeb.register_uri(
:get,
"http://search.twitter.com/search.json?q=#{query}",
:file => File.dirname(__FILE__) +
"/../fixtures/search-#{query}.json")
end


mkdir -p features/fixtures

curl http://search.twitter.com/search.json?q=jaoo >
features/fixtures/search-jaoo.json

features/ﬁxtures/search-jaoo.rb
{
"results": [
{
"text": "reading my own abstract for JAOO presentation",
"from_user": "drnic",
"id": 1666627310
},
{
"text": "Come speak with Matt at JAOO next week",
"from_user": "theRMK",
"id": 1666334207
},
{
"text": "@VenessaP I think they went out for noodles. #jaoo",
"from_user": "Steve_Hayes",
"id": 1666166639
},
{
"text": "Come speak with me at JAOO next week - http://jaoo.dk/",
"from_user": "mattnhodges",
"id": 1664823944,
}],
"refresh_url": "?since_id=1682666650&q=jaoo",
"results_per_page": 15,
"next_page": "?page=2&max_id=1682666650&q=jaoo"

features/common/env.rb

gem "fakeweb"
require "fakeweb"

Before do
FakeWeb.allow_net_connect = false
end

Running scenario
$ cucumber features/command_line_app.feature
...
Given a safe folder
And twitter has some search results for "jaoo"
Then I should see
"""
Steve_Hayes: @VenessaP I think they went out for noodles...
"""

1 scenario
1 failed step
3 passed steps

http://www.slideshare.net/bmabey/outsidein-development-with-cucumber

fetching JSON feed

def initial_json_data
Net::HTTP.get(URI.parse("http://search.twitter.com/search.json?q=#{query}"))
end

fakeweb failure?!
Given a safe folder
getaddrinfo: nodename nor servname provided, or not known
(SocketError)
from .../net/http.rb:564:in òpen'
...
from .../tweet-tail/lib/tweet-tail/tweet_poller.rb:24:in
ìnitial_json_data'
from .../tweet-tail/lib/tweet-tail/tweet_poller.rb:9:in `refresh'
from .../tweet-tail/lib/tweet-tail/cli.rb:39:in èxecute'
from .../tweet-tail/bin/tweet-tail:10
Then I dump stdout

common_steps.rb

When /^I run local executable "(.*)" with arguments "(.*)"/ do |exec, arguments|
@stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
executable = File.expand_path(File.join(File.dirname(__FILE__), "/../../bin", exec))
in_project_folder do
system "ruby #{executable} #{arguments} > #{@stdout}"
end
end

Can I ignore a
There’s probably always something
you can’t quite test
Minimise that layer of code
Test the rest

bin main lib

Can I ignore a
Test the rest

bin main lib
1x sanity check

Can I ignore a
Test the rest

bin main lib
1x sanity check
all other integration tests
on internal code

bin/tweettail

Do I ne ed to test this?
#!/usr/bin/env ruby
#
# Created on 2009-5-1 by Dr Nic Williams
# Copyright (c) 2009. All rights reserved.

require 'rubygems'
require File.expand_path(File.dirname(__FILE__) + "/../lib/tweet-tail")
require "tweet-tail/cli"

TweetTail::CLI.execute(STDOUT, ARGV)

...
Given twitter has some search results for 'jaoo'
When I run local executable 'tweettail' with arguments 'jaoo'
Then I should see
"""
theRMK: Come speak with Matt at JAOO next week...
drnic: reading my own abstract for JAOO presentation...
"""

...
Scenario: Display some search results
Given a safe folder
Then I should see some twitter messages

Scenario: Display explicit search results
Given a safe folder
When I run executable internally with arguments "jaoo"
Then I should see
"""
mattnhodges: Come speak with me at JAOO next week
Steve_Hayes: @VenessaP I think they went out for
"""

end result
$ rake install_gem
$ tweettail jaoo
JAOO: Linda R.: I used to be a mathematician - I couldn't very well have started...
bengeorge: Global Financial Crisises are cool: jaoo tix down to 250 for 2 days.
kflund: First day of work at the JAOO Tutorials in Sydney - visiting the Opera House
wa7son: To my Copenhagen Ruby or Java colleagues: Get to meet Ola Bini at JAOO Geek Nights
ldaley: I am going to JAOO... awesome.
jessechilcott: @smallkathryn it's an IT conference. http://jaoo.com.au/sydney-2009/ .
scotartt: Looking forward to JAOO Brisbane next week - http://jaoo.com.au/brisbane-2009/
scotartt: JAOO Brisbane 2009 http://ff.im/-2B5ja
gwillis: @tweval I would give #jaoo a 10.0
rowanb: Bags almost packed for Sydney. Scrum User Group then JAOO. Driving there
mattnhodges: busy rest of week ahead. Spking @ Wiki Wed. Atlassian booth babe @ JAOO
conference Syd Thurs & Fri. Kiama 4 Jase's wedding all w'end #fb
pcalcado: searching twiter for #jaoo first impressions.
kornys: #jaoo has been excellent so far - though my tutorials have been full of
Steve_Hayes: RT @martinjandrews: women in rails - provide child care at #railsconf
CaioProiete: Wish I could be at #JAOO Australia...

‘I run executable internally’ step
defn
When /^I run executable internally with arguments "(.*)"/ do |arguments|
require 'rubygems'
require File.dirname(__FILE__) + "/../../lib/tweet-tail"
require "tweet-tail/cli"

TweetTail::CLI.execute(@stdout_io = StringIO.new, arguments.split(" "))
@stdout_io.rewind
File.open(@stdout, "w") { |f| f << @stdout_io.read }
end
end

‘I should see...’
features/step_definitions/common_steps.rb
Then /Î should see$/ do |text|
actual_output = File.read(@stdout)
actual_output.should contain(text)
end

Then /Î should not see$/ do |text|
actual_output.should_not contain(text)
end

Then /Î should see exactly$/ do |text|
actual_output.should == text
end

‘When I do something...’

features/step_definitions/common_steps.rb
When /Î run project executable "(.*)" with arguments "(.*)"/ do |executable, args|
system "ruby #{executable} #{arguments} > #{@stdout}"
end
end

When /Î invoke task "rake (.*)"/ do |task|
@stdout = File.expand_path(File.join(@tmp_root, "tests.out"))
system "rake #{task} --trace > #{@stdout}"
end
end

‘Given a safe folder...’

features/support/env.rb
Before do
@tmp_root = File.dirname(__FILE__) + "/../../tmp"
@home_path = File.expand_path(File.join(@tmp_root, "home"))
FileUtils.rm_rf @tmp_root
FileUtils.mkdir_p @home_path
ENV["HOME"] = @home_path
end

tweettail jaoo -f

polling please?

how to test polling?

Scenario: Poll for results until app cancelled
When I run executable internally with arguments "jaoo -f"
Then I should see
"""
"""
When the sleep period has elapsed
Then I should see
"""
"""
When I press "Ctrl-C"
...

adding -f option
$ cucumber features/cli.feature:22
...
invalid option: -f (OptionParser::InvalidOption)

lib/tweet-tail/cli.rb
module TweetTail::CLI
def self.execute(stdout, arguments=[])
options = { :polling => false }
parser = OptionParser.new do |opts|
opts.on("-f", "Poll for new search results each 15 seconds."
) { |arg| options[:polling] = true }
opts.parse!(arguments)
end

app = TweetTail::TweetPoller.new(arguments.shift, options)
app.refresh
stdout.puts app.render_latest_results
end
end

features/ﬁxtures/
search-jaoo-

{
"results": [{
"text": "Wish I could be at #JAOO Australia...",
"from_user": "CaioProiete",
"id": 1711269079,
}],
"since_id": 1682666650,
"refresh_url": "?since_id=1711269079&q=jaoo",
"query": "jaoo"
}


Given /^twitter has some search results for "([^"]*)"$/ do |query|
:get,
"http://search.twitter.com/search.json?q=#{query}",
:file => File.expand_path(File.dirname(__FILE__) +
"/../fixtures/search-#{query}.json"))

since = "1682666650"
:get,
"http://search.twitter.com/search.json?since_id=#{since}&q=#{query}",
:file => File.expand_path(File.dirname(__FILE__) +
"/../fixtures/search-#{query}-since-#{since}.json"))
end

hmm, sleep...
...
Then I should see
"""
"""
When the sleep period has elapsed
Then I should see
"""
"""


and wait 1 sleep cycle and quit
Then I should see
"""
"""

features/step_deﬁnitions/executable_steps.rb
When /^I run executable internally with arguments "([^"]*)" and
wait (d+) sleep cycles? and quit$/ do |args, cycles|
hijack_sleep(cycles.to_i)
When %Q{I run executable internally with arguments "#{args}"}
end

features/support/time_machine_helpers.rb
module TimeMachineHelper
# expects sleep() to be called +cycles+ times, and then raises an Interrupt
def hijack_sleep(cycles)
results = [*1..cycles] # irrelevant truthy values for each sleep call
Kernel::stubs(:sleep).returns(*results).then.raises(Interrupt)
end
end
World(TimeMachineHelper)

using mocha
require "mocha"

World(Mocha::Standalone)

Before do
mocha_setup
end

After do
begin
mocha_verify
ensure
mocha_teardown
end
end

features/support/mocha.rb

working!
Feature: Live twitter search results on command line
In order to reduce cost of getting live search results
As a twitter user
I want twitter search results appearing in the console

When I run executable internally with arguments "jaoo -f" and wait 1 sleep cycle and
quit
Then I should see
"""
"""

1 scenario (1 passed)
3 steps (3 passed)

Rakeﬁle
task :default => [:features]

$ rake
(in /Users/drnic/Documents/ruby/gems/tweet-tail)
/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/bin/ruby -w -
Ilib:ext:bin:test -e 'require "rubygems"; require "test/unit"; require "test/
test_helper.rb"; require "test/test_tweet_poller.rb"'
Started
....
Finished in 0.002231 seconds.

4 tests, 10 assertions, 0 failures, 0 errors
/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/bin/ruby -I "/Library/
Ruby/Gems/1.8/gems/cucumber-0.3.2/lib:lib" ...
.................

5 scenarios (5 passed)
17 steps (17 passed)

Run unit tests + features

1. Create account with
http://runcoderun.com
2. Press ‘Test Hook’

Integration testing
with Cucumber:
How to test anything
Dr Nic Williams
mocra.com
drnicwilliams.com
twitter: @drnic
drnic@mocra.com

Integration Testing With Cucumber How To Test Anything J A O O 2009

Recomendados

Recomendados

Más contenido relacionado

La actualidad más candente

La actualidad más candente (20)

Destacado

Destacado (8)

Similar a Integration Testing With Cucumber How To Test Anything J A O O 2009

Similar a Integration Testing With Cucumber How To Test Anything J A O O 2009 (20)

Más de Dr Nic Williams

Más de Dr Nic Williams (9)

Último

Último (20)

Integration Testing With Cucumber How To Test Anything J A O O 2009

Notas del editor