email-test-helpers 1.0.0

data/.gitignore

@@ -0,0 +1,2 @@
+.yardoc
+doc

data/.yardopts

@@ -0,0 +1 @@
+--charset UTF-8 --markup markdown lib/**/*.rb - LICENSE

data/LICENSE

@@ -0,0 +1,10 @@
+The MIT License
+===============
+
+© 2011 Cody Robbins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,33 @@
+Email Test Helpers
+==================
+
+This gem provides some simple helpers for [RSpec](http://relishapp.com/rspec) and [Cucumber](http://cukes.info/) for testing ActionMailer deliveries.
+
+Full documentation is at [RubyDoc.info](http://rubydoc.info/gems/email-test-helpers).
+
+Colophon
+--------
+
+### See also
+
+If you like this gem, you may also want to check out: [Static Model](http://codyrobbins.com/software/static-model), [Active Model Email Validator](http://codyrobbins.com/software/active-model-email-validator), or [HTTP Error](http://codyrobbins.com/software/http-error).
+
+### Tested with
+
+* RSpec 2.6.0 — 20 May 2011
+* Cucumber 0.10.3 — 20 May 2011
+
+### Contributing
+
+* [Source](https://github.com/codyrobbins/email-test-helpers)
+* [Bug reports](https://github.com/codyrobbins/email-test-helpers/issues)
+
+To send patches, please fork on GitHub and submit a pull request.
+
+### Credits
+
+© 2011 [Cody Robbins](http://codyrobbins.com/). See LICENSE for details.
+
+* [Homepage](http://codyrobbins.com/software/email-test-helpers)
+* [My other gems](http://codyrobbins.com/software#gems)
+* [Follow me on Twitter](http://twitter.com/codyrobbins)

data/email-test-helpers.gemspec

@@ -0,0 +1,19 @@
+Gem::Specification.new do |s|
+  s.name     = 'email-test-helpers'
+  s.version  = '1.0.0'
+  s.summary  = 'Some helpers for RSpec and Cucumber for testing ActionMailer email delivery.'
+  s.homepage = 'http://codyrobbins.com/software/email-test-helpers'
+  s.author   = 'Cody Robbins'
+  s.email    = 'cody@codyrobbins.com'
+
+  s.post_install_message = '
+-------------------------------------------------------------
+Follow me on Twitter! http://twitter.com/codyrobbins
+-------------------------------------------------------------
+
+'
+
+  s.files = `git ls-files`.split
+
+  s.add_dependency('rspec', '>= 2')
+end

data/lib/cody_robbins/email_test_helpers/matchers.rb

@@ -0,0 +1,71 @@
+module CodyRobbins
+  module EmailTestHelpers
+    module Matchers
+      # @method be_sent_to(address)
+      #
+      # Verifies the address an email is sent to.
+      #
+      # @param address [String] The email address.
+      #
+      # @return [RSpec::Matchers::Matcher]
+      #
+      # @example
+      #     last_email.should.be_sent_to 'dagny@taggart.com'
+      RSpec::Matchers.define(:be_sent_to) do |address|
+        match do |mail|
+          mail.to.should == [address]
+        end
+      end
+
+      # @method be_sent_from_address(address)
+      #
+      # Verifies the address an email is sent from.
+      #
+      # @param address [String] The email address.
+      #
+      # @return [RSpec::Matchers::Matcher]
+      #
+      # @example
+      #     last_email.should.be_sent_from_address 'dagny@taggart.com'
+      RSpec::Matchers.define(:be_sent_from_address) do |address|
+        match do |mail|
+          mail.from.should == [address]
+        end
+      end
+
+      # @method be_sent_from_display_name(name)
+      #
+      # Verifies the display name an email is sent from. The display name is the optional text outside the angle brackets in a `From` header such as `Dagny Taggart <dagny@taggart.com>`.
+      #
+      # @param name [String] The display name.
+      #
+      # @return [RSpec::Matchers::Matcher]
+      #
+      # @example
+      #     last_email.should.be_sent_from_display_name 'Dagny Taggart'
+      RSpec::Matchers.define(:be_sent_from_display_name) do |name|
+        match do |mail|
+          mail[:from].display_names.should == [name]
+        end
+      end
+
+      # @method be_sent_from(name, address)
+      #
+      # Verifies both the address and display name an email is sent from. This just combines the `be_sent_from_address` and `be_sent_from_display_name` matchers.
+      #
+      # @param name [String] The display name.
+      # @param address [String] The email address.
+      #
+      # @return [RSpec::Matchers::Matcher]
+      #
+      # @example
+      #     last_email.should.be_sent_from 'Dagny Taggart', 'dagny@taggart.com'
+      RSpec::Matchers.define(:be_sent_from) do |name, address|
+        match do |mail|
+          mail.should be_sent_from_display_name name
+          mail.should be_sent_from_address address
+        end
+      end
+    end
+  end
+end

data/lib/cody_robbins/email_test_helpers/methods.rb

@@ -0,0 +1,17 @@
+module CodyRobbins
+  module EmailTestHelpers
+    module Methods
+      # A more readable alias for `ActionMailer::Base.deliveries`.
+      #
+      # @return [Array] All emails sent by ActionMailer.
+      def emails
+        ActionMailer::Base.deliveries
+      end
+
+      # @return [Mail::Message] The last email sent by ActionMailer.
+      def last_email
+        emails.first
+      end
+    end
+  end
+end

data/lib/email-test-helpers.rb

@@ -0,0 +1,9 @@
+require('rspec')
+
+require('cody_robbins/email_test_helpers/methods')
+require('cody_robbins/email_test_helpers/matchers')
+
+RSpec.configure do |config|
+  config.include(CodyRobbins::EmailTestHelpers::Methods)
+  config.include(CodyRobbins::EmailTestHelpers::Matchers)
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: email-test-helpers
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Cody Robbins
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-01 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "2"
+  type: :runtime
+  version_requirements: *id001
+description: 
+email: cody@codyrobbins.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .yardopts
+- LICENSE
+- README.markdown
+- email-test-helpers.gemspec
+- lib/cody_robbins/email_test_helpers/matchers.rb
+- lib/cody_robbins/email_test_helpers/methods.rb
+- lib/email-test-helpers.rb
+has_rdoc: true
+homepage: http://codyrobbins.com/software/email-test-helpers
+licenses: []
+
+post_install_message: "\n\
+  -------------------------------------------------------------\n\
+  Follow me on Twitter! http://twitter.com/codyrobbins\n\
+  -------------------------------------------------------------\n\n"
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Some helpers for RSpec and Cucumber for testing ActionMailer email delivery.
+test_files: []
+