email_veracity_checker 0.0.1

data/Manifest

@@ -0,0 +1,5 @@
+Manifest
+README
+Rakefile
+email_veracity_checker.gemspec
+lib/email_check.rb

data/README

@@ -0,0 +1,25 @@
+Usage
+=====
+
+Add following entry in your config/environment.rb
+ 
+ config.gem 'email_veracity_checker', :lib => "email_check"
+
+How to use:
+ #first param is user email address
+ #second sender address
+ #third param is domain address
+ 
+ #Note: It's not sending email, at the end point they quit connection.
+
+ EmailCheck.run("kiran@joshsoftware.com","no-reply@joshsoftware.com","joshsoftware.com").valid?
+ 
+ It's return true or false 
+
+
+Notes
+=====
+
+1) Based on: https://github.com/skillnet/validates_email_with_smtp
+
+2) Not really ideal in production because those mail servers might block you

data/Rakefile

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('email_veracity_checker', '0.0.1') do |p|
+  p.description    = "gem that illustrates how to build a gem"
+  p.url            = "https://github.com/joshsoftware/email_veracity_checke"
+  p.author         = "Kiran Chaudhari"
+  p.email          = "kiran@joshsoftware.com"
+  p.ignore_pattern = ["tmp/*", "script/*"]
+  p.development_dependencies = []
+end
+

