unmagic-enum 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 296bf3ce5a37bbae18729100c9144921c1a65bdf86a30454445103be32b99cdb
-  data.tar.gz: 7b551d488656e09684212234abdd7be21ff48b8de3cc2ee92b931f68a824283c
+  metadata.gz: 5b6ca718c4633bd4b4416c9e5b4f835b04515982c718fe328944eaa8a3e35447
+  data.tar.gz: 47868614586456e22c218b68157898ca35f927141316e7a8499682f92b2e8768
 SHA512:
-  metadata.gz: 3acdd8c864b84a908562b4d6516dbb41ea29ac112d985582785c92051f33b569934f633e3b5b4720744828bd9736271a0fe76ea5de4bc27001c3bc1d4a29aca1
-  data.tar.gz: 7da04912825247ceb2f0d9e90a70230c39dbe61ed18842d99145dd7eadd8e3e03f6882749c6c9344957ee7d07c3d05040059e4280f8c31b2e19022d73e0fa656
+  metadata.gz: 9c13abf83c50bcb036ee3631de10d5ffb14fde58a78e154e4af60574c94d6af1ad89c3424b03f25fa332de852bbd9f7e1f6755cfa728d5378c86118a6ce05516
+  data.tar.gz: 4f564234de61c4d44c3fd425c29518c99f938f8e9adda553ea1930bbe0332055cec4bea52fb83d8f6ca6bd6ca0134bd426befed056ac7013afd697376a9cc174

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-06-09
+
+### Added
+- `column_type(validate:)` option mirroring `ActiveRecord::Enum`. Defaults to `false` (an unknown value raises eagerly on assignment, as before); pass `validate: true` to suppress the eager raise so the value casts to `nil` and model validations (`presence`/`inclusion`) handle it instead.
+
 ## [0.1.1] - 2026-06-04
 
 ### Changed

data/lib/unmagic/enum/active_record_extensions.rb

@@ -6,8 +6,15 @@ module Unmagic
   class Enum
     module ActiveRecordExtensions
       class ColumnType < ActiveRecord::Type::Value
-        def initialize(enum_class)
+        # `validate:` mirrors ActiveRecord::Enum's option of the same name. It
+        # defaults to false, matching Rails: an unknown value is rejected eagerly
+        # on assignment (see #assert_valid_value). Pass validate: true to opt out
+        # of the eager raise so model validations handle the unknown value
+        # instead — it casts to nil, so a `presence`/`inclusion` validation can
+        # flag it rather than the assignment blowing up.
+        def initialize(enum_class, validate: false)
           @enum_class = enum_class
+          @raise_on_invalid_values = !validate
           super()
         end
 
@@ -39,8 +46,11 @@ module Unmagic
         # ActiveModel::Attribute#with_value_from_user calls this before storing,
         # so an invalid value raises immediately on `record.attr = ...` instead
         # of later, lazily, when the attribute is read. Blank is allowed (becomes
-        # nil); an enum instance or a known key/value passes.
+        # nil); an enum instance or a known key/value passes. When the type was
+        # built with validate: true the eager raise is suppressed (the value then
+        # casts to nil), matching ActiveRecord::Enum's raise_on_invalid_values.
         def assert_valid_value(value)
+          return unless @raise_on_invalid_values
           return if value.nil? || value == ''
           return if value.is_a?(@enum_class)
           return if @enum_class[value]
@@ -62,9 +72,12 @@ module Unmagic
       end
 
       module ClassMethods
-        # For ActiveRecord attribute type definition
-        def column_type
-          @column_type ||= Unmagic::Enum::ActiveRecordExtensions::ColumnType.new(self)
+        # For ActiveRecord attribute type definition. `validate:` mirrors
+        # ActiveRecord::Enum (default false = raise eagerly on an unknown value;
+        # true = let model validations handle it). Memoised per option value.
+        def column_type(validate: false)
+          (@column_types ||= {})[validate] ||=
+            Unmagic::Enum::ActiveRecordExtensions::ColumnType.new(self, validate: validate)
         end
       end
 

data/lib/unmagic/enum/version.rb

@@ -3,6 +3,6 @@
 module Unmagic
   class Enum
     # Current version of the unmagic-enum gem
-    VERSION = "0.1.1"
+    VERSION = "0.2.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unmagic-enum
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Keith Pitt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-04 00:00:00.000000000 Z
+date: 2026-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport