activerecord-minimizer 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd5b6b67995d6c1cbf665637d1c06d7bba3a481906a2dfab3478c1f7e9e303b0
-  data.tar.gz: f9a99422b743b0942a7e07d8de0fb43273f4ec2fdc9e9f1e34c0021e196a6aee
+  metadata.gz: 7993bf021f8de2ed44f37b3dd541d6644b1fd1d38817acaecf424852713acb2a
+  data.tar.gz: 0c520dcb7ca0543b4ac891ea9abced9968d0fec36edd258c9a47dc7ea33f962d
 SHA512:
-  metadata.gz: 1bc117e578665279e838e5ce2ea05d915c271a435224b21824e4ce51af8ac01a53248c2c7c3532f9fca3c46c2927927ff81d5b65a1db5dc93aa4dd267836fbb2
-  data.tar.gz: 8895e58f378594e9b92df76e98c72d6d377f6b6c2e1f9a77441677efc1ecdef23a15d2640cac6584940c0d7c5128ac8f563d225bbd471d5d1e5f8d58aa6652c2
+  metadata.gz: faa673f2b296a034bbca5c927642dcde2f3f38c6e689b825c8f6884fbe0810a7ec0514f3669a685fa6f81487b578d4a41345f38de5ca3f327851c0d195abd1c2
+  data.tar.gz: '09b436a70b52965449931ebc407b9396ca7068233644025de33516f56148f0c31507cd5f265a4a3884cec901482fe9c1dc3ee02e9b42e28accd41f077b332d73'

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.0 (2026-10-20)
+
+- With `load_time`, the manifest's index (10-20 MB on a large app) is let go once an eager-loading boot is done, before a preloading server forks; a file loaded later indexes the manifest again.
+- README: strict mode and enums are the core; compiling call sites (`load_time`, `views`, `ar_minimizer:build`, `guards`) and small records are experimental, with the production results. The manifest is only needed by the experimental parts.
+
 ## 0.1.3 (2026-10-18)
 
 - `ar_minimizer:manifest` stops, saying why, when no model's table exists (a database not set up yet), instead of writing a manifest that describes no models.

data/README.md

@@ -4,8 +4,7 @@ Active Record generates a reader, a writer and one method per attribute
 method pattern for every column of every model: `name?`, `name_changed?`,
 `name_was`, `saved_change_to_name?`, `name_before_type_cast`,
 `restore_name!`, ... 21 patterns in Rails 8.1, so 21 methods per column.
