FAILURE MAP
← Case archive

FA-47851 / Delimited text / Open access

The preamble parser includes the equals sign in its delimiter · case 01

A structured table violates the declared record or column contract.

Verified by executionVariant 1 · 9 checks per implementationDownload source bundle ↓JSON ↗

ROOT CAUSE

The control-prefix slice stops one character early.

VERIFIED REPAIR

Preserve the named invariant at the faulty decision: value = lines.pop(0)[4:]

Unsuccessful approach: Advancing one character further drops the delimiter itself.

Case contract

Read a table with optional exact first line sep=<single nonquote, nonnewline character>. A first-line BOM is removed before recognizing this directive. Without directive use comma. The directive is not data. Later sep= lines are ordinary records. Return delimiter and split records; empty input has no records.

Why this case matters

Delimited interchange needs explicit framing, schema and field semantics at ingestion and emission boundaries.

1 / The failure

Exit 1
"""Failure Map reference implementation. Python standard library only."""
import json
def _vary(value):
    if value == '@END': return 3 + 4*N
    if isinstance(value, str): return value.replace('@', 'cell' * N)
    if isinstance(value, list): return [_vary(x) for x in value]
    if isinstance(value, dict): return {_vary(k): _vary(v) for k,v in value.items()}
    return value
N = 1
observations = []
def solve(data):
    lines = list(data)
    if not lines: return [',', []]
    if lines[0].startswith('\ufeff'): lines[0] = lines[0][1:]
    delimiter = ','
    if lines[0].startswith('sep='):
        value = lines.pop(0)[3:]
        if len(value) != 1 or value in '\r\n"': return None
        delimiter = value
    return [delimiter, [line.split(delimiter) for line in lines]]
def check(label, actual, expected):
    observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
check('custom', solve(_vary(['sep=;', '@;x'])), _vary([';', [['@', 'x']]]))
check('BOM directive', solve(_vary(['\ufeffsep=;', '@;x'])), _vary([';', [['@', 'x']]]))
check('default', solve(_vary(['@,x'])), _vary([',', [['@', 'x']]]))
check('later directive', solve(_vary(['a,b', 'sep=;'])), _vary([',', [['a', 'b'], ['sep=;']]]))
check('bad multi', solve(_vary(['sep=;;', 'x'])), _vary(None))
check('bad quote', solve(_vary(['sep="', 'x'])), _vary(None))
check('empty marker', solve(_vary(['sep=', 'x'])), _vary(None))
check('directive only', solve(_vary(['sep=;'])), _vary([';', []]))
check('zero', solve(_vary([])), _vary([',', []]))
print(json.dumps({"observations": observations, "passed": all(x["passed"] for x in observations)}, ensure_ascii=False))
raise SystemExit(0 if all(x["passed"] for x in observations) else 1)
Boundary fixtureActualExpectedOutcome
customNone[';', [['cell', 'x']]]Failed
BOM directiveNone[';', [['cell', 'x']]]Failed
default[',', [['cell', 'x']]][',', [['cell', 'x']]]Passed
later directive[',', [['a', 'b'], ['sep=;']]][',', [['a', 'b'], ['sep=;']]]Passed
bad multiNoneNonePassed
bad quoteNoneNonePassed
empty marker['=', [['x']]]NoneFailed
directive onlyNone[';', []]Failed
zero[',', []][',', []]Passed

SHA-256 / d4f4823013e9a8fcd4401d921bd88e74a36070953d06c5da85a6255ae302d7da

2 / The unsuccessful fix

Exit 1
"""Failure Map reference implementation. Python standard library only."""
import json
def _vary(value):
    if value == '@END': return 3 + 4*N
    if isinstance(value, str): return value.replace('@', 'cell' * N)
    if isinstance(value, list): return [_vary(x) for x in value]
    if isinstance(value, dict): return {_vary(k): _vary(v) for k,v in value.items()}
    return value
N = 1
observations = []
def solve(data):
    lines = list(data)
    if not lines: return [',', []]
    if lines[0].startswith('\ufeff'): lines[0] = lines[0][1:]
    delimiter = ','
    if lines[0].startswith('sep='):
        value = lines.pop(0)[5:]
        if len(value) != 1 or value in '\r\n"': return None
        delimiter = value
    return [delimiter, [line.split(delimiter) for line in lines]]
def check(label, actual, expected):
    observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
