stoplight 5.4.0 → 5.5.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stoplight
 version: !ruby/object:Gem::Version
-  version: 5.4.0
+  version: 5.5.0
 platform: ruby
 authors:
 - Cameron Desautels
@@ -57,51 +57,61 @@ files:
 - lib/stoplight/admin/views/_card.erb
 - lib/stoplight/admin/views/index.erb
 - lib/stoplight/admin/views/layout.erb
-- lib/stoplight/color.rb
-- lib/stoplight/config/compatibility_result.rb
-- lib/stoplight/config/dsl.rb
-- lib/stoplight/config/library_default_config.rb
-- lib/stoplight/config/system_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/memory/sliding_window.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/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/domain/color.rb
+- lib/stoplight/domain/compatibility_result.rb
+- lib/stoplight/domain/config.rb
+- lib/stoplight/domain/data_store.rb
+- lib/stoplight/domain/error.rb
+- lib/stoplight/domain/failure.rb
+- lib/stoplight/domain/light.rb
+- lib/stoplight/domain/light/configuration_builder_interface.rb
+- lib/stoplight/domain/light_factory.rb
+- lib/stoplight/domain/metadata.rb
+- lib/stoplight/domain/state.rb
+- lib/stoplight/domain/state_transition_notifier.rb
+- lib/stoplight/domain/strategies/green_run_strategy.rb
+- lib/stoplight/domain/strategies/red_run_strategy.rb
+- lib/stoplight/domain/strategies/run_strategy.rb
+- lib/stoplight/domain/strategies/yellow_run_strategy.rb
+- lib/stoplight/domain/tracker/base.rb
+- lib/stoplight/domain/tracker/recovery_probe.rb
+- lib/stoplight/domain/tracker/request.rb
+- lib/stoplight/domain/traffic_control/base.rb
+- lib/stoplight/domain/traffic_control/consecutive_errors.rb
+- lib/stoplight/domain/traffic_control/error_rate.rb
+- lib/stoplight/domain/traffic_recovery.rb
+- lib/stoplight/domain/traffic_recovery/base.rb
+- lib/stoplight/domain/traffic_recovery/consecutive_successes.rb
+- lib/stoplight/infrastructure/data_store/memory.rb
+- lib/stoplight/infrastructure/data_store/memory/sliding_window.rb
+- lib/stoplight/infrastructure/data_store/redis.rb
+- lib/stoplight/infrastructure/data_store/redis/get_metadata.lua
+- lib/stoplight/infrastructure/data_store/redis/lua.rb
+- lib/stoplight/infrastructure/data_store/redis/record_failure.lua
+- lib/stoplight/infrastructure/data_store/redis/record_success.lua
+- lib/stoplight/infrastructure/data_store/redis/transition_to_green.lua
+- lib/stoplight/infrastructure/data_store/redis/transition_to_red.lua
+- lib/stoplight/infrastructure/data_store/redis/transition_to_yellow.lua
+- lib/stoplight/infrastructure/dependency_injection/container.rb
+- lib/stoplight/infrastructure/dependency_injection/unresolved_dependency_error.rb
+- lib/stoplight/infrastructure/notifier/generic.rb
+- lib/stoplight/infrastructure/notifier/io.rb
+- lib/stoplight/infrastructure/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_errors.rb
-- lib/stoplight/traffic_control/error_rate.rb
-- lib/stoplight/traffic_recovery.rb
-- lib/stoplight/traffic_recovery/base.rb
-- lib/stoplight/traffic_recovery/consecutive_successes.rb
 - lib/stoplight/version.rb
+- lib/stoplight/wiring/container.rb
+- lib/stoplight/wiring/default.rb
+- lib/stoplight/wiring/default_configuration.rb
+- lib/stoplight/wiring/default_factory_builder.rb
+- lib/stoplight/wiring/fail_safe_data_store.rb
+- lib/stoplight/wiring/fail_safe_notifier.rb
+- lib/stoplight/wiring/light/default_config.rb
+- lib/stoplight/wiring/light/system_config.rb
+- lib/stoplight/wiring/light_factory.rb
+- lib/stoplight/wiring/public_api.rb
+- lib/stoplight/wiring/system_container.rb
+- lib/stoplight/wiring/system_light_factory.rb
 homepage: https://github.com/bolshakov/stoplight
 licenses:
 - MIT

