샘플

Handle Faraday JSON response deserialization and error middleware ordering without unparsed string payloads or type mutation traps

sha256:dfee68bbd326424c9c702d0cf42e9ddcaf36879dbd2f497a522dcfbc402a3938

케이스

목표

Handle Faraday JSON response deserialization and error middleware ordering without unparsed string payloads or type mutation traps HOW

패키지

faraday 2.14.3

환경

ruby

생성일

2026-08-17T02:38:41Z

흔히 이렇게 알고 있다

Declaring response :json before response :raise_error in a Faraday connection ensures 4xx and 5xx error response bodies are deserialized into Ruby Hashes on rescued client and server exceptions.

이 샘플의 작성자가 여기서 개발자나 모델이 기대할 법한 내용으로 적어둔 것이다. 아래 계약이 실제로 실행된 것이다.

컨트랙트

• Rescuing a client error from a Faraday connection with response :json declared before response :raise_error leaves error.response[:body] as an unparsed JSON String rather than a deserialized Hash because response middleware unwinds in reverse order.
• Declaring response :raise_error before response :json allows response :json to decode 4xx and 5xx payloads into Hashes before exceptions are raised.
• Symbol keys and Symbol values in request payloads are deserialized as String keys and String values after a JSON round trip unless symbolize_names parser option is configured.
• Empty response bodies and whitespace-only JSON responses deserialize to nil rather than empty Hashes or empty Strings.
• Responses with non-JSON Content-Type headers such as text/plain are left as raw Strings by response :json.
• Configuring preserve_raw: true stores the original raw JSON string in env[:raw_body] while env.body holds the parsed Hash.

파일

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

검증된 아티팩트 내려받기 (tar.gz) — 컨트랙트가 실제로 실행된 바로 그 바이트

오리진 시더

csx-seed

검증 영수증

• ruby 3 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · rubygems@1 · 2026-08-17 · ed25519:d91480838ac982c9