pony 1.3 → 1.4

data/README.rdoc

@@ -18,7 +18,7 @@ Pony uses /usr/sbin/sendmail to send mail if it is available, otherwise it uses
 This can be over-ridden if you specify a via option:
 
   Pony.mail(:to => 'you@example.com', :via => :smtp) # sends via SMTP
-  
+
   Pony.mail(:to => 'you@example.com', :via => :sendmail) # sends via sendmail
 
 You can also specify options for SMTP:
@@ -63,7 +63,7 @@ Note: An attachment's mime-type is set based on the filename (as dictated by the
 
 Pony allows you to specify custom mail headers
   Pony.mail(
-    :to => 'me@example.com', 
+    :to => 'me@example.com',
     :headers => { "List-ID" => "...", "X-My-Custom-Header" => "what a cool custom header" }
   )
 
@@ -82,18 +82,19 @@ Options passed pretty much directly to Mail
  attachments # see Attachments section above
  headers # see Custom headers section above
  message_id
- sender
+ sender  # Sets "envelope from" (and the Sender header)
+ reply_to
 
 Other options
  via # :smtp or :sendmail, see Transport section above
  via_options # specify transport options, see Transport section above
 
-== Set default options 
+== Set default options
 
 Default options can be set so that they don't have to be repeated. The default options you set will be overriden by any options you pass in to Pony.mail()
 
   Pony.options = { :from => 'noreply@example.com', :via => :smtp, :via_options => { :host => 'smtp.yourserver.com' } }
-  Pony.mail(:to => 'foo@bar') # Sends mail to foo@bar from noreply@example.com using smtp 
+  Pony.mail(:to => 'foo@bar') # Sends mail to foo@bar from noreply@example.com using smtp
   Pony.mail(:from => 'pony@example.com', :to => 'foo@bar') # Sends mail to foo@bar from pony@example.com using smtp
 
 == Help
@@ -134,6 +135,9 @@ mailing list: ponyrb@googlegroups.com
 
 == Releases
 
+1.4
+* Updated docs
+
 1.3
 * Add new option :text_part_charset, which allows you to specify the charset for the text portion
 

data/lib/foo

