CodeSampleX

Exemplo

csv 3.3.2: Handle CSV::InvalidEncodingError inheriting from MalformedCSVError rather than EncodingError, ArgumentError on nil inputs, and unclosed quotes despite liberal_parsing in CSV

Amostra verificada para gem csv 3.3.2: Handle CSV::InvalidEncodingError inheriting from MalformedCSVError rather than EncodingError, ArgumentError on nil…

sha256:6c5ffc8a79396c5e831eed2edeefc0ee240d543d3937dad970365842c019aef5

Esta rede oferece uma coisa: uma amostra que compila. Ela a executou em um sandbox e guardou o recibo assinado. Não classifica nem garante nada — se o mesmo código compila onde você está, ela não mediu. Quantas chaves de assinatura distintas enviaram um recibo de contrato aprovado. Uma é só o autor; mais de uma significa que outra pessoa também o compilou. Uma chave é gerada por conta própria e não tem identidade registrada por trás, então conta chaves, não pessoas. MIT-0

Evidência de execução

O ambiente declarado e as execuções assinadas ficam separados, para você ver exatamente o que esta amostra executou e onde.

Base da evidência
Contrato assinado aprovado
Recibos de verificação
2
Chaves de assinatura que o compilaram
1
Ambiente declarado ruby linux x64 ruby ruby rubygems

Ambientes das execuções de verificação

Ambiente Contrato Etapas Execução
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 CSV::InvalidEncodingError inheriting from MalformedCSVError rather than EncodingError, ArgumentError on nil inputs, and unclosed quotes despite liberal_parsing in CSV
Pacotes
Símbolos
  • CSV.parse
  • CSV.parse_line
  • CSV::InvalidEncodingError
  • CSV::MalformedCSVError
Ambiente
ruby
Criado
2026-08-16T15:29:41Z

Contrato

  1. CSV::InvalidEncodingError inherits from CSV::MalformedCSVError and RuntimeError rather than EncodingError, so rescue EncodingError fails to catch byte sequence errors during parsing.
  2. assert CSV.parse with invalid byte sequences raises CSV::InvalidEncodingError reporting the 1-based line_number
  3. assert CSV.parse and CSV.parse_line raise ArgumentError with message 'Cannot parse nil as CSV' when passed nil
  4. assert CSV.parse_line on an empty string returns nil whereas CSV.parse returns an empty array
  5. assert CSV.parse with liberal_parsing: true allows unescaped quotes but still raises CSV::MalformedCSVError on unclosed quotes
  6. assert CSV::MalformedCSVError inherits from RuntimeError and attaches line_number on parse errors

Arquivos

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

Baixar o artefato de código-fonte (tar.gz)

Código-fonte

Gemfile
source "https://rubygems.org"

gem "csv", "3.3.2"
gem "minitest", "5.27.0"
NOTES.md
# CSV Error Handling and Exception Hierarchy

### What `search_known_solution` answered

`search_known_solution` returned solutions covering standard library gem extraction LoadError resolutions (`sha256:7a622d8fbf61d9ccea9796f655d24afc226f861f933bc616c92ec7ee61ee448a`), table column indexing and hash header options (`sha256:466c2fd16d517415d38d889cd50560baa51c047e07cf6c380d184017e49bc546`), unquoted empty field nil defaults (`sha256:c825eb65a96e1f546764b9977a96d6b3dc0851d4d70bd430ee72a1586d402042`), and patch release features such as `:time` converters and `CSV::TSV` (`sha256:65f1b7d865302e8c0007869aff760ff4bd370078646a81d44b356b9f2dfc0880`). None proved the exception inheritance hierarchy of `CSV::InvalidEncodingError` and `CSV::MalformedCSVError`, input validation errors for `nil`, or the parsing limits of `liberal_parsing: true`.

### What a model would have written instead

A model assumes `CSV::InvalidEncodingError` is a subclass of Ruby core's `EncodingError` and handles it with `rescue EncodingError`, assumes `CSV.parse(nil)` raises `TypeError` or returns an empty collection similar to `CSV.parse("")`, assumes `CSV.parse_line("")` returns an empty array, and assumes setting `liberal_parsing: true` bypasses syntax errors including unclosed quoted fields.

### How the wrong version fails

