leveled_cache 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a86654509725147ae338c2043e6d7f8ba9d5df587b2c34cf93a65000c30d10d
-  data.tar.gz: ca9185afc78fe514d66abb0264cb45031c88c512f9cfec7362dcb65bdcf2881c
+  metadata.gz: 8a1044673841aded566b48eb3bd310619dca57ce3f2722768e9c47c9379bd68b
+  data.tar.gz: a3dcc54d533abbc3ed3ab89d08bd851b62de5c2461af683523ca26f7ef5d2e83
 SHA512:
-  metadata.gz: 4a316bcdfee2317c1b63b52660e169bfa5b115b3aed273cb4dea60051f81ff47ce417bf33c44481e6f496bafdfef35a9b5ff406ca8f07c685baa0be8d32dd749
-  data.tar.gz: 16ef1640ba78fc68f7823bea32bc8278654fa6e4ac5f9af36aba079abc3ab73a99c58e10f471cbcc6c0fea03743b435ec749c46adb8df0d8551a0d5424139546
+  metadata.gz: 8317ac588eb5d751c96558c8f4c9fde807a98f6cc19265dab01a2e8c776a89133e1805fb438899d40b1fa3638c21581a46d2fc489cdb054e15bab3335792e7b5
+  data.tar.gz: c52bf449a0276e50e7b57627aff77ccf9916a3b3bf8c1d9b03c886706ec4fa37e039a223ea985b28e74fc1442a2161a499dd0270dbd504b5037f4549fdda6cd5

data/Appraisals

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-%w[6.1 7.0 7.1].each do |version|
+%w[6.1 7.0 7.1 7.2].each do |version|
   appraise "activesupport-#{version}" do
     gem "activesupport", "~> #{version}.0"
   end

data/CHANGELOG.md

@@ -1,4 +1,14 @@
-## [Unreleased]
+## [0.3.0] - 2024-08-15
+
+- Optimize `read_multi`
+- Implement `write_multi`
+- Fix `delete` so that keys aren't double-namespaced
+- Support nested `LeveledCache`
+
+## [0.2.0] - 2024-02-26
+
+- Support `ActiveSupport::Cache.lookup_store`
+- `#write` and `#delete` now return responses from underlying caches
 
 ## [0.1.0] - 2024-02-13
 

data/Gemfile

@@ -7,6 +7,4 @@ gemspec
 gem "appraisal"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
-gem "rubocop", "~> 1"
-gem "rubocop-rake", "~> 0"
-gem "rubocop-rspec", "~> 2.0"
+gem "standardrb", "~> 1"

data/README.md

@@ -47,7 +47,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/dpirotte/leveled_cache. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/activesupport-cache-leveled_proxy/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/dpirotte/leveled_cache. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/dpirotte/leveled_cache/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -55,4 +55,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the LeveledCache project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/activesupport-cache-leveled_proxy/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the LeveledCache project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/dpirotte/leveled_cache/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -2,11 +2,8 @@
 
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
+require "standard/rake"
 
 RSpec::Core::RakeTask.new(:spec)
 
-require "rubocop/rake_task"
-
-RuboCop::RakeTask.new
-
-task default: %i[spec rubocop]
+task default: %i[spec standard]

data/gemfiles/activesupport_6.1.gemfile

@@ -5,9 +5,7 @@ source "https://rubygems.org"
 gem "appraisal"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
-gem "rubocop", "~> 1"
-gem "rubocop-rake", "~> 0"
-gem "rubocop-rspec", "~> 2.0"
+gem "standardrb", "~> 1"
 gem "activesupport", "~> 6.1.0"
 
 gemspec path: "../"

data/gemfiles/activesupport_7.0.gemfile

@@ -5,9 +5,7 @@ source "https://rubygems.org"
 gem "appraisal"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
-gem "rubocop", "~> 1"
-gem "rubocop-rake", "~> 0"
-gem "rubocop-rspec", "~> 2.0"
+gem "standardrb", "~> 1"
 gem "activesupport", "~> 7.0.0"
 
 gemspec path: "../"

