email_repair 1.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: a87714cd558a4ce9a5ffe176b2dcfc379f2b771b
-  data.tar.gz: 8322e71366d7e121483b368cdfa83e235d413560
+SHA256:
+  metadata.gz: b61b1b2063f88892f084765ac14f503779b4b8ec762d913be9fa0c8e37c4e9e3
+  data.tar.gz: e5dc3b00f01d7f403e7bf2a3424d6054d24980003f3f72232a612b812b17f58a
 SHA512:
-  metadata.gz: 8771c5ce3aa48dec34961e30285df05f14b1d99711772248f94306b23d573c5f5d4bc00ca8c1f9a5d50a2fa927b3504f55656176fb8664937a26249ecc6e93f7
-  data.tar.gz: 1c8f55a9e3e83df59cbb22d1994977455d904645701c2b685b48107985654e14a4a592d6ae3e518b04e56f5161334f6de279bd8cd1a89dd0c28be20d3dc153d5
+  metadata.gz: 1e2a4144f8eda61738f62bdfe3f2530143eb75aca458f9f580e90f5342d9d006aefb87c58bca26784fb5fa8ce82acdc8c69c94ce33f1867849ec5a7d4f8e52a9
+  data.tar.gz: 521aaa4e93c7d06e75541d1e2841d60672b453b48a87223984d3972b618ead34b45d89af0fc5d6cdf2943b972358bfe56b8b5a8f79a9d98003ff7bc103bc6149

data/README.md

