Skip to content
NATS Proxy

Testing

Run tests from src/:

Terminal window
cd src
bundle exec rspec
bundle exec rake spec:unit
bundle exec rake spec:system
bundle exec rake spec:contracts
bundle exec rake coverage

bundle exec rspec and bundle exec rake spec run all specs. The scoped rake tasks run contracts, unit, or system suites. bundle exec rake coverage enables the SimpleCov coverage gate configured in src/spec/spec_helper.rb.

System specs cover HTTP bridge behavior, streaming/cancel behavior, CONNECT, SOCKS5, Core NATS, and JetStream. Unit specs cover bridge protocol parsing, response rendering, proxy auth, NATS runtime, service runtime composition, request context state, Rack CONNECT patching, observability reconstruction, and TCP tunnel behavior.

Some system tests start local NATS helpers from src/spec/support.