email_address 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 225554c1b1abf4ead2900a7209b55ec7babeaefe
+  data.tar.gz: 4de853f82e80be5e9e6ce843a16fd2dc3f4a3255
+SHA512:
+  metadata.gz: 11b73a88096b1553dac4aa7979a1a7385c568ae8d5c2dca268c88bf1fd2827aa77bb76e3a412a6cc85d1f5d9983f470a1a6b1840df73d428fbfdae76277bfe9a
+  data.tar.gz: 97b3f3497d00346404b94dbfde915bbbcf1dae41bcbc6d7fc98a4e0dc0072245b57597ca4939295e6db47fc2700ed935add5f8019519389950288f2501ad7bc6

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in email_address.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Allen Fair
+
+MIT License
+
+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.md

@@ -0,0 +1,67 @@
+# EmailAddress
+
+The EmailAddress library is an _opinionated_ email address handler and
+validator. 
+
+So you have an email address input by a user. Do you want to validate
+it, check it for uniqueness, or mine statistics on all your addresses?
+Then the email_address gem is for you!
+
+Opininated? Yes. By default, this does not support RFC822 specification
+because it allows addresses that should never exist for real people.
+By limiting email addresses to a subset of standardly used ones, you can
+remove false positives in validation, and help the email community
+evolve into a friendlier place. I like standards as much as the next
+person, but enough is enough!
+
+Why my opinion? I've been working with email and such since the late
+1990's. I would like to see modern practices applied to email addresses.
+These rules really do apply to most (without real statistics, I'll claim
+99.9+%) usage in the 21st Century. They may not be for everyone, you may
+need strict adherence to these standards for historical reasons, but I
+bet you'll wish you could support this one instead!
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'email_address'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install email_address
+
+## Usage
+
+Inspect your email address string by creating an instance of
+EmailAddress:
+
+    email = EmailAddress.new("user@example.com")
+
+You can see if it validates as an opinionated address:
+
+    email.valid?
+
+This runs the following checks you can do yourself:
+
+    email.valid_format?
+    email.valid_domain?
+    email.valid_user?
+    email.disposable_email?
+    email.spam_trap?
+
+Of course, the last couple tests can't be published, so you can provide
+a callback to check them yourself if you need.
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+
+task :default do
+  sh "ruby test/email_address/*"
+end

data/email_address.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'email_address/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "email_address"
+  spec.version       = EmailAddress::VERSION
+  spec.authors       = ["Allen Fair"]
+  spec.email         = ["allen.fair@gmail.com"]
+  spec.description   = %q{The EmailAddress library is an _opinionated_ email address handler and
+validator.}
+  spec.summary       = %q{EmailAddress checks on validates an acceptable set of email addresses.}
+  spec.homepage      = "https://github.com/afair/email_address"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "simpleidn"
+end

data/lib/email_address.rb

