validated_object 2.3.1 → 2.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 03a54694b8208e1e788cd55ece182bacdbfa75f3389db8c0dcc8902df92d9822
-  data.tar.gz: 03c58a85faa371f663201c0deb0e7ed8cb021f35aae8d3568e18f24e7db09c59
+  metadata.gz: '039b75227869c70e8767ab8e48b5f355d9e048f7b6a18cacec6ca679259f0097'
+  data.tar.gz: 7b16daca0ce8d9cb81af01ce6d6a984cadbc7ef36ee2b7a72b1ac67aed854415
 SHA512:
-  metadata.gz: 9f3bf8d6e81b2359e60f830d493e0a4fed9997bc21fa21c33f838794300e1b97514999ab42fb478a5cd22562ec89aa0dcfddf3a2c127b6b804f9f5f34faaea11
-  data.tar.gz: 5f05239f7150ffc10dc11544717298ec6500804ba4ab764cc8ba1dcb0bf1c6af7dfe59c927c829183902b575b2133ebc5278d2b1b9a3d8cd701dda8fd7a08f4d
+  metadata.gz: b7766bafdcb4e6d23890584bffac5c1ce7744d5166d29061a3247b2b377f52195f80531028c041db8a98f80a2b675411528804058e7fc7b008327de96c14e2e6
+  data.tar.gz: 007c20d017c7ceaf708d69f05f8c1fc19c1c262313550670f8ce1469df2641e4c78799cac90301e6cea94acfa9d7ad8489d6fba034a440b9e08ece2a0e37abb3

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,14 @@
+plugins:
+  - rubocop-rspec
+  - rubocop-rake
+
+AllCops:
+  SuggestExtensions: true
+  DisplayCopNames: true
+  ExtraDetails: true
+  Color: true
+  FormatStyleGuide: true
+  DisabledByDefault: false
+
+Lint/ConstantDefinitionInBlock:
+  Enabled: false

data/CLAUDE.md

@@ -0,0 +1,67 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+### Development Setup
+- `bin/setup` - Install dependencies (runs `bundle install`)
+- `bin/console` - Start an interactive console with the gem loaded
+
+### Testing and Quality
+- `rake spec` or `bundle exec rspec` - Run the test suite
+- `bundle exec rubocop` - Run code linting (with rubocop-rspec and rubocop-rake plugins)
+- `rake` - Default task (runs specs)
+
+### Gem Development
+- `bundle exec rake install` - Install gem locally for testing
+- `bundle exec rake release` - Release new version (updates version, creates git tag, pushes to rubygems.org)
+
+## Architecture
+
+This is a Ruby gem that provides self-validating Plain Old Ruby Objects using ActiveModel validations. The core architecture consists of:
+
+### Main Components
+
+**ValidatedObject::Base** (`lib/validated_object.rb`):
+- The main class that objects inherit from to gain validation capabilities
+- Includes `ActiveModel::Validations` for standard Rails validation methods
+- Automatically validates objects during instantiation via `initialize`
+- Provides `check_validations!` method for explicit validation with clear error messages
+- Contains a custom `TypeValidator` that supports type checking including arrays and pseudo-boolean validation
+
+**ValidatedObject::SimplifiedApi** (`lib/validated_object/simplified_api.rb`):
+- Provides convenience methods like `validates_attr` that combine `attr_reader` and `validates` 
+- Supports streamlined array element type validation with `[ElementType]` syntax
+- Allows `validated` as synonym for `validates`
+
+### Key Features
+
+- **Type Validation**: Custom `TypeValidator` supports class validation, pseudo-boolean (`Boolean` class), and array element type checking
+- **Array Element Validation**: Two syntaxes supported:
+  - `validates_attr :tags, type: Array, element_type: String`
+  - `validates_attr :tags, type: [String]` (streamlined syntax)
+- **Immutable Objects**: Uses `attr_reader` with instance variable setting to create read-only validated objects
+- **Clear Error Messages**: Validation failures provide descriptive messages like "Birthday is a String, not a Date"
+
+### Validation Patterns
+
+The gem follows a declarative pattern where classes define their validation rules upfront:
+
+```ruby
+class Dog < ValidatedObject::Base
+  validates_attr :name, presence: true
+  validates_attr :birthday, type: Date, allow_nil: true
+  validates_attr :tags, type: [String], allow_nil: true
+end
+```
+
+Objects validate themselves during instantiation and raise `ArgumentError` with detailed messages if invalid.
+
+## Development Notes
+
+- Requires Ruby 3.1+
+- Uses RSpec for testing with color output enabled
+- RuboCop configured with rspec and rake plugins
+- Gem specification allows pushing to rubygems.org
+- Demo script available at `script/demo.rb`

