nonnative 3.0.0 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 786062cd10bbaba4298dd41abc683bc7a5fd769ea7c41a05e39a9f41bc2c5d96
-  data.tar.gz: 1d0e8303858861f849aacbcb54ba2bac1f5a8336fdb74c44d09cb48881658c9f
+  metadata.gz: 3015cc7b1f784a45dbb77184fd73e67e6cf33ff9d7bb97d09ebd01f1359d85b9
+  data.tar.gz: 9bf8f2fc9bb72f8de89e76f44912d62e8a7cd19ccb533c7930600fbc70411b28
 SHA512:
-  metadata.gz: 729e1141493b2b21c5c9014216a73aade7f7ec1ab03686ab581cbcb1b1c28d2d469a4fd5e416bcd391c2f8056725433a0befe40c283357166b0743f3f4f2d834
-  data.tar.gz: e17dfe6bd69bbf4d0faf76d0b37502a32abf1ca0943d24f261c4c32301be86fff18e302f65dc9af32ac499ca73d5fe4a08ede17422d2de715a15b4c986ea64c7
+  metadata.gz: 73147dafad8a271673d070f033a1a3f92270994b0593bb7f391d0ae126ed0e34005cfd22af9e01052846bd757b866fba9db4d36a3468219be54208e8121a5f80
+  data.tar.gz: ad58bc0015ccdf3f91f9ffbb5ca12de3bd9650d540ef33ec982df353abd6892c496328815f60991e340721971e1bfbf86a663292337a755280d1157c2ff9d5be

data/Gemfile.lock

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

data/README.md

@@ -10,7 +10,7 @@ Nonnative is a Ruby-first harness for end-to-end testing of systems implemented
 It helps you:
 - start **OS processes** (e.g. your Go/Java/Rust service binary),
 - start **in-process Ruby servers** (e.g. small HTTP/TCP/gRPC fakes for dependencies),
-- optionally start **proxies** in front of processes/servers/services for fault-injection,
+- optionally start **service proxies** for fault-injection in front of externally managed dependencies,
 - wait for readiness/shutdown using **TCP port checks**.
 
 Once started, you can test however you like (TCP, HTTP, gRPC, etc).
@@ -54,23 +54,22 @@ High-level configuration fields:
 - `log`: path for the Nonnative logger output.
 - `processes`: child processes to `spawn`.
 - `servers`: in-process Ruby servers started in threads.
-- `services`: external dependencies (proxy-only; no process/thread started by Nonnative).
+- `services`: external dependencies (no process/thread started by Nonnative).
 
 Common runner fields:
 - `name`: runner name used for lookup.
-- `host`/`ports`: client-facing address. `host` defaults to `127.0.0.1`. For processes and servers, this address is also used for readiness/shutdown port checks. When a `fault_injection` proxy is enabled, clients should hit the first configured port.
+- `host`: client-facing host. Defaults to `127.0.0.1`.
 
 Process/server fields:
+- `ports`: client-facing ports. These are also used for readiness/shutdown port checks.
 - `timeout`: max time (seconds) for readiness/shutdown port checks.
 - `wait`: small sleep (seconds) between lifecycle steps.
 - `log`: per-runner log file used by process output redirection or server implementations.
 
-For `fault_injection`, the nested `proxy.host`/`proxy.port` describe the upstream target behind the proxy. Nested `proxy.host` also defaults to `127.0.0.1`. In-process server implementations typically bind there via `proxy.host` / `proxy.port`.
+Service fields:
+- `port`: client-facing service port. Services do not get TCP readiness/shutdown checks from Nonnative.
 
-> [!IMPORTANT]
-> When a proxy is enabled, tests and clients connect to the runner `host` and first configured `ports` entry; the nested `proxy.host`/`proxy.port` is the upstream target behind the proxy.
-
-Nonnative readiness and shutdown checks are TCP-only. Configure ports that are dedicated to the test run; if another process is already listening on the same `host`/`ports` endpoint, results are undefined.
+Nonnative readiness and shutdown checks are TCP-only. Configure process/server ports that are dedicated to the test run; if another process is already listening on the same endpoint, results are undefined.
 
 > [!WARNING]
 > Readiness and shutdown checks only prove that a TCP port opened or closed. They do not verify HTTP status, gRPC health, schema readiness, migrations, or application-specific health.
