magick-feature-flags 0.9.23 → 0.9.24

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0cae8aed5b88784ad2c7b2635b377cd17270044eea05e4f47a18bd3a209c9e3f
-  data.tar.gz: f2c69d41bd7a26010f25eee8e0088d660e90fdeb976de961192dcbc52c781c3d
+  metadata.gz: 9aaecf68655a77ae48f4f7b2d7f760528a4aa14aa5f37b5f8a603897e3040d40
+  data.tar.gz: 8b9694162f06fded4597aaadd14334c515f996979161915004ef113a979aba38
 SHA512:
-  metadata.gz: 7a184080f97332ecac03e71f3ae72791ed3a01389a05f84dfdab7d6588dca2a0e8da7c5c5f78b9dc7fee05c09ddbdb302bd8cc97e8a6af0b276e621a01331640
-  data.tar.gz: c51c09f333e04b46e980c8c6ff67d434611208d716757b53850d625630a48c73c6f4c961f091909ade1fd33d0170f0128111fefb1d1a181f9a012e77be2be1ab
+  metadata.gz: 4f47eaddee984442954a6a9f556c434469f8f9c923c93daa4971e232ff0b8ee248c96a510c505c3caecd99ed38687ec2a27544d8624837030a767b13b6253d0f
+  data.tar.gz: e2523e3c4051c6922638bdf6739eb3dc89e92822a1a93b0f542d6827bb5706a59d8de3bf2d56d1125584d5e20c016f92b3314b9f1f6ac047cab0ce828b00ad7d

data/README.md

@@ -10,7 +10,7 @@ A performant and memory-efficient feature toggle gem for Ruby and Rails applicat
 - **Rails Integration**: Seamless integration with Rails, including request store caching
 - **DSL Support**: Define features in a Ruby DSL file (`config/features.rb`)
 - **Thread-Safe**: All operations are thread-safe for concurrent access
-- **Performance**: Optimized for speed with memory-first caching strategy
+- **Performance**: Lightning-fast feature checks with async metrics recording and memory-first caching strategy
 - **Advanced Features**: Circuit breaker, audit logging, performance metrics, versioning, and more
 
 ## Installation
@@ -52,7 +52,8 @@ The generator creates `config/initializers/magick.rb` with sensible defaults. Yo
 ```ruby
 Magick.configure do
   # Configure Redis (optional)
-  redis url: ENV['REDIS_URL']
+  # Use database 1 by default to avoid conflicts with Rails cache (which uses DB 0)
+  redis url: ENV['REDIS_URL'], db: 1
 
   # Enable features
   performance_metrics enabled: true
@@ -73,7 +74,10 @@ Magick.configure do
   memory_ttl 7200 # 2 hours
 
   # Redis configuration
-  redis url: ENV['REDIS_URL'], namespace: 'magick:features'
+  # Use separate database (DB 1) to avoid conflicts with Rails cache (DB 0)
+  # This ensures feature toggles persist even when Rails cache is cleared
+  redis url: ENV['REDIS_URL'], namespace: 'magick:features', db: 1
+  # Or include database in URL: redis url: 'redis://localhost:6379/1'
 
   # Circuit breaker settings
   circuit_breaker threshold: 5, timeout: 60
@@ -383,7 +387,9 @@ Magick.configure do
 end
 ```
 
-**Note:** When `redis_tracking: true` is set, usage counts are persisted to Redis and aggregated across all processes, giving you total usage statistics.
+**Performance:** Metrics are recorded asynchronously in a background thread, ensuring zero overhead on feature checks. The `enabled?` method remains lightning-fast even with metrics enabled.
+
+**Note:** When `redis_tracking: true` is set, usage counts are persisted to Redis and aggregated across all processes, giving you total usage statistics. Metrics are automatically flushed in batches to minimize Redis overhead.
 
 #### Audit Logging
 
@@ -424,6 +430,9 @@ With Redis configured:
 - ✅ Persistent storage across restarts
 - ✅ Zero Redis calls on feature checks (only memory lookups)
 - ✅ Automatic cache invalidation when features change in any process
+- ✅ **Isolated from Rails cache** - Use `db: 1` to store feature toggles in a separate Redis database, ensuring they persist even when Rails cache is cleared
+
+**Important:** By default, Magick uses Redis database 1 to avoid conflicts with Rails cache (which typically uses database 0). This ensures that clearing Rails cache (`Rails.cache.clear`) won't affect your feature toggle states.
 
 ### Feature Types
 

data/lib/magick/config.rb

@@ -3,7 +3,7 @@
 module Magick
   class Config
     attr_accessor :adapter_registry, :performance_metrics, :audit_log, :versioning, :warn_on_deprecated,
