occams-record 1.7.0 → 1.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f2590ba264934763d86310d4cd9b92459cb053589afa23fb4ea4c4b423f2eb7
-  data.tar.gz: abb8aad716399e6b87d351e33a8f9ff629256964aed2f131795255cec3353b2a
+  metadata.gz: 0dc125a06b3fa732e1064483f13e5abbe2a7c64b4e6ac7f1b2d37337d8e233cb
+  data.tar.gz: 5c47a9a644b757463d5dd1961c1b86ed1de50cf247a286e8d1d0c3dd5daa99b8
 SHA512:
-  metadata.gz: 2aa46cce2b26cd5a6e0219651dcdace5391a7a1b67ae5d4e6c3a9a849c6b12a63a2c913208af0ae58d5e7c7ce6880fdc2c1081a3a4b7582b2a8300f76548c0e3
-  data.tar.gz: c3cdc38d42b7c97894bbe34215e9a8143209732c78fd8b5d8351932d5e7290783ec8239c8f5c21e6fa4f2f36325b97a76088953a9b0a28a7fd71c697aaa91993
+  metadata.gz: 7fb55ec18a98e4d2bb4b3fab8d3f609a378bee578d1b405d56a43b1f035f40d53149fc8dabc321bbaf17b180eb9e3b1dda282cc2fd8675a3e10c8bc59a9f7a59
+  data.tar.gz: f9f28ad1537cc297a0b5b1fe8a5209d4f4dfa4529148a603f715da884fa9d9f8188836aca84c8e5dcc36f674bb6abe7211de57c014e90a4539d892da0192c28d

data/README.md

@@ -11,120 +11,33 @@ OccamsRecord is a high-efficiency, advanced query library for use alongside Acti
 * 3x-5x faster than ActiveRecord queries, *minimum*.
 * Uses 1/3 the memory of ActiveRecord query results.
 * Eliminates the N+1 query problem. (This often exceeds the baseline 3x-5x gain.)
-* Support for cursors (Postgres only, new in v1.4.0)
 
 ### 2) Supercharged querying & eager loading
 
-Continue using ActiveRecord's query builder, but let Occams take over running them, eager loading, and raw SQL calls. None of the examples below are possible with ActiveRecord, but OccamsRecord makes them trivial. (More complete examples are shown later, but these should whet your appetite.)
-
-**Customize the SQL used to eager load associations**
-
-```ruby
-OccamsRecord
-  .query(User.active)
-  .eager_load(:orders) { |l|
-    l.scope { |q| q.where("created_at >= ?", date).order("created_at DESC") }
-  }
-```
-
-**Use `ORDER BY` with `find_each`/`find_in_batches`**
-
-```ruby
-OccamsRecord
-  .query(Order.order("created_at DESC"))
-  .find_each { |order|
-    ...
-  }
-```
-
-**Use cursors**
-
-```ruby
-OccamsRecord
-  .query(Order.order("created_at DESC"))
-  .find_each_with_cursor { |order|
-    ...
-  }
-```
-
-**Use `find_each`/`find_in_batches` with raw SQL**
-
-```ruby
-OccamsRecord
-  .sql("
-    SELECT * FROM orders
-    WHERE created_at >= %{date}
-    LIMIT %{batch_limit}
-    OFFSET %{batch_offset}",
-    {date: 10.years.ago}
-  )
-  .find_each { |order|
-    ...
-  }
-```
-
-**Eager load associations when you're writing raw SQL**
-
-```ruby
-OccamsRecord
-  .sql("
-    SELECT * FROM users
-    LEFT OUTER JOIN ...
-  ")
-  .model(User)
-  .eager_load(:orders)
-```
-
-**Use `pluck` with raw SQL**
-
-```ruby
-OccamsRecord
-  .sql("
-    SELECT some_col FROM users
-    INNER JOIN ...
-  ")
-  .pluck(:some_col)
-```
-
-**Eager load "ad hoc associations" using raw SQL**
-
-Relationships are complicated, and sometimes they can't be expressed in ActiveRecord models. Define your relationship on the fly!
-(Don't worry, there's a full explanation later on.)
-
-```ruby
-OccamsRecord
-  .query(User.all)
-  .eager_load_many(:orders, {:id => :user_id}, "
-    SELECT user_id, orders.*
-    FROM orders INNER JOIN ...
-    WHERE user_id IN (%{ids})
-  ")
-```
+* Customize the SQL used to eager load associations (order them, apply filters, etc)
+* Use cursors (Postgres only)
+* Use `ORDER BY` with `find_each`/`find_in_batches`
+* Use `find_each`/`find_in_batches` with raw SQL
+* Eager load associations off of raw SQL queries
+* Use `pluck` with raw SQL queries
 
+### How does OccamsRecord do all this?
 [Look over the speed and memory measurements yourself!](https://github.com/jhollinger/occams-record/wiki/Measurements) OccamsRecord achieves all of this by making some **very specific trade-offs:**
 
 * OccamsRecord results are *read-only*.
 * OccamsRecord results are *purely database rows* - they don't have any instance methods from your Rails models.
-* You *must eager load* each assocation you intend to use. If you forget one, an exception will be raised.
+* You *must eager load* each assocation you intend to use. If you try to use one you didn't eager load, an exception will be raised.
 
----
+# Overview
 
-# Installation
+Full documentation is available at [rubydoc.info/gems/occams-record](http://www.rubydoc.info/gems/occams-record). Code lives at at [github.com/jhollinger/occams-record](https://github.com/jhollinger/occams-record). Contributions welcome!
 
-Simply add it to your `Gemfile`:
+Simply add `occams-record` to your `Gemfile`:
 
 ```ruby
 gem 'occams-record'
 ```
 
----
-
-# Overview
-
-Full documentation is available at [rubydoc.info/gems/occams-record](http://www.rubydoc.info/gems/occams-record).
-
-Code lives at at [github.com/jhollinger/occams-record](https://github.com/jhollinger/occams-record). Contributions welcome!
-
 Build your queries like normal, using ActiveRecord's excellent query builder. Then pass them off to Occams Record.
 
 ```ruby

data/lib/occams-record/query.rb

@@ -96,6 +96,8 @@ module OccamsRecord
     #
     def run
       sql = block_given? ? yield(scope).to_sql : scope.to_sql
+      return [] if sql.blank? # return early in case ActiveRecord::QueryMethods#none was used
+
       @query_logger << "#{@eager_loaders.tracer}: #{sql}" if @query_logger
       result = if measure?
                  record_start_time!
@@ -237,6 +239,8 @@ module OccamsRecord
     #
     def pluck(*cols)
       sql = (block_given? ? yield(scope).to_sql : scope).select(*cols).to_sql
+      return [] if sql.blank? # return early in case ActiveRecord::QueryMethods#none was used
+
       @query_logger << "#{@eager_loaders.tracer}: #{sql}" if @query_logger
       result = if measure?
                  record_start_time!

data/lib/occams-record/version.rb

@@ -3,5 +3,5 @@
 #
 module OccamsRecord
   # @private
-  VERSION = "1.7.0".freeze
+  VERSION = "1.7.1".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: occams-record
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.7.1
 platform: ruby
 authors:
 - Jordan Hollinger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-03-28 00:00:00.000000000 Z
+date: 2023-05-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord