standard_procedure_has_attributes 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fd9d76cb1b8d6eca0e2be02212fb237a1f49c1c014010dc71ddca9678ea247a
-  data.tar.gz: f66ffafac490c8ad1d0915b20bcd56caa2be7eb0a622134785f00c0c4d6f779b
+  metadata.gz: 778498af3e84a9695e11e78dea536d76dca1be4d86919b81694cd5d0cb39be19
+  data.tar.gz: 6351d9e54b44182b9c076bc3b861293cbcd328368e34a7c11f18432984d4e406
 SHA512:
-  metadata.gz: bf4fe8a2fd19fadd3a8f6838e1ff2df9798a4880049cf36f46be7a39402abe5bc9fd0d7f7c940deb13d22aa6661c902dea5c38dd97bb4826de8812883787c40a
-  data.tar.gz: 7527db1e32925575be31abd9f887231245782d31f86df335d543cc62924d304724d1c84552ae22131c193c751257da228f3080cfc96ccafceed6e36165534bef
+  metadata.gz: b110c7d8308842ef2e7d00809d797ac4808105db8f494df2e2a22388c6923f28ddb8b8361b9b91a728976ee5fbf9aaca4b55ec198334e902d406fbc06ab0eb2c
+  data.tar.gz: e45bd96f526d0a04c82b1d6911bded7f37e54831b05e7b1a42a3c83b8847fbef132f484149924a2844ed36df31f0ec1f5cdc70512909b258e95a5dc8064eb570

data/README.md

@@ -71,10 +71,16 @@ Apart from storage, the attribute behaves just like any other attribute on your
 
 ### Defining models 
 
