stoplight 4.0.0 → 4.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0194283983ed6568bca930b6640a7d397dd06e779d921e8bd169cb6a8e743448'
-  data.tar.gz: 9b68b81b05c15cbed7885d8f10a042c0e0ecacafacb0fe6e621e3c124007d74e
+  metadata.gz: dec6c43881dfde16456ffa319f2f543f2c507dbdd760c5adf7ddb155dfa9292b
+  data.tar.gz: b3609d6233f73d9a2c4a5474ef291d76fe9ccd906267cf9d831b22a040c67d1f
 SHA512:
-  metadata.gz: 64c7f5d19bb00b46f9908d938a120c475f1fd60e481e58400c49360dae260bd6c83690e61f34362a20dea0b3b955f4f9b9d76030b8ccbb7c788fd7a531ad395b
-  data.tar.gz: e48e470e7f72d811852df5576b132a11f6f69dedf711cf371c9cfbc4dc1a4600f217b147ba53c9313a8863a06aaef88e279d3cd5f7e8ff51bd69c731123b1093
+  metadata.gz: 536ab89edb5ce429274c1f54f6718ac1a82968bb10a75a5c8d44b4dfacaf5a1a37a6f9aaac2c2c91f0b0849e149df6696e1d29373f40280ab860c3ada08e357f
+  data.tar.gz: b59267822e4ead10f8675e08c6fa16bf76c4b430a0c3c0fa9d69eb42a4df8387e22a36135b6c5d76a5f76b4e002db052937af311ee160b919a0c85a027341564

data/README.md

@@ -9,8 +9,9 @@ Stoplight is traffic control for code. It's an implementation of the circuit
 breaker pattern in Ruby.
 
 ---
-:warning: You're browsing the documentation of the not realized version. You can find the documentation 
-for the most recent version 3.0.1 [here](https://github.com/bolshakov/stoplight/tree/v3.0.1).
+
+:warning:️ You're currently browsing the documentation for Stoplight 4.x. If you're looking for
+the documentation of the previous version 3.x, you can find it [here](https://github.com/bolshakov/stoplight/tree/release/v3.x).
 
 Does your code use unreliable systems, like a flaky database or a spotty web
 service? Wrap calls to those up in stoplights to prevent them from affecting
@@ -38,7 +39,7 @@ Check out [stoplight-admin][] for controlling your stoplights.
 - [Advanced Usage](#advanced-usage)
   - [Locking](#locking)
   - [Testing](#testing)
-- [Maintenance Policy][#maintenance-policy]
+- [Maintenance Policy](#maintenance-policy)
 - [Credits](#credits)
 
 ## Installation
@@ -360,6 +361,7 @@ Stoplight.default_notifiers += [notifier]
 #### Community-supported Notifiers
 
 * [stoplight-sentry]
+* [stoplight-honeybadger](https://github.com/qoqa/stoplight-honeybadger)
 
 You you want to implement your own notifier, the following section contains all the required information.
 

data/lib/stoplight/builder.rb

@@ -30,6 +30,8 @@ module Stoplight
     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

data/lib/stoplight/circuit_breaker.rb

@@ -39,6 +39,16 @@ module Stoplight
       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

data/lib/stoplight/data_store/memory.rb

@@ -42,7 +42,7 @@ module Stoplight
       end
 
       def clear_failures(light)
-        synchronize { @failures.delete(light.name) }
+        synchronize { @failures.delete(light.name) || [] }
       end
 
       def get_state(light)

data/lib/stoplight/light/runnable.rb

@@ -3,6 +3,12 @@
 module Stoplight
   class Light
     module Runnable # rubocop:disable Style/Documentation
+      # @return [String]
+      def state
+        _, state = failures_and_state
+        state
+      end
+
       # @return [String]
       def color
         failures, state = failures_and_state

data/lib/stoplight/version.rb

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

data/spec/stoplight/circuit_breaker_spec.rb

@@ -21,6 +21,14 @@ RSpec.describe Stoplight::CircuitBreaker do
     expect { circuit_breaker.color }.to raise_error(NotImplementedError)
   end
 
+  specify '#state' do
+    expect { circuit_breaker.state }.to raise_error(NotImplementedError)
+  end
+
+  specify '#name' do
+    expect { circuit_breaker.name }.to raise_error(NotImplementedError)
+  end
+
   specify '#run' do
     expect { circuit_breaker.run {} }.to raise_error(NotImplementedError)
   end

data/spec/stoplight/light/runnable_spec.rb

@@ -23,6 +23,7 @@ RSpec.describe Stoplight::Light::Runnable, :redis do
   context 'with memory data store' do
     let(:data_store) { Stoplight::DataStore::Memory.new }
 
+    it_behaves_like 'Stoplight::Light::Runnable#state'
     it_behaves_like 'Stoplight::Light::Runnable#color'
     it_behaves_like 'Stoplight::Light::Runnable#run'
   end
@@ -30,6 +31,7 @@ RSpec.describe Stoplight::Light::Runnable, :redis do
   context 'with redis data store', :redis do
     let(:data_store) { Stoplight::DataStore::Redis.new(redis) }
 
+    it_behaves_like 'Stoplight::Light::Runnable#state'
     it_behaves_like 'Stoplight::Light::Runnable#color'
     it_behaves_like 'Stoplight::Light::Runnable#run'
   end

data/spec/support/data_store/base/clear_failures.rb

@@ -9,6 +9,12 @@ RSpec.shared_examples 'Stoplight::DataStore::Base#clear_failures' do
     expect(data_store.clear_failures(light)).to contain_exactly(failure)
   end
 
+  it 'returns an empty array when there are no failures' do
+    data_store.clear_failures(light)
+
+    expect(data_store.clear_failures(light)).to be_empty
+  end
+
   it 'clears the failures' do
     expect do
       data_store.clear_failures(light)

data/spec/support/light/runnable/state.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+RSpec.shared_examples 'Stoplight::Light::Runnable#state' do
+  subject(:light) { Stoplight::Light.new(name) }
+
+  let(:name) { random_string }
+
+  it 'is initially unlocked' do
+    expect(light.state).to eql(Stoplight::State::UNLOCKED)
+  end
+
+  context 'when its locked green' do
+    before do
+      light.data_store.set_state(light, Stoplight::State::LOCKED_GREEN)
+    end
+
+    it 'is locked green' do
+      expect(light.state).to eql(Stoplight::State::LOCKED_GREEN)
+    end
+  end
+
+  context 'when its locked red' do
+    before do
+      light.data_store.set_state(light, Stoplight::State::LOCKED_RED)
+    end
+
+    it 'is locked red' do
+      expect(light.state).to eql(Stoplight::State::LOCKED_RED)
+    end
+  end
+end

data/spec/support/light/runnable.rb

@@ -2,3 +2,4 @@
 
 require_relative 'runnable/color'
 require_relative 'runnable/run'
+require_relative 'runnable/state'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stoplight
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.1.1
 platform: ruby
 authors:
 - Cameron Desautels
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-08-18 00:00:00.000000000 Z
+date: 2025-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: redlock
@@ -103,6 +103,7 @@ files:
 - 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
@@ -122,7 +123,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.5.18
 signing_key:
 specification_version: 4
 summary: Traffic control for code.
@@ -165,4 +166,5 @@ test_files:
 - 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