breaker_machines 0.9.2-arm64-darwin

data/sig/breaker_machines/storage.rbs

@@ -0,0 +1,65 @@
+module BreakerMachines
+  module Storage
+    class Base
+      @options: Hash[Symbol, untyped]
+
+      def initialize: (**untyped options) -> void
+
+      # Status management
+      def get_status: (String circuit_name) -> { status: (:open | :closed | :half_open), opened_at: Float? }?
+      def set_status: (String circuit_name, (:open | :closed | :half_open) status, ?Float? opened_at) -> void
+
+      # Metrics tracking
+      def record_success: (String circuit_name, Float duration) -> void
+      def record_failure: (String circuit_name, Float duration) -> void
+      def success_count: (String circuit_name, Integer window_seconds) -> Integer
+      def failure_count: (String circuit_name, Integer window_seconds) -> Integer
+
+      # Cleanup
+      def clear: (String circuit_name) -> void
+      def clear_all: () -> void
+    end
+
+    class Memory < Base
+      @circuits: Concurrent::Map[String, untyped]
+      @events: Concurrent::Map[String, Concurrent::Array[untyped]]
+      @event_logs: Concurrent::Map[String, Concurrent::Array[untyped]]
+      @max_events: Integer
+
+      def initialize: (**untyped options) -> void
+      def record_event_with_details: (String circuit_name, (:success | :failure | :state_change) type, Float duration, ?error: StandardError?, ?new_state: (:open | :closed | :half_open)?) -> void
+      def event_log: (String circuit_name, Integer limit) -> Array[event_record]
+
+      private
+
+      def record_event: (String circuit_name, (:success | :failure) type, Float duration) -> void
+      def count_events: (String circuit_name, (:success | :failure) type, Integer window_seconds) -> Integer
+      def monotonic_time: () -> Float
+    end
+
+    class BucketMemory < Base
+      @buckets: Concurrent::Map[String, untyped]
+      @bucket_duration: Integer
+      @bucket_count: Integer
+      @lock: Concurrent::ReentrantReadWriteLock
+      @last_cleanup: Concurrent::AtomicReference[Float]
+      @cleanup_interval: Integer
+
+      def record_event_with_details: (String circuit_name, (:success | :failure | :state_change) event_type, Float duration, ?Hash[Symbol, untyped] details) -> void
+      def event_log: (String circuit_name, ?Integer limit) -> Array[event_record]
+
+      private
+
+      def circuit_buckets: (String circuit_name) -> Hash[Symbol, untyped]
+      def current_bucket_index: () -> Integer
+      def bucket_indices_for_window: (Integer window_seconds) -> Array[Integer]
+      def cleanup_old_buckets: (Hash[Symbol, untyped] buckets) -> void
+      def maybe_cleanup_all_buckets: () -> void
+    end
+
+    class Null < Base
+      def record_event_with_details: (String circuit_name, Symbol event_type, Float duration, ?Hash[Symbol, untyped] metadata) -> void
+      def event_log: (String circuit_name, ?Integer limit) -> Array[untyped]
+    end
+  end
+end

data/sig/breaker_machines/types.rbs

