legion-cache 1.3.15 → 1.3.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d143549258e7e7a2ec8d3ff702a724eb98648582a442c594bd8df360f8fd1c5
-  data.tar.gz: cff229d7de54b78aa9b3995a8fa9d5877e059ab32059fadb786b786357fbebaf
+  metadata.gz: 2d0de0aa53a2886b16a2d2e10bb18e37128a0e0d50d118d689c8f87aa15fcb72
+  data.tar.gz: 49387e7f795a779e595b700c2afe8eda19b7bc0e07273306ae57ca9ec71b2782
 SHA512:
-  metadata.gz: 073ea47e6e2c886388fa980f490cf395bbfe3be1a90129cc3d804ea5df36d7c8ee814e725e1bcaae94b35d840c0729b47ab5181d5c7f12581e2c3664d76a74b3
-  data.tar.gz: 82599629d8df3d385c96001321e55c123670154cbc72e243ded365d4f22d93dc085e19bfa2605fb377fab69e0be21291d46937450702d1b4a70860e41d06efde
+  metadata.gz: af05e3b8f771a81307f9c3fb81c6dcb6a9fad154bd127660d71a9e645c44636fb1317ef70db618fa5e139fb617d012747bb477017226b829cc5d26ff3db6cd5a
+  data.tar.gz: 0e31e8c387e44ff1c8e4089cabd04536df39e373cbc38bc90dc1beba85b080d92d77887ee1f4faccf4ef96bb0a02bc51d43bdebda53231e627d26f57e014775f

data/.github/CODEOWNERS

@@ -0,0 +1,7 @@
+# Auto-generated from team-config.yml
+# Team: core
+#
+# To apply: scripts/apply-codeowners.sh legion-cache
+
+* @LegionIO/maintainers
+* @LegionIO/core

data/.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+  - package-ecosystem: bundler
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    labels:
+      - "type:dependencies"
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    labels:
+      - "type:dependencies"

data/.github/workflows/ci.yml

@@ -3,6 +3,8 @@ on:
   push:
     branches: [main]
   pull_request:
+  schedule:
+    - cron: '0 9 * * 1'
 
 jobs:
   ci:
@@ -11,9 +13,25 @@ jobs:
       needs-redis: true
       needs-memcached: true
 
+  lint:
+    uses: LegionIO/.github/.github/workflows/lint-patterns.yml@main
+
+  security:
+    uses: LegionIO/.github/.github/workflows/security-scan.yml@main
+
+  version-changelog:
+    uses: LegionIO/.github/.github/workflows/version-changelog.yml@main
+
+  dependency-review:
+    uses: LegionIO/.github/.github/workflows/dependency-review.yml@main
+
+  stale:
+    if: github.event_name == 'schedule'
+    uses: LegionIO/.github/.github/workflows/stale.yml@main
+
   release:
-    needs: ci
+    needs: [ci, lint]
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     uses: LegionIO/.github/.github/workflows/release.yml@main
     secrets:
-      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}
+      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [Unreleased]
+
+## [1.3.17] - 2026-03-25
+
+### Added
+- `Legion::Cache::RedisHash` module: Redis hash and sorted-set operations (`hset`, `hgetall`, `hdel`, `zadd`, `zrangebyscore`, `zrem`, `expire`) with `redis_available?` guard and safe defaults when Redis is not connected
+- Auto-required from `legion/cache.rb` alongside the existing Redis adapter
+
+## [1.3.16] - 2026-03-25
+
+### Fixed
+- Accept ttl as positional or keyword argument in Cache.set for caller flexibility
+- Align Redis.set signature to positional ttl arg matching parent module convention
+
 ## [1.3.15] - 2026-03-24
 
 ### Added

data/CLAUDE.md

@@ -56,7 +56,7 @@ Legion::Cache (singleton module)
 - **Driver Selection at Load Time**: `Legion::Settings[:cache][:driver]` determines which module gets `extend`ed into `Legion::Cache` (`'redis'` or `'dalli'`)
 - **Connection Pooling**: Both drivers use `connection_pool` gem for thread-safe access
 - **Unified Interface**: Same `get`/`set`/`delete`/`flush`/`connected?`/`shutdown` methods regardless of backend
-- **TTL Signature Difference**: Memcached `set(key, value, ttl)` uses a positional TTL (default 180s); Redis `set(key, value, ttl: nil)` uses a keyword TTL
+- **Uniform TTL Signature**: All backends use `set(key, value, ttl)` with a positional TTL argument (Memcached default 180s, Redis/Memory/Local default nil)
 
 ### Two-Tier Cache Architecture
 

data/README.md

@@ -31,8 +31,8 @@ Legion::Cache.fetch('foobar')  # => 'testing' (get with block support)
 Legion::Cache.delete('foobar') # => true
 Legion::Cache.flush            # flush all keys
 
-# Redis driver — TTL is a keyword argument
-Legion::Cache.set('foobar', 'testing', ttl: 10)
+# Redis driver — TTL is the third positional argument
+Legion::Cache.set('foobar', 'testing', 10)
 Legion::Cache.get('foobar')    # => 'testing'
 Legion::Cache.delete('foobar') # => true
 Legion::Cache.flush            # flushdb

data/lib/legion/cache/redis.rb

@@ -68,7 +68,7 @@ module Legion
       end
       alias fetch get
 