@@ -0,0 +1,145 @@
+#require "email_address/version"
+#require "email_address/config"
+#require "email_address/host"
+#require "email_address/address"
+require 'simpleidn'
+
+class EmailAddress
+  attr_reader :address, :local, :account, :tag, :comment,
+    :domain, :subdomains, :domain_name, :base_domain, :top_level_domain
+
+  def initialize(email)
+    self.address = email
+  end
+
+  ##############################################################################
+  # Basic email address: local@domain
+  # Only supporting FQDN's (Fully Qualified Domain Names)?
+  # Length: Up to 254 characters
+  ##############################################################################
+  def address=(email)
+    @address = email.strip
+    (local_name, domain_name) = @address.split('@')
+    self.domain = domain_name
+    self.local  = local_name
+    @address
+  end
+
+  def to_s
+    [local, domain].join('@')
+  end
+
+  ##############################################################################
+  # Domain Parsing
+  # Parts: subdomains.basedomain.top-level-domain
+  # IPv6/IPv6: [128.0.0.1], [IPv6:2001:db8:1ff::a0b:dbd0]
+  # Comments: (comment)example.com, example.com(comment)
+  # Internationalized: Unicode to Punycode
+  # Length: up to 255 characters
+  ##############################################################################
+  def domain=(host_name)
+    host_name ||= ''
+    @domain = host_name.strip.downcase
+    parse_domain
+    @domain
+  end
+
+  def parse_domain
+    @subdomains = @base_domain = @domain_name = @top_level_domain = ''
+    # Patterns: *.com, *.xx.cc, *.cc
+    if @domain =~ /\A(.+)\.(\w{3,10})\z/ || @domain =~ /\A(.+)\.(\w{1,3}\.\w\w)\z/ || @domain =~ /\A(.+)\.(\w\w)\z/
+      @top_level_domain = $2;
+      sld = $1 # Second level domain
+      if sld =~ /\A(.+)\.(.+)\z/ # is subdomain? sub.example [.tld]
+        @subdomains  = $1
+        @base_domain = $2
+      else
+        @subdomains  = ""
+        @base_domain = sld
+      end
+      @domain_name  = @base_domain + '.' + @top_level_domain
+    end
+  end
+
+  def dns_hostname
+    @dns_hostname ||= SimpleIDN.to_ascii(domain)
+  end
+
+  ##############################################################################
+  # Parsing id provider-dependent, but RFC allows:
+  # A-Z a-z 0-9 . ! # $ % ' * + - / = ? ^ _ { | } ~
+  # Quoted: space ( ) , : ; < > @ [ ]
+  # Quoted-Backslash-Escaped: \ "
+  # Quote local part or dot-separated sub-parts x."y".z
+  # (comment)mailbox | mailbox(comment)
+  # 8-bit/UTF-8: allowed but mail-system defined
+  # RFC 5321 also warns that "a host that expects to receive mail SHOULD avoid defining mailboxes where the Local-part requires (or uses) the Quoted-string form".
+  # Postmaster: must always be case-insensitive
+  # Case: sensitive, but usually treated as equivalent
+  # Local Parts: comment, account tag
+  # Length: upt o 64 cgaracters
+  ##############################################################################
+  def local=(local)
+    local ||= ''
+    @local = local.strip.downcase
+    @account = parse_comment(@local)
+    (@account, @tag) = @account.split(tag_separator)
+    @tag ||= ''
+
+    @local
+  end
+
+  def parse_comment(local)
+    if local =~ /\A\((.+?)\)(.+)\z/
+      (@comment, local) = [$1, $2]
+    elsif @local =~ /\A(.+)\((.+?)\)\z/
+      (@comment, local) = [$1, $2]
+    else
+      @comment = '';
+    end
+    local
+  end
+
+  ##############################################################################
+  # Provider-Specific Settings
+  ##############################################################################
+
+  def provider
+   # @provider ||= EmailProviders::Default.new
+   'unknown'
+  end
+
+  def tag_separator
+   '+'
+  end
+
+  def case_sensitive_local
+   false
+  end
+
+  # Returns the unique address as simplified account@hostname
+  def unique_address
+    "#{account}@#{dns_hostname}".downcase
+  end
+
+  # Letters, numbers, period (no start) 6-30chars
+  def user_pattern
+   /\A[a-z0-9][\.a-z0-9]{0,29}\z/i
+  end
+
+  ##############################################################################
+  # Validations -- Eventually a provider-sepecific check
+  ##############################################################################
+  def valid?
+    return false unless @local =~ user_pattern
+    return false unless provider # .valid_domain
+    true
+  end
+
+  def valid_format?
+    return false unless @local.match(user_pattern)
+    return false unless @host.valid_format?
+    true
+  end
+
+end

data/lib/email_address/address.rb

@@ -0,0 +1,4 @@
+module EmailAddress
+  class Address
+  end
+end

data/lib/email_address/config.rb

@@ -0,0 +1,4 @@
+module EmailAddress
+  class Config
+  end
+end

