| 1 |
-- | Code for parsing extensions headers. |
| 2 |
{-# LANGUAGE OverloadedStrings #-} |
| 3 |
{-# LANGUAGE RecordWildCards #-} |
| 4 |
module Network.WebSockets.Extensions.Description |
| 5 |
( ExtensionParam |
| 6 |
, ExtensionDescription (..) |
| 7 |
, ExtensionDescriptions |
| 8 |
|
| 9 |
, parseExtensionDescriptions |
| 10 |
, encodeExtensionDescriptions |
| 11 |
) where |
| 12 |
|
| 13 |
import Control.Applicative ((*>), (<*)) |
| 14 |
import qualified Data.Attoparsec.ByteString as A |
| 15 |
import qualified Data.Attoparsec.ByteString.Char8 as AC8 |
| 16 |
import qualified Data.ByteString as B |
| 17 |
import Data.Monoid (mconcat, mappend) |
| 18 |
import Prelude |
| 19 |
|
| 20 |
type ExtensionParam = (B.ByteString, Maybe B.ByteString) |
| 21 |
|
| 22 |
data ExtensionDescription = ExtensionDescription |
| 23 |
{ extName :: !B.ByteString |
| 24 |
, extParams :: ![ExtensionParam] |
| 25 |
} deriving (Eq, Show) |
| 26 |
|
| 27 |
parseExtensionDescription :: A.Parser ExtensionDescription |
| 28 |
parseExtensionDescription = do |
| 29 |
extName <- parseIdentifier |
| 30 |
extParams <- A.many' (token ';' *> parseParam) |
| 31 |
return ExtensionDescription {..} |
| 32 |
where |
| 33 |
parseIdentifier = AC8.takeWhile isIdentifierChar <* AC8.skipSpace |
| 34 |
|
| 35 |
token c = AC8.char8 c <* AC8.skipSpace |
| 36 |
|
| 37 |
isIdentifierChar c = |
| 38 |
(c >= 'a' && c <= 'z') || |
| 39 |
(c >= 'A' && c <= 'Z') || |
| 40 |
(c >= '0' && c <= '9') || |
| 41 |
c == '-' || c == '_' |
| 42 |
|
| 43 |
parseParam :: A.Parser ExtensionParam |
| 44 |
parseParam = do |
| 45 |
name <- parseIdentifier |
| 46 |
val <- A.option Nothing $ fmap Just $ token '=' *> parseIdentifier |
| 47 |
return (name, val) |
| 48 |
|
| 49 |
encodeExtensionDescription :: ExtensionDescription -> B.ByteString |
| 50 |
encodeExtensionDescription ExtensionDescription {..} = |
| 51 |
mconcat (extName : map encodeParam extParams) |
| 52 |
where |
| 53 |
encodeParam (key, Nothing) = ";" `mappend` key |
| 54 |
encodeParam (key, Just val) = ";" `mappend` key `mappend` "=" `mappend` val |
| 55 |
|
| 56 |
type ExtensionDescriptions = [ExtensionDescription] |
| 57 |
|
| 58 |
parseExtensionDescriptions :: B.ByteString -> Either String ExtensionDescriptions |
| 59 |
parseExtensionDescriptions = A.parseOnly $ |
| 60 |
AC8.skipSpace *> |
| 61 |
A.sepBy parseExtensionDescription (AC8.char8 ',' <* AC8.skipSpace) <* |
| 62 |
A.endOfInput |
| 63 |
|
| 64 |
encodeExtensionDescriptions :: ExtensionDescriptions -> B.ByteString |
| 65 |
encodeExtensionDescriptions = B.intercalate "," . map encodeExtensionDescription |