Hakyll.Core.Compiler

Documentation

data Compiler a

A monad which lets you compile items and takes care of dependency tracking for you.

Instances

Monad Compiler

Defined in Hakyll.Core.Compiler.Internal

Methods

(>>=) :: Compiler a -> (a -> Compiler b) -> Compiler b

(>>) :: Compiler a -> Compiler b -> Compiler b

return :: a -> Compiler a

Functor Compiler

Defined in Hakyll.Core.Compiler.Internal

Methods

fmap :: (a -> b) -> Compiler a -> Compiler b

(<$) :: a -> Compiler b -> Compiler a

MonadFail Compiler

Defined in Hakyll.Core.Compiler.Internal

Methods

fail :: String -> Compiler a

Applicative Compiler

Defined in Hakyll.Core.Compiler.Internal

Methods

pure :: a -> Compiler a

(<*>) :: Compiler (a -> b) -> Compiler a -> Compiler b

liftA2 :: (a -> b -> c) -> Compiler a -> Compiler b -> Compiler c

(*>) :: Compiler a -> Compiler b -> Compiler b

(<*) :: Compiler a -> Compiler b -> Compiler a

Alternative Compiler

Trying alternative compilers if the first fails, regardless whether through fail, throwError or noResult. Aggregates error messages if all fail.

Defined in Hakyll.Core.Compiler.Internal

Methods

empty :: Compiler a

(<|>) :: Compiler a -> Compiler a -> Compiler a

some :: Compiler a -> Compiler [a]

many :: Compiler a -> Compiler [a]

MonadMetadata Compiler

Access provided metadata from anywhere

Defined in Hakyll.Core.Compiler.Internal

Methods

getMetadata :: Identifier -> Compiler Metadata

getMatches :: Pattern -> Compiler [Identifier]

getAllMetadata :: Pattern -> Compiler [(Identifier, Metadata)]

MonadError [String] Compiler

Compilation may fail with multiple error messages. catchError handles errors from throwError, fail and noResult

Defined in Hakyll.Core.Compiler.Internal

Methods

throwError :: [String] -> Compiler a

catchError :: Compiler a -> ([String] -> Compiler a) -> Compiler a

getUnderlying :: Compiler Identifier

Get the underlying identifier.

getUnderlyingExtension :: Compiler String

Get the extension of the underlying identifier. Returns something like ".html"

makeItem :: a -> Compiler (Item a)

Create an item from the underlying identifier and a given value.

getRoute :: Identifier -> Compiler (Maybe FilePath)

Get the route for a specified item

getResourceBody :: Compiler (Item String)

Get the full contents of the matched source file as a string, but without metadata preamble, if there was one.

getResourceString :: Compiler (Item String)

Get the full contents of the matched source file as a string.

getResourceLBS :: Compiler (Item ByteString)

Get the full contents of the matched source file as a lazy bytestring.

getResourceFilePath :: Compiler FilePath

Get the file path of the resource we are compiling

type Snapshot = String

Whilst compiling an item, it possible to save multiple snapshots of it, and not just the final result.

saveSnapshot :: (Binary a, Typeable a) => Snapshot -> Item a -> Compiler (Item a)

Save a snapshot of the item. This function returns the same item, which convenient for building >>= chains.

load :: (Binary a, Typeable a) => Identifier -> Compiler (Item a)

Load an item compiled elsewhere. If the required item is not yet compiled, the build system will take care of that automatically.

loadSnapshot :: (Binary a, Typeable a) => Identifier -> Snapshot -> Compiler (Item a)

Require a specific snapshot of an item.

loadBody :: (Binary a, Typeable a) => Identifier -> Compiler a

A shortcut for only requiring the body of an item.

loadBody = fmap itemBody . load

loadSnapshotBody :: (Binary a, Typeable a) => Identifier -> Snapshot -> Compiler a

A shortcut for only requiring the body for a specific snapshot of an item

loadAll :: (Binary a, Typeable a) => Pattern -> Compiler [Item a]

This function allows you to load a dynamic list of items

loadAllSnapshots :: (Binary a, Typeable a) => Pattern -> Snapshot -> Compiler [Item a]

Load a specific snapshot for each of dynamic list of items

cached :: (Binary a, Typeable a) => String -> Compiler a -> Compiler a

Turn on caching for a compilation value to avoid recomputing it on subsequent Hakyll runs. The storage key consists of the underlying identifier of the compiled ressource and the given name.

recompilingUnsafeCompiler :: IO a -> Compiler a

Run an IO computation in a Compiler. Unlike unsafeCompiler, this function will cause the item to be recompiled every time.

unsafeCompiler :: IO a -> Compiler a

Run an IO computation without dependencies in a Compiler. You probably want recompilingUnsafeCompiler instead.

debugCompiler :: String -> Compiler ()

Compiler for debugging purposes. Passes a message to the debug logger that is printed in verbose mode.

noResult :: String -> Compiler a

Fail so that it is treated as non-defined in an $if()$ branching Hakyll.Web.Template macro, and alternative Contexts are tried

Since: 4.13.0

withErrorMessage :: String -> Compiler a -> Compiler a

Prepend an error line to the error, if there is one. This allows you to add helpful context to error messages.

Since: 4.13.0