smtp_tls 1.0.2 → 1.0.3

data/History.txt

@@ -1,3 +1,12 @@
+=== 1.0.3 / 2009-07-??
+
+* 1 minor enhancement
+  * Added mail_smtp_tls executable to test SMTP connections
+
+* 2 bug fixes
+  * Suppress default DH parameters warning
+  * Pass debug output down to child IOs
+
 === 1.0.2 / 2009-06-25
 
 * 1 major enhancement

data/Manifest.txt

@@ -2,4 +2,5 @@ History.txt
 Manifest.txt
 README.txt
 Rakefile
+bin/mail_smtp_tls
 lib/smtp_tls.rb

data/README.txt

@@ -20,6 +20,51 @@ servers that use STARTTLS.
     server.send_message message, from, to
   end
 
+You can also test your SMTP connection settings using mail_smtp_tls:
+
+  $ date | ruby -Ilib bin/mail_smtp_tls smtp.example.com submission \
+    "your username" "your password" plain \
+    from@example.com to@example.com
+  Using SMTP_TLS 1.0.3
+  -> "220 smtp.example.com ESMTP XXX\r\n"
+  <- "EHLO you.example.com\r\n"
+  -> "250-smtp.example.com at your service, [192.0.2.1]\r\n"
+  -> "250-SIZE 35651584\r\n"
+  -> "250-8BITMIME\r\n"
+  -> "250-STARTTLS\r\n"
+  -> "250-ENHANCEDSTATUSCODES\r\n"
+  -> "250 PIPELINING\r\n"
+  <- "STARTTLS\r\n"
+  -> "220 2.0.0 Ready to start TLS\r\n"
+  TLS connection started
+  <- "EHLO you.example.com\r\n"
+  -> "250-smtp.example.com at your service, [192.0.2.1]\r\n"
+  -> "250-SIZE 35651584\r\n"
+  -> "250-8BITMIME\r\n"
+  -> "250-AUTH LOGIN PLAIN\r\n"
+  -> "250-ENHANCEDSTATUSCODES\r\n"
+  -> "250 PIPELINING\r\n"
+  <- "AUTH PLAIN BASE64_STUFF_HERE\r\n"
+  -> "235 2.7.0 Accepted\r\n"
+  <- "MAIL FROM:<from@example.com>\r\n"
+  -> "250 2.1.0 OK XXX\r\n"
+  <- "RCPT TO:<to@example.com>\r\n"
+  -> "250 2.1.5 OK XXX\r\n"
+  <- "DATA\r\n"
+  -> "354  Go ahead XXX\r\n"
+  writing message from String
+  wrote 91 bytes
+  -> "250 2.0.0 OK 1247028988 XXX\r\n"
+  <- "QUIT\r\n"
+  -> "221 2.0.0 closing connection XXX\r\n"
+
+This will connect to smtp.example.com using the submission port (port 587)
+with a username and password of "your username" and "your password" and
+authenticate using plain-text auth (the submission port always uses SSL) then
+send the current date to to@example.com from from@example.com.
+
+Debug output from the connection will be printed on stderr.
+
 == INSTALL:
 
   sudo gem install smtp_tls

data/bin/mail_smtp_tls

@@ -0,0 +1,53 @@
+#!/usr/bin/env ruby -w
+
+require 'net/smtp'
+require 'rubygems'
+begin
+  require 'smtp_tls'
+rescue LoadError
+end
+
+if defined?(Net::SMTP::SMTP_TLS) then
+  $stderr.puts "Using SMTP_TLS #{Net::SMTP::SMTP_TLS::VERSION}"
+else
+  $stderr.puts "Using ruby's built-in SMTP TLS support"
+end
+
+if ARGV.empty? then
+  puts "#{$0} host port user password auth_type from to"
+  puts "Then type your message on STDIN"
+  abort
+end
+
+host = ARGV.shift
+port = ARGV.shift
+port = if port =~ /\d/ then
+         port.to_i
+       else
+         Socket.getservbyname port
+       end
+user = ARGV.shift
+password = ARGV.shift
+auth_type = ARGV.shift.intern
+from = ARGV.shift
+to = ARGV.shift
+
+message = <<MESSAGE
+From: #{from}\r
+To: #{to}\r
+\r
+#{$stdin.read}
+MESSAGE
+
+begin
+  $stderr.sync = true
+  smtp = Net::SMTP.new host, port
+  smtp.set_debug_output $stderr
+  smtp.enable_starttls if port != Socket.getservbyname('smtp')
+  smtp.start Socket.gethostname, user, password, auth_type do |server|
+    server.send_message message, from, to
+  end
+rescue Net::SMTPError => e
+  puts e.message
+  exit 1
+end

data/lib/smtp_tls.rb