-                  :async_updates, :memory_ttl, :circuit_breaker_threshold, :circuit_breaker_timeout, :redis_url, :redis_namespace, :environment
+                  :async_updates, :memory_ttl, :circuit_breaker_threshold, :circuit_breaker_timeout, :redis_url, :redis_namespace, :redis_db, :environment
 
     def initialize
       @warn_on_deprecated = false
@@ -12,6 +12,7 @@ module Magick
       @circuit_breaker_threshold = 5
       @circuit_breaker_timeout = 60
       @redis_namespace = 'magick:features'
+      @redis_db = nil # Use default database (0) unless specified
       @environment = defined?(Rails) ? Rails.env.to_s : 'development'
     end
 
@@ -38,10 +39,11 @@ module Magick
       configure_memory_adapter(**options)
     end
 
-    def redis(url: nil, namespace: nil, **options)
+    def redis(url: nil, namespace: nil, db: nil, **options)
       @redis_url = url if url
       @redis_namespace = namespace if namespace
-      redis_adapter = configure_redis_adapter(url: url, namespace: namespace, **options)
+      @redis_db = db if db
+      redis_adapter = configure_redis_adapter(url: url, namespace: namespace, db: db, **options)
 
       # Automatically create Registry adapter if it doesn't exist
       # This allows users to just call `redis url: ...` without needing to call `adapter :registry`
@@ -161,17 +163,33 @@ module Magick
       adapter
     end
 
-    def configure_redis_adapter(url: nil, namespace: nil, client: nil)
+    def configure_redis_adapter(url: nil, namespace: nil, db: nil, client: nil)
       return nil unless defined?(Redis)
 
       url ||= @redis_url
       namespace ||= @redis_namespace
+      db ||= @redis_db
 
       redis_client = client || begin
+        redis_options = {}
+
         if url
-          ::Redis.new(url: url)
+          # Parse URL to extract database number if present
+          parsed_url = URI.parse(url) rescue nil
+          db_from_url = nil
+          if parsed_url && parsed_url.path && parsed_url.path.length > 1
+            # Redis URL format: redis://host:port/db_number
+            db_from_url = parsed_url.path[1..-1].to_i
+          end
+
+          # Use db parameter if provided, otherwise use db from URL, otherwise nil (default DB 0)
+          final_db = db || db_from_url
+          redis_options[:db] = final_db if final_db
+          redis_options[:url] = url
+          ::Redis.new(redis_options)
         else
-          ::Redis.new
+          redis_options[:db] = db if db
+          ::Redis.new(redis_options)
         end
       rescue StandardError
         nil
@@ -179,6 +197,20 @@ module Magick
 
       return nil unless redis_client
 
+      # If db was specified but not in URL, select it explicitly
+      # This handles cases where URL doesn't include db number
+      if db && url
+        parsed_url = URI.parse(url) rescue nil
+        url_has_db = parsed_url && parsed_url.path && parsed_url.path.length > 1
+        unless url_has_db
+          begin
+            redis_client.select(db)
+          rescue StandardError
+            # Ignore if SELECT fails (some Redis setups don't support SELECT, e.g., Redis Cluster)
+          end
+        end
+      end
+
       adapter = Adapters::Redis.new(redis_client)
       adapter.instance_variable_set(:@namespace, namespace) if namespace
       adapter

data/lib/magick/rails/railtie.rb

@@ -25,7 +25,13 @@ if defined?(Rails)
               if defined?(Redis)
                 begin
                   redis_url = app.config.respond_to?(:redis_url) ? app.config.redis_url : nil
-                  redis_client = redis_url ? ::Redis.new(url: redis_url) : ::Redis.new
+                  # Use database 1 for Magick by default to avoid conflicts with Rails cache (which uses DB 0)
+                  # Users can override this in their config/initializers/magick.rb
+                  redis_db = 1
+                  redis_options = {}
+                  redis_options[:url] = redis_url if redis_url
+                  redis_options[:db] = redis_db
+                  redis_client = redis_url ? ::Redis.new(redis_options) : ::Redis.new(db: redis_db)
                   memory_adapter = Adapters::Memory.new
                   redis_adapter = Adapters::Redis.new(redis_client)
                   magick.adapter_registry = Adapters::Registry.new(memory_adapter, redis_adapter)

data/lib/magick/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Magick
-  VERSION = '0.9.23'
+  VERSION = '0.9.24'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: magick-feature-flags
 version: !ruby/object:Gem::Version
-  version: 0.9.23
+  version: 0.9.24
 platform: ruby
 authors:
 - Andrew Lobanov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-24 00:00:00.000000000 Z
+date: 2025-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec