passive_columns 0.3.4 → 0.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1dda0f9908da208e37e6a916682dca1694dd57ff1093235e75071a38e35ebd0
-  data.tar.gz: 6d320b51823509635303c91f90c116170db1c2a2f44559443948629a630872ba
+  metadata.gz: db1546c471db3b31751f758a4787d689707e1202f7662485f2710ccdb1e72bd1
+  data.tar.gz: '0486b7f619953eb457c5d3743c44c6171718ed5573a22cb3b2674c5f7928987b'
 SHA512:
-  metadata.gz: 4002b0fff7d1563677d309215c1b6de3755206df2ea99cc71cdeb2df5089d39e8883fb4954bbacb3bb23427eb46fa86fa2d13ca7b707ddcf39bc9bb038b1c1f5
-  data.tar.gz: 655257c23cd3ee05d2941236b4af332f293270a2bb5023606df1053b1b41c6ef44c75a87ccc756f35cd89fdd85271819512fe760bc63f16e388f0a9357edad78
+  metadata.gz: 63e2a1db74d7430af2c98b7d837866d74eefeb90d68075ebf74ef8e4e35da35dec147c60b9a026be89d6e33d4180deca6584fbb7e1e51e478d456225f66515e4
+  data.tar.gz: 7062e8a4565dece1d5d341c8b50761356c5c11efb546de15ed4b513d98a0d83c6e04cb0f9db24f2cbc7b7c4ce7e666baf8e8f9c19d500050cf786e7e3fe2d424

data/README.md

@@ -37,6 +37,27 @@ But you still has an ability to retrieve the passive column on demand
   page.huge_article # => 'Some huge article...'
 ```
 
+### Eager-loading passive columns in the same query
+
+Use `with_passive_columns` when you want passive columns included in the main `SELECT` instead of loading them later.
+
+```ruby
+  # All columns (including every passive column)
+  Page.with_passive_columns
+
+  # Default non-passive columns plus only the passive columns you list.
+  # Any names that are not passive columns are ignored.
+  Page.with_passive_columns(:huge_article)
+
+  # On an association (scope is on the associated model):
+  user.pages.with_passive_columns(:huge_article)
+
+  # Equivalent when you already have a relation object to merge:
+  user.pages.merge(Page.with_passive_columns(:huge_article))
+```
+
+`find` / `find_by` still use the default selection unless you chain `with_passive_columns` explicitly (for example `Page.with_passive_columns.find(id)`).
+
 ---
 
 
@@ -65,6 +86,9 @@ user.name
 
 By the way, it uses the Rails' `.pick` method to get the value of the column under the hood
 
+### Logging on-demand SQL loads
+
+Whenever a passive attribute reader or `load_column` runs the extra `pick` query, the gem logs one **`debug`** line (prefix `[passive_columns]`, model, column, and primary-key context) **only if** `model.logger` is set — there is no fallback to `ActiveRecord::Base.logger`. Like other debug lines, it appears only when that logger’s level is **debug** (typical in `development`, usually not at `info` in production).
 
 ### Important
 

data/lib/passive_columns/loader.rb

@@ -20,16 +20,29 @@ module PassiveColumns
 
       model.send(column)
     rescue ActiveModel::MissingAttributeError
+      materialize_missing_column(column, force)
+    end
+
+    private
+
+    def materialize_missing_column(column, force)
       allowed_columns = (force ? [column] : passive_columns).map(&:to_s)
       raise if allowed_columns.exclude?(column.to_s) || identity_constraints.value?(nil)
 
+      log_lazy_sql_load(column)
       value = pick_value(column)
       model[column] = value
       model.send(:clear_attribute_change, column)
       model[column]
     end
 
-    private
+    def log_lazy_sql_load(column)
+      logger = model.logger
+      return unless logger&.debug?
+
+      ctx = identity_constraints.map { |k, v| "#{k}=#{v.inspect}" }.join(', ')
+      logger.debug("[passive_columns] On-demand SQL load of #{model.class.name}##{column} (#{ctx})")
+    end
 
     def pick_value(column)
       model.class.unscoped.where(identity_constraints).pick(column)

data/lib/passive_columns/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PassiveColumns
-  VERSION = '0.3.4'
+  VERSION = '0.3.5'
 end

data/lib/passive_columns.rb

@@ -33,11 +33,40 @@ require 'passive_columns/loader'
 #
 # The next time you call the passive column it won't hit the database as it is already loaded.
 #  page.huge_article # => 'Some huge article...'
+#
+# To load passive columns in the same query, use +with_passive_columns+ with no arguments (all passive columns)
+# or pass passive column names; any other names are ignored.
+#  Page.with_passive_columns.to_a
+#  Page.with_passive_columns(:huge_article).to_a
 module PassiveColumns
   extend ActiveSupport::Concern
 
   included do
     class_attribute :_passive_columns, default: []
+
+    # Eager-load passive columns in the main SELECT instead of omitting them.
+    # With no arguments, sets +select_values+ to all +column_names+ (including passive columns);
+    # Active Record turns that into the SELECT list.
+    # With arguments, only names listed in +passive_columns+ are merged into +select_values+ with
+    # the usual non-passive column list; other names are ignored. If none of the arguments are
+    # passive columns, the relation behaves like a normal query (passive columns still omitted).
+    #
+    # @param [Array<Symbol, String>] requested
+    # @return [ActiveRecord::Relation]
+    scope(:with_passive_columns, lambda do |*requested|
+      return self if klass._passive_columns.blank?
+
+      if requested.empty?
+        spawn.tap { |r| r.select_values = klass.column_names.dup }
+      else
+        passive_only = requested.map(&:to_s).uniq.select { |c| klass._passive_columns.include?(c) }
+        return self if passive_only.empty?
+
+        spawn.tap do |r|
+          r.select_values = klass.column_names - klass._passive_columns + passive_only
+        end
+      end
+    end)
   end
 
   class_methods do # rubocop:disable Metrics/BlockLength

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: passive_columns
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.3.5
 platform: ruby
 authors:
 - Dmitrii Golovin
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-02 00:00:00.000000000 Z
+date: 2026-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord