rfc-822 0.2.1

data/.gitignore

@@ -0,0 +1 @@
+pkg

data/LICENSE

@@ -0,0 +1,22 @@
+
+    Copyright (C) 2009 Dimitrij Denissenko
+    Inspired by work of Cal Henderson, Tim Fletcher and Dan Kubb
+    
+	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.textile

@@ -0,0 +1,52 @@
+h1. RFC822
+
+RFC822 compatible email validation and MX record check.
+
+
+h2. Features
+
+* Ruby 1.8 & 1.9 compatible
+* Email validation
+* MX checks (requires 'host' command line application)
+
+
+
+h2. Installation
+
+h6. Download from GitHub
+
+bc. wget http://github.com/dim/rfc-822/tarball/master
+
+h6. As a GEM
+
+bc. gem install rfc-822
+
+h6. Clone from GitHub
+
+bc. git clone git://github.com/dim/rfc-822.git
+
+h6. As a Rails plugin
+
+bc. ruby script/plugin install git://github.com/dim/rfc-822.git
+
+
+
+h2. Usage Examples
+
+bc. validates_format_of :email, :with => RFC822::EMAIL
+
+bc. "user@example.com" =~ RFC822::EMAIL ? puts("Email is valid.") : puts("Email is invalid")
+
+bc. RFC822.mx_records('user@mail.com') # => [#<struct RFC822::MXRecord priority=15, host="mailin-01.mx.aol.com">]
+
+
+
+h2. License
+
+Please see LICENSE document
+
+
+
+h2. Acknowledgements
+
+* Inspired by previous work of Cal Henderson, Tim Fletcher and Dan Kubb.

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rubygems'
+require 'spec/rake/spectask'
+require 'spec/version'
+
+desc 'Default: run specs.'
+task :default => :spec
+
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.spec_opts = ['--colour', '--format', 'profile', '--timeout', '20']
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "rfc-822"
+    gemspec.summary = "RFC822 compatible email validation and MX record check"
+    gemspec.description = "RFC822 compatible email validation and MX record check"
+    gemspec.email = "dimitrij@blacksquaremedia.com"
+    gemspec.homepage = "http://github.com/dim/rfc-822"
+    gemspec.authors = ["Dimitrij Denissenko"]
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.1

data/init.rb

@@ -0,0 +1 @@
+require 'rfc822'

data/lib/rfc822.rb

