stoplight 4.1.1 → 5.0.1

data/lib/stoplight/traffic_recovery/base.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Stoplight
+  module TrafficRecovery
+    # Strategies for determining how to recover traffic flow through the Stoplight.
+    # These strategies evaluate recovery metrics to decide which color the Stoplight should
+    # transition to during the recovery process.
+    #
+    # @example Creating a custom traffic recovery strategy
+    #   class GradualRecovery < Stoplight::TrafficRecovery::Base
+    #     def initialize(min_success_rate: 0.8, min_samples: 100)
+    #       @min_success_rate = min_success_rate
+    #       @min_samples = min_samples
+    #     end
+    #
+    #     def determine_color(config, metadata)
+    #       total_probes = metadata.recovery_probe_successes + metadata.recovery_probe_errors
+    #
+    #       if total_probes < @min_samples
+    #         return Color::YELLOW # Keep recovering, not enough samples
+    #       end
+    #
+    #       success_rate = metadata.recovery_probe_successes.fdiv(total_probes)
+    #       if success_rate >= @min_success_rate
+    #         Color::GREEN # Recovery successful
+    #       elsif success_rate <= 0.2
+    #         Color::RED # Recovery failed, too many errors
+    #       else
+    #         Color::YELLOW # Continue recovery
+    #       end
+    #     end
+    #   end
+    #
+    # @abstract
+    # @api private
+    class Base
+      # Determines the appropriate recovery state based on the Stoplight's
+      # current metrics and recovery progress.
+      #
+      # @param config [Stoplight::Light::Config]
+      # @param metadata [Stoplight::Metadata]
+      # @return [String] One of the Stoplight::Color constants:
+      #   - Stoplight::Color::RED: Recovery failed, block all traffic
+      #   - Stoplight::Color::YELLOW: Continue recovery process
+      #   - Stoplight::Color::GREEN: Recovery successful, return to normal traffic flow
+      def determine_color(config, metadata)
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/stoplight/traffic_recovery/single_success.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Stoplight
+  module TrafficRecovery
+    # A basic strategy that recovers traffic flow after a successful recovery probe.
+    #
+    # This strategy allows traffic to resume when a single successful probe
+    # occurs after the Stoplight has been in red state. It's a simple "one success and we're back"
+    # approach.
+    #
+    # @example Basic usage
+    #   config = Stoplight::Light::Config.new(cool_off_time: 60)
+    #   strategy = Stoplight::TrafficRecovery::SingleSuccess.new
+    #
+    # After the Stoplight turns red:
+    # - The Stoplight will wait for the cool-off period (60 seconds)
+    # - Then enter the recovery phase (YELLOW color)
+    # - The first successful probe will resume normal traffic flow (green color)
+    # @api private
+    class SingleSuccess < Base
+      # @param config [Stoplight::Light::Config]
+      # @param metadata [Stoplight::Metadata]
+      # @return [String]
+      def determine_color(config, metadata)
+        recovery_started_at = metadata.recovery_started_at || metadata.recovery_scheduled_after
+        last_success_at = metadata.last_success_at
+        if last_success_at && recovery_started_at <= last_success_at
+          Color::GREEN
+        else
+          Color::RED
+        end
+      end
+    end
+  end
+end

data/lib/stoplight/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stoplight
-  VERSION = Gem::Version.new('4.1.1')
+  VERSION = Gem::Version.new("5.0.1")
 end

data/lib/stoplight.rb

@@ -1,63 +1,123 @@
 # frozen_string_literal: true
 
-module Stoplight # rubocop:disable Style/Documentation
-  class << self
-    # @!attribute default_data_store
-    #   @return [DataStore::Base]
-    attr_accessor :default_data_store
-
-    # @!attribute default_notifiers
-    #   @return [Array<Notifier::Base>]
-    attr_accessor :default_notifiers
-
-    # @!attribute default_error_notifier
-    #   @return [Proc]
-    attr_accessor :default_error_notifier
-  end
-end
+require "zeitwerk"
 
