STORY DRIVEN
WEB DEVELOPMENT

MICHAEL KOUKOULLIS
PROGRAMMER

DESIGN
BUILD
WEB APPLICATIONS

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

CODE
RUBY
RAILS
CUCUMBER
HAPPY HAPPY SAD

WHAT I REALLY WANT?
WHY IT WORKS FOR US!

EVOLVING METHOD
DELIVERING BETTER SOFTWARE

ELEGANCE
ENJOYABLE
CREATIVE
STANDS ON ITS FEET

FOCUS. PEOPLE. TOOLS.

ON WITH THE SHOW
STORY DRIVEN DEVELOPMENT

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

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

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

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

DECLARATION OF INTENTION
NATURAL LANGUAGE
IMMENSELY POWERFUL

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

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

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

WORKFLOW
RUNNING THE STORY

FEATURE. RUNNER.

DEFINING. STEPS.

DEFINING. MODELS.

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

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

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

RERUNNING. FEATURE.

DEFINING. ROUTES.
ActionController::Routing::Routes.draw do |map|
map.home \"\", :controller => \"pages\", :action => \"home\"
map.resources :articles do |article|
article.resources :taggings
end
end

RERUNNING. FEATURE.

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

RERUNNING. FEATURE. SUCCESS!

JUST IN TIME
APP DEV
WORKFLOW

SHARED STEPS
REGEX
DRY IT UP

DRY IT UP. REGEX MATCHING.
Given /^an article exists with no tags$/ do
@article = Article.create!(:title => \"Beautiful Evidence\")
end
Given /^an article exists with one tag$/ do
@article = Article.create!(:title => \"Beautiful Evidence\")
@tag = Tag.create!(:name => \"visualisation\")
@tagging = @article.taggings.create!(:tag => @tag)
end

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

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

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

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

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

WHAT ABOUT VIEWS?
RESPONSE.SHOULD
WEBRAT

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

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

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'

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 \"tags\", :with => value
click_button \"submit\"
end
Then /^the article should be tagged with '(\\w+)'$/ do |value|
@article.tags.map(&:name).include?(value).should be_true
end

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

THANK
YOU

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