A presentation delivered to the open source developer conference in Sydney, December 2008

1. STORY DRIVEN
WEB DEVELOPMENT

2. MICHAEL KOUKOULLIS
PROGRAMMER

4. DESIGN
BUILD
WEB APPLICATIONS

5. STYLE OF DEVELOPMENT
SET OF TOOLS
WE FIND USEFUL
STORY DRIVEN DEVELOPMENT

6. CODE
RUBY
RAILS
CUCUMBER
HAPPY HAPPY SAD

7. WHAT I REALLY WANT?
WHY IT WORKS FOR US!

8. EVOLVING METHOD
DELIVERING BETTER SOFTWARE

10. ELEGANCE
ENJOYABLE
CREATIVE
STANDS ON ITS FEET

11. FOCUS. PEOPLE. TOOLS.

12. ON WITH THE SHOW
STORY DRIVEN DEVELOPMENT

13. EXAMPLE. FEATURE.
Feature: Article tags
In order to work with article tags
As a site user
I want to both create and delete tags

14. EXAMPLE. FEATURE.
Scenario: Creating a tag
Given an article exists with no tags
When I submit a new tag for the article
Then the article should have one tag
And I am redirected to the article

15. EXAMPLE. FEATURE.
Scenario: Creating a tag
Given an article exists with no tags
When I submit a new tag for the article
Then the article should have one tag
And I am redirected to the article
Scenario: Deleting a tag
Given an article exists with one tag
When I delete the article tag
Then the article should have no tags
And I am redirected to the article

16. EXAMPLE. FEATURE.
Feature: Article tags
In order to work with article tags
As a site user
I want to both create and delete tags
Scenario: Creating a tag
Given an article exists with no tags
When I submit a new tag for the article
Then the article should have one tag
And I am redirected to the article
Scenario: Deleting a tag
Given an article exists with one tag
When I delete the article tag
Then the article should have no tags
And I am redirected to the article

17. DECLARATION OF INTENTION
NATURAL LANGUAGE
IMMENSELY POWERFUL

18. BEST THING YOU CAN DO AS A
PROGRAMMER?
CODE LESS.

19. EXAMPLE. FEATURE.
Feature: Article tags
In order to work with article tags
As a site user
I want to both create and delete tags
Scenario: Creating a tag
Given an article exists with no tags
When I submit a new tag for the article
Then the article should have one tag
And I am redirected to the article
Scenario: Deleting a tag
Given an article exists with one tag
When I delete the article tag
Then the article should have no tags
And I am redirected to the article

20. WRITE PROSE
AVOID GETTING PROGRAMMATIC
MAKE IT A ‘REAL’ STORY
ITS EXECUTABLE!

21. WORKFLOW
RUNNING THE STORY

22. FEATURE. RUNNER.

23. DEFINING. STEPS.

24. DEFINING. MODELS.

25. DEFINING. MODELS.
class Article < ActiveRecord::Base
has_many :taggings, :dependent => :destroy
has_many :tags, :through => :taggings
def add_tag(value)
new_tag = Tag.find_or_create_by_name(value)
unless Tagging.exists?(:article_id => self.id, :tag_id => new_tag)
taggings.create(:tag => new_tag)
end
end
end

26. DEFINING. MODELS.
class Article < ActiveRecord::Base
has_many :taggings, :dependent => :destroy
has_many :tags, :through => :taggings
def add_tag(value)
new_tag = Tag.find_or_create_by_name(value)
unless Tagging.exists?(:article_id => self.id, :tag_id => new_tag)
taggings.create(:tag => new_tag)
end
end
end
class Tagging < ActiveRecord::Base
belongs_to :tag
belongs_to :article
end

27. DEFINING. MODELS.
class Article < ActiveRecord::Base
has_many :taggings, :dependent => :destroy
has_many :tags, :through => :taggings
def add_tag(value)
new_tag = Tag.find_or_create_by_name(value)
unless Tagging.exists?(:article_id => self.id, :tag_id => new_tag)
taggings.create(:tag => new_tag)
end
end
end
class Tagging < ActiveRecord::Base
belongs_to :tag
belongs_to :article
end
class Tag < ActiveRecord::Base
has_many :taggings
end

28. RERUNNING. FEATURE.

29. DEFINING. ROUTES.
ActionController::Routing::Routes.draw do |map|
map.home quot;quot;, :controller => quot;pagesquot;, :action => quot;homequot;
map.resources :articles do |article|
article.resources :taggings
end
end

30. RERUNNING. FEATURE.

