localized_each_validator 1.0.3 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: a597e28a4bac415c19364fceea7c8b8957724412
-  data.tar.gz: 32faaee0e6bac011a70b6d0eb7eb14bdcae44391
+SHA256:
+  metadata.gz: c7c26092e8a8fb89fccd9ddccb1c625863774f7f2b616f4af7cac8f9d905b3ed
+  data.tar.gz: 12bd6cf9c5b59cdb66690add58f40f4ef5dd191963522cfcc6e33a7a591b186c
 SHA512:
-  metadata.gz: 8dd43de193eae4c553d378c76c604d074f0881b6ca03476ad2deffdf09f3c62480a4103875725af3f722990a9af339c95222532820abc59c95ec87ad7cbc39d0
-  data.tar.gz: 5b6167cca472fed4c28d60124d897731fe846049be4e1095b9511e199140567d801bee3ebfacf51816c73bf675d62395310f156cb1dd978f45618bbe2901c94e
+  metadata.gz: a40be635f83eae9a3772d07af24c11bac7f6d1006dab727d301ecc94beb566aca345bab283bfc79c808a854d86860edd59105c01e3ecf443b3192aa623fc3664
+  data.tar.gz: d287ab7b298c2b357083548779a09d80b1a9b5cc362b742968fd887555932e996c43bd4eb9cd2cb820152ffa51df1290641de56e30cb1e49b2b3b4cabeb460fa

data/.document

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

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,14 @@
+inherit_from:
+  - ~/.rubocop.yml
+  - ~/.rubocop-rspec.yml
+
+inherit_mode:
+  merge:
+    - Include
+    - Exclude
+    - Environments
+
+AllCops:
+  Exclude:
+    - "*.gemspec" # temporarily until we move off of juweiler
+  TargetRubyVersion: 3.4

data/.ruby-gemset

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

data/.ruby-version

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

data/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2026-05-14
+
+### Added
+- `lib/localized_each_validator/version.rb` exposing
+  `LocalizedEachValidator::VERSION`.
+- `CHANGELOG.md` (this file).
+- `bin/console` and `bin/setup` scripts following the `bundle gem`
+  convention.
+- GitHub Actions CI matrix (`.github/workflows/ci.yml`) running RSpec
+  against Ruby 3.1, 3.2, 3.3, 3.4 and ActiveModel 7.0, 7.1, 7.2, 8.0.
+
+### Changed
+- **BREAKING:** Minimum Ruby version is now 3.1 (was 2.5).
+- **BREAKING:** Minimum ActiveModel version is now 6.1 (was 3.0).
+- Replaced the jeweler-generated gemspec with a hand-written gemspec
+  following the `bundle gem` convention.
+- The gem now depends on `activemodel` only; the explicit
+  `activesupport` dependency was dropped (it is pulled in transitively
+  by ActiveModel).
+- `Gemfile` simplified to a single `gemspec` directive.
+- `Rakefile` rewritten to default to `:spec` without jeweler/yard.
+- `README.md` rewritten to drop Rails 3 framing, fix the incorrect
+  superclass in the example, and document `:allow_nil`, `:allow_blank`,
+  and `:message` options.
+
+### Removed
+- **BREAKING:** The `VERSION` plain-text file is gone. Read
+  `LocalizedEachValidator::VERSION` instead.
+- Removed jeweler, RedCloth, yard and the related development tooling.
+- Removed `.travis.yml`.
+
+### Fixed
+- Gemspec referenced a non-existent `README.textile` file in `s.files`
+  and `s.extra_rdoc_files`; the actual file is `README.md`.
+- Gemspec contained a dead `if respond_to?(:specification_version)`
+  fallback branch with duplicate `yard` entries and a missing `rspec`
+  dependency. The whole branch is gone.
+- `README.md` example showed `class FourValidator < ActiveRecord::EachValidator`;
+  it now correctly subclasses `LocalizedEachValidator`.

data/README.md

