• Persistence
  • MongoMapper
  • Validatable (overwritten by: johnwyles/validatable)
• Authentication and Authorization
  • Devise
  • CanCan
  • AASM (overwritten by: johnwyles/aasm)
  • AASM::StatefulResource (included in: lib/aasm/stateful_resource.rb)
• Display
  • HAML
  • Compass
  • Formtastic
  • will_paginate
• Testing
  • Cucumber
  • Capybara
  • Culerity
  • rSpec
  • factory_girl
  • database_cleaner
• Configuration
  • AppConfig (included in: config/initializers/00_appconfig.rb)
  • i18n (included in: config/initializers/01_locales.rb)

AppConfig is a short little initializer with OpenStruct that reads a YAML file and loads various application specific settings (e.g. Application Name, Session Secret, Domain, etc.).

To install simply perform:

# Installation of kog
sudo gem install kog

Using kog is very simple as illustrated below:

require 'rubygems'
require 'kog'

# Parse a resource and getting the resource
obj = OpenGraph::Parser.parse('http://www.rottentomatoes.com/m/office_space/')
puts obj.class # => OpenGraph::Object

# The object
puts obj.inspect # => #<OpenGraph::Object:0x101b01060 @image="http://images.rottentomatoes.com/images/movie/custom/aa/1087856aa.jpg", @title="Office Space", @url="http://www.rottentomatoes.com/m/office_space/", @site_name="Rotten Tomatoes", @type="movie">

# Accessors
puts obj.type # => movie
puts obj.type?('movie').inspect # => true
puts obj.type?('dog').inspect # => false

That’s it! Now wasn’t that easy?

# features/authentication/signup.feature

Feature: Signing Up
  In order to sign up for an account
  As a guest
  I need to be able to register

  Scenario: Registration
    Given I am on the sign up page
    When I fill in "user_email" with "test@example.com"
    And I fill in "user_password" with "test1234"
    And I fill in "user_password_confirmation" with "test1234"
    And I press "Sign Up"
    Then I should see "You will receive an email with instructions"

Even after all of this I cannot be sure that I have completely covered the test but I will note that it does not require a single step definition outside of those that are provided by Capybara in the web_steps.rb convenient step definitions. Here are the other Features, Backgrounds, Scenarios, and Scenario Outlines that I used to cover the authentication class of features:

The confirmation feature:

# features/authentication/confirmation.feature

Feature:
  In order activate my account
  As a user
  I want to be able to confirm

  Background:
    Given I am pending confirmation

  Scenario: Confirmation
    Given I received the email
    When I confirm the account
    Then I should find that I am confirmed

The session feature:

# features/authentication/session.feature

Feature: Session handling
  In order to use the site
  As a registered user
  I need to be able to login and logout

  Background:
    Given that a confirmed user exists

  Scenario Outline: Logging in
    Given I am on the login page
    When I fill in "user_email" with "<email>"
    And I fill in "user_password" with "<password>"
    And I press "Sign in"
    Then I should <action>
    Examples:
      |         email       |  password   |              action             |
      | minimal@example.com |  test1234   | see "Signed in successfully"    |
      | bad@example.com     |  password   | see "Invalid email or password" |

  Scenario: Logging out
    Given I am logged in
    When I go to the sign out link
    Then I should see "Signed out successfully"

The forgotpassword feature:

# features/authentication/forgotpassword.feature

Feature: Forgot password
  In order to login
  As a user
  When I have forgotten my password
  I should be able to reset it

  Background:
    Given that a confirmed user exists

  Scenario Outline: Reset password request
    Given I am on the forgotten password page
    When I fill in "user_email" with "<email>"
    And I press "Send me reset password instructions"
    Then I should <action>
    Examples:
      |         email       |                                       action                                       |
      | minimal@example.com | see "You will receive an email with instructions about how to reset your password" |
      | bad@example.com     | see "Email not found"                                                              |

  Scenario: Reset password confirmation
    Given that I have reset my password
    When I follow the reset password link in my email
    Then I expect to be able to reset my password

and all of the step definitions:

# features/step_definitions/authentication_steps.rb

# Confrimation
Given /^I received the email$/ do
  @user.confirmed?.should be_false
end

When /^I confirm the account$/ do
  visit user_confirmation_path(:confirmation_token => @user.confirmation_token)
  page.should have_content("Your account was successfully confirmed")
  @user.confirm!
end

Then /^I should find that I am confirmed$/ do
  @user.confirmed?.should be_true
end

# Forgottenpassword
Given /^that I have a confirmed account$/ do
  @user.confirmed?
end

Given /^that I have reset my password$/ do
  @user.send_reset_password_instructions
end

When /^I follow the reset password link in my email$/ do
  visit edit_user_password_path(:reset_password_token => @user.reset_password_token)
  page.should have_content("Change your password")
end

Then /^I expect to be able to reset my password$/ do
  visit edit_user_password_path(:reset_password_token => @user.reset_password_token)
  fill_in 'user_password', :with => 'test1234'
  fill_in 'user_password_confirmation', :with => 'test1234'
  click_button('Change my password')
  page.should have_content('Your password was changed successfully')
end

# Session
Given /^I am logged in$/ do
  visit path_to('the login page')
  fill_in('user_email', :with => @user.email)
  fill_in('user_password', :with => @user.password)
  click_button('Sign in')
  if defined?(Spec::Rails::Matchers)
    page.should have_content('Signed in successfully')
  else
    assert page.has_content?('Signed in successfully')
  end
