attribute_guard 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00ca78d9fb2f442ce8c5d58b0950e6ae2406e7317cc0060b572083d85705b247
-  data.tar.gz: 447523ace443fcdeeb1312ea118e2c39dc0e8195cecb5e647aed1f70f4cb0c41
+  metadata.gz: fa71cf702b0f01ded796adf8ba3f215d024cf7a7947d633450213266df33cd74
+  data.tar.gz: 96bb1d220b952c302e9c749378be645c47fa66f49a0860d8b110ce49d2d1f0cb
 SHA512:
-  metadata.gz: d4c1f7e90bb839de650cf4f272c6269106136bd03e91f86674bd73b9d00c3da76ec43741b8389c57d4fc9cef5d505e27ced1e548e823941b34e89048a583fee6
-  data.tar.gz: 11a93fe37a9db10b1de8e41e511f06d80abbc4cbe2670f193f6d7208cd9247218f6245c9d696aef716da9e55e5a26fd24e1a4a4112cb4f634620df66972d3413
+  metadata.gz: 574fcacc35b3a9c4029999e6e9a8c89ae8d35c1f22e6187ebafbea27079e0f812a23bbf93fb42ccd667f570fa3060fba6f3bdc6e2fc1a3411bccb4066345710e
+  data.tar.gz: f3b1df97332fdfeed565332fb0be50a53811e95d3661ee0ca1988406ffe690e9cca734a2b6a136d4eacaddf2b995cf9d6c8eaa18d1647aa52ce39e6d96606c49

data/CHANGELOG.md

@@ -4,6 +4,16 @@ 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.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 1.1.0
+
+### Added
+
+- Added :raise mode that raises an error if a locked attribute has been changed instead of adding a validation error.
+
+### Changed
+
+- Changed gem dependency from `activerecord` to `activemodel`. You can now use locked attributes with ActiveModel classes that include `ActiveModel::Validations` and `ActiveModel::Dirty and implement a `new_record?` method.
+
 ## 1.0.1
 
 ### Added

data/README.md

@@ -3,8 +3,9 @@
 [![Continuous Integration](https://github.com/bdurand/attribute_guard/actions/workflows/continuous_integration.yml/badge.svg)](https://github.com/bdurand/attribute_guard/actions/workflows/continuous_integration.yml)
 [![Regression Test](https://github.com/bdurand/attribute_guard/actions/workflows/regression_test.yml/badge.svg)](https://github.com/bdurand/attribute_guard/actions/workflows/regression_test.yml)
 [![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard)
+[![Gem Version](https://badge.fury.io/rb/attribute_guard.svg)](https://badge.fury.io/rb/attribute_guard)
 
-This Ruby gem provides an extension for ActiveRecord allowing you to declare certain attributes in a model to be locked. Locked attributes cannot be changed once a record is created unless you explicitly allow changes.
+This Ruby gem provides an extension for ActiveRecord/ActiveModel allowing you to declare certain attributes in a model to be locked. Locked attributes cannot be changed once a record is created unless you explicitly allow changes.
 
 This feature can be used for a couple of different purposes.
 
@@ -118,7 +119,7 @@ record.update!(status: "canceled") # raises ActiveRecord::RecordInvalid error
 
 ### Modes
 
-The default behavior when a locked attribute is changed is to add a validation error to the record. You can change this behavior with the `mode` option when locking attributes.
+The default behavior when a locked attribute is changed is to add a validation error to the record. You can change this behavior with the `mode` option when locking attributes. You still need to validate the record to trigger the locked attribute check, regardless of the mode.
 
 ```ruby
 class MyModel
@@ -126,16 +127,23 @@ class MyModel
 
   lock_attributes :email, mode: :error
   lock_attributes :name: mode: :warn
