git-annex/Utility/Aeson.hs

127 lines
3.5 KiB
Haskell
Raw Normal View History

{- GHC File system encoding support for Aeson.
-
- Import instead of Data.Aeson
-
- Copyright 2018-2023 Joey Hess <id@joeyh.name>
-
- License: BSD-2-clause
-}
{-# LANGUAGE FlexibleInstances, TypeSynonymInstances, CPP #-}
module Utility.Aeson (
module X,
ToJSON'(..),
encode,
packString,
2019-01-07 16:29:25 +00:00
packByteString,
2022-03-02 22:24:06 +00:00
textKey,
) where
2022-03-07 17:29:24 +00:00
#if MIN_VERSION_aeson(2,0,0)
import Data.Aeson as X hiding (ToJSON, toJSON, encode, Key)
2022-03-07 17:29:24 +00:00
#else
import Data.Aeson as X hiding (ToJSON, toJSON, encode)
#endif
import Data.Aeson hiding (encode)
import qualified Data.Aeson
2022-03-02 22:24:06 +00:00
#if MIN_VERSION_aeson(2,0,0)
import qualified Data.Aeson.Key as AK
#endif
import qualified Data.Text as T
import qualified Data.Text.Encoding as T
import qualified Data.ByteString.Lazy as L
2019-01-07 16:29:25 +00:00
import qualified Data.ByteString as S
import qualified Data.Set
import qualified Data.Map
import qualified Data.Vector
import Prelude
import Utility.FileSystemEncoding
-- | Use this instead of Data.Aeson.encode to make sure that the
-- below String instance is used.
encode :: ToJSON' a => a -> L.ByteString
encode = Data.Aeson.encode . toJSON'
-- | Aeson has an unfortunate ToJSON instance for Char and [Char]
-- which does not support Strings containing UTF8 characters
-- encoded using the filesystem encoding when run in a non-utf8 locale.
--
-- Since we can't replace that with a instance that does the right
-- thing, instead here's a new class that handles String right.
class ToJSON' a where
toJSON' :: a -> Value
instance ToJSON' T.Text where
toJSON' = toJSON
instance ToJSON' String where
toJSON' = toJSON . packString
2019-01-07 16:29:25 +00:00
-- | Aeson does not have a ToJSON instance for ByteString;
-- this one assumes that the ByteString contains text, and will
-- have the same effect as toJSON' . decodeBS, but with a more efficient
-- implementation.
instance ToJSON' S.ByteString where
toJSON' = toJSON . packByteString
-- | Pack a String to Text, correctly handling the filesystem encoding.
--
-- Use this instead of Data.Text.pack.
--
-- Note that if the string contains invalid UTF8 characters not using
-- the FileSystemEncoding, this is the same as Data.Text.pack.
packString :: String -> T.Text
packString s = case T.decodeUtf8' (encodeBS s) of
Right t -> t
Left _ -> T.pack s
2022-03-02 22:24:06 +00:00
#if MIN_VERSION_aeson(2,0,0)
textKey :: T.Text -> AK.Key
textKey = AK.fromText
#else
textKey :: T.Text -> T.Text
textKey = id
#endif
2019-01-07 16:29:25 +00:00
-- | The same as packString . decodeBS, but more efficient in the usual
-- case.
packByteString :: S.ByteString -> T.Text
packByteString b = case T.decodeUtf8' b of
Right t -> t
Left _ -> T.pack (decodeBS b)
-- | An instance for lists cannot be included as it would overlap with
-- the String instance. Instead, you can use a Vector.
instance ToJSON' s => ToJSON' (Data.Vector.Vector s) where
toJSON' = toJSON . map toJSON' . Data.Vector.toList
-- Aeson generates the same JSON for a Set as for a list.
instance ToJSON' s => ToJSON' (Data.Set.Set s) where
toJSON' = toJSON . map toJSON' . Data.Set.toList
instance (ToJSON' v) => ToJSON' (Data.Map.Map T.Text v) where
toJSON' m = object $ map go (Data.Map.toList m)
where
go (k, v) = (textKey k, toJSON' v)
instance (ToJSON' a, ToJSON a) => ToJSON' (Maybe a) where
toJSON' (Just a) = toJSON (Just (toJSON' a))
toJSON' v@Nothing = toJSON v
instance (ToJSON' a, ToJSON a, ToJSON' b, ToJSON b) => ToJSON' (a, b) where
toJSON' (a, b) = toJSON ((toJSON' a, toJSON' b))
instance ToJSON' Bool where
toJSON' = toJSON
instance ToJSON' Integer where
toJSON' = toJSON
instance ToJSON' Object where
toJSON' = toJSON
instance ToJSON' Value where
toJSON' = toJSON