legion-cache 1.3.12 → 1.3.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84f54b95a9a31607080afb2afbad2e85d713cb2d24b0a126dd97cea864d443a6
-  data.tar.gz: 0be1410d11a82efb137f050b7236f6e7d8cde91d4d75cf1275c0ccc22fbc1ed7
+  metadata.gz: bb361d980bfc1761a6ea272c5225a1a1c33389ea8a15f87a1496354fb6f62390
+  data.tar.gz: f70347db3d1b7c2e849d7b31b3c456c992f776d9db0f16d801d1c0cb824160bb
 SHA512:
-  metadata.gz: e581d3e4d49937215c091f309939985b174516a5fa78619e499bc5a2d01e6ac389c438fcf5bdc63d883ca72b08bc082e0926f88ffbc7fbae2578198ca6aad954
-  data.tar.gz: a1618ccbad942d1c73bb0f549a6485f2883371b67d9bd3beded87aa58eb71bcdf092579c1d640afa80e3e98567c49e4e5cd6e4cd40f1bc0cf179ee188f219688
+  metadata.gz: 4b96a2ebb1066ace5026f7376e3c6e2788d9a744dd28e675d01e37539b02ad9cad5e18b9dd69172f2986b28742659b205d9e23708b0c1d0885a64149a1e80a4f
+  data.tar.gz: 4b45f7bc7d8ccca724d41e86899365db9ee08e1357052e70b46620752e0a91916f47372c33d11ae6ab38967c8f3ea028c2f25ee3687a29dfc0560bfb49e84f9b

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [1.3.13] - 2026-03-24
+
+### Changed
+- Reindex docs: update CLAUDE.md and README with Memory adapter and Helper mixin docs
+
 ## [1.3.12] - 2026-03-24
 
 ### Added

data/CLAUDE.md

@@ -8,14 +8,14 @@
 Caching wrapper for the LegionIO framework. Provides a consistent interface for Memcached (via `dalli`) and Redis (via `redis` gem) with connection pooling. Driver selection is config-driven.
 
 **GitHub**: https://github.com/LegionIO/legion-cache
-**Version**: 1.3.0
+**Version**: 1.3.12
 **License**: Apache-2.0
 
 ## Architecture
 
 ```
 Legion::Cache (singleton module)
-├── .setup(**opts)          # Connect to cache backend
+├── .setup(**opts)          # Connect to cache backend (auto-detects LEGION_MODE=lite -> Memory adapter)
 ├── .get(key)               # Retrieve cached value
 ├── .fetch(key, ttl)        # Get with block/TTL support (Memcached only; alias for get on Redis)
 ├── .set(key, value, ttl)   # Store value with optional TTL (positional on Memcached, keyword on Redis)
@@ -25,9 +25,10 @@ Legion::Cache (singleton module)
 ├── .size                   # Total pool connections
 ├── .available              # Idle pool connections
 ├── .restart(**opts)        # Close and reconnect pool with optional new opts
-├── .shutdown               # Close connections, mark disconnected
+├── .shutdown               # Close connections, mark disconnected (handles Memory adapter)
 ├── .local                  # Accessor for Legion::Cache::Local
 ├── .using_local?           # Whether fallback to local is active
+├── .using_memory?          # Whether Memory adapter (lite mode) is active
 │
 ├── Memcached               # Dalli-based Memcached driver (default)
 │   └── Uses connection_pool for thread safety
@@ -35,6 +36,9 @@ Legion::Cache (singleton module)
 ├── Redis                   # Redis driver
 │   └── Uses connection_pool for thread safety
 │   └── Default pool_size is 20 (Memcached default is 10)
+├── Memory                  # Lite mode adapter: pure in-memory cache, TTL expiry, Mutex thread-safety
+│   └── Activated by LEGION_MODE=lite env var; no Redis/Memcached required
+├── Helper                  # Injectable cache mixin for LEX extensions (namespaced cache_*/local_cache_*)
 ├── Local                   # Local cache tier (localhost Redis/Memcached, fallback target)
 │   ├── .setup              # Connect to local cache server (auto-detect driver)
 │   ├── .shutdown           # Close local connection
@@ -124,9 +128,11 @@ Dalli enforces a 1MB client-side limit by default (`value_max_bytes: 1_048_576`)
 
 | Path | Purpose |
 |------|---------|
-| `lib/legion/cache.rb` | Module entry, driver selection, setup/shutdown, fallback wiring |
+| `lib/legion/cache.rb` | Module entry, driver selection, setup/shutdown, fallback wiring, Memory adapter activation |
 | `lib/legion/cache/memcached.rb` | Dalli/Memcached driver implementation |
 | `lib/legion/cache/redis.rb` | Redis driver implementation |
+| `lib/legion/cache/memory.rb` | Lite mode Memory adapter: in-memory store with TTL + Mutex thread-safety |
+| `lib/legion/cache/helper.rb` | Injectable cache mixin for LEX extensions |
 | `lib/legion/cache/local.rb` | Local cache tier (localhost, fallback target) |
 | `lib/legion/cache/pool.rb` | Connection pool management |
 | `lib/legion/cache/settings.rb` | Default configuration + local defaults |

data/README.md

@@ -2,7 +2,7 @@
 
 Caching wrapper for the [LegionIO](https://github.com/LegionIO/LegionIO) framework. Provides a consistent interface for Memcached (via `dalli`) and Redis (via `redis` gem) with connection pooling. Driver selection is config-driven.
 
-**Version**: 1.3.2
+**Version**: 1.3.12
 
 ## Installation
 
@@ -40,6 +40,20 @@ Legion::Cache.flush            # flushdb
 Legion::Cache.shutdown
 ```
 
+## Lite Mode (No Infrastructure)
+
+When `LEGION_MODE=lite` is set, `Legion::Cache` activates the pure in-memory `Memory` adapter, bypassing Redis and Memcached entirely:
+
+```ruby
+ENV['LEGION_MODE'] = 'lite'
+Legion::Cache.setup
+Legion::Cache.using_memory?   # => true
+Legion::Cache.set('key', 'value', 60)
+Legion::Cache.get('key')      # => 'value'
+```
+
+The Memory adapter is thread-safe (Mutex), supports TTL expiry, and exposes the same `get`/`set`/`fetch`/`delete`/`flush` interface. Shutdown cleanly tears it down.
+
 ## Two-Tier Cache
 
 Legion::Cache supports a two-tier architecture: a shared remote cluster and a local per-machine cache. If the shared cluster is unreachable at setup, all operations transparently fall back to local.

data/lib/legion/cache/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-cache
 version: !ruby/object:Gem::Version
-  version: 1.3.12
+  version: 1.3.13
 platform: ruby
 authors:
 - Esity