@@ -0,0 +1,97 @@
+# Common type aliases used throughout BreakerMachines
+
+# External dependencies type declarations not included in their gems
+module Concurrent
+  class AtomicReference[T]
+    def initialize: (?T initial_value) -> void
+    def value: () -> T
+    def value=: (T value) -> T
+    def get: () -> T
+    def set: (T value) -> T
+  end
+
+  class AtomicFixnum
+    def initialize: (?Integer initial_value) -> void
+    def value: () -> Integer
+    def value=: (Integer value) -> Integer
+    def increment: (?Integer delta) -> Integer
+    def decrement: (?Integer delta) -> Integer
+  end
+
+  class ReentrantReadWriteLock
+    def initialize: () -> void
+    def with_read_lock: [T] () { () -> T } -> T
+    def with_write_lock: [T] () { () -> T } -> T
+  end
+end
+
+class WeakRef[T]
+  def initialize: (T object) -> void
+  def weakref_alive?: () -> bool
+  def __getobj__: () -> T
+end
+
+module Zeitwerk
+  class Loader
+    def push_dir: (String path) -> void
+    def setup: () -> void
+    def eager_load: () -> void
+  end
+end
+
+module BreakerMachines
+  # Circuit states
+  type circuit_state = :open | :closed | :half_open
+
+  # Event types
+  type event_type = :success | :failure | :state_change | :rejection
+
+  # Callback names
+  type callback_name = :on_open | :on_close | :on_half_open | :on_reject
+
+  # Storage backend symbols
+  type storage_backend = :memory | :bucket_memory | :null | :redis
+
+  # Generic callback proc
+  type callback_proc = Proc | nil
+
+  # Fallback can be a proc, array of procs/values, or any static value
+  type fallback_value = Proc | Array[Proc | untyped] | untyped
+
+  # Options hash for circuits
+  type circuit_options = {
+    failure_threshold: Integer?,
+    failure_window: Integer?,
+    success_threshold: Integer?,
+    timeout: Integer?,
+    reset_timeout: Integer?,
+    reset_timeout_jitter: Float?,
+    half_open_calls: Integer?,
+    storage: (Storage::Base | storage_backend | Class)?,
+    metrics: untyped,
+    fallback: fallback_value?,
+    on_open: callback_proc,
+    on_close: callback_proc,
+    on_half_open: callback_proc,
+    on_reject: callback_proc,
+    exceptions: Array[Class]?,
+    owner: untyped
+  }
+
+  # Event record structure
+  type event_record = {
+    timestamp: Float,
+    type: event_type,
+    duration: Float,
+    duration_ms: Float?,
+    error_class: String?,
+    new_state: circuit_state?,
+    details: Hash[Symbol, untyped]?
+  }
+
+  # Status record from storage
+  type status_record = {
+    status: circuit_state,
+    opened_at: Float?
+  }
+end

data/sig/breaker_machines.rbs

@@ -0,0 +1,42 @@
+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
+  self.@config: Configuration?
+  def self.config: () -> Configuration
+
+  # Class methods
+  def self.configure: () { (Configuration config) -> void } -> void
+
+  # 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_timeout: () -> Integer?
+  def self.default_timeout=: (Integer? value) -> void
+  def self.default_reset_timeout: () -> Integer
+  def self.default_reset_timeout=: (Integer value) -> void
+  def self.default_failure_threshold: () -> Integer
+  def self.default_failure_threshold=: (Integer value) -> void
+  def self.log_events: () -> bool
+  def self.log_events=: (bool value) -> 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
+  def self.instrument: (String event, ?Hash[Symbol, untyped] payload) -> void
+  def self.console: () -> void
+  def self.registry: () -> Registry
+  def self.loader: () -> Zeitwerk::Loader
+end

data/sig/manifest.yaml

@@ -0,0 +1,5 @@
+dependencies:
+  - name: activesupport
+  - name: concurrent-ruby
+  - name: state_machines
+  - name: zeitwerk

metadata

@@ -0,0 +1,227 @@
+--- !ruby/object:Gem::Specification
+name: breaker_machines
+version: !ruby/object:Gem::Version
+  version: 0.9.2
+platform: arm64-darwin
+authors:
+- Abdelkader Boudih
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2025-11-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        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
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: state_machines
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.100.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.100.4
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+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
+  provides a clean DSL, thread-safe operations, multiple storage backends, and comprehensive
+  introspection tools. Unlike other solutions, BreakerMachines prioritizes safety by avoiding
+  dangerous forceful timeouts while supporting fallback chains, jitter, and event callbacks.
+email:
+- terminale@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- ext/breaker_machines_native/extconf.rb
+- 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
+- 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/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
+- 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/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
+- sig/breaker_machines/circuit.rbs
+- sig/breaker_machines/console.rbs
+- sig/breaker_machines/dsl.rbs
+- sig/breaker_machines/errors.rbs
+- sig/breaker_machines/interfaces.rbs
+- sig/breaker_machines/registry.rbs
+- sig/breaker_machines/storage.rbs
+- sig/breaker_machines/types.rbs
+- sig/manifest.yaml
+homepage: https://github.com/seuros/breaker_machines
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/seuros/breaker_machines
+  source_code_uri: https://github.com/seuros/breaker_machines
+  bug_tracker_uri: https://github.com/seuros/breaker_machines/issues
+  documentation_uri: https://github.com/seuros/breaker_machines#readme
+  rubygems_mfa_required: 'true'
+  cargo_crate_name: breaker_machines_native
+  cargo_manifest_path: ext/breaker_machines_native/ffi/Cargo.toml
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.5.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.23
+signing_key: 
+specification_version: 4
+summary: Circuit breaker implementation for Ruby with a clean DSL and state_machines
+  under the hood
+test_files: []