-require 'stoplight/version'
+loader = Zeitwerk::Loader.for_gem
+loader.inflector.inflect("io" => "IO")
+loader.do_not_eager_load(
+  "#{__dir__}/stoplight/data_store",
+  "#{__dir__}/stoplight/admin",
+  "#{__dir__}/stoplight/admin.rb"
+)
+loader.ignore("#{__dir__}/stoplight/rspec.rb", "#{__dir__}/stoplight/rspec")
+loader.setup
 
-require 'stoplight/color'
-require 'stoplight/error'
-require 'stoplight/failure'
-require 'stoplight/state'
+module Stoplight # rubocop:disable Style/Documentation
+  CONFIG_MUTEX = Mutex.new
+  private_constant :CONFIG_MUTEX
 
-require 'stoplight/data_store'
-require 'stoplight/data_store/base'
-require 'stoplight/data_store/memory'
-require 'stoplight/data_store/redis'
+  class << self
+    ALREADY_CONFIGURED_WARNING = "Stoplight must be configured only once"
+    private_constant :ALREADY_CONFIGURED_WARNING
 
-require 'stoplight/notifier'
-require 'stoplight/notifier/base'
-require 'stoplight/notifier/generic'
+    # Configures the Stoplight library.
+    #
+    # This method allows you to set up the library's configuration using a block.
+    # It raises an error if called more than once.
+    #
+    # @yield [config] Provides a configuration object to the block.
+    # @yieldparam config [Stoplight::Config::ProgrammaticConfig] The configuration object.
+    # @raise [Stoplight::Error::ConfigurationError] If the library is already configured.
+    # @return [void]
+    #
+    # @example
+    #   Stoplight.configure do |config|
+    #     config.window_size = 14
+    #     config.data_store = Stoplight::DataStore::Redis.new(redis_client)
+    #     config.notifiers = [Stoplight::Notifier::IO.new($stdout)]
+    #     config.cool_off_time = 120
+    #     config.threshold = 5
+    #     config.tracked_errors = [StandardError]
+    #     config.skipped_errors = [RuntimeError]
+    #   end
+    #
+    # @note It is not recommended to call this method multiple times because after reconfiguring Stoplight
+    #   it will not be possible to change the configuration of existing circuit breakers. If you do so, the method
+    #   produces a warning:
+    #
+    #     "Stoplight reconfigured. Existing circuit breakers will not see the new configuration. New
+    #       configuration: #<Stoplight::Config::ConfigProvider cool_off_time=32, threshold=3, window_size=94, tracked_errors=StandardError, skipped_errors=NoMemoryError,ScriptError,SecurityError,SignalException,SystemExit,SystemStackError, data_store=Stoplight::DataStore::Memory>\n"
+    #
+    #   If you really know what you are doing, you can pass the +trust_me_im_an_engineer+ parameter as +true+ to
+    #   suppress this warning, which could be useful in test environments.
+    #
+    def configure(trust_me_im_an_engineer: false)
+      user_defaults = Config::UserDefaultConfig.new
+      yield(user_defaults) if block_given?
 
-require 'stoplight/notifier/io'
-require 'stoplight/notifier/logger'
+      reconfigured = !@config_provider.nil?
 
-require 'stoplight/default'
+      @config_provider = Config::ConfigProvider.new(
+        user_default_config: user_defaults.freeze,
+        library_default_config: Config::LibraryDefaultConfig.new
+      ).tap do
+        if reconfigured && !trust_me_im_an_engineer
+          warn(
+            "Stoplight reconfigured. Existing circuit breakers will not see new configuration. " \
+              "New configuration: #{@config_provider.inspect}"
+          )
+        end
+      end
+    end
 
-module Stoplight # rubocop:disable Style/Documentation
-  @default_data_store = Default::DATA_STORE
-  @default_notifiers = Default::NOTIFIERS
-  @default_error_notifier = Default::ERROR_NOTIFIER
+    # Retrieves the current configuration provider.
+    #
+    # @return [Stoplight::Config::ConfigProvider]
+    # @api private
+    def config_provider
+      CONFIG_MUTEX.synchronize do
+        @config_provider ||= configure
+      end
+    end
+  end
 end
 