data/gemfiles/activesupport_7.1.gemfile

@@ -5,9 +5,7 @@ source "https://rubygems.org"
 gem "appraisal"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
-gem "rubocop", "~> 1"
-gem "rubocop-rake", "~> 0"
-gem "rubocop-rspec", "~> 2.0"
+gem "standardrb", "~> 1"
 gem "activesupport", "~> 7.1.0"
 
 gemspec path: "../"

data/gemfiles/activesupport_7.2.gemfile

@@ -0,0 +1,11 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "appraisal"
+gem "rake", "~> 13.0"
+gem "rspec", "~> 3.0"
+gem "standardrb", "~> 1"
+gem "activesupport", "~> 7.2.0"
+
+gemspec path: "../"

data/gemfiles/activesupport_main.gemfile

@@ -5,9 +5,7 @@ source "https://rubygems.org"
 gem "appraisal"
 gem "rake", "~> 13.0"
 gem "rspec", "~> 3.0"
-gem "rubocop", "~> 1"
-gem "rubocop-rake", "~> 0"
-gem "rubocop-rspec", "~> 2.0"
+gem "standardrb", "~> 1"
 gem "activesupport", git: "https://github.com/rails/rails", glob: "activesupport/*.gemspec"
 
 gemspec path: "../"

data/lib/active_support/cache/leveled_cache_store.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module ActiveSupport
+  module Cache
+    LeveledCacheStore = LeveledCache::Store
+  end
+end

data/lib/leveled_cache/store.rb

@@ -22,8 +22,6 @@ module LeveledCache
   # care to configure underlying caches accordingly. For example, it may
   # be desirable to use NullCoder on an earlier MemoryStore.
   class Store < ActiveSupport::Cache::Store
-    VERSION = "0.1.0"
-
     # Create a new LeveledCacheProxy that calls cache methods on
     # one or more underlying caches in order.
     #
@@ -72,6 +70,15 @@ module LeveledCache
       read_entry(name, **options)
     end
 
+    # Reads data from the caches in order using the given keys. Data
+    # is returned from the first cache level with data for a key.
+    # Otherwise, +{}+ is returned.
+    #
+    # Options are passed through to the underlying caches.
+    def read_multi(*names, **options)
+      read_multi_entries(names, **options)
+    end
+
     # Writes the value to all cache levels with the provided key.
     #
     # Options are passed through to the underlying caches.
@@ -79,6 +86,20 @@ module LeveledCache
       write_entry(name, value, **options)
     end
 
+    # Deletes the value from all cache levels with the provided key.
+    #
+    # Options are passed through to the underlying caches.
+    def delete(name, **options)
+      delete_entry(name, **options)
+    end
+
+    # Writes the key value pairs to all cache levels.
+    #
+    # Options are passed through to the underlying caches.
+    def write_multi(hash, **options)
+      write_multi_entries(hash, **options)
+    end
+
     private
 
     # Recursively `fetch_multi` on each cache. Missing values
@@ -87,17 +108,22 @@ module LeveledCache
     def _fetch_multi(caches, names, options, &)
       first, *rest = caches
 
-      reads = first.read_multi(*names, **options)
+      reads = if first.is_a?(self.class)
+        first.fetch_multi(*names, **options, &)
+      else
+        first.read_multi(*names, **options)
+      end
+
       missing = names - reads.keys
 
       if missing.any?
         writes = if rest.any?
-                   _fetch_multi(rest, missing, options, &)
-                 else
-                   missing.index_with(&)
-                 end
+          _fetch_multi(rest, missing, options, &)
+        else
+          missing.index_with(&)
+        end
 
-        first.write_multi(writes, options)
+        first.write_multi(writes, **options)
         reads.merge!(writes)
       end
 
@@ -109,7 +135,7 @@ module LeveledCache
     def _fetch(caches, name, options, &block)
       first, *rest = caches
 
-      first.fetch(name, options) do
+      first.fetch(name, **options) do
         if rest.any?
           _fetch(rest, name, options, &block)
         else
