breaker_machines 0.3.0 → 0.4.0

data/lib/breaker_machines/storage/memory.rb

@@ -23,10 +23,10 @@ module BreakerMachines
         circuit_data = @circuits[circuit_name]
         return nil unless circuit_data
 
-        {
+        BreakerMachines::Status.new(
           status: circuit_data[:status],
           opened_at: circuit_data[:opened_at]
-        }
+        )
       end
 
       def set_status(circuit_name, status, opened_at = nil)
@@ -130,7 +130,7 @@ module BreakerMachines
       end
 
       def monotonic_time
-        Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        BreakerMachines.monotonic_time
       end
     end
   end

data/lib/breaker_machines/types.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module BreakerMachines
+  # Represents the status of a circuit from storage
+  # @return [Symbol] status - the circuit status (:open, :closed, :half_open)
+  # @return [Float, nil] opened_at - the monotonic time when the circuit was opened
+  Status = Data.define(:status, :opened_at)
+
+  # Represents statistical information about a circuit
+  Stats = Data.define(
+    :state,
+    :failure_count,
+    :success_count,
+    :last_failure_at,
+    :opened_at,
+    :half_open_attempts,
+    :half_open_successes
+  )
+
+  # Represents information about the last error that occurred
+  # @return [String] error_class - the error class name
+  # @return [String] message - the error message
+  # @return [Float, nil] occurred_at - the monotonic time when the error occurred
+  ErrorInfo = Data.define(:error_class, :message, :occurred_at)
+
+  # Represents cascade information for cascading circuits
+  CascadeInfo = Data.define(
+    :dependent_circuits,
+    :emergency_protocol,
+    :cascade_triggered_at,
+    :dependent_status
+  )
+
+  # Represents an event in the circuit's event log
+  # @return [Symbol] type - the event type (:success, :failure, :state_change)
+  # @return [Float] timestamp - the monotonic timestamp
+  # @return [Float] duration - the duration in milliseconds
+  # @return [String, nil] error - the error message if applicable
+  # @return [Symbol, nil] new_state - the new state if this was a state change
+  Event = Data.define(:type, :timestamp, :duration, :error, :new_state)
+end

data/lib/breaker_machines/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BreakerMachines
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end

data/lib/breaker_machines.rb

@@ -3,11 +3,14 @@
 require 'zeitwerk'
 require 'active_support'
 require 'active_support/core_ext'
+require 'state_machines'
 require_relative 'breaker_machines/errors'
+require_relative 'breaker_machines/types'
 
 loader = Zeitwerk::Loader.for_gem
 loader.inflector.inflect('dsl' => 'DSL')
 loader.ignore("#{__dir__}/breaker_machines/errors.rb")
+loader.ignore("#{__dir__}/breaker_machines/types.rb")
 loader.ignore("#{__dir__}/breaker_machines/console.rb")
 loader.ignore("#{__dir__}/breaker_machines/async_support.rb")
 loader.ignore("#{__dir__}/breaker_machines/hedged_async_support.rb")
@@ -77,6 +80,15 @@ module BreakerMachines
     def registry
       Registry.instance
     end
+
+    # Returns the current monotonic time in seconds.
+    # Monotonic time is guaranteed to always increase and is not affected
+    # by system clock adjustments, making it ideal for measuring durations.
+    #
+    # @return [Float] current monotonic time in seconds
+    def monotonic_time
+      Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    end
   end
 
   # Set up notifications on first use

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: breaker_machines
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Abdelkader Boudih
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -43,14 +43,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.31.0
+        version: 0.50.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.31.0
+        version: 0.50.0
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -109,6 +109,7 @@ files:
 - README.md
 - lib/breaker_machines.rb
 - lib/breaker_machines/async_support.rb
+- lib/breaker_machines/cascading_circuit.rb
 - lib/breaker_machines/circuit.rb
 - lib/breaker_machines/circuit/callbacks.rb
 - lib/breaker_machines/circuit/configuration.rb
@@ -117,17 +118,23 @@ files:
 - lib/breaker_machines/circuit/state_management.rb
 - lib/breaker_machines/console.rb
 - lib/breaker_machines/dsl.rb
+- lib/breaker_machines/dsl/cascading_circuit_builder.rb
+- lib/breaker_machines/dsl/circuit_builder.rb
+- lib/breaker_machines/dsl/hedged_builder.rb
+- lib/breaker_machines/dsl/parallel_fallback_wrapper.rb
 - lib/breaker_machines/errors.rb
 - lib/breaker_machines/hedged_async_support.rb
 - lib/breaker_machines/hedged_execution.rb
 - lib/breaker_machines/registry.rb
 - lib/breaker_machines/storage.rb
+- lib/breaker_machines/storage/backend_state.rb
 - lib/breaker_machines/storage/base.rb
 - lib/breaker_machines/storage/bucket_memory.rb
 - lib/breaker_machines/storage/cache.rb
 - lib/breaker_machines/storage/fallback_chain.rb
 - lib/breaker_machines/storage/memory.rb
 - lib/breaker_machines/storage/null.rb
+- lib/breaker_machines/types.rb
 - lib/breaker_machines/version.rb
 - sig/README.md
 - sig/all.rbs