Copyright	Copyright (C) 2016-2020 Jesse Rosenthal John MacFarlane
License	GNU GPL, version 2 or above
Maintainer	Jesse Rosenthal <jrosenthal@jhu.edu>
Stability	alpha
Portability	portable
Safe Haskell	None
Language	Haskell2010

Text.Pandoc.Class

Description

This module defines a type class, PandocMonad, for pandoc readers and writers. A pure instance PandocPure and an impure instance PandocIO are provided. This allows users of the library to choose whether they want conversions to perform IO operations (such as reading include files or images).

Synopsis

data CommonState = CommonState {
- stLog :: [LogMessage]
- stUserDataDir :: Maybe FilePath
- stSourceURL :: Maybe Text
- stRequestHeaders :: [(Text, Text)]
- stNoCheckCertificate :: Bool
- stMediaBag :: MediaBag
- stTranslations :: Maybe (Lang, Maybe Translations)
- stInputFiles :: [FilePath]
- stOutputFile :: Maybe FilePath
- stResourcePath :: [FilePath]
- stVerbosity :: Verbosity
- stTrace :: Bool
}
newtype PandocIO a = PandocIO {
- unPandocIO :: ExceptT PandocError (StateT CommonState IO) a
}
runIO :: PandocIO a -> IO (Either PandocError a)
runIOorExplode :: PandocIO a -> IO a
extractMedia :: FilePath -> Pandoc -> PandocIO Pandoc
class (Functor m, Applicative m, Monad m, MonadError PandocError m) => PandocMonad m where
- lookupEnv :: Text -> m (Maybe Text)
- getCurrentTime :: m UTCTime
- getCurrentTimeZone :: m TimeZone
- newStdGen :: m StdGen
- newUniqueHash :: m Int
- openURL :: Text -> m (ByteString, Maybe MimeType)
- readFileLazy :: FilePath -> m ByteString
- readFileStrict :: FilePath -> m ByteString
- glob :: String -> m [FilePath]
- fileExists :: FilePath -> m Bool
- getDataFileName :: FilePath -> m FilePath
- getModificationTime :: FilePath -> m UTCTime
- getCommonState :: m CommonState
- putCommonState :: CommonState -> m ()
- getsCommonState :: (CommonState -> a) -> m a
- modifyCommonState :: (CommonState -> CommonState) -> m ()
- logOutput :: LogMessage -> m ()
- trace :: Text -> m ()
getPOSIXTime :: PandocMonad m => m POSIXTime
getZonedTime :: PandocMonad m => m ZonedTime
readFileFromDirs :: PandocMonad m => [FilePath] -> FilePath -> m (Maybe Text)
report :: PandocMonad m => LogMessage -> m ()
setTrace :: PandocMonad m => Bool -> m ()
setRequestHeader :: PandocMonad m => Text -> Text -> m ()
setNoCheckCertificate :: PandocMonad m => Bool -> m ()
getLog :: PandocMonad m => m [LogMessage]
setVerbosity :: PandocMonad m => Verbosity -> m ()
getVerbosity :: PandocMonad m => m Verbosity
getMediaBag :: PandocMonad m => m MediaBag
setMediaBag :: PandocMonad m => MediaBag -> m ()
insertMedia :: PandocMonad m => FilePath -> Maybe MimeType -> ByteString -> m ()
setUserDataDir :: PandocMonad m => Maybe FilePath -> m ()
getUserDataDir :: PandocMonad m => m (Maybe FilePath)
fetchItem :: PandocMonad m => Text -> m (ByteString, Maybe MimeType)
fetchMediaResource :: PandocMonad m => Text -> m (FilePath, Maybe MimeType, ByteString)
getInputFiles :: PandocMonad m => m [FilePath]
setInputFiles :: PandocMonad m => [FilePath] -> m ()
getOutputFile :: PandocMonad m => m (Maybe FilePath)
setOutputFile :: PandocMonad m => Maybe FilePath -> m ()
setResourcePath :: PandocMonad m => [FilePath] -> m ()
getResourcePath :: PandocMonad m => m [FilePath]
readDefaultDataFile :: PandocMonad m => FilePath -> m ByteString
readDataFile :: PandocMonad m => FilePath -> m ByteString
fillMediaBag :: PandocMonad m => Pandoc -> m Pandoc
toLang :: PandocMonad m => Maybe Text -> m (Maybe Lang)
setTranslations :: PandocMonad m => Lang -> m ()
translateTerm :: PandocMonad m => Term -> m Text
makeCanonical :: FilePath -> FilePath
data PureState = PureState {
- stStdGen :: StdGen
- stWord8Store :: [Word8]
- stUniqStore :: [Int]
- stEnv :: [(Text, Text)]
- stTime :: UTCTime
- stTimeZone :: TimeZone
- stReferenceDocx :: Archive
- stReferencePptx :: Archive
- stReferenceODT :: Archive
- stFiles :: FileTree
- stUserDataFiles :: FileTree
- stCabalDataFiles :: FileTree
}
getPureState :: PandocPure PureState
getsPureState :: (PureState -> a) -> PandocPure a
putPureState :: PureState -> PandocPure ()
modifyPureState :: (PureState -> PureState) -> PandocPure ()
newtype PandocPure a = PandocPure {
- unPandocPure :: ExceptT PandocError (StateT CommonState (State PureState)) a
}
data FileTree
data FileInfo = FileInfo {
- infoFileMTime :: UTCTime
- infoFileContents :: ByteString
}
addToFileTree :: FileTree -> FilePath -> IO FileTree
insertInFileTree :: FilePath -> FileInfo -> FileTree -> FileTree
runPure :: PandocPure a -> Either PandocError a
data Translations

