email_validation 1.2.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 1a99ec260f9fa745d734f8c47bfbfefebcd89f63
-  data.tar.gz: 61f2e8d5180e8cb6aadc633ae0cc4174edd35599
+SHA256:
+  metadata.gz: ad4bbc5238fa86bc9d0e786d7d13523e3f531e0d6b3c2b51cf64db6a8123696c
+  data.tar.gz: 2cec8fe9d76667ebe1c4d116b603cda391396a02a062d096f5571ff56128a7c9
 SHA512:
-  metadata.gz: 94398179f18e209e96159c4f32df1c6ce7cc82702f6653b4b2b9caefbb3040a09d086822ed5e310432cb3d75c1ca8b5b8f864a2370629f6c2d24a3f2b9956af7
-  data.tar.gz: 0d3c21aed2a5c7ba5b20c8143353fd9f2367ef67c6a30593bf381386e0fd0d7d9513c674776e32f8d5df0367369f194cd14c2c35208d27e2ad2f701569182183
+  metadata.gz: ab3c73de010a3ee7a22121c21fe09c701105ca0b400effdec17e619dc1a29ea2a3e51ce6e33d7f5626d47e89d96fbc75ba7cb75354bea49a8ee1deec42bc0972
+  data.tar.gz: 18199971b30ed92f7a046b581c6f0f45b6d5702175d6e2c0dcaf96ec7939e19086a5d2b6cb855d84e13f353e124c9c82d68fdcc6ca06e3bb789f16d4d2f93f62

data/.document

@@ -0,0 +1,4 @@
+README.md
+CHANGELOG.md
+lib/**/*.rb
+LICENSE

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format=documentation

data/.ruby-gemset

@@ -0,0 +1 @@
+lev

data/.ruby-version

@@ -0,0 +1 @@
+ruby-4.0.3

data/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to this project are documented here. This project adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2026-05-14
+
+### Breaking
+
+- Minimum Ruby version is now **3.1**.
+- Minimum `activemodel` version is now **6.1**.
+- Depends on `localized_each_validator >= 2.0`.
+
+### Fixed
+
+- The `"Name <addr@host>"` form previously accepted whitespace-only names
+  (e.g. `"   <foo@bar.com>"` would validate). The regex now requires at least
+  one non-whitespace character before the angle-bracketed address.
+- The full RFC 5322 regex (`:format => :rfc5322`) had a corrupted byte range
+  in its IP-literal/quoted-pair clause: `[\x21-\x5a\x53-\x7f]` has been
+  corrected to `[\x21-\x5a\x5c-\x7f]` to match the canonical Cal Henderson
+  source. The original typo caused the character class to over-accept bytes
+  in the `0x53..0x5b` range that should have been excluded.
+
+### Changed
+
+- Packaging rewritten by hand; the jeweler/juwelier-generated gemspec is gone.
+- Version constant now lives in `lib/email_validation/version.rb`.
+- `README.md` rewritten: removed Rails 3 framing, dropped the stale version
+  banner, documented every option (including the previously-undocumented
+  `:allow_blank`), and updated the i18n example to the activemodel-friendly
+  `errors.messages.invalid_email` key.
+- CI moved from Travis to GitHub Actions, matrixing Ruby 3.1-3.4 against
+  activemodel 7.0-8.0.
+
+## [1.2.1] and earlier
+
+See the git history.

data/README.md

@@ -1,49 +1,91 @@
-email_validation
-================
+# email_validation
 
