nonnative 2.13.1 → 2.15.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f6e8c25babd4ee199097263400e00ebcc5617a82655d8943985f39abed58c86
-  data.tar.gz: 8717d16d7759563f38255e0134292c8e16838cdde145db2623555b8551d84fee
+  metadata.gz: df0fc1bbc0cd9de5368098691bb6c4b812029d70a3d8df236b587874b96e9baf
+  data.tar.gz: 431042c13689b0dec97b2064c130a1b104a167fafecda20f6e90aff2e9c22190
 SHA512:
-  metadata.gz: 50a983a80efad1e7a79ee2c00e6115d3d972da2301facacc8b77f982bc888c477d07920569eb486d51e424cb58e05c0939135ebd337728c00fa214a3c3d1d10e
-  data.tar.gz: 1ad10d708a5fc5996e9e8597c936f3efcb0365316d75bb74de6585de82c56464d7d191a484440914968093bd6eb58564f2007469ff87443e79eb3a9dd496afca
+  metadata.gz: 5dd146af474ac19e1173b38701a75383dd5650e6a182b529c20d2290c44a037072025eee23cc0f6bd06326fc91690d6da83ff746be5cac443609703d5da59075
+  data.tar.gz: 7d7dcbebffa532f5dfe93b4c80ff563d4b0bd5c329a092fc69fcbe1930cd8dac1f191cc04a9ff2dd0de15447b3f446ea134bd9708993e20e7bac780c41122d99

data/.circleci/config.yml

@@ -3,7 +3,7 @@ version: 2.1
 jobs:
   build:
     docker:
-      - image: alexfalkowski/ruby:2.5
+      - image: alexfalkowski/ruby:2.15
     working_directory: ~/nonnative
     steps:
       - checkout:
@@ -35,7 +35,7 @@ jobs:
     resource_class: arm.large
   sync:
     docker:
-      - image: alexfalkowski/release:7.7
+      - image: alexfalkowski/release:7.16
     working_directory: ~/nonnative
     steps:
       - checkout:
@@ -46,7 +46,7 @@ jobs:
     resource_class: arm.large
   version:
     docker:
-      - image: alexfalkowski/release:7.7
+      - image: alexfalkowski/release:7.16
     working_directory: ~/nonnative
     steps:
       - checkout:
@@ -58,7 +58,7 @@ jobs:
     resource_class: arm.large
   wait-all:
     docker:
-      - image: alexfalkowski/ruby:2.5
+      - image: alexfalkowski/ruby:2.15
     steps:
       - run: echo "all applicable jobs finished"
     resource_class: arm.large

data/AGENTS.md

@@ -1,154 +1,107 @@
 # AGENTS.md
 
-This repo is the `nonnative` Ruby gem: a Ruby-first harness for end-to-end testing of systems implemented in other languages by starting processes/servers/services, waiting on TCP port readiness, and optionally putting fault-injection proxies in front of them.
+`nonnative` is a Ruby gem for end-to-end testing systems implemented in other
+languages. It starts processes, in-process servers, and proxy-only services,
+waits on TCP readiness/shutdown, and can place fault-injection proxies in front
+of dependencies.
 
-## Shared skill
+Use `./bin/skills/coding-standards` for shared coding, review, testing,
+documentation, and PR conventions. This file only adds repo-specific context.
 
-Use the shared `coding-standards` skill from `./bin/skills/coding-standards`
-for cross-repository coding, review, testing, documentation, and PR
-conventions. Treat this `AGENTS.md` as the repo-specific companion to that
-skill.
+## Map And Commands
 
-## Quick map
-
-- Library code: `lib/nonnative/**/*.rb`
-- Acceptance tests: `features/**/*.feature`, `features/support/**/*.rb`, `features/step_definitions/**/*.rb`
-- Generated gRPC Ruby stubs for tests: `test/grpc/**/*`
-- Test proto files: `test/nonnative/v1/*.proto`
+- Library: `lib/nonnative/**/*.rb`
+- Cucumber features/support: `features/**/*.feature`, `features/support/**/*.rb`, `features/step_definitions/**/*.rb`
+- Generated gRPC test stubs: `test/grpc/**/*`
+- Test protos: `test/nonnative/v1/*.proto`
 - Build wiring: root `Makefile` includes `bin/build/make/*.mak`