Documentation

data CommonState Source #

CommonState represents state that is used by all instances of PandocMonad. Normally users should not need to interact with it directly; instead, auxiliary functions like setVerbosity and withMediaBag should be used.

Constructors

CommonState

Fields

stLog :: [LogMessage]
A list of log messages in reverse order
stUserDataDir :: Maybe FilePath
Directory to search for data files
stSourceURL :: Maybe Text
Absolute URL + dir of 1st source file
stRequestHeaders :: [(Text, Text)]
Headers to add for HTTP requests
stNoCheckCertificate :: Bool
Controls whether certificate validation is disabled
stMediaBag :: MediaBag
Media parsed from binary containers
stTranslations :: Maybe (Lang, Maybe Translations)
Translations for localization
stInputFiles :: [FilePath]
List of input files from command line
stOutputFile :: Maybe FilePath
Output file from command line
stResourcePath :: [FilePath]
Path to search for resources like included images
stVerbosity :: Verbosity
Verbosity level
stTrace :: Bool
Controls whether tracing messages are issued.

Instances

Instances details

Default CommonState Source #
Instance details Defined in Text.Pandoc.Class.CommonState Methods def :: CommonState #
Peekable CommonState Source #
Instance details Defined in Text.Pandoc.Lua.Marshaling.CommonState Methods peek :: StackIndex -> Lua CommonState #
Pushable CommonState Source #
Instance details Defined in Text.Pandoc.Lua.Marshaling.CommonState Methods push :: CommonState -> Lua () #

newtype PandocIO a Source #

Constructors

PandocIO
Fields unPandocIO :: ExceptT PandocError (StateT CommonState IO) a

Instances

Instances details

