X-Git-Url: http://git.cielonegro.org/gitweb.cgi?p=Lucu.git;a=blobdiff_plain;f=Network%2FHTTP%2FLucu%2FMIMEType.hs;h=768b4cf53d3227c1ff1fde966755acfa23eef780;hp=93b8f1ff38d7aeed4f388432ee5cc8463bb68166;hb=90fca0675b1694e69b8e431c989343855cbd125d;hpb=175e14b3b144537644e65ca76f1fca5c56fd44e9 diff --git a/Network/HTTP/Lucu/MIMEType.hs b/Network/HTTP/Lucu/MIMEType.hs index 93b8f1f..768b4cf 100644 --- a/Network/HTTP/Lucu/MIMEType.hs +++ b/Network/HTTP/Lucu/MIMEType.hs @@ -1,85 +1,121 @@ --- #prune - --- |Manipulation of MIME Types. +{-# LANGUAGE + DeriveDataTypeable + , FlexibleInstances + , MultiParamTypeClasses + , OverloadedStrings + , RecordWildCards + , TemplateHaskell + , TypeSynonymInstances + , UnicodeSyntax + , ViewPatterns + #-} +-- |Parsing and printing MIME Media Types +-- (). module Network.HTTP.Lucu.MIMEType ( MIMEType(..) - , () - , (<:>) - , (<=>) - , mimeTypeP - , mimeTypeListP + , mimeType ) where +import Control.Applicative +import Control.Monad.Unicode +import Data.Ascii (Ascii, AsciiBuilder, CIAscii) +import Data.Attempt +import Data.Attoparsec.Char8 +import Data.Convertible.Base +import Data.Convertible.Instances.Ascii () +import Data.Convertible.Utils +import Data.Default +import Data.Monoid.Unicode +import Data.Typeable +import Language.Haskell.TH.Syntax +import Language.Haskell.TH.Quote +import Network.HTTP.Lucu.MIMEParams +import Network.HTTP.Lucu.OrphanInstances () +import Network.HTTP.Lucu.Parser +import Network.HTTP.Lucu.Parser.Http +import Network.HTTP.Lucu.Utils +import Prelude.Unicode -import Network.HTTP.Lucu.Parser -import Network.HTTP.Lucu.Parser.Http -import Network.HTTP.Lucu.Utils - --- |@'MIMEType' \"major\" \"minor\" [(\"name\", \"value\")]@ --- represents \"major\/minor; name=value\". -data MIMEType = MIMEType { - mtMajor :: String - , mtMinor :: String - , mtParams :: [ (String, String) ] - } deriving (Eq) - +-- |A media type, subtype, and parameters. +data MIMEType + = MIMEType { + mtMedia ∷ !CIAscii + , mtSub ∷ !CIAscii + , mtParams ∷ !MIMEParams + } + deriving (Eq, Show, Read, Typeable) -instance Show MIMEType where - show (MIMEType maj min params) - = maj ++ "/" ++ min ++ - if null params then - "" - else - "; " ++ joinWith "; " (map showPair params) - where - showPair :: (String, String) -> String - showPair (name, value) - = name ++ "=" ++ if any (not . isToken) value then - quoteStr value - else - value +instance Lift MIMEType where + lift (MIMEType {..}) + = [| MIMEType { + mtMedia = $(lift mtMedia ) + , mtSub = $(lift mtSub ) + , mtParams = $(lift mtParams) + } + |] +instance ConvertSuccess MIMEType Ascii where + {-# INLINE convertSuccess #-} + convertSuccess = convertSuccessVia ((⊥) ∷ AsciiBuilder) -infix 9 , <=> -infixl 8 <:> +instance ConvertSuccess MIMEType AsciiBuilder where + {-# INLINEABLE convertSuccess #-} + convertSuccess (MIMEType {..}) + = cs mtMedia ⊕ + cs ("/" ∷ Ascii) ⊕ + cs mtSub ⊕ + cs mtParams --- |@\"major\" \<\/\> \"minor\"@ constructs a MIME Type --- \"major\/minor\". -() :: String -> String -> MIMEType -maj min - = MIMEType maj min [] +deriveAttempts [ ([t| MIMEType |], [t| Ascii |]) + , ([t| MIMEType |], [t| AsciiBuilder |]) + ] --- |\<\:\> appends a @(name, value)@ pair to a MIME Type. -(<:>) :: MIMEType -> (String, String) -> MIMEType -mt@(MIMEType _ _ params) <:> pair - = mt { - mtParams = mtParams mt ++ [pair] - } +-- |Parse 'MIMEType' from an 'Ascii'. For MIME type literals, consider +-- using 'mimeType' quasi-quoter. +instance ConvertAttempt Ascii MIMEType where + {-# INLINEABLE convertAttempt #-} + convertAttempt str + = case parseOnly (finishOff def) (cs str) of + Right t → return t + Left err → fail ("Unparsable MIME Type: " ⧺ cs str ⧺ ": " ⧺ err) --- |\<\=\> takes two strings and makes a tuple of them. So you can say --- @\"text\" \<\/\> \"xml\" \<\:\> \"charset\" \<\=\> \"UTF-8\" \<\:\> --- \"q\" \<\=\> \"0.9\"@ to represent \"text\/xml; charset=UTF-8; --- q=0.9\". -(<=>) :: String -> String -> (String, String) -name <=> value = (name, value) +instance Default (Parser MIMEType) where + {-# INLINEABLE def #-} + def = do media ← cs <$> token + _ ← char '/' + sub ← cs <$> token + params ← def + return $ MIMEType media sub params +instance Default (Parser [MIMEType]) where + {-# INLINE def #-} + def = listOf def -mimeTypeP :: Parser MIMEType -mimeTypeP = allowEOF $ - do maj <- token - char '/' - min <- token - params <- many paramP - return $ MIMEType maj min params +-- |'QuasiQuoter' for 'MIMEType' literals. +-- +-- @ +-- textPlain :: 'MIMEType' +-- textPlain = ['mimeType'| text/plain; charset=\"UTF-8\" |] +-- @ +mimeType ∷ QuasiQuoter +mimeType = QuasiQuoter { + quoteExp = (lift =≪) ∘ (parseType =≪) ∘ toAscii + , quotePat = const unsupported + , quoteType = const unsupported + , quoteDec = const unsupported + } where - paramP :: Parser (String, String) - paramP = do many lws - char ';' - many lws - name <- token - char '=' - value <- token <|> quotedStr - return (name, value) + parseType ∷ Monad m ⇒ Ascii → m MIMEType + parseType a + = case ca a of + Success t → return t + Failure e → fail (show e) + + toAscii ∷ Monad m ⇒ String → m Ascii + toAscii (trim → s) + = case ca s of + Success a → return a + Failure e → fail (show e) -mimeTypeListP :: Parser [MIMEType] -mimeTypeListP = allowEOF $ listOf mimeTypeP + unsupported ∷ Monad m ⇒ m α + unsupported = fail "Unsupported usage of mimeType quasi-quoter."