@@ -248,7 +247,7 @@ module Nonnative
     def initialize(service)
       super
 
-      @socket_server = ::TCPServer.new(proxy.host, proxy.port)
+      @socket_server = ::TCPServer.new(service.host, service.port)
     end
 
     def perform_start
@@ -405,9 +404,9 @@ Nonnative.configure do |config|
 end
 ```
 
-##### 🔀 Proxy
+##### 🔀 HTTP Forward Proxy
 
-The system allows you to define an HTTP proxy for external systems, e.g. `api.github.com`.
+The system allows you to define an in-process HTTP forward proxy server for external systems, e.g. `api.github.com`. This is a server implementation, not a fault-injection service proxy.
 
 Define your server:
 
@@ -543,9 +542,9 @@ end
 
 ### 🧩 Services
 
-A service is an external dependency to your system that you **do not** want Nonnative to start (no OS process, no Ruby thread). Services are primarily useful when paired with proxies, because they let you inject failures into dependencies that are managed elsewhere (e.g. a DB running in Docker).
+A service is an external dependency to your system that you **do not** want Nonnative to start (no OS process, no Ruby thread).
 
-Services do not get process lifecycle management or TCP readiness/shutdown checks from Nonnative. They only provide a named runner and optional proxy lifecycle for a dependency that another tool already manages.
+Services do not get process lifecycle management or TCP readiness/shutdown checks from Nonnative. They provide a named endpoint for a dependency that another tool already manages.
 
 Set it up programmatically:
 
@@ -561,13 +560,13 @@ Nonnative.configure do |config|
   config.service do |s|
     s.name = 'postgres'
     s.host = '127.0.0.1'
-    s.ports = [5432]
+    s.port = 5432
   end
 
   config.service do |s|
     s.name = 'redis'
     s.host = '127.0.0.1'
-    s.ports = [6379]
+    s.port = 6379
   end
 end
 ```
@@ -583,13 +582,11 @@ services:
   -
     name: postgres
     host: 127.0.0.1
-    ports:
-      - 5432
+    port: 5432
   -
     name: redis
     host: 127.0.0.1
-    ports:
-      - 6379
+    port: 6379
 ```
 
 Then load the file with:
@@ -618,159 +615,43 @@ Custom proxy kinds can be registered through `Nonnative.proxies`:
 Nonnative.proxies['custom'] = CustomProxy
 ```
 
-For `fault_injection`, keep the runner `host` and first `ports` entry as the client-facing endpoint and use nested `proxy.host`/`proxy.port` for the upstream target behind the proxy.
-
-##### ⚙️ Process Proxies
-
-Add this to an existing process configuration:
-
-```ruby
-require 'nonnative'
-
-Nonnative.configure do |config|
-  config.version = '1.0'
-  config.name = 'test'
-  config.url = 'http://localhost:4567'
-  config.log = 'nonnative.log'
-
-  config.process do |p|
-    p.host = '127.0.0.1'
-    p.ports = [20_000]
-
-    p.proxy = {
-      kind: 'fault_injection',
-      host: '127.0.0.1',
-      port: 12_321,
-      log: 'proxy_server.log',
-      wait: 1,
-      options: {
-        delay: 5
-      }
-    }
-  end
-end
-```
-
-YAML fragment:
+Only services support proxies. For `fault_injection`, keep the service `host`/`port` as the client-facing proxy endpoint and use nested `proxy.host`/`proxy.port` for the upstream target behind the proxy.
 
-```yaml
-version: "1.0"
-name: test
-url: http://localhost:4567
-log: nonnative.log
-processes:
-  -
-    host: 127.0.0.1
-    ports:
-      - 20000
-    proxy:
-      kind: fault_injection
-      host: 127.0.0.1
-      port: 12321
-      log: proxy_server.log
-      wait: 1
-      options:
-        delay: 5
-```
+##### 🧩 Service Proxies
 
-##### 🖥️ Server Proxies
+###### Programmatic Configuration
 