data/lib/email_address/esp.rb

@@ -0,0 +1,4 @@
+module EmailAddress
+  class Esp
+  end
+end

data/lib/email_address/host.rb

@@ -0,0 +1,6 @@
+module EmailAddress
+  class Host
+    def domain
+    end
+  end
+end

data/lib/email_address/local.rb

@@ -0,0 +1,4 @@
+module EmailAddress
+  class Local
+  end
+end

data/lib/email_address/providers/default.rb

@@ -0,0 +1,8 @@
+module EmailAddress
+  module Providers
+    class Default
+      def initialize(local, host)
+      end
+    end
+  end
+end

data/lib/email_address/providers/google.rb

@@ -0,0 +1,8 @@
+module EmailAddress
+  module Providers
+    class Google < EmailAddress::Providers::Default
+      def initialize(local, host)
+      end
+    end
+  end
+end

data/lib/email_address/version.rb

@@ -0,0 +1,3 @@
+module EmailAddress
+    VERSION = "0.0.1"
+end

data/lib/email_providers/address.rb

@@ -0,0 +1,102 @@
+module EmailAddress
+
+  # EmailAddress::Address - Inspects a Email Address.
+  #
+  # * hostname - Everything to the rigth of the @
+  # * mailbox - Everything to the left of the @
+  #
+  class Address
+    attr_reader :address, :mailbox, :host, :account, :tags
+
+    def initialize(mailbox, host_object)
+      self.mailbox = mailbox
+      @host        = host_object
+    end
+
+    def mailbox=(mailbox)
+      @mailbox = mailbox.strip.downcase
+      (@account, @tags) = @mailbox.split(tag_separator)
+      @mailbox
+    end
+
+    def address=(address)
+      @address = address.strip
+      (mailbox_name, host_name) = @address.split(/\@/)
+      return unless host_part
+
+      @mailbox_name = mailbox_name
+      @host         = EmailAddress::Host.new(host_part)
+      @mailbox      = host.provider_mailbox(mailbox_part, @host)
+      @address
+    end
+
+    def provider
+     'unknown'
+    end
+
+    def tag_separator
+     '+'
+    end
+
+    def case_sensitive_mailbox
+     false
+    end
+
+   # Letters, numbers, period (no start) 6-30chars
+   def user_pattern
+     /\A[a-z0-9][\.a-z0-9]{5,29}\z/i
+   end
+
+    # Returns the unique address as simplified account@hostname
+    def unique_address
+      "#{account}@#{dns_hostname}"
+    end
+
+    def valid?
+      return false unless @mailbox.valid?
+      return false unless @host.valid?
+      true
+    end
+
+    def valid_format?
+      return false unless @mailbox.match(user_pattern)
+      return false unless @host.valid_format?
+      true
+    end
+    
+    ############################################################################
+    # Host Deletation: domain parts
+    ############################################################################
+
+    # Returns the fully-qualified host name (everything to the right of the @).
+    def hostname
+      host.host
+    end
+
+    # Returns the host without any subdomains (domain.tld(
+    def domain_name
+      host.domain_name
+    end
+
+    # Returns the Top-Level-Domain parts (after domain): com, co.jp
+    def tld
+      host.tld
+    end
+
+    # Returns the registration name without subdomains or TLD.
+    def base_domain 
+      host.base_domain
+    end
+
+    # Returns any given subdomains of the domain name
+    def subdomains
+      host.subdomains
+    end
+
+    # Returns an ASCII name for DNS lookup, Punycode for Unicode domains.
+    def dns_hostname
+      host.dns_hostname
+    end
+
+  end
+end

data/lib/email_providers/config.rb

