X-Git-Url: http://git.cielonegro.org/gitweb.cgi?p=Lucu.git;a=blobdiff_plain;f=Network%2FHTTP%2FLucu%2FMIMEType.hs;h=d60b70e5d5f21d4704ee6bb269f271692d35e58e;hp=88a2eeffde0ad8e7e673af93c425f506c6d5706e;hb=b1fac0a;hpb=9bb89434103e9a22f100d6ecb7e65a5d461e0454 diff --git a/Network/HTTP/Lucu/MIMEType.hs b/Network/HTTP/Lucu/MIMEType.hs index 88a2eef..d60b70e 100644 --- a/Network/HTTP/Lucu/MIMEType.hs +++ b/Network/HTTP/Lucu/MIMEType.hs @@ -1,83 +1,82 @@ {-# LANGUAGE - UnboxedTuples + DeriveDataTypeable + , OverloadedStrings + , RecordWildCards + , TemplateHaskell , UnicodeSyntax #-} -{-# OPTIONS_HADDOCK prune #-} - --- |Manipulation of MIME Types. +-- |Parsing and printing MIME Media Types +-- (). module Network.HTTP.Lucu.MIMEType ( MIMEType(..) + , parseMIMEType , printMIMEType - , mimeTypeP - , mimeTypeListP + , mimeType + , mimeTypeList ) where -import Data.Ascii (Ascii, CIAscii) +import Control.Applicative +import Data.Ascii (Ascii, AsciiBuilder, CIAscii) import qualified Data.Ascii as A -import qualified Data.ByteString.Lazy as B +import Data.Attoparsec.Char8 as P +import Data.Monoid.Unicode +import Data.Typeable +import Language.Haskell.TH.Syntax +import Network.HTTP.Lucu.MIMEParams +import Network.HTTP.Lucu.Parser import Network.HTTP.Lucu.Parser.Http import Network.HTTP.Lucu.Utils -import Prelude hiding (min) +import Prelude.Unicode --- |@'MIMEType' \"major\" \"minor\" [(\"name\", \"value\")]@ --- represents \"major\/minor; name=value\". -data MIMEType = MIMEType { - mtMajor :: !CIAscii - , mtMinor :: !CIAscii - , mtParams :: ![ (CIAscii, Ascii) ] - } deriving (Eq, Show) +-- |A media type, subtype, and parameters. +data MIMEType + = MIMEType { + mtMedia ∷ !CIAscii + , mtSub ∷ !CIAscii + , mtParams ∷ !MIMEParams + } + deriving (Eq, Show, Read, Typeable) --- |Convert a 'MIMEType' to 'Ascii'. -printMIMEType ∷ MIMEType → Ascii -printMIMEType (MIMEType maj min params) - = A.fromAsciiBuilder $ - ( A.toAsciiBuilder maj ⊕ - A.toAsciiBuilder "/" ⊕ - A.toAsciiBuilder min ⊕ - if null params then - (∅) - else - A.toAsciiBuilder "; " ⊕ - joinWith "; " (map printPair params) - ) - where - printPair ∷ (CIAscii, Ascii) → A.AsciiBuilder - printPair (name, value) - = A.toAsciiBuilder (A.fromCIAscii name) ⊕ - A.toAsciiBuilder "=" ⊕ - if any ((¬) ∘ isToken) value then - quoteStr value - else - A.toAsciiBuilder value +instance Lift MIMEType where + lift (MIMEType {..}) + = [| MIMEType { + mtMedia = $(liftCIAscii mtMedia) + , mtSub = $(liftCIAscii mtSub) + , mtParams = $(lift mtParams) + } + |] --- |Parse 'MIMEType' from a 'Prelude.String'. This function throws an --- exception for parse error. -parseMIMEType :: String -> MIMEType -parseMIMEType str = case parseStr mimeTypeP str of - (# Success t, r #) -> if B.null r - then t - else error ("unparsable MIME Type: " ++ str) - (# _ , _ #) -> error ("unparsable MIME Type: " ++ str) +-- |Convert a 'MIMEType' to an 'AsciiBuilder'. +printMIMEType ∷ MIMEType → AsciiBuilder +{-# INLINEABLE printMIMEType #-} +printMIMEType (MIMEType {..}) + = A.toAsciiBuilder (A.fromCIAscii mtMedia) ⊕ + A.toAsciiBuilder "/" ⊕ + A.toAsciiBuilder (A.fromCIAscii mtSub) ⊕ + printMIMEParams mtParams +-- |Parse 'MIMEType' from an 'Ascii'. This function throws an +-- exception for parse error. For literals consider using +-- 'Network.HTTP.Lucu.MIMEType.TH.mimeType'. +parseMIMEType ∷ Ascii → MIMEType +{-# INLINEABLE parseMIMEType #-} +parseMIMEType str + = case parseOnly (finishOff mimeType) $ A.toByteString str of + Right t → t + Left err → error ("unparsable MIME Type: " ⧺ A.toString str ⧺ ": " ⧺ err) -mimeTypeP :: Parser MIMEType -mimeTypeP = allowEOF $! - do maj <- token - _ <- char '/' - min <- token - params <- many paramP - return $ MIMEType maj min params - where - paramP :: Parser (String, String) - paramP = do _ <- many lws - _ <- char ';' - _ <- many lws - name <- token - _ <- char '=' - value <- token <|> quotedStr - return (name, value) +-- |'Parser' for an 'MIMEType'. +mimeType ∷ Parser MIMEType +{-# INLINEABLE mimeType #-} +mimeType = do media ← A.toCIAscii <$> token + _ ← char '/' + sub ← A.toCIAscii <$> token + params ← mimeParams + return $ MIMEType media sub params -mimeTypeListP :: Parser [MIMEType] -mimeTypeListP = allowEOF $! listOf mimeTypeP +-- |'Parser' for a list of 'MIMEType's. +mimeTypeList ∷ Parser [MIMEType] +{-# INLINE mimeTypeList #-} +mimeTypeList = listOf mimeType