@@ -0,0 +1,37 @@
1+{-# LANGUAGE DefaultSignatures #-}
2+module Web.HttpApiData (
7+import Data.ByteString (ByteString)
8+import Data.Text (Text)
9+import Data.Text.Encoding (encodeUtf8, decodeUtf8)
11+-- | Convert value to HTTP API data.
12+class ToHttpApiData a where
13+ -- | Convert to URL path piece.
14+ toUrlPiece :: a -> Text
15+ toUrlPiece = toQueryParam
17+ -- | Convert to HTTP header value.
18+ toHeader :: a -> ByteString
19+ toHeader = encodeUtf8 . toUrlPiece
21+ -- | Convert to query param value.
22+ toQueryParam :: a -> Text
23+ toQueryParam = toUrlPiece
25+-- | Convert value from HTTP API data.
26+class FromHttpApiData a where
27+ -- | Parse URL path piece.
28+ parseUrlPiece :: Text -> Either Text a
29+ parseUrlPiece = parseQueryParam
31+ -- | Parse HTTP header value.
32+ parseHeader :: ByteString -> Either Text a
33+ parseHeader = parseUrlPiece . decodeUtf8
35+ -- | Parse query param value.
36+ parseQueryParam :: Text -> Either Text a
37+ parseQueryParam = parseUrlPiece