@@ -0,0 +1,36 @@
+module EmailAddress
+  class Config
+
+    # EmailAddress::Config.add_provider(:google, domain_names:["gmail.com", "googlemail.com", "google.com"])
+    def self.add_provider(provider, matches={})
+      @pmatch ||= []
+      @pmatch << matches
+    end
+
+    # EmailAddress::Config.config do .... end
+    def self.setup(&block)
+      @config = Config::DSL.new(&block)
+      @config.instance_eval(&block)
+    end
+
+    def self.get
+      @config
+    end
+
+    class DSL
+      attr_accessor :provider_matching_rules
+      def add_provider(provider, matches={})
+        puts provider, matches
+        @provider_matching_rules ||= []
+        @provider_matching_rules << {provider:provider, matches:matches}
+      end
+    end
+  end
+end
+
+
+#EmailAddress::Config.setup do 
+#  add_provider :google, domain_names:["gmail.com", "googlemail.com", "google.com"]
+#end
+
+#puts EmailAddress::Config.provider_matching_rules

data/lib/email_providers/factory.rb

@@ -0,0 +1,17 @@
+module EmailAddress
+
+  # EmailAddress::Address - Inspects a Email Address.
+  #
+  # Format: mailbox@hostname
+  #
+  class Factory
+    attr_reader :mailbox, :host
+
+    def address(address)
+      (@mailbox, host) = address.strip.split(/\@/)
+      return unless host
+      @host = EmailAddress::Host.new(host)
+      @mailbox = @host.provider_address(@mailbox)
+    end
+  end
+end

data/lib/email_providers/host.rb

@@ -0,0 +1,87 @@
+# EmailAddress::Address
+# EmailAddress::Host
+# EmailAddress::MailExchanger
+# EmailAddress::Config
+# EmailAddress::EspMapping
+# EmailAddress::Esp::Base, Yahoo, Msn, ...
+
+require 'simpleidn'
+
+module EmailAddress
+
+  # EmailAddress::Host handles mail host properties of an email address
+  # The host is typically the data to the right of the @ in the address
+  # and consists of:
+  #
+  # * hostname - full name of DNS host with the MX record.
+  # * domain_name - generally, the name and TLD without subdomain
+  # * base_domain - the identity name of the domain name, without the tld
+  # * tld (top-level-domain), like .com, .co.jp, .com.xx, etc.
+  # * subdomain - optional name of server/service under the domain
+  # * esp (email service provider) a name of the provider: yahoo, msn, etc.
+  # * dns_hostname - Converted hostname Unicode to Punycode
+
+  class Host
+    attr_reader :host, :domain_name, :tld, :base_domain, :subdomains, :dns_hostname
+
+    def initialize(host)
+      host.gsub!(/\A.*@/, '')
+      host.downcase!
+      self.host = host
+    end
+
+    def address(mailbox)
+      # Determine EmailAddress::Provider::Xxxx
+      EmailAddress::Address.new(mailbox, self)
+    end
+
+    def host=(host)
+      @host = host
+      # Patterns: *.com, *.xx.cc, *.cc
+      if @host =~ /(.+)\.(\w{3,10})\z/ || @host =~ /(.+)\.(\w{1,3}\.\w\w)\z/ || @host =~ /(.+)\.(\w\w)\z/
+        @tld = $2;
+        sld = $1 # Second level domain
+        if @sld =~ /(.+)\.(.+)$/ # is subdomain?
+          @subdomains = $1
+          @base_domain = $2
+        else
+          @subdomains = ""
+          @base_domain = sld
+        end
+        @domain_name  = @base_domain + '.' + @tld
+        @dns_hostname = SimpleIDN.to_ascii(@host)
+        @host
+      end
+    end
+
+    # Resets the host to the domain name, dropping any subdomain
+    def drop_subdomain!
+      self.hostname = domain_name
+    end
+
+    def valid?
+      return false unless valid_format?
+      return false unless valid_mx?
+      true
+    end
+
+    def valid_format?
+      Host.valid_format?(@host)
+    end
+
+    def self.valid_format?(host)
+      return false unless host.match(/\A([0-9a-z\-]{1,63}\.)+[a-z0-9\-]{2,15}\z/)
+      return false unless host.length <= 253
+      true
+    end
+
+    def valid_mx?
+      Host.valid_mx?(@host)
+    end
+
+    def self.valid_mx?(host)
+      true
+    end
+
+  end
+end

