nonnative 2.16.0 → 2.19.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b79bc3b75303cd4d605a4ef81c7b3c1eedd188204d088864fefb65dc73f0922
-  data.tar.gz: c8e4b5ef1bb12213e80d7084d5b3809206279a44bca610947114fd41dd188745
+  metadata.gz: '08e1e5b760ed902c52e55ef0694bddeb1e36580891ab9a778767a04ea02b1d9c'
+  data.tar.gz: d632a3b8047ebada176e3db071caada192b87d8c255d6beb0e14a1010874103f
 SHA512:
-  metadata.gz: a58c635d40b6eeb8b6aa7e9560900bad247fe768f9839b7e141f6be4e500b5fa2ec11267524621db66989f6eaf24601b790716a4508e28203e4845862ad5a289
-  data.tar.gz: 111995ab26c566d24df0fb037c094883ac07adf2142254fde6822fb9e4fcea59c855196c650bac382e5ab02fe2610181611040a96f3d13515aef586495ffaf72
+  metadata.gz: bfeba487e42d817e967c0a1cfe0814e5fc75c4d360399dcbd0caaf6ddef83c11efb8a4aff8ffe58ee6566be138b3b85e146e5ffe44dc431e734cf22544956019
+  data.tar.gz: 268c3d360f3d23b18a69317cbe656b06d24b8f94799c245108e94e5e269ac852c000d74d3427168fd2ad5b2c56ea24a3bb21e1507c77d9e4cce713fac4b57a3b

data/.circleci/config.yml

@@ -3,7 +3,7 @@ version: 2.1
 jobs:
   build:
     docker:
-      - image: alexfalkowski/ruby:3.8
+      - image: alexfalkowski/ruby:3.9
     working_directory: ~/nonnative
     steps:
       - checkout:
@@ -58,7 +58,7 @@ jobs:
     resource_class: arm.large
   wait-all:
     docker:
-      - image: alexfalkowski/ruby:3.8
+      - image: alexfalkowski/ruby:3.9
     steps:
       - run: echo "all applicable jobs finished"
     resource_class: arm.large

data/AGENTS.md

@@ -79,6 +79,9 @@ Fault-injection states: `none`, `close_all`, `delay`, `invalid_data`.
 
 Config rules:
 
+- YAML config is loaded as data only via `Nonnative::ConfigurationFile`; ERB is not evaluated and arbitrary Ruby object tags are rejected
+- Runner `host` and nested `proxy.host` default to `127.0.0.1`; use explicit `0.0.0.0` only when external access is intended
+- Process `command` can be a legacy shell string or an argv array; prefer argv arrays for new config, and `go:` config builds argv internally
 - YAML services belong under `services:`, not `processes:`
 - There is no top-level `config.wait`; `wait` is per runner
 - Programmatic service config uses `config.service do |s| ... end`, so use `s.host` / `s.port`
@@ -107,4 +110,4 @@ Limitations:
 - Process lifecycle: `lib/nonnative/process.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`
+- Config loading: `lib/nonnative/configuration.rb`, `lib/nonnative/configuration_file.rb`, `lib/nonnative/configuration_runner.rb`, `lib/nonnative/configuration_proxy.rb`

data/Gemfile.lock

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

data/README.md

@@ -37,7 +37,9 @@ gem install nonnative
 
 ## Usage
 
