better_pluck 0.9.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf2465548537590cdc1ea74f2addd0b7cf1d5503ea1456cc5cd647a8b42f2cda
-  data.tar.gz: 82f00ef52e2042cb6fa91de2af7334321702759247f2ac37d772190d67ae3cba
+  metadata.gz: 64a910349a333fa7833d93fc87015f91b11344588c3b6fc3c2635b89d9a85960
+  data.tar.gz: 3b88f50b8e75d588849954b9d27dd46f006cdb94ee70890e4f5ed87a69f14a5d
 SHA512:
-  metadata.gz: adea8a324626ea010c04bac42e0b9783ddacbe57b133078a5b05cab94735e6693c591e4c54405242ac73f18c7cb188bb83e2953dcaf9ec64591208138d8cb3ea
-  data.tar.gz: 1b14db90fc98cfbd4f35df2b96842b10c5665634aa54906521c050b87f82abf08fe7663a4e100db0e20fb4b91964da986096cbdfba05c2bdbf928210dfdd694c
+  metadata.gz: 49329adec0a9d95bac2c321fb4dbe30b68c8c194c7bc57d4102e8ce177216ca2c9482dda07698ab90f04c5172483e8588fc81fdb13bc8d08a5b680500e67a2bb
+  data.tar.gz: 725142f9eaab1335c370d8da493463df52b473e155ef25c1428314b034e3b3126e39338b274d23e558b529f1ec745413179a3e9e19daf5c7de0eeb67ab59b318

data/README.md

@@ -1,6 +1,9 @@
-# BetterPluck
+# better_pluck
 
-`BetterPluck` adds `pluck_with_methods` and `pluck_with_display_name` to ActiveRecord. These methods allow you to pluck not only database columns but also virtual methods and association data, returning lightweight `Struct` objects instead of heavy ActiveRecord instances.
+
+Main purpose is to reduce loading into memory expensive ActiveRecord objects, where it is not needed (for read-only operations).
+
+`better_pluck` adds `pluck_with_methods`, `pluck_with_display_name` to ActiveRecord. These methods allow you to pluck not only database columns but also virtual methods and association data, returning lightweight `Struct` objects instead of heavy ActiveRecord instances.
 
 This approach can reduce memory usage by up to 3-20x compared to loading full ActiveRecord objects.
 
@@ -67,8 +70,20 @@ articles.first.author.display_name # => "Author Name <author@example.com>"
 4.  **Struct Generation**: It creates a `Struct` class (cached for performance) and injects the source code of requested instance methods into it.
 5.  **Instantiation**: It maps the raw data into these `Struct` objects.
 
-## Requirements
 
-*   ActiveRecord >= 6.0
-*   method_source
-*   concurrent-ruby
+### select_with_joins method
+
+You can use the `select_with_joins` method which will create field aliases for associations instead of fully fetching activerecord objects for them. The main model can be selected with specific columns or fully fetched.
+
+```ruby
+# Example with positional arguments for base model
+users = User.select_with_joins(:id, :name, organization: :name)
+# SELECT users.id, users.name, organizations.name AS organization_name FROM users LEFT JOIN organizations ...
+users.first.name              # => "John"
+users.first.organization_name # => "Acme Corp"
+
+# Example fetching all base model columns
+articles = Article.select_with_joins(author: [:name])
+# SELECT articles.*, authors.name AS author_name FROM articles LEFT JOIN authors ...
+articles.first.author_name  # => "John Doe"
+```

data/lib/better_pluck/select_with_joins.rb

@@ -0,0 +1,50 @@
+module BetterPluck::SelectWithJoins
+  extend ActiveSupport::Concern
+
+  class_methods do
+    # extended select, allowing to write custom select queries in short format
+    # Article.select_with_joins(:id, :name, author: :name).first.author_name
+    def select_with_joins(*args)
+      fields_data = args.extract_options!
+      base_columns = args
+
+      base_key = self.table_name.singularize.to_sym
+
+      # Default to base_table.* if no base columns specified anywhere
+      if base_columns.empty? && !fields_data.key?(base_key)
+        base_columns = ["*"]
+      end
+
+      select_clause = []
+
+      # Handle base columns (no alias)
+      base_columns.each do |col|
+        if col.to_s == "*"
+          select_clause << "#{self.table_name}.*"
+        else
+          select_clause << "#{self.table_name}.#{col}"
+        end
+      end
+
+      # Handle hash columns (with alias)
+      fields_data.each do |table, cols|
+        is_base_table = (table.to_s == self.table_name.singularize)
+        table_name = is_base_table ? self.table_name : table.to_s.pluralize
+
+        if cols.to_s == "*"
+          select_clause << "#{table_name}.*"
+        else
+          Array(cols).each do |col|
+            select_clause << "#{table_name}.#{col} AS #{table}_#{col}"
+          end
+        end
+      end
+
+      # 2. Identify tables that need joining
+      joins_to_make = fields_data.keys.reject { |k| k.to_sym == base_key }
+
+      # 3. Apply left_joins and select
+      left_joins(joins_to_make).select(select_clause)
+    end
+  end
+end

data/lib/better_pluck/version.rb

@@ -1,3 +1,3 @@
 module BetterPluck
-  VERSION = "0.9.0"
+  VERSION = "1.0.0"
 end

data/lib/better_pluck.rb

@@ -1,11 +1,11 @@
 require "better_pluck/version"
 require "better_pluck/pluck_with_methods"
-require "better_pluck/select_only"
+require "better_pluck/select_with_joins"
 
 module BetterPluck
 end
 
 ActiveSupport.on_load(:active_record) do
   include BetterPluck::PluckWithMethods
-  include BetterPluck::SelectOnly
+  include BetterPluck::SelectWithJoins
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: better_pluck
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 1.0.0
 platform: ruby
 authors:
 - NazarK
@@ -118,7 +118,7 @@ files:
 - better_pluck.gemspec
 - lib/better_pluck.rb
 - lib/better_pluck/pluck_with_methods.rb
-- lib/better_pluck/select_only.rb
+- lib/better_pluck/select_with_joins.rb
 - lib/better_pluck/version.rb
 homepage: https://github.com/NazarK/better_pluck
 licenses:

data/lib/better_pluck/select_only.rb

@@ -1,30 +0,0 @@
-module BetterPluck::SelectOnly
-  extend ActiveSupport::Concern
-
-  class_methods do
-    #extended select, allowing to write custom select queries in short format
-    #Article.select_only(author: [:id, :name]).first.author_name
-    def select_only(fields_data = {})
-      # Ensure the base model is included in fields_data if missing
-      base_key = self.table_name.singularize.to_sym
-      fields_data[base_key] = "*" unless fields_data.key?(base_key)
-
-      # 1. Build the select clause
-      select_clause = fields_data.map do |table, cols|
-        table_name = (table.to_s == self.table_name.singularize) ? self.table_name : table.to_s.pluralize
-
-        if cols == "*"
-          "#{table_name}.*"
-        else
-          Array(cols).map { |col| "#{table_name}.#{col} AS #{table}_#{col}" }
-        end
-      end.flatten
-
-      # 2. Identify tables that need joining
-      joins_to_make = fields_data.keys.reject { |k| k.to_sym == base_key }
-
-      # 3. Apply left_joins and select
-      left_joins(joins_to_make).select(select_clause)
-    end
-  end
-end