nested_select 0.3.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7df4328a84a6701ef2081be1b647cd9f1c07442b6dfd48c580126daa369ef80
-  data.tar.gz: 17fd02a9b6f0bf767b55bae9243534030a4ccd7d524ff0c72cd3f62ab4e7b46c
+  metadata.gz: 5a119142073dc411c9af1581fa20953d0931293ab8d743e197c1fe8ab66b6d85
+  data.tar.gz: 2e33d0e18a6285d508198d32b8c7094eb4e438257d52c45d3de65f6fc5347733
 SHA512:
-  metadata.gz: 413915e07ba1daa75689c3863f8b6084aaaacace89afe075aaf115a61b6c34245acee01c4eae87ec9509bf7ce0d0b38e9f4fa4a6e17d341177a71d1cb5e31d42
-  data.tar.gz: d955c8d791e58df7025998c69a43bf459c03897384c2c68658e03600ba63158678012c90fded55f35fb8acc64fa652d255381d7164077dbe9c01febddf23d1e8
+  metadata.gz: 58aa697961c7872373973bdbdde0f097e70643fd2c8d325b26df8e079bb5ce0d3be4ca5f1445e907e6a0ccf3f9caa8e21d5dc21a5d2f646f40d5bd649132952d
+  data.tar.gz: 402a314b8f3313f2431ec6b1f707408444ea26e5ee1f199f3de525afb85ba507297b2cf70aa9a90e54f6a9a01d3ff1038d842b81b753879533c295743c5b76b7

data/Appraisals

@@ -0,0 +1,11 @@
+appraise "rails-7" do
+  gem "rails", "~> 7.1"
+end
+
+appraise "rails-7.2" do
+  gem "rails", "~> 7.1"
+end
+
+appraise "rails-8" do
+  gem "rails", ">= 8"
+end

data/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [0.4.2] - 2025-03-01
+- Refactoring
+- Removed all commented out code
+
+## [0.4.1] - 2025-03-01
+- Appraisal added as a development dependency
+- added github CI 
+
+## [0.4.0] - 2025-02-09
+- through relations are now also supported and allowed to partial selection via reverse nested_selection tree
+- README updated with more examples and corner cases
+- nested_select will prevent multiple partial instantiation with different attributes
+
 ## [0.3.0] - 2025-01-25
 
 - nested_select belongs_to limitation now prevents accidental foreign_key absence 

data/Dockerfile_apprsl

@@ -0,0 +1,22 @@
+FROM ruby:3.2-bullseye
+
+WORKDIR /app
+RUN  apt-get update && apt-get -y install lsb-release
+#
+RUN wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | apt-key add - && \
+    sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list' && \
+    apt-get update && apt-get -y install postgresql postgresql-client-14
+
+RUN sh -c 'echo "local   all             all                                     trust" > /etc/postgresql/$(ls /etc/postgresql)/main/pg_hba.conf' && \
+    service postgresql start && \
+    psql -U postgres -c 'CREATE DATABASE "niceql-test"'
+
+RUN gem install bundler
+
+COPY lib/rails_sql_prettifier/version.rb /app/lib/rails_sql_prettifier/version.rb
+COPY rails_sql_prettifier.gemspec /app/
+COPY Gemfil* /app/
+COPY Appraisals /app/
+#
+RUN bundle install
+RUN bundle exec appraisal install

data/README.md

@@ -1,17 +1,15 @@
-# WIP disclaimer
-The gem is under active development now. 
-Use in prod with caution only if you are properly covered by your CI. Read **Safety** and **Limitations** sections before.
-
 # Nested select -- 7 times faster and 33 times less RAM on preloading relations with heavy columns!
