rollout 2.6.2 → 3.1.0

data/spec/spec_helper.rb

@@ -5,23 +5,82 @@ require 'simplecov'
 SimpleCov.start
 
 require 'bundler/setup'
-require 'redis'
 require 'rollout'
 
-$redis = Redis.new(
-  host: ENV.fetch('REDIS_HOST', '127.0.0.1'),
-  port: ENV.fetch('REDIS_PORT', '6379'),
-  db: ENV.fetch('REDIS_DB', '7'),
-)
+class RolloutMemoryBackend
+  def initialize
+    @features = {}
+    @events = Hash.new { |hash, key| hash[key] = [] }
+  end
+
+  def fetch_feature(name)
+    state = @features[name.to_s]
+    return Rollout::FeatureState.new(name: name, percentage: 0) unless state
+
+    state.deep_clone
+  end
+
+  def fetch_features(names)
+    names.map { |name| fetch_feature(name) }
+  end
+
+  def feature_names
+    @features.keys
+  end
+
+  def feature_exists?(name)
+    @features.key?(name.to_s)
+  end
+
+  def save_feature(state)
+    @features[state.name] = state.deep_clone
+  end
+
+  def delete_feature(name)
+    @features.delete(name.to_s)
+  end
+
+  def clear_features
+  end
+
+  def mutate_feature(name)
+    mutation = yield fetch_feature(name)
+    save_feature(mutation.fetch(:state))
+    event = mutation[:event]
+    @events[name.to_s] << event if event
+    mutation
+  end
+
+  def feature_events(name, limit: nil)
+    limited_events(@events[name.to_s], limit)
+  end
+
+  def global_events(limit: nil)
+    limited_events([], limit)
+  end
+
+  def feature_updated_at(_name)
+  end
+
+  def delete_feature_events(name)
+    @events.delete(name.to_s)
+  end
+
+  private
+
+  def limited_events(events, limit)
+    return events if limit.nil?
+    raise ArgumentError, "limit must be an Integer" unless limit.is_a?(Integer)
+    raise ArgumentError, "limit must be >= 0" if limit < 0
+
+    events.last(limit)
+  end
+end
 
 RSpec.configure do |config|
   config.example_status_persistence_file_path = '.rspec_status'
 
-  # config.disable_monkey_patching!
-
   config.expect_with :rspec do |c|
     c.syntax = :expect
   end
-
-  config.before { $redis.flushdb }
 end

data/spec/support/backend_contract.rb

@@ -0,0 +1,88 @@
+require "date"
+
+RSpec.shared_examples "a rollout feature backend" do
+  def empty_state(name)
+    Rollout::FeatureState.new(name: name, percentage: 0)
+  end
+
+  def json_metadata
+    {
+      "description" => "New navigation",
+      "updated_at" => 1,
+      "enabled" => true,
+      "ratio" => 0.5,
+      "owner" => nil,
+      "label" => :beta,
+      "released_at" => Time.utc(2026, 1, 1),
+      "day" => Date.new(2026, 1, 1),
+      "labels" => ["a", { "nested" => :ok }],
+    }
+  end
+
+  it "returns an empty state for a missing feature" do
+    state = backend.fetch_feature(:chat)
+
+    expect(state).to eq empty_state(:chat)
+  end
+
+  it "preserves fetch_features order and duplicates" do
+    backend.save_feature(Rollout::FeatureState.new(name: :chat, percentage: 25))
+
+    states = backend.fetch_features([:chat, :missing, :chat])
+
+    expect(states.map(&:name)).to eq %w[chat missing chat]
+    expect(states.map(&:percentage)).to eq [25.0, 0.0, 25.0]
+  end
+
+  it "returns no features for an empty fetch_features request" do
+    expect(backend.fetch_features([])).to eq []
+  end
+
+  it "does not share nested data with a fetched state" do
+    backend.save_feature(
+      Rollout::FeatureState.new(name: :chat, percentage: 0, data: { "labels" => ["a"] }),
+    )
+
+    backend.fetch_feature(:chat).data["labels"] << "b"
+
+    expect(backend.fetch_feature(:chat).data).to eq("labels" => ["a"])
+  end
+
+  it "does not share nested data with a saved state" do
+    state = Rollout::FeatureState.new(name: :chat, percentage: 0, data: { "labels" => ["a"] })
+    backend.save_feature(state)
+
+    state.data["labels"] << "b"
+
+    expect(backend.fetch_feature(:chat).data).to eq("labels" => ["a"])
+  end
+
+  it "returns the same canonical metadata after save_feature" do
+    state = Rollout::FeatureState.new(name: :chat, percentage: 0, data: json_metadata)
+    backend.save_feature(state)
+
+    expect(backend.fetch_feature(:chat)).to eq state
+    expect(state.data["label"]).to eq "beta"
+    expect(state.data["labels"]).to eq ["a", { "nested" => "ok" }]
+  end
+
+  it "tracks existence and names after save and delete" do
+    backend.save_feature(Rollout::FeatureState.new(name: :chat, percentage: 25))
+
+    expect(backend.feature_exists?(:chat)).to be_truthy
+    expect(backend.feature_names).to eq ["chat"]
+
+    backend.delete_feature(:chat)
+
+    expect(backend.feature_exists?(:chat)).to be_falsey
+    expect(backend.fetch_feature(:chat)).to eq empty_state(:chat)
+  end
+
+  it "does not persist when mutate_feature's block raises" do
+    expect {
+      backend.mutate_feature(:chat) { raise "nope" }
+    }.to raise_error("nope")
+
+    expect(backend.feature_exists?(:chat)).to be_falsey
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rollout
 version: !ruby/object:Gem::Version