-
-## Key repo dependency
-
-This repo depends on the `bin/` git submodule.
-
-- `.gitmodules` points to `git@github.com:alexfalkowski/bin.git`
-- CI runs `git submodule sync && git submodule update --init`
-- If `bin/` is missing or you do not have SSH access, `make` targets will fail
-
-## Core commands
-
+- Required submodule: `bin/` from `git@github.com:alexfalkowski/bin.git`; missing SSH/submodule setup breaks `make`
 - Install deps: `make dep`
 - Lint: `make lint`
-- Run features: `make features`
-- Run benchmarks only: `make benchmarks`
-- Clean deps: `make clean-dep`
-- Clean reports: `make clean-reports`
-
-## Runtime model
-
-Public entry point is `lib/nonnative.rb`.
-
-Main module API:
-
-- `configure`
-- `start`
-- `stop`
-- `clear`
-- `reset`
-- `pool`
+- Features: `make features`
+- Benchmarks only: `make benchmarks`
+- Cleanup: `make clean-dep`, `make clean-reports`
 
-Configuration lives in `Nonnative::Configuration` and is built either:
+## Runtime Model
 
-- programmatically with `config.process`, `config.server`, `config.service`
-- from YAML with `config.load_file(...)`
+Public entry point: `lib/nonnative.rb`.
 
-Runtime runners:
+Main API: `configure`, `start`, `stop`, `clear`, `reset`, `pool`.
 
-- `Nonnative::Process`: manages an OS process
-- `Nonnative::Server`: manages an in-process Ruby server thread
-- `Nonnative::Service`: manages only proxy lifecycle for an externally managed dependency
+Configuration is `Nonnative::Configuration`, built with
+`config.process`, `config.server`, `config.service`, or
+`config.load_file(...)`.
 
-`Nonnative::Pool` starts services first, then servers/processes, and stops in the reverse direction.
+Runners:
 
-Readiness and shutdown checks are TCP-only via `Nonnative::Port#open?` and `#closed?`.
+- `Nonnative::Process`: OS process
+- `Nonnative::Server`: in-process Ruby server thread
+- `Nonnative::Service`: proxy lifecycle for an externally managed dependency
 
-## Cucumber integration
+`Nonnative::Pool` starts services first, then servers/processes, and stops in
+reverse. Readiness and shutdown checks are TCP-only via
+`Nonnative::Port#open?` and `#closed?`.
 
-Cucumber integration lives in `lib/nonnative/cucumber.rb`.
+## Cucumber Surface
 
-Treat `lib/nonnative/cucumber.rb` as a public compatibility surface for library consumers.
-Existing hooks and step text should not be removed or renamed unless the user explicitly wants a breaking change.
+`lib/nonnative/cucumber.rb` is public compatibility surface. Do not remove or
+rename hooks/step text unless the user explicitly requests a breaking change.
 
-Supported tags:
+Lifecycle tags:
 
 - `@startup`: start before scenario, stop after scenario
 - `@manual`: scenario starts manually, stop after scenario
 - `@clear`: call `Nonnative.clear` before scenario
 - `@reset`: reset proxies after scenario
 
-Repo-owned feature files also use suite taxonomy tags:
+Suite taxonomy tags: `@acceptance`, `@contract`, `@proxy`, `@config`,
+`@service`, `@benchmark`, `@slow`. `make features` excludes `@benchmark`;
+`make benchmarks` runs only `@benchmark`.
 
-- `@acceptance`: end-to-end runner and client flows
-- `@contract`: lower-level lifecycle / command coverage
-- `@proxy`: proxy-specific coverage
-- `@config`: scenarios or example sets that load YAML/configuration
-- `@service`: coverage centered on external services
-- `@benchmark`: benchmark-only scenarios
-- `@slow`: slower-running scenarios, currently benchmarks
+`Nonnative.clear` clears configuration, logger, observability client, and pool.
+`require 'nonnative'` loads Cucumber integration lazily and is safe outside a
+booted Cucumber runtime. For start-once-per-test-run, use
+`require 'nonnative/startup'`.
 
-`make features` excludes `@benchmark`; `make benchmarks` runs only `@benchmark`.
+## Proxy And Config Gotchas
 
-`Nonnative.clear` now clears:
+Proxy wiring is the easiest mistake:
 
-- configuration
-- logger
-- observability client
-- pool
+- Runner `host` / `port` are client-facing and used for readiness/shutdown
+- For `fault_injection`, nested `proxy.host` / `proxy.port` are the upstream target
+- Clients connect to runner `host` / `port` when a proxy is enabled
 
