thermos 1.0.2 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83926b2fe8fb25c3e0f04afca0109f2d5da8fe5e36aee84fd642ff4fd9b134f0
-  data.tar.gz: eb6120db89d227f077dace4ca1b6e33095e26c44df470252f36aebab2693d6da
+  metadata.gz: 96c092c9b446b9147dca86d7f6b655dcb8f6f00191a8260b0dbb6bd15bea56c1
+  data.tar.gz: e7b19005dffe9c4fbec290576e0d9094fb1d04021fd037e3148dc7bb57d99179
 SHA512:
-  metadata.gz: 267d7aef1db1d00ed4d92bc82a5351cfca86391f4d01d5a223ab475650ef93a35dde0615063e05e8e7c80cb6ed56841a90c4c5580e4cb96824daa08301da6754
-  data.tar.gz: 6c611264f064b6cde6bc963a1157a4545e9bcd15cfe3f4787451afcf8fb8efe53bf93240f0df473cf3e0a121f81ad3d581764ac5f72c10125ed2f60e7fab8ff5
+  metadata.gz: 5484c23bf0c7ff96d75158c37bc399cf06a45a25447347c2a56ffc0bc8d026742042655019dbfb3518fbb3ea9765431963db334973692e3ad4f9cf272c78710e
+  data.tar.gz: 39f11866f8de933f2e6f68174f43d4c4b88fc48b25c472bee5799447cdcc6d91c568eb31173bf004a41cccf0d0b882cd0368d299287b6487d2c6f7d99bccac8c

data/README.md