data/email_veracity_checker.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{email_veracity_checker}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Kiran Chaudhari"]
+  s.date = %q{2010-12-27}
+  s.description = %q{gem that illustrates how to build a gem}
+  s.email = %q{kiran@joshsoftware.com}
+  s.extra_rdoc_files = ["README", "lib/email_check.rb"]
+  s.files = ["Manifest", "README", "Rakefile", "email_veracity_checker.gemspec", "lib/email_check.rb"]
+  s.homepage = %q{https://github.com/joshsoftware/email_veracity_checke}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Email_veracity_checker", "--main", "README"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{email_veracity_checker}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{gem that illustrates how to build a gem}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/email_check.rb

@@ -0,0 +1,125 @@
+require 'resolv'
+require 'net/smtp'
+
+class EmailCheck < Net::SMTP
+
+  class EmailCheckStatus
+    attr_accessor :errors
+
+    def self.rcpt_responses
+      @@rcpt_responses ||=
+        {
+        -1  => :fail,         # Validation failed (non-SMTP)
+        250 => :valid,        # Requested mail action okay, completed
+        251 => :dunno,        # User not local; will forward to <forward-path>
+        550 => :invalid,      # Requested action not taken:, mailbox unavailable
+        551 => :dunno,        # User not local; please try <forward-path>
+        552 => :valid,        # Requested mail action aborted:, exceeded storage allocation
+        553 => :invalid,      # Requested action not taken:, mailbox name not allowed
+        450 => :valid_fails,  # Requested mail action not taken:, mailbox unavailable
+        451 => :valid_fails,  # Requested action aborted:, local error in processing
+        452 => :valid_fails,  # Requested action not taken:, insufficient system storage
+        500 => :fail,         # Syntax error, command unrecognised
+        501 => :invalid,      # Syntax error in parameters or arguments
+        503 => :fail,         # Bad sequence of commands
+        550 => :fail,         # Unknown user
+        521 => :invalid,      # <domain> does not accept mail [rfc1846]
+        421 => :fail,         # <domain> Service not available, closing transmission channel
+      }
+    end
+
+    def initialize(response_code, error = nil)
+      errors = Array.new
+      errors.push error unless error.nil?
+      @response = (self.class.rcpt_responses.has_key?(response_code) ?
+                   response_code : -1)
+    end
+
+    # Symbolic status of mail address verification.
+    #
+    # :fail         Verification failed
+    # :dunno        Verification succeeded, but can't tell about validity
+    # :valid        address known to be valid
+    # :valid_fails  address known to be valid, delivery would have failed temporarily
+    # :invalid      address known to be invalid
+    def status
+      @@rcpt_responses[@response]
+    end
+
+    # true if verified address is known to be valid
+    def valid?
+      [:valid, :valid_fails].include? self.status
+      #puts "[CHECK EMAIL EXISTS] status is #{self.status}."
+    end
+
+    # true if verified address is known to be invalid
+    def invalid?
+      self.status == :invalid
+    end
+  end
+
+  #decoy_from = "development@einsteinindustries.com"
+  #domain = "einsteinindustries.com"
+  #call EmailCheck.run(email, decoy_from, domain, server = nil )
+  def self.run(addr, decoy_from, domain, server = nil)
+    if addr.index('@').nil?
+      ret = EmailCheckStatus.new(-1, error)
+      #puts "[CHECK EMAIL EXISTS] email is #{addr} -> no email specified"
+      return ret
+    end
+
+    server = get_mail_server(addr[(addr.index('@')+1)..-1]) if server.nil?
+    ret = nil
+
+    #puts "[CHECK EMAIL EXISTS] email is #{addr}."
+    #puts "[CHECK EMAIL EXISTS] addr is #{server}."
+
+    begin
+      smtp = EmailCheck.new(server)
+      smtp.set_debug_output $stderr
+      smtp.start(domain)
+      ret = smtp.check_mail_addr(domain, addr, decoy_from)
+      smtp.finish
+
+      if ret.class != String
+        # ruby 1.8.7
+        #puts "[CHECK EMAIL EXISTS] ret success is #{ret.success?}."
+        #puts "[CHECK EMAIL EXISTS] ret message is #{ret.message}."
+        #puts "[CHECK EMAIL EXISTS] ret status is #{ret.status}."
+        ret = EmailCheckStatus.new(ret.message.to_s[0..2].to_i)
+      else
+        # ruby 1.8.5
+        ret = EmailCheckStatus.new(ret[0..2].to_i)
+      end
+    rescue Net::SMTPAuthenticationError, Net::SMTPServerBusy, Net::SMTPSyntaxError, Net::SMTPFatalError, Net::SMTPUnknownError => error
+      ret = EmailCheckStatus.new(error.to_s[0..2].to_i, error)
+      #puts "[CHECK EMAIL EXISTS] ret1 is #{ret}, error is #{error.to_s[0..2]}."
+    rescue IOError, TimeoutError, ArgumentError => error
+      ret = EmailCheckStatus.new(-1, error)
+      #puts "[CHECK EMAIL EXISTS] ret2 is #{ret}, error is #{error}."
+    rescue Exception => error
+      ret = EmailCheckStatus.new(-1, error)
+      #puts "[CHECK EMAIL EXISTS] ret3 is #{ret}, error is #{error}."
+    end
+
+    return ret
+  end
+
+  def check_mail_addr(domain, to_addr, decoy_from = nil)
+    raise IOError, 'closed session' unless @socket
+    raise ArgumentError, 'mail destination not given' if to_addr.empty?
+    helo domain
+    mailfrom decoy_from
+    rcptto to_addr
+  end
+
+  # Gets the MX record
+  # Note: might need to add other records if mx is insufficient
+  def self.get_mail_server(host)
+    res = Resolv::DNS.new.getresources(host, Resolv::DNS::Resource::IN::MX)
+    unless res.empty?
+      return res.sort {|x,y| x.preference <=> y.preference}.first.exchange.to_s
+    end
+    nil
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: email_veracity_checker
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Kiran Chaudhari
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-27 00:00:00 +05:30
+default_executable: 
+dependencies: []
+
+description: gem that illustrates how to build a gem
+email: kiran@joshsoftware.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- lib/email_check.rb
+files: 
+- Manifest
+- README
+- Rakefile
+- email_veracity_checker.gemspec
+- lib/email_check.rb
+has_rdoc: true
+homepage: https://github.com/joshsoftware/email_veracity_checke
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Email_veracity_checker
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: email_veracity_checker
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: gem that illustrates how to build a gem
+test_files: []
+