nonnative 3.18.0 → 3.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5b12a0346b56caafe5c5c3b569be5d413f549881aaff7b11a5f32790fcdb9a8
-  data.tar.gz: 34c07a08b757d56c2a03180f988c90227f1a4fa2b5a3e4f98dc0d893fd18eaa9
+  metadata.gz: 011e40916b32666c33c2a0374ee97c3e96d563cf950f5c68e12b8afa7c18e986
+  data.tar.gz: 7b21a33ad8fc14077751e679b66a14523c79c0783004934f55fa61ea5608e477
 SHA512:
-  metadata.gz: 1bcbc6b9874a9ee048b4aac19382fc6d241f6d1ff616c787fede90c8957a8e51180dc8101aa41574e980098d1805937d7475e15212402b8f4cfb5a71d509091c
-  data.tar.gz: 9efff6226af6557162861d81f43976bfcde15991aa736715e140f7bc22cae1a8a28a65ec18d332a5f09997fc95fb755d7418a9e4156118ba7152c8bc3fb6be39
+  metadata.gz: 0e24fea055ed0e972507bfcb8ebbdf2c604d41e1a6908333a1863f1ba44dd356ea518936d3d6076f73fb37d0c3a9f593b6321ef1392d51d6d1cdf4c145b5ad6d
+  data.tar.gz: ec70302587120b093bb506d5d324821e880b10e406974822f44e1efa7c3fdee29465847eb8f71466ab3806ddd0eb328f2e0788bca28196066c6b3636ce0edb83

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nonnative (3.18.0)
+    nonnative (3.19.0)
       concurrent-ruby (>= 1, < 2)
       config (>= 5, < 6)
       cucumber (>= 7, < 12)

data/README.md

@@ -788,6 +788,7 @@ The `fault_injection` proxy allows you to simulate failures by injecting them. W
 Clients connect to the service `host`/`port`, while the proxy forwards traffic to nested `proxy.host`/`proxy.port`.
 
 - `close_all` - Closes the socket as soon as it connects.
+- `reset_peer` - Resets the socket as soon as it connects, so clients observe a TCP reset (`Errno::ECONNRESET`) rather than the graceful close performed by `close_all`.
 - `delay` - Delays traffic on the connection. Defaults to 2 seconds and can be configured through options.
 - `timeout` - Accepts the connection and stalls traffic until reset or stop closes the connection, so clients exercise their own read timeout behavior.
 - `invalid_data` - Forwards client requests unchanged, then corrupts upstream responses before they reach the client.
@@ -801,6 +802,7 @@ name = 'name of service in configuration'
 service = Nonnative.pool.service_by_name(name)
 
 service.proxy.close_all # To use close_all.
+service.proxy.reset_peer # To reset (RST) client connections.
 service.proxy.timeout # To stall traffic until reset or stop.
 service.proxy.reset # To reset it back to a good state.
 ```
@@ -809,6 +811,7 @@ Use the Cucumber proxy steps:
 
 ```cucumber
 Given I set the proxy for service 'service_1' to 'close_all'