@@ -0,0 +1,66 @@
+require 'timeout'
+require 'uri'
+
+module RFC822
+  
+  module Patterns
+    
+    def self.compile(string)
+      Regexp.new string, nil, 'n'
+    end
+    
+    QTEXT     = compile "[^\\x0d\\x22\\x5c\\x80-\\xff]"  
+    DTEXT     = compile "[^\\x0d\\x5b-\\x5d\\x80-\\xff]" 
+    
+    ATOM_CORE = compile "[^\\x00-\\x20\\x22\\x28\\x29\\x2c\\x2e\\x3a-\\x3c\\x3e\\x40\\x5b-\\x5d\\x7f-\\xff]+"
+    ATOM_EDGE = compile "[^\\x00-\\x20\\x22\\x28\\x29\\x2c-\\x2e\\x3a-\\x3c\\x3e\\x40\\x5b-\\x5d\\x7f-\\xff]"
+    ATOM      = compile "(?:#{ATOM_EDGE}{1,2}|#{ATOM_EDGE}#{ATOM_CORE}#{ATOM_EDGE})"
+    
+    QPAIR     = compile "\\x5c[\\x00-\\x7f]"
+    QSTRING   = compile "\\x22(?:#{QTEXT}|#{QPAIR})*\\x22"
+    
+    WORD      = compile "(?:#{ATOM}|#{QSTRING})"
+
+    LOCAL_PT  = compile "#{WORD}(?:\\x2e#{WORD})*"
+    ADDRESS   = compile "#{LOCAL_PT}\\x40#{URI::REGEXP::PATTERN::HOSTNAME}"    
+  
+  end
+  
+  MXRecord = Struct.new(:priority, :host)  
+  EMAIL    = /\A#{Patterns::ADDRESS}\z/
+  
+  @@host_command = '/usr/bin/env host'
+  
+  class << self
+    
+    def host_command
+      @@host_command
+    end
+
+    def host_command=(value)
+      @@host_command = value
+    end
+
+    def mx_records(address)
+      address = address.to_s
+      return [] unless address =~ EMAIL
+  
+      Timeout::timeout(2) do 
+        raw_mx_records(address.split('@').last).map do |priority, host|
+          MXRecord.new(priority.to_i, host)
+        end
+      end
+    rescue Timeout::Error
+      []
+    end
+
+    def raw_mx_records(domain)      
+      host_mx(domain).scan(/#{Regexp.escape(domain)}[\w ]+?(\d+) (#{URI::REGEXP::PATTERN::HOSTNAME})\./)      
+    end
+    
+    def host_mx(domain)
+      `#{host_command} -t MX #{domain}`      
+    end
+
+  end
+end

data/rfc-822.gemspec

@@ -0,0 +1,51 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rfc-822}
+  s.version = "0.2.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dimitrij Denissenko"]
+  s.date = %q{2010-08-04}
+  s.description = %q{RFC822 compatible email validation and MX record check}
+  s.email = %q{dimitrij@blacksquaremedia.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.textile"
+  ]
+  s.files = [
+    ".gitignore",
+     "LICENSE",
+     "README.textile",
+     "Rakefile",
+     "VERSION",
+     "init.rb",
+     "lib/rfc822.rb",
+     "rfc-822.gemspec",
+     "spec/helper.rb",
+     "spec/rfc822_spec.rb"
+  ]
+  s.homepage = %q{http://github.com/dim/rfc-822}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{RFC822 compatible email validation and MX record check}
+  s.test_files = [
+    "spec/rfc822_spec.rb",
+     "spec/helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/spec/helper.rb

@@ -0,0 +1,4 @@
+$: << File.dirname(__FILE__) + '/../lib'
+require 'rubygems'
+require 'spec'
+require 'rfc822'

data/spec/rfc822_spec.rb

@@ -0,0 +1,79 @@
+require File.dirname(__FILE__) + '/helper'
+
+describe RFC822 do
+
+  after do
+    RFC822.host_command = '/usr/bin/env host'    
+  end
+  
+  describe 'email pattern' do
+    
+    it 'should match RFC822 compliant addresses' do
+      "user@home".should match(RFC822::EMAIL)
+      "user@home.com".should match(RFC822::EMAIL)
+      "user@dashed-home.info".should match(RFC822::EMAIL)
+      "user@separated.home.info".should match(RFC822::EMAIL)
+      "dashed-user@home.com".should match(RFC822::EMAIL)            
+      "underscored_user@home.com".should match(RFC822::EMAIL)            
+      "separated.user@home.com".should match(RFC822::EMAIL)            
+      "slashed/user@home.com".should match(RFC822::EMAIL)            
+      "plussed+user@home.com".should match(RFC822::EMAIL)            
+      "{wrapped}user@home.com".should match(RFC822::EMAIL)            
+    end
+
+    it 'should not match non-RFC822 compliant addresses' do
+      "user-home".should_not match(RFC822::EMAIL)
+      "@home.com".should_not match(RFC822::EMAIL)
+      "user@".should_not match(RFC822::EMAIL)
+      "user@underscored_home.org".should_not match(RFC822::EMAIL)
+      "user@just,wrong.org".should_not match(RFC822::EMAIL)
+      "user@just/wrong.org".should_not match(RFC822::EMAIL)
+      "user@just wrong.org".should_not match(RFC822::EMAIL)
+      "wrong,user@home.com".should_not match(RFC822::EMAIL)            
+      "wrong-user.@home.com".should_not match(RFC822::EMAIL)            
+      "wrong@user@home.com".should_not match(RFC822::EMAIL)            
+      "wrong user@home.com".should_not match(RFC822::EMAIL)            
+      "wrong(user)@home.com".should_not match(RFC822::EMAIL)            
+    end    
+    
+  end
+  
+  it 'should allow to change the host command' do
+    RFC822.host_command.should == '/usr/bin/env host'
+    RFC822.host_command = '/opt/bin host'
+    RFC822.host_command.should == '/opt/bin host'     
+  end
+  
+  describe 'MX record check' do
+
+    before do
+      RFC822.stub!(:host_mx).and_return(%Q(
+hotmail.com mail is handled by 5 mx3.hotmail.com.
+hotmail.com mail is handled by 5 mx4.hotmail.com.
+hotmail.com mail is handled by 5 mx1.hotmail.com.
+hotmail.com mail is handled by 5 mx2.hotmail.com.
+))
+    end
+
+    it 'should return raw MX records fo a domain' do
+      RFC822.raw_mx_records('hotmail.com').should == [
+        ["5", "mx3.hotmail.com"], 
+        ["5", "mx4.hotmail.com"], 
+        ["5", "mx1.hotmail.com"], 
+        ["5", "mx2.hotmail.com"]
+      ]
+    end
+
+    it 'should return prioritised MX records of an address' do
+      RFC822.mx_records('user@hotmail.com').should have(4).items
+      record = RFC822.mx_records('user@hotmail.com').first
+      record.priority.should == 5
+      record.host.should == "mx3.hotmail.com"
+    end
+
+    it 'should return an empty result if address is invalid' do
+      RFC822.mx_records('user@hotmail@com').should == []
+    end
+   
+  end
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: rfc-822
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 1
+  version: 0.2.1
+platform: ruby
+authors: 
+- Dimitrij Denissenko
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-04 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: RFC822 compatible email validation and MX record check
+email: dimitrij@blacksquaremedia.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.textile
+files: 
+- .gitignore
+- LICENSE
+- README.textile
+- Rakefile
+- VERSION
+- init.rb
+- lib/rfc822.rb
+- rfc-822.gemspec
+- spec/helper.rb
+- spec/rfc822_spec.rb
+has_rdoc: true
+homepage: http://github.com/dim/rfc-822
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  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: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: RFC822 compatible email validation and MX record check
+test_files: 
+- spec/rfc822_spec.rb
+- spec/helper.rb