-**Simple email validator for Rails 3+**
+[![CI](https://github.com/RISCfuture/email_validation/actions/workflows/ci.yml/badge.svg)](https://github.com/RISCfuture/email_validation/actions/workflows/ci.yml)
+[![Gem Version](https://img.shields.io/gem/v/email_validation.svg)](https://rubygems.org/gems/email_validation)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-|             |                                 |
-|:------------|:--------------------------------|
-| **Author**  | Tim Morgan                      |
-| **Version** | 1.1.1 (Jul 19, 2011)            |
-| **License** | Released under the MIT license. |
+A simple, localizable email-address validator for any ActiveModel-based class.
 
-About
------
+|              |                                  |
+|:-------------|:---------------------------------|
+| **Author**   | Tim Morgan                       |
+| **License**  | Released under the MIT license.  |
 
-This gem adds a very simple email address format validator to be used with
-ActiveRecord models in Rails 3.0+. It supports localized error messages.
+## About
 
-Installation
-------------
+`email_validation` adds an `EachValidator` for email addresses. It works with
+any class that includes `ActiveModel::Validations` (ActiveRecord models, plain
+Ruby objects with `include ActiveModel::Model`, etc.) and supports localized
+error messages out of the box.
 
-Add the gem to your project's `Gemfile`:
+## Installation
 
-```` ruby
-gem 'email_validation'
-````
+Add to your `Gemfile`:
 
-Usage
------
+```ruby
+gem "email_validation"
+```
 
-This gem is an `EachValidator`, and thus is used with the `validates` method:
+Then `bundle install`.
+
+## Usage
+
+```ruby
+class User
+  include ActiveModel::Model
+  include ActiveModel::Validations
+
+  attr_accessor :email_address
 
-```` ruby
-class User < ActiveRecord::Base
   validates :email_address,
             presence: true,
-			email: true
+            email:    true
 end
-````
+```
+
+### Options
+
+| Option         | Description                                                                                                                                                                                                                                                              |
+|:---------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `:format`      | Which regex to validate against. Defaults to a loose regex that accepts most real-world addresses. Pass `:rfc5322` for the full RFC 5322 regex, or `:rfc5322_simple` for a simplified variant that rejects common typos (quoted local parts, IP-literal domains, etc.). |
+| `:message`     | A custom error message to use when validation fails.                                                                                                                                                                                                                     |
+| `:allow_nil`   | If `true`, `nil` values pass validation (inherited from `LocalizedEachValidator`).                                                                                                                                                                                       |
+| `:allow_blank` | If `true`, blank values pass validation (inherited from `LocalizedEachValidator`).                                                                                                                                                                                       |
+
+Examples:
+
+```ruby
+validates :email_address, email: true
+validates :email_address, email: { format: :rfc5322 }
+validates :email_address, email: { allow_blank: true }
+validates :email_address, email: { message: "doesn't look like an email" }
+```
 
-The localization key is `invalid_email`, and can be specified in the localized
-YAML file like so:
+The validator also accepts the `Name <addr@host>` form, so values like
+`"Foo Bar <foo@bar.com>"` validate correctly.
 
-```` yaml
+## Localization
+
+The error message key is `invalid_email`. Add a translation to your locale
+files under `errors.messages`:
+
+```yaml
 en:
-  activerecord:
-	errors:
-	  messages:
-	    invalid_email: Email address is invalid.
-````
+  errors:
+    messages:
+      invalid_email: "Email address is invalid."
+```
+
+You can also nest it under `activerecord.errors.messages` (or any of the other
+ActiveModel error-message lookup paths) if you prefer per-model granularity.
+
+## Development
+
+```bash
+bin/setup
+bundle exec rspec
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

data/Rakefile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+begin
+  require "standard/rake"
+rescue LoadError
+  # standard is optional in CI matrix runs
+end
+
+task default: :spec

data/email_validation.gemspec

@@ -1,55 +1,45 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-# stub: email_validation 1.2.0 ruby lib
-
-Gem::Specification.new do |s|
-  s.name = "email_validation"
-  s.version = "1.2.0"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.require_paths = ["lib"]
-  s.authors = ["Tim Morgan"]
-  s.date = "2014-07-09"
-  s.description = "A simple, localizable EachValidator for email address fields in ActiveRecord 3.0."
-  s.email = "git@timothymorgan.info"
-  s.extra_rdoc_files = [
-    "LICENSE",
-    "README.md"
-  ]
-  s.files = [
-    "LICENSE",
-    "README.md",
-    "email_validation.gemspec",
-    "lib/email_validation.rb"
-  ]
-  s.homepage = "http://github.com/riscfuture/email_validation"
-  s.rubygems_version = "2.3.0"
-  s.summary = "Simple email validation in Rails 3"
-
-  if s.respond_to? :specification_version then
-    s.specification_version = 4
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<localized_each_validator>, [">= 1.0.1"])
-      s.add_development_dependency(%q<jeweler>, [">= 0"])
-      s.add_development_dependency(%q<yard>, [">= 0"])
-      s.add_development_dependency(%q<redcarpet>, [">= 0"])
-      s.add_development_dependency(%q<rspec>, [">= 0"])
-    else
-      s.add_dependency(%q<localized_each_validator>, [">= 1.0.1"])
-      s.add_dependency(%q<jeweler>, [">= 0"])
-      s.add_dependency(%q<yard>, [">= 0"])
-      s.add_dependency(%q<redcarpet>, [">= 0"])
-      s.add_dependency(%q<rspec>, [">= 0"])
+# frozen_string_literal: true
+
+# Read VERSION directly without requiring `email_validation/version`, which
+# itself requires `localized_each_validator` — a runtime dep that may not yet
+# be installed when this gemspec is first evaluated.
+version = File.read(File.expand_path("lib/email_validation/version.rb", __dir__))
+           .match(/VERSION\s*=\s*["']([^"']+)["']/)[1]
+
+Gem::Specification.new do |spec|
+  spec.name        = "email_validation"
+  spec.version     = version
+  spec.authors     = ["Tim Morgan"]
+  spec.email       = ["git@timothymorgan.info"]
+
+  spec.summary     = "Simple, localizable email address validator for ActiveModel"
+  spec.description = "A simple, localizable EachValidator for email address fields. " \
+                     "Drop in to any ActiveModel-based class and use `validates :foo, email: true`."
+  spec.homepage    = "https://github.com/RISCfuture/email_validation"
+  spec.license     = "MIT"
+
+  spec.required_ruby_version = ">= 3.1"
+
+  spec.metadata = {
+    "homepage_uri"          => spec.homepage,
+    "source_code_uri"       => "#{spec.homepage}/tree/master",
+    "changelog_uri"         => "#{spec.homepage}/blob/master/CHANGELOG.md",
+    "bug_tracker_uri"       => "#{spec.homepage}/issues",
+    "rubygems_mfa_required" => "true"
+  }
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").select { |f| File.exist?(f) }.reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github .idea Gemfile])
     end
-  else
-    s.add_dependency(%q<localized_each_validator>, [">= 1.0.1"])
-    s.add_dependency(%q<jeweler>, [">= 0"])
-    s.add_dependency(%q<yard>, [">= 0"])
-    s.add_dependency(%q<redcarpet>, [">= 0"])
-    s.add_dependency(%q<rspec>, [">= 0"])
   end
-end
+  spec.require_paths = ["lib"]
 
+  spec.add_dependency "activemodel", ">= 6.1"
+  spec.add_dependency "localized_each_validator", ">= 2.0"
+
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "standard", ">= 1.0"
+end

data/lib/email_validation/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require "localized_each_validator"
+
+class EmailValidator < LocalizedEachValidator
+  VERSION = "2.0.0"
+end

data/lib/email_validation.rb

@@ -1,4 +1,7 @@
-require 'localized_each_validator'
+# frozen_string_literal: true
+
+require "localized_each_validator"
+require "email_validation/version"
 
 # Validates email addresses. Uses the `invalid_email` error message key.
 #
@@ -8,27 +11,34 @@ require 'localized_each_validator'
 # Options
 # -------
 #
-# |              |                                                                                                                                                                                                                                                                     |
-# |:-------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-# | `:format`    | By default, uses a simple email regex that matches most email addresses. If `:rfc_5322`, uses a full RFC 5322 email regex that will match common typos as well. If `:rfc_5322_simple`, uses a simplified version of the previous regex to ignore some common typos. |
-# | `:message`   | A custom message to use if the email is invalid.                                                                                                                                                                                                                    |
-# | `:allow_nil` | If true, `nil` values are allowed.                                                                                                                                                                                                                                  |
+# |                |                                                                                                                                                                                                                                                                     |
+# |:---------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+# | `:format`      | By default, uses a simple email regex that matches most email addresses. If `:rfc5322`, uses a full RFC 5322 email regex that will match common typos as well. If `:rfc5322_simple`, uses a simplified version of the previous regex to ignore some common typos. |
+# | `:message`     | A custom message to use if the email is invalid.                                                                                                                                                                                                                    |
+# | `:allow_nil`   | If true, `nil` values are allowed (inherited from {LocalizedEachValidator}).                                                                                                                                                                                        |
+# | `:allow_blank` | If true, blank values are allowed (inherited from {LocalizedEachValidator}).                                                                                                                                                                                        |
 
 class EmailValidator < LocalizedEachValidator
-  # Regular expression describing valid emails.
-  RFC5322_REGEX        = /(?:[a-z0-9!#$%&'*+\/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+\/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])/i
-  RFC5322_SIMPLE_REGEX = /[a-z0-9!#$%&'*+\/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+\/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?/i
-  BASIC_REGEX          = /[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}/i
+  # Full RFC 5322 regex (Cal Henderson). Matches the vast majority of valid email
+  # addresses including quoted local parts and IP-literal domains.
+  RFC5322_REGEX = %r{(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x5c-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])}i.freeze
+
+  # Simplified RFC 5322 regex - rejects common typos like quoted local parts and
+  # IP-literal domains, but otherwise follows RFC 5322 closely.
+  RFC5322_SIMPLE_REGEX = %r{[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?}i.freeze
+
+  # A loose regex that catches the most common email address formats.
+  BASIC_REGEX = /[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/i.freeze
 
   error_key :invalid_email
 
   # @private
   def valid?(_, _, value)
     regex = case options[:format]
-              when :rfc_5322 then RFC5322_REGEX
-              when :rfc_5322_simple then RFC5322_SIMPLE_REGEX
-              else BASIC_REGEX
+            when :rfc5322 then RFC5322_REGEX
+            when :rfc5322_simple then RFC5322_SIMPLE_REGEX
+            else BASIC_REGEX
             end
-    value =~ /\A#{regex}\z/i || value =~ /\A.+\s+<#{regex}>\z/i
+    (value =~ /\A#{regex}\z/i || value =~ /\A\S.*?\s+<#{regex}>\z/i) != nil
   end
 end

metadata

@@ -1,119 +1,127 @@
 --- !ruby/object:Gem::Specification
 name: email_validation
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Tim Morgan
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: localized_each_validator
+  name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.1
+        version: '6.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.1
+        version: '6.1'
 - !ruby/object:Gem::Dependency
-  name: jeweler
+  name: localized_each_validator
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+        version: '2.0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
-  name: redcarpet
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: standard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
-description: A simple, localizable EachValidator for email address fields in ActiveRecord
-  3.0.
-email: git@timothymorgan.info
+        version: '1.0'
+description: 'A simple, localizable EachValidator for email address fields. Drop in
+  to any ActiveModel-based class and use `validates :foo, email: true`.'
+email:
+- git@timothymorgan.info
 executables: []
 extensions: []
-extra_rdoc_files:
-- LICENSE
-- README.md
+extra_rdoc_files: []
 files:
+- ".document"
+- ".rspec"
+- ".ruby-gemset"
+- ".ruby-version"
+- CHANGELOG.md
 - LICENSE
 - README.md
+- Rakefile
 - email_validation.gemspec
 - lib/email_validation.rb
-homepage: http://github.com/riscfuture/email_validation
-licenses: []
-metadata: {}
-post_install_message: 
+- lib/email_validation/version.rb
+homepage: https://github.com/RISCfuture/email_validation
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/RISCfuture/email_validation
+  source_code_uri: https://github.com/RISCfuture/email_validation/tree/master
+  changelog_uri: https://github.com/RISCfuture/email_validation/blob/master/CHANGELOG.md
+  bug_tracker_uri: https://github.com/RISCfuture/email_validation/issues
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.3.0
-signing_key: 
+rubygems_version: 4.0.11
 specification_version: 4
-summary: Simple email validation in Rails 3
+summary: Simple, localizable email address validator for ActiveModel
 test_files: []