passive_model 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92b215b614d68f0e42bf4f96475a4c84ee331f3cb9e48c3627d1dc6bf0cf25c3
-  data.tar.gz: cb7d3782cab1e2d86390dfad69ede00f0e7176ef092b75327f01aec1d015c5fb
+  metadata.gz: 3c2b1ac63fdec874fc2f59c9d9bedd53f40dfec303cf9c045ce7f922cb312679
+  data.tar.gz: e6344a1d4168704cdc9160ebb5fcfbd6bc9d98e661c0c1c6e9feeffa7cb28648
 SHA512:
-  metadata.gz: 33f7f75e0bb079a39e49f3ea5cd6396e2e299e3dd31e32c7732ff43efe9df65141178ae1a8f8567bb4cae44c37b8571c207b3e1aa901c8eef818f2f955f3fee4
-  data.tar.gz: c1f82c6c0e0b372aa9bd1cd9b56091bc024fa01729cce504873756fa43c2d00583689ca6532da2ac53f497c1e5d9cf0ac14e5b62ff509bc7519629172fc6e596
+  metadata.gz: c1c90541613b89b7704700d32a48fef9bb0adb9eeee6862f65129b71f1547a77a3c98d4ec337184381a6bbc3a5a24cdc4764d4f22424145a40b32f0cf157ccc1
+  data.tar.gz: ddacc10308fee161f2e1d059fb8e96736700d3529466a825df52deffc5a5b67a09bcc80a6a3848ab8d1e3c70db49c5306ba5b92ab903fff8c47bd1f499912c3f

data/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 1.1.0 - 2026-06-14
+
+- Require `active_model` directly when loading `passive_model`, so the gem boots
+  without relying on the host Rails application to preload ActiveModel.
+- Replace the broad `rails` runtime dependency with `activemodel`.
+- Align the gem's Ruby requirement with ActiveModel 7.
+- Change `save!` to raise `PassiveModel::ValidationError`, an
+  `ActiveModel::ValidationError` subclass, instead of
+  `ActiveRecord::RecordInvalid`.
+- Store `before_save` callbacks per subclass so callbacks do not leak between
+  unrelated `PassiveModel::Base` subclasses.
+- Add focused tests for independent boot, validations, `save`, `save!`, and
+  callback isolation.

data/README.md

@@ -1,95 +1,162 @@
 # PassiveModel
 
-This is a gem for using Rails ActiveModel functionalities without having an actual database table.
+PassiveModel provides lightweight model objects for Rails applications when you
+want ActiveModel-style behavior without a database table.
 
-Supports validation, callbacks etc. And behaves like a model object, so can be replaced with actual model objects.
+It is useful for form objects, service inputs, or other plain Ruby objects that
+need validations, naming, translation, conversion, and callback hooks similar to
+Active Record models.
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'passive_model'
+gem "passive_model"
 ```
 
 And then execute:
 
-    $ bundle install
+```sh
+bundle install
+```
 
-Or install it yourself as:
+Or install it yourself:
 
-    $ gem install passive_model
+```sh
+gem install passive_model
+```
 
-## Usage
+PassiveModel depends on ActiveModel 7.0 or newer. It does not depend on Rails or
+ActiveRecord.
 
-Create a class from `PassiveModel::Base`.
+## Usage
 
-For example:
+Create a class that inherits from `PassiveModel::Base` and define the attributes
+your object exposes.
 
-```erbruby
+```ruby
 class ContactForm < PassiveModel::Base
   attr_accessor :first_name, :last_name
 
   validates :first_name, presence: true
   validates :last_name, presence: true
   validate :first_name_is_not_spam
-  
+
   private
-  
+
   def first_name_is_not_spam
-    return if first_name.downcase != 'test'
+    return unless first_name.to_s.downcase == "test"
 
-    errors.add(:first_name, 'is not valid')
+    errors.add(:first_name, "is not valid")
   end
 end
 ```
 
-#### Create new objects 
+### Creating Objects
 
-`form = ContactForm.new(first_name: 'John', last_name: 'Doe')`
+Pass initial attributes to `.new`:
 
-#### Set attributes
+```ruby
+form = ContactForm.new(first_name: "John", last_name: "Doe")
+```
 
-`form.attributes = { first_name: 'Lewis' }`
+### Assigning Attributes
 
-#### Emulate a save
+Assign multiple attributes with `attributes=`:
 
-It runs the validations and also calls `before_save` callbacks if the object is valid
+```ruby
+form.attributes = { first_name: "Lewis" }
+```
+
+The current implementation copies each key directly to an instance variable. For
+example, `first_name: "Lewis"` sets `@first_name`. Define `attr_accessor`,
+`attr_reader`, or explicit methods for values you need to read later.
 
-`form.save # returns true if valid?`
+This assignment style does not call custom setters and does not reject unknown
+attribute names.
 
-#### Emulate a save!
+### Validations
 
-Raise an error if cannot be saved
+`PassiveModel::Base` includes ActiveModel validations, so standard Rails
+validators work:
 
