]> gitweb @ CieloNegro.org - Lucu.git/blobdiff - Network/HTTP/Lucu/MIMEType.hs
New module: Network.HTTP.Lucu.MIMEType.TH
[Lucu.git] / Network / HTTP / Lucu / MIMEType.hs
index 1aebc9f56b1233b34a75384d6a45db7441125b7c..9c34c50e634cdd1360d26d221ada577c49b64aa2 100644 (file)
@@ -1,9 +1,12 @@
 {-# LANGUAGE
-    OverloadedStrings
+    DeriveDataTypeable
+  , OverloadedStrings
+  , RecordWildCards
+  , TemplateHaskell
   , UnicodeSyntax
   #-}
-
--- |MIME Types
+-- |Parsing and printing MIME Media Types
+-- (<http://tools.ietf.org/html/rfc2046>).
 module Network.HTTP.Lucu.MIMEType
     ( MIMEType(..)
     , mkMIMEType
@@ -19,44 +22,51 @@ import Control.Applicative
 import Data.Ascii (Ascii, AsciiBuilder, CIAscii)
 import qualified Data.Ascii as A
 import Data.Attoparsec.Char8 as P
-import Data.Map (Map)
 import Data.Monoid.Unicode
-import Data.Text (Text)
+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.RFC2231
-import Prelude hiding (min)
+import Network.HTTP.Lucu.Utils
 import Prelude.Unicode
 
--- |@'MIMEType' \"major\" \"minor\" [(\"name\", \"value\"), ...]@
--- represents \"major\/minor; name=value; ...\".
-data MIMEType = MIMEType {
-      mtMajor  ∷ !CIAscii
-    , mtMinor  ∷ !CIAscii
-    , mtParams ∷ !(Map CIAscii Text)
-    } 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 = A.toString ∘ A.fromAsciiBuilder ∘ printMIMEType
+instance Lift MIMEType where
+    lift (MIMEType {..})
+        = [| MIMEType {
+               mtMedia  = $(liftCIAscii mtMedia)
+             , mtSub    = $(liftCIAscii mtSub)
+             , mtParams = $(lift mtParams)
+             }
+           |]
 
--- |@'mkMIMEType' major minor@ returns a 'MIMEType' with the given
--- @major@ and @minor@ types but without any parameters.
+-- |@'mkMIMEType' media sub@ returns a 'MIMEType' with the given
+-- @media@ and @sub@ types but without any parameters.
 mkMIMEType ∷ CIAscii → CIAscii → MIMEType
 {-# INLINE mkMIMEType #-}
-mkMIMEType maj min
-    = MIMEType maj min (∅)
+mkMIMEType = flip flip (∅) ∘ MIMEType
 
 -- |Convert a 'MIMEType' to an 'AsciiBuilder'.
 printMIMEType ∷ MIMEType → AsciiBuilder
 {-# INLINEABLE printMIMEType #-}
-printMIMEType (MIMEType maj min params)
-    = A.toAsciiBuilder (A.fromCIAscii maj) ⊕
+printMIMEType (MIMEType {..})
+    = A.toAsciiBuilder (A.fromCIAscii mtMedia) ⊕
       A.toAsciiBuilder "/" ⊕
-      A.toAsciiBuilder (A.fromCIAscii min) ⊕
-      printMIMEParams params
+      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
@@ -67,11 +77,11 @@ parseMIMEType str
 -- |'Parser' for an 'MIMEType'.
 mimeType ∷ Parser MIMEType
 {-# INLINEABLE mimeType #-}
-mimeType = do maj    ← A.toCIAscii <$> token
+mimeType = do media  ← A.toCIAscii <$> token
               _      ← char '/'
-              min    ← A.toCIAscii <$> token
+              sub    ← A.toCIAscii <$> token
               params ← mimeParams
-              return $ MIMEType maj min params
+              return $ MIMEType media sub params
 
 -- |'Parser' for a list of 'MIMEType's.
 mimeTypeList ∷ Parser [MIMEType]