mx_record 0.1.0 → 0.1.3

data/Gemfile

@@ -1,13 +1,8 @@
 source "http://rubygems.org"
-# Add dependencies required to use your gem here.
-# Example:
-#   gem "activesupport", ">= 2.3.5"
 
-# Add dependencies to develop your gem here.
-# Include everything needed to run rake, tests, features, etc.
 group :development, :test do
   gem "shoulda", ">= 0"
   gem "rdoc", "~> 3.12"
-  gem "bundler", "~> 1.0.0"
+  gem "bundler", "~> 1.2.3"
   gem "jeweler", "~> 1.8.3"
-end
+end

data/Gemfile.lock

@@ -1,23 +1,39 @@
 GEM
   remote: http://rubygems.org/
   specs:
+    activesupport (3.2.11)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    bourne (1.1.2)
+      mocha (= 0.10.5)
     git (1.2.5)
-    jeweler (1.8.3)
+    i18n (0.6.1)
+    jeweler (1.8.4)
       bundler (~> 1.0)
       git (>= 1.2.5)
       rake
       rdoc
-    json (1.6.5)
-    rake (0.9.2.2)
+    json (1.7.6)
+    metaclass (0.0.1)
+    mocha (0.10.5)
+      metaclass (~> 0.0.1)
+    multi_json (1.5.0)
+    rake (10.0.3)
     rdoc (3.12)
       json (~> 1.4)
-    shoulda (2.11.3)
+    shoulda (3.3.2)
+      shoulda-context (~> 1.0.1)
+      shoulda-matchers (~> 1.4.1)
+    shoulda-context (1.0.2)
+    shoulda-matchers (1.4.2)
+      activesupport (>= 3.0.0)
+      bourne (~> 1.1.2)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.0.0)
+  bundler (~> 1.2.3)
   jeweler (~> 1.8.3)
   rdoc (~> 3.12)
   shoulda

data/README.md

@@ -1,6 +1,18 @@
 # mx_record
 
-> A mail exchanger record (MX record) is a type of resource record in the Domain Name System that specifies a mail server responsible for accepting email messages on behalf of a recipient's domain, and a preference value used to prioritize mail delivery if multiple mail servers are available. The set of MX records of a domain name specifies how email should be routed with the Simple Mail Transfer Protocol [[more](http://en.wikipedia.org/wiki/MX_record)].
+A mail exchanger record (MX record) is a type of resource record in the Domain Name System that specifies a mail server responsible for accepting email messages on behalf of a recipient's domain, and a preference value used to prioritize mail delivery if multiple mail servers are available. The set of MX records of a domain name specifies how email should be routed with the Simple Mail Transfer Protocol [[more](http://en.wikipedia.org/wiki/MX_record)].
+
+# Usage
+
+```ruby
+MXRecord::get_server('google.com')
+  #=> aspmx.l.google.com
+```
+
+```ruby
+MXRecord::get_server('rangers.co.uk')
+  #=> mail.rangers.co.uk
+```
 
 # Contributing to mx_record
 

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.3

data/lib/mx_record.rb

@@ -1,17 +1,35 @@
 require 'resolv'
 
 module MXRecord
-  def self.get_server(domain)
-    mx = nil
+
+  # Obtain the mail exchange record for a particular domain.
+  #
+  # Returns an array of Resolv::DNS::Resource::IN::MX records e.g. for Google:
+  #
+  # [ #<Resolv::DNS::Resource::IN::MX:0x007faaac870da8 @preference=50, @exchange=#<Resolv::DNS::Name: alt4.aspmx.l.google.com.>, @ttl=347>,
+  #   #<Resolv::DNS::Resource::IN::MX:0x007faaac8769b0 @preference=20, @exchange=#<Resolv::DNS::Name: alt1.aspmx.l.google.com.>, @ttl=347>,
+  #   #<Resolv::DNS::Resource::IN::MX:0x007faaac874db8 @preference=40, @exchange=#<Resolv::DNS::Name: alt3.aspmx.l.google.com.>, @ttl=347>,
+  #   #<Resolv::DNS::Resource::IN::MX:0x007faaac87abf0 @preference=30, @exchange=#<Resolv::DNS::Name: alt2.aspmx.l.google.com.>, @ttl=347>,
+  #   #<Resolv::DNS::Resource::IN::MX:0x007faaac87f830 @preference=10, @exchange=#<Resolv::DNS::Name: aspmx.l.google.com.>, @ttl=347> ]
+  def self.mail_servers(domain)
     Resolv::DNS.open do |dns|
