Web.Encodings

Various web encodings.

Simple encodings.

URL (percentage encoding)

encodeUrl :: StringLike a => a -> a

Encode all but unreserved characters with percentage encoding.

This function implicitly converts the given value to a UTF-8 bytestream.

decodeUrl :: StringLike s => s -> s

Decode percentage encoding. Assumes use of UTF-8 character encoding.

If there are any parse errors, this returns the original input. If you would like to be alerted more directly of errors, use decodeUrlFailure.

decodeUrlFailure :: (Failure DecodeUrlException m, StringLike s, Monad m) => s -> m s

Same as decodeUrl, but failures on either invalid percent or UTF8 encoding.

data DecodeUrlException

Constructors

InvalidPercentEncoding

InvalidUtf8Encoding

Instances

Show DecodeUrlException

Typeable DecodeUrlException

Exception DecodeUrlException

HTML (entity encoding)

encodeHtml :: StringLike s => s -> s

Escape special HTML characters.

decodeHtml :: StringLike s => s -> s

Decode HTML-encoded content into plain content.

Note: this does not support all HTML entities available. It also swallows all failures.

JSON

encodeJson :: StringLike s => s -> s

Perform JSON-encoding on a string. Does not wrap in quotation marks. Taken from json package by Sigbjorn Finne.

decodeJson :: StringLike s => s -> s

HTTP level encoding.

Query string- pairs of percentage encoding

encodeUrlPairs :: StringLike s => [(s, s)] -> s

Convert a list of key-values pairs into a query string. Does not include the question mark at the beginning.

decodeUrlPairs :: StringLike s => s -> [(s, s)]

Convert into key-value pairs. Strips the leading ? if necesary.

decodeUrlPairsFailure :: (StringLike s, Failure DecodeUrlException m, Monad m) => s -> m [(s, s)]

Convert into key-value pairs. Strips the leading ? if necesary. failures as necesary for invalid encodings.

Post parameters

data FileInfo s c

Information on an uploaded file.

Constructors

FileInfo

Fields

fileName :: s

fileContentType :: s

fileContent :: c

Instances

(Eq s, Eq c) => Eq (FileInfo s c)

(Show s, Show c) => Show (FileInfo s c)

parseMultipart

Arguments

:: StringLike s

=> String

boundary

-> s

content

-> ([(s, s)], [(s, FileInfo s s)])

Parse a multipart form into parameters and files.

parsePost

Arguments

:: StringLike s

=> String

content type

-> String

content length

-> s

body of the post

-> ([(s, s)], [(s, FileInfo s s)])

Parse a post request. This function determines the correct decoding function to use.

Specific HTTP headers

decodeCookies :: StringLike s => s -> [(s, s)]

Deprecate alias for parseCookies.

parseCookies :: StringLike s => s -> [(s, s)]

Decode the value of an HTTP_COOKIE header into key/value pairs.

parseHttpAccept :: StringLike s => s -> [s]

Parse the HTTP accept string to determine supported content types.

Date/time encoding

formatW3 :: UTCTime -> String

Format a UTCTime in W3 format; useful for setting cookies.

WAI-specific decodings

data Sink x y

A destination for data, the opposite of a Source.

Constructors

Sink

Fields

sinkInit :: IO x

sinkAppend :: x -> ByteString -> IO x

sinkClose :: x -> IO y

sinkFinalize :: y -> IO ()

lbsSink :: Sink ([ByteString] -> [ByteString]) ByteString

tempFileSink :: Sink (FilePath, Handle) FilePath