legion-cache 1.3.10 → 1.3.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 55564d67820fd4fe967dda95b7bc33d6c52fb78db138513a3dc2112766ca6154
-  data.tar.gz: 13fdaa235bba02a090b20b7b9b500099f41c660e0ad492ec1d19bcec9e8b0db0
+  metadata.gz: 84f54b95a9a31607080afb2afbad2e85d713cb2d24b0a126dd97cea864d443a6
+  data.tar.gz: 0be1410d11a82efb137f050b7236f6e7d8cde91d4d75cf1275c0ccc22fbc1ed7
 SHA512:
-  metadata.gz: bd16d23507c10117ffd1acab7d286fcde27e2843b264c6a60e45b3825b159cee2c865746aee8800187e964144e2b3b57b0ea1909246afabab0ed1bfc4f59a14f
-  data.tar.gz: 4d4572b182caf141e0033cb2fd4068406c74889fd0c9cf737cc18a89139cc50c13761b42c69760415a2e45b4831ea80900f3f9be8e7bfa71a2ee76355d951988
+  metadata.gz: e581d3e4d49937215c091f309939985b174516a5fa78619e499bc5a2d01e6ac389c438fcf5bdc63d883ca72b08bc082e0926f88ffbc7fbae2578198ca6aad954
+  data.tar.gz: a1618ccbad942d1c73bb0f549a6485f2883371b67d9bd3beded87aa58eb71bcdf092579c1d640afa80e3e98567c49e4e5cd6e4cd40f1bc0cf179ee188f219688

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.3.12] - 2026-03-24
+
+### Added
+- `Legion::Cache::Memory` adapter module for lite mode: pure in-memory cache with TTL expiry and thread-safe Mutex synchronization
+- Cache `setup` auto-detects `LEGION_MODE=lite` and activates Memory adapter, skipping Redis/Memcached
+- `@using_memory` flag routes `get`/`set`/`fetch`/`delete`/`flush` through Memory adapter
+- `shutdown` cleanly tears down Memory adapter when active
+
+## [1.3.11] - 2026-03-22
+
+### Added
+- `Legion::Cache::Helper` module: injectable cache mixin for LEX extensions
+- Namespaced `cache_set`, `cache_get`, `cache_delete`, `cache_fetch` for shared cache
+- Namespaced `local_cache_set`, `local_cache_get`, `local_cache_delete`, `local_cache_fetch` for per-node local cache
+
 ## [1.3.10] - 2026-03-22
 
 ### Changed

data/lib/legion/cache/helper.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Legion
+  module Cache
+    module Helper
+      def cache_namespace
+        @cache_namespace ||= derive_cache_namespace
+      end
+
+      def cache_set(key, value, ttl: 60)
+        Legion::Cache.set(cache_namespace + key, value, ttl)
+      end
+
+      def cache_get(key)
+        Legion::Cache.get(cache_namespace + key)
+      end
+
+      def cache_delete(key)
+        Legion::Cache.delete(cache_namespace + key)
+      end
+
+      def cache_fetch(key, ttl: 60, &)
+        Legion::Cache.fetch(cache_namespace + key, ttl, &)
+      end
+
+      def local_cache_set(key, value, ttl: 60)
+        Legion::Cache::Local.set(cache_namespace + key, value, ttl)
+      end
+
+      def local_cache_get(key)
+        Legion::Cache::Local.get(cache_namespace + key)
+      end
+
+      def local_cache_delete(key)
+        Legion::Cache::Local.delete(cache_namespace + key)
+      end
+
+      def local_cache_fetch(key, ttl: 60, &)
+        Legion::Cache::Local.fetch(cache_namespace + key, ttl, &)
+      end
+
+      private
+
+      def derive_cache_namespace
+        if respond_to?(:lex_filename)
+          fname = lex_filename
+          fname.is_a?(Array) ? fname.first : fname
+        else
+          derive_cache_namespace_from_class
+        end
+      end
+
+      def derive_cache_namespace_from_class
+        name = respond_to?(:ancestors) ? ancestors.first.to_s : self.class.to_s
+        parts = name.split('::')
+        ext_idx = parts.index('Extensions')
+        target = if ext_idx && parts[ext_idx + 1]
+                   parts[ext_idx + 1]
+                 else
+                   parts.last
+                 end
+        target.gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+              .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+              .downcase
+      end
+    end
+  end
+end