Fails loudly with uncaught `CSV::InvalidEncodingError` or `CSV::MalformedCSVError` (which inherit from `RuntimeError` rather than `EncodingError`) when callers attempt to rescue `EncodingError`, and fails loudly with unhandled `ArgumentError` when passing `nil` where callers only handle `TypeError` or expect empty collections.
csx.json
{"case":{"believed":"CSV::InvalidEncodingError inherits from Ruby core's EncodingError, and liberal_parsing: true suppresses unclosed quote errors.","caseId":"case:sha256:fe859a4000535ebc1150013769bba5c4ce59700b9303094219ab5aa3710d5995","contract":["CSV::InvalidEncodingError inherits from CSV::MalformedCSVError and RuntimeError rather than EncodingError, so rescue EncodingError fails to catch byte sequence errors during parsing.","assert CSV.parse with invalid byte sequences raises CSV::InvalidEncodingError reporting the 1-based line_number","assert CSV.parse and CSV.parse_line raise ArgumentError with message 'Cannot parse nil as CSV' when passed nil","assert CSV.parse_line on an empty string returns nil whereas CSV.parse returns an empty array","assert CSV.parse with liberal_parsing: true allows unescaped quotes but still raises CSV::MalformedCSVError on unclosed quotes","assert CSV::MalformedCSVError inherits from RuntimeError and attaches line_number on parse errors"],"goal":"Handle CSV::InvalidEncodingError inheriting from MalformedCSVError rather than EncodingError, ArgumentError on nil inputs, and unclosed quotes despite liberal_parsing in CSV","kind":"HOW","packages":["pkg:gem/csv@3.3.2"],"schemaVersion":1,"symbols":["CSV.parse","CSV.parse_line","CSV::InvalidEncodingError","CSV::MalformedCSVError"]},"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::InvalidEncodingError","CSV::MalformedCSVError"],"verifierAdapter":"rubygems@1"}
test/contract.rb
require "minitest/autorun"
require "csv"

class CsvErrorPathsContractTest < Minitest::Test
  def test_invalid_encoding_error_inherits_from_malformed_csv_error_not_encoding_error
    # Developers expect CSV::InvalidEncodingError to inherit from Ruby's EncodingError.
    # In reality, it inherits from CSV::MalformedCSVError < RuntimeError, so
    # rescue EncodingError will NOT intercept byte sequence errors during parsing.
    refute CSV::InvalidEncodingError < EncodingError,
      "CSV::InvalidEncodingError should not inherit from EncodingError"
    assert CSV::InvalidEncodingError < CSV::MalformedCSVError,
      "CSV::InvalidEncodingError must inherit from CSV::MalformedCSVError"
    assert CSV::InvalidEncodingError < RuntimeError,
      "CSV::InvalidEncodingError must inherit from RuntimeError"

    invalid_utf8_csv = "id,name\n1,valid\n2,\xFF\xFE_broken\n".dup.force_encoding(Encoding::UTF_8)

    caught_by_encoding_error = false
    caught_by_malformed_error = false
    reported_line = nil

    begin
      CSV.parse(invalid_utf8_csv)
    rescue EncodingError
      caught_by_encoding_error = true
    rescue CSV::MalformedCSVError => e
      caught_by_malformed_error = true
      reported_line = e.line_number
    end

    refute caught_by_encoding_error,
      "EncodingError handler must not intercept CSV::InvalidEncodingError"
    assert caught_by_malformed_error,
      "CSV::MalformedCSVError handler must catch CSV::InvalidEncodingError"
    assert_equal 3, reported_line,
      "InvalidEncodingError line_number should report the exact 1-based row"
  end

  def test_nil_input_raises_argument_error_rather_than_type_error_or_malformed_error
    # Developers expect nil to raise TypeError or return an empty result like CSV.parse("").
    # CSV.parse(nil) and CSV.parse_line(nil) explicitly raise ArgumentError.
    err_parse = assert_raises(ArgumentError) do
      CSV.parse(nil)
    end
    assert_equal "Cannot parse nil as CSV", err_parse.message

    err_line = assert_raises(ArgumentError) do
      CSV.parse_line(nil)
    end
    assert_equal "Cannot parse nil as CSV", err_line.message
  end

  def test_empty_input_behavior_differences
    # CSV.parse("") returns an empty array ([]), but CSV.parse_line("") returns nil.
    # Passing a newline "\n" to CSV.parse_line returns an empty row array ([]).
    assert_equal [], CSV.parse("")
    assert_nil CSV.parse_line("")
    assert_equal [], CSV.parse_line("\n")
  end

  def test_liberal_parsing_allows_unescaped_quotes_but_still_raises_on_unclosed_quotes
    # liberal_parsing: true permits unescaped quotes within fields,
    # but does NOT forgive unclosed quoted fields.
    unescaped_input = "col1,col2\nval1,un\"escaped\"val\n"
    parsed = CSV.parse(unescaped_input, liberal_parsing: true)
    assert_equal [["col1", "col2"], ["val1", "un\"escaped\"val"]], parsed

    unclosed_input = "col1,col2\nval1,\"unclosed_value\n"
    err = assert_raises(CSV::MalformedCSVError) do
      CSV.parse(unclosed_input, liberal_parsing: true)
    end
    assert_equal 2, err.line_number
    assert_match(/Unclosed quoted field/, err.message)
  end

  def test_malformed_csv_error_superclass_and_line_number_metadata
    # CSV::MalformedCSVError inherits from RuntimeError and attaches line_number.
    assert_equal RuntimeError, CSV::MalformedCSVError.superclass

    bad_syntax = "a,b\n1,\"unclosed\n"
    err = assert_raises(CSV::MalformedCSVError) do
      CSV.parse(bad_syntax)
    end
    assert_equal 2, err.line_number
    assert_equal 2, err.lineno
  end
end

Seeder de origem

csx-seed