@@ -0,0 +1,97 @@
+= The express way to send email in Ruby
+
+== Overview
+
+Ruby no longer has to be jealous of PHP's mail() function, which can send an email in a single command.
+
+  Pony.mail(:to => 'you@example.com', :from => 'me@example.com', :subject => 'hi', :body => 'Hello there.')
+  Pony.mail(:to => 'you@example.com', :html_body => '<h1>Hello there!</h1>', :body => "In case you can't read html, Hello there.")
+  Pony.mail(:to => 'you@example.com', :cc => 'him@example.com', :from => 'me@example.com', :subject => 'hi', :body => 'Howsit!')
+
+Any option key may be omitted except for :to. For a complete list of options, see List Of Options section below.
+
+
+== Transport
+
+Pony uses /usr/sbin/sendmail to send mail if it is available, otherwise it uses SMTP to localhost.
+
+This can be over-ridden if you specify a via option:
+
+  Pony.mail(:to => 'you@example.com', :via => :smtp) # sends via SMTP
+
+  Pony.mail(:to => 'you@example.com', :via => :sendmail) # sends via sendmail
+
+You can also specify options for SMTP:
+
+  Pony.mail(:to => 'you@example.com', :via => :smtp, :via_options => {
+    :address        => 'smtp.yourserver.com',
+    :port           => '25',
+    :user_name      => 'user',
+    :password       => 'password',
+    :authentication => :plain, # :plain, :login, :cram_md5, no auth by default
+    :domain         => "localhost.localdomain" # the HELO domain provided by the client to the server
+  }
+
+Gmail example (with TLS/SSL)
+
+  Pony.mail(:to => 'you@example.com', :via => :smtp, :via_options => {
+    :address              => 'smtp.gmail.com',
+    :port                 => '587',
+    :enable_starttls_auto => true,
+    :user_name            => 'user',
+    :password             => 'password',
+    :authentication       => :plain, # :plain, :login, :cram_md5, no auth by default
+    :domain               => "localhost.localdomain" # the HELO domain provided by the client to the server
+  })
+
+And options for Sendmail:
+
+  Pony.mail(:to => 'you@example.com', :via => :smtp, :via_options => {
+    :location  => '/path/to/sendmail' # this defaults to 'which sendmail' or '/usr/sbin/sendmail' if 'which' fails
+    :arguments => '-t' # -t and -i are the defaults
+  }
+
+== Attachments
+
+You can attach a file or two with the :attachments option:
+
+  Pony.mail(..., :attachments => {"foo.zip" => File.read("path/to/foo.zip"), "hello.txt" => "hello!"})
+
+Note: An attachment's mime-type is set based on the filename (as dictated by the ruby gem mime-types).  So 'foo.pdf' has a mime-type of 'application/pdf'
+
+== Custom Headers
+
+Pony allows you to specify custom mail headers
+  Pony.mail(
+    :to => 'me@example.com',
+    :headers => { "List-ID" => "...", "X-My-Custom-Header" => "what a cool custom header" }
+  )
+
+== List Of Options
+
+Options passed pretty much directly to Mail
+ to
+ cc
+ bcc
+ from
+ body # the plain text body
+ html_body # for sending html-formatted email
+ subject
+ charset # In case you need to send in utf-8 or similar
+ attachments # see Attachments section above
+ headers # see Custom headers section above
+ message_id
+ sender  # Sets "envelope from" (and the Sender header)
+ reply_to
+
+Other options
+ via # :smtp or :sendmail, see Transport section above
+ via_options # specify transport options, see Transport section above
+
+== Set default options
+
+Default options can be set so that they don't have to be repeated. The default options you set will be overriden by any options you pass in to Pony.mail()
+
+  Pony.options = { :from => 'noreply@example.com', :via => :smtp, :via_options => { :host => 'smtp.yourserver.com' } }
+  Pony.mail(:to => 'foo@bar') # Sends mail to foo@bar from noreply@example.com using smtp
+  Pony.mail(:from => 'pony@example.com', :to => 'foo@bar') # Sends mail to foo@bar from pony@example.com using smtp

data/lib/pony.rb

@@ -1,32 +1,31 @@
-require 'rubygems'
 require 'mail'
 require 'base64'
 
 # = The express way to send email in Ruby
-# 
+#
 # == Overview
-# 
+#
 # Ruby no longer has to be jealous of PHP's mail() function, which can send an email in a single command.
-# 
+#
 #   Pony.mail(:to => 'you@example.com', :from => 'me@example.com', :subject => 'hi', :body => 'Hello there.')
 #   Pony.mail(:to => 'you@example.com', :html_body => '<h1>Hello there!</h1>', :body => "In case you can't read html, Hello there.")
 #   Pony.mail(:to => 'you@example.com', :cc => 'him@example.com', :from => 'me@example.com', :subject => 'hi', :body => 'Howsit!')
-# 
+#
 # Any option key may be omitted except for :to. For a complete list of options, see List Of Options section below.
-# 
-# 
+#
+#
 # == Transport
-# 
+#
 # Pony uses /usr/sbin/sendmail to send mail if it is available, otherwise it uses SMTP to localhost.
-# 
+#
 # This can be over-ridden if you specify a via option:
-# 
+#
 #   Pony.mail(:to => 'you@example.com', :via => :smtp) # sends via SMTP
-#   
+#
 #   Pony.mail(:to => 'you@example.com', :via => :sendmail) # sends via sendmail
-# 
+#
 # You can also specify options for SMTP:
-# 
+#
 #   Pony.mail(:to => 'you@example.com', :via => :smtp, :via_options => {
 #     :address        => 'smtp.yourserver.com',
 #     :port           => '25',
@@ -35,9 +34,9 @@ require 'base64'
 #     :authentication => :plain, # :plain, :login, :cram_md5, no auth by default
 #     :domain         => "localhost.localdomain" # the HELO domain provided by the client to the server
 #   }
-# 
+#
 # Gmail example (with TLS/SSL)
-# 
+#
 #   Pony.mail(:to => 'you@example.com', :via => :smtp, :via_options => {
 #     :address              => 'smtp.gmail.com',
 #     :port                 => '587',
@@ -47,32 +46,32 @@ require 'base64'
 #     :authentication       => :plain, # :plain, :login, :cram_md5, no auth by default
 #     :domain               => "localhost.localdomain" # the HELO domain provided by the client to the server
 #   })
-# 
+#
 # And options for Sendmail:
-# 
+#
 #   Pony.mail(:to => 'you@example.com', :via => :smtp, :via_options => {
 #     :location  => '/path/to/sendmail' # this defaults to 'which sendmail' or '/usr/sbin/sendmail' if 'which' fails
 #     :arguments => '-t' # -t and -i are the defaults
 #   }
-# 
+#
 # == Attachments
-# 
+#
 # You can attach a file or two with the :attachments option:
-# 
+#
 #   Pony.mail(..., :attachments => {"foo.zip" => File.read("path/to/foo.zip"), "hello.txt" => "hello!"})
-# 
+#
 # Note: An attachment's mime-type is set based on the filename (as dictated by the ruby gem mime-types).  So 'foo.pdf' has a mime-type of 'application/pdf'
-# 
+#
 # == Custom Headers
-# 
+#
 # Pony allows you to specify custom mail headers
 #   Pony.mail(
-#     :to => 'me@example.com', 
+#     :to => 'me@example.com',
 #     :headers => { "List-ID" => "...", "X-My-Custom-Header" => "what a cool custom header" }
 #   )
-# 
+#
 # == List Of Options
-# 
+#
 # Options passed pretty much directly to Mail
 #  to
 #  cc
@@ -82,21 +81,23 @@ require 'base64'
 #  html_body # for sending html-formatted email
 #  subject
 #  charset # In case you need to send in utf-8 or similar
+#  text_part_charset # for multipart messages, set the charset of the text part
 #  attachments # see Attachments section above
 #  headers # see Custom headers section above
 #  message_id
 #  sender  # Sets "envelope from" (and the Sender header)
-# 
+#  reply_to
+#
 # Other options
 #  via # :smtp or :sendmail, see Transport section above
 #  via_options # specify transport options, see Transport section above
 #
-# == Set default options 
-# 
+# == Set default options
+#
 # Default options can be set so that they don't have to be repeated. The default options you set will be overriden by any options you pass in to Pony.mail()
-# 
+#
 #   Pony.options = { :from => 'noreply@example.com', :via => :smtp, :via_options => { :host => 'smtp.yourserver.com' } }
-#   Pony.mail(:to => 'foo@bar') # Sends mail to foo@bar from noreply@example.com using smtp 
+#   Pony.mail(:to => 'foo@bar') # Sends mail to foo@bar from noreply@example.com using smtp
 #   Pony.mail(:from => 'pony@example.com', :to => 'foo@bar') # Sends mail to foo@bar from pony@example.com using smtp
 
 
@@ -105,12 +106,12 @@ module Pony
   @@options = {}
 
 # Default options can be set so that they don't have to be repeated.
-# 
+#
 #   Pony.options = { :from => 'noreply@example.com', :via => :smtp, :via_options => { :host => 'smtp.yourserver.com' } }
-#   Pony.mail(:to => 'foo@bar') # Sends mail to foo@bar from noreply@example.com using smtp 
+#   Pony.mail(:to => 'foo@bar') # Sends mail to foo@bar from noreply@example.com using smtp
 #   Pony.mail(:from => 'pony@example.com', :to => 'foo@bar') # Sends mail to foo@bar from pony@example.com using smtp
   def self.options=(value)
-    @@options = value 
+    @@options = value
   end
 
   def self.options()

data/pony.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{pony}
-  s.version = "1.3"
+  s.version = "1.4"
 
   s.description = "Send email in one command: Pony.mail(:to => 'someone@example.com', :body => 'hello')"
   s.summary = s.description

metadata

@@ -1,8 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: pony
 version: !ruby/object:Gem::Version 
+  hash: 7
   prerelease: 
-  version: "1.3"
+  segments: 
+  - 1
+  - 4
+  version: "1.4"
 platform: ruby
 authors: 
 - Adam Wiggins
@@ -11,8 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-06-23 00:00:00 -07:00
-default_executable: 
+date: 2011-11-29 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: mail
@@ -22,6 +25,10 @@ dependencies:
     requirements: 
     - - ">"
       - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 0
         version: "2.0"
   type: :runtime
   version_requirements: *id001
@@ -33,6 +40,11 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 0
+        - 0
         version: 2.0.0
   type: :development
   version_requirements: *id002
@@ -48,10 +60,10 @@ files:
 - README.rdoc
 - Rakefile
 - pony.gemspec
+- lib/foo
 - lib/pony.rb
 - spec/base.rb
 - spec/pony_spec.rb
-has_rdoc: true
 homepage: http://github.com/benprew/pony
 licenses: []
 
@@ -66,17 +78,23 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
 requirements: []
 
 rubyforge_project: pony
-rubygems_version: 1.6.2
+rubygems_version: 1.8.5
 signing_key: 
 specification_version: 3
 summary: "Send email in one command: Pony.mail(:to => 'someone@example.com', :body => 'hello')"