Monad PandocIO Source #
Instance details Defined in Text.Pandoc.Class.PandocIO Methods (>>=) :: PandocIO a -> (a -> PandocIO b) -> PandocIO b # (>>) :: PandocIO a -> PandocIO b -> PandocIO b # return :: a -> PandocIO a #
Functor PandocIO Source #
Instance details Defined in Text.Pandoc.Class.PandocIO Methods fmap :: (a -> b) -> PandocIO a -> PandocIO b # (<$) :: a -> PandocIO b -> PandocIO a #
Applicative PandocIO Source #
Instance details Defined in Text.Pandoc.Class.PandocIO Methods pure :: a -> PandocIO a # (<>) :: PandocIO (a -> b) -> PandocIO a -> PandocIO b # liftA2 :: (a -> b -> c) -> PandocIO a -> PandocIO b -> PandocIO c # (>) :: PandocIO a -> PandocIO b -> PandocIO b # (<*) :: PandocIO a -> PandocIO b -> PandocIO a #
MonadIO PandocIO Source #
Instance details Defined in Text.Pandoc.Class.PandocIO Methods liftIO :: IO a -> PandocIO a #
PandocMonad PandocIO Source #
Instance details Defined in Text.Pandoc.Class.PandocIO Methods lookupEnv :: Text -> PandocIO (Maybe Text) Source # getCurrentTime :: PandocIO UTCTime Source # getCurrentTimeZone :: PandocIO TimeZone Source # newStdGen :: PandocIO StdGen Source # newUniqueHash :: PandocIO Int Source # openURL :: Text -> PandocIO (ByteString, Maybe MimeType) Source # readFileLazy :: FilePath -> PandocIO ByteString Source # readFileStrict :: FilePath -> PandocIO ByteString Source # glob :: String -> PandocIO [FilePath] Source # fileExists :: FilePath -> PandocIO Bool Source # getDataFileName :: FilePath -> PandocIO FilePath Source # getModificationTime :: FilePath -> PandocIO UTCTime Source # getCommonState :: PandocIO CommonState Source # putCommonState :: CommonState -> PandocIO () Source # getsCommonState :: (CommonState -> a) -> PandocIO a Source # modifyCommonState :: (CommonState -> CommonState) -> PandocIO () Source # logOutput :: LogMessage -> PandocIO () Source # trace :: Text -> PandocIO () Source #
MonadError PandocError PandocIO Source #
Instance details Defined in Text.Pandoc.Class.PandocIO Methods throwError :: PandocError -> PandocIO a # catchError :: PandocIO a -> (PandocError -> PandocIO a) -> PandocIO a #

runIO :: PandocIO a -> IO (Either PandocError a) Source #

Evaluate a PandocIO operation.

runIOorExplode :: PandocIO a -> IO a Source #

Evaluate a PandocIO operation, handling any errors by exiting with an appropriate message and error status.

extractMedia :: FilePath -> Pandoc -> PandocIO Pandoc Source #

Extract media from the mediabag into a directory.

class (Functor m, Applicative m, Monad m, MonadError PandocError m) => PandocMonad m where Source #

The PandocMonad typeclass contains all the potentially IO-related functions used in pandoc's readers and writers. Instances of this typeclass may implement these functions in IO (as in PandocIO) or using an internal state that represents a file system, time, and so on (as in PandocPure).

Minimal complete definition

lookupEnv, getCurrentTime, getCurrentTimeZone, newStdGen, newUniqueHash, openURL, readFileLazy, readFileStrict, glob, fileExists, getDataFileName, getModificationTime, getCommonState, putCommonState, logOutput

Methods

lookupEnv :: Text -> m (Maybe Text) Source #

Lookup an environment variable.

getCurrentTime :: m UTCTime Source #

Get the current (UTC) time.

getCurrentTimeZone :: m TimeZone Source #

Get the locale's time zone.

newStdGen :: m StdGen Source #

Return a new generator for random numbers.

newUniqueHash :: m Int Source #

Return a new unique integer.

openURL :: Text -> m (ByteString, Maybe MimeType) Source #

Retrieve contents and mime type from a URL, raising an error on failure.

readFileLazy :: FilePath -> m ByteString Source #

Read the lazy ByteString contents from a file path, raising an error on failure.

readFileStrict :: FilePath -> m ByteString Source #

Read the strict ByteString contents from a file path, raising an error on failure.

glob :: String -> m [FilePath] Source #

Return a list of paths that match a glob, relative to the working directory. See Glob for the glob syntax.

fileExists :: FilePath -> m Bool Source #

Returns True if file exists.

getDataFileName :: FilePath -> m FilePath Source #