data/lib/email_providers/mail_exchanger.rb

@@ -0,0 +1,60 @@
+require 'resolv'
+require 'netaddr'
+require 'socket'
+
+class MailExchanger
+  cattr_accessor :domains, :lookups
+  
+  def self.valid_mx?(domain)
+    dns_a_record_exists?(domain) || mxers(domain).size > 0
+  end
+
+  def self.dns_a_record_exists?(domain)
+    @dns_a_record ||= {}
+    @dns_a_record[domain] = false
+    if Socket.gethostbyname(domain)
+      return @dns_a_record[domain] = true
+    end
+  rescue SocketError # not found
+      @dns_a_record[domain] = false
+  end
+
+  # Returns DNS A record results for the domain as: [[domain, ip, 0],...]
+  def self.domain_hosts(domain)
+    @domain_hosts ||= {}
+    @domain_hosts[domain] = []
+    res = TCPSocket.gethostbyname(domain)
+    res = res.slice(3, res.size)
+    res.each { |r| @domain_hosts[domain] << [domain, r, 0] }
+    @domain_hosts[domain]
+
+    rescue SocketError
+      return []
+  end
+
+  # Returns: [["mta7.am0.yahoodns.net", "66.94.237.139", 1], ["mta5.am0.yahoodns.net", "67.195.168.230", 1], ["mta6.am0.yahoodns.net", "98.139.54.60", 1]]
+  # If not found, returns []
+  def self.mxers(domain)
+    @domains ||= {}
+    return @domains[domain] if @domains.key?(domain)
+    @lookups = @lookups ? @lookups + 1 : 1
+    mx = nil
+    mxs = Resolv::DNS.open do |dns|
+      ress = dns.getresources domain, Resolv::DNS::Resource::IN::MX
+      ress.map { |r| [r.exchange.to_s, IPSocket::getaddress(r.exchange.to_s), r.preference] }
+    end
+    @domains[domain] = mxs
+  end
+
+  # Returns an array of MX IP address (String) for the given email domain
+  def self.mx_ips(domain)
+    mxers(domain).map {|m| m[1] }
+  end
+
+  # Given a cidr (ip/bits) and ip address, returns true on match. Caches cidr object.
+  def self.in_cidr?(cidr, ip)
+    @cidrs ||= {}
+    @cidrs[cidr] ||= NetAddr::CIDR.create(cidr)
+    @cidrs[cidr].matches?(ip)
+  end
+end

data/lib/email_providers/mailbox.rb

@@ -0,0 +1,44 @@
+module EmailAddress
+
+  # EmailAddress::Mailbox - Left side of the @
+  #
+  # * mailbox - Everything to the left of the @
+  # * account - part of the mailbox typically sent to a user
+  # * tags - Address tags appended to the account for tracking
+  #
+  class Mailbox
+    attr_reader :mailbox, :account, :tags, :provider
+
+    def initialize(mailbox, mail_provider=nil)
+      @provider = mail_provider
+      @mailbox  = mailbox
+    end
+
+    def to_s
+      @mailbox
+    end
+
+    def mailbox=(mailbox)
+      @mailbox = mailbox.strip.downcase
+      (@account, @tags) = @mailbox.split(@provider.tag_separator)
+      @mailbox
+    end
+
+    def valid?
+      return false unless provider.valid?(mailbox)
+      true
+    end
+
+    def valid_format?
+      return false unless provider.valid_format?(mailbox)
+      #return false unless @mailbox =~ /\A\w[\w\.\-\+\']*\z/
+      true
+    end
+
+    # Returns true if the email account is a standard reserved address
+    def reserved?
+      %Q(postmaster abuse).include?(account)
+    end
+    
+  end
+end

data/lib/email_providers/providers/default.rb

