{-# LANGUAGE NoImplicitPrelude, OverloadedStrings, DeriveDataTypeable, DeriveGeneric, ExistentialQuantification #-} -- | Description : All message type definitions. module IHaskell.Types ( Message(..), MessageHeader(..), MessageType(..), Username, Metadata(..), replyType, ExecutionState(..), StreamType(..), MimeType(..), DisplayData(..), EvaluationResult(..), ExecuteReplyStatus(..), KernelState(..), LintStatus(..), Width, Height, Display(..), defaultKernelState, extractPlain, kernelOpts, KernelOpt(..), IHaskellDisplay(..), IHaskellWidget(..), Widget(..), CommInfo(..), KernelSpec(..), ) where import IHaskellPrelude import qualified Data.Text as T import qualified Data.Text.Lazy as LT import qualified Data.ByteString as BS import qualified Data.ByteString.Lazy as LBS import qualified Data.ByteString.Char8 as CBS import qualified Data.ByteString.Char8 as Char import Data.Serialize import GHC.Generics import Data.Aeson (Value) import IHaskell.IPython.Kernel -- | A class for displayable Haskell types. -- -- IHaskell's displaying of results behaves as if these two overlapping/undecidable instances also -- existed: -- -- > instance (Show a) => IHaskellDisplay a -- > instance Show a where shows _ = id class IHaskellDisplay a where display :: a -> IO Display -- | Display as an interactive widget. class IHaskellDisplay a => IHaskellWidget a where -- | Output target name for this widget. The actual input parameter should be ignored. targetName :: a -> String -- | Called when the comm is opened. Allows additional messages to be sent after comm open. open :: a -- ^ Widget to open a comm port with. -> (Value -> IO ()) -- ^ Way to respond to the message. -> IO () open _ _ = return () -- | Respond to a comm data message. comm :: a -- ^ Widget which is being communicated with. -> Value -- ^ Sent data. -> (Value -> IO ()) -- ^ Way to respond to the message. -> IO () comm _ _ _ = return () -- | Close the comm, releasing any resources we might need to. close :: a -- ^ Widget to close comm port with. -> Value -- ^ Sent data. -> IO () close _ _ = return () data Widget = forall a. IHaskellWidget a => Widget a deriving Typeable instance IHaskellDisplay Widget where display (Widget widget) = display widget instance IHaskellWidget Widget where targetName (Widget widget) = targetName widget open (Widget widget) = open widget comm (Widget widget) = comm widget close (Widget widget) = close widget instance Show Widget where show _ = "" -- | Wrapper for ipython-kernel's DisplayData which allows sending multiple results from the same -- expression. data Display = Display [DisplayData] | ManyDisplay [Display] deriving (Show, Typeable, Generic) instance Serialize Display instance Monoid Display where mempty = Display [] ManyDisplay a `mappend` ManyDisplay b = ManyDisplay (a ++ b) ManyDisplay a `mappend` b = ManyDisplay (a ++ [b]) a `mappend` ManyDisplay b = ManyDisplay (a : b) a `mappend` b = ManyDisplay [a, b] -- | All state stored in the kernel between executions. data KernelState = KernelState { getExecutionCounter :: Int , getLintStatus :: LintStatus -- Whether to use hlint, and what arguments to pass it. , useSvg :: Bool , useShowErrors :: Bool , useShowTypes :: Bool , usePager :: Bool , openComms :: Map UUID Widget , kernelDebug :: Bool } deriving Show defaultKernelState :: KernelState defaultKernelState = KernelState { getExecutionCounter = 1 , getLintStatus = LintOn , useSvg = True , useShowErrors = False , useShowTypes = False , usePager = True , openComms = mempty , kernelDebug = False } -- | Kernel options to be set via `:set` and `:option`. data KernelOpt = KernelOpt { getOptionName :: [String] -- ^ Ways to set this option via `:option` , getSetName :: [String] -- ^ Ways to set this option via `:set` , getUpdateKernelState :: KernelState -> KernelState -- ^ Function to update the kernel -- state. } kernelOpts :: [KernelOpt] kernelOpts = [ KernelOpt ["lint"] [] $ \state -> state { getLintStatus = LintOn } , KernelOpt ["no-lint"] [] $ \state -> state { getLintStatus = LintOff } , KernelOpt ["svg"] [] $ \state -> state { useSvg = True } , KernelOpt ["no-svg"] [] $ \state -> state { useSvg = False } , KernelOpt ["show-types"] ["+t"] $ \state -> state { useShowTypes = True } , KernelOpt ["no-show-types"] ["-t"] $ \state -> state { useShowTypes = False } , KernelOpt ["show-errors"] [] $ \state -> state { useShowErrors = True } , KernelOpt ["no-show-errors"] [] $ \state -> state { useShowErrors = False } , KernelOpt ["pager"] [] $ \state -> state { usePager = True } , KernelOpt ["no-pager"] [] $ \state -> state { usePager = False } ] -- | Current HLint status. data LintStatus = LintOn | LintOff deriving (Eq, Show) data CommInfo = CommInfo Widget UUID String deriving Show -- | Output of evaluation. data EvaluationResult = -- | An intermediate result which communicates what has been printed thus -- far. IntermediateResult { outputs :: Display -- ^ Display outputs. } | FinalResult { outputs :: Display -- ^ Display outputs. , pagerOut :: [DisplayData] -- ^ Mimebundles to display in the IPython -- pager. , startComms :: [CommInfo] -- ^ Comms to start. } deriving Show