-  version: 2.6.2
+  version: 3.1.0
 platform: ruby
 authors:
 - James Golick
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-06 00:00:00.000000000 Z
+date: 2026-09-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: observer
@@ -24,26 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: redis
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '4.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '6'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '4.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '6'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -64,14 +44,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '2.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -142,14 +122,13 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: '0.17'
-description: Feature flippers with redis.
+description: Feature flippers.
 email:
 - jamesgolick@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".circleci/config.yml"
 - ".github/workflows/release.yml"
 - ".github/workflows/test.yml"
 - ".gitignore"
@@ -161,15 +140,20 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- docs/upgrading-to-v3.md
 - lib/rollout.rb
 - lib/rollout/feature.rb
+- lib/rollout/feature_state.rb
 - lib/rollout/logging.rb
 - lib/rollout/version.rb
 - rollout.gemspec
 - spec/rollout/feature_spec.rb
+- spec/rollout/feature_state_spec.rb
 - spec/rollout/logging_spec.rb
+- spec/rollout/memory_backend_contract_spec.rb
 - spec/rollout_spec.rb
 - spec/spec_helper.rb
+- spec/support/backend_contract.rb
 homepage: https://github.com/FetLife/rollout
 licenses:
 - MIT
@@ -189,9 +173,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project:
-rubygems_version: 2.5.1
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Feature flippers with redis.
+summary: Feature flippers.
 test_files: []

data/.circleci/config.yml

@@ -1,119 +0,0 @@
-version: 2.1
-
-workflows:
-  main:
-    jobs:
-      - ruby33
-      - ruby31
-      - ruby32
-      - ruby30
-      - ruby27
-      - ruby26
-      - ruby25
-      - ruby24
-
-executors:
-  ruby33:
-    docker:
-      - image: cimg/ruby:3.3
-      - image: cimg/redis:7.2
-  ruby32:
-    docker:
-      - image: cimg/ruby:3.2
-      - image: cimg/redis:7.2
-  ruby31:
-    docker:
-      - image: cimg/ruby:3.1
-      - image: cimg/redis:7.2
-  ruby30:
-    docker:
-      - image: cimg/ruby:3.0
-      - image: cimg/redis:7.2
-  ruby27:
-    docker:
-      - image: cimg/ruby:2.7
-      - image: cimg/redis:7.2
-  ruby26:
-    docker:
-      - image: cimg/ruby:2.7
-      - image: cimg/redis:7.2
-  ruby25:
-    docker:
-      - image: cimg/ruby:2.7
-      - image: cimg/redis:7.2
-  ruby24:
-    docker:
-      - image: cimg/ruby:2.4
-      - image: cimg/redis:7.2
-
-commands:
-  test:
-    steps:
-      - run:
-          name: Bundle Install
-          command: bundle check --path vendor/bundle || bundle install
-
-      - run:
-          name: Run rspec
-          command: |
-            bundle exec rspec --format documentation --format RspecJunitFormatter --out test_results/rspec.xml
-
-jobs:
-  ruby33:
-    executor: ruby33
-    steps:
-      - checkout
-      - test
-
-      - run:
-          name: Report Test Coverage
-          command: |
-            wget https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 -O cc-test-reporter
-            chmod +x cc-test-reporter
-            ./cc-test-reporter format-coverage -t simplecov -o coverage/codeclimate.json coverage/.resultset.json
-            ./cc-test-reporter upload-coverage -i coverage/codeclimate.json
-
-      - store_test_results:
-          path: test_results
-
-  ruby32:
-    executor: ruby30
-    steps:
-      - checkout
-      - test
-
-  ruby31:
-    executor: ruby30
-    steps:
-      - checkout
-      - test
-
-  ruby30:
-    executor: ruby30
-    steps:
-      - checkout
-      - test
-
-  ruby27:
-    executor: ruby27
-    steps:
-      - checkout
-      - test
-
-  ruby26:
-    executor: ruby27
-    steps:
-      - checkout
-      - test
-
-  ruby25:
-    executor: ruby27
-    steps:
-      - checkout
-      - test
-
-  ruby24:
-    executor: ruby24
-    steps:
-      - checkout
-      - test