Encoding and decoding UTF-8 JSON content.

This module is a thin wrapper around the most excellent aeson library, which has rich and powerful facilities for encoding Haskell types into JSON.

Quite often, however, you find yourself having to create a Haskell type just to read some JSON coming from an external web service or API. This can be challenging when the source of the JSON is complex or varying its schema over time. For ease of exploration this module simply defines an easy to use intermediate type representing JSON as a format.

To use this module, you may find the following imports helpful:

{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE OverloadedLists #-}

import Data.HashMap.Strict (HashMap)
import qualified Data.HashMap.Strict as HashMap  -- from the unordered-containers package.
import Data.Scientific (Scientific)              -- from the scientific package
import Core.Encoding.Json

Often you'll be working with literals directly in your code. While you can write:

    j = JsonObject (HashMap.fromList [(JsonKey "answer", JsonNumber 42)])

and it would be correct, enabling OverloadedStrings and OverloadedLists allows you to write:

    j = JsonObject [("answer", 42)]

which you is somewhat less cumbersome. You're certainly welcome to use the constructors if you find it makes for more readable code or if you need the type annotations.

Support for pretty-printing JSON values with syntax highlighting using the prettyprinter library. To output a JSON structure to terminal colourized with ANSI escape codes you can use the Render instance:

    debug "j" (render j)

will get you:

23:46:04Z (00000.007) j =
{
    "answer": 42.0
}