Einführung in Cucumber mit Rails

Cucumber
Hussein Morsy und Tanja Otto

30.06.2009
Heinrich-Heine-Universität Düsseldorf
Rails User Group Düsseldorf

Über uns

• internes Entwicklerteam von Sales-Lentz
• IBEs für Reisen, Bustickets, Eventtickets
• seit 2006 entwickeln wir mit Ruby on Rails
• Buch Ruby on Rails 2 Galileo Press
http://www.railsbuch.de

Wer setzt Cucumber in
seinen Projekten ein?

Aufbau
• Philosophie
• Cucumber Features erstellen
• Cucumber Features automatisieren
• Tabellen, Outlines und weitere Helferleins
• Cucumber installieren und konﬁgurieren
• Demo

Was ist TDD
• Hauptmerkmal: Test First
• Von Innen nach Aussen
• Red => Green => Refactor
“Make it green than make it clean”
• TDD ist kein Test-Tool, sondern eine
Technik für Entwickler

Units

Views Views Views Views

Controller Controller Controller

Model Model Model Model Model

TDD-Tools

• Unit-Test-Frameworks in Ruby
• Test::Unit
• Shoulda
• RSpec
• ...

Ziel von BDD

writing software that matters

Was ist BDD

• BDD ist kein Ersatz für TDD
• TDD ist ein Bestandteil von BDD
• BDD bedeutet outside-in Entwicklung
• Wie ein User mit der App arbeiten möchte
beeinﬂusst die Implementierung
• Kundenwünsche stehen an erster Stelle

Outside-In

Views Views Views Views

Controller Controller Controller

Model Model Model Model Model

Planung
• Beschreibung der Features bzw.
Akzeptanzkritieren
• Beschreibung einer Story aus
Anwendersicht
• Zusammen mit dem Kunden
• Business Value steht an erster Stelle
• Wenn Kritieren erfüllt => Akzeptiert

Merkmale

• Beschreibung der Features/
Akzeptanzkriterien in Prosaform
• Automatisiertes ausführen der Features
• Unterstützung von mehreren Sprachen
• Nicht nur für Rails (Java, .Net, Erlang, ... )

Aufbau von Features

• Titel & Kurzbeschreibung
• Ein oder mehrere Szenarien (die die
Akzeptanzkriterien darstellen)

Feature: Booking
As a Customer
I want to book a travel
So that I can spend my holidays with Sales-Lentz

Scenario:....

Feature: Booking
As a .... (Role)
I want to .... (Action)
So that ... (Buisniss value/ Outcome)

Scenario: booking a Travel
Given a travel “Rhein in Flammen” for 137.40
When I go to the detail page of Rhein in Flammen
When I follow "buchen"
When I select "Herr" from "Anrede"
When I ﬁll in "Nachname" with "Mustermann"
When I ﬁll in "E-Mail" with "hans@mustermann.de"
When I check "Versicherung"
When I press "buchen"
Then I should see "Ihre Buchung"
Then I should see "Herr"
Then I should see "Mustermann"
Then I should see "hans@mustermann.de"
Then I should see "137,40 EUR"
Then I should not see "Ausgebucht"

When I go to the detail page of Rhein in Flammen
And I follow "buchen"
And I select "Herr" from "Anrede"
And I ﬁll in "Nachname" with "Mustermann"
And I ﬁll in "E-Mail" with "hans@mustermann.de"
And I check "Versicherung"
And I press "buchen"
And I should see "Herr"
And I should see "Mustermann"
And I should see "hans@mustermann.de"
And I should see "137,40 EUR"
But I should not see "Ausgebucht"

Aufbau eines Szenarios

• Titel (Scenario:)
• Steps
• Vorbedingungen (Given)
• Aktionen (When)
• Erwartungen (Then)

Feature: Administrationsbereich
Als ein angemeldeter Administrator
Möchte ich die Admin-Seiten besuchen
So dass ich die Seiten leicht aktualisieren kann.

Szenario: Zugang für Admin-Seite beschränken
Gegeben sei ein Admin-User
Wenn ich nicht eingelogged bin
Und ich die Admin-Seite besuche
Dann sollte mir der Zugang verweigert werden

Szenario: Zugang für für autorisierten User
Gegeben sei ein Admin-User
Und ich bin eingelogged als Admin-User
Wenn ich die Admin-Seite besuche
Dann sollte ich "Admin-Bereich" sehen

Automatisieren von
Features

Ziel

Automatisiertes ausführen der Features
auf der Applikation
wie in einem Webbrowser

Step-Deﬁnition

Ruby Code, der die Steps in den Szenarien
ausführbar macht

Given-Step mit Definition

Step

Step-Definition
Given /â travel "([^"]*)" for ([0-9.]*)$/ do |title, price|
Travel.create(:title => title, :price => price.to_f)
end