data/lib/stoplight/color.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-module Stoplight
-  module Color
-    GREEN = "green"
-    YELLOW = "yellow"
-    RED = "red"
-  end
-end

data/lib/stoplight/config/dsl.rb

@@ -1,97 +0,0 @@
-# frozen_string_literal: true
-
-module Stoplight
-  module Config
-    # This is a DSL for configuring Stoplight settings. It is responsible for
-    # transforming the provided settings into a format that can be used by Stoplight.
-    #
-    # @api private
-    class DSL
-      def transform(settings)
-        if settings.has_key?(:data_store)
-          settings[:data_store] = build_data_store(settings[:data_store])
-        end
-
-        if settings.has_key?(:notifiers)
-          settings[:notifiers] = build_notifiers(settings[:notifiers])
-        end
-
-        if settings.has_key?(:tracked_errors)
-          settings[:tracked_errors] = build_tracked_errors(settings[:tracked_errors])
-        end
-
-        if settings.has_key?(:skipped_errors)
-          settings[:skipped_errors] = build_skipped_errors(settings[:skipped_errors])
-        end
-
-        if settings.has_key?(:cool_off_time)
-          settings[:cool_off_time] = build_cool_off_time(settings[:cool_off_time])
-        end
-
-        if settings.has_key?(:traffic_control)
-          settings[:traffic_control] = build_traffic_control(settings[:traffic_control])
-        end
-
-        if settings.has_key?(:traffic_recovery)
-          settings[:traffic_recovery] = build_traffic_recovery(settings[:traffic_recovery])
-        end
-        settings
-      end
-
-      private
-
-      def build_data_store(data_store)
-        DataStore::FailSafe.wrap(data_store)
-      end
-
-      def build_notifiers(notifiers)
-        notifiers.map { |notifier| Notifier::FailSafe.wrap(notifier) }
-      end
-
-      def build_tracked_errors(tracked_error)
-        Array(tracked_error)
-      end
-
-      def build_skipped_errors(skipped_errors)
-        Array(skipped_errors)
-      end
-
-      def build_cool_off_time(cool_off_time)
-        cool_off_time.to_i
-      end
-
-      def build_traffic_control(traffic_control)
-        case traffic_control
-        in Stoplight::TrafficControl::Base
-          traffic_control
-        in :consecutive_errors
-          Stoplight::TrafficControl::ConsecutiveErrors.new
-        in :error_rate
-          Stoplight::TrafficControl::ErrorRate.new
-        in {error_rate: error_rate_settings}
-          Stoplight::TrafficControl::ErrorRate.new(**error_rate_settings)
-        else
-          raise Error::ConfigurationError, <<~ERROR
-            unsupported traffic_control strategy provided (`#{traffic_control}`). Supported options:
-              * Stoplight::TrafficControl::ConsecutiveErrors
-              * Stoplight::TrafficControl::ErrorRate
-          ERROR
-        end
-      end
-
-      def build_traffic_recovery(traffic_recovery)
-        case traffic_recovery
-        in Stoplight::TrafficRecovery::Base
-          traffic_recovery
-        in :consecutive_successes
-          Stoplight::TrafficRecovery::ConsecutiveSuccesses.new
-        else
-          raise Error::ConfigurationError, <<~ERROR
-            unsupported traffic_recovery strategy provided (`#{traffic_recovery}`). Supported options:
-              * Stoplight::TrafficRecovery::ConsecutiveSuccesses
-          ERROR
-        end
-      end
-    end
-  end
-end