@@ -120,19 +146,43 @@ module LeveledCache
 
     def read_entry(key, **options)
       @caches.lazy.map do |cache|
-        cache.read(key, options)
+        cache.read(key, **options)
       end.compact.first
     end
 
     def write_entry(key, entry, **options)
-      @caches.each do |cache|
-        cache.write(key, entry, options)
+      @caches.map do |cache|
+        cache.write(key, entry, **options)
       end
     end
 
     def delete_entry(key, **options)
-      @caches.each do |cache|
-        cache.delete(key, options)
+      @caches.map do |cache|
+        cache.delete(key, **options)
+      end
+    end
+
+    def read_multi_entries(*keys, **options)
+      _read_multi_entries(@caches, *keys, **options)
+    end
+
+    def _read_multi_entries(caches, keys, **options)
+      first, *rest = caches
+
+      reads = first.read_multi(*keys, **options)
+
+      missing = keys - reads.keys
+
+      if missing.any? && rest.any?
+        reads.merge!(_read_multi_entries(rest, missing, **options))
+      end
+
+      reads
+    end
+
+    def write_multi_entries(hash, **options)
+      @caches.map do |cache|
+        cache.write_multi(hash)
       end
     end
   end

data/lib/leveled_cache/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LeveledCache
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/leveled_cache.rb

@@ -1,3 +1,4 @@
 # frozen_string_literal: true
 
 require "leveled_cache/store"
+require "leveled_cache/version"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: leveled_cache
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Dave Pirotte
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-16 00:00:00.000000000 Z
+date: 2024-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -19,7 +19,7 @@ dependencies:
         version: '6.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '8.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,8 +29,8 @@ dependencies:
         version: '6.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7.2'
-description: 
+        version: '8.0'
+description:
 email:
 - dpirotte@gmail.com
 executables: []
@@ -38,7 +38,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".rspec"
-- ".rubocop.yml"
 - Appraisals
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
@@ -49,7 +48,9 @@ files:
 - gemfiles/activesupport_6.1.gemfile
 - gemfiles/activesupport_7.0.gemfile
 - gemfiles/activesupport_7.1.gemfile
+- gemfiles/activesupport_7.2.gemfile
 - gemfiles/activesupport_main.gemfile
+- lib/active_support/cache/leveled_cache_store.rb
 - lib/leveled_cache.rb
 - lib/leveled_cache/store.rb
 - lib/leveled_cache/version.rb
@@ -61,7 +62,7 @@ metadata:
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/dpirotte/leveled_cache
   changelog_uri: https://github.com/dpirotte/leveled_cache/blob/main/CHANGELOG.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -76,8 +77,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.1
-signing_key: 
+rubygems_version: 3.3.23
+signing_key:
 specification_version: 4
 summary: ActiveSupport::Cache that wraps multiple levels of caches
 test_files: []

data/.rubocop.yml

@@ -1,50 +0,0 @@
-require:
-  - rubocop-rake
-  - rubocop-rspec
-
-AllCops:
-  NewCops: enable
-  TargetRubyVersion: 3.1
-
-Bundler/OrderedGems:
-  Exclude:
-    - gemfiles/*
-
-Metrics/BlockLength:
-  Max: 200
-
-Metrics/MethodLength:
-  Max: 16
-
-Style/ArgumentsForwarding:
-  UseAnonymousForwarding: false
-
-Style/FrozenStringLiteralComment:
-  Exclude:
-    - gemfiles/*
-
-Style/StringLiterals:
-  Enabled: true
-  EnforcedStyle: double_quotes
-
-Style/StringLiteralsInInterpolation:
-  Enabled: true
-  EnforcedStyle: double_quotes
-
-Layout/LineLength:
-  Max: 120
-
-Lint/MissingSuper:
-  Enabled: false
-
-RSpec/ExampleLength:
-  Max: 7
-
-RSpec/MessageSpies:
-  EnforcedStyle: receive
-
-RSpec/MultipleExpectations:
-  Max: 5
-
-RSpec/MultipleMemoizedHelpers:
-  Max: 6