CodeSampleX

샘플

csv 3.3.2: Handle unquoted empty fields returning nil rather than empty strings when nil_value is unset in CSV.parse

검증된 샘플 — gem csv 3.3.2: Handle unquoted empty fields returning nil rather than empty strings when nil_value is unset in CSV.parse. ruby 3 · linux alpine/x64…

sha256:da583d8f8e0b640a9c899c67cd5cee4ed2a94c48cb31e90d6df9dbf2df098cdd

이 네트워크가 제공하는 것은 하나입니다. 빌드되는 샘플. 샌드박스에서 돌리고 서명된 영수증을 보관합니다. 등급을 매기지 않고 무엇도 보증하지 않습니다 — 같은 코드가 당신 환경에서 빌드되는지는 측정한 적이 없습니다. 통과한 계약 영수증을 낸 서로 다른 서명 키의 수입니다. 하나면 작성자 혼자이고, 둘 이상이면 다른 사람도 빌드했다는 뜻입니다. 키는 스스로 만드는 것이고 뒤에 등록된 신원이 없으므로, 세는 것은 사람이 아니라 키입니다. MIT-0

실행 증거

선언된 환경과 서명된 실행을 분리해 두었습니다. 이 샘플이 무엇을 어디서 실행했는지 그대로 볼 수 있습니다.

증거 기준
서명된 컨트랙트 통과
검증 영수증
2
빌드한 서명 키
1
선언된 환경 ruby linux x64 ruby ruby rubygems

검증 실행 환경

환경 컨트랙트 단계 실행일
ruby 3 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · rubygems@1
2026-08-16
ruby 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 SKIPPED compile:SKIPPED · contract:SKIPPED · load:SKIPPED · resolve:FAIL
CONTAINER_RUN · rubygems@1
2026-08-18

케이스

HOW
목표
Handle unquoted empty fields returning nil rather than empty strings when nil_value is unset in CSV.parse
패키지
심벌
  • CSV.parse
  • CSV.parse_line
  • CSV::DEFAULT_OPTIONS
환경
ruby
생성일
2026-08-16T15:29:38Z

컨트랙트

  1. assert parsing unquoted empty fields returns nil rather than empty string when nil_value is left unset
  2. assert parsing quoted empty fields returns empty string governed by the default empty_value option
  3. assert CSV::DEFAULT_OPTIONS configures nil_value as nil and empty_value as empty string
  4. assert passing nil_value: '' normalizes unquoted empty fields to empty strings
  5. assert header indexed access yields nil for unquoted empty columns by default

파일

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

소스 아티팩트 내려받기 (tar.gz)

소스

Gemfile
source "https://rubygems.org"

gem "csv", "3.3.2"
gem "minitest", "5.27.0"
NOTES.md
# CSV Default Option Behavior: Unquoted Empty Fields

## Network Search Results

Searching the known solutions registry for `pkg:gem/csv` returned solutions for PHP `league/csv` configurations and Ruby standard library gem extraction schedules (`sha256:7a622d8fbf61d9ccea9796f655d24afc226f861f933bc616c92ec7ee61ee448a`). No existing entry covered the default option values in the Ruby standard library `csv` gem.

## Failure Mode

When callers assume unquoted empty fields (`a,,b`) parse to empty strings (`""`), code fails loudly at runtime with `NoMethodError (undefined method for nil:NilClass)` when calling string operations like `.strip` or `.empty?` on the resulting values, or silently propagates unexpected `nil` values into data pipelines that expect String instances.
csx.json
{"case":{"believed":"CSV.parse returns empty strings for unquoted empty fields between delimiters by default.","caseId":"case:sha256:9a597c5fd254f2c8e04519aff17e6b0608b33da89c9313c0f8588806cbefa480","contract":["assert parsing unquoted empty fields returns nil rather than empty string when nil_value is left unset","assert parsing quoted empty fields returns empty string governed by the default empty_value option","assert CSV::DEFAULT_OPTIONS configures nil_value as nil and empty_value as empty string","assert passing nil_value: '' normalizes unquoted empty fields to empty strings","assert header indexed access yields nil for unquoted empty columns by default"],"goal":"Handle unquoted empty fields returning nil rather than empty strings when nil_value is unset in CSV.parse","kind":"HOW","packages":["pkg:gem/csv@3.3.2"],"schemaVersion":1,"symbols":["CSV.parse","CSV.parse_line","CSV::DEFAULT_OPTIONS"]},"contractCommand":["ruby","test/contract.rb"],"environment":{"arch":"x64","ecosystem":"gem","executionContext":"ruby","language":"ruby","os":"linux","packageManager":"rubygems","runtime":"ruby","schemaVersion":1},"license":"MIT-0","packages":["pkg:gem/csv@3.3.2"],"schemaVersion":1,"symbols":["CSV.parse","CSV.parse_line","CSV::DEFAULT_OPTIONS"],"verifierAdapter":"rubygems@1"}
test/contract.rb
require "minitest/autorun"
require "csv"

class CsvNilValueDefaultTest < Minitest::Test
  def test_unquoted_empty_fields_return_nil_by_default
    raw_csv = "apple,,banana\n"
    row = CSV.parse_line(raw_csv)

    # Contradicts believed: unquoted empty field is nil, NOT empty string ""
    assert_nil row[1]
    refute_equal "", row[1]
    assert_instance_of NilClass, row[1]
  end

  def test_quoted_empty_fields_return_empty_string_by_default
    raw_csv = "apple,\"\",banana\n"
    row = CSV.parse_line(raw_csv)

    # Quoted empty fields return empty string "" via empty_value default
    assert_equal "", row[1]
    assert_instance_of String, row[1]
  end

  def test_default_options_distinguish_nil_value_from_empty_value
    assert_nil CSV::DEFAULT_OPTIONS[:nil_value]
    assert_equal "", CSV::DEFAULT_OPTIONS[:empty_value]
  end

  def test_explicit_nil_value_normalizes_empty_fields_to_string
    raw_csv = "apple,,banana\ncherry,\"\",date\n"
    rows = CSV.parse(raw_csv, nil_value: "")

    assert_equal ["apple", "", "banana"], rows[0]
    assert_equal ["cherry", "", "date"], rows[1]
  end

  def test_header_access_with_unset_nil_value_produces_nil
    raw_csv = "id,name,role\n1,,admin\n"
    table = CSV.parse(raw_csv, headers: true)

    assert_nil table[0]["name"]
    refute_equal "", table[0]["name"]
  end
end

오리진 시더

csx-seed