email_list 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rvmrc

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+
+# This is an RVM Project .rvmrc file, used to automatically load the ruby
+# development environment upon cd'ing into the directory
+
+# First we specify our desired <ruby>[@<gemset>], the @gemset name is optional,
+# Only full ruby name is supported here, for short names use:
+#     echo "rvm use ree" > .rvmrc
+environment_id="ree-1.8.7-2011.12@email_list"
+
+#
+# Uncomment the following lines if you want to verify rvm version per project
+#
+# rvmrc_rvm_version="1.10.2" # 1.10.1 seams as a safe start
+# eval "$(echo ${rvm_version}.${rvmrc_rvm_version} | awk -F. '{print "[[ "$1*65536+$2*256+$3" -ge "$4*65536+$5*256+$6" ]]"}' )" || {
+#   echo "This .rvmrc file requires at least RVM ${rvmrc_rvm_version}, aborting loading."
+#   return 1
+# }
+#
+
+#
+# Uncomment following line if you want options to be set only for given project.
+#
+# PROJECT_JRUBY_OPTS=( --1.9 )
+#
+# The variable PROJECT_JRUBY_OPTS requires the following to be run in shell:
+#
+#    chmod +x ${rvm_path}/hooks/after_use_jruby_opts
+#
+
+#
+# First we attempt to load the desired environment directly from the environment
+# file. This is very fast and efficient compared to running through the entire
+# CLI and selector. If you want feedback on which environment was used then
+# insert the word 'use' after --create as this triggers verbose mode.
+#
+if [[ -d "${rvm_path:-$HOME/.rvm}/environments" \
+  && -s "${rvm_path:-$HOME/.rvm}/environments/$environment_id" ]]
+then
+  \. "${rvm_path:-$HOME/.rvm}/environments/$environment_id"
+
+  if [[ -s "${rvm_path:-$HOME/.rvm}/hooks/after_use" ]]
+  then
+    . "${rvm_path:-$HOME/.rvm}/hooks/after_use"
+  fi
+else
+  # If the environment file has not yet been created, use the RVM CLI to select.
+  if ! rvm --create  "$environment_id"
+  then
+    echo "Failed to create RVM environment '${environment_id}'."
+    return 1
+  fi
+fi
+
+#
+# If you use an RVM gemset file to install a list of gems (*.gems), you can have
+# it be automatically loaded. Uncomment the following and adjust the filename if
+# necessary.
+#
+# filename=".gems"
+# if [[ -s "$filename" ]]
+# then
+#   rvm gemset import "$filename" | grep -v already | grep -v listed | grep -v complete | sed '/^$/d'
+# fi
+
+# If you use bundler, this might be useful to you:
+# if [[ -s Gemfile ]] && ! command -v bundle >/dev/null
+# then
+#   printf "%b" "The rubygem 'bundler' is not installed. Installing it now.\n"
+#   gem install bundler
+# fi
+# if [[ -s Gemfile ]] && command -v bundle
+# then
+#   bundle install
+# fi
+
+if [[ $- == *i* ]] # check for interactive shells
+then
+    echo "Using: $(tput setaf 2)$GEM_HOME$(tput sgr0)" # show the user the ruby and gemset they are using in green
+else 
+	echo "Using: $GEM_HOME" # don't use colors in interactive shells
+fi
+

data/Gemfile

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

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec

data/email_list.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "email_list/version"
+
+Gem::Specification.new do |s|
+  s.name        = "email_list"
+  s.version     = EmailList::VERSION
+  s.authors     = ["Michael Guterl"]
+  s.email       = ["michael@diminishing.org"]
+  s.homepage    = "http://github.com/recruitmilitary/email_list"
+  s.summary     = %q{A gem for managing a list of email addresses stored in a string.}
+  s.description = %q{A gem for managing a list of email addresses stored in a string.}
+
+  s.rubyforge_project = "email_list"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec"
+end

data/lib/email_list.rb

