샘플

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