@@ -0,0 +1,213 @@
+# Thermos
+
+**Always-warm Rails caching that automatically rebuilds when your models change.**
+
+[![Gem Version](https://badge.fury.io/rb/thermos.svg)](https://badge.fury.io/rb/thermos)
+[![Code Climate](https://codeclimate.com/github/athal7/thermos/badges/gpa.svg)](https://codeclimate.com/github/athal7/thermos)
+![Build Status](https://img.shields.io/github/actions/workflow/status/athal7/thermos/CI.yml?branch=main)
+
+Thermos is a Rails caching library that keeps your cache always warm by rebuilding it in the background whenever ActiveRecord models change. No more stale data, no more cold cache penalties, no more `touch: true` on all your associations.
+
+## Features
+
+- **Always-warm cache** — Cache is rebuilt in the background when models change
+- **No stale data** — Unlike TTL-based caching, data is only as stale as your job queue latency
+- **No cold cache penalties** — Cache is pre-warmed, so users never wait for expensive queries
+- **No `touch` callbacks needed** — Thermos watches model dependencies automatically
+- **Works with any backend** — Sidekiq, Solid Queue, Resque, or any ActiveJob adapter
+- **Works with any cache store** — Redis, Memcached, Solid Cache, or any Rails cache store
+- **ETag support** — Works seamlessly with HTTP caching for browser and CDN caching
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'thermos'
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+## Quick Start
+
+```ruby
+# In a controller - cache is automatically rebuilt when Category or its products change
+json = Thermos.keep_warm(key: "category", model: Category, id: params[:id], deps: [:products]) do |id|
+  Category.includes(:products).find(id).to_json
+end
+
+render json: json
+```
+
+That's it! When any `Category` or associated `Product` is created, updated, or destroyed, Thermos automatically rebuilds the cache in the background.
+
+## Why Thermos?
+
+Most cache strategies have significant downsides:
+
+| Strategy | Problem |
+|----------|---------|
+| **TTL-based** (expires_in) | Stale data until expiration |
+| **Key-based** (cache_key) | Cold cache on first request after any change |
+| **Touch callbacks** | Extra database writes on every association change |
+
+Thermos solves all of these by rebuilding caches proactively in background jobs.
+
+> "I just want to Thermos everything now!! Unbelievable improvement. It's like every dev's dream come true" — [@jono-booth](https://github.com/jono-booth)
+
+## Prerequisites
+
+Configure a [Rails Cache Store](https://guides.rubyonrails.org/caching_with_rails.html#configuration) that supports shared access across processes (Redis, Memcached, Solid Cache — not MemoryStore).
+
+Thermos works with any ActiveJob adapter, including Rails 8's [Solid Queue](https://github.com/rails/solid_queue) and [Solid Cache](https://github.com/rails/solid_cache).
+
+## Usage
+
+### keep_warm (Simple)
+
+With `keep_warm`, the cached content is defined along with the cache block and dependencies definition. This is the simplest implementation, *but is only compatible with the [Active Job Inline Adapter](https://api.rubyonrails.org/classes/ActiveJob/QueueAdapters/InlineAdapter.html)*. See the next section about fill/drink for compatibility with other Active Job Adapters.
+
+*API Controller*
+
+```ruby
+json = Thermos.keep_warm(key: "api_categories_show", model: Category, id: params[:id], deps: [:category_items, :products]) do |id|
+  Category.find(id).to_json
+end
+
+render json: json
+```
+
+*Frontend Controller*
+
+```ruby
+rendered_template = Thermos.keep_warm(key: "frontend_categories_show", model: Category, id: params[:id], deps: [:category_items, :products]) do |id|
+  @category = Category.includes(category_items: :product).find(id)
+  render_to_string :show
+end
+
+render rendered_template
+```
+
+### fill / drink (Advanced)
+
+For more control, define your cache once with `fill` and read it anywhere with `drink`. This is ideal for sharing cached data across multiple controllers or when using background job adapters other than inline.
+
+*Rails Initializer*
+
+```ruby
+Thermos.fill(key: "api_categories_show", model: Category, deps: [:category_items, :products]) do |id|
+  Category.find(id).to_json
+end
+```
+
+*API Controller*
+
+```ruby
+json = Thermos.drink(key: "api_categories_show", id: params[:id])
+render json: json
+```
+
+## Options
+
+### lookup_key
+
+If you want to be able to lookup by a key other than `id` (e.g. you use a slug in the params), you can specify the `lookup_key` as an argument to `keep_warm` or `fill`:
+
+```ruby
+Thermos.keep_warm(key: "api_categories_show", model: Category, id: params[:slug], lookup_key: :slug) do |slug|
+  Category.find_by(slug: slug).to_json
+end
+```
+
+or
+
+```ruby
+Thermos.fill(key: "api_categories_show", model: Category, lookup_key: :slug) do |slug|
+  Category.find_by(slug: slug).to_json
+end
+```
+
+### queue
+
+If you want to specify a queue for the refill jobs to run other than the default queue, you can provide it to either way of using Thermos:
+
+```ruby
+Thermos.keep_warm(key: "api_categories_show", model: Category, queue: "low_priority") do |id|
+  Category.find(id).to_json
+end
+```
+
+or
+
+```ruby
+Thermos.fill(key: "api_categories_show", model: Category, queue: "low_priority") do |id|
+  Category.find(id).to_json
+end
+
+Thermos.drink(key: "api_categories_show", id: params[:slug])
+```
+
+### Indirect Relationships
+
+You can specify indirect relationships as dependencies as well. For example, if `Store has_many categories`, and `Category has_many products`, but there is no relationship specified on the `Store` model to `Product`:
+
+```ruby
+Thermos.keep_warm(key: "api_stores_show", model: Store, id: params[:id], deps: [categories: [:products]]) do |id|
+  Store.find(id).to_json
+end
+```
+
+*NOTE* in this example, a change to any model in the association chain will trigger a refill of the cache.
+
+### filter
+
+You can provide a filter to restrict whether a record gets rebuilt on model changes:
+
+```ruby
+filter = ->(model) { model.name.match("ball") }
+Thermos.keep_warm(key: "api_categories_show", model: Category, id: params[:id], filter: filter) do |id|
+  Category.find(id).to_json
+end
+```
+
+## Using with ETags
+
+Thermos works seamlessly with Rails' HTTP caching via ETags, enabling browser and CDN caching of your responses. Since Thermos keeps your cache always warm and rebuilds it when models change, the cached value's digest will naturally change when the underlying data changes.
+
+Use Rails' `stale?` helper with the cached value to enable conditional GET requests:
+
+```ruby
+def show
+  json = Thermos.drink(key: "api_categories_show", id: params[:id])
+
+  if stale?(etag: json)
+    render json: json
+  end
+end
+```
+
+When the cached value changes (triggered by model updates), the ETag will change, and clients will receive the new content. When the value hasn't changed, clients with a matching ETag will receive a `304 Not Modified` response.
+
+This enables caching at multiple layers:
+- **Browser cache**: Browsers store responses and revalidate with the server using the ETag, avoiding re-downloads of unchanged content
+- **CDN cache**: CDNs can cache responses and serve them directly to users, only revalidating with your server when needed
+
+Combined with Thermos, you get:
+- **Always-warm application cache** (no cold cache penalties)
+- **Reduced server load** (304 responses skip rendering)
+- **Reduced bandwidth** (browsers and CDNs serve cached content)
+- **Faster responses** (CDN edge locations serve content closer to users)
+
+## Contributors
+
+<a href="https://github.com/athal7/thermos/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=athal7/thermos" />
+</a>
+
+## License
+
+This project uses MIT-LICENSE.

data/lib/thermos/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Thermos
-  VERSION = "1.0.2"
+  VERSION = "2.0.1"
 end

data/test/dependencies_test.rb

@@ -1,6 +1,6 @@
 require "test_helper"
 
-class DependenciesTest < ActiveSupport::TestCase
+class DependenciesTest < ActiveJob::TestCase
   self.use_transactional_tests = true
   teardown :clear_cache
 
@@ -18,7 +18,7 @@ class DependenciesTest < ActiveSupport::TestCase
     mock.verify
 
     mock.expect(:call, 2, [category.id])
-    category_item.update!(name: "foo")
+    perform_enqueued_jobs { category_item.update!(name: "foo") }
     mock.verify
 
     mock.expect(:call, 3, [category.id])
@@ -40,7 +40,7 @@ class DependenciesTest < ActiveSupport::TestCase
     mock.verify
 
     mock.expect(:call, 2, [category.id])
-    category_item.update!(name: "foo")
+    perform_enqueued_jobs { category_item.update!(name: "foo") }
     assert_raises(MockExpectationError) { mock.verify }
 
     mock.expect(:call, 3, [category.id])
@@ -57,7 +57,7 @@ class DependenciesTest < ActiveSupport::TestCase
     end
 
     mock.expect(:call, 1, [category.id])
-    CategoryItem.create!(category: category)
+    perform_enqueued_jobs { CategoryItem.create!(category: category) }
     mock.verify
 
     mock.expect(:call, 2, [category.id])
@@ -78,13 +78,13 @@ class DependenciesTest < ActiveSupport::TestCase
     ) { |id| mock.call(id) }
 
     mock.expect(:call, 1, [category.id])
-    CategoryItem.create!(category: category)
+    perform_enqueued_jobs { CategoryItem.create!(category: category) }
     mock.verify
 
-    category.update!(name: "hockey")
+    perform_enqueued_jobs { category.update!(name: "hockey") }
 
     mock.expect(:call, 1, [category.id])
-    CategoryItem.create!(category: category)
+    perform_enqueued_jobs { CategoryItem.create!(category: category) }
     assert_raises(MockExpectationError) { mock.verify }
   end
 
@@ -102,7 +102,7 @@ class DependenciesTest < ActiveSupport::TestCase
     mock.verify
 
     mock.expect(:call, 2, [category.id])
-    store.update!(name: "foo")
+    perform_enqueued_jobs { store.update!(name: "foo") }
     mock.verify
 
     mock.expect(:call, 3, [category.id])
@@ -142,7 +142,7 @@ class DependenciesTest < ActiveSupport::TestCase
 
     mock.expect(:call, 1, [category.id])
     mock.expect(:call, 1, [category.id])
-    Store.create!(name: "foo", categories: [category])
+    perform_enqueued_jobs { Store.create!(name: "foo", categories: [category]) }
     mock.verify
 
     mock.expect(:call, 2, [category.id])
@@ -164,13 +164,13 @@ class DependenciesTest < ActiveSupport::TestCase
 
     mock.expect(:call, 1, [category.id])
     mock.expect(:call, 1, [category.id])
-    Store.create!(name: "foo", categories: [category])
+    perform_enqueued_jobs { Store.create!(name: "foo", categories: [category]) }
     mock.verify
 
     category.update!(name: "hockey")
 
     mock.expect(:call, 2, [category.id])
-    Store.create!(name: "bar", categories: [category])
+    perform_enqueued_jobs { Store.create!(name: "bar", categories: [category]) }
     assert_raises(MockExpectationError) { mock.verify }
   end
 
@@ -188,7 +188,7 @@ class DependenciesTest < ActiveSupport::TestCase
     mock.verify
 
     mock.expect(:call, 2, [category.id])
-    product.update!(name: "foo")
+    perform_enqueued_jobs { product.update!(name: "foo") }
     mock.verify
 
     mock.expect(:call, 3, [category.id])
@@ -210,7 +210,7 @@ class DependenciesTest < ActiveSupport::TestCase
     mock.verify
 
     mock.expect(:call, 2, [category.id])
-    product.update!(name: "foo")
+    perform_enqueued_jobs { product.update!(name: "foo") }
     assert_raises(MockExpectationError) { mock.verify }
 
     mock.expect(:call, 3, [category.id])
@@ -227,7 +227,7 @@ class DependenciesTest < ActiveSupport::TestCase
     end
 
     mock.expect(:call, 1, [category.id])
-    Product.create!(categories: [category])
+    perform_enqueued_jobs { Product.create!(categories: [category]) }
     mock.verify
 
     mock.expect(:call, 2, [category.id])
@@ -248,13 +248,13 @@ class DependenciesTest < ActiveSupport::TestCase
     ) { |id| mock.call(id) }
 
     mock.expect(:call, 1, [category.id])
-    Product.create!(categories: [category])
+    perform_enqueued_jobs { Product.create!(categories: [category]) }
     mock.verify
 
     category.update!(name: "hockey")
 
     mock.expect(:call, 2, [category.id])
-    Product.create!(categories: [category])
+    perform_enqueued_jobs { Product.create!(categories: [category]) }
     assert_raises(MockExpectationError) { mock.verify }
   end
 
@@ -270,13 +270,13 @@ class DependenciesTest < ActiveSupport::TestCase
     ) { |id| mock.call(id) }
 
     mock.expect(:call, 1, [store.id])
-    category.update!(name: "foo")
+    perform_enqueued_jobs { category.update!(name: "foo") }
     mock.verify
 
     mock.expect(:call, 2, [store.id])
     assert_equal 1, Thermos.drink(key: "key", id: store.id)
     assert_raises(MockExpectationError) { mock.verify }
-    Product.create!(categories: [category])
+    perform_enqueued_jobs { Product.create!(categories: [category]) }
     mock.verify
 
     mock.expect(:call, 3, [store.id])
@@ -300,7 +300,7 @@ class DependenciesTest < ActiveSupport::TestCase
 
     category_mock.expect(:call, 2, [category.id])
     product_mock.expect(:call, 2, [product.id])
-    product.update!(name: "foo")
+    perform_enqueued_jobs { product.update!(name: "foo") }
     assert_raises(MockExpectationError) { category_mock.verify }
     product_mock.verify
   end

data/test/dummy/app/models/category.rb

@@ -1,7 +1,7 @@
 class Category < ActiveRecord::Base
   has_many :category_items
   has_many :products, through: :category_items
-  belongs_to :store
+  belongs_to :store, optional: true
 
   def ball?
     name.match("ball")

data/test/dummy/app/models/category_item.rb

@@ -1,4 +1,4 @@
 class CategoryItem < ActiveRecord::Base
-  belongs_to :category
-  belongs_to :product
+  belongs_to :category, optional: true
+  belongs_to :product, optional: true
 end

data/test/dummy/config/application.rb

@@ -1,20 +1,33 @@
 require File.expand_path("../boot", __FILE__)
 
-require "rails/all"
+require "rails"
+require "active_model/railtie"
+require "active_job/railtie"
+require "active_record/railtie"
+require "action_controller/railtie"
+require "action_mailer/railtie"
+require "action_view/railtie"
+# require "active_storage/engine"
+# require "action_mailbox/engine"
+# require "action_text/engine"
+require "rails/test_unit/railtie"
 
 Bundler.require(*Rails.groups)
 require "thermos"
 
 module Dummy
   class Application < Rails::Application
+    # Initialize configuration defaults for originally generated Rails version.
+    config.load_defaults Rails::VERSION::STRING.to_f
+
     # Settings in config/environments/* take precedence over those specified here.
     # Application configuration should go into files in config/initializers
     # -- all .rb files in that directory are automatically loaded.
-    # Set Time.zone default to the specified zone and make Active Record auto-convert to this zone.
-    # Run "rake -D time" for a list of tasks for finding time zone names. Default is UTC.
-    # config.time_zone = 'Central Time (US & Canada)'
-    # The default locale is :en and all translations from config/locales/*.rb,yml are auto loaded.
-    # config.i18n.load_path += Dir[Rails.root.join('my', 'locales', '*.{rb,yml}').to_s]
-    # config.i18n.default_locale = :de
+
+    # Don't generate system test files.
+    config.generators.system_tests = nil
+
+    # Use a real queuing backend for Active Job (and separate queues per environment).
+    config.active_job.queue_adapter = :test
   end
 end

data/test/dummy/config/environments/development.rb

@@ -1,17 +1,23 @@
 Rails.application.configure do
   # Settings specified here will take precedence over those in config/application.rb.
 
-  # In the development environment your application's code is reloaded on
-  # every request. This slows down response time but is perfect for development
+  # In the development environment your application's code is reloaded any time
+  # it changes. This slows down response time but is perfect for development
   # since you don't have to restart the web server when you make code changes.
-  config.cache_classes = false
+  config.enable_reloading = true
 
   # Do not eager load code on boot.
   config.eager_load = false
 
-  # Show full error reports and disable caching.
+  # Show full error reports.
   config.consider_all_requests_local = true
+
+  # Enable server timing.
+  config.server_timing = true
+
+  # Enable/disable caching. By default caching is disabled.
   config.action_controller.perform_caching = false
+  config.cache_store = :memory_store
 
   # Don't care if the mailer can't send.
   config.action_mailer.raise_delivery_errors = false
@@ -22,20 +28,6 @@ Rails.application.configure do
   # Raise an error on page load if there are pending migrations.
   config.active_record.migration_error = :page_load
 
-  # Debug mode disables concatenation and preprocessing of assets.
-  # This option may cause significant delays in view rendering with a large
-  # number of complex assets.
-  # config.assets.debug = true
-
-  # Asset digests allow you to set far-future HTTP expiration dates on all assets,
-  # yet still be able to expire them through the digest params.
-  # config.assets.digest = true
-
-  # Adds additional error checking when serving assets at runtime.
-  # Checks for improperly declared sprockets dependencies.
-  # Raises helpful error messages.
-  # config.assets.raise_runtime_errors = true
-
   # Raises error for missing translations
-  # config.action_view.raise_on_missing_translations = true
+  # config.i18n.raise_on_missing_translations = true
 end

data/test/dummy/config/environments/production.rb

@@ -2,78 +2,26 @@ Rails.application.configure do
   # Settings specified here will take precedence over those in config/application.rb.
 
   # Code is not reloaded between requests.
-  config.cache_classes = true
+  config.enable_reloading = false
 
-  # Eager load code on boot. This eager loads most of Rails and
-  # your application in memory, allowing both threaded web servers
-  # and those relying on copy on write to perform better.
-  # Rake tasks automatically ignore this option for performance.
+  # Eager load code on boot for better performance and memory savings.
   config.eager_load = true
 
-  # Full error reports are disabled and caching is turned on.
+  # Full error reports are disabled.
   config.consider_all_requests_local = false
-  config.action_controller.perform_caching = true
-
-  # Enable Rack::Cache to put a simple HTTP cache in front of your application
-  # Add `rack-cache` to your Gemfile before enabling this.
-  # For large-scale production use, consider using a caching reverse proxy like
-  # NGINX, varnish or squid.
-  # config.action_dispatch.rack_cache = true
-
-  # Disable serving static files from the `/public` folder by default since
-  # Apache or NGINX already handles this.
-  config.serve_static_files = ENV["RAILS_SERVE_STATIC_FILES"].present?
-
-  # Compress JavaScripts and CSS.
-  # config.assets.js_compressor = :uglifier
-
-  # config.assets.css_compressor = :sass
-
-  # Do not fallback to assets pipeline if a precompiled asset is missed.
-  # config.assets.compile = false
-
-  # Asset digests allow you to set far-future HTTP expiration dates on all assets,
-  # yet still be able to expire them through the digest params.
-  # config.assets.digest = true
-
-  # `config.assets.precompile` and `config.assets.version` have moved to config/initializers/assets.rb
 
-  # Specifies the header that your server uses for sending files.
-  # config.action_dispatch.x_sendfile_header = 'X-Sendfile' # for Apache
-  # config.action_dispatch.x_sendfile_header = 'X-Accel-Redirect' # for NGINX
-
-  # Force all access to the app over SSL, use Strict-Transport-Security, and use secure cookies.
-  # config.force_ssl = true
-
-  # Use the lowest log level to ensure availability of diagnostic information
-  # when problems arise.
-  config.log_level = :debug
-
-  # Prepend all log lines with the following tags.
-  # config.log_tags = [ :subdomain, :uuid ]
-
-  # Use a different logger for distributed setups.
-  # config.logger = ActiveSupport::TaggedLogging.new(SyslogLogger.new)
-
-  # Use a different cache store in production.
-  # config.cache_store = :mem_cache_store
-
-  # Enable serving of images, stylesheets, and JavaScripts from an asset server.
-  # config.action_controller.asset_host = 'http://assets.example.com'
+  # Turn on fragment caching in view templates.
+  config.action_controller.perform_caching = true
 
-  # Ignore bad email addresses and do not raise email delivery errors.
-  # Set this to true and configure the email server for immediate delivery to raise delivery errors.
-  # config.action_mailer.raise_delivery_errors = false
+  # Disable serving static files from `public/`, relying on NGINX/Apache to do so instead.
+  config.public_file_server.enabled = ENV["RAILS_SERVE_STATIC_FILES"].present?
 
   # Enable locale fallbacks for I18n (makes lookups for any locale fall back to
   # the I18n.default_locale when a translation cannot be found).
   config.i18n.fallbacks = true
 
-  # Send deprecation notices to registered listeners.
-  config.active_support.deprecation = :notify
-
-  # Use default logging formatter so that PID and timestamp are not suppressed.
-  config.log_formatter = ::Logger::Formatter.new
+  # Don't log any deprecations.
+  config.active_support.report_deprecations = false
 
   # Do not dump schema after migrations.
   config.active_record.dump_schema_after_migration = false

data/test/dummy/config/environments/test.rb

@@ -1,27 +1,27 @@
 Rails.application.configure do
   # Settings specified here will take precedence over those in config/application.rb.
 
-  # The test environment is used exclusively to run your application's
-  # test suite. You never need to work with it otherwise. Remember that
-  # your test database is "scratch space" for the test suite and is wiped
-  # and recreated between test runs. Don't rely on the data there!
-  config.cache_classes = true
-
-  # Do not eager load code on boot. This avoids loading your whole application
-  # just for the purpose of running a single test. If you are using a tool that
-  # preloads Rails for running tests, you may have to set it to true.
-  config.eager_load = false
-
-  # Configure static file server for tests with Cache-Control for performance.
-  config.serve_static_files = true
-  config.static_cache_control = "public, max-age=3600"
-
-  # Show full error reports and disable caching.
+  # While tests run files are not watched, reloading is not necessary.
+  config.enable_reloading = false
+
+  # Eager loading loads your entire application. When running a single test locally,
+  # this is usually not necessary, and can slow down your test suite. However, it's
+  # recommended that you enable it in continuous integration systems to ensure eager
+  # loading is working properly before deploying your code.
+  config.eager_load = ENV["CI"].present?
+
+  # Configure public file server for tests with cache-control for performance.
+  config.public_file_server.enabled = true
+  config.public_file_server.headers = {
+    "Cache-Control" => "public, max-age=3600",
+  }
+
+  # Show full error reports.
   config.consider_all_requests_local = true
-  config.action_controller.perform_caching = false
+  config.cache_store = :memory_store
 
-  # Raise exceptions instead of rendering exception templates.
-  config.action_dispatch.show_exceptions = false
+  # Render exception templates for rescuable exceptions and raise for other exceptions.
+  config.action_dispatch.show_exceptions = :rescuable
 
   # Disable request forgery protection in test environment.
   config.action_controller.allow_forgery_protection = false
@@ -31,12 +31,9 @@ Rails.application.configure do
   # ActionMailer::Base.deliveries array.
   config.action_mailer.delivery_method = :test
 
-  # Randomize the order test cases are executed.
-  config.active_support.test_order = :random
-
   # Print deprecation notices to the stderr.
   config.active_support.deprecation = :stderr
 
   # Raises error for missing translations
-  # config.action_view.raise_on_missing_translations = true
+  # config.i18n.raise_on_missing_translations = true
 end

data/test/dummy/db/schema.rb

@@ -10,31 +10,31 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[7.1].define(version: 2016_03_26_174530) do
+ActiveRecord::Schema[8.1].define(version: 2016_03_26_174530) do
   create_table "categories", force: :cascade do |t|
+    t.datetime "created_at", precision: nil, null: false
     t.string "name"
     t.integer "store_id"
-    t.datetime "created_at", precision: nil, null: false
     t.datetime "updated_at", precision: nil, null: false
   end
 
   create_table "category_items", force: :cascade do |t|
-    t.string "name"
     t.integer "category_id"
-    t.integer "product_id"
     t.datetime "created_at", precision: nil, null: false
+    t.string "name"
+    t.integer "product_id"
     t.datetime "updated_at", precision: nil, null: false
   end
 
   create_table "products", force: :cascade do |t|
-    t.string "name"
     t.datetime "created_at", precision: nil, null: false
+    t.string "name"
     t.datetime "updated_at", precision: nil, null: false
   end
 
   create_table "stores", force: :cascade do |t|
-    t.string "name"
     t.datetime "created_at", precision: nil, null: false
+    t.string "name"
     t.datetime "updated_at", precision: nil, null: false
   end
 end

data/test/filter_test.rb

@@ -1,6 +1,6 @@
 require "test_helper"
 
-class FilterTest < ActiveSupport::TestCase
+class FilterTest < ActiveJob::TestCase
   self.use_transactional_tests = true
   teardown :clear_cache
 
@@ -16,11 +16,11 @@ class FilterTest < ActiveSupport::TestCase
     ) { |name| mock.call(name) }
 
     mock.expect(:call, 1, ["basketball"])
-    category.update!(name: "basketball")
+    perform_enqueued_jobs { category.update!(name: "basketball") }
     mock.verify
 
     mock.expect(:call, 1, ["hockey"])
-    category.update!(name: "hockey")
+    perform_enqueued_jobs { category.update!(name: "hockey") }
     assert_raises(MockExpectationError) { mock.verify }
   end
 

data/test/test_helper.rb

@@ -6,11 +6,11 @@ ActiveRecord::Migrator.migrations_paths = [
   File.expand_path("../../test/dummy/db/migrate", __FILE__),
 ]
 require "rails/test_help"
+require "minitest/mock"
 
 # Filter out Minitest backtrace while allowing backtrace from other libraries
 # to be shown.
 Minitest.backtrace_filter = Minitest::BacktraceFilter.new
-require "minitest/mock"
 
 # Load support files
 Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
@@ -29,7 +29,7 @@ elsif ActiveSupport::TestCase.respond_to?(:fixture_paths=)
 end
 ActiveSupport::TestCase.fixtures :all
 
-ActiveJob::Base.queue_adapter = :inline
+ActiveJob::Base.queue_adapter = :test
 ActiveSupport.test_order = :random
 
 def clear_cache

data/test/thermos_test.rb

@@ -1,6 +1,6 @@
 require "test_helper"
 
-class ThermosTest < ActiveSupport::TestCase
+class ThermosTest < ActiveJob::TestCase
   self.use_transactional_tests = true
   teardown :clear_cache
 
@@ -50,7 +50,7 @@ class ThermosTest < ActiveSupport::TestCase
     mock.verify
 
     mock.expect(:call, 2, [category.id])
-    category.update!(name: "foo")
+    perform_enqueued_jobs { category.update!(name: "foo") }
     mock.verify
 
     mock.expect(:call, 3, [category.id])
@@ -92,7 +92,7 @@ class ThermosTest < ActiveSupport::TestCase
     mock.verify
 
     mock.expect(:call, 1, [category.id])
-    category.update!(name: "foo")
+    perform_enqueued_jobs { category.update!(name: "foo") }
     mock.verify
 
     mock.expect(:call, 3, [other_category.id])
@@ -123,7 +123,7 @@ class ThermosTest < ActiveSupport::TestCase
     end
 
     mock.expect(:call, 1, ["foo"])
-    Category.create!(name: "foo")
+    perform_enqueued_jobs { Category.create!(name: "foo") }
     mock.verify
 
     mock.expect(:call, 2, ["foo"])
@@ -144,7 +144,7 @@ class ThermosTest < ActiveSupport::TestCase
     mock.verify
 
     mock.expect(:call, 2, ["foo"])
-    category.update!(name: "foo")
+    perform_enqueued_jobs { category.update!(name: "foo") }
     mock.verify
 
     mock.expect(:call, 3, [category.name])

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: thermos
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 2.0.1
 platform: ruby
 authors:
 - Andrew Thal
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-19 00:00:00.000000000 Z
+date: 2025-12-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -16,30 +16,36 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
-  name: sqlite3
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,7 +59,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: prettier
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,22 +73,26 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: psych
+  name: prettier
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: '0'
 description: |
-  Thermos is a library for caching in rails that re-warms caches
-  in the background based on model changes.
+  Thermos is a Rails caching library that keeps your cache always warm by
+  automatically rebuilding it in the background when ActiveRecord models change.
+  No more stale data from TTL expiration, no more slow cold cache hits, and no
+  need to 'touch' associated models. Works with any ActiveJob backend (Sidekiq,
+  Solid Queue, etc.) and any cache store (Redis, Memcached, Solid Cache, etc.).
+  Perfect for API responses, JSON serialization, and view caching.
 email:
 - athal7@me.com
 executables: []
@@ -90,6 +100,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - MIT-LICENSE
+- README.md
 - Rakefile
 - lib/thermos.rb
 - lib/thermos/beverage.rb
@@ -130,7 +141,6 @@ files:
 - test/dummy/config/initializers/filter_parameter_logging.rb
 - test/dummy/config/initializers/inflections.rb
 - test/dummy/config/initializers/mime_types.rb
-- test/dummy/config/initializers/session_store.rb
 - test/dummy/config/initializers/wrap_parameters.rb
 - test/dummy/config/locales/en.yml
 - test/dummy/config/routes.rb
@@ -155,26 +165,31 @@ files:
 homepage: https://github.com/athal7/thermos
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  homepage_uri: https://github.com/athal7/thermos
+  source_code_uri: https://github.com/athal7/thermos
+  changelog_uri: https://github.com/athal7/thermos/releases
+  rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
-summary: Always-warm, auto-rebuilding rails caching without timers or touching.
+summary: Always-warm, auto-rebuilding Rails cache that updates in the background when
+  models change.
 test_files:
 - test/dependencies_test.rb
 - test/dummy/README.rdoc
@@ -206,7 +221,6 @@ test_files:
 - test/dummy/config/initializers/filter_parameter_logging.rb
 - test/dummy/config/initializers/inflections.rb
 - test/dummy/config/initializers/mime_types.rb
-- test/dummy/config/initializers/session_store.rb
 - test/dummy/config/initializers/wrap_parameters.rb
 - test/dummy/config/locales/en.yml
 - test/dummy/config/routes.rb

data/test/dummy/config/initializers/session_store.rb

@@ -1,3 +0,0 @@
-# Be sure to restart your server when you modify this file.
-
-Rails.application.config.session_store :cookie_store, key: "_dummy_session"