System.Logger.Message

Msg and ToBytes assist in constructing log messages. For example:

> g <- new (setBufSize 1 . setOutput StdOut $ defSettings)
> info g $ msg "some text" ~~ "key" .= "value" ~~ "okay" .= True
2014-04-28T21:18:20Z, I, some text, key=value, okay=True
>

Documentation

class ToBytes a where

Convert some value to a Builder.

Minimal complete definition

bytes

Methods

bytes :: a -> Builder

Instances

ToBytes Bool

Methods

bytes :: Bool -> Builder

ToBytes Char

Methods

bytes :: Char -> Builder

ToBytes Double

Methods

bytes :: Double -> Builder

ToBytes Float

Methods

bytes :: Float -> Builder

ToBytes Int

Methods

bytes :: Int -> Builder

ToBytes Int8

Methods

bytes :: Int8 -> Builder

ToBytes Int16

Methods

bytes :: Int16 -> Builder

ToBytes Int32

Methods

bytes :: Int32 -> Builder

ToBytes Int64

Methods

bytes :: Int64 -> Builder

ToBytes Integer

Methods

bytes :: Integer -> Builder

ToBytes Word

Methods

bytes :: Word -> Builder

ToBytes Word8

Methods

bytes :: Word8 -> Builder

ToBytes Word16

Methods

bytes :: Word16 -> Builder

ToBytes Word32

Methods

bytes :: Word32 -> Builder

ToBytes Word64

Methods

bytes :: Word64 -> Builder

ToBytes ByteString

Methods

bytes :: ByteString -> Builder

ToBytes ByteString

Methods

bytes :: ByteString -> Builder

ToBytes Text

Methods

bytes :: Text -> Builder

ToBytes Text

Methods

bytes :: Text -> Builder

ToBytes Builder

Methods

bytes :: Builder -> Builder

ToBytes [Char]

Methods

bytes :: [Char] -> Builder

data Msg

Type representing log messages.

data Builder

Instances

IsString Builder

Methods

fromString :: String -> Builder

Semigroup Builder

Methods

(<>) :: Builder -> Builder -> Builder

sconcat :: NonEmpty Builder -> Builder

stimes :: Integral b => b -> Builder -> Builder

Monoid Builder

Methods

mempty :: Builder

mappend :: Builder -> Builder -> Builder

mconcat :: [Builder] -> Builder

ToBytes Builder

Methods

bytes :: Builder -> Builder

msg :: ToBytes a => a -> Msg -> Msg

Turn some value into a Msg.

field :: ToBytes a => ByteString -> a -> Msg -> Msg

Render some field, i.e. a key-value pair delimited by "=".

(.=) :: ToBytes a => ByteString -> a -> Msg -> Msg infixr 5

Alias of field.

(+++) :: (ToBytes a, ToBytes b) => a -> b -> Builder infixr 6

Concatenate two ToBytes values.

(~~) :: (b -> c) -> (a -> b) -> a -> c infixr 4

Alias of . with lowered precedence to allow combination with .= without requiring parentheses.

val :: ByteString -> Builder

Type restriction. Useful to disambiguate string literals when using OverloadedStrings pragma.

eval :: Builder -> ByteString

render :: ByteString -> Bool -> (Msg -> Msg) -> ByteString

Intersperse parts of the log message with the given delimiter and render the whole builder into a ByteString.

If the second parameter is set to True, netstrings encoding is used for the message elements. Cf. http://cr.yp.to/proto/netstrings.txt for details.