{-
JSON instances. Should they be in Types.hs ?
-}

{-# LANGUAGE FlexibleInstances #-}
{-# LANGUAGE LambdaCase        #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards   #-}

module Hledger.Data.Json (
  -- * Instances
  -- * Utilities
   toJsonText
  ,writeJsonFile
  ,readJsonFile
) where

import           Data.Aeson
import           Data.Aeson.Encode.Pretty (Config(..), Indent(..), NumberFormat(..),
                     encodePretty', encodePrettyToTextBuilder')
--import           Data.Aeson.TH
import qualified Data.ByteString.Lazy as BL
import           Data.Decimal (DecimalRaw(..), roundTo)
import           Data.Maybe (fromMaybe)
import qualified Data.Text.Lazy    as TL
import qualified Data.Text.Lazy.Builder as TB
import           Text.Megaparsec (Pos, SourcePos, mkPos, unPos)

import           Hledger.Data.Types
import           Hledger.Data.Amount (amountsRaw, mixed)

-- To JSON

instance ToJSON Status
instance ToJSON SourcePos

-- Use the same encoding as the underlying Int
instance ToJSON Pos where
  toJSON :: Pos -> Value
toJSON = Int -> Value
forall a. ToJSON a => a -> Value
toJSON (Int -> Value) -> (Pos -> Int) -> Pos -> Value
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Pos -> Int
unPos
  toEncoding :: Pos -> Encoding
toEncoding = Int -> Encoding
forall a. ToJSON a => a -> Encoding
toEncoding (Int -> Encoding) -> (Pos -> Int) -> Pos -> Encoding
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Pos -> Int
unPos

-- https://github.com/simonmichael/hledger/issues/1195

-- The default JSON output for Decimal can contain 255-digit integers
-- (for repeating decimals caused by implicit transaction prices).
-- JSON output is intended to be consumed by diverse apps and
-- programming languages, which can't handle numbers like that.
-- From #1195:
--
-- > - JavaScript uses 64-bit IEEE754 numbers which can only accurately
-- >   represent integers up to 9007199254740991 (i.e. a maximum of 15 digits).
-- > - Java’s largest integers are limited to 18 digits.
-- > - Python 3 integers are unbounded.
-- > - Python 2 integers are limited to 18 digits like Java.
-- > - C and C++ number limits depend on platform — most platforms should
-- >   be able to represent unsigned integers up to 64 bits, i.e. 19 digits.
--
-- What is the best compromise for both accuracy and practicality ?
-- For now, we provide both the maximum precision representation
-- (decimalPlaces & decimalMantissa), and a floating point representation
-- with up to 10 decimal places (and an unbounded number of integer digits).
-- We hope the mere presence of the large number in JSON won't break things,
-- and that the overall number of significant digits in the floating point
-- remains manageable in practice. (I'm not sure how to limit the number
-- of significant digits in a Decimal right now.)
instance (Integral a, ToJSON a) => ToJSON (DecimalRaw a) where
  toJSON :: DecimalRaw a -> Value
toJSON = [Pair] -> Value
object ([Pair] -> Value)
-> (DecimalRaw a -> [Pair]) -> DecimalRaw a -> Value
forall b c a. (b -> c) -> (a -> b) -> a -> c
. DecimalRaw a -> [Pair]
forall kv a.
(KeyValue kv, Integral a, ToJSON a) =>
DecimalRaw a -> [kv]
decimalKV
  toEncoding :: DecimalRaw a -> Encoding
toEncoding = Series -> Encoding
pairs (Series -> Encoding)
-> (DecimalRaw a -> Series) -> DecimalRaw a -> Encoding
forall b c a. (b -> c) -> (a -> b) -> a -> c
. [Series] -> Series
forall a. Monoid a => [a] -> a
mconcat ([Series] -> Series)
-> (DecimalRaw a -> [Series]) -> DecimalRaw a -> Series
forall b c a. (b -> c) -> (a -> b) -> a -> c
. DecimalRaw a -> [Series]
forall kv a.
(KeyValue kv, Integral a, ToJSON a) =>
DecimalRaw a -> [kv]
decimalKV

decimalKV :: (KeyValue kv, Integral a, ToJSON a) => DecimalRaw a -> [kv]
decimalKV :: DecimalRaw a -> [kv]
decimalKV DecimalRaw a
d = let d' :: DecimalRaw a
d' = if DecimalRaw a -> Word8
forall i. DecimalRaw i -> Word8
decimalPlaces DecimalRaw a
d Word8 -> Word8 -> Bool
forall a. Ord a => a -> a -> Bool
<= Word8
10 then DecimalRaw a
d else Word8 -> DecimalRaw a -> DecimalRaw a
forall i. Integral i => Word8 -> DecimalRaw i -> DecimalRaw i
roundTo Word8
10 DecimalRaw a
d in
    [ Key
"decimalPlaces"   Key -> Word8 -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= DecimalRaw a -> Word8
forall i. DecimalRaw i -> Word8
decimalPlaces DecimalRaw a
d'
    , Key
"decimalMantissa" Key -> a -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= DecimalRaw a -> a
forall i. DecimalRaw i -> i
decimalMantissa DecimalRaw a
d'
    , Key
"floatingPoint"   Key -> Double -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= (DecimalRaw a -> Double
forall a b. (Real a, Fractional b) => a -> b
realToFrac DecimalRaw a
d' :: Double)
    ]

instance ToJSON Amount
instance ToJSON AmountStyle

-- Use the same JSON serialisation as Maybe Word8
instance ToJSON AmountPrecision where
  toJSON :: AmountPrecision -> Value
toJSON = Maybe Word8 -> Value
forall a. ToJSON a => a -> Value
toJSON (Maybe Word8 -> Value)
-> (AmountPrecision -> Maybe Word8) -> AmountPrecision -> Value
forall b c a. (b -> c) -> (a -> b) -> a -> c
. \case
    Precision Word8
n      -> Word8 -> Maybe Word8
forall a. a -> Maybe a
Just Word8
n
    AmountPrecision
NaturalPrecision -> Maybe Word8
forall a. Maybe a
Nothing
  toEncoding :: AmountPrecision -> Encoding
toEncoding = Maybe Word8 -> Encoding
forall a. ToJSON a => a -> Encoding
toEncoding (Maybe Word8 -> Encoding)
-> (AmountPrecision -> Maybe Word8) -> AmountPrecision -> Encoding
forall b c a. (b -> c) -> (a -> b) -> a -> c
. \case
    Precision Word8
n      -> Word8 -> Maybe Word8
forall a. a -> Maybe a
Just Word8
n
    AmountPrecision
NaturalPrecision -> Maybe Word8
forall a. Maybe a
Nothing

instance ToJSON Side
instance ToJSON DigitGroupStyle

instance ToJSON MixedAmount where
  toJSON :: MixedAmount -> Value
toJSON = [Amount] -> Value
forall a. ToJSON a => a -> Value
toJSON ([Amount] -> Value)
-> (MixedAmount -> [Amount]) -> MixedAmount -> Value
forall b c a. (b -> c) -> (a -> b) -> a -> c
. MixedAmount -> [Amount]
amountsRaw
  toEncoding :: MixedAmount -> Encoding
toEncoding = [Amount] -> Encoding
forall a. ToJSON a => a -> Encoding
toEncoding ([Amount] -> Encoding)
-> (MixedAmount -> [Amount]) -> MixedAmount -> Encoding
forall b c a. (b -> c) -> (a -> b) -> a -> c
. MixedAmount -> [Amount]
amountsRaw

instance ToJSON BalanceAssertion
instance ToJSON AmountPrice
instance ToJSON MarketPrice
instance ToJSON PostingType

instance ToJSON Posting where
  toJSON :: Posting -> Value
toJSON = [Pair] -> Value
object ([Pair] -> Value) -> (Posting -> [Pair]) -> Posting -> Value
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Posting -> [Pair]
forall kv. KeyValue kv => Posting -> [kv]
postingKV
  toEncoding :: Posting -> Encoding
toEncoding = Series -> Encoding
pairs (Series -> Encoding) -> (Posting -> Series) -> Posting -> Encoding
forall b c a. (b -> c) -> (a -> b) -> a -> c
. [Series] -> Series
forall a. Monoid a => [a] -> a
mconcat ([Series] -> Series) -> (Posting -> [Series]) -> Posting -> Series
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Posting -> [Series]
forall kv. KeyValue kv => Posting -> [kv]
postingKV

postingKV :: KeyValue kv => Posting -> [kv]
postingKV :: Posting -> [kv]
postingKV Posting{[Tag]
Maybe Day
Maybe Transaction
Maybe Posting
Maybe BalanceAssertion
Text
Status
PostingType
MixedAmount
poriginal :: Posting -> Maybe Posting
ptransaction :: Posting -> Maybe Transaction
pbalanceassertion :: Posting -> Maybe BalanceAssertion
ptags :: Posting -> [Tag]
ptype :: Posting -> PostingType
pcomment :: Posting -> Text
pamount :: Posting -> MixedAmount
paccount :: Posting -> Text
pstatus :: Posting -> Status
pdate2 :: Posting -> Maybe Day
pdate :: Posting -> Maybe Day
poriginal :: Maybe Posting
ptransaction :: Maybe Transaction
pbalanceassertion :: Maybe BalanceAssertion
ptags :: [Tag]
ptype :: PostingType
pcomment :: Text
pamount :: MixedAmount
paccount :: Text
pstatus :: Status
pdate2 :: Maybe Day
pdate :: Maybe Day
..} =
    [ Key
"pdate"             Key -> Maybe Day -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Maybe Day
pdate
    , Key
"pdate2"            Key -> Maybe Day -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Maybe Day
pdate2
    , Key
"pstatus"           Key -> Status -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Status
pstatus
    , Key
"paccount"          Key -> Text -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Text
paccount
    , Key
"pamount"           Key -> MixedAmount -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= MixedAmount
pamount
    , Key
"pcomment"          Key -> Text -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Text
pcomment
    , Key
"ptype"             Key -> PostingType -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= PostingType
ptype
    , Key
"ptags"             Key -> [Tag] -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= [Tag]
ptags
    , Key
"pbalanceassertion" Key -> Maybe BalanceAssertion -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Maybe BalanceAssertion
pbalanceassertion
    -- To avoid a cycle, show just the parent transaction's index number
    -- in a dummy field. When re-parsed, there will be no parent.
    , Key
"ptransaction_"     Key -> String -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= String -> (Transaction -> String) -> Maybe Transaction -> String
forall b a. b -> (a -> b) -> Maybe a -> b
maybe String
"" (Integer -> String
forall a. Show a => a -> String
show(Integer -> String)
-> (Transaction -> Integer) -> Transaction -> String
forall b c a. (b -> c) -> (a -> b) -> a -> c
.Transaction -> Integer
tindex) Maybe Transaction
ptransaction
    -- This is probably not wanted in json, we discard it.
    , Key
"poriginal"         Key -> Maybe Posting -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= (Maybe Posting
forall a. Maybe a
Nothing :: Maybe Posting)
    ]

instance ToJSON Transaction
instance ToJSON TransactionModifier
instance ToJSON TMPostingRule
instance ToJSON PeriodicTransaction
instance ToJSON PriceDirective
instance ToJSON DateSpan
instance ToJSON Interval
instance ToJSON Period
instance ToJSON AccountAlias
instance ToJSON AccountType
instance ToJSONKey AccountType
instance ToJSON AccountDeclarationInfo
instance ToJSON PayeeDeclarationInfo
instance ToJSON Commodity
instance ToJSON TimeclockCode
instance ToJSON TimeclockEntry
instance ToJSON Journal

instance ToJSON Account where
  toJSON :: Account -> Value
toJSON = [Pair] -> Value
object ([Pair] -> Value) -> (Account -> [Pair]) -> Account -> Value
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Account -> [Pair]
forall kv. KeyValue kv => Account -> [kv]
accountKV
  toEncoding :: Account -> Encoding
toEncoding = Series -> Encoding
pairs (Series -> Encoding) -> (Account -> Series) -> Account -> Encoding
forall b c a. (b -> c) -> (a -> b) -> a -> c
. [Series] -> Series
forall a. Monoid a => [a] -> a
mconcat ([Series] -> Series) -> (Account -> [Series]) -> Account -> Series
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Account -> [Series]
forall kv. KeyValue kv => Account -> [kv]
accountKV

accountKV :: KeyValue kv => Account -> [kv]
accountKV :: Account -> [kv]
accountKV Account
a =
    [ Key
"aname"        Key -> Text -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Account -> Text
aname Account
a
    , Key
"aebalance"    Key -> MixedAmount -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Account -> MixedAmount
aebalance Account
a
    , Key
"aibalance"    Key -> MixedAmount -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Account -> MixedAmount
aibalance Account
a
    , Key
"anumpostings" Key -> Int -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Account -> Int
anumpostings Account
a
    , Key
"aboring"      Key -> Bool -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Account -> Bool
aboring Account
a
    -- To avoid a cycle, show just the parent account's name
    -- in a dummy field. When re-parsed, there will be no parent.
    , Key
"aparent_"     Key -> Text -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= Text -> (Account -> Text) -> Maybe Account -> Text
forall b a. b -> (a -> b) -> Maybe a -> b
maybe Text
"" Account -> Text
aname (Account -> Maybe Account
aparent Account
a)
    -- Just the names of subaccounts, as a dummy field, ignored when parsed.
    , Key
"asubs_"       Key -> [Text] -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= (Account -> Text) -> [Account] -> [Text]
forall a b. (a -> b) -> [a] -> [b]
map Account -> Text
aname (Account -> [Account]
asubs Account
a)
    -- The actual subaccounts (and their subs..), making a (probably highly redundant) tree
    -- ,"asubs"        .= asubs a
    -- Omit the actual subaccounts
    , Key
"asubs"        Key -> [Account] -> kv
forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
.= ([]::[Account])
    ]

instance ToJSON Ledger

-- From JSON

instance FromJSON Status
instance FromJSON SourcePos
-- Use the same encoding as the underlying Int
instance FromJSON Pos where
  parseJSON :: Value -> Parser Pos
parseJSON = (Int -> Pos) -> Parser Int -> Parser Pos
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
fmap Int -> Pos
mkPos (Parser Int -> Parser Pos)
-> (Value -> Parser Int) -> Value -> Parser Pos
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Value -> Parser Int
forall a. FromJSON a => Value -> Parser a
parseJSON

instance FromJSON Amount
instance FromJSON AmountStyle

-- Use the same JSON serialisation as Maybe Word8
instance FromJSON AmountPrecision where
  parseJSON :: Value -> Parser AmountPrecision
parseJSON = (Maybe Word8 -> AmountPrecision)
-> Parser (Maybe Word8) -> Parser AmountPrecision
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
fmap (AmountPrecision
-> (Word8 -> AmountPrecision) -> Maybe Word8 -> AmountPrecision
forall b a. b -> (a -> b) -> Maybe a -> b
maybe AmountPrecision
NaturalPrecision Word8 -> AmountPrecision
Precision) (Parser (Maybe Word8) -> Parser AmountPrecision)
-> (Value -> Parser (Maybe Word8))
-> Value
-> Parser AmountPrecision
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Value -> Parser (Maybe Word8)
forall a. FromJSON a => Value -> Parser a
parseJSON

instance FromJSON Side
instance FromJSON DigitGroupStyle

instance FromJSON MixedAmount where
  parseJSON :: Value -> Parser MixedAmount
parseJSON = ([Amount] -> MixedAmount) -> Parser [Amount] -> Parser MixedAmount
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
fmap ([Amount] -> MixedAmount
forall (t :: * -> *). Foldable t => t Amount -> MixedAmount
mixed :: [Amount] -> MixedAmount) (Parser [Amount] -> Parser MixedAmount)
-> (Value -> Parser [Amount]) -> Value -> Parser MixedAmount
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Value -> Parser [Amount]
forall a. FromJSON a => Value -> Parser a
parseJSON

instance FromJSON BalanceAssertion
instance FromJSON AmountPrice
instance FromJSON MarketPrice
instance FromJSON PostingType
instance FromJSON Posting
instance FromJSON Transaction
instance FromJSON AccountDeclarationInfo
-- XXX The ToJSON instance replaces subaccounts with just names.
-- Here we should try to make use of those to reconstruct the
-- parent-child relationships.
instance FromJSON Account

-- Decimal, various attempts
--
-- https://stackoverflow.com/questions/40331851/haskell-data-decimal-as-aeson-type
----instance FromJSON Decimal where parseJSON =
----  A.withScientific "Decimal" (return . right . eitherFromRational . toRational)
--
-- https://github.com/bos/aeson/issues/474
-- http://hackage.haskell.org/package/aeson-1.4.2.0/docs/Data-Aeson-TH.html
-- $(deriveFromJSON defaultOptions ''Decimal) -- doesn't work
-- $(deriveFromJSON defaultOptions ''DecimalRaw)  -- works; requires TH, but gives better parse error messages
--
-- https://github.com/PaulJohnson/Haskell-Decimal/issues/6
instance FromJSON (DecimalRaw Integer)
--
-- @simonmichael, I think the code in your first comment should work if it compiles—though “work” doesn’t mean you can parse a JSON number directly into a `Decimal` using the generic instance, as you’ve discovered.
--
--Error messages with these extensions are always rather cryptic, but I’d prefer them to Template Haskell. Typically you’ll want to start by getting a generic `ToJSON` instance working, then use that to figure out what the `FromJSON` instance expects to parse: for a correct instance, `encode` and `decode` should give you an isomorphism between your type and a subset of `Bytestring` (up to the `Maybe` wrapper that `decode` returns).
--
--I don’t have time to test it right now, but I think it will also work without `DeriveAnyClass`, just using `DeriveGeneric` and `StandAloneDeriving`. It should also work to use the [`genericParseJSON`](http://hackage.haskell.org/package/aeson/docs/Data-Aeson.html#v:genericParseJSON) function to implement the class explicitly, something like this:
--
--{-# LANGUAGE DeriveGeneric #-}
--{-# LANGUAGE StandAloneDeriving #-}
--import GHC.Generics
--import Data.Aeson
--deriving instance Generic Decimal
--instance FromJSON Decimal where
--  parseJSON = genericParseJSON defaultOptions
--
--And of course you can avoid `StandAloneDeriving` entirely if you’re willing to wrap `Decimal` in your own `newtype`.

-- XXX these will allow reading a Journal, but currently the
-- jdeclaredaccounttypes Map gets serialised as a JSON list, which
-- can't be read back.
--
-- instance FromJSON AccountAlias
-- instance FromJSONKey AccountType where fromJSONKey = genericFromJSONKey defaultJSONKeyOptions
-- instance FromJSON AccountType
-- instance FromJSON ClockTime
-- instance FromJSON Commodity
-- instance FromJSON DateSpan
-- instance FromJSON Interval
-- instance FromJSON Period
-- instance FromJSON PeriodicTransaction
-- instance FromJSON PriceDirective
-- instance FromJSON TimeclockCode
-- instance FromJSON TimeclockEntry
-- instance FromJSON TransactionModifier
-- instance FromJSON Journal


-- Utilities

-- | Config for pretty printing JSON output.
jsonConf :: Config
jsonConf :: Config
jsonConf = Config :: Indent
-> (Text -> Text -> Ordering) -> NumberFormat -> Bool -> Config
Config{confIndent :: Indent
confIndent=Int -> Indent
Spaces Int
2, confCompare :: Text -> Text -> Ordering
confCompare=Text -> Text -> Ordering
forall a. Ord a => a -> a -> Ordering
compare, confNumFormat :: NumberFormat
confNumFormat=NumberFormat
Generic, confTrailingNewline :: Bool
confTrailingNewline=Bool
True}

-- | Show a JSON-convertible haskell value as pretty-printed JSON text.
toJsonText :: ToJSON a => a -> TL.Text
toJsonText :: a -> Text
toJsonText = Builder -> Text
TB.toLazyText (Builder -> Text) -> (a -> Builder) -> a -> Text
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Config -> a -> Builder
forall a. ToJSON a => Config -> a -> Builder
encodePrettyToTextBuilder' Config
jsonConf

-- | Write a JSON-convertible haskell value to a pretty-printed JSON file.
-- Eg: writeJsonFile "a.json" nulltransaction
writeJsonFile :: ToJSON a => FilePath -> a -> IO ()
writeJsonFile :: String -> a -> IO ()
writeJsonFile String
f = String -> ByteString -> IO ()
BL.writeFile String
f (ByteString -> IO ()) -> (a -> ByteString) -> a -> IO ()
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Config -> a -> ByteString
forall a. ToJSON a => Config -> a -> ByteString
encodePretty' Config
jsonConf

-- | Read a JSON file and decode it to the target type, or raise an error if we can't.
-- Eg: readJsonFile "a.json" :: IO Transaction
readJsonFile :: FromJSON a => FilePath -> IO a
readJsonFile :: String -> IO a
readJsonFile String
f = do
  ByteString
bl <- String -> IO ByteString
BL.readFile String
f
  -- PARTIAL:
  let v :: Value
v = Value -> Maybe Value -> Value
forall a. a -> Maybe a -> a
fromMaybe (String -> Value
forall a. HasCallStack => String -> a
error (String -> Value) -> String -> Value
forall a b. (a -> b) -> a -> b
$ String
"could not decode JSON in "String -> String -> String
forall a. [a] -> [a] -> [a]
++String -> String
forall a. Show a => a -> String
show String
fString -> String -> String
forall a. [a] -> [a] -> [a]
++String
" to target value")
          (ByteString -> Maybe Value
forall a. FromJSON a => ByteString -> Maybe a
decode ByteString
bl :: Maybe Value)
  case Value -> Result a
forall a. FromJSON a => Value -> Result a
fromJSON Value
v :: FromJSON a => Result a of
    Error String
e   -> String -> IO a
forall a. HasCallStack => String -> a
error String
e
    Success a
t -> a -> IO a
forall (m :: * -> *) a. Monad m => a -> m a
return a
t