hectoregm-email_spec 0.1.2

data/examples/rails_root/db/schema.rb

@@ -0,0 +1,19 @@
+# This file is auto-generated from the current state of the database. Instead of editing this file, 
+# please use the migrations feature of Active Record to incrementally modify your database, and
+# then regenerate this schema definition.
+#
+# Note that this schema.rb definition is the authoritative source for your database schema. If you need
+# to create the application database on another system, you should be using db:schema:load, not running
+# all the migrations from scratch. The latter is a flawed and unsustainable approach (the more migrations
+# you'll amass, the slower it'll run and the greater likelihood for issues).
+#
+# It's strongly recommended to check this file into your version control system.
+
+ActiveRecord::Schema.define(:version => 20090125013728) do
+
+  create_table "users", :force => true do |t|
+    t.string "email"
+    t.string "name"
+  end
+
+end

data/examples/rails_root/doc/README_FOR_APP

@@ -0,0 +1,5 @@
+To build the guides:
+
+* Install source-highlighter (http://www.gnu.org/software/src-highlite/source-highlight.html)
+* Install the mizuho gem (http://github.com/FooBarWidget/mizuho/tree/master)
+* Run `rake guides` from the railties directory

data/examples/rails_root/features/errors.feature

@@ -0,0 +1,42 @@
+Feature: Email-spec errors example
+
+In order to help alleviate email testing in apps
+As a email-spec contributor I a newcomer
+Should be able to easily determine where I have gone wrong
+These scenarios should fail with helpful messages
+
+    Scenario: I fail to receive an email
+      Given I am at "/"
+      And no emails have been sent
+      When I fill in "Email" with "quentin@example.com"
+      And I press "Sign up"
+      And I should receive an email
+      When "quentin@example.com" opens the email with subject "no email"
+
+    Scenario: I fail to receive an email with the expected link
+      Given I am at "/"
+      And no emails have been sent
+      When I fill in "Email" with "quentin@example.com"
+      And I press "Sign up"
+      And I should receive an email
+      When I open the email
+      When I follow "link that doesn't exist" in the email
+
+    Scenario: I attempt to operate on an email that is not opened
+      Given I am at "/"
+      And no emails have been sent
+      When I fill in "Email" with "quentin@example.com"
+      And I press "Sign up"
+      And I should receive an email
+      When I follow "confirm" in the email
+
+    Scenario: I attempt to check out an unopened email
+      Given I am at "/"
+      And no emails have been sent
+      When I fill in "Email" with "quentin@example.com"
+      And I press "Sign up"
+      Then I should see "confirm" in the email
+      And I should see "Account confirmation" in the subject
+
+
+

data/examples/rails_root/features/example.feature

@@ -0,0 +1,59 @@
+Feature: EmailSpec Example -- Prevent Bots from creating accounts
+
+In order to help alleviate email testing in apps
+As an email-spec contributor I want new users of the library
+to easily adopt email-spec in their app by following this example
+
+In order to prevent bots from setting up new accounts
+As a site manager I want new users
+to verify their email address with a confirmation link
+
+Scenario: A new person signs up imperatively 
+    Given I am a real person wanting to sign up for an account
+    And I am at "/"
+
+    When I fill in "Email" with "quentin@example.com"
+    And I fill in "Name" with "Quentin Jones"
+    And I press "Sign up"
+
+    Then "quentin@example.com" should receive 1 email
+    And "quentin@example.com" should have 1 email
+    And "foo@bar.com" should not receive an email
+
+    When "quentin@example.com" opens the email with subject "Account confirmation"
+
+    Then I should see "confirm" in the email
+    And I should see "Quentin Jones" in the email
+    And I should see "Account confirmation" in the subject
+
+    When I follow "Click here to confirm your account!" in the email
+    Then I should see "Confirm your new account"
+
+
+Scenario: slightly more declarative, but still mostly imperative
+    Given I am a real person wanting to sign up for an account
+    And I'm on the signup page
+
+    When I fill in "Email" with "quentin@example.com"
+    And I fill in "Name" with "Quentin Jones"
+    And I press "Sign up"
+
+    Then I should receive an email
+
+    When I open the email
+    Then I should see "Account confirmation" in the subject
+
+    When I follow "http:///confirm" in the email
+    Then I should see "Confirm your new account"
+
+
+ Scenario: declarative
+    Given I am a real person wanting to sign up for an account
+    And I'm on the signup page
+
+    When I submit my registration information
+    Then I should receive an email with a link to a confirmation page
+
+
+
+

data/examples/rails_root/features/step_definitions/email_steps.rb

@@ -0,0 +1,74 @@
+#Commonly used email steps
+#
+# To add your own steps make a custom_email_steps.rb
+# The provided methods are:
+#
+# reset_mailer 
+# open_last_email
+# visit_in_email
+# unread_emails_for
+# mailbox_for
+# current_email
+# open_email
+# read_emails_for
+# find_email
+
+module EmailHelpers
+  def current_email_address
+    "quentin@example.com" # Replace with your a way to find your current_email. e.g current_user.email
+  end
+end
+World(EmailHelpers)
+
+# Use this step to reset the e-mail queue within a scenario.
+# This is done automatically before each scenario.
+Given /^(?:a clear email queue|no emails have been sent)$/ do
+  reset_mailer
+end
+
+# Use this step to open the most recently sent e-mail. 
+When /^I open the email$/ do
+  open_email(current_email_address)
+end
+
+When /^I follow "(.*)" in the email$/ do |link|
+  visit_in_email(link)
+end
+
+Then /^I should receive (an|\d+) emails?$/ do |amount|
+  amount = 1 if amount == "an"
+  unread_emails_for(current_email_address).size.should == amount.to_i
+end
+
+Then /^"([^']*?)" should receive (\d+) emails?$/ do |address, n|
+  unread_emails_for(address).size.should == n.to_i 
+end
+
+Then /^"([^']*?)" should have (\d+) emails?$/ do |address, n|
+  mailbox_for(address).size.should == n.to_i
+end
+
+Then /^"([^']*?)" should not receive an email$/ do |address|
+  find_email(address).should be_nil
+end
+
+Then /^I should see "(.*)" in the subject$/ do |text|
+  current_email.should have_subject(Regexp.new(text))
+end
+
+Then /^I should see "(.*)" in the email$/ do |text|
+  current_email.body.should =~ Regexp.new(text)
+end
+
+When %r{^"([^']*?)" opens? the email with subject "([^']*?)"$} do |address, subject|
+  open_email(address, :with_subject => subject)
+end
+
+When %r{^"([^']*?)" opens? the email with text "([^']*?)"$} do |address, text|
+  open_email(address, :with_text => text)
+end
+
+When /^I click the first link in the email$/ do
+  click_first_link_in_email
+end
+

data/examples/rails_root/features/step_definitions/user_steps.rb

@@ -0,0 +1,23 @@
+Given "I am a real person wanting to sign up for an account" do
+  # no-op.. for documentation purposes only!
+end
+
+When /^I submit my registration information$/ do
+  fill_in "Name", :with => valid_user_attributes[:name]
+  fill_in "Email", :with => valid_user_attributes[:email]
+  click_button
+end
+
+Then /^I should receive an email with a link to a confirmation page$/ do
+  unread_emails_for(valid_user_attributes[:email]).size.should == 1 
+  
+  # this call will store the email and you can access it with current_email
+  open_last_email_for(valid_user_attributes[:email])
+  current_email.should have_subject(/Account confirmation/)
+  current_email.should have_body_text(valid_user_attributes[:name])
+
+  click_email_link_matching /confirm/
+  response.should include_text("Confirm your new account")
+  
+end
+

data/examples/rails_root/features/step_definitions/webrat_steps.rb

@@ -0,0 +1,104 @@
+# Commonly used webrat steps
+# http://github.com/brynary/webrat
+
+Given /^I am at "(.+)"$/ do |path|
+  visit path
+end
+
+Given /^I'm on the (.+) page$/ do |page|
+  locations = {"signup" => "/"}
+  visit locations[page]
+end
+
+When /^I press "(.*)"$/ do |button|
+  click_button(button)
+end
+
+When /^I follow "(.*)"$/ do |link|
+  click_link(link)
+end
+
+When /^I fill in "(.*)" with "(.*)"$/ do |field, value|
+  fill_in(field, :with => value) 
+end
+
+When /^I select "(.*)" from "(.*)"$/ do |value, field|
+  select(value, :from => field) 
+end
+
+# Use this step in conjunction with Rail's datetime_select helper. For example:
+# When I select "December 25, 2008 10:00" as the date and time 
+When /^I select "(.*)" as the date and time$/ do |time|
+  select_datetime(time)
+end
+
+# Use this step when using multiple datetime_select helpers on a page or 
+# you want to specify which datetime to select. Given the following view:
+#   <%= f.label :preferred %><br />
+#   <%= f.datetime_select :preferred %>
+#   <%= f.label :alternative %><br />
+#   <%= f.datetime_select :alternative %>
+# The following steps would fill out the form:
+# When I select "November 23, 2004 11:20" as the "Preferred" data and time
+# And I select "November 25, 2004 10:30" as the "Alternative" data and time
+When /^I select "(.*)" as the "(.*)" date and time$/ do |datetime, datetime_label|
+  select_datetime(datetime, :from => datetime_label)
+end
+
+# Use this step in conjuction with Rail's time_select helper. For example:
+# When I select "2:20PM" as the time
+# Note: Rail's default time helper provides 24-hour time-- not 12 hour time. Webrat
+# will convert the 2:20PM to 14:20 and then select it. 
+When /^I select "(.*)" as the time$/ do |time|
+  select_time(time)
+end
+
+# Use this step when using multiple time_select helpers on a page or you want to
+# specify the name of the time on the form.  For example:
+# When I select "7:30AM" as the "Gym" time
+When /^I select "(.*)" as the "(.*)" time$/ do |time, time_label|
+  select_time(time, :from => time_label)
+end
+
+# Use this step in conjuction with Rail's date_select helper.  For example:
+# When I select "February 20, 1981" as the date
+When /^I select "(.*)" as the date$/ do |date|
+  select_date(date)
+end
+
+# Use this step when using multiple date_select helpers on one page or
+# you want to specify the name of the date on the form. For example:
+# When I select "April 26, 1982" as the "Date of Birth" date
+When /^I select "(.*)" as the "(.*)" date$/ do |date, date_label|
+  select_date(date, :from => date_label)
+end
+
+When /^I check "(.*)"$/ do |field|
+  check(field) 
+end
+
+When /^I uncheck "(.*)"$/ do |field|
+  uncheck(field) 
+end
+
+When /^I choose "(.*)"$/ do |field|
+  choose(field)
+end
+
+When /^I attach the file at "(.*)" to "(.*)" $/ do |path, field|
+  attach_file(field, path)
+end
+
+Then /^I should see "(.*)"$/ do |text|
+  response.body.should =~ /#{text}/m
+end
+
+Then /^I should not see "(.*)"$/ do |text|
+  response.body.should_not =~ /#{text}/m
+end
+
+Then /^the "(.*)" checkbox should be checked$/ do |label|
+  field_labeled(label).should be_checked
+end
+
+

data/examples/rails_root/features/support/env.rb

@@ -0,0 +1,21 @@
+# Sets up the Rails environment for Cucumber
+ENV["RAILS_ENV"] = "test"
+require File.expand_path(File.dirname(__FILE__) + '/../../config/environment')
+require 'cucumber/rails/world'
+Cucumber::Rails.use_transactional_fixtures
+
+require 'webrat'
+require 'cucumber/rails/rspec'
+require 'webrat/core/matchers'
+
+Webrat.configure do |config|
+  config.mode = :rails
+end
+
+
+
+require File.expand_path(File.dirname(__FILE__) + '../../../../../lib/email_spec')
+require 'email_spec/cucumber'
+
+require File.expand_path(File.dirname(__FILE__) +'/../../spec/model_factory.rb')
+World(Fixjour)

data/examples/rails_root/public/404.html

@@ -0,0 +1,30 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+
+<head>
+  <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
+  <title>The page you were looking for doesn't exist (404)</title>
+	<style type="text/css">
+		body { background-color: #fff; color: #666; text-align: center; font-family: arial, sans-serif; }
+		div.dialog {
+			width: 25em;
+			padding: 0 4em;
+			margin: 4em auto 0 auto;
+			border: 1px solid #ccc;
+			border-right-color: #999;
+			border-bottom-color: #999;
+		}
+		h1 { font-size: 100%; color: #f00; line-height: 1.5em; }
+	</style>
+</head>
+
+<body>
+  <!-- This file lives in public/404.html -->
+  <div class="dialog">
+    <h1>The page you were looking for doesn't exist.</h1>
+    <p>You may have mistyped the address or the page may have moved.</p>
+  </div>
+</body>
+</html>

data/examples/rails_root/public/422.html

@@ -0,0 +1,30 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+
+<head>
+  <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
+  <title>The change you wanted was rejected (422)</title>
+	<style type="text/css">
+		body { background-color: #fff; color: #666; text-align: center; font-family: arial, sans-serif; }
+		div.dialog {
+			width: 25em;
+			padding: 0 4em;
+			margin: 4em auto 0 auto;
+			border: 1px solid #ccc;
+			border-right-color: #999;
+			border-bottom-color: #999;
+		}
+		h1 { font-size: 100%; color: #f00; line-height: 1.5em; }
+	</style>
+</head>
+
+<body>
+  <!-- This file lives in public/422.html -->
+  <div class="dialog">
+    <h1>The change you wanted was rejected.</h1>
+    <p>Maybe you tried to change something you didn't have access to.</p>
+  </div>
+</body>
+</html>

data/examples/rails_root/public/500.html

@@ -0,0 +1,33 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+
+<head>
+  <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
+  <title>We're sorry, but something went wrong (500)</title>
+	<style type="text/css">
+		body { background-color: #fff; color: #666; text-align: center; font-family: arial, sans-serif; }
+		div.dialog {
+			width: 25em;
+			padding: 0 4em;
+			margin: 4em auto 0 auto;
+			border: 1px solid #ccc;
+			border-right-color: #999;
+			border-bottom-color: #999;
+		}
+		h1 { font-size: 100%; color: #f00; line-height: 1.5em; }
+	</style>
+</head>
+
+<body>
+  <!-- This file lives in public/500.html -->
+  <div class="dialog">
+    <h1>We're sorry, but something went wrong.</h1>
+    <p>We've been notified about this issue and we'll take a look at it shortly.</p>
+    <p><small>(If you're the administrator of this website, then please read
+    the log file "<%=h RAILS_ENV %>.log"
+    to find out what went wrong.)</small></p>
+  </div>
+</body>
+</html>

data/examples/rails_root/public/dispatch.rb

@@ -0,0 +1,10 @@
+#!/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/bin/ruby
+
+require File.dirname(__FILE__) + "/../config/environment" unless defined?(RAILS_ROOT)
+
+# If you're using RubyGems and mod_ruby, this require should be changed to an absolute path one, like:
+# "/usr/local/lib/ruby/gems/1.8/gems/rails-0.8.0/lib/dispatcher" -- otherwise performance is severely impaired
+require "dispatcher"
+
+ADDITIONAL_LOAD_PATHS.reverse.each { |dir| $:.unshift(dir) if File.directory?(dir) } if defined?(Apache::RubyRun)
+Dispatcher.dispatch

data/examples/rails_root/public/javascripts/application.js

@@ -0,0 +1,2 @@
+// Place your application-specific JavaScript functions and classes here
+// This file is automatically included by javascript_include_tag :defaults