-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Extract and apply patches to JSON documents.
--   
--   This is a small library for working with changes to JSON documents. It
--   includes a library and two command-line executables in the style of
--   the diff(1) and patch(1) commands available on many systems.
@package aeson-diff
@version 1.0.0.1


module Data.Aeson.Pointer

-- | Pointer to a location in a JSON document.
--   
--   Defined in RFC 6901 <a>http://tools.ietf.org/html/rfc6901</a>
newtype Pointer
Pointer :: Path -> Pointer
[pointerPath] :: Pointer -> Path

-- | Traverse a single layer of a JSON document.
data Key

-- | Traverse a <a>Value</a> with an <a>Object</a> constructor.
OKey :: Text -> Key

-- | Traverse a <a>Value</a> with an <a>Array</a> constructor.
AKey :: Int -> Key

-- | Report an error following a pointer.
pointerFailure :: Path -> Value -> Result a

-- | A sequence of <a>Key</a>s forms a path through a JSON document.
type Path = [Key]

-- | Format a <a>Pointer</a> as described in RFC 6901.
formatPointer :: Pointer -> Text

-- | Get the value at a <a>Path</a>.
get :: Pointer -> Value -> Result Value
instance GHC.Base.Monoid Data.Aeson.Pointer.Pointer
instance GHC.Show.Show Data.Aeson.Pointer.Pointer
instance GHC.Classes.Eq Data.Aeson.Pointer.Pointer
instance GHC.Show.Show Data.Aeson.Pointer.Key
instance GHC.Classes.Ord Data.Aeson.Pointer.Key
instance GHC.Classes.Eq Data.Aeson.Pointer.Key
instance Data.Aeson.Types.Class.ToJSON Data.Aeson.Pointer.Key
instance Data.Aeson.Types.Class.FromJSON Data.Aeson.Pointer.Key
instance Data.Aeson.Types.Class.ToJSON Data.Aeson.Pointer.Pointer
instance Data.Aeson.Types.Class.FromJSON Data.Aeson.Pointer.Pointer


module Data.Aeson.Patch

-- | Describes the changes between two JSON documents.
newtype Patch
Patch :: [Operation] -> Patch
[patchOperations] :: Patch -> [Operation]

-- | An <a>Operation</a> describes the operations which can appear as part
--   of a JSON Patch.
--   
--   See RFC 6902 Section 4
--   <a>http://tools.ietf.org/html/rfc6902#section-4</a>.
data Operation

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.1</a>
Add :: Pointer -> Value -> Operation
[changePointer] :: Operation -> Pointer
[changeValue] :: Operation -> Value

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.2</a>
Rem :: Pointer -> Operation
[changePointer] :: Operation -> Pointer

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.3</a>
Rep :: Pointer -> Value -> Operation
[changePointer] :: Operation -> Pointer
[changeValue] :: Operation -> Value

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.4</a>
Mov :: Pointer -> Pointer -> Operation
[changePointer] :: Operation -> Pointer
[fromPointer] :: Operation -> Pointer

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.5</a>
Cpy :: Pointer -> Pointer -> Operation
[changePointer] :: Operation -> Pointer
[fromPointer] :: Operation -> Pointer

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.6</a>
Tst :: Pointer -> Value -> Operation
[changePointer] :: Operation -> Pointer
[changeValue] :: Operation -> Value
instance GHC.Base.Monoid Data.Aeson.Patch.Patch
instance GHC.Show.Show Data.Aeson.Patch.Patch
instance GHC.Classes.Eq Data.Aeson.Patch.Patch
instance GHC.Show.Show Data.Aeson.Patch.Operation
instance GHC.Classes.Eq Data.Aeson.Patch.Operation
instance Data.Aeson.Types.Class.ToJSON Data.Aeson.Patch.Patch
instance Data.Aeson.Types.Class.FromJSON Data.Aeson.Patch.Patch
instance Data.Aeson.Types.Class.ToJSON Data.Aeson.Patch.Operation
instance Data.Aeson.Types.Class.FromJSON Data.Aeson.Patch.Operation


-- | This module implements data types and operations to represent the
--   differences between JSON documents (i.e. a patch), to compare JSON
--   documents and extract such a patch, and to apply such a patch to a
--   JSON document.
module Data.Aeson.Diff

-- | Describes the changes between two JSON documents.
newtype Patch
Patch :: [Operation] -> Patch
[patchOperations] :: Patch -> [Operation]

-- | Pointer to a location in a JSON document.
--   
--   Defined in RFC 6901 <a>http://tools.ietf.org/html/rfc6901</a>
data Pointer

-- | Traverse a single layer of a JSON document.
data Key

-- | Traverse a <a>Value</a> with an <a>Object</a> constructor.
OKey :: Text -> Key

-- | Traverse a <a>Value</a> with an <a>Array</a> constructor.
AKey :: Int -> Key

-- | An <a>Operation</a> describes the operations which can appear as part
--   of a JSON Patch.
--   
--   See RFC 6902 Section 4
--   <a>http://tools.ietf.org/html/rfc6902#section-4</a>.
data Operation

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.1</a>
Add :: Pointer -> Value -> Operation
[changePointer] :: Operation -> Pointer
[changeValue] :: Operation -> Value

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.2</a>
Rem :: Pointer -> Operation
[changePointer] :: Operation -> Pointer

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.3</a>
Rep :: Pointer -> Value -> Operation
[changePointer] :: Operation -> Pointer
[changeValue] :: Operation -> Value

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.4</a>
Mov :: Pointer -> Pointer -> Operation
[changePointer] :: Operation -> Pointer
[fromPointer] :: Operation -> Pointer

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.5</a>
Cpy :: Pointer -> Pointer -> Operation
[changePointer] :: Operation -> Pointer
[fromPointer] :: Operation -> Pointer

-- | <a>http://tools.ietf.org/html/rfc6902#section-4.6</a>
Tst :: Pointer -> Value -> Operation
[changePointer] :: Operation -> Pointer
[changeValue] :: Operation -> Value

-- | Compare two JSON documents and generate a patch describing the
--   differences.
diff :: Value -> Value -> Patch

-- | Apply a patch to a JSON document.
patch :: Patch -> Value -> Result Value

-- | Apply an <a>Operation</a> to a <a>Value</a>.
applyOperation :: Operation -> Value -> Result Value