31. DEFINING. CONTROLERS.
class TaggingsController < ApplicationController
def create
article = Article.find(params[:article_id])
article.add_tag(params[:tags])
redirect_to article_path(article)
end
def destroy
article = Article.find(params[:article_id])
tagging = article.taggings.find(params[:id])
tagging.destroy
redirect_to article_path(article)
end
end

32. RERUNNING. FEATURE. SUCCESS!

33. JUST IN TIME
APP DEV
WORKFLOW

34. SHARED STEPS
REGEX
DRY IT UP

35. DRY IT UP. REGEX MATCHING.
Given /^an article exists with no tags$/ do
@article = Article.create!(:title => quot;Beautiful Evidencequot;)
end
Given /^an article exists with one tag$/ do
@article = Article.create!(:title => quot;Beautiful Evidencequot;)
@tag = Tag.create!(:name => quot;visualisationquot;)
@tagging = @article.taggings.create!(:tag => @tag)
end

36. DRY IT UP. REGEX MATCHING.
Given /^an article exists with no tags$/ do
@article = Article.create!(:title => quot;Beautiful Evidencequot;)
end
Given /^an article exists with one tag$/ do
@article = Article.create!(:title => quot;Beautiful Evidencequot;)
@tag = Tag.create!(:name => quot;visualisationquot;)
@tagging = @article.taggings.create!(:tag => @tag)
end
Given /^an article exists with (d+) tags$/ do |num|
@article = Article.create!(:title => quot;Beautiful Evidencequot;)
num.to_i.times do |num|
@tag = Tag.create!(:name => quot;random-tag-#{num}quot;)
@tagging = @article.taggings.create!(:tag => @tag)
end
end

37. DRY IT UP. REGEX MATCHING.
Then /^the article should have one tag$/ do
@article.taggings.length.should == 1
end
Then /^the article should have no tags$/ do
@article.taggings.length.should == 0
end

38. DRY IT UP. REGEX MATCHING.
Then /^the article should have one tag$/ do
@article.taggings.length.should == 1
end
Then /^the article should have no tags$/ do
@article.taggings.length.should == 0
end
Then /^the article should have (d+) tags$/ do |num|
@article.taggings.length.should == num.to_i
end

39. DRY IT UP. REGEX MATCHING.
Feature: Article tags
In order to work with article tags
As a site user
I want to both create and delete tags
Scenario: Creating a tag
Given an article exists with no tags
When I submit a new tag for the article
Then the article should have one tag
And I am redirected to the article
Scenario: Deleting a tag
Given an article exists with one tag
When I delete the article tag
Then the article should have no tags
And I am redirected to the article

40. DRY IT UP. REGEX MATCHING.
Given an article exists with 0 tags
Then the article should have 1 tags
Given an article exists with 1 tags
Then the article should have 0 tags

41. WHAT ABOUT VIEWS?
RESPONSE.SHOULD
WEBRAT

42. VIEWS. RESPONSE.SHOULD
Feature: Viewing an article
In order to read an article
As a site user
I want access the article
Scenario: Viewing an article
Given an article exists with 1 tags
When I view the article
Then I should see the page
And I should see the article title
And I should see the article tag

43. VIEWS. RESPONSE.SHOULD
When /^I view the article$/ do
get article_path(@article)
end
Then /^I should see the page$/ do
response.should be_success
end
Then /^I should see the article title$/ do
response.should include_text(@article.title)
end
Then /^I should see the article tag$/ do
response.should include_text(@tag.name)
end

44. VIEWS. WEBRAT
Scenario: Submitting the add tag form
Given an article exists with 0 tags
When I visit the article page
And I submit the tag form with 'edward'
Then I am redirected to the article
And the article should have 1 tags
And the article should be tagged with 'edward'

45. VIEWS. WEBRAT
Scenario: Submitting the add tag form
Given an article exists with 0 tags
When I visit the article page
And I submit the tag form with 'edward'
Then I am redirected to the article
And the article should have 1 tags
And the article should be tagged with 'edward'
When /^I visit the article page$/ do
visit article_path(@article)
end
When /^I submit the tag form with '(w+)'$/ do |value|
fill_in quot;tagsquot;, :with => value
click_button quot;submitquot;
end
Then /^the article should be tagged with '(w+)'$/ do |value|
@article.tags.map(&:name).include?(value).should be_true
end

46. STORY DRIVEN DEVELOPMENT
NATURAL LANGUAGE SPECS
ELEGANT
CHANCE TO CODE LESS
ENJOYABLE

47. THANK
YOU

48. MICHAEL KOUKOULLIS
twitter: kouky
email : m@agencyrainford.com