-nested_select allows the partial selection of the relations attributes during preloading process, leading to less RAM and CPU usage.
-Here is a benchmark output for a [gist I've created](https://gist.github.com/alekseyl/5d08782808a29df6813f16965f70228a) to emulate real-life example: displaying a course with its structure.
+nested_select allows the partial selection of the relations attributes during preloading process, 
+leading to less RAM and CPU usage.
+Here is a benchmark output for a [gist I've created](https://gist.github.com/alekseyl/5d08782808a29df6813f16965f70228a) to run real-life example: 
+displaying a course with its structure.
 
 Given: 
 - Models are Course, Topic, Lesson. 
 - Their relations has a following structure: course has_many topics, each topic has_many lessons. 
 - To display a single course you need its structure, minimum data needed: topic and lessons titles and ordering.
 
-**Single course**, a real prod set of data used by current UI (~ x33 times less RAM):
+**Single course**, a real example against production data and a real flow (~ x33 times less RAM):
 
 ```
 irb(main):216:0>compare_nested_select(ids, 1, silence_ar_logger_for_memory_profiling: false)
@@ -22,9 +20,10 @@ nested_select  0.096008   0.002876   0.098884 (  0.466985)
 simple includes  0.209188   0.058340   0.267528 (  0.903893)                                                       
                                                                                                                    
 ----------------- Memory comparison, for root_collection_size: 1 ---------                                         
-
+# partial selection
 D, [2025-01-12T19:08:36.163282 #503] DEBUG -- :   Topic Load (4.1ms)  SELECT "topics"."id", "topics"."position", "topics"."title", "topics"."course_id" FROM "topics" WHERE "topics"."deleted_at" IS NULL AND "topics"."course_id" = $1  [["course_id", 1624]]                                                                 
 D, [2025-01-12T19:08:36.168803 #503] DEBUG -- :   Lesson Load (3.9ms)  SELECT "lessons"."id", "lessons"."title", "lessons"."topic_id", "lessons"."position", "lessons"."topic_id" FROM "lessons" WHERE "lessons"."deleted_at" IS NULL AND "lessons"."topic_id" = $1  [["topic_id", 7297]]                                      
+# selects in full 
 D, [2025-01-12T19:08:37.220379 #503] DEBUG -- :   Topic Load (4.2ms)  SELECT "topics"."id", "topics"."position", "topics"."title", "topics"."course_id" FROM "topics" WHERE "topics"."deleted_at" IS NULL AND "topics"."course_id" = $1  [["course_id", 1624]]                                                                 
 D, [2025-01-12T19:08:37.247484 #503] DEBUG -- :   Lesson Load (25.7ms)  SELECT "lessons".* FROM "lessons" WHERE "lessons"."deleted_at" IS NULL AND "lessons"."topic_id" = $1  [["topic_id", 7297]]
 
@@ -39,8 +38,8 @@ RAM ratio improvements x33.54678126442086 on retain objects
 RAM ratio improvements x15.002820281285949 on total_allocated objects
 ```
 
-**100 courses**, this is kinda a synthetic example (there is no UI for multiple courses display with their structure) 
-on the real prod data, but the bigger than needed collection (x7 faster):
+**100 courses**, this is kinda a synthetic example since there is no UI for multiple courses display together with their structures.
+It executed against the real production data. (nested select serves x7 faster):
 
 ```
 irb(main):280:0> compare_nested_select(ids, 100)
@@ -48,7 +47,7 @@ irb(main):280:0> compare_nested_select(ids, 100)
 ------- CPU comparison, for root_collection_size: 100 ----
                     user     system      total        real           
 nested_select    1.571095   0.021778   1.592873 (  2.263369)
-simple includes  5.374909   1.704284   7.079193 ( 15.488579)
+simple includes  5.374909   1.704284   7.079193 ( 15.488579) 
                                                         
 ----------------- Memory comparison, for root_collection_size: 100 ---------
 ------ Nested Select memory consumption for root_collection_size: 100 ------
@@ -62,9 +61,11 @@ Total allocated: 33.05 MB (38332 objects)
 Total retained:  32.00 MB (24057 objects)               
 RAM ratio improvements x15.57707431190517 on retain objects
 RAM ratio improvements x11.836000856510193 on total_allocated objects
-
 ```
 
+**Summary:** if you have CPU/RAM bottlenecks, heavy relations instantiation for heavy views or reports generation, 
+and you want it to be less demanding in RAM and CPU -- you should try nested_select. 
+
 ## Installation
 
 Install the gem and add to the application's Gemfile by executing:
@@ -76,6 +77,8 @@ If bundler is not being used to manage dependencies, install the gem by executin
     $ gem install nested_select
 
 ## Usage
+
+### Specify which attributes to load in preloading models   
 Assume you have a relation users <- profile, and you want to preview users in a paginated feed, 
 and you need only :photo_url attribute of a profile, with nested_select you can do it like this:  
 
@@ -95,16 +98,88 @@ end
 User.includes(:profile).select(profile: :photo_url).limit(10)
 ```
 
-## Safety
+### Partial preloading of through relations 
+Whenever you are using `through` relations between models and running preload, 
+then rails will fully load all intermediate objects under the hood!
+That is definitely wastes lots of RAM, CPU including those on the DB side. 
+With nested_select you can apply selections to `through` relations. 
+Ex:
+
+```ruby
+class User
+  has_one :user_profile, inverse_of: :user
+  has_many :avatars, through: :user_profile, inverse_of: :user
+end
+
+  # pay attention user_profile relation, wasn't included explicitly, 
+  # but still rails needed them to be preloaded to be able to match and preload avatars
+  user = User.includes(:avatars)
+             .select(avatars: [:img_url, { user_profile: [:zip_code] }]).first
+  
+  # user - loaded fully
+  # avatars - foreign and primary keys needed to establish relations + img_url
+  # user_profile - foreign and primary keys + zip_code
+```
+**REM:** Through preloading happens in reverse, so to nest their selection 
+you must start from the latest, in this case avatar, and go to the previous ones in this case its a user_profile
+
+If you want intermediate models to be completely skinny, you should select like this:
+
+```ruby
+class User
+  has_one :user_profile, inverse_of: :user
+  has_many :avatars, through: :user_profile, inverse_of: :user
+  has_many :through_avatar_images, through: :avatars, class_name: :Image, source: :images
+end
+
+  # only through_avatar_images is matter here, and we want everything else to be as small as possible
+  user = User.includes(:through_avatar_images)
+             .select(through_avatar_images: [avatars: [:id, user_profile: [:id]]]).first
+  
+  # through_avatar_images -- loaded in full
+  # avatars, user_profile -- only relations columns id, user_profile_id e.t.c
+```
+
+**REM** There was an idea for through relations use a skinny approach: no nested attributes means, 
+only relation keys should be loaded:
+
+```ruby
+  user = User.includes(:through_avatar_images)
+             .select(through_avatar_images: [avatars: :user_profile]).first
+```
+but that could be easily confused with normal flow behaviour, so I stick to basic default: no nested attributes,
+means default behaviour, i.e. all attributes. 
+
+
+# Safety
 How safe is the partial model loading? Earlier version of rails and activerecord would return nil in the case, 
 when attribute wasn't selected from a DB, but rails 6 started to raise a ActiveModel::MissingAttributeError. 
 So the major problem is already solved -- your code will not operate based on falsy blank values, it will raise an exception. 
 
+But if you are working with attributes directly ( which you should not btw ), you will see nil, without any exception. 
+Using as_json on such models will also deliver json without exception and without skipped attributes. 
+
+## Partial selection in multiple preloading branches
+If you are doing some strange or narrow cases whenever you preloading same objects via different preloading branches, 
+including the most common case through relations, which rails preloads in full, then you must be very accurate 
+with nested selection, cause rails loads and attach associations only once, if it was partial
+than you might get yourself into trouble. BUT nested_select will check and raise an exception 
+if you are trying to re-instantiate with a different set of attributes. Ex:
+
+```
+ActiveModel::MissingAttributeError: Reflection 'avatars' already loaded with a different set of basic attributes.
+expected: ["img_url", "user_profile_id", "id"], already loaded with: ["created_at", "user_profile_id", "id"]
+Hint: ensure that you are using same set of attributes for entrance of same relation
+      on nesting selection tree including reverse through relations
+```
+
+# Limitations
+
 ## belongs_to foreign keys limitations 
-Rails preloading happens from loaded record to their reflection step by step. 
-That's makes pretty easy to include foreign keys for has_* relations, and very hard for belongs_to, 
+Rails preloading happens from loaded records to their reflections step by step. 
+That's makes it pretty easy to include foreign keys for has_* relations, and very hard for belongs_to, 
 to work this out you need to analyze includes based on the already loaded records, analyze and traverse their relations.
-This needs a lot of monkey patching, and for now I decided not to gow this way.
+This needs a lot of monkey patching, and for now I decided not to go this way.
 That means in case when nesting selects based on belongs_to reflections, 
 you'll need to select their foreign keys **EXPLICITLY!** 
 
@@ -118,15 +193,18 @@ class Image < ApplicationRecord
   belongs_to :avatar
 end
 
-Image.includes(avatar: :user).select(avatar: [:id, :size, { user: [:email] }]).load # <--- will raise a Missing Attribute exception 
+Image.includes(avatar: :user).select(avatar: [:size, { user: [:email] }]).load # <--- will raise a Missing Attribute exception 
 
 #> ActiveModel::MissingAttributeError: Parent reflection avatar was missing foreign key user_id in nested selection
 #> while trying to preload belongs_to reflection named user.
 #> Hint: didn't you forgot to add user_id inside [:id, :size]?
 
-Image.includes(avatar: :user).select(avatar: [:id, :size, :user_id, { user: [:email] }]).load
+Image.includes(avatar: :user).select(avatar: [:size, :user_id, { user: [:email] }]).load
 ```
 
+## will not work with ar_lazy_preload
+Right now it will not work with ar_lazy_preload gem. nested_select relies on the includes_values definition
+of a relation. If you are doing it in a lazy way, there weren't any explicit includes, that means it will not extract any nested selection.
 
 ## Testing
 
@@ -135,15 +213,16 @@ docker compose run test
 ```
 
 ## TODO
-- [ ] Cover all relation combinations and add missing functionality
+- [x] Cover all relation combinations and add missing functionality
   - [x] Ensure relations foreign keys are present on the selection
   - [x] Ensure primary key will be added
-  - [-] Ensure belongs_to will add a foreign_key column
-- [ ] Optimize through relations ( since they loading a whole set of attributes )
-- [ ] Separated rails version testing
+  - [-] Ensure belongs_to will add a foreign_key column (Too hard to manage :(, its definitely not a low hanging fruit)
+- [x] Optimize through relations ( since they loading a whole set of attributes )
+- [x] Separated rails version testing
 - [x] Merge multiple nested selections 
 - [x] Don't apply any selection if blank ( allows to limit only part of subselection tree)
 - [x] Allows to use custom attributes
+- [ ] Eager loading? 
 
 ## Development
 

data/docker-compose.yml

@@ -11,3 +11,11 @@ services:
       - './Gemfile:/app/Gemfile'
       - './Gemfile.lock:/app/Gemfile.lock'
 
+  appraisal:
+    build:
+      context: .
+      dockerfile: Dockerfile_apprsl
+    image: nested_select_appraisal
+    command: /bin/bash -c 'service postgresql start && appraisal rake test'
+    volumes:
+      - '.:/app'

data/lib/nested_select/preloader/association.rb

@@ -4,12 +4,56 @@ module NestedSelect
       attr_reader :nested_select_values
 
       def build_scope
-        nested_select_values.blank? ? super : super.select(*nested_select_values)
+        association_nested_select_values.blank? ? super : super.select(association_nested_select_values)
       end
 
       def apply_nested_select_values(partial_select_values)
+        @nested_select_values = [*partial_select_values]
+        ensure_nesting_selection_integrity!(association_nested_select_values)
+      end
+      def reflection_relation_keys_attributes
         foreign_key = reflection.foreign_key unless reflection.is_a?(ActiveRecord::Reflection::BelongsToReflection)
-        @nested_select_values = [*partial_select_values, *foreign_key, *reflection.klass.primary_key].uniq
+        [*foreign_key, *reflection.klass.primary_key].map(&:to_s)
+      end
+
+      def association_nested_select_values
+        this_association_select_values = nested_select_values&.grep_v(Hash)&.map {_1.try(:to_s) }
+        return if this_association_select_values.blank?
+
+        [*this_association_select_values, *reflection_relation_keys_attributes].uniq
+      end
+
+      # ensure that different preloading branches will match nested selected attributes
+      def ensure_nesting_selection_integrity!(nested_select_final_values)
+        single_owner = owners.first
+        # do nothing unless not yet loaded
+        return unless single_owner.association(reflection.name).loaded?
+
+        single_reflection_record = single_owner.send(reflection.name)
+        return if single_reflection_record.blank?
+
+        single_reflection_record = single_reflection_record.first if single_reflection_record.is_a?(Enumerable)
+
+        attributes_loaded = single_reflection_record.attributes.keys.map(&:to_s)
+        current_selection = nested_select_final_values.grep_v(Hash).map(&:to_s)
+
+        basic_attributes_matched = (attributes_loaded & reflection.klass.column_names).tally ==
+                                   (current_selection & reflection.klass.column_names).tally
+
+        # this is not a 100% safe verification, but it will match cases with custom attributes selection for example:
+        # "(SELECT COUNT(*) FROM images) as IMG_count" =~ /img_count/
+        custom_attributes_matched = (attributes_loaded - reflection.klass.column_names).all? do |loaded_attr|
+          (current_selection - reflection.klass.column_names).any? do |upcoming_custom_attr|
+            upcoming_custom_attr =~ /#{loaded_attr}/i
+          end
+        end
+
+        raise ActiveModel::MissingAttributeError, <<~ERR if !basic_attributes_matched || !custom_attributes_matched
+          Reflection '#{reflection.name}' already loaded with a different set of basic attributes.
+          expected: #{current_selection}, already loaded with: #{attributes_loaded}
+          Hint: ensure that you are using same set of attributes for entrance of same relation
+                on nesting selection tree including reverse through relations
+        ERR
       end
     end
   end

data/lib/nested_select/preloader/branch.rb

@@ -7,6 +7,7 @@ module NestedSelect
         prevent_belongs_to_foreign_key_absence!(reflection)
 
         super.tap do |ldrs|
+          # nested_select_values contains current level selection + nested relation selections
           ldrs.each{ _1.apply_nested_select_values(nested_select_values) } if nested_select_values.present?
         end
       end
@@ -17,16 +18,16 @@ module NestedSelect
 
         # ActiveRecord will not raise in case its missing, so we should prevent silent error here
         if parent.nested_select_values.present? &&
-          !parent.nested_select_values.map(&:to_sym).include?( reflection.foreign_key.to_sym )
+          !parent.nested_select_values.grep_v(Hash)
+                 .map(&:to_sym).include?(reflection.foreign_key.to_sym)
 
           raise ActiveModel::MissingAttributeError, <<~ERR
             Parent reflection #{parent.association} was missing foreign key #{reflection.foreign_key} in nested selection,
-            while trying to preload belongs_to reflection named #{reflection.name}. 
+            while trying to preload belongs_to reflection named #{reflection.name}.
             Hint: didn't you forgot to add #{reflection.foreign_key} inside #{parent.nested_select_values}?
           ERR
         end
       end
-
     end
   end
 end

data/lib/nested_select/preloader/through_association.rb

@@ -7,16 +7,16 @@ module NestedSelect
           associations: through_reflection.name,
           scope: through_scope,
           associate_by_default: false,
-          ).tap { _1.apply_nested_select_values(nested_select_values) }.loaders
+          ).tap do
+          _1.apply_nested_select_values(nested_select_values.grep(Hash))
+        end.loaders
       end
 
-      def apply_nested_select_values( partial_select_values )
-        return super unless reflection.parent_reflection.is_a?( ActiveRecord::Reflection::HasAndBelongsToManyReflection)
-
-        # when parent reflection is a HasAndBelongsToManyReflection,
-        # then we don't need foreign_key to be included, as it does in super
-        @nested_select_values = partial_select_values
+      def reflection_relation_keys_attributes
+        foreign_key = reflection.foreign_key unless reflection.parent_reflection.is_a?(ActiveRecord::Reflection::HasAndBelongsToManyReflection)
+        [*foreign_key, *reflection.klass.primary_key].map(&:to_s)
       end
+
     end
   end
 end

data/lib/nested_select/preloader.rb

@@ -12,6 +12,8 @@ module NestedSelect
       ActiveRecord::Associations::Preloader::ThroughAssociation.prepend(ThroughAssociation)
       ActiveRecord::Associations::Preloader::Association.prepend(Association)
     end
+
+    # first one will start from the roots [included_1: [{}], included_2: [{}] ]
     def apply_nested_select_values(nested_select_values)
       distribute_nested_select_over_loading_tree(@tree, nested_select_values)
     end
@@ -20,12 +22,19 @@ module NestedSelect
       #  nested_select_values = [:id, :title, comments: [:id, :body], cover: [:id, img: [:url]]]
       return if nested_select_values.blank?
 
-      sub_tree.nested_select_values = nested_select_values.grep_v(Hash)
+      sub_tree.nested_select_values = [*nested_select_values.grep_v(Hash)]
       # sub_nested_select_values = { comments: [:id, :body], cover: [:id, img: [:url]] }
-      sub_nested_select_values = nested_select_values.grep(Hash).inject(&:merge)&.symbolize_keys
+      sub_nested_select_values = nested_select_values.grep(Hash).inject({}, &:merge)&.symbolize_keys
+
       # it could be a case when selection tree is not that deep than Branch tree.
       return if sub_nested_select_values.blank?
 
+      # its possible to subselect in reverse direction for through relation's
+      # in that case includes are implicit, but we need to add that reverse tree into nested select
+      reverse_nested_selections = sub_nested_select_values.except(*sub_tree.children.map(&:association))
+      # this is for reverse selection of through models
+      sub_tree.nested_select_values << reverse_nested_selections if reverse_nested_selections.present?
+
       sub_tree.children.each do |chld_brnch|
         distribute_nested_select_over_loading_tree(chld_brnch, sub_nested_select_values[chld_brnch.association])
       end

data/lib/nested_select/relation.rb

@@ -9,17 +9,30 @@ module NestedSelect
     def select(*fields)
       # {user_profile: [:zip_code]} + {user_profile: [:bio]} -> { user_profile: [:zip_code, :bio] }
       @nested_select_values = [*@nested_select_values, *fields.grep(Hash)].deep_combine_elements
+      # returning self means -- there was only nesting selection,
+      # and we should not interfere with default selection
       fields.grep_v(Hash).present? ? super(*fields.grep_v(Hash)) : self
     end
 
+    # # when nested_select interferes the 'through' selection, its doing this in reverse
+    # # in this case the first one preload wins a selection scope,
+    # # so we need to make them all the same across all selection trees
+    # # ( except for the cases when traversing ends up in same place using different path,
+    # # this case is out of the normal sense )
+    # def combine_reverse_selection_sub_trees
+    #   @nested_select_values.permutation.each do |left, right|
+    #
+    #   end
+    # end
+
     def preload_associations(records) # :nodoc:
       preload = preload_values
       preload += includes_values unless eager_loading?
       scope = strict_loading_value ? StrictLoadingScope : nil
       preload.each do |associations|
         ActiveRecord::Associations::Preloader.new(records:, associations:, scope:)
-                                             .tap{ _1.apply_nested_select_values(nested_select_values) } # <-- Patching code
-                                             .call
+          .tap{_1.apply_nested_select_values(nested_select_values) } # <-- Patching code
+          .call
       end
     end
   end

data/lib/nested_select/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module NestedSelect
-  VERSION = "0.3.0"
+  VERSION = "0.4.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nested_select
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.2
 platform: ruby
 authors:
 - alekseyl
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-02-01 00:00:00.000000000 Z
+date: 2025-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -178,6 +178,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: ActiveRecord improved select on nested models, allows partial instantiation
   on nested models, easy one step improvements on performance and memory
 email:
@@ -188,15 +202,13 @@ extra_rdoc_files: []
 files:
 - ".idea/.gitignore"
 - ".idea/inspectionProfiles/profiles_settings.xml"
-- ".idea/misc.xml"
-- ".idea/modules.xml"
-- ".idea/nested_select.iml"
-- ".idea/vcs.xml"
 - ".rubocop.yml"
 - ABOUT_NESTED_SELECT.md
+- Appraisals
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Dockerfile
+- Dockerfile_apprsl
 - LICENSE.txt
 - README.md
 - Rakefile

data/.idea/misc.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="NodePackageJsonFileManager">
-    <packageJsonPaths />
-  </component>
-</project>

data/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/nested_select.iml" filepath="$PROJECT_DIR$/.idea/nested_select.iml" />
-    </modules>
-  </component>
-</project>

data/.idea/nested_select.iml

@@ -1,125 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="RUBY_MODULE" version="4">
-  <component name="ModuleRunConfigurationManager">
-    <shared />
-  </component>
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$">
-      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
-      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
-      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
-    </content>
-    <orderEntry type="jdk" jdkName="RVM: ruby-3.3.4 [ns1]" jdkType="RUBY_SDK" />
-    <orderEntry type="sourceFolder" forTests="false" />
-    <orderEntry type="library" scope="PROVIDED" name="actionpack (v8.0.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="actionview (v8.0.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="activemodel (v8.0.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="activerecord (v8.0.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="activesupport (v8.0.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="amazing_print (v1.7.2, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="ast (v2.4.2, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="benchmark (v0.4.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="bigdecimal (v3.1.9, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="builder (v3.3.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.5.11, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="byebug (v11.1.3, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="concurrent-ruby (v1.3.4, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="connection_pool (v2.5.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="crass (v1.0.6, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="date (v3.4.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="drb (v2.2.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="erubi (v1.13.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="i18n (v1.14.6, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="io-console (v0.8.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="irb (v1.14.3, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="json (v2.9.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="language_server-protocol (v3.17.0.3, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="logger (v1.6.5, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="loofah (v2.24.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="minitest (v5.25.4, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="niceql (v0.6.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="nokogiri (v1.18.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="parallel (v1.26.3, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="parser (v3.3.6.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="psych (v5.2.3, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="racc (v1.8.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rack (v3.1.8, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rack-session (v2.1.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rack-test (v2.2.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rackup (v2.2.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rails-dom-testing (v2.2.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rails-html-sanitizer (v1.6.2, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rails-i18n (v8.0.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rails_sql_prettifier (v7.0.4, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="railties (v8.0.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rainbow (v3.1.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rake (v13.2.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rdoc (v6.11.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="regexp_parser (v2.10.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="reline (v0.6.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rubocop (v1.70.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="rubocop-ast (v1.37.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="ruby-progressbar (v1.13.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="securerandom (v0.4.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="sqlite3 (v2.5.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="stringio (v3.1.2, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="stubberry (v0.3.0, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="thor (v1.3.2, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="timeout (v0.4.3, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="tzinfo (v2.0.6, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="unicode-display_width (v3.1.3, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="unicode-emoji (v4.0.4, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="uri (v1.0.2, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="useragent (v0.16.11, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-    <orderEntry type="library" scope="PROVIDED" name="zeitwerk (v2.7.1, RVM: ruby-3.3.4 [ns1]) [gem]" level="application" />
-  </component>
-  <component name="RakeTasksCache-v2">
-    <option name="myRootTask">
-      <RakeTaskImpl id="rake">
-        <subtasks>
-          <RakeTaskImpl description="Build nested_select-0.2.0.gem into the pkg directory" fullCommand="build" id="build" />
-          <RakeTaskImpl id="build">
-            <subtasks>
-              <RakeTaskImpl description="Generate SHA512 checksum of nested_select-0.2.0.gem into the checksums directory" fullCommand="build:checksum" id="checksum" />
-            </subtasks>
-          </RakeTaskImpl>
-          <RakeTaskImpl description="Remove any temporary products" fullCommand="clean" id="clean" />
-          <RakeTaskImpl description="Remove any generated files" fullCommand="clobber" id="clobber" />
-          <RakeTaskImpl description="Build and install nested_select-0.2.0.gem into system gems" fullCommand="install" id="install" />
-          <RakeTaskImpl id="install">
-            <subtasks>
-              <RakeTaskImpl description="Build and install nested_select-0.2.0.gem into system gems without network access" fullCommand="install:local" id="local" />
-            </subtasks>
-          </RakeTaskImpl>
-          <RakeTaskImpl description="Create tag v0.2.0 and build and push nested_select-0.2.0.gem to https://rubygems.org" fullCommand="release[remote]" id="release[remote]" />
-          <RakeTaskImpl description="Run RuboCop" fullCommand="rubocop" id="rubocop" />
-          <RakeTaskImpl id="rubocop">
-            <subtasks>
-              <RakeTaskImpl description="Autocorrect RuboCop offenses (only when it's safe)" fullCommand="rubocop:autocorrect" id="autocorrect" />
-              <RakeTaskImpl description="Autocorrect RuboCop offenses (safe and unsafe)" fullCommand="rubocop:autocorrect_all" id="autocorrect_all" />
-              <RakeTaskImpl description="" fullCommand="rubocop:auto_correct" id="auto_correct" />
-            </subtasks>
-          </RakeTaskImpl>
-          <RakeTaskImpl description="Run the test suite" fullCommand="test" id="test" />
-          <RakeTaskImpl id="test">
-            <subtasks>
-              <RakeTaskImpl description="Print out the test command" fullCommand="test:cmd" id="cmd" />
-              <RakeTaskImpl description="Show which test files fail when run in isolation" fullCommand="test:isolated" id="isolated" />
-              <RakeTaskImpl description="Run the test suite and report the slowest 25 tests" fullCommand="test:slow" id="slow" />
-              <RakeTaskImpl description="" fullCommand="test:deps" id="deps" />
-            </subtasks>
-          </RakeTaskImpl>
-          <RakeTaskImpl description="" fullCommand="default" id="default" />
-          <RakeTaskImpl description="" fullCommand="release" id="release" />
-          <RakeTaskImpl id="release">
-            <subtasks>
-              <RakeTaskImpl description="" fullCommand="release:guard_clean" id="guard_clean" />
-              <RakeTaskImpl description="" fullCommand="release:rubygem_push" id="rubygem_push" />
-              <RakeTaskImpl description="" fullCommand="release:source_control_push" id="source_control_push" />
-            </subtasks>
-          </RakeTaskImpl>
-        </subtasks>
-      </RakeTaskImpl>
-    </option>
-  </component>
-</module>

data/.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>