breaker_machines 0.4.0 → 0.6.0

data/lib/breaker_machines.rb

@@ -14,32 +14,95 @@ 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")
+loader.ignore("#{__dir__}/breaker_machines/circuit/async_state_management.rb")
+loader.ignore("#{__dir__}/breaker_machines/native_speedup.rb")
+loader.ignore("#{__dir__}/breaker_machines/native_extension.rb")
 loader.setup
 
 # BreakerMachines provides a thread-safe implementation of the Circuit Breaker pattern
 # for Ruby applications, helping to prevent cascading failures in distributed systems.
 module BreakerMachines
+  # Global configuration class for BreakerMachines
+  class Configuration
+    attr_accessor :default_storage,
+                  :default_timeout,
+                  :default_reset_timeout,
+                  :default_failure_threshold,
+                  :log_events,
+                  :fiber_safe
+
+    def initialize
+      @default_storage = :bucket_memory
+      @default_timeout = nil
+      @default_reset_timeout = 60.seconds
+      @default_failure_threshold = 5
+      @log_events = true
+      @fiber_safe = false
+    end
+  end
+
   class << self
     def loader
       loader
     end
-  end
-
-  # Global configuration
-  include ActiveSupport::Configurable
 
-  config_accessor :default_storage, default: :bucket_memory
-  config_accessor :default_timeout, default: nil
-  config_accessor :default_reset_timeout, default: 60.seconds
-  config_accessor :default_failure_threshold, default: 5
-  config_accessor :log_events, default: true
-  config_accessor :fiber_safe, default: false
+    def config
+      @config ||= Configuration.new
+    end
 
-  class << self
     def configure
       yield config
     end
 
+    # Delegate config attributes to config object for backward compatibility
+    def default_storage
+      config.default_storage
+    end
+
+    def default_storage=(value)
+      config.default_storage = value
+    end
+
+    def default_timeout
+      config.default_timeout
+    end
+
+    def default_timeout=(value)
+      config.default_timeout = value
+    end
+
+    def default_reset_timeout
+      config.default_reset_timeout
+    end
+
+    def default_reset_timeout=(value)
+      config.default_reset_timeout = value
+    end
+
+    def default_failure_threshold
+      config.default_failure_threshold
+    end
+
+    def default_failure_threshold=(value)
+      config.default_failure_threshold = value
+    end
+
+    def log_events
+      config.log_events
+    end
+
+    def log_events=(value)
+      config.log_events = value
+    end
+
+    def fiber_safe
+      config.fiber_safe
+    end
+
+    def fiber_safe=(value)
+      config.fiber_safe = value
+    end
+
     def setup_notifications
       return unless config.log_events
 
@@ -64,12 +127,27 @@ module BreakerMachines
 
     attr_writer :logger
 
+    # Centralized logging helper
+    # @param level [Symbol] log level (:debug, :info, :warn, :error)
+    # @param message [String] message to log
+    def log(level, message)
+      return unless config.log_events && logger
+
+      logger.public_send(level, "[BreakerMachines] #{message}")
+    end
+
     def instrument(event, payload = {})
       return unless config.log_events
 
       ActiveSupport::Notifications.instrument("breaker_machines.#{event}", payload)
     end
 
+    # Check if native extension is available
+    # @return [Boolean] true if native extension loaded successfully
+    def native_available?
+      @native_available || false
+    end
+
     # Launch the interactive console
     def console
       require_relative 'breaker_machines/console'
@@ -81,6 +159,22 @@ module BreakerMachines
       Registry.instance
     end
 
+    # Register a circuit with the global registry
+    def register(circuit)
+      registry.register(circuit)
+    end
+
+    # Reset the registry and configurations (useful for testing)
+    def reset!
+      registry.clear
+      config.default_storage = :bucket_memory
+      config.default_timeout = nil
+      config.default_reset_timeout = 60.seconds
+      config.default_failure_threshold = 5
+      config.log_events = true
+      config.fiber_safe = false
+    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.
@@ -94,3 +188,13 @@ module BreakerMachines
   # Set up notifications on first use
   setup_notifications if config.log_events
 end
