nonnative 3.13.0 → 3.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 304a9d9d01fafb9f0822e4510c647f87095f78987feecb5a9d2eddc43317a880
-  data.tar.gz: 366157abd34f6ffa48cce159dffd49075e4a98653ea5d3f3b11b2494ad47b4a1
+  metadata.gz: 802f0ee020ba8e7c6cef867895d30c6491ace313fec8103aa6b99726c8402666
+  data.tar.gz: 70d522685a3c9cfbc872ee36549d9ba8274be60138a79db68e64c83115fd7cb5
 SHA512:
-  metadata.gz: 6fa7d92393e3a4df9f400a7f35c857998c13dc026ec85be407fa37d6e8ba2189c5992af70e001c1cdfaf9589d1b6d33a2daf11abf8361f84f07ab8bc3a72fed1
-  data.tar.gz: bf37673b803ff66338009fbbd458d707c6eed9ef0ba618bb53b97e2f5770788708343f6bd34b67758fd6d1a13e464f63edffced76c26591f8ac4fe4ec2267a3e
+  metadata.gz: a0b3e8502437cfd6d3a556a8a6f10901a2a89d85a4689fbad3c68d6819e03b4cccf5a51de3cfd66b86827d66f768891f68ee41c91b3ea504345c7f25d22178c8
+  data.tar.gz: b16ef6cfe6099e9a62be954178c71a743fb297ece661be2651239c8501707af30e1609e58abfe99bc58d007777a45c99505eb374484c0ba9788e886d0b876e42

data/.circleci/config.yml

@@ -17,7 +17,7 @@ executors:
       - image: alexfalkowski/ruby:3.19
   release:
     docker:
-      - image: alexfalkowski/release:8.19
+      - image: alexfalkowski/release:8.20
   alpine:
     docker:
       - image: alpine:latest

data/AGENTS.md

@@ -79,6 +79,32 @@ of dependencies.
   thread. Do not flag the listener `join` as an unbounded reliability gap unless
   the task is explicitly about proxy shutdown behavior or there is a normal-use
   reproducer, failing CI evidence, or platform-specific hang evidence.
+- Service readiness is intentionally TCP-only for externally managed
+  dependencies. Do not flag missing HTTP/gRPC service readiness as a feature gap
+  unless the task is explicitly about changing the `Nonnative::Service`
+  readiness model. HTTP/gRPC readiness belongs to managed processes, where the
+  user explicitly models the application health endpoints.
+- Process runners intentionally inherit the parent working directory. Nonnative
+  is normally run from the test folder that owns `test/nonnative.yml`, relative
+  config paths, logs, and reports. Do not flag missing process cwd/chdir support
+  as a feature gap unless the task is explicitly about changing process working
+  directory behavior.
+- Message-specific start/stop assertions and attempted-stop success assertions
+  in `features/step_definitions/lifecycle_steps.rb` are repository-local
+  Cucumber helpers. Do not flag their absence from `lib/nonnative/cucumber.rb`
+  as a feature gap unless downstream usage evidence exists or the task is
+  explicitly about expanding public lifecycle assertion steps.
+- Liveness, readiness, and metrics endpoint assertion steps in
+  `features/step_definitions/servers_steps.rb` are repository-local Cucumber
+  helpers for testing nonnative's own framework assumptions. Do not flag their
+  absence from `lib/nonnative/cucumber.rb` as a feature gap unless downstream
+  usage evidence exists or the task is explicitly about expanding public
+  observability assertion steps.
+- `Nonnative::Configuration` intentionally exposes `process_by_name` without
+  matching `server_by_name` or `service_by_name` helpers. Do not flag missing
+  server/service configuration lookup helpers as a feature gap unless downstream
+  usage evidence exists or the task is explicitly about changing the
+  pre-start configuration lookup API.
 
 ## Runtime Model
 

data/Gemfile.lock

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

data/README.md

@@ -758,6 +758,7 @@ Clients connect to the service `host`/`port`, while the proxy forwards traffic t
 
 - `close_all` - Closes the socket as soon as it connects.
 - `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.
 
 ###### 🧩 Fault Injection Services
@@ -769,6 +770,7 @@ name = 'name of service in configuration'
 service = Nonnative.pool.service_by_name(name)
 
 service.proxy.close_all # To use close_all.
+service.proxy.timeout # To stall traffic until reset or stop.
 service.proxy.reset # To reset it back to a good state.
 ```
 