-`form.save!`
+```ruby
+form = ContactForm.new(last_name: "Doe")
+
+form.valid? # => false
+form.errors[:first_name] # => ["can't be blank"]
+```
 
-#### persisted?
+ActiveModel validation callbacks such as `before_validation` and
+`after_validation` are also available.
 
-Return if save has been called
+### Save
 
-`form.persisted?`
+`save` validates the object. If the object is invalid, it returns `false`. If the
+object is valid, it runs registered `before_save` callbacks and returns `true`.
+
+```ruby
+invalid_form = ContactForm.new(last_name: "Doe")
+valid_form = ContactForm.new(first_name: "John", last_name: "Doe")
+
+invalid_form.save # => false
+valid_form.save # => true
+```
 
-#### before_save callback
+### Save Bang
 
-Add a callback as follows:
+`save!` calls `save` and raises `PassiveModel::ValidationError` when the object
+cannot be saved. `PassiveModel::ValidationError` inherits from
+`ActiveModel::ValidationError`; it does not require ActiveRecord.
 
-```erbruby
+```ruby
+form = ContactForm.new
+
+form.save! # raises PassiveModel::ValidationError
+```
+
+### before_save Callback
+
+Register a `before_save` callback with the class method:
+
+```ruby
 class ContactForm < PassiveModel::Base
+  attr_accessor :first_name
+
+  validates :first_name, presence: true
+
   before_save :send_info_to_mailchimp
-  
-  validate :first_name, presence: true
-  
+
   private
-  
+
   def send_info_to_mailchimp
-    # API call  
+    # API call
   end
 end
 ```
 
-The callback will be executed only if validations are clear.
+The callback is executed only after validations pass.
+
+`before_save` callbacks are stored per class, so callbacks registered on one
+`PassiveModel::Base` subclass do not run for unrelated subclasses.
+
+### persisted?
+
+`persisted?` is intended to report whether `save` has been called successfully.
+In the current implementation it returns `false` unless an instance sets
+`@persisted` itself.
+
+## Behavior Notes
+
+These notes describe the current gem behavior and should be reviewed before
+changing runtime code:
+
+- `persisted?` does not currently switch to `true` after a successful `save`.
+- Attribute assignment writes instance variables directly instead of using
+  ActiveModel attributes or custom setters.
 
 ## Contributing
 
-If you need more functionality, for bug reports raise a request at https://github.com/RocketApex/passive_model
+For bug reports or feature requests, open an issue at
+https://github.com/RocketApex/passive_model.

data/lib/passive_model/base.rb

@@ -12,6 +12,27 @@ module PassiveModel
     include ActiveModel::Validations::Callbacks
     include ActiveModel::Conversion
     extend ActiveModel::Naming
+    extend ActiveModel::Translation
+
+    class << self
+      def before_save(name)
+        callback = name.to_sym
+
+        before_save_callbacks << callback unless before_save_callbacks.include?(callback)
+      end
+
+      def inherited(subclass)
+        super
+
+        subclass.instance_variable_set(:@before_save_callbacks, before_save_callbacks.dup)
+      end
+
+      private
+
+      def before_save_callbacks
+        @before_save_callbacks ||= []
+      end
+    end
 
     def initialize(hash = {})
       set_attributes(hash)
@@ -24,12 +45,12 @@ module PassiveModel
     def save
       return false unless self.valid?
 
-      execute_callbacks(@@before_save_callbacks)
+      execute_callbacks(before_save_callbacks)
       true
     end
 
     def save!
-      raise(ActiveRecord::RecordInvalid) unless self.save
+      raise(PassiveModel::ValidationError.new(self)) unless self.save
     end
 
     def persisted?
@@ -44,9 +65,8 @@ module PassiveModel
       end
     end
 
-    def self.before_save(name)
-      @@before_save_callbacks ||= []
-      @@before_save_callbacks << name unless @@before_save_callbacks.include?(name)
+    def before_save_callbacks
+      self.class.send(:before_save_callbacks)
     end
 
     def set_attributes(hash)

data/lib/passive_model/version.rb

@@ -1,3 +1,3 @@
 module PassiveModel
-  VERSION = "1.0.2"
+  VERSION = "1.1.0"
 end

data/lib/passive_model.rb

@@ -1,6 +1,9 @@
 require "passive_model/version"
-require "passive_model/base"
+require "active_model"
 
 module PassiveModel
   class Error < StandardError; end
+  class ValidationError < ActiveModel::ValidationError; end
 end
+
+require "passive_model/base"

metadata

@@ -1,17 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: passive_model
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Jey Geethan
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-14 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -32,6 +31,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - MIT-LICENSE
 - README.md
 - Rakefile
@@ -44,9 +44,8 @@ licenses:
 metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/RocketApex/passive_model
-  source_code_uri: https://github.com/RocketApex/passive_model
-  changelog_uri: https://github.com/RocketApex/passive_model
-post_install_message:
+  source_code_uri: https://github.com/RocketApex/passive_model/tree/main
+  changelog_uri: https://github.com/RocketApex/passive_model/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib
@@ -54,15 +53,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 4.0.11
 specification_version: 4
 summary: For using models without saving to the database
 test_files: []