data/lib/legion/cache/memory.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module Legion
+  module Cache
+    module Memory
+      extend self
+
+      @store = {}
+      @expiry = {}
+      @mutex = Mutex.new
+      @connected = false
+
+      def setup(**)
+        @connected = true
+      end
+
+      def client(**) = self
+
+      def connected?
+        @connected
+      end
+
+      def get(key)
+        @mutex.synchronize do
+          expire_if_needed(key)
+          @store[key]
+        end
+      end
+
+      def set(key, value, ttl = nil)
+        @mutex.synchronize do
+          @store[key] = value
+          @expiry[key] = Time.now + ttl if ttl&.positive?
+          value
+        end
+      end
+
+      def fetch(key, ttl = nil)
+        val = get(key)
+        return val unless val.nil?
+
+        val = yield if block_given?
+        set(key, val, ttl)
+        val
+      end
+
+      def delete(key)
+        @mutex.synchronize do
+          @store.delete(key)
+          @expiry.delete(key)
+        end
+      end
+
+      def flush(_delay = 0)
+        @mutex.synchronize do
+          @store.clear
+          @expiry.clear
+        end
+      end
+
+      def close = nil
+
+      def shutdown
+        flush
+        @connected = false
+      end
+
+      def reset!
+        @mutex.synchronize do
+          @store.clear
+          @expiry.clear
+          @connected = false
+        end
+      end
+
+      def size = 1
+      def available = 1
+
+      private
+
+      def expire_if_needed(key)
+        return unless @expiry.key?(key) && Time.now > @expiry[key]
+
+        @store.delete(key)
+        @expiry.delete(key)
+      end
+    end
+  end
+end

data/lib/legion/cache/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Cache
-    VERSION = '1.3.10'
+    VERSION = '1.3.12'
   end
 end

data/lib/legion/cache.rb

@@ -6,7 +6,9 @@ require 'legion/cache/cacheable'
 
 require 'legion/cache/memcached'
 require 'legion/cache/redis'
+require 'legion/cache/memory'
 require 'legion/cache/local'
+require 'legion/cache/helper'
 
 module Legion
   module Cache
@@ -20,15 +22,29 @@ module Legion
       def setup(**)
         return Legion::Settings[:cache][:connected] = true if connected?
 
+        if ENV['LEGION_MODE'] == 'lite'
+          Legion::Cache::Memory.setup
+          @using_memory = true
+          @connected = true
+          Legion::Settings[:cache][:connected] = true
+          Legion::Logging.info 'Legion::Cache using in-memory adapter (lite mode)' if defined?(Legion::Logging)
+          return
+        end
+
         setup_local
         setup_shared(**)
       end
 
       def shutdown
         Legion::Logging.info 'Shutting down Legion::Cache'
-        close unless @using_local
-        Legion::Cache::Local.shutdown if Legion::Cache::Local.connected?
+        if @using_memory
+          Legion::Cache::Memory.shutdown
+        else
+          close unless @using_local
+          Legion::Cache::Local.shutdown if Legion::Cache::Local.connected?
+        end
         @using_local = false
+        @using_memory = false
         @connected = false
         Legion::Settings[:cache][:connected] = false
       end
@@ -42,30 +58,35 @@ module Legion
       end
 
       def get(key)
+        return Legion::Cache::Memory.get(key) if @using_memory
         return Legion::Cache::Local.get(key) if @using_local
 
         super
       end
 
       def set(key, value, ttl = 180)
+        return Legion::Cache::Memory.set(key, value, ttl) if @using_memory
         return Legion::Cache::Local.set(key, value, ttl) if @using_local
 
         super
       end
 
       def fetch(key, ttl = nil)
+        return Legion::Cache::Memory.fetch(key, ttl) if @using_memory
         return Legion::Cache::Local.fetch(key, ttl) if @using_local
 
         super
       end
 
       def delete(key)
+        return Legion::Cache::Memory.delete(key) if @using_memory
         return Legion::Cache::Local.delete(key) if @using_local
 
         super
       end
 
       def flush(delay = 0)
+        return Legion::Cache::Memory.flush(delay) if @using_memory
         return Legion::Cache::Local.flush(delay) if @using_local
 
         super

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-cache
 version: !ruby/object:Gem::Version
-  version: 1.3.10
+  version: 1.3.12
 platform: ruby
 authors:
 - Esity
@@ -101,8 +101,10 @@ files:
 - legion-cache.gemspec
 - lib/legion/cache.rb
 - lib/legion/cache/cacheable.rb
+- lib/legion/cache/helper.rb
 - lib/legion/cache/local.rb
 - lib/legion/cache/memcached.rb
+- lib/legion/cache/memory.rb
 - lib/legion/cache/pool.rb
 - lib/legion/cache/redis.rb
 - lib/legion/cache/settings.rb