@@ -776,6 +778,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 'timeout'
 Then I should reset the proxy for service 'service_1'
 ```
 

data/lib/nonnative/configuration_proxy.rb

@@ -4,8 +4,8 @@ module Nonnative
   # Proxy configuration attached to a service configuration.
   #
   # A proxy allows you to interpose behavior between a client and a real service. For example,
-  # the built-in `"fault_injection"` proxy can close connections, introduce delays, or corrupt data
-  # for resilience testing.
+  # the built-in `"fault_injection"` proxy can close connections, introduce delays, stall traffic,
+  # or corrupt data for resilience testing.
   #
   # This object is created automatically for each service via {Nonnative::ConfigurationService}.
   # When `kind` is set to `"none"`, no proxy is started and the service will use its configured

data/lib/nonnative/cucumber.rb

@@ -56,6 +56,7 @@ module Nonnative
       PROXY_OPERATIONS = {
         'close_all' => :close_all,
         'delay' => :delay,
+        'timeout' => :timeout,
         'invalid_data' => :invalid_data,
         'reset' => :reset
       }.freeze

data/lib/nonnative/fault_injection_proxy.rb

@@ -11,6 +11,7 @@ module Nonnative
   #
   # - {#close_all}: close connections immediately on accept
   # - {#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
   # - {#reset}: return to healthy pass-through behavior
   #
@@ -107,6 +108,17 @@ module Nonnative
       apply_state :delay
     end
 
+    # Accepts connections and stalls without forwarding bytes.
+    #
+    # This simulates a dependency that accepts a TCP connection but leaves clients waiting until
+    # their own read timeout fires. The proxy keeps the connection silent until reset or stop closes
+    # active connections.
+    #
+    # @return [void]
+    def timeout
+      apply_state :timeout
+    end
+
     # Mutates upstream responses while forwarding client requests unchanged.
     #
     # @return [void]

data/lib/nonnative/socket_pair.rb

@@ -16,6 +16,7 @@ module Nonnative
   # @see Nonnative::SocketPairFactory
   # @see Nonnative::CloseAllSocketPair
   # @see Nonnative::DelaySocketPair
+  # @see Nonnative::TimeoutSocketPair
   # @see Nonnative::InvalidDataSocketPair
   class SocketPair
     # @param proxy [#host, #port, #options] proxy configuration used to connect upstream

data/lib/nonnative/socket_pair_factory.rb

@@ -10,18 +10,20 @@ module Nonnative
   # - `:none` (or any unknown value) -> {Nonnative::SocketPair} (pass-through)
   # - `:close_all` -> {Nonnative::CloseAllSocketPair}
   # - `:delay` -> {Nonnative::DelaySocketPair}
+  # - `:timeout` -> {Nonnative::TimeoutSocketPair}
   # - `:invalid_data` -> {Nonnative::InvalidDataSocketPair}
   #
   # @see Nonnative::FaultInjectionProxy
   # @see Nonnative::SocketPair
   # @see Nonnative::CloseAllSocketPair
   # @see Nonnative::DelaySocketPair
+  # @see Nonnative::TimeoutSocketPair
   # @see Nonnative::InvalidDataSocketPair
   class SocketPairFactory
     class << self
       # Creates a socket-pair instance for the given proxy state.
       #
-      # @param kind [Symbol] proxy state (e.g. `:none`, `:close_all`, `:delay`, `:invalid_data`)
+      # @param kind [Symbol] proxy state (e.g. `:none`, `:close_all`, `: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)
@@ -30,6 +32,8 @@ module Nonnative
                  CloseAllSocketPair
                when :delay
                  DelaySocketPair
+               when :timeout
+                 TimeoutSocketPair
                when :invalid_data
                  InvalidDataSocketPair
                else

data/lib/nonnative/timeout_socket_pair.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Nonnative
+  # Socket-pair variant used by the fault-injection proxy to simulate read timeouts.
+  #
+  # When active, the proxy accepts the client connection and keeps it open without forwarding bytes.
+  # Clients with read deadlines should observe their own timeout behavior.
+  #
+  # This behavior is enabled by calling {Nonnative::FaultInjectionProxy#timeout}.
+  #
+  # @see Nonnative::FaultInjectionProxy
+  # @see Nonnative::SocketPairFactory
+  # @see Nonnative::SocketPair
+  class TimeoutSocketPair < SocketPair
+    # Keeps the accepted socket silent until reset or stop closes active proxy connections.
+    #
+    # @param local_socket [TCPSocket] the accepted client socket
+    # @return [void]
+    def connect(local_socket)
+      @local_socket = local_socket
+
+      Nonnative.logger.info "stalling socket '#{local_socket.inspect}' for 'timeout' pair"
+
+      # Do not call super: the base implementation opens the upstream socket and forwards traffic.
+      sleep 0.1 until local_socket.closed?
+    ensure
+      close
+    end
+  end
+end

data/lib/nonnative/version.rb

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

data/lib/nonnative.rb

@@ -102,6 +102,7 @@ require 'nonnative/fault_injection_proxy'
 require 'nonnative/socket_pair'
 require 'nonnative/close_all_socket_pair'
 require 'nonnative/delay_socket_pair'
+require 'nonnative/timeout_socket_pair'
 require 'nonnative/invalid_data_socket_pair'
 require 'nonnative/socket_pair_factory'
 require 'nonnative/go_executable'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nonnative
 version: !ruby/object:Gem::Version
-  version: 3.13.0
+  version: 3.14.0
 platform: ruby
 authors:
 - Alejandro Falkowski
@@ -330,6 +330,7 @@ files:
 - lib/nonnative/stop_error.rb
 - lib/nonnative/tcp_probe.rb
 - lib/nonnative/timeout.rb
+- lib/nonnative/timeout_socket_pair.rb
 - lib/nonnative/version.rb
 - nonnative.gemspec
 homepage: https://github.com/alexfalkowski/nonnative