email_spec 1.2.1 → 1.4.0

data/README.rdoc

@@ -1,148 +0,0 @@
-= Email Spec
-
-A collection of RSpec matchers and Cucumber steps to make testing emails go smoothly.
-
-This library works with ActionMailer and Pony.  When using it with ActionMailer it works with
-DelayedJob, ActiveRecord Mailer, and action_mailer_cache_delivery.
-
-When using the action_mailer_cache_delivery library you must use this fork:
-http://github.com/liangzan/action_mailer_cache_delivery
-
-If you are testing emails in conjunction with an automated browser solution, like Selenium,
-you will want to use action_mailer_cache_delivery in your test environment.  (This is
-because your test process and server processes are distinct and therefore need an
-intermediate store for the emails.) DelayedJob and ActiveRecord Mailer will also work but
-you generally don't want to include those projects unless you need them in production.
-
-== Setup
-
-  script/plugin install git://github.com/bmabey/email-spec.git
-
-=== Gem Setup
-
-  gem install email_spec
-
-  # Gemfile
-  group :test do
-    gem 'email_spec'
-  end
-
-=== Cucumber
-
-To use the steps in features put the following in your env.rb:
-
-  # Make sure this require is after you require cucumber/rails/world.
-  require 'email_spec' # add this line if you use spork
-  require 'email_spec/cucumber'
-
-This will load all the helpers that the steps rely on.
-It will also add a Before hook for Cucumber so that emails are cleared at the start of each scenario.
-
-Then:
-
-  rails generate email_spec:steps
-
-This will give you a bunch of steps to get started with in step_definitions/email_steps.rb
-
-By default, the generated file will look for email to example@example.com. You can either change this
-by editing the current_email_address method in email_steps.rb, or by simply specifying the target
-email in your features:
-
-  Scenario: A new person signs up
-      Given I am at "/"
-      When I fill in "Email" with "quentin@example.com"
-      And I press "Sign up"
-      And "quentin@example.com" should receive an email   # Specify who should receive the email
-
-=== RSpec
-
-First you need to require email_spec in your spec_helper.rb:
-
-  require "email_spec"
-
-You will then need to include EmailSpec::Helpers and EmailSpec::Matchers in your example groups.
-If you want to have access to the helpers and matchers in all of your examples you can do the following in your spec_helper.rb:
-
-  Spec::Runner.configure do |config|
-    config.include(EmailSpec::Helpers)
-    config.include(EmailSpec::Matchers)
-  end
-
-Otherwise, you will need to include them in the example groups you wish to use them:
-
-  describe "Signup Email" do
-    include EmailSpec::Helpers
-    include EmailSpec::Matchers
-    ...
-  end
-
-== Usage
-
-=== Cucumber
-
-  Scenario: A new person signs up
-      Given I am at "/"
-      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
-      Then I should see "confirm" in the email body
-      When I follow "confirm" in the email
-      Then I should see "Confirm your new account"
-
-For more examples, check out examples/rails_root in the source for a small example app that implements these steps.
-
-=== RSpec
-
-==== Testing In Isolation
-It is often useful to test your mailers in isolation.  You can accomplish this by using mocks to verify that the mailer is being called in the correct place and then write focused examples for the actual mailer.  This is a simple example from the sample app found in the gem:
-
-Verify that the mailer is used correctly in the controller (this would apply to a model as well):
-
-  describe "POST /signup (#signup)" do
-    it "should deliver the signup email" do
-      # expect
-      UserMailer.should_receive(:deliver_signup).with("email@example.com", "Jimmy Bean")
-      # when
-      post :signup, "Email" => "email@example.com", "Name" => "Jimmy Bean"
-    end
-  end
-
-Examples for the #signup method in UserMailer:
-
-  describe "Signup Email" do
-    include EmailSpec::Helpers
-    include EmailSpec::Matchers
-    include ActionController::UrlWriter
-
-    before(:all) do
-      @email = UserMailer.create_signup("jojo@yahoo.com", "Jojo Binks")
-    end
-
-    it "should be set to be delivered to the email passed in" do
-      @email.should deliver_to("jojo@yahoo.com")
-    end
-
-    it "should contain the user's message in the mail body" do
-      @email.should have_body_text(/Jojo Binks/)
-    end
-
-    it "should contain a link to the confirmation link" do
-      @email.should have_body_text(/#{confirm_account_url}/)
-    end
-
-    it "should have the correct subject" do
-      @email.should have_subject(/Account confirmation/)
-    end
-
-  end
-
-==== Using the helpers when not testing in isolation
-
-Don't. :)  Seriously, if you do just take a look at the helpers and use them as you wish.
-
-== Original Authors
-
-Ben Mabey, Aaron Gibralter, Mischa Fierer
-
-Please see History.txt for upcoming changsets and other contributors.

data/examples/rails3_root/Gemfile

@@ -1,17 +0,0 @@
-source 'http://gemcutter.org'
-
-gem 'rails', '3.0.0.rc'
-gem 'sqlite3-ruby', :require => 'sqlite3'
-
-gem 'delayed_job', '>=2.0.3'
-gem 'mimetype-fu', :require => 'mimetype_fu'
-
-group :test do
-  gem "test-unit"
-  gem "cucumber-rails"
-  gem "database_cleaner"
-  gem 'capybara'
-  gem "rspec", ">= 2.0.1"
-  gem "rspec-rails", ">= 2.0.1"
-  gem "email_spec", :path => "../../"
-end

data/examples/rails3_root/Gemfile.lock

@@ -1,135 +0,0 @@
-PATH
-  remote: ../../
-  specs:
-    email_spec (1.2.0)
-      mail (~> 2.2)
-      rspec (~> 2.0)
-
-GEM
-  remote: http://gemcutter.org/
-  specs:
-    abstract (1.0.0)
-    actionmailer (3.0.0.rc)
-      actionpack (= 3.0.0.rc)
-      mail (~> 2.2.5)
-    actionpack (3.0.0.rc)
-      activemodel (= 3.0.0.rc)
-      activesupport (= 3.0.0.rc)
-      builder (~> 2.1.2)
-      erubis (~> 2.6.6)
-      i18n (~> 0.4.1)
-      rack (~> 1.2.1)
-      rack-mount (~> 0.6.9)
-      rack-test (~> 0.5.4)
-      tzinfo (~> 0.3.22)
-    activemodel (3.0.0.rc)
-      activesupport (= 3.0.0.rc)
-      builder (~> 2.1.2)
-      i18n (~> 0.4.1)
-    activerecord (3.0.0.rc)
-      activemodel (= 3.0.0.rc)
-      activesupport (= 3.0.0.rc)
-      arel (~> 0.4.0)
-      tzinfo (~> 0.3.22)
-    activeresource (3.0.0.rc)
-      activemodel (= 3.0.0.rc)
-      activesupport (= 3.0.0.rc)
-    activesupport (3.0.0.rc)
-    arel (0.4.0)
-      activesupport (>= 3.0.0.beta)
-    builder (2.1.2)
-    capybara (0.3.9)
-      culerity (>= 0.2.4)
-      mime-types (>= 1.16)
-      nokogiri (>= 1.3.3)
-      rack (>= 1.0.0)
-      rack-test (>= 0.5.4)
-      selenium-webdriver (>= 0.0.3)
-    cucumber (0.8.5)
-      builder (~> 2.1.2)
-      diff-lcs (~> 1.1.2)
-      gherkin (~> 2.1.4)
-      json_pure (~> 1.4.3)
-      term-ansicolor (~> 1.0.4)
-    cucumber-rails (0.3.2)
-      cucumber (>= 0.8.0)
-    culerity (0.2.10)
-    daemons (1.1.0)
-    database_cleaner (0.5.2)
-    delayed_job (2.0.3)
-      daemons
-    diff-lcs (1.1.2)
-    erubis (2.6.6)
-      abstract (>= 1.0.0)
-    ffi (0.6.3)
-      rake (>= 0.8.7)
-    gherkin (2.1.5)
-      trollop (~> 1.16.2)
-    i18n (0.4.1)
-    json_pure (1.4.3)
-    mail (2.2.5)
-      activesupport (>= 2.3.6)
-      mime-types
-      treetop (>= 1.4.5)
-    mime-types (1.16)
-    mimetype-fu (0.1.2)
-    nokogiri (1.4.2)
-    polyglot (0.3.1)
-    rack (1.2.1)
-    rack-mount (0.6.9)
-      rack (>= 1.0.0)
-    rack-test (0.5.4)
-      rack (>= 1.0)
-    rails (3.0.0.rc)
-      actionmailer (= 3.0.0.rc)
-      actionpack (= 3.0.0.rc)
-      activerecord (= 3.0.0.rc)
-      activeresource (= 3.0.0.rc)
-      activesupport (= 3.0.0.rc)
-      bundler (>= 1.0.0.rc.1)
-      railties (= 3.0.0.rc)
-    railties (3.0.0.rc)
-      actionpack (= 3.0.0.rc)
-      activesupport (= 3.0.0.rc)
-      rake (>= 0.8.3)
-      thor (~> 0.14.0)
-    rake (0.8.7)
-    rspec (2.1.0)
-      rspec-core (~> 2.1.0)
-      rspec-expectations (~> 2.1.0)
-      rspec-mocks (~> 2.1.0)
-    rspec-core (2.1.0)
-    rspec-expectations (2.1.0)
-      diff-lcs (~> 1.1.2)
-    rspec-mocks (2.1.0)
-    rspec-rails (2.1.0)
-      rspec (~> 2.1.0)
-    rubyzip (0.9.4)
-    selenium-webdriver (0.0.27)
-      ffi (>= 0.6.1)
-      json_pure
-      rubyzip
-    sqlite3-ruby (1.3.1)
-    term-ansicolor (1.0.5)
-    test-unit (2.1.0)
-    thor (0.14.0)
-    treetop (1.4.8)
-      polyglot (>= 0.3.1)
-    trollop (1.16.2)
-    tzinfo (0.3.22)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  capybara
-  cucumber-rails
-  database_cleaner
-  delayed_job (>= 2.0.3)
-  email_spec!
-  mimetype-fu
-  rails (= 3.0.0.rc)
-  rspec (>= 2.0.1)
-  rspec-rails (>= 2.0.1)
-  sqlite3-ruby
-  test-unit

data/examples/rails3_root/README

@@ -1,5 +0,0 @@
-== Running features in this app
-
-1. Make sure you have latest bundler gem.
-2. cd into rails3_root and run `bundle install`
-3. run script/rails generate email_spec:steps

data/examples/rails3_root/Rakefile

@@ -1,11 +0,0 @@
-# Add your own tasks in files placed in lib/tasks ending in .rake,
-# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
-
-require File.expand_path('../config/application', __FILE__)
-
-require 'rake'
-require 'rake/testtask'
-require 'rake/rdoctask'
-require 'delayed/tasks'
-
-Rails3Root::Application.load_tasks

data/examples/rails3_root/app/controllers/application_controller.rb

@@ -1,3 +0,0 @@
-class ApplicationController < ActionController::Base
-  protect_from_forgery
-end

data/examples/rails3_root/app/controllers/welcome_controller.rb

@@ -1,16 +0,0 @@
-class WelcomeController < ApplicationController
-  def signup
-    UserMailer.signup(params['Email'], params['Name']).deliver
-  end
-
-  def confirm
-  end
-
-  def newsletter
-    Delayed::Job.enqueue(NotifierJob.new(:newsletter,params['Email'], params['Name']))
-  end
-
-  def attachments
-    UserMailer.attachments_mail(params['Email'], params['Name']).deliver
-  end
-end

data/examples/rails3_root/app/helpers/application_helper.rb

@@ -1,2 +0,0 @@
-module ApplicationHelper
-end

data/examples/rails3_root/app/mailers/user_mailer.rb

@@ -1,39 +0,0 @@
-class UserMailer < ActionMailer::Base
-  default :from => "admin@example.com",
-          :sent_on => Time.now.to_s
-  
-  
-  def signup(email, name)
-    @name = name
-    
-    mail :to => email,
-         :subject => "Account confirmation"
-  end
-
-  def newsletter(email, name)
-    @name = name
-    
-    mail :to => email,
-         :subject => "Newsletter sent"
-  end
-
-  def attachments_mail(email, name)
-    @name = name
-    
-    add_attachment 'image.png'
-    add_attachment 'document.pdf'
-    
-    mail :to => email,
-         :subject => "Attachments test"
-  end
-
-  private
-
-  def add_attachment(attachment_name)
-    attachment_path = "#{Rails.root}/attachments/#{attachment_name}"
-    File.open(attachment_path) do |file|
-      filename = File.basename(file.path)
-      attachments[filename] = {:content_type => File.mime_type?(file), :content => file.read}
-    end
-  end
-end

data/examples/rails3_root/app/models/user.rb

@@ -1,2 +0,0 @@
-class User < ActiveRecord::Base
-end

data/examples/rails3_root/app/views/user_mailer/attachments.html.erb

@@ -1,6 +0,0 @@
-Hello <%= @name %>!
-
-Documents are attached.
-
-Regards
-Rails Example App

data/examples/rails3_root/app/views/user_mailer/newsletter.html.erb

@@ -1,8 +0,0 @@
-Hello <%= @name %>!
-
-This week.....
-.....
-.....
-
-Regards
-Rails Example App

data/examples/rails3_root/app/views/user_mailer/signup.html.erb

@@ -1,4 +0,0 @@
-Hello <%= @name %>!
-
-<%= link_to "Click here to confirm your account!", confirm_account_url %>
-This is the HTML part

data/examples/rails3_root/app/views/user_mailer/signup.text.erb

@@ -1,4 +0,0 @@
-Hello <%= @name %>!
-
-<%= link_to "Click here to confirm your account!", confirm_account_url %>
-This is the text part

data/examples/rails3_root/app/views/welcome/confirm.html.erb

@@ -1 +0,0 @@
-Confirm your new account!

data/examples/rails3_root/app/views/welcome/index.html.erb

@@ -1,8 +0,0 @@
-<%= form_tag '/welcome/signup' do -%>
-    <label for="Name">Name</label>
-    <%= text_field_tag 'Name' %>
-    <label for="Email">Email</label>
-    <%= text_field_tag 'Email' %>
-    <div><%= submit_tag 'Sign up' %></div>
-<% end -%>
-

data/examples/rails3_root/app/views/welcome/signup.html.erb

@@ -1 +0,0 @@
-Thanks!  Go check your email!

data/examples/rails3_root/config.ru

@@ -1,4 +0,0 @@
-# This file is used by Rack-based servers to start the application.
-
-require ::File.expand_path('../config/environment',  __FILE__)
-run Rails3Root::Application