@@ -0,0 +1,55 @@
+module EmailAddress
+  module Providers
+    class Default
+       def initialize(address)
+         @mailbox = mailbox
+       end
+
+       def account(mailbox)
+         mailbox
+       end
+
+       def provider
+         'default'
+       end
+
+       def tag_separator
+         '+'
+       end
+
+       def case_sensitive_mailbox
+         false
+       end
+
+       def max_domain_length
+         253
+       end
+
+       def max_email_length
+         254
+       end
+
+       # Letters, numbers, period (no start) 6-30chars
+       def max_mailbox_length
+         64
+       end
+
+       # Letters, numbers, period (no start) 6-30chars
+       def user_pattern
+         /\A[a-z0-9][\.\'a-z0-9]{5,29}\z/i
+       end
+
+       def valid?
+         return false unless valid_format?
+       end
+
+       def valid_format?
+         return false if mailbox.length > max_mailbox_length
+         return false if address.length > max_email_length
+         return false unless mailbox.to_s.match(user_pattern)
+         true
+       end
+
+    end
+  end
+end

data/lib/email_providers/providers/google.rb

@@ -0,0 +1,27 @@
+module EmailAddress
+  module Providers
+    class Google < Default
+       def account
+         account.gsub(/\./. '')
+       end
+
+       def provider
+         'google'
+       end
+
+       def tag_separator
+         '+'
+       end
+
+       def case_sensitive_mailbox
+         false
+       end
+
+       # Letters, numbers, period (no start) 6-30chars
+       def user_pattern
+         /\A[a-z0-9][\.a-z0-9]{5,29}\z/i
+       end
+
+    end
+  end
+end

data/lib/email_providers/version.rb

@@ -0,0 +1,3 @@
+module EmailAddress
+  VERSION = "0.0.1"
+end

data/test/email_address.rb

@@ -0,0 +1,52 @@
+# encoding: UTF-8
+require_relative 'test_helper'
+
+class TestEmailAddress < MiniTest::Unit::TestCase
+  def test_address
+    a = EmailAddress.new('user@example.com')
+    assert_equal a.local, 'user'
+    assert_equal a.tag, ''
+    assert_equal a.comment, ''
+    assert_equal a.domain, 'example.com'
+    assert_equal a.subdomains, ''
+    assert_equal a.base_domain, 'example'
+    assert_equal a.dns_hostname, 'example.com'
+    assert_equal a.top_level_domain, 'com'
+    assert_equal a.to_s, 'user@example.com'
+  end
+
+  def test_foreign_address
+    a = EmailAddress.new("user@sub.example.co.jp")
+    assert_equal a.domain, "sub.example.co.jp"
+    assert_equal a.subdomains, "sub"
+    assert_equal a.domain_name, "example.co.jp"
+    assert_equal a.base_domain, "example"
+    assert_equal a.top_level_domain, "co.jp"
+  end
+
+  def test_address_tag
+    a = EmailAddress.new('user+etc@example.com')
+    assert_equal a.account, 'user'
+    assert_equal a.tag, 'etc'
+    assert_equal a.unique_address, 'user@example.com'
+  end
+
+  def test_address_comment
+    a = EmailAddress.new('(comment)user@example.com')
+    assert_equal a.comment, 'comment'
+    assert_equal a.account, 'user'
+    assert_equal a.unique_address, 'user@example.com'
+  end
+
+  def test_user_validation
+    a = EmailAddress.new("user@example.co.jp")
+    assert a.valid? == true
+  end
+
+  def test_unicode_domain
+    a = EmailAddress.new("User@København.eu")
+    assert_equal a.dns_hostname, 'xn--kbenhavn-54a.eu'
+    assert_equal a.unique_address, 'user@xn--kbenhavn-54a.eu'
+  end
+
+end

data/test/email_address/address.rb

@@ -0,0 +1,16 @@
+#encoding: utf-8
+require_relative '../test_helper'
+
+class TestAddress < MiniTest::Unit::TestCase
+  def test_address
+    a = EmailAddress.new("User+tag@example.com")
+    assert_equal "user", a.account
+    assert_equal "user+tag", a.local
+    assert_equal "user@example.com", a.unique_address
+  end
+  
+  def test_unicode_user
+    a = EmailAddress.new("å@example.com")
+    assert_equal false, a.valid_format?
+  end
+end

data/test/email_address/config.rb

@@ -0,0 +1,13 @@
+#encoding: utf-8
+require_relative '../test_helper'
+#require 'minitest/autorun'
+
+class TestConfig < MiniTest::Unit::TestCase
+  def test_config
+    EmailAddress::Config.setup do
+      add_provider :google, domain_names: %w(gmail.com googlemail.com google.com)
+    end
+    assert_equal EmailAddress::Config.get.provider_matching_rules.first[:provider], :google
+  end
+  
+end

data/test/email_address/host.rb

@@ -0,0 +1,29 @@
+# encoding: UTF-8
+require_relative '../test_helper'
+
+
+class TestHost < MiniTest::Unit::TestCase
+  def test_host
+    a = EmailAddress::Host.new("example.com")
+    assert_equal "example.com", a.host
+    assert_equal "example.com", a.domain_name
+    assert_equal "example", a.base_domain
+    assert_equal ".com", a.tld
+    assert_equal "", a.subdomains
+  end
+
+  def test_foreign_host
+    a = EmailAddress::Host.new("yahoo.co.jp")
+    assert_equal "yahoo.co.jp", a.host
+    assert_equal "yahoo.co.jp", a.domain_name
+    assert_equal "yahoo", a.base_domain
+    assert_equal "co.jp", a.tld
+    assert_equal "", a.subdomains
+  end
+
+  def test_unicode_host
+    a = EmailAddress::Host.new("å.com")
+    assert_equal "xn--5ca.com", a.dns_hostname
+  end
+
+end

data/test/email_address/mail_exchanger.rb

@@ -0,0 +1,9 @@
+#encoding: utf-8
+require_relative '../test_helper'
+
+class TestMailExchanger < MiniTest::Unit::TestCase
+  def test_exchanger
+    a = EmailAddress::MailExchanger.new("example.com")
+    # assert_equal "user@example.com", a.unique_address
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'minitest/autorun'
+require 'minitest/pride'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'email_address'
+
+# Go!

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: email_address
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Allen Fair
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simpleidn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |-
+  The EmailAddress library is an _opinionated_ email address handler and
+  validator.
+email:
+- allen.fair@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- email_address.gemspec
+- lib/email_address.rb
+- lib/email_address/address.rb
+- lib/email_address/config.rb
+- lib/email_address/esp.rb
+- lib/email_address/host.rb
+- lib/email_address/local.rb
+- lib/email_address/providers/default.rb
+- lib/email_address/providers/google.rb
+- lib/email_address/version.rb
+- lib/email_providers/address.rb
+- lib/email_providers/config.rb
+- lib/email_providers/factory.rb
+- lib/email_providers/host.rb
+- lib/email_providers/mail_exchanger.rb
+- lib/email_providers/mailbox.rb
+- lib/email_providers/providers/default.rb
+- lib/email_providers/providers/google.rb
+- lib/email_providers/version.rb
+- test/email_address.rb
+- test/email_address/address.rb
+- test/email_address/config.rb
+- test/email_address/host.rb
+- test/email_address/mail_exchanger.rb
+- test/test_helper.rb
+homepage: https://github.com/afair/email_address
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0.rc.1
+signing_key: 
+specification_version: 4
+summary: EmailAddress checks on validates an acceptable set of email addresses.
+test_files:
+- test/email_address.rb
+- test/email_address/address.rb
+- test/email_address/config.rb
+- test/email_address/host.rb
+- test/email_address/mail_exchanger.rb
+- test/test_helper.rb
+has_rdoc: