breaker_machines 0.10.3 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0888d588b03f049c46ec019c12a401648c1c2bed107bf62a72b15896de290af2'
-  data.tar.gz: 902e776cd459cfa52c7fbc2f72e175666ee941db7d7c00a572759bb0daaebd08
+  metadata.gz: fd34f2d2c0993335422fcb7c9a2495af660ec6c59dde5f57c7f9da0841cb51db
+  data.tar.gz: fc1ba508ecbaf43dbf451ef81bcacb9b586a0003ca5148d66d80f4d51a53f926
 SHA512:
-  metadata.gz: 3d375d5858d1c5dd435503bf782a802ab23a2cf8a1b6e93b7eb746bdcf4d51ea23df28186f34f86b223c7da53dd63c92128b915be72fa36812f0aebbfb9df1bc
-  data.tar.gz: 1f30b69ee1c28efc09912dcdeb0bb28031230c9665187e59c94b6c4cdcf64910f3392393d7d95fbdb949adcf71bd8547a848c1bc8047e84510a5754fe0b2b70e
+  metadata.gz: 49eac0d2918c9cee306309f785009fe53ffbd4d4a26641132f2dfe8a069e0cb200a47a3d97a8748ae1bf52d4604969127d3c549db2e31cf6e25d0b95ce9eb65c
+  data.tar.gz: a08fa2490b8b2a3b1ac6bc44853540763875ce39ce439c860b682256f01ccfbdf5e5e63176f917d9c109a3593b573a32588dddb336c34d0a1023c00bbe4c15c5

data/ext/breaker_machines_native/core/Cargo.toml

@@ -1,18 +1,21 @@
 [package]
 name = "breaker-machines"
-version = "0.7.2"
+version = "0.7.6"
 edition = "2024"
-authors = ["Abdelkader Boudih <terminale@gmail.com>"]
+authors = ["Abdelkader Boudih <oss@seuros.com>"]
 license = "MIT"
 description = "High-performance circuit breaker with fallback support and rate-based thresholds"
 repository = "https://github.com/seuros/breaker_machines"
 readme = "README.md"
-keywords = ["circuit-breaker", "reliability", "fault-tolerance"]
+keywords = ["circuit-breaker", "reliability", "fault-tolerance", "state-machine"]
 categories = ["concurrency"]
 
 [lib]
 crate-type = ["lib"]
 
+[features]
+inspect = ["state-machines/inspect"]
+
 [dependencies]
 state-machines = { workspace = true }
 chrono-machines = { workspace = true }

data/ext/breaker_machines_native/ffi/Cargo.toml

@@ -1,16 +1,18 @@
 [package]
 name = "breaker_machines_native"
-version = "0.5.4"
+version = "0.5.8"
 edition = "2024"
-authors = ["Abdelkader Boudih <terminale@gmail.com>"]
+authors = ["Abdelkader Boudih <oss@seuros.com>"]
 license = "MIT"
+description = "Ruby FFI bindings for breaker-machines circuit breaker"
+repository = "https://github.com/seuros/breaker_machines"
 
 [lib]
 crate-type = ["cdylib"]
 
 [dependencies]
 breaker-machines = { workspace = true }
-magnus = { version = "0.8.2", features = ["embed"] }
+magnus = "0.8.2"
 
 [build-dependencies]
 rb-sys = "0.9"

data/ext/breaker_machines_native/ffi/extconf.rb

@@ -12,9 +12,9 @@ def create_noop_makefile(message)
   exit 0
 end
 
-# Skip native extension compilation on JRuby
-if RUBY_ENGINE == 'jruby'
-  create_noop_makefile('Skipping native extension on JRuby')
+# Skip native extension compilation outside CRuby
+unless RUBY_ENGINE == 'ruby'
+  create_noop_makefile("Skipping native extension on #{RUBY_ENGINE}")
 end
 
 # Check if Cargo is available

data/lib/breaker_machines/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: breaker_machines
 version: !ruby/object:Gem::Version
-  version: 0.10.3
+  version: 0.11.0
 platform: ruby
 authors:
 - Abdelkader Boudih
