philiprehberger-feature_flag 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f93e18c3bfdce3ba46b83aa08594796a3b394c6991bc60a8084de865d36c03d9
-  data.tar.gz: 6a3cf44dee1303fa16c0068a9d8f3a9b8f84671c3f023a6b39be30da3c191662
+  metadata.gz: d9ab240ee6674acbd17dd987934bbf0f8e43b70904412fa7320c15bf87ca85fd
+  data.tar.gz: 5b95143bed4e182588d273c81961e8de3e0eb9ebe38ef3514ec5ffd14e47f12f
 SHA512:
-  metadata.gz: 9646249f3c0e7c534cdd32fe96e71383c4d914fb141973e44b0509162a0d1a13c7e6731085eb5b549fe747eff23a0ff6cc61de946ac63fa50c536e0863d9c773
-  data.tar.gz: 474d240fd9fe19a245f10534e812d0dbaaad2ccc587c04dc86374750158442fe64e152c780f7be8fd5609c2e6da0c0047eaa48277cfef64acc0eec643399bf24
+  metadata.gz: 3e024c67a8ffba1e6277c499f33b553339c3c2868cf52069aec8c4d4a3be82b7b0879a6fd858524b0b8e21b3d1d41b90710c0832a4ad080ba1bccb99119e1655
+  data.tar.gz: 296f281debc07bd19bcf65325f46446d9bae166479c6e733d7b5bae7408a1a2ae94fdd781e510aeb052049f7a9add0524fc67fe11e7761d78b86d340af2f56fa

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-04-26
+
+### Added
+- `FeatureFlag.reset_all!` — clear all registered flags, overrides, and metrics in one call (intended for test cleanup)
+- `FeatureFlag.flags` — list registered flag names
+
 ## [0.4.0] - 2026-04-23
 
 ### Added

data/README.md

@@ -221,7 +221,10 @@ export FEATURE_DARK_MODE=true
 export FEATURE_BETA_SEARCH=false
 ```
 
-### Test helper
+### Test Helpers
+
+`with` scopes a single override to a block — the original value is restored
+when the block exits.
 
 ```ruby
 Philiprehberger::FeatureFlag.with(:dark_mode, true) do
@@ -231,6 +234,23 @@ end
 # original value restored after block
 ```
 
+`reset_all!` clears every piece of registry state — backend-stored flags,
+overrides, metrics, dependencies, schedules, targets, and groups. Pair it
+with `flags` to assert a clean slate at the start of each example.
+
+```ruby
+RSpec.configure do |config|
+  config.before(:each) { Philiprehberger::FeatureFlag.reset_all! }
+end
+
+# In a spec
+Philiprehberger::FeatureFlag.configuration.backend.set(:dark_mode, true)
+Philiprehberger::FeatureFlag.flags # => [:dark_mode]
+
+Philiprehberger::FeatureFlag.reset_all!
+Philiprehberger::FeatureFlag.flags # => []
+```
+
 ### Reloading
 
 ```ruby
@@ -263,6 +283,8 @@ flags.flag_names
 | `.with(flag, value) { }` | Override a flag in a block |
 | `.reload!` | Reload flags from the backend |
 | `.reset!` | Reset configuration and overrides |
+| `.reset_all!` | Reset every piece of registry state (flags, overrides, metrics, dependencies, schedules, targets, groups) — intended for test cleanup |
+| `.flags` | List registered flag names (alias of `.flag_names`) |
 | `.flag_names` | Sorted, deduplicated list of all known flag names |
 | `.depends_on(flag, requires:)` | Declare a flag dependency |
 | `.schedule(flag, enable_at:, disable_at:)` | Schedule flag activation window |

data/lib/philiprehberger/feature_flag/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module FeatureFlag
-    VERSION = '0.4.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/feature_flag.rb

@@ -127,6 +127,36 @@ module Philiprehberger
         reset_groups!
       end
 
+      # Fully reset every piece of registry state — backend-stored flags,
+      # in-flight overrides, recorded metrics, dependencies, schedules,
+      # targets, context predicates, and groups. Intended for use in test
+      # suites (e.g. +before(:each) { FeatureFlag.reset_all! }+) so each
+      # example starts from a clean slate. Safe to call when nothing is
+      # registered.
+      #
+      # @return [void]
+      def reset_all!
+        @configuration = nil
+        @overrides = nil
+        reset_dependencies!
+        reset_schedules!
+        reset_metrics!
+        reset_targets!
+        reset_groups!
+        nil
+      end
+
+      # Return the array of registered flag names. A flag is considered
+      # registered when it has been stored on the backend or referenced by
+      # any of the dependency, schedule, targeting, or group subsystems.
+      # Equivalent to {.flag_names} — kept as a shorter alias for callers
+      # that want the registered list without thinking about ordering.
+      #
+      # @return [Array<Symbol>] sorted, deduplicated registered flag names
+      def flags
+        flag_names
+      end
+
       private
 
       def backend_flag_names

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-feature_flag
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-23 00:00:00.000000000 Z
+date: 2026-04-27 00:00:00.000000000 Z
 dependencies: []
 description: A lightweight feature flag library supporting in-memory, ENV, and YAML
   backends with percentage rollout and A/B variant support.