@@ -0,0 +1,61 @@
+require "email_list/version"
+
+class EmailList
+
+  EMAIL_ADDRESS_QTEXT           = Regexp.new '[^\\x0d\\x22\\x5c\\x80-\\xff]', nil, 'n'
+  EMAIL_ADDRESS_DTEXT           = Regexp.new '[^\\x0d\\x5b-\\x5d\\x80-\\xff]', nil, 'n'
+  EMAIL_ADDRESS_ATOM            = Regexp.new '[^\\x00-\\x20\\x22\\x28\\x29\\x2c\\x2e\\x3a-\\x3c\\x3e\\x40\\x5b-\\x5d\\x7f-\\xff]+', nil, 'n'
+  EMAIL_ADDRESS_QUOTED_PAIR     = Regexp.new '\\x5c[\\x00-\\x7f]', nil, 'n'
+  EMAIL_ADDRESS_DOMAIN_LITERAL  = Regexp.new "\\x5b(?:#{EMAIL_ADDRESS_DTEXT}|#{EMAIL_ADDRESS_QUOTED_PAIR})*\\x5d", nil, 'n'
+  EMAIL_ADDRESS_QUOTED_STRING   = Regexp.new "\\x22(?:#{EMAIL_ADDRESS_QTEXT}|#{EMAIL_ADDRESS_QUOTED_PAIR})*\\x22", nil, 'n'
+  EMAIL_ADDRESS_DOMAIN_REF      = EMAIL_ADDRESS_ATOM
+  EMAIL_ADDRESS_SUB_DOMAIN      = "(?:#{EMAIL_ADDRESS_DOMAIN_REF}|#{EMAIL_ADDRESS_DOMAIN_LITERAL})"
+  EMAIL_ADDRESS_WORD            = "(?:#{EMAIL_ADDRESS_ATOM}|#{EMAIL_ADDRESS_QUOTED_STRING})"
+  EMAIL_ADDRESS_DOMAIN          = "#{EMAIL_ADDRESS_SUB_DOMAIN}(?:\\x2e#{EMAIL_ADDRESS_SUB_DOMAIN})*"
+  EMAIL_ADDRESS_LOCAL_PART      = "#{EMAIL_ADDRESS_WORD}(?:\\x2e#{EMAIL_ADDRESS_WORD})*"
+  EMAIL_ADDRESS_SPEC            = "#{EMAIL_ADDRESS_LOCAL_PART}\\x40#{EMAIL_ADDRESS_DOMAIN}"
+  EMAIL_ADDRESS_INNER_PATTERN   = Regexp.new "#{EMAIL_ADDRESS_SPEC}", nil, 'n'
+  EMAIL_ADDRESS_EXACT_PATTERN   = Regexp.new "\\A#{EMAIL_ADDRESS_SPEC}\\z", nil, 'n'
+
+  def self.valid?(emails)
+    split(emails).each do |email|
+      unless email =~ EMAIL_ADDRESS_EXACT_PATTERN
+        return false
+      end
+    end
+
+    true
+  end
+
+  def self.split(emails)
+    emails.split(/,|;\s?/).map &:strip
+  end
+
+  include Enumerable
+
+  attr_reader :emails
+
+  def initialize(string)
+    string = '' if string.nil?
+
+    @string = string
+    @emails = EmailList.split(@string)
+  end
+
+  def each(&block)
+    @emails.each(&block)
+  end
+
+  def to_s
+    @string.to_s
+  end
+
+  def ==(other)
+    if other.is_a?(String)
+      emails.sort == EmailList.split(other).sort
+    else
+      emails.sort == other.emails.sort
+    end
+  end
+
+end

data/lib/email_list/version.rb

@@ -0,0 +1,3 @@
+class EmailList
+  VERSION = "0.0.1"
+end

data/spec/email_list_spec.rb