Given Step-Deﬁnition

• Hier werden meist die Daten vorbereitet
• Implementierung meist mit ActiveRecord
end

When-Step mit Definition

Step
When I press “buchen”

Step-Definition
When /Î press "([^"]*)"$/ do |button|
click_button(button)
end

When Step-Deﬁnition

• Hier ﬁndet die Interaktion statt
• Simulation des Browsers
• Implementierung z.B. mit Webrat
end

Then-Step mit Definition

Step

Step-Definition
Then /Î should see "([^"]*)"$/ do |text|
response.should contain(text)
end

Then Step-Deﬁnition

• Hier wird geprüft, ob eine bestimmte
Zeichenkette in der Ausgabe vorkommt
• Implementierung z.B. mit RSpec
end

features/step_definitions/booking_steps.rb
end

end

When /Î fill in "([^"]*)" with "([^"]*)"$/ do |field, value|
fill_in(field, :with => value)
end

end

Techniken zur Step-
Deﬁnition
• Direct Model Access (z.B. mit
ActiveRecord)
• Simulated Browser (Webrat)
• Automated Browser (Selenium)
• RSpec-Befehle

Webrat
• Simuliert Browser
• DSL zum steuern des Browsers
• Webrat kann auch ohne Cucumber
eingesetzt werden (z.B. RSpec, Test::Unit,...)
• Schnell
• kein JavaScript

visit home_path

click_link "Sign up"

ﬁll_in "Email", :with => "good@example.com"

select "Free account"

click_button "Register"

Selenium

• Wird im Firefox-Browser ausgeführt
• Führt JavaScript aus
• Langsam

Tabellen, Outlines und
weitere Helferleins

Ohne Tabellen
Given a travel “New York” for 2137.40
And a travel “San Francisco” for 2137.40
And a travel “Las Vegas” for 1134.40
And a travel “Dubai” for 3135.40
And a travel “London” for 637.40
And a travel “Berlin” for 337.40
And a travel “Hamburg” for 437.40
And a travel “München” for 1137.40
...

Mit Tabellen
Given the following travels
| title | price |
| New York | 2137.40 |
| San Francisco | 2137.40 |
| Las Vegas | 1134.40 |
| Dubai | 3135.40 |
| London | 637.40 |
| Berlin | 337.40 |
| Hamburg | 437.40 |
| München | 1137.40 |

Step Deﬁnition
Given /^the following travels$/ do |travels|
Travel.create(travels.hashes)
end

travels.class == Cucumber::Ast::Table
travels.hashes ==
[
{:title => “New York”, :price => 2137.40},
{:title => “San Francisco”, :price => 2137.40},
]

Ohne Background
....
Scenario: booking a Travel for less than 2000
....

Ohne Scenario Outline
Scenario: login with correct user/password
Given a User “hans” with password “geheim”
When I visit the login-page
And I fill in “username” with “hans”
And I fill in “password” with “geheim”
Then I should see “Login erfolgreich”

Scenario: login with wrong password
And I fill in “username” with “hans”
And I fill in “password” with “blub”
Then I should see “Login fehlgeschlagen”

@iteration2
....
....

Aufruf

# Alle Szenarien ausführen mit dem Tag “iteration2”
cucumber - - tags iteration2 features/booking.feature

# Alle Szenarien ausführen ohne den Tag “iteration2”
cucumber - - tags ~iteration2 features/booking.feature

Cucumber installieren
und konﬁgurieren

Installation
Gems installieren:
[sudo] gem install rspec rspec-rails cucumber webrat

Verzeichnisse und Konﬁgurationsdateien generieren
script/generate cucumber

Ausführen von Cucumber
Alle Features ausführen (mit rake)
rake features

Alle Features ausführen (ohne rake)
cucumber features # vorher ggf. rake db:test:prepare

Einzelnes Feature ausführen:
cucumber features/booking.feature

Einzelnes Szenario ausführen:
cucumber features/booking.feature:24

Sites

• Homepage: http://cukes.info/
• Linksammlung: http://delicious.com/mucki/
cucumber

Session & Screencasts
• Railscast.com
• http://railscasts.com/episodes/156-webrat
• http://railscasts.com/episodes/155-
beginning-with-cucumber
• http://railscasts.com/episodes/159-more-on-
cucumber
• ...

Literatur
The RSpec Book:
http://www.pragprog.com

Download der
Präsentation
http://devteam.sales-lentz.lu

Follow us on twitter:
https://twitter.com/HusseinMorsy
https://twitter.com/ajnato

Einführung in Cucumber mit Rails

Recommandé

Recommandé

Contenu connexe

En vedette

En vedette (20)

Einführung in Cucumber mit Rails