Data.Csv.Parser.Megaparsec

A CSV parser. The parser here is RFC 4180 compliant, with the following extensions:

• Non-escaped fields may contain any characters except double-quotes, commas (or generally delimiter characters), carriage returns, and newlines.
• Escaped fields may contain any characters, but double-quotes need to be escaped.

The parser provides better error messages than the parser that comes with Cassava library, while being compatible with the rest of the library.

Documentation

data ConversionError

Custom error component for CSV parsing. It allows typed reporting of conversion errors.

Constructors

ConversionError String

Instances

Eq ConversionError

Methods

(==) :: ConversionError -> ConversionError -> Bool

(/=) :: ConversionError -> ConversionError -> Bool

Data ConversionError

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ConversionError -> c ConversionError

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ConversionError

toConstr :: ConversionError -> Constr

dataTypeOf :: ConversionError -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c ConversionError)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ConversionError)

gmapT :: (forall b. Data b => b -> b) -> ConversionError -> ConversionError

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ConversionError -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ConversionError -> r

gmapQ :: (forall d. Data d => d -> u) -> ConversionError -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> ConversionError -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> ConversionError -> m ConversionError

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ConversionError -> m ConversionError

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ConversionError -> m ConversionError

Ord ConversionError

Methods

compare :: ConversionError -> ConversionError -> Ordering

(<) :: ConversionError -> ConversionError -> Bool

(<=) :: ConversionError -> ConversionError -> Bool

(>) :: ConversionError -> ConversionError -> Bool

(>=) :: ConversionError -> ConversionError -> Bool

max :: ConversionError -> ConversionError -> ConversionError

min :: ConversionError -> ConversionError -> ConversionError

Read ConversionError

Methods

readsPrec :: Int -> ReadS ConversionError

readList :: ReadS [ConversionError]

readPrec :: ReadPrec ConversionError

readListPrec :: ReadPrec [ConversionError]

Show ConversionError

Methods

showsPrec :: Int -> ConversionError -> ShowS

show :: ConversionError -> String

showList :: [ConversionError] -> ShowS

ShowErrorComponent ConversionError

Methods

showErrorComponent :: ConversionError -> String

decode

Arguments

:: FromRecord a

=> HasHeader

Whether the data contains header that should be skipped

-> FilePath

File name (use empty string if you have none)

-> ByteString

CSV data

-> Either (ParseError Word8 ConversionError) (Vector a)

Deserialize CSV records form a lazy ByteString. If this fails due to incomplete or invalid input, Left is returned. Equivalent to decodeWith defaultDecodeOptions.

decodeWith

Arguments

:: FromRecord a

=> DecodeOptions

Decoding options

-> HasHeader

Whether the data contains header that should be skipped

-> FilePath

File name (use empty string if you have none)

-> ByteString

CSV data

-> Either (ParseError Word8 ConversionError) (Vector a)

Like decode, but lets you customize how the CSV data is parsed.

decodeByName

Arguments

:: FromNamedRecord a

=> FilePath

File name (use empty string if you have none)

-> ByteString

CSV data

-> Either (ParseError Word8 ConversionError) (Header, Vector a)

Deserialize CSV records from a lazy ByteString. If this fails due to incomplete or invalid input, Left is returned. The data is assumed to be preceded by a header. Equivalent to decodeByNameWith defaultDecodeOptions.

decodeByNameWith

Arguments

:: FromNamedRecord a

=> DecodeOptions

Decoding options

-> FilePath

File name (use empty string if you have none)

-> ByteString

CSV data

-> Either (ParseError Word8 ConversionError) (Header, Vector a)

Like decodeByName, but lets you customize how the CSV data is parsed.