Expose CircuitBreaker#name and CircuitBreaker#state methods

lib/stoplight/builder.rb

@@ -30,6 +30,8 @@ class Builder
     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

lib/stoplight/circuit_breaker.rb

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

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

spec/stoplight/circuit_breaker_spec.rb

@@ -21,6 +21,14 @@
     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

spec/stoplight/light/runnable_spec.rb

@@ -23,13 +23,15 @@ def random_string
   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
 
   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

spec/support/light/runnable.rb

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

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