@@ -0,0 +1,104 @@
+require 'email_list'
+
+describe EmailList do
+
+  describe '.valid?' do
+    it 'returns true for a single email address' do
+      EmailList.valid?('foo@example.com').should be_true
+    end
+
+    it 'returns false for a blank string' do
+      EmailList.valid?(' ').should be_false
+    end
+
+    it 'returns false for a bad email' do
+      EmailList.valid?('foo').should be_false
+    end
+
+    it 'returns false when one email in a list is invalid' do
+      EmailList.valid?('foo@example.com, foo@').should be_false
+    end
+
+    it 'returns true for a comma separated list of email addresses' do
+      EmailList.valid?('foo@example.com,bar@example.com').should be_true
+    end
+
+    it 'returns true for a comma separated (with spaces) list of email addresses' do
+      EmailList.valid?('foo@example.com, bar@example.com').should be_true
+    end
+
+    it 'returns true for a comma separated (with multiple spaces) list of email addresses' do
+      EmailList.valid?('foo@example.com,  bar@example.com').should be_true
+    end
+
+    it 'returns true for a semi-colon separated list of email addresses' do
+      EmailList.valid?('foo@example.com;bar@example.com').should be_true
+    end
+
+    it 'returns true for a semi-colon separated (with spaces) list of email addresses' do
+      EmailList.valid?('foo@example.com; bar@example.com').should be_true
+    end
+
+    it 'returns true for a semi-colon separated (with multiple spaces) list of email addresses' do
+      EmailList.valid?('foo@example.com;  bar@example.com').should be_true
+    end
+  end
+
+  describe '.split' do
+    it 'returns a one element array for a single email address' do
+      EmailList.split('foo@example.org').should == ['foo@example.org']
+    end
+
+    it 'returns an array of email addresses for a comma separated list' do
+      EmailList.split('foo@example.org,bar@example.org').should == ['foo@example.org', 'bar@example.org']
+    end
+
+    it 'returns an array of email addresses for a comma separated (with spaces) list' do
+      EmailList.split('foo@example.org,  bar@example.org').should == ['foo@example.org', 'bar@example.org']
+    end
+
+    it 'returns an array of email addresses for a semi-colon separated list' do
+      EmailList.split('foo@example.org;bar@example.org').should == ['foo@example.org', 'bar@example.org']
+    end
+
+    it 'returns an array of email addresses for a semi-colon separated (with spaces) list' do
+      EmailList.split('foo@example.org;  bar@example.org').should == ['foo@example.org', 'bar@example.org']
+    end
+  end
+
+  describe '#to_s' do
+    it 'returns the original string' do
+      string = 'foo@example.org, bar@example.org'
+      email_list = EmailList.new(string)
+
+      email_list.to_s.should == string
+    end
+  end
+
+  it 'behaves like an enumerable' do
+    email_list = EmailList.new('foo@example.org, bar@example.org')
+
+    email_list.map.should == ['foo@example.org', 'bar@example.org']
+  end
+
+  it 'compares against other instances of EmailList' do
+    email_list1 = EmailList.new('foo@example.org, bar@example.org')
+    email_list2 = EmailList.new('bar@example.org, foo@example.org')
+
+    email_list1.should == email_list2
+    email_list2.should == email_list1
+  end
+
+  it 'compares against strings' do
+    string = 'foo@example.org, bar@example.org'
+    email_list = EmailList.new(string)
+
+    email_list.should == string
+  end
+
+  it 'returns an empty email list when given nil' do
+    email_list = EmailList.new(nil)
+
+    email_list.emails.should == []
+  end
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: email_list
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Michael Guterl
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-02-27 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: A gem for managing a list of email addresses stored in a string.
+email: 
+- michael@diminishing.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rvmrc
+- Gemfile
+- Rakefile
+- email_list.gemspec
+- lib/email_list.rb
+- lib/email_list/version.rb
+- spec/email_list_spec.rb
+homepage: http://github.com/recruitmilitary/email_list
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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: email_list
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: A gem for managing a list of email addresses stored in a string.
+test_files: 
+- spec/email_list_spec.rb