data/lib/stoplight/config/library_default_config.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-module Stoplight
-  module Config
-    # Provides default settings for the Stoplight library.
-    # @api private
-    LibraryDefaultConfig = Light::Config.empty.with(
-      cool_off_time: Stoplight::Default::COOL_OFF_TIME,
-      data_store: Stoplight::Default::DATA_STORE,
-      error_notifier: Stoplight::Default::ERROR_NOTIFIER,
-      notifiers: Stoplight::Default::NOTIFIERS,
-      threshold: Stoplight::Default::THRESHOLD,
-      recovery_threshold: Stoplight::Default::RECOVERY_THRESHOLD,
-      window_size: Stoplight::Default::WINDOW_SIZE,
-      tracked_errors: Stoplight::Default::TRACKED_ERRORS,
-      skipped_errors: Stoplight::Default::SKIPPED_ERRORS,
-      traffic_control: Stoplight::Default::TRAFFIC_CONTROL,
-      traffic_recovery: Stoplight::Default::TRAFFIC_RECOVERY
-    )
-  end
-end

data/lib/stoplight/config/system_config.rb

@@ -1,10 +0,0 @@
-# frozen_string_literal: true
-
-module Stoplight
-  module Config
-    SystemConfig = LibraryDefaultConfig.with(
-      traffic_recovery: :consecutive_successes,
-      recovery_threshold: 3
-    )
-  end
-end

data/lib/stoplight/data_store/memory/sliding_window.rb

@@ -1,77 +0,0 @@
-# frozen_string_literal: true
-
-module Stoplight
-  module DataStore
-    class Memory < Base
-      # Hash-based sliding window for O(1) amortized operations.
-      #
-      # Maintains a running sum and stores per-second counts in a Hash. Ruby's Hash
-      # preserves insertion order (FIFO), allowing efficient removal of expired
-      # buckets from the front via +Hash#shift+, with their counts subtracted from
-      # the running sum.
-      #
-      # Performance: O(1) amortized for both reads and writes
-      # Memory: Bounded to the number of buckets
-      #
-      # @note Not thread-safe; synchronization must be handled externally
-      # @api private
-      class SlidingWindow
-        # @!attribute buckets
-        #   @return [Hash<Integer, Integer>] A hash mapping time buckets to their counts
-        private attr_reader :buckets
-
-        # @!attribute running_sum
-        #   @return [Integer] The running sum of all increments in the current window
-        private attr_accessor :running_sum
-
-        def initialize
-          @buckets = Hash.new { |buckets, bucket| buckets[bucket] = 0 }
-          @running_sum = 0
-        end
-
-        # Increment the count at a given timestamp
-        def increment
-          buckets[current_bucket] += 1
-          self.running_sum += 1
-        end
-
-        # @param window_start [Time]
-        # @return [Integer]
-        def sum_in_window(window_start)
-          slide_window!(window_start)
-          self.running_sum
-        end
-
-        private def slide_window!(window_start)
-          window_start_ts = window_start.to_i
-
-          loop do
-            timestamp, sum = buckets.first
-            if timestamp.nil? || timestamp >= window_start_ts
-              break
-            else
-              self.running_sum -= sum
-              buckets.shift
-            end
-          end
-        end
-
-        private def current_bucket
-          bucket_for_time(current_time)
-        end
-
-        private def bucket_for_time(time)
-          time.to_i
-        end
-
-        private def current_time
-          Time.now
-        end
-
-        def inspect
-          "#<#{self.class.name} #{buckets}>"
-        end
-      end
-    end
-  end
-end

data/lib/stoplight/data_store/memory.rb