-require 'stoplight/configurable'
-require 'stoplight/circuit_breaker'
-require 'stoplight/builder'
-require 'stoplight/configuration'
-require 'stoplight/light/lockable'
-require 'stoplight/light/runnable'
-require 'stoplight/light'
-
-# @return [Stoplight::CircuitBreaker]
-def Stoplight(name, &code) # rubocop:disable Naming/MethodName
-  if block_given?
-    warn '[DEPRECATED] Calling `Stoplight("name") { ... }` with a code block is deprecated. ' \
-      'Please pass code block to the run method `Stoplight("name").run { ... }` method instead.'
-    Stoplight::Builder.with(name: name).build(&code)
-  else
-    Stoplight::Builder.with(name: name)
-  end
+# Creates a new Stoplight circuit breaker with the given name and settings.
+#
+# @param name [String] The name of the circuit breaker.
+# @param settings [Hash] Optional settings to configure the circuit breaker.
+#   @option settings [Numeric] :cool_off_time The time to wait before resetting the circuit breaker.
+#   @option settings [Stoplight::DataStore::Base] :data_store The data store to use for storing state.
+#   @option settings [Proc] :error_notifier A proc to handle error notifications.
+#   @option settings [Array<Stoplight::Notifier::Base>] :notifiers A list of notifiers to use.
+#   @option settings [Numeric] :threshold The failure threshold to trip the circuit breaker.
+#   @option settings [Numeric] :window_size The size of the rolling window for failure tracking.
+#   @option settings [Array<StandardError>] :tracked_errors A list of errors to track.
+#   @option settings [Array<Exception>] :skipped_errors A list of errors to skip.
+#
+# @return [Stoplight::Light] A new circuit breaker instance.
+# @raise [ArgumentError] If an unknown option is provided in the settings.
+#
+# @example configure circuit breaker behavior
+#   light = Stoplight("Payment API", window_size: 300, threshold: 5, cool_off_time: 60)
+#
+# @example configure data store
+#   light = Stoplight("Payment API", data_store: Stoplight::DataStore::Redis.new(redis_client))
+#
+# In the example below, the +TimeoutError+ and +NetworkError+ exceptions
+# will be counted towards the threshold for moving the circuit breaker into the red state.
+# If not configured, the default tracked error is +StandardError+.
+#
+# @example configure tracked errors
+#   light = Stoplight("Payment API", tracked_errors: [TimeoutError, NetworkError])
+#
+# In the example below , the +ActiveRecord::RecordNotFound+ doesn't
+# move the circuit breaker into the red state.
+#
+# @example configure skipped errors
+#   light = Stoplight("Payment API", skipped_errors: [ActiveRecord::RecordNotFound])
+#
+def Stoplight(name, **settings) # rubocop:disable Naming/MethodName
+  config = Stoplight.config_provider.provide(name, **settings)
+  Stoplight::Light.new(config)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stoplight
 version: !ruby/object:Gem::Version
-  version: 4.1.1
+  version: 5.0.1
 platform: ruby
 authors:
 - Cameron Desautels
@@ -10,22 +10,22 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-08 00:00:00.000000000 Z
+date: 2025-06-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: redlock
+  name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0'
 description: An implementation of the circuit breaker pattern.
 email:
 - camdez@gmail.com
@@ -39,71 +39,62 @@ files:
 - LICENSE.md
 - README.md
 - lib/stoplight.rb
-- lib/stoplight/builder.rb
-- lib/stoplight/circuit_breaker.rb
+- lib/stoplight/admin.rb
+- lib/stoplight/admin/actions/action.rb
+- lib/stoplight/admin/actions/lock.rb
+- lib/stoplight/admin/actions/lock_all_green.rb
+- lib/stoplight/admin/actions/lock_green.rb
+- lib/stoplight/admin/actions/lock_red.rb
+- lib/stoplight/admin/actions/stats.rb
+- lib/stoplight/admin/actions/unlock.rb
+- lib/stoplight/admin/dependencies.rb
+- lib/stoplight/admin/helpers.rb
+- lib/stoplight/admin/lights_repository.rb
+- lib/stoplight/admin/lights_repository/light.rb
+- lib/stoplight/admin/lights_stats.rb
+- lib/stoplight/admin/views/_card.erb
+- lib/stoplight/admin/views/index.erb
+- lib/stoplight/admin/views/layout.erb
 - lib/stoplight/color.rb
