{-# LANGUAGE AllowAmbiguousTypes    #-}
{-# LANGUAGE ConstraintKinds        #-}
{-# LANGUAGE DefaultSignatures      #-}
{-# LANGUAGE FlexibleInstances      #-}
{-# LANGUAGE FunctionalDependencies #-}
{-# LANGUAGE GADTs                  #-}
{-# LANGUAGE KindSignatures         #-}
{-# LANGUAGE LambdaCase             #-}
{-# LANGUAGE MultiParamTypeClasses  #-}
{-# LANGUAGE PatternSynonyms        #-}
{-# LANGUAGE RankNTypes             #-}
{-# LANGUAGE ScopedTypeVariables    #-}
{-# LANGUAGE TypeApplications       #-}
{-# LANGUAGE TypeFamilies           #-}
{-# LANGUAGE TypeInType             #-}
{-# LANGUAGE TypeOperators          #-}
{-# LANGUAGE UndecidableInstances   #-}
{-# OPTIONS_HADDOCK not-home        #-}

-- |
-- Module      : GHC.TypeLits.Printf.Internal
-- Copyright   : (c) Justin Le 2019
-- License     : BSD3
--
-- Maintainer  : justin@jle.im
-- Stability   : experimental
-- Portability : non-portable
--
-- Internal workings of the printf mechanisms, exposed for potential
-- debugging purposes.
--
-- Please do not use this module for anything besides debugging, as is
-- definitely very unstable and might go away or change dramatically
-- between versions.

module GHC.TypeLits.Printf.Internal (
    ParseFmtStr
  , ParseFmtStr_
  , ParseFmt
  , ParseFmt_
  , FormatAdjustment(..)
  , ShowFormat
  , FormatSign(..)
  , WidthMod(..)
  , Flags(..)
  , EmptyFlags
  , FieldFormat(..)
  , SChar
  , Demote
  , Reflect(..)
  , FormatType(..)
  , Printf(..)
  , FormatFun(..)
  , PFmt(..)
  , pfmt
  , mkPFmt, mkPFmt_
  , PHelp(..)
  ) where

import           Data.Int
import           Data.Proxy
import           Data.Symbol.Utils
import           Data.Word
import           GHC.OverloadedLabels
import           GHC.TypeLits
import           GHC.TypeLits.Printf.Parse
import           Numeric.Natural
import qualified Data.Text                 as T
import qualified Data.Text.Lazy            as TL
import qualified Text.Printf               as P

-- | Typeclass associating format types (@d@, @f@, etc.) with the types
-- that can be formatted by them.
--
-- You can extend the printf methods here for your own types by writing
-- your instances here.
class FormatType (t :: SChar) a where
    formatArg :: p t -> a -> P.FieldFormat -> ShowS

    default formatArg :: P.PrintfArg a => p t -> a -> P.FieldFormat -> ShowS
    formatArg _ = a -> FieldFormat -> ShowS
forall a. PrintfArg a => a -> FieldFormat -> ShowS
P.formatArg

instance FormatType "c" Char
instance FormatType "c" Word8
instance FormatType "c" Word16

instance FormatType "d" Char
instance FormatType "d" Int
instance FormatType "d" Int8
instance FormatType "d" Int16
instance FormatType "d" Int32
instance FormatType "d" Int64
instance FormatType "d" Integer
instance FormatType "d" Natural
instance FormatType "d" Word
instance FormatType "d" Word8
instance FormatType "d" Word16
instance FormatType "d" Word32
instance FormatType "d" Word64

instance FormatType "o" Char
instance FormatType "o" Int
instance FormatType "o" Int8
instance FormatType "o" Int16
instance FormatType "o" Int32
instance FormatType "o" Int64
instance FormatType "o" Integer
instance FormatType "o" Natural
instance FormatType "o" Word
instance FormatType "o" Word8
instance FormatType "o" Word16
instance FormatType "o" Word32
instance FormatType "o" Word64

instance FormatType "x" Int
instance FormatType "x" Int8
instance FormatType "x" Int16
instance FormatType "x" Int32
instance FormatType "x" Int64
instance FormatType "x" Integer
instance FormatType "x" Natural
instance FormatType "x" Word
instance FormatType "x" Word8
instance FormatType "x" Word16
instance FormatType "x" Word32
instance FormatType "x" Word64

instance FormatType "X" Char
instance FormatType "X" Int
instance FormatType "X" Int8
instance FormatType "X" Int16
instance FormatType "X" Int32
instance FormatType "X" Int64
instance FormatType "X" Integer
instance FormatType "X" Natural
instance FormatType "X" Word
instance FormatType "X" Word8
instance FormatType "X" Word16
instance FormatType "X" Word32
instance FormatType "X" Word64

instance FormatType "b" Char
instance FormatType "b" Int
instance FormatType "b" Int8
instance FormatType "b" Int16
instance FormatType "b" Int32
instance FormatType "b" Int64
instance FormatType "b" Integer
instance FormatType "b" Natural
instance FormatType "b" Word
instance FormatType "b" Word8
instance FormatType "b" Word16
instance FormatType "b" Word32
instance FormatType "b" Word64

instance FormatType "u" Char
instance FormatType "u" Int
instance FormatType "u" Int8
instance FormatType "u" Int16
instance FormatType "u" Int32
instance FormatType "u" Int64
instance FormatType "u" Integer
instance FormatType "u" Natural
instance FormatType "u" Word
instance FormatType "u" Word8
instance FormatType "u" Word16
instance FormatType "u" Word32
instance FormatType "u" Word64

instance FormatType "f" Double
instance FormatType "f" Float

instance FormatType "F" Double
instance FormatType "F" Float

instance FormatType "g" Double
instance FormatType "g" Float

instance FormatType "G" Double
instance FormatType "G" Float

instance FormatType "e" Double
instance FormatType "e" Float

instance FormatType "E" Double
instance FormatType "E" Float

instance FormatType "s" String
instance FormatType "s" T.Text where
    formatArg :: p "s" -> Text -> FieldFormat -> ShowS
formatArg _ = String -> FieldFormat -> ShowS
forall a. PrintfArg a => a -> FieldFormat -> ShowS
P.formatArg (String -> FieldFormat -> ShowS)
-> (Text -> String) -> Text -> FieldFormat -> ShowS
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Text -> String
T.unpack
instance FormatType "s" TL.Text where
    formatArg :: p "s" -> Text -> FieldFormat -> ShowS
formatArg _ = String -> FieldFormat -> ShowS
forall a. PrintfArg a => a -> FieldFormat -> ShowS
P.formatArg (String -> FieldFormat -> ShowS)
-> (Text -> String) -> Text -> FieldFormat -> ShowS
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Text -> String
TL.unpack

-- | Treats as @c@
instance FormatType "v" Char
-- | Treats as @d@
instance FormatType "v" Int
-- | Treats as @d@
instance FormatType "v" Int8
-- | Treats as @d@
instance FormatType "v" Int16
-- | Treats as @d@
instance FormatType "v" Int32
-- | Treats as @d@
instance FormatType "v" Int64
-- | Treats as @d@
instance FormatType "v" Integer
-- | Treats as @u@
instance FormatType "v" Natural
-- | Treats as @u@
instance FormatType "v" Word
-- | Treats as @u@
instance FormatType "v" Word8
-- | Treats as @u@
instance FormatType "v" Word16
-- | Treats as @u@
instance FormatType "v" Word32
-- | Treats as @u@
instance FormatType "v" Word64
-- | Treats as @g@
instance FormatType "v" Double
-- | Treats as @g@
instance FormatType "v" Float
-- | Treats as @s@
instance FormatType "v" String
-- | Treats as @s@
instance FormatType "v" T.Text where
    formatArg :: p "v" -> Text -> FieldFormat -> ShowS
formatArg _ = String -> FieldFormat -> ShowS
forall a. PrintfArg a => a -> FieldFormat -> ShowS
P.formatArg (String -> FieldFormat -> ShowS)
-> (Text -> String) -> Text -> FieldFormat -> ShowS
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Text -> String
T.unpack
-- | Treats as @s@
instance FormatType "v" TL.Text where
    formatArg :: p "v" -> Text -> FieldFormat -> ShowS
formatArg _ = String -> FieldFormat -> ShowS
forall a. PrintfArg a => a -> FieldFormat -> ShowS
P.formatArg (String -> FieldFormat -> ShowS)
-> (Text -> String) -> Text -> FieldFormat -> ShowS
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Text -> String
TL.unpack

-- | The typeclass supporting polyarity used by
-- 'GHC.TypeLits.Printf.printf'. It works in mostly the same way as
-- 'P.PrintfType' from "Text.Printf", and similar the same as
-- 'Data.Symbol.Examples.Printf.FormatF'.  Ideally, you will never have to
-- run into this typeclass or have to deal with it directly.
--
-- Every item in the first argument of 'FormatFun' is a chunk of the
-- formatting string, split between format holes ('Right') and string
-- chunks ('Left').
--
-- If you want to see some useful error messages for feedback, 'pHelp' can
-- be useful:
--
-- >>> pHelp $ printf @"You have %.2f dollars, %s" 3.62
-- -- ERROR: Call to printf missing argument fulfilling "%s"
-- -- Either provide an argument or rewrite the format string to not expect
-- -- one.
class FormatFun (ffs :: [Either Symbol FieldFormat]) fun where
    formatFun :: p ffs -> String -> fun

-- | A useful tool for helping the type system give useful errors for
-- 'GHC.TypeLits.Printf.printf':
--
-- >>> printf @"You have ".2f" dollars, %s" 3.26 :: PHelp
-- -- ERROR: Call to printf missing argument fulfilling "%s"
-- -- Either provide an argument or rewrite the format string to not expect
-- -- one.
--
-- Mostly useful if you want to force a useful type error to help see what
-- is going on.
--
-- See also 'pHelp'
newtype PHelp = PHelp {
    -- | A useful helper function for helping the type system give useful
    -- errors for 'printf':
    --
    -- >>> pHelp $ printf @"You have %.2f dollars, %s" 3.62
    -- -- ERROR: Call to printf missing argument fulfilling "%s"
    -- -- Either provide an argument or rewrite the format string to not expect
    -- -- one.
    --
    -- Mostly useful if you want to force a useful type error to help see
    -- what is going on.
    PHelp -> String
pHelp :: String
  }

instance {-# INCOHERENT #-} (a ~ String) => FormatFun '[] a where
    formatFun :: p '[] -> String -> a
formatFun _ = String -> a
forall a. a -> a
id
instance (a ~ Char) => FormatFun '[] PHelp where
    formatFun :: p '[] -> String -> PHelp
formatFun _ = String -> PHelp
PHelp
instance (a ~ Char) => FormatFun '[] T.Text where
    formatFun :: p '[] -> String -> Text
formatFun _ = String -> Text
T.pack
instance (a ~ Char) => FormatFun '[] TL.Text where
    formatFun :: p '[] -> String -> Text
formatFun _ = String -> Text
TL.pack
instance (a ~ ()) => FormatFun '[] (IO a) where
    formatFun :: p '[] -> String -> IO a
formatFun _ = String -> IO a
String -> IO ()
putStr

instance TypeError ( 'Text "Result type of a call to printf not sufficiently inferred."
               ':$$: 'Text "Please provide an explicit type annotation or other way to help inference."
                   )
      => FormatFun '[] () where
    formatFun :: p '[] -> String -> ()
formatFun _ = String -> ()
forall a. HasCallStack => String -> a
error

instance TypeError ( 'Text "An extra argument of type "
               ':<>: 'ShowType a
               ':<>: 'Text " was given to a call to printf."
               ':$$: 'Text "Either remove the argument, or rewrite the format string to include the appropriate hole"
                   )
      => FormatFun '[] (a -> b) where
    formatFun :: p '[] -> String -> a -> b
formatFun _ = String -> a -> b
forall a. HasCallStack => String -> a
error

instance (KnownSymbol str, FormatFun ffs fun) => FormatFun ('Left str ': ffs) fun where
    formatFun :: p ('Left str : ffs) -> String -> fun
formatFun _ str :: String
str = Proxy ffs -> String -> fun
forall (ffs :: [Either SChar FieldFormat]) fun
       (p :: [Either SChar FieldFormat] -> *).
FormatFun ffs fun =>
p ffs -> String -> fun
formatFun (Proxy ffs
forall k (t :: k). Proxy t
Proxy @ffs) (String
str String -> ShowS
forall a. [a] -> [a] -> [a]
++ Proxy str -> String
forall (n :: SChar) (proxy :: SChar -> *).
KnownSymbol n =>
proxy n -> String
symbolVal (Proxy str
forall k (t :: k). Proxy t
Proxy @str))

instance {-# INCOHERENT #-} (afun ~ (arg -> fun), Reflect ff, ff ~ 'FF f w p m c, FormatType c arg, FormatFun ffs fun) => FormatFun ('Right ff ': ffs) afun where
    formatFun :: p ('Right ff : ffs) -> String -> afun
formatFun _ str :: String
str x :: arg
x = Proxy ffs -> String -> fun
forall (ffs :: [Either SChar FieldFormat]) fun
       (p :: [Either SChar FieldFormat] -> *).
FormatFun ffs fun =>
p ffs -> String -> fun
formatFun (Proxy ffs
forall k (t :: k). Proxy t
Proxy @ffs) (String
str String -> ShowS
forall a. [a] -> [a] -> [a]
++ Proxy c -> arg -> FieldFormat -> ShowS
forall (t :: SChar) a (p :: SChar -> *).
FormatType t a =>
p t -> a -> FieldFormat -> ShowS
formatArg (Proxy c
forall k (t :: k). Proxy t
Proxy @c) arg
x FieldFormat
Demote FieldFormat
ff "")
      where
        ff :: Demote FieldFormat
ff = Proxy ff -> Demote FieldFormat
forall a (x :: a) (p :: a -> *). Reflect x => p x -> Demote a
reflect (Proxy ff
forall k (t :: k). Proxy t
Proxy @ff)

type family MissingError ff where
    MissingError ff = 'Text "Call to printf missing an argument fulfilling \"%"
                ':<>: 'Text (ShowFormat ff)
                ':<>: 'Text "\""
                ':$$: 'Text "Either provide an argument or rewrite the format string to not expect one."

instance TypeError (MissingError ff) => FormatFun ('Right ff ': ffs) String where
    formatFun :: p ('Right ff : ffs) -> ShowS
formatFun _ = ShowS
forall a. HasCallStack => String -> a
error
instance TypeError (MissingError ff) => FormatFun ('Right ff ': ffs) () where
    formatFun :: p ('Right ff : ffs) -> String -> ()
formatFun _ = String -> ()
forall a. HasCallStack => String -> a
error
instance TypeError (MissingError ff) => FormatFun ('Right ff ': ffs) T.Text where
    formatFun :: p ('Right ff : ffs) -> String -> Text
formatFun _ = String -> Text
forall a. HasCallStack => String -> a
error
instance TypeError (MissingError ff) => FormatFun ('Right ff ': ffs) TL.Text where
    formatFun :: p ('Right ff : ffs) -> String -> Text
formatFun _ = String -> Text
forall a. HasCallStack => String -> a
error
instance TypeError (MissingError ff) => FormatFun ('Right ff ': ffs) PHelp where
    formatFun :: p ('Right ff : ffs) -> String -> PHelp
formatFun _ = String -> PHelp
forall a. HasCallStack => String -> a
error
instance TypeError (MissingError ff) => FormatFun ('Right ff ': ffs) (IO a) where
    formatFun :: p ('Right ff : ffs) -> String -> IO a
formatFun _ = String -> IO a
forall a. HasCallStack => String -> a
error

class Printf (str :: Symbol) fun where
    -- | A version of 'GHC.TypeLits.Printf.printf' taking an explicit
    -- proxy, which allows usage without /TypeApplications/
    --
    -- >>> putStrLn $ printf_ (Proxy :: Proxy "You have %.2f dollars, %s") 3.62 "Luigi"
    -- You have 3.62 dollars, Luigi
    printf_ :: p str -> fun

instance (Listify str lst, ffs ~ ParseFmtStr_ lst, FormatFun ffs fun) => Printf str fun where
    printf_ :: p str -> fun
printf_ _ = Proxy ffs -> String -> fun
forall (ffs :: [Either SChar FieldFormat]) fun
       (p :: [Either SChar FieldFormat] -> *).
FormatFun ffs fun =>
p ffs -> String -> fun
formatFun (Proxy ffs
forall k (t :: k). Proxy t
Proxy @ffs) ""

-- | Utility type powering 'pfmt'.  See documentation for 'pfmt' for more
-- information on usage.
--
-- Using /OverloadedLabels/, you never need to construct this directly
-- can just write @#f@ and a @'PFmt' "f"@ will be generated.  You can also
-- create this using 'mkPFmt' or 'mkPFmt_', in the situations where
-- /OverloadedLabels/ doesn't work or is not wanted.
newtype PFmt c = PFmt P.FieldFormat

-- | A version of 'mkPFmt' that takes an explicit proxy input.
--
-- >>> pfmt (mkPFmt_ (Proxy :: Proxy ".2f")) 3.6234124
-- "3.62"
mkPFmt_
    :: forall str lst ff f w q m c p. (Listify str lst, ff ~ ParseFmt_ lst, Reflect ff, ff ~ 'FF f w q m c)
    => p str
    -> PFmt c
mkPFmt_ :: p str -> PFmt c
mkPFmt_ _ = FieldFormat -> PFmt c
forall k (c :: k). FieldFormat -> PFmt c
PFmt FieldFormat
Demote FieldFormat
ff
  where
    ff :: Demote FieldFormat
ff = Proxy ff -> Demote FieldFormat
forall a (x :: a) (p :: a -> *). Reflect x => p x -> Demote a
reflect (Proxy ff
forall k (t :: k). Proxy t
Proxy @ff)

-- | Useful for using 'pfmt' without /OverloadedLabels/, or also when
-- passing format specifiers that aren't currently allowed with
-- /OverloadedLabels/ until GHC 8.10+ (like @#.2f@).
--
-- >>> pfmt (mkPFmt @".2f") 3.6234124
-- "3.62"
mkPFmt
    :: forall str lst ff f w q m c. (Listify str lst, ff ~ ParseFmt_ lst, Reflect ff, ff ~ 'FF f w q m c)
    => PFmt c
mkPFmt :: PFmt c
mkPFmt = Proxy str -> PFmt c
forall (str :: SChar) (lst :: [SChar]) (ff :: FieldFormat)
       (f :: Flags) (w :: Maybe Nat) (q :: Maybe Nat)
       (m :: Maybe WidthMod) (c :: SChar) (p :: SChar -> *).
(Listify str lst, ff ~ ParseFmt_ lst, Reflect ff,
 ff ~ 'FF f w q m c) =>
p str -> PFmt c
mkPFmt_ @str @lst (Proxy str
forall k (t :: k). Proxy t
Proxy @str)

instance (Listify str lst, ff ~ ParseFmt_ lst, Reflect ff, ff ~ 'FF f w p m c) => IsLabel str (PFmt c) where
    fromLabel :: PFmt c
fromLabel = forall (str :: SChar) (lst :: [SChar]) (ff :: FieldFormat)
       (f :: Flags) (w :: Maybe Nat) (p :: Maybe Nat)
       (m :: Maybe WidthMod) (c :: SChar).
(Listify str lst, ff ~ ParseFmt_ lst, Reflect ff,
 ff ~ 'FF f w p m c) =>
PFmt c
forall (ff :: FieldFormat) (f :: Flags) (w :: Maybe Nat)
       (p :: Maybe Nat) (m :: Maybe WidthMod) (c :: SChar).
(Listify str lst, ff ~ ParseFmt_ lst, Reflect ff,
 ff ~ 'FF f w p m c) =>
PFmt c
mkPFmt @str @lst

-- | Parse and run a /single/ format hole on a single vale.  Can be useful
-- for formatting individual items or for testing your own custom instances of
-- 'FormatType'.
--
-- Usually meant to be used with /OverloadedLabels/:
--
-- >>> pfmt #f 3.62
-- "3.62"
--
-- However, current versions of GHC disallow labels that aren't valid
-- identifier names, disallowing things like @'pfmt' #.2f 3.62@.  While
-- there is an
-- <https://github.com/ghc-proposals/ghc-proposals/blob/master/proposals/0170-unrestricted-overloadedlabels.rst
-- approved proposal> that allows this, if you are using an earlier GHC
-- version, you can get around this using 'mkPFmt':
--
-- >>> pfmt (mkPFmt @".2f") 3.6234124
-- "3.62"
--
-- Ideally we'd want to be able to write
--
-- >>> pfmt #.2f 3.6234124
-- "3.62"
--
-- (which should be possible in GHC 8.10+)
--
-- Note that the format string should not include the leading @%@.
pfmt :: forall c a. FormatType c a => PFmt c -> a -> String
pfmt :: PFmt c -> a -> String
pfmt (PFmt ff :: FieldFormat
ff) x :: a
x = Proxy c -> a -> FieldFormat -> ShowS
forall (t :: SChar) a (p :: SChar -> *).
FormatType t a =>
p t -> a -> FieldFormat -> ShowS
formatArg (Proxy c
forall k (t :: k). Proxy t
Proxy @c) a
x FieldFormat
ff ""