+
+# Load optional native speedup after core is loaded
+# Opt-in with BREAKER_MACHINES_NATIVE=1 to enable native extensions
+if ENV['BREAKER_MACHINES_NATIVE'] == '1'
+  begin
+    require_relative 'breaker_machines/native_speedup'
+  rescue LoadError
+    # Native gem not available, skip native support
+  end
+end

data/sig/breaker_machines.rbs

@@ -1,14 +1,27 @@
 module BreakerMachines
   VERSION: String
 
+  class Configuration
+    attr_accessor default_storage: (:memory | :bucket_memory | :null | untyped)
+    attr_accessor default_timeout: Integer?
+    attr_accessor default_reset_timeout: Integer
+    attr_accessor default_failure_threshold: Integer
+    attr_accessor log_events: bool
+    attr_accessor fiber_safe: bool
+
+    def initialize: () -> void
+  end
+
   # Global configuration
-  extend ActiveSupport::Configurable
+  self.@config: Configuration?
+  def self.config: () -> Configuration
+
+  # Class methods
+  def self.configure: () { (Configuration config) -> void } -> void
 
-  # Configuration accessors
-  self.@config: untyped
-  def self.config: () -> ActiveSupport::Configurable::Configuration
+  # Delegated config accessors for backward compatibility
   def self.default_storage: () -> (:memory | :bucket_memory | :null | untyped)
-  def self.default_storage=: (:memory | :bucket_memory | :null | untyped value) -> void
+  def self.default_storage=: ((:memory | :bucket_memory | :null | untyped) value) -> void
   def self.default_timeout: () -> Integer?
   def self.default_timeout=: (Integer? value) -> void
   def self.default_reset_timeout: () -> Integer
@@ -17,9 +30,8 @@ module BreakerMachines
   def self.default_failure_threshold=: (Integer value) -> void
   def self.log_events: () -> bool
   def self.log_events=: (bool value) -> void
-
-  # Class methods
-  def self.configure: () { (untyped config) -> void } -> void
+  def self.fiber_safe: () -> bool
+  def self.fiber_safe=: (bool value) -> void
   def self.setup_notifications: () -> void
   def self.logger: () -> ActiveSupport::Logger?
   def self.logger=: (ActiveSupport::Logger? logger) -> void

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: breaker_machines
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Abdelkader Boudih
@@ -15,14 +15,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '8.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: chrono_machines
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -43,14 +57,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.50.0
+        version: 0.100.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.50.0
+        version: 0.100.4
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -93,6 +107,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rb_sys
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
 description: |
   BreakerMachines is a production-ready circuit breaker implementation for Ruby that prevents
   cascade failures in distributed systems. Built on the battle-tested state_machines gem, it
@@ -102,21 +130,90 @@ description: |
 email:
 - terminale@gmail.com
 executables: []
-extensions: []
+extensions:
+- ext/breaker_machines_native/extconf.rb
 extra_rdoc_files: []
 files:
 - LICENSE.txt
 - README.md