-Nonnative is configured via {#Nonnative.configure} (programmatic) or `config.load_file(...)` (YAML).
+Nonnative is configured via `Nonnative.configure` (programmatic) or `config.load_file(...)` (YAML).
+YAML configuration is loaded as data only: ERB is not evaluated and arbitrary Ruby objects are not
+deserialized.
 
 High-level configuration fields:
 - `version`: configuration version (example: `"1.0"`).
@@ -48,13 +50,16 @@ High-level configuration fields:
 - `servers`: in-process Ruby servers started in threads.
 - `services`: external dependencies (proxy-only; no process/thread started by Nonnative).
 
-Runner fields (process/server/service):
+Common runner fields:
+- `name`: runner name used for lookup.
+- `host`/`port`: 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, this is the endpoint your tests/clients should hit.
+
+Process/server fields:
 - `timeout`: max time (seconds) for readiness/shutdown port checks.
 - `wait`: small sleep (seconds) between lifecycle steps.
-- `host`/`port`: client-facing address used for readiness/shutdown port checks. When a `fault_injection` proxy is enabled, this is the endpoint your tests/clients should hit.
-- `log`: per-runner log file (used by process output redirection or server implementations).
+- `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. In-process server implementations typically bind there via `proxy.host` / `proxy.port`.
+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`.
 
 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`/`port`, results are undefined.
 
@@ -90,8 +95,10 @@ This calls `Nonnative.start` immediately and registers an `at_exit` stop.
 ### Processes
 
 A process is some sort of command that you would run locally.
+Commands can be strings or argv arrays. String commands preserve legacy shell semantics, while argv arrays
+avoid shell interpretation and are preferred for new configuration.
 
-Setup it up programmatically:
+Set it up programmatically:
 
 ```ruby
 require 'nonnative'
@@ -104,7 +111,7 @@ Nonnative.configure do |config|
 
   config.process do |p|
     p.name = 'start_1'
-    p.command = -> { 'features/support/bin/start 12_321' }
+    p.command = -> { ['features/support/bin/start', '12_321'] }
     p.timeout = 5
     p.wait = 0.1
     p.port = 12_321
@@ -117,7 +124,7 @@ Nonnative.configure do |config|
 
   config.process do |p|
     p.name = 'start_2'
-    p.command = -> { 'features/support/bin/start 12_322' }
+    p.command = -> { ['features/support/bin/start', '12_322'] }
     p.timeout = 0.5
     p.wait = 0.1
     p.port = 12_322
@@ -126,7 +133,7 @@ Nonnative.configure do |config|
 end
 ```
 
-Setup it up through configuration:
+Set it up through configuration:
 
 ```yaml
 version: "1.0"
@@ -136,7 +143,9 @@ log: nonnative.log
 processes:
   -
     name: start_1
-    command: features/support/bin/start 12_321
+    command:
+      - features/support/bin/start
+      - "12_321"
     timeout: 5
     wait: 1
     port: 12321
@@ -146,7 +155,9 @@ processes:
       TEST: true
   -
     name: start_2
-    command: features/support/bin/start 12_322
+    command:
+      - features/support/bin/start
+      - "12_322"
     timeout: 5
     wait: 1
     port: 12322
@@ -205,7 +216,7 @@ module Nonnative
 end
 ```
 
-Setup it up programmatically:
+Set it up programmatically:
 
 ```ruby
 require 'nonnative'
@@ -218,7 +229,7 @@ Nonnative.configure do |config|
 
   config.server do |s|
     s.name = 'server_1'
-    s.klass = Nonnative::EchoServer
+    s.klass = Nonnative::TCPServer
     s.timeout = 1
     s.port = 12_323
     s.log = 'server_1.log'
@@ -226,7 +237,7 @@ Nonnative.configure do |config|
 
   config.server do |s|
     s.name = 'server_2'
-    s.klass = Nonnative::EchoServer
+    s.klass = Nonnative::TCPServer
     s.timeout = 1
     s.port = 12_324
     s.log = 'server_2.log'
@@ -234,7 +245,7 @@ Nonnative.configure do |config|
 end
 ```
 
-Setup it up through configuration:
+Set it up through configuration:
 
 ```yaml
 version: "1.0"
@@ -244,13 +255,13 @@ log: nonnative.log
 servers:
   -
     name: server_1
-    class: Nonnative::EchoServer
+    class: Nonnative::TCPServer
     timeout: 1
     port: 12323
     log: server_1.log
   -
     name: server_2
-    class: Nonnative::EchoServer
+    class: Nonnative::TCPServer
     timeout: 1
     port: 12324
     log: server_2.log
@@ -288,7 +299,7 @@ module Nonnative
 end
 ```
 
-Setup it up programmatically:
+Set it up programmatically:
 
 ```ruby
 require 'nonnative'
@@ -309,7 +320,7 @@ Nonnative.configure do |config|
 end
 ```
 
-Setup it up through configuration:
+Set it up through configuration:
 
 ```yaml
 version: "1.0"
@@ -353,7 +364,7 @@ module Nonnative
 end
 ```
 
-Setup it up programmatically:
+Set it up programmatically:
 
 ```ruby
 require 'nonnative'
@@ -374,7 +385,7 @@ Nonnative.configure do |config|
 end
 ```
 
-Setup it up through configuration:
+Set it up through configuration:
 
 ```yaml
 version: "1.0"
@@ -422,7 +433,7 @@ module Nonnative
 end
 ```
 
-Setup it up programmatically:
+Set it up programmatically:
 
 ```ruby
 require 'nonnative'
@@ -443,7 +454,7 @@ Nonnative.configure do |config|
 end
 ```
 
-Setup it up through configuration:
+Set it up through configuration:
 
 ```yaml
 version: "1.0"
@@ -705,7 +716,7 @@ Clients connect to the runner `host`/`port`, while the proxy forwards traffic to
 
 ###### Fault Injection Processes
 
-Setup it up programmatically:
+Set it up programmatically:
 
 ```ruby
 name = 'name of process in configuration'
@@ -724,7 +735,7 @@ Then I should reset the proxy for process 'process_1'
 
 ###### Fault Injection Servers
 
-Setup it up programmatically:
+Set it up programmatically:
 
 ```ruby
 name = 'name of server in configuration'
@@ -743,7 +754,7 @@ Then I should reset the proxy for server 'server_1'
 
 ###### Fault Injection Services
 
-Setup it up programmatically:
+Set it up programmatically:
 
 ```ruby
 name = 'name of service in configuration'
@@ -762,11 +773,26 @@ Then I should reset the proxy for service 'service_1'
 
 ### Go
 
-As we love using go as a language for services we have added support to start binaries with defined parameters. This expects that you build your services in the format of `command sub_command --params`
+As we love using Go as a language for services we have added support to start binaries with defined parameters.
+
+Programmatic Go binaries can be configured as normal argv process commands:
+
+```ruby
+Nonnative.configure do |config|
+  config.process do |p|
+    p.name = 'go'
+    p.command = -> { ['your_binary', 'sub_command', '--config', 'config.yaml'] }
+    p.port = 12_345
+  end
+end
+```
+
+YAML `go:` configuration is for Go test binaries compiled with `go test -c`. It builds argv entries in this order: executable, optional `-test.*` profiling/trace/coverage flags, command, then parameters. Parameter strings are parsed into argv words with shell-style quoting, but the argv entries are executed without shell interpretation.
 
 To get this to work you will need to create a `main_test.go` file with these contents:
 
 ```go
+//go:build features
 // +build features
 
 package main
@@ -774,7 +800,7 @@ package main
 import "testing"
 
 func TestFeatures(t *testing.T) {
- main()
+    main()
 }
 ```
 
@@ -784,15 +810,7 @@ Then to compile this binary you will need to do the following:
 go test -mod vendor -c -tags features -covermode=count -o your_binary -coverpkg=./... github.com/your_location
 ```
 
-Setup it up programmatically:
-
-```ruby
-tools = %w[prof trace cover]
-
-Nonnative.go_executable(tools, 'reports', 'your_binary', 'sub_command', '--config config.yaml')
-```
-
-Setup it up through configuration:
+Set it up through configuration:
 
 ```yaml
 version: "1.0"
@@ -808,7 +826,7 @@ processes:
       executable: your_binary
       command: sub_command
       parameters:
-        - --config config.yaml
+        - "-i file:.config/server.yml"
     timeout: 5
     port: 8000
     log: go.log

data/lib/nonnative/configuration.rb

@@ -52,13 +52,14 @@ module Nonnative
 
     # Loads a configuration file and appends its runners to this instance.
     #
-    # The file is loaded using the `config` gem via {Nonnative.configurations}. Top-level attributes are
-    # copied onto this object, and runner sections are transformed into configuration runner objects.
+    # The file is loaded using safe YAML parsing. ERB is not evaluated,
+    # arbitrary object deserialization is not allowed, top-level attributes are copied onto this object,
+    # and runner sections are transformed into configuration runner objects.
     #
     # @param path [String] path to a configuration file (typically YAML)
     # @return [void]
     def load_file(path)
-      cfg = Nonnative.configurations(path)
+      cfg = Nonnative::ConfigurationFile.load(path)
 
       self.version = cfg.version
       self.name = cfg.name
@@ -140,7 +141,7 @@ module Nonnative
         params = go.parameters || []
         tools = go.tools || []
 
-        -> { Nonnative.go_executable(tools, go.output, go.executable, go.command, *params) }
+        -> { Nonnative.go_executable_args(tools, go.output, go.executable, go.command, *params) }
       else
         -> { process.command }
       end

data/lib/nonnative/configuration_file.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Nonnative
+  # Safely loads a YAML configuration file into the Config::Options shape used by Nonnative.
+  class ConfigurationFile
+    class << self
+      # Loads a file into a Config::Options instance.
+      #
+      # YAML files are parsed as data only: ERB is not evaluated and arbitrary object deserialization is not allowed.
+      #
+      # @param path [String] file path
+      # @return [Config::Options]
+      def load(path)
+        Config::Options.new.tap do |config|
+          config.add_source!(safe_load_yaml(path))
+          config.load!
+        end
+      end
+
+      private
+
+      def safe_load_yaml(path)
+        contents = File.read(path)
+        config = YAML.safe_load(contents, aliases: true) || {}
+        return config if config.is_a?(Hash)
+
+        raise ArgumentError, "Configuration file '#{path}' must contain a YAML mapping"
+      rescue Psych::SyntaxError => e
+        raise ArgumentError, "YAML syntax error occurred while parsing #{path}: #{e.message}"
+      end
+    end
+  end
+end

data/lib/nonnative/configuration_process.rb

@@ -11,11 +11,21 @@ module Nonnative
   # @see Nonnative::Configuration
   # @see Nonnative::Process
   class ConfigurationProcess < ConfigurationRunner
-    # @return [Proc] a callable that returns the command string to execute (e.g. `-> { "./bin/api" }`)
+    # @return [Proc] a callable that returns the command to execute
+    #   as a shell string or argv array
+    #   (e.g. `-> { "./bin/api" }` or `-> { ["./bin/api", "--port", "8080"] }`)
+    attr_accessor :command
+
     # @return [String, nil] signal name to use for stopping (defaults to `"INT"` when not set)
+    attr_accessor :signal
+
     # @return [Numeric] readiness timeout (seconds) used when waiting for the port to open/close
+    attr_accessor :timeout
+
     # @return [String] log file path to append process stdout/stderr to
+    attr_accessor :log
+
     # @return [Hash, nil] environment variables to pass to the spawned process
-    attr_accessor :command, :signal, :timeout, :log, :environment
+    attr_accessor :environment
   end
 end

data/lib/nonnative/configuration_proxy.rb

@@ -15,7 +15,7 @@ module Nonnative
   # @see Nonnative.proxies
   class ConfigurationProxy
     # @return [String] proxy kind name (for example `"none"` or `"fault_injection"`)
-    # @return [String] upstream host used by proxy implementations (defaults to `"0.0.0.0"`)
+    # @return [String] upstream host used by proxy implementations (defaults to `"127.0.0.1"`)
     # @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`)