Returns the path of data file.

getModificationTime :: FilePath -> m UTCTime Source #

Return the modification time of a file.

getCommonState :: m CommonState Source #

Get the value of the CommonState used by all instances of PandocMonad.

putCommonState :: CommonState -> m () Source #

Set the value of the CommonState used by all instances of PandocMonad. | Get the value of a specific field of CommonState.

getsCommonState :: (CommonState -> a) -> m a Source #

Get the value of a specific field of CommonState.

modifyCommonState :: (CommonState -> CommonState) -> m () Source #

Modify the CommonState.

logOutput :: LogMessage -> m () Source #

Output a log message.

trace :: Text -> m () Source #

Output a debug message to sterr, using trace, if tracing is enabled. Note: this writes to stderr even in pure instances.

Instances

Instances details

PandocMonad PandocPure Source #
Instance details Defined in Text.Pandoc.Class.PandocPure Methods lookupEnv :: Text -> PandocPure (Maybe Text) Source # getCurrentTime :: PandocPure UTCTime Source # getCurrentTimeZone :: PandocPure TimeZone Source # newStdGen :: PandocPure StdGen Source # newUniqueHash :: PandocPure Int Source # openURL :: Text -> PandocPure (ByteString, Maybe MimeType) Source # readFileLazy :: FilePath -> PandocPure ByteString Source # readFileStrict :: FilePath -> PandocPure ByteString Source # glob :: String -> PandocPure [FilePath] Source # fileExists :: FilePath -> PandocPure Bool Source # getDataFileName :: FilePath -> PandocPure FilePath Source # getModificationTime :: FilePath -> PandocPure UTCTime Source # getCommonState :: PandocPure CommonState Source # putCommonState :: CommonState -> PandocPure () Source # getsCommonState :: (CommonState -> a) -> PandocPure a Source # modifyCommonState :: (CommonState -> CommonState) -> PandocPure () Source # logOutput :: LogMessage -> PandocPure () Source # trace :: Text -> PandocPure () Source #
PandocMonad PandocIO Source #
Instance details Defined in Text.Pandoc.Class.PandocIO Methods lookupEnv :: Text -> PandocIO (Maybe Text) Source # getCurrentTime :: PandocIO UTCTime Source # getCurrentTimeZone :: PandocIO TimeZone Source # newStdGen :: PandocIO StdGen Source # newUniqueHash :: PandocIO Int Source # openURL :: Text -> PandocIO (ByteString, Maybe MimeType) Source # readFileLazy :: FilePath -> PandocIO ByteString Source # readFileStrict :: FilePath -> PandocIO ByteString Source # glob :: String -> PandocIO [FilePath] Source # fileExists :: FilePath -> PandocIO Bool Source # getDataFileName :: FilePath -> PandocIO FilePath Source # getModificationTime :: FilePath -> PandocIO UTCTime Source # getCommonState :: PandocIO CommonState Source # putCommonState :: CommonState -> PandocIO () Source # getsCommonState :: (CommonState -> a) -> PandocIO a Source # modifyCommonState :: (CommonState -> CommonState) -> PandocIO () Source # logOutput :: LogMessage -> PandocIO () Source # trace :: Text -> PandocIO () Source #
(MonadTrans t, PandocMonad m, Functor (t m), MonadError PandocError (t m), Monad (t m), Applicative (t m)) => PandocMonad (t m) Source #
Instance details Defined in Text.Pandoc.Class.PandocMonad Methods lookupEnv :: Text -> t m (Maybe Text) Source # getCurrentTime :: t m UTCTime Source # getCurrentTimeZone :: t m TimeZone Source # newStdGen :: t m StdGen Source # newUniqueHash :: t m Int Source # openURL :: Text -> t m (ByteString, Maybe MimeType) Source # readFileLazy :: FilePath -> t m ByteString Source # readFileStrict :: FilePath -> t m ByteString Source # glob :: String -> t m [FilePath] Source # fileExists :: FilePath -> t m Bool Source # getDataFileName :: FilePath -> t m FilePath Source # getModificationTime :: FilePath -> t m UTCTime Source # getCommonState :: t m CommonState Source # putCommonState :: CommonState -> t m () Source # getsCommonState :: (CommonState -> a) -> t m a Source # modifyCommonState :: (CommonState -> CommonState) -> t m () Source # logOutput :: LogMessage -> t m () Source # trace :: Text -> t m () Source #
PandocMonad m => PandocMonad (ParsecT s st m) Source #
Instance details Defined in Text.Pandoc.Class.PandocMonad Methods lookupEnv :: Text -> ParsecT s st m (Maybe Text) Source # getCurrentTime :: ParsecT s st m UTCTime Source # getCurrentTimeZone :: ParsecT s st m TimeZone Source # newStdGen :: ParsecT s st m StdGen Source # newUniqueHash :: ParsecT s st m Int Source # openURL :: Text -> ParsecT s st m (ByteString, Maybe MimeType) Source # readFileLazy :: FilePath -> ParsecT s st m ByteString Source # readFileStrict :: FilePath -> ParsecT s st m ByteString Source # glob :: String -> ParsecT s st m [FilePath] Source # fileExists :: FilePath -> ParsecT s st m Bool Source # getDataFileName :: FilePath -> ParsecT s st m FilePath Source # getModificationTime :: FilePath -> ParsecT s st m UTCTime Source # getCommonState :: ParsecT s st m CommonState Source # putCommonState :: CommonState -> ParsecT s st m () Source # getsCommonState :: (CommonState -> a) -> ParsecT s st m a Source # modifyCommonState :: (CommonState -> CommonState) -> ParsecT s st m () Source # logOutput :: LogMessage -> ParsecT s st m () Source # trace :: Text -> ParsecT s st m () Source #

