legion-cache 1.3.16 → 1.3.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b737f804b6327030853b50a1c0fb76a5a06c8c26219ae23a0c0ac767a8d62d53
-  data.tar.gz: 31d960c23bea1c3426c476cce67ce30cee27879b2f3b917fdf98e02aa4d5670a
+  metadata.gz: 2d0de0aa53a2886b16a2d2e10bb18e37128a0e0d50d118d689c8f87aa15fcb72
+  data.tar.gz: 49387e7f795a779e595b700c2afe8eda19b7bc0e07273306ae57ca9ec71b2782
 SHA512:
-  metadata.gz: 1828c469b2d162eca345ca255e0489e98fee32249516552c922f56163c4066cb27364215b60a727af7c71b38f021f7d077107df826aadaafb95cbfd36ed04884
-  data.tar.gz: c4303cb9185f7d793fb4d383c690d7b48c90739a574ce2a03d0e1c93af6066cb62d6384738323336ccf3796c197cdd5f382b383e148537dafbccc165965d2670
+  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/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [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

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.16'
+    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'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-cache
 version: !ruby/object:Gem::Version
-  version: 1.3.16
+  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