Various reason for failed parsing.

Since: 0.1.0

Parse a top level array into a stream of json values. Throws a ParserError on invalid input, see conduitArrayEither for more graceful error handling.

Examples

>>> :set -XTypeApplications
>>> :set -XOverloadedStrings
>>> import Conduit
>>> runConduit $ yield ("[1,2,3,4]") .| conduitArray @Int .| printC
1
2
3
4

Since: 0.1.0

Same as conduitArray, parse a top level array into a stream of values, but produce Left ParserError instead of failing immediately with an exception.

Since: 0.1.0

Parse a top level object into a stream of key/value pairs. Throws a ParserError on invalid input, see conduitObjectEither for more graceful error handling.

Examples

>>> :set -XOverloadedStrings
>>> :set -XTypeApplications
>>> import Conduit
>>> let input = "{ \"foo\": 1, \"bar\": 2, \"baz\": 3 }"
>>> runConduit $ yield input .| conduitObject @String @Int .| printC
("foo",1)
("bar",2)
("baz",3)

Since: 0.1.0

Same as conduitObject, except fails gracefully. Parse a top level object into a stream of key/value pairs with potential failures as Left ParserError.

Since: 0.1.0

Parse a top level array as a stream of JSON values. Expects opening and closing braket '[' and ']' at the beginning and the end of the stream respectfully. Nothing indicates terminating closing square braket has been reached, but it does not mean there are no left over bytes in the input stream.

Since: 0.1.0

Parse a stream of JSON values. Expects that there are no opening or closing top level array braces [ and ]. Could be very useful for consuming infinite streams of log entries, where each entry is formatted as a JSON value.

Examples

>>> import Conduit
>>> import Data.ByteString.Char8 (ByteString, pack)
>>> import Data.Attoparsec.ByteString.Char8 (char8)
>>> let input = pack "{\"foo\":1}\n{\"bar\":2}\n" :: ByteString
>>> let parser = conduitArrayParserNoStartEither (char8 '\n')
>>> runConduit (yield input .| parser .| printC)
Right (1:1 (0)-2:1 (10),Object (fromList [("foo",Number 1.0)]))
Right (2:1 (10)-3:1 (20),Object (fromList [("bar",Number 2.0)]))

>>> runConduit $ yield (pack "1,2,3,\"Haskell\",") .| conduitArrayParserNoStartEither (char8 ',') .| printC
Right (1:1 (0)-1:3 (2),Number 1.0)
Right (1:3 (2)-1:5 (4),Number 2.0)
Right (1:5 (4)-1:7 (6),Number 3.0)
Right (1:7 (6)-1:17 (16),String "Haskell")

Since: 0.1.0

Parse a top level key value mapping. Expects opening and closing braces '{' and '}'. Nothing indicates terminating closing curly brace has been reached, but it does not mean there are no left over bytes in the input stream.

Since: 0.1.0

Parse a stream of key/value pairs. Expects that there are no opening or closing top level curly braces '{' and '}'. It is suitable for infinite streams of key value/pairs delimited by a custom character, eg. a new line.

Examples

>>> import Conduit
>>> import Data.ByteString.Char8 (ByteString, pack)
>>> import Data.Attoparsec.ByteString.Char8 (char8)
>>> let input = pack "\"foo\":1|\"bar\":2|" :: ByteString
>>> let parser = conduitObjectParserNoStartEither (char8 '|')
>>> runConduit (yield input .| parser .| printC)
Right (1:1 (0)-1:9 (8),("foo",Number 1.0))
Right (1:9 (8)-1:17 (16),("bar",Number 2.0))

Since: 0.1.0

Skips all spaces and newlines

Since: 0.1.0

Use a comma for delimiter.

Since: 0.1.0

Parser for delimiter with terminating character

Since: 0.1.0

Consume '[' with all preceeding space characters

Since: 0.1.0

Parse a JSON value potentially prefixed by whitespace followed by a suffix

Since: 0.1.0

Parse a JSON value followed either by a delimiter or terminating character ']', which is also supplied to the delimiter parser. Nothing is returned when terminating character is reached.

Since: 0.1.1

Consume '{' with all preceeding space characters

Since: 0.1.0

Parse a JSON key value pair followed by a suffix

Since: 0.1.0

Parse JSON key value pairs followed either by a delimiter or terminating character ']', which is also supplied to the delimiter parser. Nothing is returned when terminating character is reached.

Since: 0.1.0