safe_memoize 0.7.0 → 0.9.0

data/sig/safe_memoize.rbs

@@ -7,6 +7,7 @@ module SafeMemoize
   type memo_key = default_memo_key | custom_memo_key
   type memo_record = { value: untyped, expires_at: Float?, cached_at: Float }
 
+  @configuration: Configuration?
   @__safe_memo_cache__: Hash[memo_key, memo_record]?
   @__safe_memo_mutex__: Mutex?
   @__safe_memo_shared_cache__: Hash[memo_key, memo_record]?
@@ -17,17 +18,23 @@ module SafeMemoize
   def self.configure: () { (Configuration) -> void } -> void
   def self.configuration: () -> Configuration
   def self.reset_configuration!: () -> Configuration
+  def self.deprecate: (String subject, message: String, horizon: String) -> void
 
   class Configuration
     attr_accessor default_ttl: Numeric?
     attr_accessor default_max_size: Integer?
+    attr_accessor on_deprecation: (^(String message) -> void)?
+    attr_accessor on_hook_error: (^(Exception error, Symbol hook_type, untyped cache_key) -> void)?
+    attr_accessor active_support_notifications: bool
+    attr_accessor statsd_client: untyped
+    attr_accessor opentelemetry_tracer: untyped
 
     def initialize: () -> void
   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)?) -> void
-    def memoize_all: (?except: Array[Symbol | String], ?include_protected: bool, ?include_private: bool, ?ttl: Numeric?, ?max_size: Integer?, ?if: (^(untyped result) -> boolish)?, ?unless: (^(untyped result) -> boolish)?, ?shared: bool, ?key: (^(*untyped args, **untyped kwargs) -> untyped)?) -> void
+    def memoize_all: (?except: Array[Symbol | String], ?only: Array[Symbol | String], ?include_protected: bool, ?include_private: bool, ?ttl: Numeric?, ?max_size: Integer?, ?if: (^(untyped result) -> boolish)?, ?unless: (^(untyped result) -> boolish)?, ?shared: bool, ?key: (^(*untyped args, **untyped kwargs) -> untyped)?) -> void
     def reset_shared_memo: (Symbol | String method_name, *untyped args, **untyped kwargs) -> void
     def reset_all_shared_memos: () -> void
     def shared_memoized?: (Symbol | String method_name, *untyped args, **untyped kwargs) -> bool
@@ -68,6 +75,7 @@ module SafeMemoize
     def memo_stale?: (Symbol | String method_name, *untyped args, **untyped kwargs) -> bool
     def reset_memo: (Symbol | String method_name, *untyped args, **untyped kwargs) -> void
     def reset_all_memos: () -> void
+    def memo_inspect: (Symbol | String method_name, *untyped args, **untyped kwargs) -> { cached: bool, value: untyped, hits: Integer, misses: Integer, ttl_remaining: Float?, age: Float?, custom_key: untyped, lru_position: Integer? }?
   end
 
   module CacheStoreMethods
@@ -108,6 +116,7 @@ module SafeMemoize
     def safe_memo_values_for: (Symbol? method_name) -> Array[untyped]
     def memo_projection: (memo_key cache_key, memo_record value, include_method: bool, include_value: bool) -> Hash[Symbol, untyped]
     def safe_memo_cache_key: (Symbol | String method_name, Array[untyped] args, Hash[Symbol, untyped] kwargs) -> default_memo_key
+    def deep_freeze_copy: (untyped obj) -> untyped
   end
 
   module HooksMethods
@@ -185,5 +194,27 @@ module SafeMemoize
     include PublicCustomKeyMethods
     include LruMethods
   end
+
+  module Adapters
+    module OpenTelemetry
+      SPAN_NAME: String
+      def self.trace: (untyped tracer, Symbol | String method_name, String? class_name) { () -> untyped } -> untyped
+    end
+  end
+
+  module Rails
+    def self.track: (untyped instance) -> void
+    def self.reset_tracked!: () -> void
+
+    module RequestScoped
+      def self.included: (Module base) -> void
+      def reset_request_memos: () -> void
+    end
+
+    class Middleware
+      def initialize: (untyped app) -> void
+      def call: (untyped env) -> untyped
+    end
+  end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: safe_memoize
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -34,7 +34,7 @@ description: 'SafeMemoize is a production-ready, zero-dependency memoization lib
   cache key generators, and introspection helpers. Method visibility (public, protected,
   private) is fully preserved.'
 email:
-- eclectic-coding@users.noreply.github.com
+- chuck@eclecticcoding.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -44,8 +44,14 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
+- ROADMAP.md
 - Rakefile
+- benchmarks/README.md
+- benchmarks/benchmark.rb
+- codecov.yml
 - lib/safe_memoize.rb
+- lib/safe_memoize/adapters/opentelemetry.rb
+- lib/safe_memoize/adapters/statsd.rb
 - lib/safe_memoize/cache_metrics_methods.rb
 - lib/safe_memoize/cache_record_methods.rb
 - lib/safe_memoize/cache_store_methods.rb
@@ -59,6 +65,9 @@ files:
 - lib/safe_memoize/public_custom_key_methods.rb
 - lib/safe_memoize/public_methods.rb
 - lib/safe_memoize/public_metrics_methods.rb
+- lib/safe_memoize/rails.rb
+- lib/safe_memoize/rails/middleware.rb
+- lib/safe_memoize/rails/request_scoped.rb
 - lib/safe_memoize/release_tooling.rb
 - lib/safe_memoize/version.rb
 - sig/safe_memoize.rbs