-- lib/stoplight/configurable.rb
-- lib/stoplight/configuration.rb
+- lib/stoplight/config/config_provider.rb
+- lib/stoplight/config/library_default_config.rb
+- lib/stoplight/config/user_default_config.rb
 - lib/stoplight/data_store.rb
 - lib/stoplight/data_store/base.rb
+- lib/stoplight/data_store/fail_safe.rb
 - lib/stoplight/data_store/memory.rb
 - lib/stoplight/data_store/redis.rb
+- lib/stoplight/data_store/redis/get_metadata.lua
+- lib/stoplight/data_store/redis/lua.rb
+- lib/stoplight/data_store/redis/record_failure.lua
+- lib/stoplight/data_store/redis/record_success.lua
+- lib/stoplight/data_store/redis/transition_to_green.lua
+- lib/stoplight/data_store/redis/transition_to_red.lua
+- lib/stoplight/data_store/redis/transition_to_yellow.lua
 - lib/stoplight/default.rb
 - lib/stoplight/error.rb
 - lib/stoplight/failure.rb
 - lib/stoplight/light.rb
-- lib/stoplight/light/deprecated.rb
-- lib/stoplight/light/lockable.rb
-- lib/stoplight/light/runnable.rb
-- lib/stoplight/notifier.rb
+- lib/stoplight/light/config.rb
+- lib/stoplight/light/configuration_builder_interface.rb
+- lib/stoplight/light/green_run_strategy.rb
+- lib/stoplight/light/red_run_strategy.rb
+- lib/stoplight/light/run_strategy.rb
+- lib/stoplight/light/yellow_run_strategy.rb
+- lib/stoplight/metadata.rb
 - lib/stoplight/notifier/base.rb
+- lib/stoplight/notifier/fail_safe.rb
 - lib/stoplight/notifier/generic.rb
 - lib/stoplight/notifier/io.rb
 - lib/stoplight/notifier/logger.rb
 - lib/stoplight/rspec.rb
 - lib/stoplight/rspec/generic_notifier.rb
 - lib/stoplight/state.rb
+- lib/stoplight/traffic_control/base.rb
+- lib/stoplight/traffic_control/consecutive_failures.rb
+- lib/stoplight/traffic_recovery/base.rb
+- lib/stoplight/traffic_recovery/single_success.rb
 - lib/stoplight/version.rb
-- spec/spec_helper.rb
-- spec/stoplight/builder_spec.rb
-- spec/stoplight/circuit_breaker_spec.rb
-- spec/stoplight/color_spec.rb
-- spec/stoplight/configurable_spec.rb
-- spec/stoplight/data_store/base_spec.rb
-- spec/stoplight/data_store/memory_spec.rb
-- spec/stoplight/data_store/redis_spec.rb
-- spec/stoplight/data_store_spec.rb
-- spec/stoplight/default_spec.rb
-- spec/stoplight/error_spec.rb
-- spec/stoplight/failure_spec.rb
-- spec/stoplight/light/lockable_spec.rb
-- spec/stoplight/light/runnable_spec.rb
-- spec/stoplight/light_spec.rb
-- spec/stoplight/notifier/base_spec.rb
-- spec/stoplight/notifier/generic_spec.rb
-- spec/stoplight/notifier/io_spec.rb
-- spec/stoplight/notifier/logger_spec.rb
-- spec/stoplight/notifier_spec.rb
-- spec/stoplight/state_spec.rb
-- spec/stoplight/version_spec.rb
-- spec/stoplight_spec.rb
-- spec/support/configurable.rb
-- spec/support/data_store/base.rb
-- spec/support/data_store/base/clear_failures.rb
-- spec/support/data_store/base/clear_state.rb
-- spec/support/data_store/base/get_all.rb
-- spec/support/data_store/base/get_failures.rb
-- spec/support/data_store/base/get_state.rb
-- spec/support/data_store/base/names.rb
-- spec/support/data_store/base/record_failures.rb
-- spec/support/data_store/base/set_state.rb
-- spec/support/data_store/base/with_notification_lock.rb
-- spec/support/database_cleaner.rb
-- spec/support/exception_helpers.rb
-- spec/support/light/runnable.rb
-- spec/support/light/runnable/color.rb
-- spec/support/light/runnable/run.rb
-- spec/support/light/runnable/state.rb
 homepage: https://github.com/bolshakov/stoplight
 licenses:
 - MIT
