CodeSampleX

Sample

faraday-net_http 3.4.4: Distinguish between connection open timeouts and read/write timeouts when handling Net::HTTP adapter exceptions in Faraday

Verified sample for gem faraday-net_http 3.4.4: Distinguish between connection open timeouts and read/write timeouts when handling Net::HTTP adapter…

sha256:433adef28fe1437eec97938d51ac23888970243b093b96201d673f77b3ebdb72

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
2
Signing keys that built it
1
Declared environment ruby linux x64 ruby ruby rubygems

Verification-run environments

Environment Contract Stages Run
ruby 3 · linux debian/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · rubygems@1
2026-08-16
ruby 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 SKIPPED compile:SKIPPED · contract:SKIPPED · load:SKIPPED · resolve:FAIL
CONTAINER_RUN · rubygems@1
2026-08-18

Case

HOW
Goal
Distinguish between connection open timeouts and read/write timeouts when handling Net::HTTP adapter exceptions in Faraday
Packages
Symbols
  • Faraday::Adapter::NetHttp
  • Faraday::Adapter::NetHttp#call
  • Faraday::ConnectionFailed
  • Faraday::TimeoutError
  • Faraday::SSLError
Environment
ruby
Created
2026-08-16T17:31:38Z

Contract

  1. Net::OpenTimeout is mapped to Faraday::ConnectionFailed rather than Faraday::TimeoutError because faraday-net_http routes socket open failures through its connection failure handler.
  2. Net::ReadTimeout and Net::WriteTimeout are mapped to Faraday::TimeoutError by the outer timeout handler.
  3. Errno::ETIMEDOUT is caught as Faraday::TimeoutError rather than Faraday::ConnectionFailed.
  4. Zlib::GzipFile::Error raised during body decompression is caught by NET_HTTP_EXCEPTIONS and wrapped as Faraday::ConnectionFailed.
  5. OpenSSL::SSL::SSLError is caught by NET_HTTP_EXCEPTIONS and wrapped as Faraday::SSLError.
  6. Faraday::TimeoutError and Faraday::SSLError do not inherit from Faraday::ConnectionFailed, preventing a single rescue clause from catching both connection setup and read timeouts unless rescuing Faraday::Error.

Files

  • Gemfile
  • NOTES.md
  • csx.json
  • lib/client_wrapper.rb
  • test/contract.rb

Download the source artifact (tar.gz)

Origin Seeder

csx-seed