@@ -1,285 +0,0 @@
-# frozen_string_literal: true
-
-require "monitor"
-
-module Stoplight
-  module DataStore
-    # @see Base
-    class Memory < Base
-      include MonitorMixin
-
-      KEY_SEPARATOR = ":"
-
-      def initialize
-        @errors = Hash.new { |errors, light_name| errors[light_name] = SlidingWindow.new }
-        @successes = Hash.new { |successes, light_name| successes[light_name] = SlidingWindow.new }
-
-        @recovery_probe_errors = Hash.new { |recovery_probe_errors, light_name| recovery_probe_errors[light_name] = SlidingWindow.new }
-        @recovery_probe_successes = Hash.new { |recovery_probe_successes, light_name| recovery_probe_successes[light_name] = SlidingWindow.new }
-
-        @metadata = Hash.new { |h, k| h[k] = Metadata.new }
-        super # MonitorMixin
-      end
-
-      # @return [Array<String>]
-      def names
-        synchronize { @metadata.keys }
-      end
-
-      # @param config [Stoplight::Light::Config]
-      # @return [Stoplight::Metadata]
-      def get_metadata(config)
-        light_name = config.name
-
-        synchronize do
-          current_time = self.current_time
-          recovery_window_start = (current_time - config.cool_off_time)
-          recovered_at = @metadata[light_name].recovered_at
-          window_start = if config.window_size
-            [recovered_at, (current_time - config.window_size)].compact.max
-          else
-            current_time
-          end
-
-          @metadata[light_name].with(
-            current_time:,
-            errors: @errors[config.name].sum_in_window(window_start),
-            successes: @successes[config.name].sum_in_window(window_start),
-            recovery_probe_errors: @recovery_probe_errors[config.name].sum_in_window(recovery_window_start),
-            recovery_probe_successes: @recovery_probe_successes[config.name].sum_in_window(recovery_window_start)
-          )
-        end
-      end
-
-      # @param config [Stoplight::Light::Config]
-      # @param failure [Stoplight::Failure]
-      # @return [Stoplight::Metadata]
-      def record_failure(config, failure)
-        current_time = self.current_time
-        light_name = config.name
-
-        synchronize do
-          @errors[light_name].increment if config.window_size
-
-          metadata = @metadata[light_name]
-          @metadata[light_name] = if metadata.last_error_at.nil? || current_time > metadata.last_error_at
-            metadata.with(
-              last_error_at: current_time,
-              last_error: failure,
-              consecutive_errors: metadata.consecutive_errors.succ,
-              consecutive_successes: 0
-            )
-          else
-            metadata.with(
-              consecutive_errors: metadata.consecutive_errors.succ,
-              consecutive_successes: 0
-            )
-          end
-          get_metadata(config)
-        end
-      end
-
-      # @param config [Stoplight::Light::Config]
-      # @return [void]
-      def record_success(config)
-        light_name = config.name
-        current_time = self.current_time
-
-        synchronize do
-          @successes[light_name].increment if config.window_size
-
-          metadata = @metadata[light_name]
-          @metadata[light_name] = if metadata.last_success_at.nil? || current_time > metadata.last_success_at
-            metadata.with(
-              last_success_at: current_time,
-              consecutive_errors: 0,
-              consecutive_successes: metadata.consecutive_successes.succ
-            )
-          else
-            metadata.with(
-              consecutive_errors: 0,
-              consecutive_successes: metadata.consecutive_successes.succ
-            )
-          end
-        end
-      end
-
-      # @param config [Stoplight::Light::Config]
-      # @param failure [Stoplight::Failure]
-      # @return [Stoplight::Metadata]
-      def record_recovery_probe_failure(config, failure)
-        light_name = config.name
-        current_time = self.current_time
-
-        synchronize do
-          @recovery_probe_errors[light_name].increment
-
-          metadata = @metadata[light_name]
-          @metadata[light_name] = if metadata.last_error_at.nil? || current_time > metadata.last_error_at
-            metadata.with(
-              last_error_at: current_time,
-              last_error: failure,
-              consecutive_errors: metadata.consecutive_errors.succ,
-              consecutive_successes: 0
-            )
-          else
-            metadata.with(
-              consecutive_errors: metadata.consecutive_errors.succ,
-              consecutive_successes: 0
-            )
-          end
-          get_metadata(config)
-        end
-      end
-
-      # @param config [Stoplight::Light::Config]
-      # @return [Stoplight::Metadata]
-      def record_recovery_probe_success(config)
-        light_name = config.name
-        current_time = self.current_time
-
-        synchronize do
-          @recovery_probe_successes[light_name].increment
-
-          metadata = @metadata[light_name]
-          @metadata[light_name] = if metadata.last_success_at.nil? || current_time > metadata.last_success_at
-            metadata.with(
-              last_success_at: current_time,
-              consecutive_errors: 0,
-              consecutive_successes: metadata.consecutive_successes.succ
-            )
-          else
-            metadata.with(
-              consecutive_errors: 0,
-              consecutive_successes: metadata.consecutive_successes.succ
-            )
-          end
-          get_metadata(config)
-        end
-      end
-
-      # @param config [Stoplight::Light::Config]
-      # @param state [String]
-      # @return [String]
-      def set_state(config, state)
-        light_name = config.name
-
-        synchronize do
-          metadata = @metadata[light_name]
-          @metadata[light_name] = metadata.with(locked_state: state)
-        end
-        state
-      end
-
-      # @return [String]
-      def inspect
-        "#<#{self.class.name}>"
-      end
-
-      # Combined method that performs the state transition based on color
-      #
-      # @param config [Stoplight::Light::Config] The light configuration
-      # @param color [String] The color to transition to ("GREEN", "YELLOW", or "RED")
-      # @return [Boolean] true if this is the first instance to detect this transition
-      def transition_to_color(config, color)
-        case color
-        when Color::GREEN
-          transition_to_green(config)
-        when Color::YELLOW
-          transition_to_yellow(config)
-        when Color::RED
-          transition_to_red(config)
-        else
-          raise ArgumentError, "Invalid color: #{color}"
-        end
-      end
-
-      # Transitions to GREEN state and ensures only one notification
-      #
-      # @param config [Stoplight::Light::Config] The light configuration
-      # @return [Boolean] true if this is the first instance to detect this transition
-      private def transition_to_green(config)
-        light_name = config.name
-        current_time = self.current_time
-
-        synchronize do
-          metadata = @metadata[light_name]
-          if metadata.recovered_at
-            false
-          else
-            @metadata[light_name] = metadata.with(
-              recovered_at: current_time,
-              recovery_started_at: nil,
-              breached_at: nil,
-              recovery_scheduled_after: nil
-            )
-            true
-          end
-        end
-      end
-
-      # Transitions to YELLOW (recovery) state and ensures only one notification
-      #
-      # @param config [Stoplight::Light::Config] The light configuration
-      # @return [Boolean] true if this is the first instance to detect this transition
-      private def transition_to_yellow(config)
-        light_name = config.name
-        current_time = self.current_time
-
-        synchronize do
-          metadata = @metadata[light_name]
-          if metadata.recovery_started_at.nil?
-            @metadata[light_name] = metadata.with(
-              recovery_started_at: current_time,
-              recovery_scheduled_after: nil,
-              recovered_at: nil,
-              breached_at: nil
-            )
-            true
-          else
-            @metadata[light_name] = metadata.with(
-              recovery_scheduled_after: nil,
-              recovered_at: nil,
-              breached_at: nil
-            )
-            false
-          end
-        end
-      end
-
-      # Transitions to RED state and ensures only one notification
-      #
-      # @param config [Stoplight::Light::Config] The light configuration
-      # @return [Boolean] true if this is the first instance to detect this transition
-      private def transition_to_red(config)
-        light_name = config.name
-        current_time = self.current_time
-        recovery_scheduled_after = current_time + config.cool_off_time
-
-        synchronize do
-          metadata = @metadata[light_name]
-          if metadata.breached_at
-            @metadata[light_name] = metadata.with(
-              recovery_scheduled_after: recovery_scheduled_after,
-              recovery_started_at: nil,
-              recovered_at: nil
-            )
-            false
-          else
-            @metadata[light_name] = metadata.with(
-              breached_at: current_time,
-              recovery_scheduled_after: recovery_scheduled_after,
-              recovery_started_at: nil,
-              recovered_at: nil
-            )
-            true
-          end
-        end
-      end
-
-      private def current_time
-        Time.now
-      end
-    end
-  end
-end

data/lib/stoplight/data_store/redis/lua.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module Stoplight
-  module DataStore
-    class Redis
-      # @api private
-      module Lua
-        class << self
-          def read_lua_file(name_without_extension)
-            File.read(File.join(__dir__, "#{name_without_extension}.lua"))
-          end
-        end
-
-        RECORD_FAILURE = read_lua_file("record_failure")
-        RECORD_SUCCESS = read_lua_file("record_success")
-        GET_METADATA = read_lua_file("get_metadata")
-        TRANSITION_TO_YELLOW = read_lua_file("transition_to_yellow")
-        TRANSITION_TO_RED = read_lua_file("transition_to_red")
-        TRANSITION_TO_GREEN = read_lua_file("transition_to_green")
-      end
-    end
-  end
-end