샘플

Preserve Ruby object and key types across JSON serialization boundaries without falling into as_json omission, symbolize_names and create_additions incompatibility, or silent key collision data loss

sha256:274b26e9f2c0a58c7a444f4d62e6bb7ca665c0f5f1069a445b9faa8adecd8b4d

케이스

목표

Preserve Ruby object and key types across JSON serialization boundaries without falling into as_json omission, symbolize_names and create_additions incompatibility, or silent key collision data loss HOW

패키지

json 2.9.1

환경

ruby

생성일

2026-08-16T17:36:59Z

흔히 이렇게 알고 있다

JSON.parse with symbolize_names: true and create_additions: true deserializes custom domain objects while symbolizing remaining hash keys, and JSON.generate serializes objects that implement as_json.

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

컨트랙트

• assert JSON.parse raises ArgumentError when :symbolize_names and :create_additions are combined, making addition deserialization mutually exclusive with key symbolization
• assert JSON.generate ignores as_json and serializes arbitrary objects to inspect strings unless to_json is defined, while a to_json returning a Hash raises TypeError
• assert JSON.parse with create_additions: true instantiates registered domain objects via json_create, whereas custom create_id mismatch or missing json_create returns a plain Hash and uninitialized classes raise ArgumentError
• assert JSON.generate stringifies non-string hash keys where nil becomes an empty string, and colliding stringified keys silently overwrite earlier values on parse
• assert core Ruby types like Range and Symbol require json/add extensions to encode json_class structures, which default JSON.parse reads as Hash and create_additions: true restores to exact instances

파일

• Gemfile
• NOTES.md
• csx.json
• src/type_boundary.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