end

To get the minimal user, referenced in a few of the step definitions, I created a Factory:

# spec/factories/user.rb

Factory.define :minimal_user, :class => User do |u|
  u.email 'minimal@example.com'
  u.password 'test1234'
  u.password_confirmation 'test1234'
end

And added the FactoryGirl gem to the Cucumber environment:

# config/environments/cucumber.rb

config.gem "factory_girl"

As you can see there is a lot here and a lot of it probably duplicates the test coverage found in the Devise gem. However, developing these Features, Scenarios, and Step Definitions has been great practice for me and warmed me up very gently to how fun Behavior Driven Design (BDD) can be.

#!/usr/bin/env ruby

class Collatz
  def self.get_convergence_point(number_one, number_two)
    self.get_path_intersection(number_one, number_two).first
  end

  def self.get_path_intersection(number_one, number_two)
    # Get the paths
    path_one = self.get_path(number_one)
    path_two = self.get_path(number_two)

    # Return the intersection
    path_one & path_two
  end 

  def self.get_path_matrix(number, matrix=Hash.new)
    # Get all of the "child" numbers for this number
    numbers = self.get_path(number)

    # Itterate
    numbers.each do |n|
      # Save some work
      if (matrix[n].nil?)
        matrix[n] = self.get_path(n)

        # Done
        if (n == 1)
          return matrix
        end

        # Recursive
        return self.get_path_matrix(n, matrix)
      end
    end
  end

  def self.get_step_count(number)
    self.get_path(number).length - 1
  end

  def self.get_path(n, numbers=Array.new)
    # Append current itteration
    numbers << n

    # Done
    if (n == 1)
      return numbers
    end

    # Recursive
    if(n%2 == 1)
      self.get_path((3*n)+1, numbers)
    else
      self.get_path(n/2, numbers)
    end
  end
end

## Get some info
matrix_one = Collatz::get_path_matrix(ARGV[0].to_i)
matrix_one_step_count = Collatz::get_step_count(ARGV[0].to_i)
matrix_two = Collatz::get_path_matrix(ARGV[1].to_i)
matrix_path_intersection = Collatz::get_path_intersection(ARGV[0].to_i, ARGV[1].to_i)
matrix_convergence_point = Collatz::get_convergence_point(ARGV[0].to_i, ARGV[1].to_i)

puts matrix_one.inspect
puts matrix_one_step_count.inspect
puts matrix_two.inspect
puts matrix_path_intersection.inspect
puts matrix_convergence_point

## Empty space
puts
puts

## Print "pretty" path
path_one = Collatz::get_path(ARGV[0].to_i)
path_two = Collatz::get_path(ARGV[1].to_i)
path_convergence_point = Collatz::get_convergence_point(ARGV[0].to_i, ARGV[1].to_i)
path_intersection = Collatz::get_path_intersection(ARGV[0].to_i, ARGV[1].to_i)

if path_one.length >= path_two.length
  left_path = path_one
  right_path = path_two
else
  left_path = path_two
  right_path = path_one
end

left_path -= matrix_path_intersection
right_path -= matrix_path_intersection
path_intersection.reverse.each do |n|
  if (!right_path.empty?)
    puts '  ' + n.to_s
  else
    puts n.to_s
  end
end

if (!right_path.empty?)
  puts ' / \\'
end

left_path.reverse.each do |x|
  next if (x == path_convergence_point)
  puts x.to_s + "   " + right_path.pop.to_s
end

This yields the output:

$ ruby collatz.rb 7 6
{16=>[16, 8, 4, 2, 1], 5=>[5, 16, 8, 4, 2, 1], 11=>[11, 34, 17, 52, 26, 13, 40, 20, 10, 5, 16, 8, 4, 2, 1], 22=>[22, 11, 34, 17, 52, 26, 13, 40, 20, 10, 5, 16, 8, 4, 2, 1], 17=>[17, 52, 26, 13, 40, 20, 10, 5, 16, 8, 4, 2, 1], 1=>[1], 34=>[34, 17, 52, 26, 13, 40, 20, 10, 5, 16, 8, 4, 2, 1], 40=>[40, 20, 10, 5, 16, 8, 4, 2, 1], 7=>[7, 22, 11, 34, 17, 52, 26, 13, 40, 20, 10, 5, 16, 8, 4, 2, 1], 2=>[2, 1], 13=>[13, 40, 20, 10, 5, 16, 8, 4, 2, 1], 8=>[8, 4, 2, 1], 52=>[52, 26, 13, 40, 20, 10, 5, 16, 8, 4, 2, 1], 20=>[20, 10, 5, 16, 8, 4, 2, 1], 4=>[4, 2, 1], 26=>[26, 13, 40, 20, 10, 5, 16, 8, 4, 2, 1], 10=>[10, 5, 16, 8, 4, 2, 1]}
16
{16=>[16, 8, 4, 2, 1], 5=>[5, 16, 8, 4, 2, 1], 6=>[6, 3, 10, 5, 16, 8, 4, 2, 1], 1=>[1], 2=>[2, 1], 8=>[8, 4, 2, 1], 3=>[3, 10, 5, 16, 8, 4, 2, 1], 4=>[4, 2, 1], 10=>[10, 5, 16, 8, 4, 2, 1]}
[10, 5, 16, 8, 4, 2, 1]
10

  1
  2
  4
  8
  16
  5
  10
 / \
20   3
40   6
13
26
52
17
34
11
22
7