{-# LANGUAGE FlexibleInstances, MultiParamTypeClasses, FunctionalDependencies, Safe #-}
{-
This module is part of Chatty.
Copyleft (c) 2014 Marvin Cohrs
All wrongs reversed. Sharing is an act of love, not crime.
Please share Antisplice with everyone you like.
Chatty is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Chatty is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with Chatty. If not, see .
-}
-- | Provides a typeclass for all monads that may scan text.
module Text.Chatty.Scanner where
import Text.Chatty.Finalizer
import Control.Applicative
import Control.Monad
import Control.Monad.State
import Control.Monad.Identity
import Control.Monad.Trans.Class
import System.IO
-- | A typeclass for all monads that may read input.
class Monad m => ChScanner m where
-- | Read one single character
mscan1 :: m Char
-- | Lazily read all the input.
mscanL :: m String
-- | Input readable? (not EOF)
mscannable :: m Bool
-- | Return FD handle, if available
mscanh :: m (Maybe Handle)
mscanh = return Nothing
-- | Input available yet?
mready :: m Bool
-- ChScanner instance for: IO
instance ChScanner IO where
mscan1 = getChar
mscanL = getContents
mscannable = fmap not isEOF
mscanh = return $ Just stdin
mready = hReady stdin
-- ChScanner instance for: StateT String
instance Monad m => ChScanner (StateT String m) where
mscan1 = do
c <- gets head
modify tail
return c
mscanL = do
s <- get
put []
return s
mscannable = gets (not.null)
mready = return True
-- Definition of HereStringT + instances
-- | HereStringT holds a given string and uses it as input for the function
-- (much like here-strings in the shell)
newtype HereStringT m a = HereString { runHereStringT :: String -> m (a,String) }
instance Monad m => Monad (HereStringT m) where
return a = HereString $ \s -> return (a,s)
(HereString h) >>= f = HereString $ \s -> do (a,s') <- h s; runHereStringT (f a) s'
instance MonadTrans HereStringT where
lift m = HereString $ \s -> do a <- m; return (a,s)
instance Monad m => Functor (HereStringT m) where
fmap f a = HereString $ \s -> do (a',s') <- runHereStringT a s; return (f a',s')
instance Monad m => Applicative (HereStringT m) where
(<*>) = ap
pure = return
instance Monad m => ChScanner (HereStringT m) where
mscan1 = HereString $ \(s:ss) -> return (s,ss)
mscanL = HereString $ \s -> return (s,[])
mscannable = HereString $ \s -> return (not $ null s,s)
mready = return True
instance MonadIO m => MonadIO (HereStringT m) where
liftIO = lift . liftIO
instance ChFinalizer m => ChFinalizer (HereStringT m) where
mqfh = lift . mqfh
mfin = lift mfin
-- Definition of QuietT + instances
-- | QuietT does not convey any input (much like Monad (QuietT m) where
return = Quiet . return
(Quiet q) >>= f = Quiet $ do q' <- q; runQuietT (f q')
instance MonadTrans QuietT where
lift = Quiet
instance Monad m => ChScanner (QuietT m) where
mscan1 = return undefined
mscanL = return []
mscannable = return False
mready = return False
instance Functor m => Functor (QuietT m) where
fmap f (Quiet a) = Quiet $ fmap f a
instance (Functor m, Monad m) => Applicative (QuietT m) where
(<*>) = ap
pure = return
-- Definition of InRedirT + instances
-- | InRedirT redirects all input to a given handle (much like m a }
-- | InRedirT on an IO monad
type InRedir = InRedirT (HandleCloserT IO)
instance Monad m => Monad (InRedirT m) where
return a = InRedir $ \h -> return a
(InRedir r) >>= f = InRedir $ \h -> do a <- r h; runInRedirT (f a) h
instance MonadTrans InRedirT where
lift m = InRedir $ \h -> do a <- m; return a
instance MonadIO m => MonadIO (InRedirT m) where
liftIO = lift . liftIO
instance MonadIO m => ChScanner (InRedirT m) where
mscan1 = InRedir $ \h -> do c <- liftIO $ hGetChar h; return c
mscanL = InRedir $ \h -> do s <- liftIO $ hGetContents h; return s
mscannable = InRedir $ \h -> do b <- liftIO $ hIsEOF h; return b
mscanh = InRedir $ \h -> return (Just h)
mready = InRedir $ \h -> do r <- liftIO $ hReady h; return r
instance Monad m => Functor (InRedirT m) where
fmap f a = InRedir $ \h -> do a' <- runInRedirT a h; return (f a')
instance Monad m => Applicative (InRedirT m) where
(<*>) = ap
pure = return
instance ChFinalizer m => ChFinalizer (InRedirT m) where
mqfh = lift . mqfh
mfin = lift mfin
-- | Run InRedir with handle
runInRedir :: InRedir a -> Handle -> IO a
runInRedir m h = withLazyIO $ runInRedirT m h
-- | Run InRedirT with a filename
runInRedirFT :: (Functor m,MonadIO m,ChFinalizer m) => InRedirT m a -> FilePath -> m a
runInRedirFT m fp = do
h <- liftIO $ openFile fp ReadMode
a <- runInRedirT m h
mqfh h
--liftIO $ hClose h
return a
-- | Run InRedir with a filename
runInRedirF :: InRedir a -> FilePath -> IO a
runInRedirF m fp = withLazyIO $ runInRedirFT m fp
-- | Line-scanning alternative to mscan1/L
mscanLn :: ChScanner m => m String
mscanLn = do
h <- mscan1
if h == '\n' then return ""
else do
hs <- mscanLn
return (h:hs)
-- | Scan a fixed number of chars
mscanN :: ChScanner m => Int -> m String
mscanN n
| n > 0 = do
b <- mscannable
if not b then return []
else do
h <- mscan1
hs <- mscanN (n-1)
return (h:hs)
| otherwise = return []
-- Shell-like syntax
-- | Redirection source that does not provide any output
data EmptyI = EmptyI
-- | Class for all primitive redirection sources.
class RedirectionSource t mt a r | t -> mt, t a -> r where
-- | Redirection
(.<.) :: (ChFinalizer m,Functor m,MonadIO m,ChScanner (mt m)) => mt m a -> t -> m r
instance RedirectionSource EmptyI QuietT a a where
m .<. _ = runQuietT m
instance RedirectionSource FilePath InRedirT a a where
m .<. fp = runInRedirFT m fp
instance RedirectionSource Handle InRedirT a a where
m .<. fp = runInRedirT m fp
-- | Class for all Here-Documents
class RedirectionHeredoc t mt a r | t -> mt, t a -> r where
-- | Redirection
(.<<.) :: (Functor m,ChScanner (mt m)) => mt m a -> t -> m r
instance RedirectionHeredoc String HereStringT a a where
m .<<. str = fmap fst $ runHereStringT m str