Пример

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