@@ -0,0 +1,81 @@
+# Localized `EachValidator`
+
+[![CI](https://github.com/RISCfuture/localized_each_validator/actions/workflows/ci.yml/badge.svg)](https://github.com/RISCfuture/localized_each_validator/actions/workflows/ci.yml)
+[![Gem Version](https://img.shields.io/gem/v/localized_each_validator.svg)](https://rubygems.org/gems/localized_each_validator)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+|             |                                 |
+| :---------- | :------------------------------ |
+| **Author**  | Tim Morgan                      |
+| **License** | Released under the MIT license. |
+
+## About
+
+`LocalizedEachValidator` is a small abstract subclass of
+`ActiveModel::EachValidator` that makes it easy to write validators whose
+error messages are looked up through Rails / ActiveModel's I18n
+infrastructure.
+
+Subclass `LocalizedEachValidator`, declare an `error_key`, and implement
+`#valid?`. The validator adds the error key to the record's errors when a
+value fails validation; ActiveModel will then resolve that key against the
+standard I18n error message hierarchy.
+
+## Installation
+
+Add to your `Gemfile`:
+
+```ruby
+gem "localized_each_validator"
+```
+
+Or, if you're writing your own validator gem, add it to your gemspec:
+
+```ruby
+spec.add_dependency "localized_each_validator", "~> 2.0"
+```
+
+Then run `bundle install`.
+
+## Usage
+
+Subclass `LocalizedEachValidator`, set an `error_key`, and implement
+`#valid?`:
+
+```ruby
+class FourValidator < LocalizedEachValidator
+  error_key :must_be_four
+
+  def valid?(record, attribute, value)
+    value == 4
+  end
+end
+```
+
+Users of your validator can then add a translation:
+
+```yaml
+en:
+  activemodel:
+    errors:
+      messages:
+        must_be_four: "must be four"
+```
+
+### Options
+
+`LocalizedEachValidator` honors the standard `EachValidator` options:
+
+* `:allow_nil` — skip validation when the value is `nil`.
+* `:allow_blank` — skip validation when the value is blank.
+* `:message` — override the default `error_key`-based error message with
+  a literal string or another symbol.
+
+### Default `error_key`
+
+If you don't call `error_key`, the default is derived from the class
+name: the trailing `Validator` is stripped, the result is demodulized,
+and `underscore`d. For example, `Auth::EmailAddressValidator` defaults
+to `:email_address`.
+
+See the `LocalizedEachValidator` class documentation for more details.

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/localized_each_validator/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require "active_model/validator"
+
+class LocalizedEachValidator < ActiveModel::EachValidator
+  VERSION = "2.0.0"
+end

data/lib/localized_each_validator.rb

@@ -1,17 +1,20 @@
-require 'active_support/core_ext/hash/except'
-require 'active_model/validator'
+# frozen_string_literal: true
 
-# An @EachValidator@ that uses the translation table to build its error
+require "active_support/core_ext/hash/except"
+require "active_model/validator"
+require "localized_each_validator/version"
+
+# An `EachValidator` that uses the translation table to build its error
 # messages. Override the {#valid?} method to describe your validation
 # conditions of your subclasses.
 #
 # The error message translation lookups conform to the standard hierarchy of
 # internationalization keys as described by the
-# @ActiveRecord::Errors#generate_message@ method. (See its documentation for
+# `ActiveRecord::Errors#generate_message` method. (See its documentation for
 # more information.) The last portion of the translation key path is the error
 # message key, and by default it is the name of the validator class (excepting
 # "Validator"), underscored and demodulized. For example, an
-# @EmailAddressValidator@ subclass would use the @email_address@ key within the
+# `EmailAddressValidator` subclass would use the `email_address` key within the
 # normal ActiveRecord error key structure.
 #
 # @abstract Subclass this validator to perform your specific validations.
@@ -19,22 +22,10 @@ require 'active_model/validator'
 class LocalizedEachValidator < ActiveModel::EachValidator
   # @private
   def validate_each(record, attribute, value)
-    return if options[:allow_nil] and value.nil?
-    return if options[:allow_blank] and value.blank?
-    record.errors.add(attribute, options[:message] || self.class.error_key) unless valid?(record, attribute, value)
-  end
+    return if options[:allow_nil] && value.nil?
+    return if options[:allow_blank] && value.blank?
 
-  protected
-
-  # @abstract Override this method to return true or false depending on whether
-  # @value@ is a valid value for @record@'s @attribute@.
-  # @param [ActiveRecord::Base] record The record being validated.
-  # @param [Symbol] attribute The attribute with the given value.
-  # @param value The value of the attribute to be validated.
-  # @return [true, false] Whether the value is valid.
-
-  def valid?(record, attribute, value)
-    raise NotImplementedError, "Implement this method in your subclasses"
+    record.errors.add(attribute, options[:message] || self.class.error_key) unless valid?(record, attribute, value)
   end
 
   # @overload error_key
@@ -46,10 +37,21 @@ class LocalizedEachValidator < ActiveModel::EachValidator
   #   @param [Symbol] value The new error message key.
 
   def self.error_key(value=nil)
-    if value then
-      @error_key = value
-    else
-      return @error_key || to_s.demodulize.sub(/Validator$/, '').underscore.to_sym
-    end
+    return @error_key || to_s.demodulize.sub(/Validator$/, "").underscore.to_sym unless value
+
+    @error_key = value
+  end
+
+  protected
+
+  # @abstract Override this method to return true or false depending on whether
+  #   `value` is a valid value for `record`'s `attribute`.
+  # @param [ActiveRecord::Base] record The record being validated.
+  # @param [Symbol] attribute The attribute with the given value.
+  # @param value The value of the attribute to be validated.
+  # @return [true, false] Whether the value is valid.
+
+  def valid?(_record, _attribute, _value)
+    raise NotImplementedError, "Implement this method in your subclasses"
   end
 end

data/localized_each_validator.gemspec

@@ -1,57 +1,43 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = "localized_each_validator"
-  s.version = "1.0.3"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Tim Morgan"]
-  s.date = "2013-07-24"
-  s.description = "Adds an abstract EachValidator superclass that you can use to create localizable validations."
-  s.email = "git@timothymorgan.info"
-  s.extra_rdoc_files = [
-    "LICENSE",
-    "README.textile"
-  ]
-  s.files = [
-    "LICENSE",
-    "README.textile",
-    "lib/localized_each_validator.rb",
-    "localized_each_validator.gemspec"
-  ]
-  s.homepage = "http://github.com/riscfuture/localized_each_validator"
-  s.require_paths = ["lib"]
-  s.rubygems_version = "2.0.5"
-  s.summary = "Simple EachValidator with localization support"
-
-  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<activemodel>, [">= 3.0"])
-      s.add_runtime_dependency(%q<activesupport>, [">= 3.0"])
-      s.add_development_dependency(%q<jeweler>, [">= 0"])
-      s.add_development_dependency(%q<yard>, [">= 0"])
-      s.add_development_dependency(%q<RedCloth>, [">= 0"])
-      s.add_development_dependency(%q<rspec>, [">= 0"])
-    else
-      s.add_dependency(%q<activemodel>, [">= 3.0"])
-      s.add_dependency(%q<activesupport>, [">= 3.0"])
-      s.add_dependency(%q<jeweler>, [">= 0"])
-      s.add_dependency(%q<yard>, [">= 0"])
-      s.add_dependency(%q<RedCloth>, [">= 0"])
-      s.add_dependency(%q<rspec>, [">= 0"])
+# frozen_string_literal: true
+
+# Read the version constant from lib/localized_each_validator/version.rb without
+# requiring the file (which would force `active_model` to be loaded during
+# gemspec evaluation, before dependencies are installed).
+version = File.read(File.expand_path("lib/localized_each_validator/version.rb", __dir__))
+           .match(/VERSION\s*=\s*["']([^"']+)["']/)[1]
+
+Gem::Specification.new do |spec|
+  spec.name        = "localized_each_validator"
+  spec.version     = version
+  spec.authors     = ["Tim Morgan"]
+  spec.email       = ["git@timothymorgan.info"]
+
+  spec.summary     = "Simple EachValidator with localization support"
+  spec.description = "Adds an abstract EachValidator superclass that you can use to create localizable validations."
+  spec.homepage    = "https://github.com/RISCfuture/localized_each_validator"
+  spec.license     = "MIT"
+
+  spec.required_ruby_version = ">= 3.1"
+
+  spec.metadata = {
+    "homepage_uri"          => spec.homepage,
+    "source_code_uri"       => "https://github.com/RISCfuture/localized_each_validator/tree/master",
+    "changelog_uri"         => "https://github.com/RISCfuture/localized_each_validator/blob/master/CHANGELOG.md",
+    "bug_tracker_uri"       => "https://github.com/RISCfuture/localized_each_validator/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<activemodel>, [">= 3.0"])
-    s.add_dependency(%q<activesupport>, [">= 3.0"])
-    s.add_dependency(%q<jeweler>, [">= 0"])
-    s.add_dependency(%q<yard>, [">= 0"])
-    s.add_dependency(%q<RedCloth>, [">= 0"])
-    s.add_dependency(%q<rspec>, [">= 0"])
   end
-end
+  spec.require_paths = ["lib"]
 
+  spec.add_dependency "activemodel", ">= 6.1"
+
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "standard", ">= 1.0"
+end

metadata

@@ -1,133 +1,114 @@
 --- !ruby/object:Gem::Specification
 name: localized_each_validator
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 2.0.0
 platform: ruby
 authors:
 - Tim Morgan
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-24 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '6.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: jeweler
-  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'
+        version: '6.1'
 - !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: RedCloth
+  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'
+        version: '1.0'
 description: Adds an abstract EachValidator superclass that you can use to create
   localizable validations.
-email: git@timothymorgan.info
+email:
+- git@timothymorgan.info
 executables: []
 extensions: []
-extra_rdoc_files:
-- LICENSE
-- README.textile
+extra_rdoc_files: []
 files:
+- ".document"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-gemset"
+- ".ruby-version"
+- CHANGELOG.md
 - LICENSE
-- README.textile
+- README.md
+- Rakefile
 - lib/localized_each_validator.rb
+- lib/localized_each_validator/version.rb
 - localized_each_validator.gemspec
-homepage: http://github.com/riscfuture/localized_each_validator
-licenses: []
-metadata: {}
-post_install_message: 
+homepage: https://github.com/RISCfuture/localized_each_validator
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/RISCfuture/localized_each_validator
+  source_code_uri: https://github.com/RISCfuture/localized_each_validator/tree/master
+  changelog_uri: https://github.com/RISCfuture/localized_each_validator/blob/master/CHANGELOG.md
+  bug_tracker_uri: https://github.com/RISCfuture/localized_each_validator/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.0.5
-signing_key: 
+rubygems_version: 4.0.11
 specification_version: 4
 summary: Simple EachValidator with localization support
 test_files: []

data/README.textile

@@ -1,39 +0,0 @@
-h1. Localized @EachValidator@
-
-| *Author* | Tim Morgan |
-| *Version* | 1.0.3 (Jul 23, 2013) |
-| *License* | Released under the MIT license. |
-
-h2. About
-
-Localized @EachValidator@ is a subclass of ActiveRecord's @EachValidator@ that
-makes it easier to write a localized validator with Rails 3's localization. It's
-small and simple.
-
-h2. Usage
-
-Add this gem to your project's @Gemfile@, or to your own validator gem's
-dependencies. Then, sublass @LocalizedEachValidator@ and provide the @error_key@
-and override the @valid?@ method, like so:
-
-<pre><code>
-class FourValidator < ActiveRecord::EachValidator
-  error_key :must_be_four
-
-  def valid?(record, field, value)
-    value == 4
-  end
-</code></pre>
-
-Now, users of your validator can create a localization YAML file like so:
-
-<pre><code>
-en:
-  activerecord:
-	errors:
-	  messages:
-	    must_be_four: This number must be four.
-</code></pre>
-
-
-See the {LocalizedEachValidator} class documentation for more information.