@@ -150,7 +150,6 @@ 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
@@ -165,30 +164,6 @@ files:
 - ext/breaker_machines_native/ffi/Cargo.toml
 - ext/breaker_machines_native/ffi/extconf.rb
 - ext/breaker_machines_native/ffi/src/lib.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.1/Cargo.toml
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.1/examples/basic.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.1/src/builder.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.1/src/bulkhead.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.1/src/callbacks.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.1/src/circuit.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.1/src/classifier.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.1/src/errors.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.1/src/lib.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.1/src/storage.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.2/Cargo.toml
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.2/examples/basic.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.2/src/builder.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.2/src/bulkhead.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.2/src/callbacks.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.2/src/circuit.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.2/src/classifier.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.2/src/errors.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.2/src/lib.rs
-- ext/breaker_machines_native/target/package/breaker-machines-0.7.2/src/storage.rs
-- ext/breaker_machines_native/target/release/build/clang-sys-710ac1a8148f7790/out/common.rs
-- ext/breaker_machines_native/target/release/build/clang-sys-710ac1a8148f7790/out/dynamic.rs
-- ext/breaker_machines_native/target/release/build/clang-sys-710ac1a8148f7790/out/macros.rs
-- ext/breaker_machines_native/target/release/build/rb-sys-9ecc9c8203d58b3a/out/bindings-0.9.117-mri-arm64-darwin24-4.0.0.rs
 - lib/breaker_machines.rb
 - lib/breaker_machines/async_circuit.rb
 - lib/breaker_machines/async_support.rb
@@ -266,7 +241,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.1
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Circuit breaker implementation for Ruby with a clean DSL and state_machines
   under the hood

data/ext/breaker_machines_native/Cargo.toml

@@ -1,8 +0,0 @@
-[workspace]
-members = ["core", "ffi"]
-resolver = "2"
-
-[workspace.dependencies]
-breaker-machines = { path = "./core" }
-state-machines = "0.6"
-chrono-machines = "0.2.1"

data/ext/breaker_machines_native/target/package/breaker-machines-0.7.1/Cargo.toml

@@ -1,48 +0,0 @@
-# THIS FILE IS AUTOMATICALLY GENERATED BY CARGO
-#
-# When uploading crates to the registry Cargo will automatically
-# "normalize" Cargo.toml files for maximal compatibility
-# with all versions of Cargo and also rewrite `path` dependencies
-# to registry (e.g., crates.io) dependencies.
-#
-# If you are reading this file be aware that the original Cargo.toml
-# will likely look very different (and much more reasonable).
-# See Cargo.toml.orig for the original contents.
-
-[package]
-edition = "2024"
-name = "breaker-machines"
-version = "0.7.1"
-authors = ["Abdelkader Boudih <terminale@gmail.com>"]
-build = false
-autolib = false
-autobins = false
-autoexamples = false
-autotests = false
-autobenches = false
-description = "High-performance circuit breaker with fallback support and rate-based thresholds"
-readme = "README.md"
-keywords = [
-    "circuit-breaker",
-    "reliability",
-    "fault-tolerance",
-]
-categories = ["concurrency"]
-license = "MIT"
-repository = "https://github.com/seuros/breaker_machines"
-resolver = "2"
-
-[lib]
-name = "breaker_machines"
-crate-type = ["lib"]
-path = "src/lib.rs"
-
-[[example]]
-name = "basic"
-path = "examples/basic.rs"
-
-[dependencies.chrono-machines]
-version = "0.2.1"
-
-[dependencies.state-machines]
-version = "0.6"

data/ext/breaker_machines_native/target/package/breaker-machines-0.7.1/examples/basic.rs

@@ -1,61 +0,0 @@
-//! Basic circuit breaker usage example
-
-use breaker_machines::CircuitBreaker;
-
-fn main() {
-    println!("=== Circuit Breaker Basic Example ===\n");
-
-    // Create a circuit with builder API
-    let mut circuit = CircuitBreaker::builder("payment_api")
-        .failure_threshold(3)
-        .failure_window_secs(10.0)
-        .half_open_timeout_secs(5.0)
-        .success_threshold(2)
-        .on_open(|name| println!("🔴 Circuit '{}' opened!", name))
-        .on_close(|name| println!("🟢 Circuit '{}' closed!", name))
-        .on_half_open(|name| println!("🟡 Circuit '{}' half-open, testing...", name))
-        .build();
-
-    println!("Initial state: {}\n", circuit.state_name());
-
-    // Simulate successful calls
-    println!("--- Successful calls ---");
-    for i in 1..=2 {
-        match circuit.call(move || Ok::<_, String>(format!("Payment {}", i))) {
-            Ok(result) => println!("✓ {}", result),
-            Err(e) => println!("✗ Error: {}", e),
-        }
-    }
-    println!("State: {}\n", circuit.state_name());
-
-    // Simulate failures
-    println!("--- Triggering failures ---");
-    for i in 1..=3 {
-        match circuit.call(move || Err::<String, _>(format!("Payment failed {}", i))) {
-            Ok(_) => println!("✓ Success"),
-            Err(e) => println!("✗ {}", e),
-        }
-    }
-    println!("State: {} (circuit opened)\n", circuit.state_name());
-
-    // Try calling while open
-    println!("--- Attempting call while open ---");
-    match circuit.call(|| Ok::<_, String>("Should be rejected")) {
-        Ok(_) => println!("✓ Success"),
-        Err(e) => println!("✗ {}", e),
-    }
-    println!();
-
-    // Reset and demonstrate recovery
-    println!("--- Resetting circuit ---");
-    circuit.reset();
-    println!("State after reset: {}\n", circuit.state_name());
-
-    // Successful calls after reset
-    println!("--- Calls after reset ---");
-    match circuit.call(|| Ok::<_, String>("Payment successful")) {
-        Ok(result) => println!("✓ {}", result),
-        Err(e) => println!("✗ {}", e),
-    }
-    println!("State: {}", circuit.state_name());
-}