@@ -27,7 +27,7 @@ module Nonnative
     #
     # Defaults:
     # - `kind`: `"none"`
-    # - `host`: `"0.0.0.0"`
+    # - `host`: `"127.0.0.1"`
     # - `port`: `0`
     # - `wait`: `0.1`
     # - `options`: `{}`
@@ -35,7 +35,7 @@ module Nonnative
     # @return [void]
     def initialize
       self.kind = 'none'
-      self.host = '0.0.0.0'
+      self.host = '127.0.0.1'
       self.port = 0
       self.wait = 0.1
       self.options = {}

data/lib/nonnative/configuration_runner.rb

@@ -14,7 +14,7 @@ module Nonnative
   # @see Nonnative::ConfigurationService
   class ConfigurationRunner
     # @return [String, nil] runner name used for lookup (for example via `pool.process_by_name`)
-    # @return [String] host to bind/connect to (defaults to `"0.0.0.0"`)
+    # @return [String] host to bind/connect to (defaults to `"127.0.0.1"`)
     # @return [Integer] port to bind/connect to
     # @return [Numeric] wait interval (seconds) used by runners between lifecycle steps
     attr_accessor :name, :host, :port, :wait
@@ -30,14 +30,14 @@ module Nonnative
     # Creates a runner configuration with defaults.
     #
     # Defaults:
