Ejemplo
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
Muestra verificada para gem csv 3.3.2: Handle CSV::InvalidEncodingError inheriting from MalformedCSVError rather than EncodingError, ArgumentError on nil…
sha256:6c5ffc8a79396c5e831eed2edeefc0ee240d543d3937dad970365842c019aef5
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 CSV::InvalidEncodingError inheriting from MalformedCSVError rather than EncodingError, ArgumentError on nil inputs, and unclosed quotes despite liberal_parsing in CSV
- Paquetes
- Símbolos
-
- CSV.parse
- CSV.parse_line
- CSV::InvalidEncodingError
- CSV::MalformedCSVError
- Entorno
- ruby
- Creado
- 2026-08-16T15:29:41Z
Contrato
- 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
Archivos
- Gemfile
- NOTES.md
- csx.json
- test/contract.rb
Código fuente
source "https://rubygems.org"
gem "csv", "3.3.2"
gem "minitest", "5.27.0"
# 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.
{"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"}
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