getPOSIXTime :: PandocMonad m => m POSIXTime Source #

Get the POSIX time.

getZonedTime :: PandocMonad m => m ZonedTime Source #

Get the zoned time.

readFileFromDirs :: PandocMonad m => [FilePath] -> FilePath -> m (Maybe Text) Source #

Read file, checking in any number of directories.

report :: PandocMonad m => LogMessage -> m () Source #

Log a message using logOutput. Note that logOutput is called only if the verbosity level exceeds the level of the message, but the message is added to the list of log messages that will be retrieved by getLog regardless of its verbosity level.

setTrace :: PandocMonad m => Bool -> m () Source #

Determine whether tracing is enabled. This affects the behavior of trace. If tracing is not enabled, trace does nothing.

setRequestHeader Source #

Arguments

:: PandocMonad m
=> Text	Header name
-> Text	Value
-> m ()

Set request header to use in HTTP requests.

setNoCheckCertificate :: PandocMonad m => Bool -> m () Source #

Determine whether certificate validation is disabled

getLog :: PandocMonad m => m [LogMessage] Source #

Get the accumulated log messages (in temporal order).

setVerbosity :: PandocMonad m => Verbosity -> m () Source #

Set the verbosity level.

getVerbosity :: PandocMonad m => m Verbosity Source #

Get the verbosity level.

getMediaBag :: PandocMonad m => m MediaBag Source #

Retrieve the media bag.

setMediaBag :: PandocMonad m => MediaBag -> m () Source #

Initialize the media bag.

insertMedia :: PandocMonad m => FilePath -> Maybe MimeType -> ByteString -> m () Source #

Insert an item into the media bag.

setUserDataDir :: PandocMonad m => Maybe FilePath -> m () Source #

Set the user data directory in common state.

getUserDataDir :: PandocMonad m => m (Maybe FilePath) Source #

Get the user data directory from common state.

fetchItem :: PandocMonad m => Text -> m (ByteString, Maybe MimeType) Source #

Fetch an image or other item from the local filesystem or the net. Returns raw content and maybe mime type.

fetchMediaResource :: PandocMonad m => Text -> m (FilePath, Maybe MimeType, ByteString) Source #