-      mail_servers = dns.getresources(domain, Resolv::DNS::Resource::IN::MX)
-      return nil unless mail_servers and not mail_servers.empty?
-      highest_priority = mail_servers.first
-      mail_servers.each do |server|
-        highest_priority = server if server.preference < highest_priority.preference
-      end
-      mx = highest_priority.exchange.to_s
+      dns.getresources(domain, Resolv::DNS::Resource::IN::MX)
     end
-    return mx
+  end
+
+  # Obtain the preferred mail server based on the MX record's preference.
+  #
+  # Returns a String containing the mail server name e.g. aspmx.l.google.com;
+  # returns nil if no servers are found.
+  def self.primary_server(domain)
+    servers = mail_servers(domain)
+
+    primary_server = servers.first
+
+    servers.each do |server|
+      primary_server = server if server.preference < primary_server.preference
+    end
+
+    primary_server.exchange.to_s
   end
 end

data/mx_record.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "mx_record"
-  s.version = "0.1.0"
+  s.version = "0.1.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Lee Reilly"]
-  s.date = "2012-04-23"
+  s.date = "2013-01-22"
   s.description = "Find MX records for a given domain name"
   s.email = "lee@leereilly.net"
   s.extra_rdoc_files = [
@@ -17,7 +17,6 @@ Gem::Specification.new do |s|
     "README.md"
   ]
   s.files = [
-    ".rbenv-version",
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
@@ -32,7 +31,7 @@ Gem::Specification.new do |s|
   s.homepage = "http://github.com/leereilly/mx_record"
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.21"
+  s.rubygems_version = "1.8.23"
   s.summary = "Find MX records for a given domain name"
 
   if s.respond_to? :specification_version then
@@ -41,18 +40,18 @@ Gem::Specification.new do |s|
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_development_dependency(%q<shoulda>, [">= 0"])
       s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
-      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.2.3"])
       s.add_development_dependency(%q<jeweler>, ["~> 1.8.3"])
     else
       s.add_dependency(%q<shoulda>, [">= 0"])
       s.add_dependency(%q<rdoc>, ["~> 3.12"])
-      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.2.3"])
       s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
     end
   else
     s.add_dependency(%q<shoulda>, [">= 0"])
     s.add_dependency(%q<rdoc>, ["~> 3.12"])
-    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.2.3"])
     s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
   end
 end

data/test/test_mx_record.rb

@@ -1,8 +1,22 @@
 require 'helper'
 
 class TestMxRecord < Test::Unit::TestCase
-  should "probably rename this file and start testing for real" do
-    mx_server = MXRecord::get_server('google.com')
+  should "obtain the highest priority mail server" do
+    mx_server = MXRecord::primary_server('google.com')
     assert_equal 'aspmx.l.google.com', mx_server
   end
+
+  should "obtain all of the mail servers" do
+    mx_servers = MXRecord::mail_servers('google.com')
+    assert_equal 5, mx_servers.size
+  end
+
+  should "return nothing when valid domains have no mail servers" do
+    assert_equal [], MXRecord::mail_servers('example.com')
+  end
+
+  should "return nothing when invalid domains are supplied" do
+    assert_equal [], MXRecord::mail_servers('git.hub')
+  end
+
 end

metadata

@@ -1,72 +1,88 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: mx_record
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 0.1.3
   prerelease: 
-  version: 0.1.0
 platform: ruby
-authors: 
+authors:
 - Lee Reilly
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-04-23 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2013-01-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: shoulda
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: "3.12"
+      - !ruby/object:Gem::Version
+        version: '3.12'
   type: :development
   prerelease: false
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: 1.0.0
+      - !ruby/object:Gem::Version
+        version: 1.2.3
   type: :development
   prerelease: false
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.3
+- !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
+      - !ruby/object:Gem::Version
         version: 1.8.3
   type: :development
   prerelease: false
-  version_requirements: *id004
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.3
 description: Find MX records for a given domain name
 email: lee@leereilly.net
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - LICENSE.txt
 - README.md
-files: 
-- .rbenv-version
+files:
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -78,34 +94,31 @@ files:
 - test/helper.rb
 - test/test_mx_record.rb
 homepage: http://github.com/leereilly/mx_record
-licenses: 
+licenses:
 - MIT
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: -1185378686703042268
-      segments: 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
       - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+      hash: 2296114277497960799
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.8.21
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Find MX records for a given domain name
 test_files: []
-

data/.rbenv-version

@@ -1 +0,0 @@
-1.9.2-p290