check('custom', solve(_vary(['sep=;', '@;x'])), _vary([';', [['@', 'x']]]))
check('BOM directive', solve(_vary(['\ufeffsep=;', '@;x'])), _vary([';', [['@', 'x']]]))
check('default', solve(_vary(['@,x'])), _vary([',', [['@', 'x']]]))
check('later directive', solve(_vary(['a,b', 'sep=;'])), _vary([',', [['a', 'b'], ['sep=;']]]))
check('bad multi', solve(_vary(['sep=;;', 'x'])), _vary(None))
check('bad quote', solve(_vary(['sep="', 'x'])), _vary(None))
check('empty marker', solve(_vary(['sep=', 'x'])), _vary(None))
check('directive only', solve(_vary(['sep=;'])), _vary([';', []]))
check('zero', solve(_vary([])), _vary([',', []]))
print(json.dumps({"observations": observations, "passed": all(x["passed"] for x in observations)}, ensure_ascii=False))
raise SystemExit(0 if all(x["passed"] for x in observations) else 1)
Boundary fixtureActualExpectedOutcome
customNone[';', [['cell', 'x']]]Failed
BOM directiveNone[';', [['cell', 'x']]]Failed
default[',', [['cell', 'x']]][',', [['cell', 'x']]]Passed
later directive[',', [['a', 'b'], ['sep=;']]][',', [['a', 'b'], ['sep=;']]]Passed
bad multi[';', [['x']]]NoneFailed
bad quoteNoneNonePassed
empty markerNoneNonePassed
directive onlyNone[';', []]Failed
zero[',', []][',', []]Passed

SHA-256 / 57cf2f459bd0529b108ad94eabb69a55d3f8fec4593bc0a218d6a96e8f2d9239

3 / The verified repair

Exit 0
"""Failure Map reference implementation. Python standard library only."""
import json
def _vary(value):
    if value == '@END': return 3 + 4*N
    if isinstance(value, str): return value.replace('@', 'cell' * N)
    if isinstance(value, list): return [_vary(x) for x in value]
    if isinstance(value, dict): return {_vary(k): _vary(v) for k,v in value.items()}
    return value
N = 1
observations = []
def solve(data):
    lines = list(data)
    if not lines: return [',', []]
    if lines[0].startswith('\ufeff'): lines[0] = lines[0][1:]
    delimiter = ','
    if lines[0].startswith('sep='):
        value = lines.pop(0)[4:]
        if len(value) != 1 or value in '\r\n"': return None
        delimiter = value
    return [delimiter, [line.split(delimiter) for line in lines]]
def check(label, actual, expected):
    observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
check('custom', solve(_vary(['sep=;', '@;x'])), _vary([';', [['@', 'x']]]))
check('BOM directive', solve(_vary(['\ufeffsep=;', '@;x'])), _vary([';', [['@', 'x']]]))
check('default', solve(_vary(['@,x'])), _vary([',', [['@', 'x']]]))
check('later directive', solve(_vary(['a,b', 'sep=;'])), _vary([',', [['a', 'b'], ['sep=;']]]))
check('bad multi', solve(_vary(['sep=;;', 'x'])), _vary(None))
check('bad quote', solve(_vary(['sep="', 'x'])), _vary(None))
check('empty marker', solve(_vary(['sep=', 'x'])), _vary(None))
check('directive only', solve(_vary(['sep=;'])), _vary([';', []]))
check('zero', solve(_vary([])), _vary([',', []]))
print(json.dumps({"observations": observations, "passed": all(x["passed"] for x in observations)}, ensure_ascii=False))
raise SystemExit(0 if all(x["passed"] for x in observations) else 1)
Boundary fixtureActualExpectedOutcome
custom[';', [['cell', 'x']]][';', [['cell', 'x']]]Passed
BOM directive[';', [['cell', 'x']]][';', [['cell', 'x']]]Passed
default[',', [['cell', 'x']]][',', [['cell', 'x']]]Passed
later directive[',', [['a', 'b'], ['sep=;']]][',', [['a', 'b'], ['sep=;']]]Passed
bad multiNoneNonePassed
bad quoteNoneNonePassed
empty markerNoneNonePassed
directive only[';', []][';', []]Passed
zero[',', []][',', []]Passed

SHA-256 / 8fabc2b5931577e048a269d4a147f73b0a0137a2340e20dc50bf9d50bec13875

Verification & scope

Deterministic bounded in-memory model. No claim of complete CSV or external format conformance. This reproducer isolates one failure mechanism. Results cover the supplied fixtures. Variants within a family share a test contract and should remain grouped when constructing evaluation splits. Related mechanisms with a shared evaluation_group must also remain together; these controlled models are not independent production incidents.

Observations recorded using Python 3.12.14 at 2026-09-29T14:44:45.371170+00:00.

Case digest / ec96991f8c1cd0d297763ac296d987ff068e80b0b73933604432d85aa34ce5f2