-    # - `host`: `"0.0.0.0"`
+    # - `host`: `"127.0.0.1"`
     # - `port`: `0`
     # - `wait`: `0.1`
     # - `proxy`: a new {Nonnative::ConfigurationProxy} with its own defaults
     #
     # @return [void]
     def initialize
-      self.host = '0.0.0.0'
+      self.host = '127.0.0.1'
       self.port = 0
       self.wait = 0.1
 

data/lib/nonnative/go_command.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 module Nonnative
-  # Builds command lines for running a Go test binary with optional profiling/trace/coverage flags.
+  # Builds commands for running a Go test binary with optional profiling/trace/coverage flags.
   #
-  # This helper is used by {Nonnative.go_executable} and by YAML configuration when a process has a
-  # `go:` section (see {Nonnative::Configuration}).
+  # This helper is used by YAML configuration when a process has a `go:` section
+  # (see {Nonnative::Configuration}).
   #
   # The generated flags use Go's `testing` package flags (e.g. `-test.cpuprofile=...`), so this
   # is intended to run a binary compiled from `go test -c`.
@@ -19,12 +19,14 @@ module Nonnative
   #
   # If `tools` is `nil` or empty, all tools (`prof`, `trace`, `cover`) are enabled.
   #
+  # Parameter strings are parsed into argv words using shell-style quoting, then executed without a shell.
+  #
   # @example
   #   cmd = Nonnative::GoCommand.new(%w[prof cover], './svc.test', 'reports')