-Add this to an existing server configuration:
+Add a proxy to a service configuration:
 
 ```ruby
-require 'nonnative'
-
-Nonnative.configure do |config|
-  config.version = '1.0'
-  config.name = 'test'
-  config.url = 'http://localhost:4567'
-  config.log = 'nonnative.log'
-
-  config.server do |s|
-    s.host = '127.0.0.1'
-    s.ports = [20_000]
-
-    s.proxy = {
-      kind: 'fault_injection',
-      host: '127.0.0.1',
-      port: 12_321,
-      log: 'proxy_server.log',
-      wait: 1,
-      options: {
-        delay: 5
-      }
+config.service do |s|
+  s.name = 'redis'
+  s.host = '127.0.0.1'
+  s.port = 16_379
+
+  s.proxy = {
+    kind: 'fault_injection',
+    host: '127.0.0.1',
+    port: 6379,
+    log: 'proxy_server.log',
+    wait: 1,
+    options: {
+      delay: 5
     }
-  end
+  }
 end
 ```
 
-YAML fragment:
-
-```yaml
-version: "1.0"
-name: test
-url: http://localhost:4567
-log: nonnative.log
-servers:
-  -
-    host: 127.0.0.1
-    ports:
-      - 20000
-    proxy:
-      kind: fault_injection
-      host: 127.0.0.1
-      port: 12321
-      log: proxy_server.log
-      wait: 1
-      options:
-        delay: 5
-```
-
-##### 🧩 Service Proxies
-
-Add this to an existing service configuration:
-
-```ruby
-require 'nonnative'
-
-Nonnative.configure do |config|
-  config.version = '1.0'
-  config.name = 'test'
-  config.url = 'http://localhost:4567'
-  config.log = 'nonnative.log'
-
-  config.service do |s|
-    s.name = 'redis'
-    s.host = '127.0.0.1'
-    s.ports = [16_379]
-
-    s.proxy = {
-      kind: 'fault_injection',
-      host: '127.0.0.1',
-      port: 6379,
-      log: 'proxy_server.log',
-      wait: 1,
-      options: {
-        delay: 5
-      }
-    }
-  end
-end
-```
+###### YAML Configuration
 
-YAML fragment:
+Add a proxy to a service YAML entry:
 
 ```yaml
-version: "1.0"
-name: test
-url: http://localhost:4567
-log: nonnative.log
 services:
   -
     name: redis
     host: 127.0.0.1
-    ports:
-      - 16379
+    port: 16379
     proxy:
       kind: fault_injection
       host: 127.0.0.1
@@ -785,53 +666,15 @@ services:
 
 The `fault_injection` proxy allows you to simulate failures by injecting them. We currently support the following:
 
-Clients connect to the runner `host` and first configured `ports` entry, while the proxy forwards traffic to nested `proxy.host`/`proxy.port`.
+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.
 - `delay` - Delays traffic on the connection. Defaults to 2 seconds and can be configured through options.
 - `invalid_data` - Forwards client requests unchanged, then corrupts upstream responses before they reach the client.
 
-###### ⚙️ Fault Injection Processes
-
-Set it up programmatically:
-
-```ruby
-name = 'name of process in configuration'
-server = Nonnative.pool.process_by_name(name)
-
-server.proxy.close_all # To use close_all.
-server.proxy.reset # To reset it back to a good state.
-```
-
-With cucumber:
-
-```cucumber
-Given I set the proxy for process 'process_1' to 'close_all'
-Then I should reset the proxy for process 'process_1'
-```
-
-###### 🖥️ Fault Injection Servers
-
-Set it up programmatically:
-
-```ruby
-name = 'name of server in configuration'
-server = Nonnative.pool.server_by_name(name)
-
-server.proxy.close_all # To use close_all.
-server.proxy.reset # To reset it back to a good state.
-```
-
-With cucumber:
-
-```cucumber
-Given I set the proxy for server 'server_1' to 'close_all'
-Then I should reset the proxy for server 'server_1'
-```
-
 ###### 🧩 Fault Injection Services
 
-Set it up programmatically:
+Set the proxy state programmatically:
 
 ```ruby
 name = 'name of service in configuration'
@@ -841,7 +684,7 @@ service.proxy.close_all # To use close_all.
 service.proxy.reset # To reset it back to a good state.
 ```
 
-With cucumber:
+Use the Cucumber proxy steps:
 
 ```cucumber
 Given I set the proxy for service 'service_1' to 'close_all'

data/lib/nonnative/configuration.rb

@@ -124,13 +124,13 @@ module Nonnative
     def add_processes(cfg)
       processes = cfg.processes || []
       processes.each do |loaded_process|