data/ext/breaker_machines_native/target/package/breaker-machines-0.7.1/src/builder.rs

@@ -1,232 +0,0 @@
-//! Builder API for ergonomic circuit breaker configuration
-
-use crate::{
-    MemoryStorage, StorageBackend,
-    bulkhead::BulkheadSemaphore,
-    callbacks::Callbacks,
-    circuit::{CircuitBreaker, CircuitContext, Config},
-    classifier::FailureClassifier,
-};
-use std::sync::Arc;
-
-/// Builder for creating circuit breakers with fluent API
-pub struct CircuitBuilder {
-    name: String,
-    config: Config,
-    storage: Option<Arc<dyn StorageBackend>>,
-    failure_classifier: Option<Arc<dyn FailureClassifier>>,
-    bulkhead: Option<Arc<BulkheadSemaphore>>,
-    callbacks: Callbacks,
-}
-
-impl CircuitBuilder {
-    /// Create a new builder for a circuit with the given name
-    pub fn new(name: impl Into<String>) -> Self {
-        Self {
-            name: name.into(),
-            config: Config::default(),
-            storage: None,
-            failure_classifier: None,
-            bulkhead: None,
-            callbacks: Callbacks::new(),
-        }
-    }
-
-    /// Set the absolute failure threshold (number of failures to open circuit)
-    pub fn failure_threshold(mut self, threshold: usize) -> Self {
-        self.config.failure_threshold = Some(threshold);
-        self
-    }
-
-    /// Disable absolute failure threshold (use only rate-based)
-    pub fn disable_failure_threshold(mut self) -> Self {
-        self.config.failure_threshold = None;
-        self
-    }
-
-    /// Set the failure rate threshold (0.0-1.0)
-    /// Circuit opens when (failures / total_calls) >= this value
-    pub fn failure_rate(mut self, rate: f64) -> Self {
-        self.config.failure_rate_threshold = Some(rate.clamp(0.0, 1.0));
-        self
-    }
-
-    /// Set minimum number of calls before rate-based threshold is evaluated
-    pub fn minimum_calls(mut self, calls: usize) -> Self {
-        self.config.minimum_calls = calls;
-        self
-    }
-
-    /// Set the failure window in seconds
-    pub fn failure_window_secs(mut self, seconds: f64) -> Self {
-        self.config.failure_window_secs = seconds;
-        self
-    }
-
-    /// Set the half-open timeout in seconds
-    pub fn half_open_timeout_secs(mut self, seconds: f64) -> Self {
-        self.config.half_open_timeout_secs = seconds;
-        self
-    }
-
-    /// Set the success threshold (successes needed to close from half-open)
-    pub fn success_threshold(mut self, threshold: usize) -> Self {
-        self.config.success_threshold = threshold;
-        self
-    }
-
-    /// Set the jitter factor (0.0 = no jitter, 1.0 = full jitter)
-    /// Uses chrono-machines formula: timeout * (1 - jitter + rand * jitter)
-    pub fn jitter_factor(mut self, factor: f64) -> Self {
-        self.config.jitter_factor = factor;
-        self
-    }
-
-    /// Set custom storage backend
-    pub fn storage(mut self, storage: Arc<dyn StorageBackend>) -> Self {
-        self.storage = Some(storage);
-        self
-    }
-
-    /// Set a failure classifier to filter which errors should trip the circuit
-    ///
-    /// The classifier determines whether a given error should count toward
-    /// opening the circuit. Use this to ignore "expected" errors like validation
-    /// failures or client errors (4xx), while still tripping on server errors (5xx).
-    ///
-    /// # Examples
-    ///
-    /// ```rust
-    /// use breaker_machines::{CircuitBreaker, PredicateClassifier};
-    /// use std::sync::Arc;
-    ///
-    /// let circuit = CircuitBreaker::builder("api")
-    ///     .failure_classifier(Arc::new(PredicateClassifier::new(|ctx| {
-    ///         // Only trip on slow errors
-    ///         ctx.duration > 1.0
-    ///     })))
-    ///     .build();
-    /// ```
-    pub fn failure_classifier(mut self, classifier: Arc<dyn FailureClassifier>) -> Self {
-        self.failure_classifier = Some(classifier);
-        self
-    }
-
-    /// Set maximum concurrency limit (bulkheading)
-    ///
-    /// When set, the circuit breaker will reject calls with `BulkheadFull` error
-    /// if the number of concurrent calls exceeds this limit. This prevents
-    /// resource exhaustion by limiting how many operations can run simultaneously.
-    ///
-    /// # Panics
-    ///
-    /// Panics if `limit` is 0.
-    ///
-    /// # Examples
-    ///
-    /// ```rust
-    /// use breaker_machines::CircuitBreaker;
-    ///
-    /// let mut circuit = CircuitBreaker::builder("api")
-    ///     .max_concurrency(10) // Allow max 10 concurrent calls
-    ///     .build();
-    ///
-    /// // This will succeed until 10 calls are running concurrently
-    /// let result = circuit.call(|| Ok::<_, String>("success"));
-    /// ```
-    pub fn max_concurrency(mut self, limit: usize) -> Self {
-        self.bulkhead = Some(Arc::new(BulkheadSemaphore::new(limit)));
-        self
-    }
-
-    /// Set callback for when circuit opens
-    pub fn on_open<F>(mut self, f: F) -> Self
-    where
-        F: Fn(&str) + Send + Sync + 'static,
-    {
-        self.callbacks.on_open = Some(Arc::new(f));
-        self
-    }
-
-    /// Set callback for when circuit closes
-    pub fn on_close<F>(mut self, f: F) -> Self
-    where
-        F: Fn(&str) + Send + Sync + 'static,
-    {
-        self.callbacks.on_close = Some(Arc::new(f));
-        self
-    }
-
-    /// Set callback for when circuit enters half-open
-    pub fn on_half_open<F>(mut self, f: F) -> Self
-    where
-        F: Fn(&str) + Send + Sync + 'static,
-    {
-        self.callbacks.on_half_open = Some(Arc::new(f));
-        self
-    }
-
-    /// Build the circuit breaker
-    pub fn build(self) -> CircuitBreaker {
-        let storage = self
-            .storage
-            .unwrap_or_else(|| Arc::new(MemoryStorage::new()));
-
-        let context = CircuitContext {
-            name: self.name,
-            config: self.config,
-            storage,
-            failure_classifier: self.failure_classifier,
-            bulkhead: self.bulkhead,
-        };
-
-        CircuitBreaker::with_context_and_callbacks(context, self.callbacks)
-    }
-}
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-
-    #[test]
-    fn test_builder_defaults() {
-        let circuit = CircuitBuilder::new("test").build();
-
-        assert_eq!(circuit.state_name(), "Closed");
-        assert!(circuit.is_closed());
-    }
-
-    #[test]
-    fn test_builder_custom_config() {
-        let circuit = CircuitBuilder::new("test")
-            .failure_threshold(10)
-            .failure_window_secs(120.0)
-            .half_open_timeout_secs(60.0)
-            .success_threshold(3)
-            .build();
-
-        assert!(circuit.is_closed());
-    }
-
-    #[test]
-    fn test_builder_with_callbacks() {
-        use std::sync::atomic::{AtomicBool, Ordering};
-
-        let opened = Arc::new(AtomicBool::new(false));
-        let opened_clone = opened.clone();
-
-        let mut circuit = CircuitBuilder::new("test")
-            .failure_threshold(2)
-            .on_open(move |_name| {
-                opened_clone.store(true, Ordering::SeqCst);
-            })
-            .build();
-
-        // Trigger failures to open circuit
-        let _ = circuit.call(|| Err::<(), _>("error 1"));
-        let _ = circuit.call(|| Err::<(), _>("error 2"));
-
-        // Callback should have been triggered
-        assert!(opened.load(Ordering::SeqCst));
-    }
-}