Fetch local or remote resource (like an image) and provide data suitable for adding it to the MediaBag.

getInputFiles :: PandocMonad m => m [FilePath] Source #

Retrieve the input filenames.

setInputFiles :: PandocMonad m => [FilePath] -> m () Source #

Set the input filenames.

getOutputFile :: PandocMonad m => m (Maybe FilePath) Source #

Retrieve the output filename.

setOutputFile :: PandocMonad m => Maybe FilePath -> m () Source #

Set the output filename.

setResourcePath :: PandocMonad m => [FilePath] -> m () Source #

Set the resource path searched by fetchItem.

getResourcePath :: PandocMonad m => m [FilePath] Source #

Retrieve the resource path searched by fetchItem.

readDefaultDataFile :: PandocMonad m => FilePath -> m ByteString Source #

Read file from from the default data files.

readDataFile :: PandocMonad m => FilePath -> m ByteString Source #

Read file from user data directory or, if not found there, from the default data files.

fillMediaBag :: PandocMonad m => Pandoc -> m Pandoc Source #

Traverse tree, filling media bag for any images that aren't already in the media bag.

toLang :: PandocMonad m => Maybe Text -> m (Maybe Lang) Source #

Convert BCP47 string to a Lang, issuing warning if there are problems.

setTranslations :: PandocMonad m => Lang -> m () Source #

Select the language to use with translateTerm. Note that this does not read a translation file; that is only done the first time translateTerm is used.

translateTerm :: PandocMonad m => Term -> m Text Source #

Get a translation from the current term map. Issue a warning if the term is not defined.

makeCanonical :: FilePath -> FilePath Source #

Canonicalizes a file path by removing redundant . and ...

data PureState Source #

The PureState contains ersatz representations of things that would normally be obtained through IO.

Constructors

PureState

Fields

stStdGen :: StdGen
stWord8Store :: [Word8]
should be infinite, i.e. [1..]
stUniqStore :: [Int]
should be infinite and contain every element at most once, e.g. [1..]
stEnv :: [(Text, Text)]
stTime :: UTCTime
stTimeZone :: TimeZone
stReferenceDocx :: Archive
stReferencePptx :: Archive
stReferenceODT :: Archive
stFiles :: FileTree
stUserDataFiles :: FileTree
stCabalDataFiles :: FileTree

Instances

Instances details

Default PureState Source #
Instance details Defined in Text.Pandoc.Class.PandocPure Methods def :: PureState #

getPureState :: PandocPure PureState Source #

Retrieve the underlying state of the PandocPure type.

getsPureState :: (PureState -> a) -> PandocPure a Source #

Retrieve a value from the underlying state of the PandocPure type.

putPureState :: PureState -> PandocPure () Source #

Set a new state for the PandocPure type.

modifyPureState :: (PureState -> PureState) -> PandocPure () Source #

Modify the underlying state of the PandocPure type.

newtype PandocPure a Source #

Constructors

PandocPure
Fields unPandocPure :: ExceptT PandocError (StateT CommonState (State PureState)) a

Instances

Instances details

