MIT licensed by Ian Grant Jeffries
Maintained by [email protected]
This version can be pinned in stack with:hjsonpointer-1.0.0.2@sha256:54740ca5a59e0217fb69000a07538a227d19b270242b5604ae0cb3c27d8196e4,1471

Module documentation for 1.0.0.2

Summary

JSON Pointer library for Haskell.

Hackage / GitHub / Travis CI

Example

{-# LANGUAGE OverloadedStrings #-}

module Example where

import           Control.Monad      (unless)
import           Data.Aeson
import qualified Data.Aeson.Pointer as P

main :: IO ()
main = do
    -- JSON Pointers must either be empty or start with a /.
    pntr1 <- case P.unescape "/foo/0" of
                 Left _     -> error "Failed to construct JSON Pointer."
                 Right pntr -> return pntr

    -- We can also write JSON Pointers in Haskell.
    let pntr2 = P.Pointer [P.Token "/"]
    -- When we do this we don't have to escape / or ~ characters
    -- (as ~1 and ~0 respectively) like we do in an escaped JSON
    -- Pointer string.
    unless (P.unescape "/~1" == Right pntr2) (error "ohno!")

    print (P.resolve pntr1 document)
    print (P.resolve pntr2 document)

  where
    document :: Value
    document = object [ "foo" .= [String "bar", String "baz"]
                      , "/"   .= String "quux"
                      ]

Output:

Right (String "bar")
Right (String "quux")

Changes

1.0.0.2

  • Bump hspec.

1.0.0.1

  • Remove HUnit dep.

1.0.0.0

  • Bump aeson.

0.3.0.2

  • Switch to hspec for tests.

0.3.0.1

  • Enable GHC 8.

0.3.0.0

  • Rewrite.

0.2

  • Fix mistake in resolveRefTok.
  • Split errors over two types.
  • Switch the order of pointer and value arguments for functions that take both. The pointer now comes first.

0.1

  • Initial implementation.