+- ext/breaker_machines_native/Cargo.toml
+- ext/breaker_machines_native/core/Cargo.toml
+- ext/breaker_machines_native/core/examples/basic.rs
+- ext/breaker_machines_native/core/src/builder.rs
+- ext/breaker_machines_native/core/src/bulkhead.rs
+- ext/breaker_machines_native/core/src/callbacks.rs
+- ext/breaker_machines_native/core/src/circuit.rs
+- ext/breaker_machines_native/core/src/classifier.rs
+- ext/breaker_machines_native/core/src/errors.rs
+- ext/breaker_machines_native/core/src/lib.rs
+- ext/breaker_machines_native/core/src/storage.rs
+- ext/breaker_machines_native/extconf.rb
+- ext/breaker_machines_native/ffi/Cargo.toml
+- ext/breaker_machines_native/ffi/src/lib.rs
+- ext/breaker_machines_native/target/debug/build/clang-sys-d961dfabd5f43fba/out/common.rs
+- ext/breaker_machines_native/target/debug/build/clang-sys-d961dfabd5f43fba/out/dynamic.rs
+- ext/breaker_machines_native/target/debug/build/clang-sys-d961dfabd5f43fba/out/macros.rs
+- ext/breaker_machines_native/target/debug/build/rb-sys-2bb7281aac8faec8/out/bindings-0.9.117-mri-arm64-darwin24-3.4.7.rs
+- ext/breaker_machines_native/target/debug/build/rb-sys-54cb99ea6aeab8bc/out/bindings-0.9.117-mri-arm64-darwin24-3.4.7.rs
+- ext/breaker_machines_native/target/debug/build/rb-sys-9e64a270c6421e93/out/bindings-0.9.117-mri-arm64-darwin24-3.4.7.rs
+- ext/breaker_machines_native/target/debug/build/rb-sys-e627030114d3fc19/out/bindings-0.9.117-mri-arm64-darwin24-3.4.7.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.1.0/Cargo.toml
+- ext/breaker_machines_native/target/package/breaker-machines-0.1.0/examples/basic.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.1.0/src/builder.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.1.0/src/callbacks.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.1.0/src/circuit.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.1.0/src/errors.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.1.0/src/lib.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.1.0/src/storage.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.2.0/Cargo.toml
+- ext/breaker_machines_native/target/package/breaker-machines-0.2.0/examples/basic.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.2.0/src/builder.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.2.0/src/callbacks.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.2.0/src/circuit.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.2.0/src/errors.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.2.0/src/lib.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.2.0/src/storage.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.5.0/Cargo.toml
+- ext/breaker_machines_native/target/package/breaker-machines-0.5.0/examples/basic.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.5.0/src/builder.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.5.0/src/callbacks.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.5.0/src/circuit.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.5.0/src/errors.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.5.0/src/lib.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.5.0/src/storage.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.6.0/Cargo.toml
+- ext/breaker_machines_native/target/package/breaker-machines-0.6.0/examples/basic.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.6.0/src/builder.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.6.0/src/bulkhead.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.6.0/src/callbacks.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.6.0/src/circuit.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.6.0/src/classifier.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.6.0/src/errors.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.6.0/src/lib.rs
+- ext/breaker_machines_native/target/package/breaker-machines-0.6.0/src/storage.rs
+- ext/breaker_machines_native/target/release/build/clang-sys-ef8ad8b846ac8b75/out/common.rs
+- ext/breaker_machines_native/target/release/build/clang-sys-ef8ad8b846ac8b75/out/dynamic.rs
+- ext/breaker_machines_native/target/release/build/clang-sys-ef8ad8b846ac8b75/out/macros.rs
+- ext/breaker_machines_native/target/release/build/rb-sys-064bf9961dd17810/out/bindings-0.9.117-mri-arm64-darwin24-3.4.7.rs
 - lib/breaker_machines.rb
+- lib/breaker_machines/async_circuit.rb
 - lib/breaker_machines/async_support.rb
 - lib/breaker_machines/cascading_circuit.rb
 - lib/breaker_machines/circuit.rb
+- lib/breaker_machines/circuit/async_state_management.rb
+- lib/breaker_machines/circuit/base.rb
 - lib/breaker_machines/circuit/callbacks.rb
 - lib/breaker_machines/circuit/configuration.rb
+- lib/breaker_machines/circuit/coordinated_state_management.rb
 - lib/breaker_machines/circuit/execution.rb
+- lib/breaker_machines/circuit/hedged_execution.rb
 - lib/breaker_machines/circuit/introspection.rb
+- lib/breaker_machines/circuit/native.rb
+- lib/breaker_machines/circuit/state_callbacks.rb
 - lib/breaker_machines/circuit/state_management.rb
+- lib/breaker_machines/circuit_group.rb
 - lib/breaker_machines/console.rb
+- lib/breaker_machines/coordinated_circuit.rb
 - lib/breaker_machines/dsl.rb
 - lib/breaker_machines/dsl/cascading_circuit_builder.rb
 - lib/breaker_machines/dsl/circuit_builder.rb
@@ -124,7 +221,8 @@ files:
 - 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/native_extension.rb
