Пример
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. Контракт…
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
Контракт
- 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
Файлы
- Gemfile
- NOTES.md
- csx.json
- test/contract.rb
Исходный код
source "https://rubygems.org"
gem "csv", "3.3.2"
gem "minitest", "5.27.0"
# 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.
{"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"}
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