info.fingo.spata.error

Base exception reported by CSV handling methods. May be thrown, raised through fs2.Stream#raiseError or returned as Left, depending on context.

Exception subclasses denote errors which make CSV parsing or rendering completely impossible, while Errors are typically local and mean that at least partial results should be available.

For possible error codes see concrete classes implementations.

Position is the record and line number at which error has been detected. See Position for row and line description.

col is the position (character) at given line at which the error has been detected. 0 means "before first character".

field is the name (key) of field at which error has been detected. It may be a name from header or a number (starting with 0) if no header is present.

Error for content-related issues, typically reported on record level.

Error reported for CSV data problems, caused by string parsing.

Possible messageCodes are:

• wrongType for error caused by parsing field to specific type.

Field information provided in case of error.

Depending and the stage of CSV processing (parsing, accessing) and the type of error, it may be available fully (with name and index), partially (with name or index) or not available at all.

Error reported while accessing field with incorrect header value (key).

Possible messageCodes are:

• wrongKey for error caused by accessing field with incorrect key.

Error reported while accessing field with incorrect index.

Possible messageCodes are:

• wrongIndex for error caused by accessing field with index out of bounds.

Exception reported for CSV format errors.

Possible messageCodes are:

• unclosedQuotation for not enclosed quotation,
• unescapedQuotation for not escaped quotation,
• unmatchedQuotation for unmatched quotation (probably premature end of file),
• fieldTooLong for values longer than provided maximum (may be caused by unmatched quotation),
• missingHeader when header isn't found (may be empty content),
• duplicatedHeader when two or more header names are duplicated (not unique),
• wrongNumberOfFields when number of values doesn't match header or previous records size.