+- lib/breaker_machines/native_speedup.rb
 - lib/breaker_machines/registry.rb
 - lib/breaker_machines/storage.rb
 - lib/breaker_machines/storage/backend_state.rb
@@ -133,9 +231,11 @@ files:
 - lib/breaker_machines/storage/cache.rb
 - lib/breaker_machines/storage/fallback_chain.rb
 - lib/breaker_machines/storage/memory.rb
+- lib/breaker_machines/storage/native.rb
 - lib/breaker_machines/storage/null.rb
 - lib/breaker_machines/types.rb
 - lib/breaker_machines/version.rb
+- lib/breaker_machines_native/breaker_machines_native.bundle
 - sig/README.md
 - sig/all.rbs
 - sig/breaker_machines.rbs

data/lib/breaker_machines/hedged_execution.rb

@@ -1,113 +0,0 @@
-# frozen_string_literal: true
-
-require 'concurrent'
-require 'timeout'
-
-module BreakerMachines
-  # HedgedExecution provides hedged request functionality for circuit breakers
-  # Hedged requests improve latency by sending duplicate requests to multiple backends
-  # and returning the first successful response
-  module HedgedExecution
-    extend ActiveSupport::Concern
-
-    # Execute a hedged request pattern
-    def execute_hedged(&)
-      return execute_single_hedged(&) unless @config[:backends]&.any?
-
-      execute_multi_backend_hedged
-    end
-
-    private
-
-    # Execute hedged request with a single backend (original block)
-    def execute_single_hedged(&block)
-      return yield unless hedged_requests_enabled?
-
-      max_requests = @config[:max_hedged_requests] || 2
-      delay_ms = @config[:hedging_delay] || 50
-
-      if @config[:fiber_safe]
-        execute_hedged_async(Array.new(max_requests) { block }, delay_ms)
-      else
-        execute_hedged_sync(Array.new(max_requests) { block }, delay_ms)
-      end
-    end
-
-    # Execute hedged requests across multiple backends
-    def execute_multi_backend_hedged
-      backends = @config[:backends]
-      return backends.first.call if backends.size == 1
-
-      if @config[:fiber_safe]
-        execute_hedged_async(backends, @config[:hedging_delay] || 0)
-      else
-        execute_hedged_sync(backends, @config[:hedging_delay] || 0)
-      end
-    end
-
-    # Synchronous hedged execution using threads
-    def execute_hedged_sync(callables, delay_ms)
-      result_queue = Queue.new
-      error_queue = Queue.new
-      threads = []
-      cancelled = Concurrent::AtomicBoolean.new(false)
-
-      callables.each_with_index do |callable, index|
-        # Add delay for hedge requests (not the first one)
-        sleep(delay_ms / 1000.0) if index.positive? && delay_ms.positive?
-
-        # Skip if already got a result
-        break if cancelled.value
-
-        threads << Thread.new do
-          unless cancelled.value
-            begin
-              result = callable.call
-              result_queue << result unless cancelled.value
-              cancelled.value = true
-            rescue StandardError => e
-              error_queue << e unless cancelled.value
-            end
-          end
-        end
-      end
-
-      # Wait for first result or all errors
-      begin
-        Timeout.timeout(@config[:timeout] || 30) do
-          # Check for successful result
-          loop do
-            unless result_queue.empty?
-              result = result_queue.pop
-              cancelled.value = true
-              return result
-            end
-
-            # Check if all requests failed
-            raise error_queue.pop if error_queue.size >= callables.size
-
-            # Small sleep to prevent busy waiting
-            sleep 0.001
-          end
-        end
-      ensure
-        # Cancel remaining threads
-        cancelled.value = true
-        threads.each(&:kill)
-      end
-    end
-
-    # Async hedged execution (requires async support)
-    def execute_hedged_async(callables, delay_ms)
-      # This will be implemented when async support is loaded
-      # For now, fall back to sync implementation
-      return execute_hedged_sync(callables, delay_ms) unless respond_to?(:execute_hedged_with_async)
-
-      execute_hedged_with_async(callables, delay_ms)
-    end
-
-    def hedged_requests_enabled?
-      @config[:hedged_requests] == true
-    end
-  end
-end