capybara-email 0.1.2 → 1.0.0

data/README.md

@@ -1,6 +1,8 @@
 # CapybaraEmail #
 
 [![Build Status](http://travis-ci.org/dockyard/capybara-email.png)](http://travis-ci.org/dockyard/capybara-email)
+[![Dependency Status](https://gemnasium.com/dockyard/capybara-email.png?travis)](https://gemnasium.com/dockyard/capybara-email)
+[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/dockyard/capybara-email)
 
 Easily test [ActionMailer](https://github.com/rails/rails/tree/master/actionmailer) and [Mail](https://github.com/mikel/mail) messages in your Capybara integration tests
 
@@ -55,6 +57,37 @@ feature 'Emailer' do
 end
 ```
 
+### Cucumber ###
+Require `capybara/email` in your `features/support/env.rb`
+
+    require 'capybara/email'
+
+Once you have required `capybara-email`, gaining access to usable methods
+is easy as adding this module to your Cucumber `World`:
+
+    World(Capybara::Email::DSL)
+
+I recommend adding this to a support file such as `features/support/capybara_email.rb`
+
+```ruby
+require 'capybara/email'
+World(Capybara::Email::DSL)
+```
+
+Example:
+
+```ruby
+Scenario: Email is sent to winning user
+  Given "me@example.com" is playing a game
+  When that user picks a winning piece
+  Then "me@example.com" receives an email with "You've Won!" as the subject
+
+Then /^"([^"]*)" receives an email with "([^"]*)" as the subject$/ do |email_address, subject|
+  open_email(email_address)
+  current_email.subject.should eq subject
+end
+```
+
 ### Test::Unit ###
 
 Include `Capybara::Email::DSL` in your test class
@@ -99,6 +132,8 @@ end
 
 [Brian Cardarella](http://twitter.com/bcardarella)
 
+[We are very thankful for the many contributors](https://github.com/dockyard/client_side_validations-simple_form/graphs/contributors)
+
 ## Versioning ##
 
 This gem follows [Semantic Versioning](http://semver.org)

data/lib/capybara/email/driver.rb

@@ -11,36 +11,63 @@ class Capybara::Email::Driver < Capybara::Driver::Base
     when :rack_test
       url.to_s
     else
-      Capybara.current_session.driver.send(:url, url.path)
+      Capybara.current_session.driver.send(:url, url.request_uri)
     end
 
     Capybara.current_session.driver.visit url
   end
 
+
   def body
     dom.to_xml
   end
 
+  # Access to email subject
+  #
+  #  delegates back to instance of Mail::Message
+  #
+  # @return String
   def subject
     email.subject
   end
 
+  # Access to email recipient(s)
+  #
+  #  delegates back to instance of Mail::Message
+  #
+  # @return [Array<String>]
   def to
     email.to
   end
 
+  # Access to email sender(s)
+  #
+  #  delegates back to instance of Mail::Message
+  #
+  # @return [Array<String>]
   def from
     email.from
   end
 
+  # Nokogiri object for traversing content
+  #
+  # @return Nokogiri::HTML::Document
   def dom
     @dom ||= Nokogiri::HTML(source)
   end
 
+  # Find elements based on given xpath
+  #
+  # @param [xpath string]
+  #
+  # @return [Array<Capybara::Driver::Node>]
   def find(selector)
     dom.xpath(selector).map { |node| Capybara::Email::Node.new(self, node) }
   end
 
+  # String version of email HTML source
+  #
+  # @return String
   def source
     if email.mime_type == 'text/plain'
       convert_to_html(raw)
@@ -49,6 +76,9 @@ class Capybara::Email::Driver < Capybara::Driver::Base
     end
   end
 
+  # Plain text email contents
+  #
+  # @return String
   def raw
     email.body.encoded
   end

data/lib/capybara/email/version.rb

@@ -1,5 +1,5 @@
 module Capybara
   module Email
-    VERSION = '0.1.2'
+    VERSION = '1.0.0'
   end
 end

data/lib/capybara/node/email.rb

@@ -1,27 +1,27 @@
 class Capybara::Node::Email < Capybara::Node::Document
 
-  # Delgate to the email body
+  # Delegate to the email body
   #
   # @return [Mail::Message#body]
   def body
     base.raw
   end
 
-  # Delgate to the email subject
+  # Delegate to the email subject
   #
   # @return [Mail::Message#subject]
   def subject
     base.subject
   end
 
-  # Delgate to the email to
+  # Delegate to the email to
   #
   # @return [Mail::Message#to]
   def to
     base.to
   end
 
-  # Delgate to the email from
+  # Delegate to the email from
   #
   # @return [Mail::Message#from]
   def from

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: capybara-email
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-20 00:00:00.000000000Z
+date: 2012-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mail
-  requirement: &70349199022800 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70349199022800
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: actionmailer
-  requirement: &70349199022380 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +37,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70349199022380
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: capybara
-  requirement: &70349199021960 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +53,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70349199021960
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bourne
-  requirement: &70349199021540 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +69,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70349199021540
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70349199021120 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,7 +85,28 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70349199021120
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Test your ActionMailer and Mailer messages in Capybara
 email:
 - bcardarella@gmail.com
@@ -74,7 +115,6 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- LICENSE
 - README.md
 - lib/capybara-email.rb
 - lib/capybara/email.rb
@@ -96,17 +136,22 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 511581874085042611
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 511581874085042611
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.15
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Test your ActionMailer and Mailer messages in Capybara
 test_files: []
-has_rdoc: 

data/LICENSE

@@ -1,22 +0,0 @@
-Copyright (c) 2012 Brian Cardarella
-
-MIT License
-
-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.