X-Git-Url: http://git.cielonegro.org/gitweb.cgi?p=Lucu.git;a=blobdiff_plain;f=Network%2FHTTP%2FLucu%2FMIMEType.hs;h=d60b70e5d5f21d4704ee6bb269f271692d35e58e;hp=4128f53b91c3d58fbd560af850c8a6ae16b8f29d;hb=b1fac0a;hpb=65a16e9330e797303a5cf8143dcbe135812d526f diff --git a/Network/HTTP/Lucu/MIMEType.hs b/Network/HTTP/Lucu/MIMEType.hs index 4128f53..d60b70e 100644 --- a/Network/HTTP/Lucu/MIMEType.hs +++ b/Network/HTTP/Lucu/MIMEType.hs @@ -1,91 +1,82 @@ {-# LANGUAGE - OverloadedStrings + 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 Control.Applicative -import Data.Ascii (Ascii, CIAscii) +import Data.Ascii (Ascii, AsciiBuilder, CIAscii) import qualified Data.Ascii as A import Data.Attoparsec.Char8 as P -import qualified Data.ByteString.Char8 as C8 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 (A.fromCIAscii maj) ⊕ - A.toAsciiBuilder "/" ⊕ - A.toAsciiBuilder (A.fromCIAscii 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 C8.any ((¬) ∘ isToken) (A.toByteString value) then - quoteStr value - else - A.toAsciiBuilder value +instance Lift MIMEType where + lift (MIMEType {..}) + = [| MIMEType { + mtMedia = $(liftCIAscii mtMedia) + , mtSub = $(liftCIAscii mtSub) + , mtParams = $(lift mtParams) + } + |] + +-- |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. +-- exception for parse error. For literals consider using +-- 'Network.HTTP.Lucu.MIMEType.TH.mimeType'. parseMIMEType ∷ Ascii → MIMEType +{-# INLINEABLE parseMIMEType #-} parseMIMEType str - = let p = do t ← mimeTypeP - endOfInput - return t - bs = A.toByteString str - in - case parseOnly p bs of - Right t → t - Left err → error ("unparsable MIME Type: " ⧺ C8.unpack bs ⧺ ": " ⧺ err) + = 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 = try $ - do maj ← A.toCIAscii <$> token - _ ← char '/' - min ← A.toCIAscii <$> token - params ← P.many paramP - return $ MIMEType maj min params - where - paramP ∷ Parser (CIAscii, Ascii) - paramP = try $ - do skipMany lws - _ ← char ';' - skipMany lws - name ← A.toCIAscii <$> 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 = listOf mimeTypeP +-- |'Parser' for a list of 'MIMEType's. +mimeTypeList ∷ Parser [MIMEType] +{-# INLINE mimeTypeList #-} +mimeTypeList = listOf mimeType