-  #   cmd.executable('serve', '--config', 'config.yaml')
-  #   # => "./svc.test -test.cpuprofile=... -test.coverprofile=... serve --config config.yaml"
+  #   cmd.executable_args('serve', '--config', 'config.yaml')
+  #   # => ["./svc.test", "-test.cpuprofile=...", "-test.coverprofile=...", "serve", "--config", "config.yaml"]
   #
-  # @see Nonnative.go_executable
+  # @see Nonnative.go_executable_args
   class GoCommand
     # @param tools [Array<String>, nil] tool names to enable (see class docs)
     # @param exec [String] path to the compiled Go test binary
@@ -35,22 +37,25 @@ module Nonnative
       @output = output
     end
 
-    # Returns an executable command string including enabled `-test.*` flags.
+    # Returns an executable argv array including enabled `-test.*` flags.
     #
     # A short random suffix is appended to output filenames to reduce collisions across runs.
     #
     # @param cmd [String] command/sub-command argument passed to the Go test binary
-    # @param params [Array<String>] additional parameters passed after `cmd`
-    # @return [String] the full command to execute
-    def executable(cmd, *params)
-      params = params.join(' ')
-      "#{exec} #{flags(cmd).join(' ')} #{cmd} #{params}".strip
+    # @param params [Array<String>] additional parameter strings passed after `cmd`
+    # @return [Array<String>] argv entries to execute
+    def executable_args(cmd, *params)
+      [exec, *flags(cmd), cmd, *parameter_args(params)]
     end
 
     private
 
     attr_reader :tools, :exec, :output
 