-`require 'nonnative'` still loads the Cucumber integration, but hook/step registration is lazy, so plain `require 'nonnative'` is safe outside a booted Cucumber runtime.
+Proxy kinds: `none`, `fault_injection`.
+Fault-injection states: `none`, `close_all`, `delay`, `invalid_data`.
 
-For “start once per test run”, use `require 'nonnative/startup'`.
+Config rules:
 
-## Proxy wiring
-
-This is the easiest thing to get wrong.
-
-- Runner `host` / `port` are the client-facing endpoint and the values used by readiness/shutdown checks
-- For `fault_injection`, nested `proxy.host` / `proxy.port` are the upstream target behind the proxy
-- Clients should connect to the runner `host` / `port` when a proxy is enabled
-
-Available proxy kinds:
-
-- `none`
-- `fault_injection`
-
-Fault injection states:
-
-- `none`
-- `close_all`
-- `delay`
-- `invalid_data`
-
-## Config gotchas
-
-- Services must be declared under `services:` in YAML, not `processes:`
+- YAML services belong under `services:`, not `processes:`
 - There is no top-level `config.wait`; `wait` is per runner
-- Service configs use `config.service do |s| ... end`, so use `s.host` / `s.port`
-- Proxy examples need both sides of the split:
-  - runner `host` / `port` = proxy endpoint
-  - nested `proxy.host` / `proxy.port` = upstream target
+- Programmatic service config uses `config.service do |s| ... end`, so use `s.host` / `s.port`
+- Proxy examples need both endpoint sides: runner `host` / `port` for the proxy, nested `proxy.host` / `proxy.port` for upstream
+
+## Fixtures And Limitations
 
-## Test fixtures worth knowing
+Useful fixtures:
 
-- Local process fixture: `features/support/bin/start`
-- HTTP fixtures: `features/support/http_server.rb`, `features/support/http_proxy_server.rb`
-- TCP fixture: `features/support/tcp_server.rb`
-- gRPC fixtures: `features/support/grpc_server.rb`, plus generated stubs under `test/grpc/`
+- Process: `features/support/bin/start`
+- HTTP: `features/support/http_server.rb`, `features/support/http_proxy_server.rb`
+- TCP: `features/support/tcp_server.rb`
+- gRPC: `features/support/grpc_server.rb`, generated stubs in `test/grpc/`
 
-## Important limitations / gotchas
+Limitations:
 
-- Ruby version is constrained by `nonnative.gemspec` to `>= 4.0.0` and `< 5.0.0`
 - The `grpc` Ruby library uses a global logger; per-server gRPC loggers are not really supported
-- `make` depends on the `bin/` submodule being present
 - Local Ruby/Bundler mismatches can break native extensions on macOS
-- Coverage output and Cucumber reports are written under `test/reports`
+- Coverage and Cucumber reports go under `test/reports`
 - Port checks can be flaky if tests reuse ports unexpectedly
 
-## Where to look first
+## Look First
 
-- Lifecycle orchestration: `lib/nonnative.rb`, `lib/nonnative/pool.rb`
-- Readiness / timeouts: `lib/nonnative/port.rb`, `lib/nonnative/timeout.rb`
+- Lifecycle: `lib/nonnative.rb`, `lib/nonnative/pool.rb`
+- Readiness/timeouts: `lib/nonnative/port.rb`, `lib/nonnative/timeout.rb`
 - Process lifecycle: `lib/nonnative/process.rb`
-- Proxies / fault injection: `lib/nonnative/fault_injection_proxy.rb`, `lib/nonnative/socket_pair_factory.rb`
-- Cucumber integration: `lib/nonnative/cucumber.rb`, `lib/nonnative/startup.rb`, `features/support/env.rb`
+- Proxies: `lib/nonnative/fault_injection_proxy.rb`, `lib/nonnative/socket_pair_factory.rb`
+- Cucumber: `lib/nonnative/cucumber.rb`, `lib/nonnative/startup.rb`, `features/support/env.rb`
 - Config loading: `lib/nonnative/configuration.rb`, `lib/nonnative/configuration_runner.rb`, `lib/nonnative/configuration_proxy.rb`

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nonnative (2.13.1)
+    nonnative (2.15.1)
       concurrent-ruby (>= 1, < 2)
       config (>= 5, < 6)
       cucumber (>= 7, < 12)
@@ -206,4 +206,4 @@ DEPENDENCIES
   simplecov-cobertura
 
 BUNDLED WITH
-  4.0.8
+  4.0.10

data/README.md

@@ -547,9 +547,13 @@ Nonnative.configure do |config|
   config.log = 'nonnative.log'
 
   config.process do |p|