data/HISTORY.md

@@ -1,2 +1,5 @@
+# 2.3.2
+- Add 'validated' as a synonym for 'validates' (and in the simplified API), so both can be used interchangeably.
+
 # 1.1.0
 Introduces the new Boolean pseudo-type.

data/README.md

@@ -12,7 +12,7 @@ class Person < ValidatedObject::Base
 end
 
 # Instantiating it runs the validations.
-me  = Person.new(name: 'Robb')
+me  = Person.new(name: 'Robert')
 you = Person.new(name: '')     # => ArgumentError: "Name can't be blank"
 ```
 
@@ -82,6 +82,19 @@ validates :premium_membership, type: Boolean
 #...
 ```
 
+
+### Array element type validation
+
+You can validate that an attribute is an array of a specific type using array syntax:
+
+```ruby
+# Validate that names is an array of String objects.
+validates_attr :names, type: [String]
+```
+
+If the array contains any elements that are not of the specified type, validation will fail with a clear error message.
+
+
 ### Instantiating and automatically validating
 
 ```ruby

data/lib/validated_object/simplified_api.rb

@@ -1,4 +1,4 @@
-require "active_support/concern"
+require 'active_support/concern'
 
 # Enable a simplified API for the common case of
 # read-only ValidatedObjects.
@@ -10,9 +10,37 @@ module ValidatedObject
       # Simply delegate to `attr_reader` and `validates`.
       def validated_attr(attribute, *options)
         attr_reader attribute
+
         validates attribute, *options
       end
-    end
 
+      # Allow 'validated' as a synonym for 'validates'.
+      def validated(*args, **kwargs, &block)
+        validates(*args, **kwargs, &block)
+      end
+
+      # Alias for validated_attr for compatibility with test usage.
+      def validates_attr(attribute, *options, **kwargs)
+        attr_reader attribute
+
+        if kwargs[:type]
+          type_val = kwargs.delete(:type)
+          element_type = kwargs.delete(:element_type)
+
+          # Parse Array[ElementType] syntax
+          if type_val.is_a?(Array) && type_val.length == 1 && type_val[0].is_a?(Class)
+            # This handles Array[Comment] syntax
+            element_type = type_val[0]
+            type_val = Array
+          end
+
+          opts = { type: { with: type_val } }
+          opts[:type][:element_type] = element_type if element_type
+          validates attribute, opts.merge(kwargs)
+        else
+          validates attribute, *options, **kwargs
+        end
+      end
+    end
   end
 end

data/lib/validated_object/version.rb

@@ -1,6 +1,5 @@
-# typed: strict
 # frozen_string_literal: true
 
 module ValidatedObject
-  VERSION = '2.3.1'
+  VERSION = '2.3.3'
 end

data/lib/validated_object.rb

@@ -1,12 +1,9 @@
-# typed: true
 # frozen_string_literal: true
 
 require 'active_model'
-require 'sorbet-runtime'
 require 'validated_object/version'
 require 'validated_object/simplified_api'
 
-
 module ValidatedObject
   # @abstract Subclass and add `attr_accessor` and validations
   #   to create custom validating objects.
@@ -46,11 +43,8 @@ module ValidatedObject
   class Base
     include ActiveModel::Validations
     include SimplifiedApi
-    extend T::Sig
-
-    SymbolHash = T.type_alias { T::Hash[Symbol, T.untyped] }
 
-    EMPTY_HASH = T.let({}.freeze, SymbolHash)
+    EMPTY_HASH = {}.freeze
 
     # A private class definition, not intended to
     # be used directly. Implements a pseudo-boolean class
@@ -66,15 +60,14 @@ module ValidatedObject
     #
     # @raise [ArgumentError] if the object is not valid at the
     #   end of initialization or `attributes` is not a Hash.
-    sig { params(attributes: SymbolHash).void }
     def initialize(attributes = EMPTY_HASH)
       set_instance_variables from_hash: attributes
       check_validations!
-      nil
     end
 
     def validated_attr(attribute_name, **validation_options)
       attr_reader attribute_name
+
       validates attribute_name, validation_options
     end
 
@@ -82,7 +75,6 @@ module ValidatedObject
     #
     # @raise [ArgumentError] if any validations fail.
     # @return [ValidatedObject::Base] the receiver
-    sig { returns(ValidatedObject::Base) }
     def check_validations!
       raise ArgumentError, errors.full_messages.join('; ') if invalid?
 
@@ -102,22 +94,22 @@ module ValidatedObject
     #     validates :neutered, type: Boolean, allow_nil: true  # Typed but optional
     #   end
     class TypeValidator < ActiveModel::EachValidator
-      extend T::Sig
-
       # @return [nil]
-      sig do
-        params(
-          record: T.untyped,
-          attribute: T.untyped,
-          value: T.untyped
-        )
-          .void
-      end
       def validate_each(record, attribute, value)
-        validation_options = T.let(options, SymbolHash)
-
+        validation_options = options
         expected_class = validation_options[:with]
 
+        # Support type: Array, element_type: ElementType
+        if expected_class == Array && validation_options[:element_type]
+          return save_error(record, attribute, value, validation_options) unless value.is_a?(Array)
+
+          element_type = validation_options[:element_type]
+          unless value.all? { |el| el.is_a?(element_type) }
+            record.errors.add attribute, validation_options[:message] || "contains non-#{element_type} elements"
+          end
+          return
+        end
+
         return if pseudo_boolean?(expected_class, value) ||
                   expected_class?(expected_class, value)
 
@@ -126,40 +118,39 @@ module ValidatedObject
 
       private
 
-      sig { params(expected_class: T.untyped, value: T.untyped).returns(T.untyped) }
       def pseudo_boolean?(expected_class, value)
         expected_class == Boolean && boolean?(value)
       end
 
-      sig { params(expected_class: T.untyped, value: T.untyped).returns(T.untyped) }
       def expected_class?(expected_class, value)
         value.is_a?(expected_class)
       end
 
-      sig { params(value: T.untyped).returns(T.untyped) }
       def boolean?(value)
         value.is_a?(TrueClass) || value.is_a?(FalseClass)
       end
 
-      sig do
-        params(
-          record: T.untyped,
-          attribute: T.untyped,
-          value: T.untyped,
-          validation_options: SymbolHash
-        )
-          .void
-      end
       def save_error(record, attribute, value, validation_options)
         record.errors.add attribute,
                           validation_options[:message] || "is a #{value.class}, not a #{validation_options[:with]}"
       end
     end
 
+    # Register the TypeValidator with ActiveModel so `type:` validation option works
+    unless ActiveModel::Validations.const_defined?(:TypeValidator)
+      ActiveModel::Validations.const_set(:TypeValidator, TypeValidator)
+    end
+
+    # Allow 'validated' as a synonym for 'validates'
+    def self.validated(*args, **kwargs, &block)
+      validates(*args, **kwargs, &block)
+    end
+
     private
 
-    sig { params(from_hash: SymbolHash).void }
     def set_instance_variables(from_hash:)
+      raise TypeError, "#{from_hash} is not a hash" unless from_hash.is_a?(Hash)
+
       from_hash.each do |variable_name, variable_value|
         # Test for the attribute reader
         send variable_name.to_sym

data/script/demo.rb

@@ -1,9 +1,9 @@
-# typed: ignore
 require 'date'
 require 'validated_object'
 
 class Dog < ValidatedObject::Base
   attr_reader :name, :birthday
+
   validates :name, presence: true
   validates :birthday, type: Date, allow_nil: true
 end
@@ -15,4 +15,4 @@ maru = Dog.new(birthday: Date.today, name: 'Maru')
 puts maru.inspect
 
 hiro = Dog.new(birthday: 'today')
-puts hiro.inspect
+puts hiro.inspect

data/validated_object.gemspec

@@ -19,11 +19,9 @@ Gem::Specification.new do |spec|
 
   # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
   # delete this section to allow pushing this gem to any host.
-  if spec.respond_to?(:metadata)
-    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
-  else
-    raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
-  end
+  raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.' unless spec.respond_to?(:metadata)
+
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   spec.bindir        = 'exe'
@@ -32,8 +30,9 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency 'rake', '>= 12.3.3'
   spec.add_development_dependency 'rspec', '>= 3.9.0'
-  spec.add_development_dependency 'sorbet', '>= 0.5.5890'
+  spec.add_development_dependency 'rubocop', '>= 1.80.0'
+  spec.add_development_dependency 'rubocop-rake', '>= 0.0.0'
+  spec.add_development_dependency 'rubocop-rspec', '>= 0.0.0'
 
   spec.add_runtime_dependency 'activemodel', '>= 3.2.21'
-  spec.add_runtime_dependency 'sorbet-runtime', '>= 0.5.5890'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: validated_object
 version: !ruby/object:Gem::Version
-  version: 2.3.1
+  version: 2.3.3
 platform: ruby
 authors:
 - Robb Shecter
@@ -38,47 +38,61 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 3.9.0
 - !ruby/object:Gem::Dependency
-  name: sorbet
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.5890
+        version: 1.80.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.5890
+        version: 1.80.0
 - !ruby/object:Gem::Dependency
-  name: activemodel
+  name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.21
-  type: :runtime
+        version: 0.0.0
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.21
+        version: 0.0.0
 - !ruby/object:Gem::Dependency
-  name: sorbet-runtime
+  name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.5890
+        version: 0.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.0
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.21
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.5890
+        version: 3.2.21
 description: A small wrapper around ActiveModel Validations.
 email:
 - robb@public.law
@@ -89,7 +103,9 @@ files:
 - ".github/workflows/ruby.yml"
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - ".travis.yml"
+- CLAUDE.md
 - Gemfile
 - HISTORY.md
 - LICENSE.txt
@@ -101,24 +117,6 @@ files:
 - lib/validated_object/simplified_api.rb
 - lib/validated_object/version.rb
 - script/demo.rb
-- sorbet/config
-- sorbet/rbi/gems/activemodel.rbi
-- sorbet/rbi/gems/activesupport.rbi
-- sorbet/rbi/gems/concurrent-ruby.rbi
-- sorbet/rbi/gems/i18n.rbi
-- sorbet/rbi/gems/rake.rbi
-- sorbet/rbi/gems/rspec-core.rbi
-- sorbet/rbi/gems/rspec-expectations.rbi
-- sorbet/rbi/gems/rspec-mocks.rbi
-- sorbet/rbi/gems/rspec-support.rbi
-- sorbet/rbi/gems/rspec.rbi
-- sorbet/rbi/gems/site_ruby.rbi
-- sorbet/rbi/gems/thread_safe.rbi
-- sorbet/rbi/gems/tzinfo.rbi
-- sorbet/rbi/sorbet-typed/lib/activemodel/all/activemodel.rbi
-- sorbet/rbi/sorbet-typed/lib/activesupport/>=6/activesupport.rbi
-- sorbet/rbi/sorbet-typed/lib/activesupport/all/activesupport.rbi
-- sorbet/rbi/sorbet-typed/lib/minitest/all/minitest.rbi
 - validated_object.gemspec
 homepage: https://github.com/public-law/validated_object
 licenses:
@@ -139,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.7.1
 specification_version: 4
 summary: Self-validating plain Ruby objects.
 test_files: []

data/sorbet/config

@@ -1,2 +0,0 @@
---dir
-.