-      def set(key, value, ttl: nil)
+      def set(key, value, ttl = nil)
         args = {}
         args[:ex] = ttl unless ttl.nil?
         result = client.with { |conn| conn.set(key, value, **args) == 'OK' }

data/lib/legion/cache/redis_hash.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+module Legion
+  module Cache
+    module RedisHash
+      module_function
+
+      # Returns true when the Redis driver is loaded and the connection pool is live.
+      def redis_available?
+        pool = Legion::Cache.instance_variable_get(:@client)
+        return false if pool.nil?
+
+        Legion::Cache.connected?
+      rescue StandardError
+        false
+      end
+
+      # Set hash fields from a Ruby Hash.
+      # Uses Redis HSET key field value [field value ...]
+      def hset(key, hash)
+        return false unless redis_available?
+
+        Legion::Cache.instance_variable_get(:@client).with do |conn|
+          flat = hash.flat_map { |k, v| [k.to_s, v.to_s] }
+          conn.hset(key, *flat)
+        end
+        true
+      rescue StandardError => e
+        log_redis_error('hset', e)
+        false
+      end
+
+      # Returns a Ruby Hash (string keys) of all field-value pairs for the key.
+      def hgetall(key)
+        return nil unless redis_available?
+
+        Legion::Cache.instance_variable_get(:@client).with do |conn|
+          conn.hgetall(key)
+        end
+      rescue StandardError => e
+        log_redis_error('hgetall', e)
+        nil
+      end
+
+      # Delete one or more hash fields.
+      def hdel(key, *fields)
+        return 0 unless redis_available?
+
+        Legion::Cache.instance_variable_get(:@client).with do |conn|
+          conn.hdel(key, *fields)
+        end
+      rescue StandardError => e
+        log_redis_error('hdel', e)
+        0
+      end
+
+      # Add a member to a sorted set with the given score.
+      def zadd(key, score, member)
+        return false unless redis_available?
+
+        Legion::Cache.instance_variable_get(:@client).with do |conn|
+          conn.zadd(key, score.to_f, member.to_s)
+        end
+        true
+      rescue StandardError => e
+        log_redis_error('zadd', e)
+        false
+      end
+
+      # Range query on a sorted set by score. Returns an array of members.
+      # limit: accepts [offset, count] array matching Redis LIMIT semantics.
+      def zrangebyscore(key, min, max, limit: nil)
+        return [] unless redis_available?
+
+        opts = {}
+        opts[:limit] = limit if limit
+
+        Legion::Cache.instance_variable_get(:@client).with do |conn|
+          conn.zrangebyscore(key, min, max, **opts)
+        end
+      rescue StandardError => e
+        log_redis_error('zrangebyscore', e)
+        []
+      end
+
+      # Remove a member from a sorted set.
+      def zrem(key, member)
+        return false unless redis_available?
+
+        Legion::Cache.instance_variable_get(:@client).with do |conn|
+          conn.zrem(key, member.to_s)
+        end
+        true
+      rescue StandardError => e
+        log_redis_error('zrem', e)
+        false
+      end
+
+      # Set a TTL (in seconds) on a key.
+      def expire(key, seconds)
+        return false unless redis_available?
+
+        Legion::Cache.instance_variable_get(:@client).with do |conn|
+          conn.expire(key, seconds.to_i) == 1
+        end
+      rescue StandardError => e
+        log_redis_error('expire', e)
+        false
+      end
+
+      def log_redis_error(method, error)
+        return unless defined?(Legion::Logging)
+
+        Legion::Logging.warn "[cache:redis_hash] #{method} failed: #{error.class} — #{error.message}"
+      end
+    end
+  end
+end

data/lib/legion/cache/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Cache
-    VERSION = '1.3.15'
+    VERSION = '1.3.17'
   end
 end

data/lib/legion/cache.rb

@@ -6,6 +6,7 @@ require 'legion/cache/cacheable'
 
 require 'legion/cache/memcached'
 require 'legion/cache/redis'
+require 'legion/cache/redis_hash'
 require 'legion/cache/memory'
 require 'legion/cache/local'
 require 'legion/cache/helper'
@@ -79,8 +80,9 @@ module Legion
         [ttl, max].min
       end
 
-      def set(key, value, ttl = 180, **)
-        effective_ttl = enforce_phi_ttl(ttl, **)
+      def set(key, value, ttl = nil, **opts)
+        ttl = opts.delete(:ttl) || ttl || 180
+        effective_ttl = enforce_phi_ttl(ttl, **opts)
         return Legion::Cache::Memory.set(key, value, effective_ttl) if @using_memory
         return Legion::Cache::Local.set(key, value, effective_ttl) if @using_local
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-cache
 version: !ruby/object:Gem::Version
-  version: 1.3.15
+  version: 1.3.17
 platform: ruby
 authors:
 - Esity
@@ -90,6 +90,8 @@ extra_rdoc_files:
 - LICENSE
 - README.md
 files:
+- ".github/CODEOWNERS"
+- ".github/dependabot.yml"
 - ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rubocop.yml"
@@ -107,6 +109,7 @@ files:
 - lib/legion/cache/memory.rb
 - lib/legion/cache/pool.rb
 - lib/legion/cache/redis.rb
+- lib/legion/cache/redis_hash.rb
 - lib/legion/cache/settings.rb
 - lib/legion/cache/version.rb
 - sonar-project.properties