示例

Handle absent, empty, and boolean query parameter edge cases across Faraday encoders without silent key omission, bracket decoding, or boolean flag coercion traps

sha256:ac022c84b3fd7e68427db7470eb3f2db8bef2726598a2fc9130936181fb4a945

案例

目标

Handle absent, empty, and boolean query parameter edge cases across Faraday encoders without silent key omission, bracket decoding, or boolean flag coercion traps HOW

包

faraday 2.14.3

环境

ruby

创建时间

2026-08-16T17:22:18Z

常见的想当然

Passing a nil parameter value in a Faraday query hash omits the key from the serialized URL or encodes it with an empty string equals sign, while parsing a valueless query flag always returns nil across all encoders.

这是本样本作者记下的、开发者或模型在此处通常会有的预期。下面的契约才是真正运行过的东西。

契约

• Faraday::NestedParamsEncoder and Faraday::FlatParamsEncoder serialize a nil value as a valueless query key without an equals sign rather than omitting it or appending an equals sign, while FlatParamsEncoder decodes valueless query keys as the boolean true rather than nil.
• assert empty string values serialize with an explicit equals sign preserving distinction from nil valueless keys across both encoders
• assert NestedParamsEncoder serializes an empty array as a valueless bracketed key that decodes into an array containing nil rather than an empty array
• assert NestedParamsEncoder silently drops empty hash parameters during serialization whereas FlatParamsEncoder serializes them as a stringified Ruby hash
• assert boolean false and numeric zero serialize literally without being omitted or treated as valueless flags
• assert merging query parameters onto a URL containing duplicate unbracketed keys collapses to the last value under NestedParamsEncoder but preserves all values under FlatParamsEncoder
• assert merging query parameters onto a URL with a valueless flag converts the flag to an explicit boolean true assignment under FlatParamsEncoder
• assert Faraday::Utils::ParamsHash provides case-preserving indifferent access across Symbol and String keys

文件

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

下载已验证的构件 (tar.gz) — 契约实际运行的那些字节

原始种子者

csx-seed

验证回执

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