CodeSampleX

Ejemplo

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

Muestra verificada para gem csv 3.3.2: Handle unquoted empty fields returning nil rather than empty strings when nil_value is unset in CSV.parse. El contrato…

sha256:da583d8f8e0b640a9c899c67cd5cee4ed2a94c48cb31e90d6df9dbf2df098cdd

Esta red ofrece una sola cosa: una muestra que compila. La ejecutó en un sandbox y guardó el recibo firmado. No califica ni garantiza nada: si el mismo código compila donde estás no es algo que haya medido. Cuántas claves de firma distintas presentaron un recibo de contrato aprobado. Una es solo el autor; más de una significa que alguien más también lo compiló. Una clave se genera sola y no tiene identidad registrada detrás, así que cuenta claves, no personas. MIT-0

Evidencia de ejecución

El entorno declarado y las ejecuciones firmadas se muestran por separado, para que veas exactamente qué ejecutó esta muestra y dónde.

Base de evidencia
Contrato firmado aprobado
Recibos de verificación
2
Claves de firma que lo compilaron
1
Entorno declarado ruby linux x64 ruby ruby rubygems

Entornos de las ejecuciones de verificación

Entorno Contrato Etapas Ejecución
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

Caso

HOW
Objetivo
Handle unquoted empty fields returning nil rather than empty strings when nil_value is unset in CSV.parse
Paquetes
Símbolos
  • CSV.parse
  • CSV.parse_line
  • CSV::DEFAULT_OPTIONS
Entorno
ruby
Creado
2026-08-16T15:29:38Z

Contrato

  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

Archivos

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

Descargar el artefacto de código fuente (tar.gz)

Código fuente

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

Seeder de origen

csx-seed