CodeSampleX

Sample

faraday-net_http 3.4.4: Handle the asymmetric exception wrapping and phase distribution between Faraday timeout options and Faraday::Adapter::NetHttp

Verified sample for gem faraday-net_http 3.4.4: Handle the asymmetric exception wrapping and phase distribution between Faraday timeout options and…

sha256:d2ab361b5a26aaca1485c8c63f2f849804f7725bbab6574a58d895abd1d2a4e1

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
2
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-17
ruby 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · rubygems@1
2026-08-18

Case

HOW
Goal
Handle the asymmetric exception wrapping and phase distribution between Faraday timeout options and Faraday::Adapter::NetHttp
Packages
Symbols
  • Faraday::Adapter::NetHttp#call
  • Faraday::Adapter::NetHttp#configure_request
  • Faraday::Adapter::NetHttp::NET_HTTP_EXCEPTIONS
Environment
ruby
Created
2026-08-17T02:41:37Z

Contract

  1. Net::OpenTimeout raises Faraday::ConnectionFailed rather than Faraday::TimeoutError because NET_HTTP_EXCEPTIONS intercepts open timeouts before Timeout::Error rescue handlers run.
  2. Net::ReadTimeout and Net::WriteTimeout raise Faraday::TimeoutError wrapping the underlying Net::ProtocolError timeout exception.
  3. Setting a general request timeout distributes the duration to open_timeout, read_timeout, and write_timeout on Net::HTTP individually instead of enforcing a single total deadline.
  4. Specific timeout options override their respective phase on Net::HTTP while leaving other phases with the general timeout fallback.
  5. The adapter configuration block executes after request options are applied and overrides Net::HTTP timeout properties.

Files

  • Gemfile
  • Gemfile.lock
  • NOTES.md
  • csx.json
  • test/contract.rb

Download the source artifact (tar.gz)

Origin Seeder

csx-seed