+        reject_proxy(loaded_process, 'processes')
+
         process do |process_config|
           process_config.command = command(loaded_process)
           process_config.signal = loaded_process.signal
           process_config.environment = loaded_process.environment
           runner_attributes(process_config, loaded_process)
-
-          assign_proxy(process_config, loaded_process.proxy)
         end
       end
     end
@@ -150,11 +150,11 @@ module Nonnative
     def add_servers(cfg)
       servers = cfg.servers || []
       servers.each do |loaded_server|
+        reject_proxy(loaded_server, 'servers')
+
         server do |server_config|
           server_config.klass = Object.const_get(server_class_name(loaded_server))
           runner_attributes(server_config, loaded_server)
-
-          assign_proxy(server_config, loaded_server.proxy)
         end
       end
     end
@@ -165,7 +165,7 @@ module Nonnative
         service do |service_config|
           service_config.name = loaded_service.name
           service_config.host = loaded_service.host if loaded_service.host
-          assign_ports(service_config, loaded_service)
+          assign_service_port(service_config, loaded_service)
 
           assign_proxy(service_config, loaded_service.proxy)
         end
@@ -193,7 +193,21 @@ module Nonnative
       runner.ports = loaded.ports if loaded.ports
     end
 
-    def assign_proxy(runner, loaded_proxy)
+    def assign_service_port(service, loaded)
+      values = loaded.to_h
+      raise ArgumentError, "Use 'port' instead of 'ports' for service '#{loaded.name}'" if values.key?(:ports) || values.key?('ports')
+
+      service.port = loaded.port if loaded.port
+    end
+
+    def reject_proxy(loaded, kind)
+      values = loaded.to_h
+      return unless values.key?(:proxy) || values.key?('proxy')
+
+      raise ArgumentError, "Use 'services' for proxy configuration; #{kind} do not support 'proxy'"
+    end
+
+    def assign_proxy(service, loaded_proxy)
       return unless loaded_proxy
 
       proxy_attributes = {
@@ -206,7 +220,7 @@ module Nonnative
       proxy_attributes[:host] = loaded_proxy.host if loaded_proxy.host
       proxy_attributes[:wait] = loaded_proxy.wait if loaded_proxy.wait
 
-      runner.proxy = proxy_attributes
+      service.proxy = proxy_attributes
     end
   end
 end

data/lib/nonnative/configuration_proxy.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
 module Nonnative
-  # Proxy configuration attached to a runner configuration.
+  # 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.
   #
-  # This object is created automatically for each runner via {Nonnative::ConfigurationRunner}.
-  # When `kind` is set to `"none"`, no proxy is started and the runner will use its configured
+  # 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
   # `host`/`port` directly.
   #
-  # @see Nonnative::ConfigurationRunner#proxy
+  # @see Nonnative::ConfigurationService#proxy
   # @see Nonnative.proxies
   class ConfigurationProxy
     # @return [String] proxy kind name (for example `"none"` or `"fault_injection"`)

data/lib/nonnative/configuration_runner.rb

@@ -3,8 +3,7 @@
 module Nonnative
   # Base configuration for a runnable unit managed by Nonnative.
   #
-  # This class holds connection and timing attributes common to processes, servers and services,
-  # as well as a nested {Nonnative::ConfigurationProxy} describing how/if a proxy should be started.
+  # This class holds connection and timing attributes common to processes, servers and services.
   #
   # Instances of this type are typically created via {Nonnative::Configuration#process},
   # {Nonnative::Configuration#server}, or {Nonnative::Configuration#service}.
@@ -22,29 +21,18 @@ module Nonnative
     # @return [Array<Integer>] client-facing ports used for readiness/shutdown checks
     attr_reader :ports
 
-    # Proxy configuration for this runner.
-    #
-    # Note that this returns a configuration object even if no proxy is enabled; by default
-    # the proxy kind is `"none"`.
-    #
-    # @return [Nonnative::ConfigurationProxy]
-    attr_reader :proxy
-
     # Creates a runner configuration with defaults.
     #
     # Defaults:
     # - `host`: `"127.0.0.1"`
     # - `ports`: `[0]`
     # - `wait`: `0.1`
-    # - `proxy`: a new {Nonnative::ConfigurationProxy} with its own defaults
     #
     # @return [void]
     def initialize
       self.host = '127.0.0.1'
-      self.ports = [0]
+      @ports = [0]
       self.wait = 0.1
-
-      @proxy = Nonnative::ConfigurationProxy.new
     end
 
     # Sets the client-facing ports for this runner.
@@ -57,34 +45,11 @@ module Nonnative
 
     # Returns the primary client-facing port.
     #
-    # This preserves a single endpoint for proxy binding and client helpers while the public
-    # configuration contract uses {#ports}.
+    # This preserves a single endpoint for client helpers while the public configuration contract uses {#ports}.
     #
     # @return [Integer]
     def port
       ports.first
     end
-
-    # Sets proxy configuration using a hash-like value.
-    #
-    # This is primarily used when loading YAML configuration files, where proxy attributes are
-    # represented as scalar values.
-    #
-    # @param value [Hash] proxy attributes
-    # @option value [String] :kind proxy kind name (for example `"fault_injection"`)
-    # @option value [String] :host upstream host behind the proxy (optional)
-    # @option value [Integer] :port upstream port behind the proxy
-    # @option value [String] :log proxy log file path
-    # @option value [Numeric] :wait wait interval (seconds) after state changes (optional)
-    # @option value [Hash] :options proxy implementation specific options
-    # @return [void]
-    def proxy=(value)
-      proxy.kind = value[:kind]
-      proxy.host = value[:host] if value[:host]
-      proxy.port = value[:port]
-      proxy.log = value[:log]
-      proxy.wait = value[:wait] if value[:wait]
-      proxy.options = value[:options]
-    end
   end
 end

data/lib/nonnative/configuration_service.rb

@@ -11,5 +11,61 @@ module Nonnative
   # @see Nonnative::Configuration
   # @see Nonnative::Service
   class ConfigurationService < ConfigurationRunner
+    # @return [Integer] client-facing port used by the service proxy
+    attr_accessor :port
+
+    # Proxy configuration for this service.
+    #
+    # @return [Nonnative::ConfigurationProxy]
+    attr_reader :proxy
+
+    # Creates a service configuration with defaults.
+    #
+    # @return [void]
+    def initialize
+      super
+
+      self.port = 0
+      @proxy = Nonnative::ConfigurationProxy.new
+    end
+
+    # Sets proxy configuration using a hash-like value.
+    #
+    # This is primarily used when loading YAML configuration files, where proxy attributes are
+    # represented as scalar values.
+    #
+    # @param value [Hash] proxy attributes
+    # @option value [String] :kind proxy kind name (for example `"fault_injection"`)
+    # @option value [String] :host upstream host behind the proxy (optional)
+    # @option value [Integer] :port upstream port behind the proxy
+    # @option value [String] :log proxy log file path
+    # @option value [Numeric] :wait wait interval (seconds) after state changes (optional)
+    # @option value [Hash] :options proxy implementation specific options
+    # @return [void]
+    def proxy=(value)
+      proxy.kind = value[:kind]
+      proxy.host = value[:host] if value[:host]
+      proxy.port = value[:port]
+      proxy.log = value[:log]
+      proxy.wait = value[:wait] if value[:wait]
+      proxy.options = value[:options]
+    end
+
+    # Services expose a single proxy listener, so plural runner ports are not supported.
+    #
+    # @return [void]
+    # @raise [ArgumentError] when plural service ports are read
+    def ports
+      raise ArgumentError, "Use 'port' instead of 'ports' for service '#{name}'"
+    end
+
+    # Services expose a single proxy listener, so plural runner ports are not supported.
+    #
+    # @param _value [Array<Integer>] ignored plural ports
+    # @return [void]
+    # @raise [ArgumentError] when plural service ports are assigned
+    def ports=(_value)
+      raise ArgumentError, "Use 'port' instead of 'ports' for service '#{name}'"
+    end
   end
 end

data/lib/nonnative/cucumber.rb

@@ -45,16 +45,6 @@ module Nonnative
       end
 
       def install_proxy_mutation_steps
-        Given('I set the proxy for process {string} to {string}') do |name, operation|
-          process = Nonnative.pool.process_by_name(name)
-          Nonnative::Cucumber::Registration.apply_proxy_operation(process.proxy, operation)
-        end
-
-        Given('I set the proxy for server {string} to {string}') do |name, operation|
-          server = Nonnative.pool.server_by_name(name)
-          Nonnative::Cucumber::Registration.apply_proxy_operation(server.proxy, operation)
-        end
-
         Given('I set the proxy for service {string} to {string}') do |name, operation|
           service = Nonnative.pool.service_by_name(name)
           Nonnative::Cucumber::Registration.apply_proxy_operation(service.proxy, operation)
@@ -62,16 +52,6 @@ module Nonnative
       end
 
       def install_proxy_reset_steps
-        Then('I should reset the proxy for process {string}') do |name|
-          process = Nonnative.pool.process_by_name(name)
-          process.proxy.reset
-        end
-
-        Then('I should reset the proxy for server {string}') do |name|
-          server = Nonnative.pool.server_by_name(name)
-          server.proxy.reset
-        end
-
         Then('I should reset the proxy for service {string}') do |name|
           service = Nonnative.pool.service_by_name(name)
           service.proxy.reset

data/lib/nonnative/fault_injection_proxy.rb

@@ -18,12 +18,12 @@ module Nonnative
   #
   # ## Wiring
   #
-  # When enabled, your test/client should connect to the runner `host` and first configured port (the
-  # proxy endpoint), and the proxy will forward traffic to the upstream target exposed by {#host}:{#port}.
+  # When enabled, your test/client should connect to the service `host` and `port` (the proxy
+  # endpoint), and the proxy will forward traffic to the upstream target exposed by {#host}:{#port}.
   #
   # ## Configuration
   #
-  # The proxy is configured via the runner’s `proxy` hash:
+  # The proxy is configured via the service's `proxy` hash:
   #
   # - `kind`: `"fault_injection"`
   # - `host` / `port`: upstream target behind the proxy (exposed via {#host}/{#port})
@@ -50,7 +50,7 @@ module Nonnative
       end
     end
 
-    # @param service [Nonnative::ConfigurationRunner] runner configuration with proxy settings
+    # @param service [Nonnative::ConfigurationService] service configuration with proxy settings
     def initialize(service)
       @connections = Concurrent::Hash.new
       @logger = Logger.new(service.proxy.log)
@@ -62,8 +62,8 @@ module Nonnative
 
     # Starts the proxy accept loop in a background thread.
     #
-    # This binds a TCP server on the underlying runner’s `service.host` and first configured port.
-    # Clients connect to that runner endpoint, while upstream traffic is forwarded to {#host}:{#port}.
+    # This binds a TCP server on the service `host` and `port`.
+    # Clients connect to that service endpoint, while upstream traffic is forwarded to {#host}:{#port}.
     #
     # @return [void]
     def start

data/lib/nonnative/grpc_server.rb

@@ -4,8 +4,7 @@ module Nonnative
   # gRPC server runner implemented using {GRPC::RpcServer}.
   #
   # This is a convenience server implementation for running a gRPC service in-process under
-  # Nonnative's server lifecycle. It binds to the configured proxy `host`/`port` and is started/stopped
-  # by {Nonnative::Server} via {#perform_start} / {#perform_stop}.
+  # Nonnative's server lifecycle. It binds to the configured server `host` and first `ports` entry.
   #
   # Important note about logging: the `grpc` gem uses a global logger. This implementation sets
   # `GRPC.logger` to write to the configured `service.log`, and whichever gRPC server is initialized
@@ -33,12 +32,11 @@ module Nonnative
 
     # Binds the gRPC server and begins serving requests.
     #
-    # The server binds to the upstream proxy host/port so the fault-injection proxy can expose the
-    # runner host and first configured port as the client-facing endpoint used by readiness checks.
+    # The server binds to the configured server host and first configured port.
     #
     # @return [void]
     def perform_start
-      server.add_http2_port("#{proxy.host}:#{proxy.port}", :this_port_is_insecure)
+      server.add_http2_port("#{service.host}:#{service.port}", :this_port_is_insecure)
       server.run
     end
 

data/lib/nonnative/http_server.rb

@@ -4,8 +4,7 @@ module Nonnative
   # Puma-based HTTP server runner.
   #
   # This is a convenience server implementation for running a Rack/Sinatra application in-process
-  # under Nonnative's server lifecycle. It binds to the configured proxy `host`/`port` (so it works
-  # consistently with proxy configuration) and uses Puma for HTTP serving.
+  # under Nonnative's server lifecycle. It binds to the configured server `host` and first `ports` entry.
   #
   # The server is started and stopped by {Nonnative::Server} via {#perform_start} / {#perform_stop}.
   #
@@ -48,12 +47,11 @@ module Nonnative
 
     # Binds the Puma server and begins serving.
     #
-    # The listener binds to the upstream proxy host/port so the fault-injection proxy can expose the
-    # runner host and first configured port as the client-facing endpoint used by readiness checks.
+    # The listener binds to the configured server host and first configured port.
     #
     # @return [void]
     def perform_start
-      server.add_tcp_listener proxy.host, proxy.port
+      server.add_tcp_listener service.host, service.port
       server.run false
     end
 

data/lib/nonnative/no_proxy.rb

@@ -7,7 +7,7 @@ module Nonnative
   # It does not bind/listen or alter traffic; it simply exposes the underlying runner's configured
   # `host` and primary `port`.
   #
-  # Runners can always call `start`, `stop`, and `reset` safely on this proxy.
+  # Services can always call `start`, `stop`, and `reset` safely on this proxy.
   #
   # @see Nonnative.proxy
   # @see Nonnative::Proxy

data/lib/nonnative/pool.rb

@@ -104,15 +104,13 @@ module Nonnative
       services[runner_index(configuration.services, name)]
     end
 
-    # Resets proxies for all runners in this pool.
+    # Resets service proxies in this pool.
     #
     # This is used by the Cucumber `@reset` hook and is safe to call any time after the pool is created.
     #
     # @return [void]
     def reset
       services.each { |s| s.proxy.reset }
-      servers.each { |s| s.first.proxy.reset }
-      processes.each { |p| p.first.proxy.reset }
     end
 
     private

data/lib/nonnative/process.rb

@@ -4,7 +4,6 @@ module Nonnative
   # Runtime runner that manages an OS-level child process.
   #
   # A process runner:
-  # - starts the configured proxy (if any),
   # - spawns a child process using the configured command and environment,
   # - waits briefly (via the runner `wait`), and
   # - participates in readiness/shutdown via TCP port checks orchestrated by {Nonnative::Pool}.
@@ -21,7 +20,7 @@ module Nonnative
       @timeout = Nonnative::Timeout.new(service.timeout)
     end
 
-    # Starts the proxy (if any) and spawns the configured process if it is not already running.
+    # Spawns the configured process if it is not already running.
     #
     # @return [Array<(Integer, Boolean)>]
     #   a tuple of:
@@ -29,7 +28,6 @@ module Nonnative
     #   - whether the process appears to still be running (non-blocking wait result)
     def start
       unless process_exists?
-        proxy.start
         @pid = process_spawn
         wait_start
       end
@@ -37,7 +35,7 @@ module Nonnative
       [pid, ::Process.waitpid2(pid, ::Process::WNOHANG).nil?]
     end
 
-    # Stops the process (if running) and stops the proxy (if any).
+    # Stops the process if it is running.
     #
     # The process is signalled using the configured signal (defaults to `INT` when not set).
     #
@@ -54,8 +52,6 @@ module Nonnative
       end
 
       [pid, stopped]
-    ensure
-      proxy.stop
     end
 
     # Returns a memoized memory reader for the spawned process.

data/lib/nonnative/proxy.rb

@@ -4,8 +4,7 @@ module Nonnative
   # Base class for proxy implementations.
   #
   # A proxy is responsible for interposing behavior between a client and a target service.
-  # Runners ({Nonnative::Process}, {Nonnative::Server}, and {Nonnative::Service}) create a proxy
-  # instance via {Nonnative::ProxyFactory} based on `service.proxy.kind`.
+  # Runtime services create a proxy instance via {Nonnative::ProxyFactory} based on `service.proxy.kind`.
   #
   # Concrete proxies typically implement these public methods:
   # - `start`: begin proxying (bind/listen, start threads, etc)
@@ -17,7 +16,7 @@ module Nonnative
   # @see Nonnative::NoProxy
   # @see Nonnative::FaultInjectionProxy
   class Proxy
-    # @param service [Nonnative::ConfigurationRunner] runner configuration with an attached proxy configuration
+    # @param service [Nonnative::ConfigurationService] service configuration with an attached proxy configuration
     def initialize(service)
       @service = service
     end

data/lib/nonnative/proxy_factory.rb

@@ -1,11 +1,10 @@
 # frozen_string_literal: true
 
 module Nonnative
-  # Factory for creating proxy instances for runners.
+  # Factory for creating proxy instances for services.
   #
-  # Each runtime runner ({Nonnative::Process}, {Nonnative::Server}, {Nonnative::Service}) constructs
-  # a proxy via this factory. The proxy implementation is selected by `service.proxy.kind` and resolved
-  # using {Nonnative.proxy}.
+  # A runtime service constructs a proxy via this factory. The proxy implementation is selected by
+  # `service.proxy.kind` and resolved using {Nonnative.proxy}.
   #
   # If the kind is unknown (or `"none"`), {Nonnative.proxy} returns {Nonnative::NoProxy}.
   #
@@ -15,9 +14,9 @@ module Nonnative
   # @see Nonnative::NoProxy
   class ProxyFactory
     class << self
-      # Creates a proxy instance for the given runner configuration.
+      # Creates a proxy instance for the given service configuration.
       #
-      # @param service [Nonnative::ConfigurationRunner] runner configuration with an attached proxy configuration
+      # @param service [Nonnative::ConfigurationService] service configuration with an attached proxy configuration
       # @return [Nonnative::Proxy] proxy instance (may be a {Nonnative::NoProxy})
       def create(service)
         proxy = Nonnative.proxy(service.proxy.kind)

data/lib/nonnative/runner.rb

@@ -10,21 +10,13 @@ module Nonnative
   # - {Nonnative::Server} for in-process Ruby servers (threads)
   # - {Nonnative::Service} for proxy-only external dependencies
   #
-  # Each runner has an associated proxy instance created via {Nonnative::ProxyFactory}.
-  #
   # @see Nonnative::Process
   # @see Nonnative::Server
   # @see Nonnative::Service
   class Runner
-    # Returns the proxy instance for this runner.
-    #
-    # @return [Nonnative::Proxy]
-    attr_reader :proxy
-
     # @param service [Nonnative::ConfigurationRunner] runner configuration
     def initialize(service)
       @service = service
-      @proxy = Nonnative::ProxyFactory.create(service)
     end
 
     # Returns the configured runner name.

data/lib/nonnative/server.rb

@@ -4,7 +4,6 @@ module Nonnative
   # Runtime runner that manages an in-process Ruby server.
   #
   # A server runner:
-  # - starts the configured proxy (if any),
   # - starts a Ruby thread that runs {#perform_start},
   # - waits briefly (via the runner `wait`), and
   # - participates in readiness/shutdown via TCP port checks orchestrated by {Nonnative::Pool}.
@@ -25,7 +24,7 @@ module Nonnative
       @timeout = Nonnative::Timeout.new(service.timeout)
     end
 
-    # Starts the proxy (if any) and starts the server thread if not already started.
+    # Starts the server thread if it is not already started.
     #
     # @return [Array<(Integer, TrueClass)>]
     #   a tuple of:
@@ -33,7 +32,6 @@ module Nonnative
     #   - `true` (thread creation itself is considered started; readiness is checked separately)
     def start
       unless thread
-        proxy.start
         @thread = Thread.new { perform_start }
 
         wait_start
@@ -46,14 +44,13 @@ module Nonnative
 
     # Stops the server if it is running.
     #
-    # Calls {#perform_stop}, terminates the server thread, stops the proxy (if any), and waits briefly.
+    # Calls {#perform_stop}, terminates the server thread, and waits briefly.
     #
     # @return [Integer] the server identifier (`object_id`)
     def stop
       if thread
         perform_stop
         thread.terminate
-        proxy.stop
 
         @thread = nil
         wait_stop

data/lib/nonnative/service.rb

@@ -12,6 +12,18 @@ module Nonnative
   # @see Nonnative::ConfigurationService
   # @see Nonnative::Proxy
   class Service < Runner
+    # Returns the proxy instance for this service.
+    #
+    # @return [Nonnative::Proxy]
+    attr_reader :proxy
+
+    # @param service [Nonnative::ConfigurationService] service configuration
+    def initialize(service)
+      super
+
+      @proxy = Nonnative::ProxyFactory.create(service)
+    end
+
     # Starts the configured proxy (if any).
     #
     # @return [void]

data/lib/nonnative/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nonnative
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.2.0
 platform: ruby
 authors:
 - Alejandro Falkowski