Monad PandocPure Source #
Instance details Defined in Text.Pandoc.Class.PandocPure Methods (>>=) :: PandocPure a -> (a -> PandocPure b) -> PandocPure b # (>>) :: PandocPure a -> PandocPure b -> PandocPure b # return :: a -> PandocPure a #
Functor PandocPure Source #
Instance details Defined in Text.Pandoc.Class.PandocPure Methods fmap :: (a -> b) -> PandocPure a -> PandocPure b # (<$) :: a -> PandocPure b -> PandocPure a #
Applicative PandocPure Source #
Instance details Defined in Text.Pandoc.Class.PandocPure Methods pure :: a -> PandocPure a # (<>) :: PandocPure (a -> b) -> PandocPure a -> PandocPure b # liftA2 :: (a -> b -> c) -> PandocPure a -> PandocPure b -> PandocPure c # (>) :: PandocPure a -> PandocPure b -> PandocPure b # (<*) :: PandocPure a -> PandocPure b -> PandocPure a #
PandocMonad PandocPure Source #
Instance details Defined in Text.Pandoc.Class.PandocPure Methods lookupEnv :: Text -> PandocPure (Maybe Text) Source # getCurrentTime :: PandocPure UTCTime Source # getCurrentTimeZone :: PandocPure TimeZone Source # newStdGen :: PandocPure StdGen Source # newUniqueHash :: PandocPure Int Source # openURL :: Text -> PandocPure (ByteString, Maybe MimeType) Source # readFileLazy :: FilePath -> PandocPure ByteString Source # readFileStrict :: FilePath -> PandocPure ByteString Source # glob :: String -> PandocPure [FilePath] Source # fileExists :: FilePath -> PandocPure Bool Source # getDataFileName :: FilePath -> PandocPure FilePath Source # getModificationTime :: FilePath -> PandocPure UTCTime Source # getCommonState :: PandocPure CommonState Source # putCommonState :: CommonState -> PandocPure () Source # getsCommonState :: (CommonState -> a) -> PandocPure a Source # modifyCommonState :: (CommonState -> CommonState) -> PandocPure () Source # logOutput :: LogMessage -> PandocPure () Source # trace :: Text -> PandocPure () Source #
MonadError PandocError PandocPure Source #
Instance details Defined in Text.Pandoc.Class.PandocPure Methods throwError :: PandocError -> PandocPure a # catchError :: PandocPure a -> (PandocError -> PandocPure a) -> PandocPure a #

data FileTree Source #

Basis of the mock file system used by PandocPure.

Instances

Instances details

Semigroup FileTree Source #
Instance details Defined in Text.Pandoc.Class.PandocPure Methods (<>) :: FileTree -> FileTree -> FileTree # sconcat :: NonEmpty FileTree -> FileTree # stimes :: Integral b => b -> FileTree -> FileTree #
Monoid FileTree Source #
Instance details Defined in Text.Pandoc.Class.PandocPure Methods mempty :: FileTree # mappend :: FileTree -> FileTree -> FileTree # mconcat :: [FileTree] -> FileTree #

data FileInfo Source #

Captures all file-level information necessary for a PandocMonad conforming mock file system.

Constructors

FileInfo
Fields infoFileMTime :: UTCTime infoFileContents :: ByteString

addToFileTree :: FileTree -> FilePath -> IO FileTree Source #

Add the specified file to the FileTree. If file is a directory, add its contents recursively.

insertInFileTree :: FilePath -> FileInfo -> FileTree -> FileTree Source #

Insert an ersatz file into the FileTree.

runPure :: PandocPure a -> Either PandocError a Source #

Run a PandocPure operation.

data Translations Source #

Instances

Instances details

Show Translations Source #
Instance details Defined in Text.Pandoc.Translations Methods showsPrec :: Int -> Translations -> ShowS # show :: Translations -> String # showList :: [Translations] -> ShowS #
Generic Translations Source #
Instance details Defined in Text.Pandoc.Translations Associated Types type Rep Translations :: Type -> Type # Methods from :: Translations -> Rep Translations x # to :: Rep Translations x -> Translations #
Semigroup Translations Source #
Instance details Defined in Text.Pandoc.Translations Methods (<>) :: Translations -> Translations -> Translations # sconcat :: NonEmpty Translations -> Translations # stimes :: Integral b => b -> Translations -> Translations #
Monoid Translations Source #
Instance details Defined in Text.Pandoc.Translations Methods mempty :: Translations # mappend :: Translations -> Translations -> Translations # mconcat :: [Translations] -> Translations #
FromYAML Translations Source #
Instance details Defined in Text.Pandoc.Translations Methods parseYAML :: Node Pos -> Parser Translations #
FromJSON Translations Source #
Instance details Defined in Text.Pandoc.Translations Methods parseJSON :: Value -> Parser Translations # parseJSONList :: Value -> Parser [Translations] #
type Rep Translations Source #
Instance details Defined in Text.Pandoc.Translations type Rep Translations