ree 1.3.4 → 1.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc1a6ceaa82a725d38d02a6c62ed8f9db63b5af83e899442981c52edd3736ddc
-  data.tar.gz: 85cdd65fc59888a77116379b51ae093cd53462d10567fec028bef06ff5673085
+  metadata.gz: 452953a21318a446a47364d8bc043f9fdbc2d8bfd85731714f6b10eeb1f553da
+  data.tar.gz: 3326d95a0384bed8a496de402d0ef7e2f126546976e7cc321dc2bb8b7bd0ffb4
 SHA512:
-  metadata.gz: cd5e95f265f16c743c3b57115b15fb5e2054e09715cf8532ec82607e23c67bdc6495db827cc3f9192d47d3f524719b311bad17f3d7a28b8923d131a1e119a86d
-  data.tar.gz: 16896abb9ded31351b057c6a992d380ba2611ac7cd9db90779d806106b8a381f1cf4a1e6762df19c7ba40073771a8f06f1d2699af8b0dc26c16e71d2b56de4d6
+  metadata.gz: 6350771b8847969833e106028195c609130b3476ccd9ab84701a84fb27401737ae57e1aee130d0c05ef04f3caf1cc34371f70b05220d5878c009b8760b907c07
+  data.tar.gz: 6e8c7039300062b1f470fc5d6f7d026f2bc6a66302109364ec6185915659371e661b02e05d45418191bd2d51402f57f5df9d219d48093b6d8eb20f9185ff8fdc

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ree (1.3.4)
+    ree (1.3.5)
       base64
       commander
       logger

data/README.md

@@ -449,6 +449,28 @@ end
 ### Disabling contracts
 If you want to disable contracts, set the `NO_CONTRACTS` environment variable. This will disable contracts and you won't have a performance hit.
 
+### DB load performance mode
+Read models that load many rows pay for casting every column through the
+mapper even though the DB driver already returns correctly typed values.
+Enable the mode in `ree.setup.rb` (before any DAO or mapper is loaded):
+
+```ruby
+if ENV['RUBY_ENV'] == 'production'
+  Ree.enable_db_load_performance_mode
+end
+```
+
+Mappers built while the mode is on compile a specialized `db_load` method:
+primitive fields (`integer`, `string`, `bool`, `float`, `date`, `time`,
+`date_time`, `rational`, `any`) skip casting behind a single type-guard
+check, and dto construction avoids intermediate allocations. Values that
+fail the guard (e.g. a date stored as a string inside `pg_jsonb`, or a
+`BigDecimal` from a `numeric` column mapped to `float`) are cast exactly as
+before, so results and errors are identical to the normal mode. Custom
+types, enums, `pg_array`/`pg_jsonb` and nested mappers are always cast.
+Calls with `role:`/`only:`/`except:` fall back to the generic
+implementation. Running production under YJIT compounds the gain.
+
 ## Ree Schemas
 Coming soon...
 

data/lib/ree/templates/init/ree.setup.rb

@@ -8,4 +8,7 @@ end
 if ENV['RUBY_ENV'] == 'production'
   # Define preload context for registered objects
   Ree.preload_for(:production)
+
+  # Skip db casting for values already typecast by the DB driver
+  # Ree.enable_db_load_performance_mode
 end

data/lib/ree/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ree
-  VERSION = "1.3.4"
+  VERSION = "1.3.5"
 end

data/lib/ree.rb

@@ -148,6 +148,23 @@ module Ree
       !!@hide_internal_swagger_endpoints
     end
 
+    # Mappers built while this mode is on compile a specialized :db_load
+    # method that trusts DB values already typecast by the driver: primitive
+    # fields skip casting behind a cheap type guard, and dto construction
+    # avoids intermediate allocations. Read at mapper build time, so enable
+    # it in ree.setup.rb before any DAO/mapper is loaded.
+    def enable_db_load_performance_mode
+      @db_load_performance_mode = true
+    end
+
+    def disable_db_load_performance_mode
+      @db_load_performance_mode = false
+    end
+
+    def db_load_performance_mode?
+      !!@db_load_performance_mode
+    end
+
     def obfuscated?
       ENV.has_key?('REE_LICENSE_KEY')
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ree
 version: !ruby/object:Gem::Version
-  version: 1.3.4
+  version: 1.3.5
 platform: ruby
 authors:
 - Ruslan Gatiyatov