Exemplo

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

Caso

Objetivo

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

Pacotes

faraday 2.14.3

Ambiente

ruby

Criado

2026-08-16T17:22:18Z

O que costuma-se supor

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.

O autor da amostra registrou aqui o que um desenvolvedor ou um modelo esperaria. O contrato abaixo é o que de fato rodou.

Contrato

• 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

Arquivos

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

Baixar o artefato verificado (tar.gz) — exatamente os bytes contra os quais o contrato rodou

Seeder de origem

csx-seed

Recibos de verificação

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