Debian Codegraph @

src/Network/HTTP/Media/Charset/Internal.hs

raw
1 -- | Defines the 'Charset' accept header with an 'Accept' instance for use in
2 -- language negotiation.
3 module Network.HTTP.Media.Charset.Internal
4 ( Charset (..),
5 )
6 where
7
8 import Control.Monad (guard)
9 import Data.ByteString (ByteString)
10 import qualified Data.ByteString.Char8 as BS
11 import Data.CaseInsensitive (CI, original)
12 import qualified Data.CaseInsensitive as CI
13 import Data.Maybe (fromMaybe)
14 import Data.String (IsString (..))
15 import Network.HTTP.Media.Accept (Accept (..))
16 import Network.HTTP.Media.RenderHeader (RenderHeader (..))
17 import Network.HTTP.Media.Utils (isValidToken)
18
19 -- | Suitable for HTTP charset as defined in
20 -- <https://tools.ietf.org/html/rfc7231#section-5.3.3 RFC7231>.
21 --
22 -- Specifically:
23 --
24 -- > charset = token / "*"
25 newtype Charset = Charset (CI ByteString)
26 deriving (Eq, Ord)
27
28 instance Show Charset where
29 show = BS.unpack . renderHeader
30
31 instance IsString Charset where
32 fromString str =
33 flip fromMaybe (parseAccept $ BS.pack str) $
34 error $
35 "Invalid encoding literal " ++ str
36
37 instance Accept Charset where
38 parseAccept bs = do
39 guard $ isValidToken bs
40 return $ Charset (CI.mk bs)
41
42 matches _ (Charset "*") = True
43 matches a b = a == b
44
45 moreSpecificThan _ (Charset "*") = True
46 moreSpecificThan _ _ = False
47
48 instance RenderHeader Charset where
49 renderHeader (Charset e) = original e