@@ -116,55 +107,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.6
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.18
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Traffic control for code.
-test_files:
-- spec/spec_helper.rb
-- spec/stoplight/builder_spec.rb
-- spec/stoplight/circuit_breaker_spec.rb
-- spec/stoplight/color_spec.rb
-- spec/stoplight/configurable_spec.rb
-- spec/stoplight/data_store/base_spec.rb
-- spec/stoplight/data_store/memory_spec.rb
-- spec/stoplight/data_store/redis_spec.rb
-- spec/stoplight/data_store_spec.rb
-- spec/stoplight/default_spec.rb
-- spec/stoplight/error_spec.rb
-- spec/stoplight/failure_spec.rb
-- spec/stoplight/light/lockable_spec.rb
-- spec/stoplight/light/runnable_spec.rb
-- spec/stoplight/light_spec.rb
-- spec/stoplight/notifier/base_spec.rb
-- spec/stoplight/notifier/generic_spec.rb
-- spec/stoplight/notifier/io_spec.rb
-- spec/stoplight/notifier/logger_spec.rb
-- spec/stoplight/notifier_spec.rb
-- spec/stoplight/state_spec.rb
-- spec/stoplight/version_spec.rb
-- spec/stoplight_spec.rb
-- spec/support/configurable.rb
-- spec/support/data_store/base/clear_failures.rb
-- spec/support/data_store/base/clear_state.rb
-- spec/support/data_store/base/get_all.rb
-- spec/support/data_store/base/get_failures.rb
-- spec/support/data_store/base/get_state.rb
-- spec/support/data_store/base/names.rb
-- spec/support/data_store/base/record_failures.rb
-- spec/support/data_store/base/set_state.rb
-- spec/support/data_store/base/with_notification_lock.rb
-- spec/support/data_store/base.rb
-- spec/support/database_cleaner.rb
-- spec/support/exception_helpers.rb
-- spec/support/light/runnable/color.rb
-- spec/support/light/runnable/run.rb
-- spec/support/light/runnable/state.rb
-- spec/support/light/runnable.rb
+test_files: []

data/lib/stoplight/builder.rb

@@ -1,70 +0,0 @@
-# frozen_string_literal: true
-
-require 'forwardable'
-
-module Stoplight
-  # An interface to build Stoplight configuration. The builder is
-  # immutable, so it's safe to pass an instance of this builder
-  # across the code.
-  #
-  # @example
-  #   circuit_breaker = Stoplight('http_api')
-  #     .with_data_store(data_store)
-  #     .with_cool_off_time(60)
-  #     .with_threshold(5)
-  #     .with_window_size(3600)
-  #     .with_notifiers(notifiers)
-  #     .with_error_notifier(error_notifier) #=> <#Stoplight::Builder ..>
-  #
-  # It's safe to pass this +circuit_breaker+ around your code like this:
-  #
-  #     def call(circuit_breaker)
-  #       circuit_breaker.run { call_api }
-  #     end
-  #
-  # @api private use +Stoplight()+ method instead
-  class Builder
-    include CircuitBreaker
-    extend Forwardable
-
-    def_delegator :build, :with_error_handler
-    def_delegator :build, :with_fallback
-    def_delegator :build, :color
-    def_delegator :build, :name
-    def_delegator :build, :state
-    def_delegator :build, :run
-    def_delegator :build, :lock
-    def_delegator :build, :unlock
-
-    class << self
-      # @param settings [Hash]
-      #   @see +Stoplight::Configuration#initialize+
-      # @return [Stoplight::Builder]
-      def with(**settings)
-        new Configuration.new(**settings)
-      end
-    end
-
-    # @param [Stoplight::Configuration]
-    def initialize(configuration)
-      @configuration = configuration
-    end
-
-    # @return [Stoplight::Light]
-    def build(&code)
-      Light.new(configuration.name, configuration, &code)
-    end
-
-    # @param other [any]
-    # @return [Boolean]
-    def ==(other)
-      other.is_a?(self.class) && configuration == other.configuration
-    end
-
-    private
-
-    def reconfigure(configuration)
-      self.class.new(configuration)
-    end
-  end
-end

