rollout-redis-adapter 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf83c825545efedafc1178bb65a87f6a8efdf94da42818aaad99342c7b58d750
-  data.tar.gz: 1391230d545262e09d4e02b40419c2f6ece6d45a0475862e53b1bf085d3b3935
+  metadata.gz: c4c44183a42a826a4a8d96d018caa891dcd43519700ff309dbb83c8aab1df4ec
+  data.tar.gz: e6bedd04a653fe34fc060d5a0eeb57a195fb68c87442ca419795ef4998b02ab0
 SHA512:
-  metadata.gz: 4c677217147be1281238fc328cf7063f40cdfe44084dc128746321f127e0d0c0d41290cca725e2dc2177fe642bb2196cf901a341d5a2e70121afe1190f372754
-  data.tar.gz: 0c170c12b556cacce684a044a27958e8033aa73d406a8c225cfb04cbbf47bbe54b01acb63e4b9cdba80ab4008e71c91e168955ae146bfdd789b970d9a6ece307
+  metadata.gz: 7601f9edbd29fb598348964a1b081b0de79899d604fc370b029550635c0020ff9ba411b3cec6dd42b4788e0f6cc20db3cbfc6a231913042cd8d53be8b3112af2
+  data.tar.gz: 4e1af966e074998263b6c8d8d27be904b5ebbfc40fa711d10d53f93bf791711065bfd2394a092917f45dfb80c6eeb38c6ff92ae9c4b231e29b0b1d480761289e

data/lib/rollout/adapters/redis.rb

@@ -4,6 +4,7 @@ require 'redis'
 require 'rollout'
 require 'rollout/logging'
 require 'rollout/redis/codec'
+require 'rollout/redis/feature_export'
 
 class Rollout
   module Adapters
@@ -54,6 +55,21 @@ class Rollout
         @client.del(FEATURES_KEY)
       end
 
+      def export_features(include_history: false)
+        registered = feature_names.map(&:to_s).reject { |name| name.empty? }.uniq
+        stored = stored_feature_names
+        missing_names = (registered - stored).sort
+        unregistered_names = (stored - registered).sort
+        present = registered - missing_names
+
+        ::Rollout::Redis::FeatureExport.new(
+          states: fetch_features(present),
+          missing_names: missing_names,
+          unregistered_names: unregistered_names,
+          history: include_history ? export_history : [],
+        )
+      end
+
       def mutate_feature(name)
         mutation = yield fetch_feature(name)
         save_feature(mutation.fetch(:state))
@@ -89,7 +105,7 @@ class Rollout
 
       def feature_updated_at(name)
         _, score = @client.zrange(events_key(name), 0, 0, with_scores: true).first
-        Time.at(-score.to_f / 1_000_000) if score
+        ::Rollout::Redis::Codec.time_from_score(score) if score
       end
 
       def delete_feature_events(name)
@@ -98,6 +114,85 @@ class Rollout
 
       private
 
+      def stored_feature_names
+        names = []
+        @client.scan_each(match: 'feature:*') do |raw_key|
+          key = raw_key.to_s
+          next if key == FEATURES_KEY
+          next if key.end_with?(':logging:events')
+
+          names << key.sub(/\Afeature:/, '')
+        end
+        names.uniq
+      end
+
+      def export_history
+        feature_members = []
+        global_members = {}
+        seen_keys = {}
+
+        @client.scan_each(match: 'feature:*:logging:events') do |raw_key|
+          key = raw_key.to_s
+          next if seen_keys[key]
+
+          seen_keys[key] = true
+          if key == global_events_key
+            zrange_pairs(key).each do |member, score|
+              global_members[member] = score
+            end
+          else
+            name = history_feature_name(key)
+            next if name.nil? || name == '_global_'
+
+            zrange_pairs(key).each do |member, score|
+              feature_members << [member, score]
+            end
+          end
+        end
+
+        seen = {}
+        rows = []
+        feature_members.each do |member, score|
+          seen[member] = true
+          rows << [member, score, true, !global_members[member].nil?]
+        end
+        global_members.each do |member, score|
+          next if seen[member]
+
+          rows << [member, score, false, true]
+        end
+
+        sort_history_rows(rows).map do |member, score, feature_visible, global_visible|
+          history_entry(member, score, feature_visible, global_visible)
+        end
+      end
+
+      def history_feature_name(key)
+        return nil unless key.start_with?('feature:') && key.end_with?(':logging:events')
+
+        key.sub(/\Afeature:/, '').sub(/:logging:events\z/, '')
+      end
+
+      def zrange_pairs(key)
+        pairs = @client.zrange(key, 0, -1, with_scores: true)
+        return [] if pairs.nil? || pairs.empty?
+        return pairs if pairs.first.is_a?(Array)
+
+        pairs.each_slice(2).to_a
+      end
+
+      def history_entry(member, score, feature_visible, global_visible)
+        ::Rollout::Redis::FeatureExport::HistoryEntry.new(
+          event: ::Rollout::Redis::Codec.decode_event(member, score),
+          feature_visible: feature_visible,
+          global_visible: global_visible,
+        )
+      end
+
+      def sort_history_rows(rows)
+        rows.sort_by { |member, score, _feature_visible, _global_visible| [score, member] }.reverse
+      end
+
       def key(name)
         "feature:#{name}"
       end

data/lib/rollout/redis/codec.rb

@@ -37,7 +37,11 @@ class Rollout
       def self.decode_event(value, score)
         hash = JSON.parse(value, symbolize_names: true)
 
-        Logging::Event.new(**hash.merge(created_at: Time.at(-score.to_f / 1_000_000)))
+        Logging::Event.new(**hash.merge(created_at: time_from_score(score)))
+      end
+
+      def self.time_from_score(score)
+        Time.at(Rational(-score.to_i, 1_000_000))
       end
     end
   end

data/lib/rollout/redis/feature_export.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+class Rollout
+  module Redis
+    class FeatureExport
+      class HistoryEntry
+        attr_reader :event, :feature_visible, :global_visible
+
+        def initialize(event:, feature_visible:, global_visible:)
+          @event = event
+          @feature_visible = feature_visible
+          @global_visible = global_visible
+        end
+      end
+
+      attr_reader :states, :missing_names, :unregistered_names, :history
+
+      def initialize(states:, missing_names:, unregistered_names:, history: [])
+        @states = states
+        @missing_names = missing_names
+        @unregistered_names = unregistered_names
+        @history = history
+      end
+
+      def valid?
+        missing_names.empty? && unregistered_names.empty?
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rollout-redis-adapter
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - FetLife
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-15 00:00:00.000000000 Z
+date: 2026-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redis
@@ -61,6 +61,7 @@ files:
 - lib/rollout-redis-adapter.rb
 - lib/rollout/adapters/redis.rb
 - lib/rollout/redis/codec.rb
+- lib/rollout/redis/feature_export.rb
 homepage: https://github.com/FetLife/rollout
 licenses:
 - MIT