@@ -7,7 +7,7 @@ require 'net/smtp'
 class Net::SMTP
 
   class SMTP_TLS
-    VERSION = '1.0.2'
+    VERSION = '1.0.3'
   end
 
   class << self
@@ -70,6 +70,7 @@ class Net::SMTP
 
     sock = timeout(@open_timeout) { TCPSocket.open @address, @port }
     @socket = Net::InternetMessageIO.new(sock)
+    @socket.debug_output = @debug_output
     @socket.read_timeout = 60 # @read_timeout
 
     check_response(critical { recv_response() })
@@ -77,7 +78,9 @@ class Net::SMTP
 
     raise 'openssl library not installed' unless defined?(OpenSSL)
     starttls
+    @ssl_context.tmp_dh_callback = proc { }
     ssl = OpenSSL::SSL::SSLSocket.new sock, @ssl_context
+    @debug_output << "TLS connection started\n" if @debug_output
     ssl.sync_close = true
     ssl.connect
     if @ssl_context.verify_mode != OpenSSL::SSL::VERIFY_NONE then
@@ -85,6 +88,7 @@ class Net::SMTP
     end
 
     @socket = Net::InternetMessageIO.new ssl
+    @socket.debug_output = @debug_output
     @socket.read_timeout = 60 # @read_timeout
     do_helo helodomain
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: smtp_tls
 version: !ruby/object:Gem::Version 
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors: 
 - Eric Hodel
@@ -31,7 +31,7 @@ cert_chain:
   x52qPcexcYZR7w==
   -----END CERTIFICATE-----
 
-date: 2009-06-25 00:00:00 -07:00
+date: 2009-07-08 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -42,7 +42,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 2.3.0
+        version: 2.3.2
     version: 
 description: |-
   Provides SMTP STARTTLS support for Ruby 1.8.6 (built-in for 1.8.7+).  Simply
@@ -60,11 +60,56 @@ description: |-
     smtp.start Socket.gethostname, user, password, authentication do |server|
       server.send_message message, from, to
     end
+  
+  You can also test your SMTP connection settings using mail_smtp_tls:
+  
+    $ date | ruby -Ilib bin/mail_smtp_tls smtp.example.com submission \
+      "your username" "your password" plain \
+      from@example.com to@example.com
+    Using SMTP_TLS 1.0.3
+    -> "220 smtp.example.com ESMTP XXX\r\n"
+    <- "EHLO you.example.com\r\n"
+    -> "250-smtp.example.com at your service, [192.0.2.1]\r\n"
+    -> "250-SIZE 35651584\r\n"
+    -> "250-8BITMIME\r\n"
+    -> "250-STARTTLS\r\n"
+    -> "250-ENHANCEDSTATUSCODES\r\n"
+    -> "250 PIPELINING\r\n"
+    <- "STARTTLS\r\n"
+    -> "220 2.0.0 Ready to start TLS\r\n"
+    TLS connection started
+    <- "EHLO you.example.com\r\n"
+    -> "250-smtp.example.com at your service, [192.0.2.1]\r\n"
+    -> "250-SIZE 35651584\r\n"
+    -> "250-8BITMIME\r\n"
+    -> "250-AUTH LOGIN PLAIN\r\n"
+    -> "250-ENHANCEDSTATUSCODES\r\n"
+    -> "250 PIPELINING\r\n"
+    <- "AUTH PLAIN BASE64_STUFF_HERE\r\n"
+    -> "235 2.7.0 Accepted\r\n"
+    <- "MAIL FROM:<from@example.com>\r\n"
+    -> "250 2.1.0 OK XXX\r\n"
+    <- "RCPT TO:<to@example.com>\r\n"
+    -> "250 2.1.5 OK XXX\r\n"
+    <- "DATA\r\n"
+    -> "354  Go ahead XXX\r\n"
+    writing message from String
+    wrote 91 bytes
+    -> "250 2.0.0 OK 1247028988 XXX\r\n"
+    <- "QUIT\r\n"
+    -> "221 2.0.0 closing connection XXX\r\n"
+  
+  This will connect to smtp.example.com using the submission port (port 587)
+  with a username and password of "your username" and "your password" and
+  authenticate using plain-text auth (the submission port always uses SSL) then
+  send the current date to to@example.com from from@example.com.
+  
+  Debug output from the connection will be printed on stderr.
 email: 
 - drbrain@segment7.net
 - ""
-executables: []
-
+executables: 
+- mail_smtp_tls
 extensions: []
 
 extra_rdoc_files: 
@@ -76,6 +121,7 @@ files:
 - Manifest.txt
 - README.txt
 - Rakefile
+- bin/mail_smtp_tls
 - lib/smtp_tls.rb
 has_rdoc: true
 homepage: http://seattlerb.rubyforge.org/smtp_tls