safe_memoize 1.6.0 → 1.7.1

data/sig/safe_memoize.rbs

@@ -66,7 +66,7 @@ module SafeMemoize
   end
 
   module ClassMethods
-    def memoize: (Symbol | String method_name, ?ttl: Numeric?, ?max_size: Integer?, ?ttl_refresh: bool, ?if: (^(untyped result) -> boolish)?, ?unless: (^(untyped result) -> boolish)?, ?shared: bool, ?key: (^(*untyped args, **untyped kwargs) -> untyped)?, ?store: Stores::Base?, ?fiber_local: bool, ?ractor_safe: bool, ?namespace: String?, ?shared_cache: String?, ?cache_bust: (^() -> untyped) | Symbol | nil, ?copy_on_read: bool, ?group: Symbol | String | nil, ?circuit_breaker: bool | Hash[Symbol, untyped] | nil, **untyped extension_options) -> void
+    def memoize: (Symbol | String method_name, ?ttl: Numeric?, ?max_size: Integer?, ?ttl_refresh: bool, ?if: (^(untyped result) -> boolish)?, ?unless: (^(untyped result) -> boolish)?, ?shared: bool, ?key: (^(*untyped args, **untyped kwargs) -> untyped)?, ?store: Stores::Base | Array[Stores::Base] | nil, ?fiber_local: bool, ?ractor_safe: bool, ?namespace: String?, ?shared_cache: String?, ?cache_bust: (^() -> untyped) | Symbol | nil, ?copy_on_read: bool, ?group: Symbol | String | nil, ?circuit_breaker: bool | Hash[Symbol, untyped] | nil, ?stampede_protection: bool | Numeric | nil, **untyped extension_options) -> void
     def safe_memoize_store: () -> Stores::Base?
     def safe_memoize_store=: (Stores::Base?) -> Stores::Base?
     def safe_memoize_namespace: () -> String?
@@ -148,7 +148,7 @@ module SafeMemoize
 
     def memo_ttl: (Numeric? ttl) -> Float?
     def memo_expires_at: (Float? ttl) -> Float?
-    def memo_record: (untyped value, expires_at: Float?) -> memo_record
+    def memo_record: (untyped value, expires_at: Float?, ?delta: Float?) -> memo_record
     def memo_record_value: (memo_record record) -> untyped
     def memo_record_live?: (memo_record? record) -> bool
     def memo_prune_expired_entries!: (Hash[memo_key, memo_record] cache) -> void
@@ -251,6 +251,14 @@ module SafeMemoize
   end
 
   module RactorSharedMethods
+    MUTEX_KEY: Symbol
+    PORTS: bool
+
+    def self.round_trip: (untyped supervisor, Symbol op, *untyped args) -> untyped
+    def self.round_trip_via_port: (untyped supervisor, Symbol op, *untyped args) -> untyped
+    def self.round_trip_via_queue: (untyped supervisor, Symbol op, *untyped args) -> untyped
+    def self.ractor_mutex: () -> Thread::Mutex
+
     def reset_ractor_memo: (Symbol | String method_name, *untyped args, **untyped kwargs) -> void
     def reset_all_ractor_memos: () -> void
     def ractor_memoized?: (Symbol | String method_name, *untyped args, **untyped kwargs) -> bool
@@ -301,6 +309,38 @@ module SafeMemoize
       def expired?: ({ expires_at: Float?, value: untyped, cached_at: Float }) -> bool
     end
 
+    class Multilevel < Base
+      attr_reader stores: Array[Base]
+
+      def initialize: (*Base stores, ?promote_expires_in: Numeric?) -> void
+      def read: (untyped key) -> untyped
+      def write: (untyped key, untyped value, ?expires_in: Numeric?) -> void
+      def delete: (untyped key) -> void
+      def clear: () -> void
+      def keys: () -> Array[untyped]
+    end
+
+    class XFetch < Base
+      ENVELOPE_KEY: Symbol
+      DEFAULT_BETA: Float
+      DEFAULT_DELTA: Float
+
+      attr_reader wrapped_store: Base
+      attr_reader beta: Float
+      attr_reader delta: Float
+
+      def initialize: (Base store, ?beta: Numeric, ?delta: Numeric) -> void
+      def read: (untyped key) -> untyped
+      def write: (untyped key, untyped value, ?expires_in: Numeric?) -> void
+      def delete: (untyped key) -> void
+      def clear: () -> void
+      def keys: () -> Array[untyped]
+
+      private
+
+      def envelope?: (untyped value) -> bool
+    end
+
     class CircuitBreaker < Base
       DEFAULT_ERROR_THRESHOLD: Integer
       DEFAULT_PROBE_INTERVAL: Float

metadata

@@ -1,28 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safe_memoize
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.1
 platform: ruby
 authors:
 - Chuck Smith
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.22'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.22'
+dependencies: []
 description: 'SafeMemoize is a production-ready, zero-dependency memoization library
   for Ruby. It uses Ruby''s prepend mechanism to wrap methods with a thread-safe cache
   (Mutex + double-check locking) that correctly handles nil and false return values
@@ -49,6 +35,7 @@ files:
 - ROADMAP.md
 - Rakefile
 - UPGRADING.md
+- benchmarks/BENCHMARK.md
 - benchmarks/README.md
 - benchmarks/benchmark.rb
 - codecov.yml
@@ -79,8 +66,10 @@ files:
 - lib/safe_memoize/stores/base.rb
 - lib/safe_memoize/stores/circuit_breaker.rb
 - lib/safe_memoize/stores/memory.rb
+- lib/safe_memoize/stores/multilevel.rb
 - lib/safe_memoize/stores/rails_cache.rb
 - lib/safe_memoize/stores/redis.rb
+- lib/safe_memoize/stores/xfetch.rb
 - lib/safe_memoize/version.rb
 - rbi/safe_memoize.rbi
 - sig/safe_memoize.rbs