+  lock_attributes :updated_at, mode: :raise
   lock_attributes :created_at, mode: ->(record, attribute) { raise "Created timestamp cannot be changed" }
 end
 ```
 
 * `:error` - Add a validation error to the record. This is the default.
 
-* `:warn` - Log a warning that the record was changed. This mode is useful to allow you soft deploy locked attributes to production on a mature project and give you information about where you may need to update code to unlock attributes.
+* `:warn` - Log a warning that the record was changed. This mode is useful to allow you soft deploy locked attributes to production on a mature project and give you information about where you may need to update code to unlock attributes. If the model does not have a `logger` method that returns a `Logger`-like object, then the output will be sent to `STDERR`.
+
+* `:raise` = Raise an `AttributeGuard::LockedAttributeError` error.
 
 * `Proc` - If you provide a `Proc` object, it will be called with the record and the attribute name when a locked attribute is changed.
 
+### Using with ActiveModel
+
+The gem works out of the box with ActiveRecord. You can also use it with ActiveModel classes as long as they include the `ActiveModel::Validations` and `ActiveModel::Dirty` modules. The model also needs to implement a `new_record?` method.
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/VERSION

@@ -1 +1 @@
-1.0.1
+1.1.0

data/attribute_guard.gemspec

@@ -4,7 +4,7 @@ Gem::Specification.new do |spec|
   spec.authors = ["Brian Durand"]
   spec.email = ["bbdurand@gmail.com"]
 
-  spec.summary = "ActiveRecord extension that allows locking attributes to prevent unintended updates."
+  spec.summary = "ActiveRecord/ActiveModel extension that allows locking attributes to prevent unintended updates."
 
   spec.homepage = "https://github.com/bdurand/attribute_guard"
   spec.license = "MIT"
@@ -31,7 +31,7 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = ">= 2.5"
 
-  spec.add_dependency "activerecord", ">= 5.0"
+  spec.add_dependency "activemodel", ">= 5.2"
 
   spec.add_development_dependency "bundler"
 end

data/lib/attribute_guard.rb

@@ -36,6 +36,9 @@ end
 module AttributeGuard
   extend ActiveSupport::Concern
 
+  class LockedAttributeError < StandardError
+  end
+
   included do
     class_attribute :locked_attributes, default: {}, instance_accessor: false
     private_class_method :locked_attributes=
@@ -56,13 +59,19 @@ module AttributeGuard
   # Validator that checks for changes to locked attributes.
   class LockedAttributesValidator < ActiveModel::Validator
     def validate(record)
+      unless record.respond_to?(:new_record?)
+        raise "AttributeGuard can only be used with models that respond to :new_record?"
+      end
+
       return if record.new_record?
 
       record.class.send(:locked_attributes).each do |attribute, params|
         if record.changes.include?(attribute) && record.attribute_locked?(attribute)
           message, mode = params
           if mode == :warn
-            record&.logger&.warn("Changed locked attribute #{attribute} on #{record.class.name} with id #{record.id}")
+            log_warning(record, attribute)
+          elsif mode == :raise
+            raise LockedAttributeError.new(error_message(record, attribute))
           elsif mode.is_a?(Proc)
             mode.call(record, attribute)
           else
@@ -71,6 +80,21 @@ module AttributeGuard
         end
       end
     end
+
+    private
+
+    def error_message(record, attribute)
+      "Changed locked attribute #{attribute} on #{record.class.name} with id #{record.id}"
+    end
+
+    def log_warning(record, attribute)
+      message = error_message(record, attribute)
+      if record.respond_to?(:logger) && record.logger.respond_to?(:warn)
+        record.logger.warn(message)
+      else
+        warn(message)
+      end
+    end
   end
 
   module ClassMethods
@@ -113,7 +137,7 @@ module AttributeGuard
   #   user.unlock_attributes(:email).update!(email: "user@example.com")
   #
   # @param attributes [Array<Symbol, String>] the attributes to unlock
-  # @return [ActiveRecord::Base] the object itself
+  # @return [Object] the object itself
   def unlock_attributes(*attributes)
     attributes = attributes.flatten.map(&:to_s)
     return if attributes.empty?

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: attribute_guard
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Brian Durand
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-11 00:00:00.000000000 Z
+date: 2024-04-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: activerecord
+  name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.2'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -74,6 +74,6 @@ requirements: []
 rubygems_version: 3.4.12
 signing_key:
 specification_version: 4
-summary: ActiveRecord extension that allows locking attributes to prevent unintended
-  updates.
+summary: ActiveRecord/ActiveModel extension that allows locking attributes to prevent
+  unintended updates.
 test_files: []