-activerecord-minimizer generates the readers and writers only, and compiles
-the call sites that used the rest into the calls they stood for. Part of
+activerecord-minimizer generates the readers and writers only. Part of
 [rails-minify](../rails-minify).
 
 ```ruby
@@ -57,7 +56,21 @@ first call to one generates it on that model.
 Turn `slim` on in development and tests as well as production: the
 errors then show up while you work and in CI. Slim follows code reloads.
 
-## Compiling call sites
+## Enums
+
+`config.ar_minimizer.enums = true` replaces the closures Rails defines for
+enum predicates and bang methods, which build and intern the
+`<name>_for_database` symbol on every call, with ordinary methods carrying
+the enum's values: `def published? = public_send(:status_for_database) == 1`.
+1.3–1.6× faster predicates; non-finite float values keep Rails' closures.
+
+## Experimental
+
+Each is off unless set. They are faster per call in benchmarks, but made no
+measurable difference on a production app (see [Numbers](#numbers)), and the
+compiling parts cost memory in every worker.
+
+### Compiling call sites
 
 Calls whose receiver is known to be a record of a model with that column are
 compiled to what the generated method would have done:
@@ -92,7 +105,7 @@ Where it compiles:
   `app/` and `lib/` in place instead, like explode_sqlite. Production only (or
   `FORCE=1`); `DRY_RUN=1` previews.
 
-All three read the **manifest**, `config/ar_minimizer.json`, written by
+All three read the **manifest** (strict mode and enums don't need one), `config/ar_minimizer.json`, written by
 `bin/rails ar_minimizer:manifest`: per model its columns and their query kind,
 the attribute method patterns, hand-written methods, superclass, app modules,
 associations, scopes, and names it defines another way (an enum predicate
@@ -103,19 +116,14 @@ stale, and an eager-loading boot logs an error if it is.
 Never compiled: methods any model defines by hand, names used as columns,
 primary key methods, `defined?(...)`, calls with blocks, heredoc arguments.
 
-## More
+### More
 
-* **Enums** (`config.ar_minimizer.enums = true`) replaces the closures Rails
-  defines for enum predicates and bang methods, which build and intern the
-  `<name>_for_database` symbol on every call, with ordinary methods carrying
-  the enum's values: `def published? = public_send(:status_for_database) == 1`.
-  1.3–1.6× faster predicates; non-finite float values keep Rails' closures.
 * **Small records** (`config.ar_minimizer.small_records = true`). A loaded
   record owns two Hashes most records never put anything in, 160 bytes each:
   the association cache and the attribute set's Attribute objects. Both start
   as one shared frozen empty Hash and get their own on the first insert. A
   read-only record goes from 1,480 to 1,160 bytes (23 columns), at the same
-  speed. Destroyed and frozen records still raise on writes.
+  speed. Only worth it on pages that load thousands of records. Destroyed and frozen records still raise on writes.
 * **Census** (`ArMinimizer::Census`, run by rails-minify's
   `bin/rails minify:census`): how many call sites compile, and why the others
   don't.
@@ -140,6 +148,17 @@ On [Japan Voyage](https://japanvoyage.jp) (191 models, 2009 columns):
 * Test suite (4317 runs) in strict mode, after rubocop-minify's rewrites and
   with a 41-line keep list: the same results as the untouched app.
 
+In production there (Falcon, 6 workers, half the workers with a part and half
+without, the same traffic for an hour, October 2026):
+
+| part | result |
+|---|---|
+| strict mode | no call to a removed method; the same latency and memory |
+| enums | the same median latency; no change in allocations on these pages |
+| small records | no difference: tens of records per request |
+| compiling in views | no faster, ~22 MB more per worker |
+| compiling at load time | ~12% more CPU per request, not reproduced locally; measured before the app was preloaded, so worth measuring again |
+
 ## Requirements and caveats
 
 * Ruby 3.4+, Rails 8.0, 8.1 and main (`rake test:rails`).

data/lib/ar_minimizer/loader.rb

@@ -15,7 +15,7 @@ module ArMinimizer
       # version: changes when the index does (Manifest.digest of the file).
       def install!(index:, patterns:, exclude_patterns: nil, version: nil, guards: false)
         require "require-hooks/setup"
-        @index = index
+        @index = @index_source = index
         @guards = guards
         @mutex = Mutex.new
         if defined?(RequireHooks::Bootsnap) && RequireHooks::Bootsnap.respond_to?(:add_version_hash)
@@ -33,6 +33,13 @@ module ArMinimizer
         @index
       end
 
+      # Lets go of the index (10-20 MB on a large app) once app/ and lib/ are
+      # loaded, before a preloading server forks: a file loaded later indexes
+      # the manifest again.
+      def release_index!
+        @mutex.synchronize { @index = @index_source } if @index_source.respond_to?(:call)
+      end
+
       # nil leaves the file as it is.
       def transform(path, source)
         result = Rewriter.new(index: index, path: path, marker: false, guards: @guards).rewrite(source || File.read(path))

data/lib/ar_minimizer/railtie.rb

@@ -44,6 +44,7 @@ module ArMinimizer
         # File.fnmatch? without FNM_PATHNAME: `*` crosses directories.
         ArMinimizer::Loader.install!(index: manifest, patterns: roots.map { "#{it}/*.rb" }, guards: !!options.guards,
           version: ArMinimizer::Manifest.digest(manifest_json))
+        app.config.after_initialize { ArMinimizer::Loader.release_index! if app.config.eager_load }
       end
 
       # Every model is loaded after eager loading: say so if the manifest no

data/lib/ar_minimizer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ArMinimizer
-  VERSION = "0.1.3"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activerecord-minimizer
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Sampo Kuokkanen