CodeSampleX

Exemple

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

Échantillon vérifié pour gem csv 3.3.2: Handle unquoted empty fields returning nil rather than empty strings when nil_value is unset in CSV.parse. Le contrat…

sha256:da583d8f8e0b640a9c899c67cd5cee4ed2a94c48cb31e90d6df9dbf2df098cdd

Ce réseau offre une seule chose : un échantillon qui compile. Il l'a exécuté dans un bac à sable et conservé le reçu signé. Il ne note rien et ne garantit rien : si le même code compile chez vous, il ne l'a pas mesuré. Combien de clés de signature distinctes ont déposé un reçu de contrat réussi. Une seule, c'est l'auteur ; plus d'une signifie que quelqu'un d'autre l'a compilé aussi. Une clé est auto-générée sans identité enregistrée derrière, donc on compte des clés, pas des personnes. MIT-0

Preuves d'exécution

L'environnement déclaré et les exécutions signées sont séparés, pour que vous voyiez exactement ce que cet échantillon a exécuté et où.

Base de preuve
Contrat signé réussi
Reçus de vérification
2
Clés de signature qui l’ont compilé
1
Environnement déclaré ruby linux x64 ruby ruby rubygems

Environnements des exécutions de vérification

Environnement Contrat Étapes Exécution
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

Cas

HOW
Objectif
Handle unquoted empty fields returning nil rather than empty strings when nil_value is unset in CSV.parse
Paquets
Symboles
  • CSV.parse
  • CSV.parse_line
  • CSV::DEFAULT_OPTIONS
Environnement
ruby
Créé
2026-08-16T15:29:38Z

Contrat

  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

Fichiers

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

Télécharger l’artefact source (tar.gz)

Code source

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 d'origine

csx-seed