data/lib/stoplight/circuit_breaker.rb

@@ -1,102 +0,0 @@
-# frozen_string_literal: true
-
-module Stoplight
-  # @abstract
-  module CircuitBreaker
-    include Configurable
-
-    # Configures a custom proc that allows you to not to handle an error
-    # with Stoplight.
-    #
-    # @example
-    #   light = Stoplight('example')
-    #     .with_error_handler do |error, handler|
-    #       raise error if error.is_a?(ActiveRecord::RecordNotFound)
-    #       handle.call(error)
-    #     end
-    #   light.run { User.find(123) }
-    #
-    # In the example above, the +ActiveRecord::RecordNotFound+ doesn't
-    # move the circuit breaker into the red state.
-    #
-    # @yieldparam error [Exception]
-    # @yieldparam handle [Proc]
-    # @return [Stoplight::CircuitBreaker]
-    def with_error_handler(&error_handler)
-      raise NotImplementedError
-    end
-
-    # Configures light with the given fallback block
-    #
-    # @example
-    #   light = Stoplight('example')
-    #   light.with_fallback { |error| e.is_a?()ZeroDivisionError) ? 0 : nil }
-    #   light.run { 1 / 0} #=> 0
-    #
-    # @yieldparam error [Exception, nil]
-    # @return [Stoplight::CircuitBreaker]
-    def with_fallback(&fallback)
-      raise NotImplementedError
-    end
-
-    # @return [String] one of +locked_green+, +locked_red+, and +unlocked+
-    def state
-      raise NotImplementedError
-    end
-
-    # @return [String] the light's name
-    def name
-      raise NotImplementedError
-    end
-
-    # Returns current color:
-    #   * +Stoplight::Color::GREEN+ -- circuit breaker is closed
-    #   * +Stoplight::Color::RED+ -- circuit breaker is open
-    #   * +Stoplight::Color::YELLOW+ -- circuit breaker is half-open
-    #
-    # @example
-    #   light = Stoplight('example')
-    #   light.color #=> Color::GREEN
-    #
-    # @return [String] returns current light color
-    def color
-      raise NotImplementedError
-    end
-
-    # Runs the given block of code with this circuit breaker
-    #
-    # @example
-    #   light = Stoplight('example')
-    #   light.run { 2/0 }
-    #
-    # @raise [Stoplight::Error::RedLight]
-    # @return [any]
-    def run(&code)
-      raise NotImplementedError
-    end
-
-    # Locks light in either +State::LOCKED_RED+ or +State::LOCKED_GREEN+
-    #
-    # @example
-    #   light = Stoplight('example-locked')
-    #   light.lock(Stoplight::Color::RED)
-    #
-    # @param color [String] should be either +Color::RED+ or +Color::GREEN+
-    # @return [Stoplight::CircuitBreaker] returns locked circuit breaker
-    def lock(color)
-      raise NotImplementedError
-    end
-
-    # Unlocks light and sets it's state to State::UNLOCKED
-    #
-    # @example
-    #   light = Stoplight('example-locked')
-    #   light.lock(Stoplight::Color::RED)
-    #   light.unlock
-    #
-    # @return [Stoplight::CircuitBreaker] returns unlocked circuit breaker
-    def unlock
-      raise NotImplementedError
-    end
-  end
-end