+    p.host = '127.0.0.1'
+    p.port = 20_000
+
     p.proxy = {
       kind: 'fault_injection',
-      port: 20_000,
+      host: '127.0.0.1',
+      port: 12_321,
       log: 'proxy_server.log',
       wait: 1,
       options: {
@@ -569,9 +573,12 @@ url: http://localhost:4567
 log: nonnative.log
 processes:
   -
+    host: 127.0.0.1
+    port: 20000
     proxy:
       kind: fault_injection
-      port: 20000
+      host: 127.0.0.1
+      port: 12321
       log: proxy_server.log
       wait: 1
       options:
@@ -592,9 +599,13 @@ Nonnative.configure do |config|
   config.log = 'nonnative.log'
 
   config.server do |s|
+    s.host = '127.0.0.1'
+    s.port = 20_000
+
     s.proxy = {
       kind: 'fault_injection',
-      port: 20_000,
+      host: '127.0.0.1',
+      port: 12_321,
       log: 'proxy_server.log',
       wait: 1,
       options: {
@@ -614,9 +625,12 @@ url: http://localhost:4567
 log: nonnative.log
 servers:
   -
+    host: 127.0.0.1
+    port: 20000
     proxy:
       kind: fault_injection
-      port: 20000
+      host: 127.0.0.1
+      port: 12321
       log: proxy_server.log
       wait: 1
       options:

data/lib/nonnative/configuration_proxy.rb

@@ -15,8 +15,8 @@ module Nonnative
   # @see Nonnative.proxies
   class ConfigurationProxy
     # @return [String] proxy kind name (for example `"none"` or `"fault_injection"`)
-    # @return [String] proxy bind host (defaults to `"0.0.0.0"`)
-    # @return [Integer] proxy bind port (defaults to `0`)
+    # @return [String] upstream host used by proxy implementations (defaults to `"0.0.0.0"`)
+    # @return [Integer] upstream port used by proxy implementations (defaults to `0`)
     # @return [String, nil] path to proxy log file (implementation-dependent)
     # @return [Numeric] wait interval (seconds) after proxy state changes (defaults to `0.1`)
     # @return [Hash] proxy implementation options (implementation-dependent)

data/lib/nonnative/configuration_runner.rb

@@ -51,8 +51,8 @@ module Nonnative
     #
     # @param value [Hash] proxy attributes
     # @option value [String] :kind proxy kind name (for example `"fault_injection"`)
-    # @option value [String] :host proxy bind host (optional)
-    # @option value [Integer] :port proxy bind port
+    # @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

data/lib/nonnative/cucumber.rb

@@ -32,6 +32,13 @@ module Nonnative
     end
 
     module ProxySteps
+      PROXY_OPERATIONS = {
+        'close_all' => :close_all,
+        'delay' => :delay,
+        'invalid_data' => :invalid_data,
+        'reset' => :reset
+      }.freeze
+
       def install_proxy_steps
         install_proxy_mutation_steps
         install_proxy_reset_steps
@@ -40,17 +47,17 @@ module Nonnative
       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)
-          process.proxy.send(operation)
+          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)
-          server.proxy.send(operation)
+          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)
-          service.proxy.send(operation)
+          Nonnative::Cucumber::Registration.apply_proxy_operation(service.proxy, operation)
         end
       end
 
@@ -70,6 +77,14 @@ module Nonnative
           service.proxy.reset
         end
       end
+
+      def apply_proxy_operation(proxy, operation)
+        method = PROXY_OPERATIONS.fetch(operation) do
+          raise ArgumentError, "Unsupported proxy operation '#{operation}'"
+        end
+
+        proxy.public_send(method)
+      end
     end
 
     module LifecycleSteps

data/lib/nonnative/version.rb

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

data/lib/nonnative.rb

@@ -189,7 +189,7 @@ module Nonnative
     #
     # @return [Hash{String=>Class}]
     def proxies
-      @proxies ||= { 'fault_injection' => Nonnative::FaultInjectionProxy }.freeze
+      @proxies ||= { 'fault_injection' => Nonnative::FaultInjectionProxy }
     end
 
     # Resolves a proxy implementation for a configured kind.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nonnative
 version: !ruby/object:Gem::Version
-  version: 2.13.1
+  version: 2.15.1
 platform: ruby
 authors:
 - Alejandro Falkowski
@@ -345,7 +345,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.8
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Allows you to keep using the power of ruby to test other systems
 test_files: []