-You can also store references to other models using the `has_model` declaration.  This stores a [GlobalID](https://github.com/rails/globalid) inside the data field, converting the reference back to a real model when needed.  The actual GlobalID is mangled slightly before it is stored, to provide compatibility with the [GlobalIdSerialiser](https://github.com/standard-procedure/global_id_serialiser), which also uses GlobalIDs to store references to models.  The difference with `has_model` is `has_model` reloads the model on-demand, whereas `GlobalIdSerialiser` loads all models from the data field when the record is loaded.  GlobalIdSerialiser also allows you to store your models within arrays or nested inside hashes - but you need to be careful about the performance implications if lots of models are stored.  
+You can also store references to other models using the `has_model` declaration.  This stores a [GlobalID](https://github.com/rails/globalid) inside the data field, converting the reference back to a real model when needed.  `has_model` reloads the model on-demand so there is no database request until you actually try to access the stored model.  However, because of the way this works, you cannot eager-load stored models, so be careful when trying to display large numbers of records, as you will end up with N+1 queries.  
 
 When using `has_model` you can optionally specify a class name (as a string).  If given, the model will be tested to make sure it is that class (or a subclass of it) and, if not the record is marked as invalid.  
 
+### Defining arrays of models
+
+Similarly, you can store arrays of models using the `has_models` declaration.  Internally this stores a comma separated list of GlobalIDs inside the data field, using `GlobalID::Locator.locate_many` to convert the array back to models as efficiently as possible.  Again, eager loading is not possible so watch out for N+1 queries.  
+
+Like `has_model` you can optionally specify a class name (as a string), which then validates the provided models to make sure they are valid classes or subclasses.  
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/checksums/standard_procedure_has_attributes-0.2.0.gem.sha512

@@ -0,0 +1 @@
+a81ee1c0a59142295d6bbfddefd39697884c3de3b911836c49d8f51ffa75b73c21ffe2efa1a7ac90235b640ce5aa07d378d09f4f4b76371a416885704d1a184a

data/checksums/standard_procedure_has_attributes-0.2.1.gem.sha512

@@ -0,0 +1 @@
+63c96059dcaa5affe06c9dd6d785385b00b8908dd7f6301cc2e7f09cf442f88c68d36e1b3448a5bab589cc2a91fb7363fd038ed6300ffa87f57548edd517c56f

data/lib/has_attributes/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HasAttributes
-  VERSION = "0.1.0"
+  VERSION = "0.2.1"
 end

data/lib/has_attributes.rb

@@ -3,7 +3,7 @@
 require_relative "has_attributes/version"
 require "active_support/concern"
 require "active_support/core_ext/string/inflections"
-require "global_id_serialiser"
+require "global_id"
 
 module HasAttributes
   extend ActiveSupport::Concern
@@ -12,22 +12,23 @@ module HasAttributes
   class_methods do
     def has_attribute name, cast_type = :string, field_name: :data, **options
       field_name = field_name.to_sym
-      name = name.to_sym
+      name = name.to_s
       typecaster = cast_type.nil? ? nil : ActiveRecord::Type.lookup(cast_type)
       typecast_value = ->(value) { typecaster.nil? ? value : typecaster.cast(value) }
+      field_name_value = ->(instance) { instance.send(field_name.to_sym) || {} }
       define_attribute_method name
       if cast_type != :boolean
-        define_method(name.to_sym) { typecast_value.call(send(field_name.to_sym)[name.to_s]) || options[:default] }
+        define_method(name.to_sym) { typecast_value.call(field_name_value.call(self)[name.to_s]) || options[:default] }
       else
         define_method(name.to_sym) do
-          value = typecast_value.call(send(field_name.to_sym)[name.to_s])
+          value = typecast_value.call(field_name_value.call(self)[name.to_s])
           [true, false].include?(value) ? value : options[:default]
         end
         alias_method :"#{name}?", name.to_sym
       end
       define_method(:"#{name}=") do |value|
         attribute_will_change! name
-        send(field_name.to_sym)[name.to_s] = typecast_value.call(value)
+        send :"#{field_name}=", field_name_value.call(self).merge(name.to_s => typecast_value.call(value))
       end
     end
 
@@ -38,7 +39,7 @@ module HasAttributes
       validate :"#{name}_class_name", if: -> { send(name).present? } if class_name.present?
 
       define_method(name.to_sym) do
-        model_id = send id_attribute
+        model_id = send id_attribute.to_sym
         model_id.nil? ? nil : GlobalID::Locator.locate(model_id.sub("modelid-", ""))
       rescue ActiveRecord::RecordNotFound
         nil
@@ -53,5 +54,32 @@ module HasAttributes
         errors.add name, :invalid unless send(name).is_a?(class_name.constantize)
       end
     end
+
+    def has_models name, class_name = nil, field_name: :data, **options
+      name = name.to_sym
+      array_attribute = "#{name}_array"
+      has_attribute array_attribute, field_name:, **options
+      validate :"#{name}_class_names", if: -> { send(name).any? } if class_name.present?
+
+      define_method(name.to_sym) do
+        model_ids = send(array_attribute).to_s.split(",").map do |model_id|
+          model_id.to_s.sub("modelid-", "")
+        end
+        GlobalID::Locator.locate_many(model_ids)
+      rescue ActiveRecord::RecordNotFound
+        []
+      end
+
+      define_method(:"#{name}=") do |models|
+        model_ids = Array.wrap(models).map do |model|
+          model.nil? ? nil : "modelid-#{model.to_global_id}"
+        end.compact
+        send :"#{array_attribute}=", model_ids.join(",")
+      end
+
+      define_method :"#{name}_class_names" do
+        errors.add name, :invalid if send(name).any? { |model| !model.is_a?(class_name.constantize) }
+      end
+    end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: standard_procedure_has_attributes
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Rahoul Baruah
 bindir: exe
 cert_chain: []
-date: 2025-06-13 00:00:00.000000000 Z
+date: 2025-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: globalid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
 description: Store Rails attributes in a serialized JSON field, with support for GlobalIDs
   and indexes
 email:
@@ -38,6 +52,8 @@ files:
 - README.md
 - Rakefile
 - checksums/standard_procedure_has_attributes-0.1.0.gem.sha512
+- checksums/standard_procedure_has_attributes-0.2.0.gem.sha512
+- checksums/standard_procedure_has_attributes-0.2.1.gem.sha512
 - lib/has_attributes.rb
 - lib/has_attributes/version.rb
 - sig/has_attributes.rbs