+Given I set the proxy for service 'service_1' to 'reset_peer'
 Given I set the proxy for service 'service_1' to 'timeout'
 Then I should reset the proxy for service 'service_1'
 ```

data/lib/nonnative/cucumber.rb

@@ -55,6 +55,7 @@ module Nonnative
     module ProxySteps
       PROXY_OPERATIONS = {
         'close_all' => :close_all,
+        'reset_peer' => :reset_peer,
         'delay' => :delay,
         'timeout' => :timeout,
         'invalid_data' => :invalid_data,

data/lib/nonnative/fault_injection_proxy.rb

@@ -10,6 +10,7 @@ module Nonnative
   # This class exposes a small public control surface for tests:
   #
   # - {#close_all}: close connections immediately on accept
+  # - {#reset_peer}: reset connections immediately on accept (TCP RST rather than a graceful close)
   # - {#delay}: delay reads by a configured duration (default: 2 seconds)
   # - {#timeout}: accept connections and keep them silent until clients time out
   # - {#invalid_data}: forward requests unchanged and mutate upstream responses before they reach clients
@@ -99,6 +100,16 @@ module Nonnative
       apply_state :close_all
     end
 
+    # Forces new connections to be reset immediately.
+    #
+    # Unlike {#close_all}, which closes the socket gracefully (FIN), this closes the accepted socket
+    # with a zero linger timeout so clients observe a TCP reset (`Errno::ECONNRESET`).
+    #
+    # @return [void]
+    def reset_peer
+      apply_state :reset_peer
+    end
+
     # Delays reads before forwarding.
     #
     # The delay duration is controlled by `service.proxy.options[:delay]` and defaults to 2 seconds.

data/lib/nonnative/reset_peer_socket_pair.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Nonnative
+  # Socket-pair variant used by the fault-injection proxy to simulate an abrupt connection reset.
+  #
+  # When active, the proxy accepts a TCP connection and closes it with a zero linger timeout, so the
+  # kernel sends a TCP RST instead of a graceful FIN. Clients observe a reset ("connection reset by
+  # peer", `Errno::ECONNRESET`) rather than a clean end-of-stream, which is distinct from the graceful
+  # close performed by {Nonnative::CloseAllSocketPair}.
+  #
+  # This behavior is enabled by calling {Nonnative::FaultInjectionProxy#reset_peer}.
+  #
+  # @see Nonnative::FaultInjectionProxy
+  # @see Nonnative::SocketPairFactory
+  # @see Nonnative::SocketPair
+  # @see Nonnative::CloseAllSocketPair
+  class ResetPeerSocketPair < SocketPair
+    # Resets the accepted socket by closing it with a zero linger timeout, forcing a TCP RST.
+    #
+    # @param local_socket [TCPSocket] the accepted client socket
+    # @return [void]
+    def connect(local_socket)
+      Nonnative.logger.info "resetting socket '#{local_socket.inspect}' for 'reset_peer' pair"
+
+      local_socket.setsockopt(Socket::Option.linger(true, 0))
+      local_socket.close
+    end
+  end
+end

data/lib/nonnative/socket_pair_factory.rb

@@ -9,6 +9,7 @@ module Nonnative
   # Proxy states are mapped as follows:
   # - `:none` (or any unknown value) -> {Nonnative::SocketPair} (pass-through)
   # - `:close_all` -> {Nonnative::CloseAllSocketPair}
+  # - `:reset_peer` -> {Nonnative::ResetPeerSocketPair}
   # - `:delay` -> {Nonnative::DelaySocketPair}
   # - `:timeout` -> {Nonnative::TimeoutSocketPair}
   # - `:invalid_data` -> {Nonnative::InvalidDataSocketPair}
@@ -16,6 +17,7 @@ module Nonnative
   # @see Nonnative::FaultInjectionProxy
   # @see Nonnative::SocketPair
   # @see Nonnative::CloseAllSocketPair
+  # @see Nonnative::ResetPeerSocketPair
   # @see Nonnative::DelaySocketPair
   # @see Nonnative::TimeoutSocketPair
   # @see Nonnative::InvalidDataSocketPair
@@ -23,13 +25,15 @@ module Nonnative
     class << self
       # Creates a socket-pair instance for the given proxy state.
       #
-      # @param kind [Symbol] proxy state (e.g. `:none`, `:close_all`, `:delay`, `:timeout`, `:invalid_data`)
+      # @param kind [Symbol] proxy state (e.g. `:none`, `:close_all`, `:reset_peer`, `:delay`, `:timeout`, `:invalid_data`)
       # @param proxy [Nonnative::ConfigurationProxy] proxy configuration (host/port/options)
       # @return [Nonnative::SocketPair] a socket-pair implementation instance
       def create(kind, proxy)
         pair = case kind
                when :close_all
                  CloseAllSocketPair
+               when :reset_peer
+                 ResetPeerSocketPair
                when :delay
                  DelaySocketPair
                when :timeout

data/lib/nonnative/version.rb

@@ -4,5 +4,5 @@ module Nonnative
   # The current gem version.
   #
   # @return [String]
-  VERSION = '3.18.0'
+  VERSION = '3.19.0'
 end

data/lib/nonnative.rb

@@ -111,6 +111,7 @@ require 'nonnative/no_proxy'
 require 'nonnative/fault_injection_proxy'
 require 'nonnative/socket_pair'
 require 'nonnative/close_all_socket_pair'
+require 'nonnative/reset_peer_socket_pair'
 require 'nonnative/delay_socket_pair'
 require 'nonnative/timeout_socket_pair'
 require 'nonnative/invalid_data_socket_pair'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nonnative
 version: !ruby/object:Gem::Version
-  version: 3.18.0
+  version: 3.19.0
 platform: ruby
 authors:
 - Alejandro Falkowski
@@ -446,6 +446,7 @@ files:
 - lib/nonnative/process.rb
 - lib/nonnative/proxy.rb
 - lib/nonnative/proxy_factory.rb
+- lib/nonnative/reset_peer_socket_pair.rb
 - lib/nonnative/runner.rb
 - lib/nonnative/server.rb
 - lib/nonnative/service.rb