+    def parameter_args(params)
+      params.flatten.compact.flat_map { |p| Shellwords.split(p.to_s) }
+    end
+
     def flags(cmd)
       suffix = SecureRandom.alphanumeric(4)
       m = File.basename(exec, File.extname(exec))

data/lib/nonnative/process.rb

@@ -89,10 +89,10 @@ module Nonnative
         environment[k] = ENV.fetch(k, nil) || environment[k]
       end
 
-      command = service.command.call
+      command = Array(service.command.call)
 
-      spawn(environment, command, %i[out err] => [service.log, 'a']).tap do |pid|
-        Nonnative.logger.info "started '#{command}' with pid '#{pid}'"
+      spawn(environment, *command, %i[out err] => [service.log, 'a']).tap do |pid|
+        Nonnative.logger.info "started '#{command.join(' ')}' with pid '#{pid}'"
       end
     end
 

data/lib/nonnative/version.rb

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

data/lib/nonnative.rb

@@ -46,6 +46,7 @@ require 'timeout'
 require 'yaml'
 require 'open3'
 require 'securerandom'
+require 'shellwords'
 
 require 'grpc'
 require 'sinatra'
@@ -67,6 +68,7 @@ require 'nonnative/stop_error'
 require 'nonnative/not_found_error'
 require 'nonnative/timeout'
 require 'nonnative/port'
+require 'nonnative/configuration_file'
 require 'nonnative/configuration'
 require 'nonnative/configuration_runner'
 require 'nonnative/configuration_process'
@@ -113,16 +115,6 @@ module Nonnative
     # @return [Nonnative::Pool, nil] the pool instance, or `nil` if not started yet
     attr_accessor :pool
 
-    # Loads one or more configuration files using the `config` gem.
-    #
-    # This is primarily used by {Nonnative::Configuration#load_file}, but is public for advanced cases.
-    #
-    # @param files [Array<String>] paths to configuration files
-    # @return [Config::Options] the loaded configuration object
-    def configurations(*files)
-      Config.load_files(files)
-    end
-
     # Returns the current configuration (memoized).
     #
     # @return [Nonnative::Configuration]
@@ -162,7 +154,7 @@ module Nonnative
       File.readlines(path).select { |l| predicate.call(l) }
     end
 
-    # Builds a Go test executable command line with optional profiling/trace/coverage flags.
+    # Builds a Go test executable argv array with optional profiling/trace/coverage flags.
     #
     # This is used when process configuration specifies a `go` section.
     #
@@ -170,10 +162,10 @@ module Nonnative
     # @param output [String] directory where outputs should be written
     # @param exec [String] the test binary (or wrapper) to execute
     # @param cmd [String] the command argument passed to the test binary
-    # @param params [Array<String>] extra parameters for the command
-    # @return [String] executable command string
-    def go_executable(tools, output, exec, cmd, *params)
-      Nonnative::GoCommand.new(tools, exec, output).executable(cmd, params)
+    # @param params [Array<String>] extra parameter strings for the command
+    # @return [Array<String>] executable argv entries
+    def go_executable_args(tools, output, exec, cmd, *params)
+      Nonnative::GoCommand.new(tools, exec, output).executable_args(cmd, *params)
     end
 
     # Returns an HTTP client for common health/readiness endpoints.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nonnative
 version: !ruby/object:Gem::Version
-  version: 2.16.0
+  version: 2.19.1
 platform: ruby
 authors:
 - Alejandro Falkowski
@@ -288,6 +288,7 @@ files:
 - lib/nonnative.rb
 - lib/nonnative/close_all_socket_pair.rb
 - lib/nonnative/configuration.rb
+- lib/nonnative/configuration_file.rb
 - lib/nonnative/configuration_process.rb
 - lib/nonnative/configuration_proxy.rb
 - lib/nonnative/configuration_runner.rb