@@ -4,7 +4,8 @@
 [![Build Status](https://travis-ci.org/ChalkSchools/email-repair.svg?branch=master)](https://travis-ci.org/ChalkSchools/email-repair)
 [![Coverage Status](https://img.shields.io/coveralls/ChalkSchools/email-repair.svg)](https://coveralls.io/r/ChalkSchools/email-repair?branch=master)
 
-TODO: Write a gem description
+Email Repair is a utility for sanitizing and validating user-provided email
+address.
 
 ## Installation
 
@@ -22,7 +23,72 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+```ruby
+require 'email_repair'
+require 'ostruct'
+
+EmailRepair::Mechanic.new.repair('blah@gmail')
+# "blah@gmail.com"
+
+EmailRepair::Mechanic.new.repair_all(%w[One@@two.com bleep@blop plooooooop])
+# <OpenStruct sanitized_emails=["one@two.com"], invalid_emails=["bleep@blop", "plooooooop"]>
+```
+
+### Public Methods
+
+#### EmailRepair::Mechanic#repair(email)
+
+Takes a single email address, applies the available repairs to it and returns
+the repaired email. If the email cannot be repaired, `nil` is returned instead.
+
+#### EmailRepair::Mechanic#repair_all(emails)
+
+Takes an array of emails, applies available repairs to each email and returns an
+`OpenStruct` containing keys `sanitized_emails:` with a unique array of the
+emails that were able to be repaired, and `invalid_emails:` with unique array of
+the emails that were unable to be repaired
+
+#### EmailRepair::Constants::email_regex
+
+Returns a regular expression to be used to validate user-supplied email
+addresses.
+
+### Available Repairs
+
+#### CommonMistakeRepair
+
+Repairs common email typos:
+* downcases the email
+* removes white space
+* removes duplicate @ symbols
+* replaces `.c0m` with `.com`
+* replaces commas with periods
+
+#### CommonDomainSuffixRepair
+
+Adds missing top-level domain for common email domains. For example, it replaces
+`blah@gmail` with `blah@gmail.com`.
+
+#### CommonDomainPeriodAdder
+
+Adds missing period between the domain and top-level domain for common email
+domains. For example, it replaces `blah@gmailcom` with `blah@gmail.com`.
+
+#### CommonDomainAtAdder
+
+Replaces '#', '.', or '-', with '@', or adds missing @ symbol for common
+domains. For example, it replaces `blahgmail.com` and `blah#gmail.com` with
+`blah@gmail.com`.
+
+#### CommonDomainSwapRepair
+
+Fixes swapped letters ('ia' instead of 'ai') in common domains. For example, it
+replaces `blah@gmial.com` with `blah@gmail.com`.
+
+#### EmailRegexRepair
+
+Extracts the email address from strings that contain other text. For example, it
+replaces `blah <blah@email.com>` with `blah@email.com`.
 
 ## Contributing
 

data/lib/email_repair/constants.rb

@@ -4,7 +4,7 @@ module EmailRepair
       def email_regex
         local_part_regex = "[#{valid_chars}]" \
           "([#{valid_chars_with_dot}]*[#{valid_chars}])?"
-        /#{local_part_regex}@(?:[a-z0-9\-]+\.)+(?:[a-z]{2,24})/
+        /#{local_part_regex}@(?:[a-zA-Z0-9\-]+\.)+(?:[a-zA-Z]{2,24})/
       end
 
     private
@@ -14,7 +14,7 @@ module EmailRepair
       end
 
       def valid_chars
-        'a-z0-9_%\+\-\''
+        'a-zA-Z0-9_%\+\-\''
       end
     end
   end

data/lib/email_repair/mechanic.rb

@@ -96,8 +96,11 @@ module EmailRepair
 
     class CommonDomainAtAdder < CommonDomainRepair
       def self.repair(email)
+        return email if email.match('.+@.+\..+')
+
         common_domains.each do |name, suffix|
           punc_regex = /[.#-]#{name}.#{suffix}$/
+
           if email.match(punc_regex)
             email = email.sub(punc_regex, "@#{name}.#{suffix}")
           elsif email.match?(/[^@]#{name}.#{suffix}$/)

data/lib/email_repair/version.rb

@@ -1,3 +1,3 @@
 module EmailRepair
-  VERSION = '1.0.0'.freeze
+  VERSION = '2.0.1'.freeze
 end

data/spec/lib/email_repair/constants_spec.rb

@@ -0,0 +1,10 @@
+require 'spec_helper'
+
+module EmailRepair
+  describe Constants, '.email_regex' do
+    it 'allows capital letters' do
+      expect('ICan.CaPitAliZe@hOwI.WanT')
+        .to match(/\A#{EmailRepair::Constants.email_regex}\z/)
+    end
+  end
+end

data/spec/lib/email_repair/mechanic_spec.rb

@@ -123,6 +123,10 @@ module EmailRepair
       end
     end
 
+    it 'does not add an extra @ if there is already one' do
+      expect(mechanic.repair('bloo@myyahoo.com')).to eq 'bloo@myyahoo.com'
+    end
+
     it 'replaces , with .' do
       expect(mechanic.repair('b@b,com')).to eq 'b@b.com'
     end

metadata

@@ -1,17 +1,73 @@
 --- !ruby/object:Gem::Specification
 name: email_repair
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - Holman Gao
 - JT Bowler
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-03-28 00:00:00.000000000 Z
-dependencies: []
-description: 
+date: 2023-08-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.23
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.23
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 13.0.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 13.0.6
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.12.0
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.50.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.50.2
+description:
 email:
 - holman@golmansax.com
 - jbowler2400@gmail.com
@@ -25,13 +81,14 @@ files:
 - lib/email_repair/constants.rb
 - lib/email_repair/mechanic.rb
 - lib/email_repair/version.rb
+- spec/lib/email_repair/constants_spec.rb
 - spec/lib/email_repair/mechanic_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/ChalkSchools/email-repair
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -46,11 +103,11 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.14
-signing_key: 
+rubygems_version: 3.4.10
+signing_key:
 specification_version: 4
 summary: Library to fix invalid emails
 test_files:
-- spec/spec_helper.rb
+- spec/lib/email_repair/constants_spec.rb
 - spec/lib/email_repair/mechanic_spec.rb
+- spec/spec_helper.rb