@@ -5,9 +5,7 @@
5{-# LANGUAGE DeriveFunctor #-}
5{-# LANGUAGE DeriveFunctor #-}
6{-# LANGUAGE DeriveTraversable #-}
6{-# LANGUAGE DeriveTraversable #-}
7{-# LANGUAGE FlexibleInstances #-}
7{-# LANGUAGE FlexibleInstances #-}
8−{-# LANGUAGE KindSignatures #-}
9{-# LANGUAGE OverloadedStrings #-}
8{-# LANGUAGE OverloadedStrings #-}
10−{-# LANGUAGE PolyKinds #-}
11{-# LANGUAGE ScopedTypeVariables #-}
9{-# LANGUAGE ScopedTypeVariables #-}
12{-# LANGUAGE TypeSynonymInstances #-}
10{-# LANGUAGE TypeSynonymInstances #-}
@@ -15,72 +13,65 @@
15-- such as URL pieces, headers and query parameters.
13-- such as URL pieces, headers and query parameters.
16module Web.Internal.HttpApiData where
14module Web.Internal.HttpApiData where
18−import Prelude ()
16+#if __GLASGOW_HASKELL__ < 710
19−import Prelude.Compat
17+import Control.Applicative
18+import Data.Foldable (Foldable)
19+import Data.Traversable (Traversable (traverse))
21−import Control.Applicative (Const(Const))
22import Control.Arrow (left, (&&&))
22import Control.Arrow (left, (&&&))
23import Control.Monad ((<=<))
23import Control.Monad ((<=<))
24−import qualified Data.Attoparsec.Text as Atto
24+
25−import qualified Data.Attoparsec.Time as Atto
26import Data.ByteString (ByteString)
25import Data.ByteString (ByteString)
27import qualified Data.ByteString as BS
26import qualified Data.ByteString as BS
28−import qualified Data.ByteString.Builder as BS
27+import Data.Monoid
29−import qualified Data.ByteString.Lazy as LBS
28+
30−import Data.Coerce (coerce)
31−import Data.Data (Data)
32import qualified Data.Fixed as F
29import qualified Data.Fixed as F
33−import Data.Functor.Identity (Identity(Identity))
30+import Data.Int
34−import Data.Int (Int16, Int32, Int64, Int8)
35−import Data.Kind (Type)
36−import qualified Data.Map as Map
37−import Data.Monoid (All (..), Any (..), Dual (..),
31+import Data.Word
38− First (..), Last (..),
32+
39− Product (..), Sum (..))
40−import Data.Semigroup (Semigroup (..))
41−import qualified Data.Semigroup as Semi
42−import Data.Tagged (Tagged (..))
43import Data.Text (Text)
33import Data.Text (Text)
44import qualified Data.Text as T
34import qualified Data.Text as T
45−import Data.Text.Encoding (decodeUtf8', decodeUtf8With,
35+import Data.Text.Encoding (decodeUtf8', encodeUtf8)
47−import Data.Text.Encoding.Error (lenientDecode)
48import qualified Data.Text.Lazy as L
36import qualified Data.Text.Lazy as L
49import Data.Text.Read (Reader, decimal, rational,
37import Data.Text.Read (Reader, decimal, rational,
51−import Data.Time.Compat (Day, FormatTime, LocalTime,
40+import Data.Time
52− NominalDiffTime, TimeOfDay,
41+#if __GLASGOW_HASKELL__ < 710
53− UTCTime, ZonedTime, formatTime,
55− nominalDiffTimeToSeconds,
56− secondsToNominalDiffTime)
57−import Data.Time.Format.Compat (defaultTimeLocale,
42+import Data.Time.Locale.Compat
58− iso8601DateFormat)
43+#endif
59−import Data.Time.Calendar.Month.Compat (Month)
44+import Data.Version
60−import Data.Time.Calendar.Quarter.Compat (Quarter, QuarterOfYear (..),
45+
61− toYearQuarter)
46+#if MIN_VERSION_base(4,8,0)
62−import Data.Typeable (Typeable)
63−import qualified Data.UUID.Types as UUID
64−import Data.Version (Version, parseVersion,
66−import Data.Void (Void, absurd)
47+import Data.Void
67−import Data.Word (Word16, Word32, Word64, Word8)
68−import qualified Network.HTTP.Types as H
69−import Numeric.Natural (Natural)
48+import Numeric.Natural
70import Text.ParserCombinators.ReadP (readP_to_S)
51import Text.ParserCombinators.ReadP (readP_to_S)
71import Text.Read (readMaybe)
52import Text.Read (readMaybe)
72−import Web.Cookie (SetCookie, parseSetCookie,
75#if USE_TEXT_SHOW
54#if USE_TEXT_SHOW
76import TextShow (TextShow, showt)
55import TextShow (TextShow, showt)
58+import qualified Data.UUID.Types as UUID
60+import qualified Data.ByteString.Builder as BS
61+import Data.Data (Data)
62+import Data.Typeable (Typeable)
63+import qualified Network.HTTP.Types as H
65+import qualified Data.Attoparsec.Text as Atto
66+import qualified Data.Attoparsec.Time as Atto
68+import Web.Cookie (SetCookie, parseSetCookie,
80-- >>> data BasicAuthToken = BasicAuthToken Text deriving (Show)
73-- >>> data BasicAuthToken = BasicAuthToken Text deriving (Show)
81-- >>> instance FromHttpApiData BasicAuthToken where parseHeader h = BasicAuthToken <$> parseHeaderWithPrefix "Basic " h; parseQueryParam p = BasicAuthToken <$> parseQueryParam p
74-- >>> instance FromHttpApiData BasicAuthToken where parseHeader h = BasicAuthToken <$> parseHeaderWithPrefix "Basic " h; parseQueryParam p = BasicAuthToken <$> parseQueryParam p
82−-- >>> import Data.Time.Compat
83−-- >>> import Data.Version
85-- | Convert value to HTTP API data.
76-- | Convert value to HTTP API data.
@@ -96,7 +87,7 @@ class ToHttpApiData a where
96 -- The default definition uses 'H.encodePathSegmentsRelative',
87 -- The default definition uses 'H.encodePathSegmentsRelative',
97 -- but this may be overriden with a more efficient version.
88 -- but this may be overriden with a more efficient version.
98 toEncodedUrlPiece :: a -> BS.Builder
89 toEncodedUrlPiece :: a -> BS.Builder
99− toEncodedUrlPiece = H.urlEncodeBuilder True . encodeUtf8 . toUrlPiece
90+ toEncodedUrlPiece = H.encodePathSegmentsRelative . (:[]) . toUrlPiece
101 -- | Convert to HTTP header value.
92 -- | Convert to HTTP header value.
102 toHeader :: a -> ByteString
93 toHeader :: a -> ByteString
@@ -338,7 +329,7 @@ lookupBoundedEnumOf f = flip lookup (map (f &&& id) [minBound..maxBound])
338-- >>> parseBoundedEnumOf toUrlPiece "true" :: Either Text Bool
329-- >>> parseBoundedEnumOf toUrlPiece "true" :: Either Text Bool
339-- Right True
330-- Right True
341−-- For case insensitive parser see 'parseBoundedEnumOfI'.
332+-- For case sensitive parser see 'parseBoundedEnumOfI'.
342parseBoundedEnumOf :: (Bounded a, Enum a) => (a -> Text) -> Text -> Either Text a
333parseBoundedEnumOf :: (Bounded a, Enum a) => (a -> Text) -> Text -> Either Text a
343parseBoundedEnumOf = parseMaybeTextData . lookupBoundedEnumOf
334parseBoundedEnumOf = parseMaybeTextData . lookupBoundedEnumOf
@@ -439,8 +430,10 @@ instance ToHttpApiData Version where
439 toUrlPiece = T.pack . showVersion
430 toUrlPiece = T.pack . showVersion
440 toEncodedUrlPiece = unsafeToEncodedUrlPiece
431 toEncodedUrlPiece = unsafeToEncodedUrlPiece
433+#if MIN_VERSION_base(4,8,0)
442instance ToHttpApiData Void where toUrlPiece = absurd
434instance ToHttpApiData Void where toUrlPiece = absurd
443instance ToHttpApiData Natural where toUrlPiece = showt; toEncodedUrlPiece = unsafeToEncodedUrlPiece
435instance ToHttpApiData Natural where toUrlPiece = showt; toEncodedUrlPiece = unsafeToEncodedUrlPiece
445instance ToHttpApiData Bool where toUrlPiece = showTextData; toEncodedUrlPiece = unsafeToEncodedUrlPiece
438instance ToHttpApiData Bool where toUrlPiece = showTextData; toEncodedUrlPiece = unsafeToEncodedUrlPiece
446instance ToHttpApiData Ordering where toUrlPiece = showTextData; toEncodedUrlPiece = unsafeToEncodedUrlPiece
439instance ToHttpApiData Ordering where toUrlPiece = showTextData; toEncodedUrlPiece = unsafeToEncodedUrlPiece
@@ -459,8 +452,7 @@ instance ToHttpApiData Word16 where toUrlPiece = showt; toEncodedUrlPiece = un
459instance ToHttpApiData Word32 where toUrlPiece = showt; toEncodedUrlPiece = unsafeToEncodedUrlPiece
452instance ToHttpApiData Word32 where toUrlPiece = showt; toEncodedUrlPiece = unsafeToEncodedUrlPiece
460instance ToHttpApiData Word64 where toUrlPiece = showt; toEncodedUrlPiece = unsafeToEncodedUrlPiece
453instance ToHttpApiData Word64 where toUrlPiece = showt; toEncodedUrlPiece = unsafeToEncodedUrlPiece
462−-- | Note: this instance is not polykinded
463−instance F.HasResolution a => ToHttpApiData (F.Fixed (a :: Type)) where toUrlPiece = showt; toEncodedUrlPiece = unsafeToEncodedUrlPiece
455+instance F.HasResolution a => ToHttpApiData (F.Fixed a) where toUrlPiece = showt; toEncodedUrlPiece = unsafeToEncodedUrlPiece
466-- >>> toUrlPiece (fromGregorian 2015 10 03)
458-- >>> toUrlPiece (fromGregorian 2015 10 03)
@@ -500,108 +492,36 @@ instance ToHttpApiData UTCTime where
500 toUrlPiece = timeToUrlPiece "%H:%M:%S%QZ"
492 toUrlPiece = timeToUrlPiece "%H:%M:%S%QZ"
501 toEncodedUrlPiece = unsafeToEncodedUrlPiece
493 toEncodedUrlPiece = unsafeToEncodedUrlPiece
504−-- >>> toUrlPiece Monday
506−instance ToHttpApiData DayOfWeek where
507− toUrlPiece Monday = "monday"
508− toUrlPiece Tuesday = "tuesday"
509− toUrlPiece Wednesday = "wednesday"
510− toUrlPiece Thursday = "thursday"
511− toUrlPiece Friday = "friday"
512− toUrlPiece Saturday = "saturday"
513− toUrlPiece Sunday = "sunday"
515− toEncodedUrlPiece = unsafeToEncodedUrlPiece
520−instance ToHttpApiData QuarterOfYear where
521− toUrlPiece Q1 = "q1"
522− toUrlPiece Q2 = "q2"
523− toUrlPiece Q3 = "q3"
524− toUrlPiece Q4 = "q4"
527−-- >>> import Data.Time.Calendar.Quarter.Compat (Quarter (..))
528−-- >>> MkQuarter 8040
531−-- >>> toUrlPiece $ MkQuarter 8040
534−instance ToHttpApiData Quarter where
535− toUrlPiece q = case toYearQuarter q of
536− (y, qoy) -> T.pack (show y ++ "-" ++ f qoy)
544−-- >>> import Data.Time.Calendar.Month.Compat (Month (..))
548−-- >>> toUrlPiece $ MkMonth 24482
551−instance ToHttpApiData Month where
552− toUrlPiece = T.pack . formatTime defaultTimeLocale "%Y-%m"
554instance ToHttpApiData NominalDiffTime where
495instance ToHttpApiData NominalDiffTime where
555− toUrlPiece = toUrlPiece . nominalDiffTimeToSeconds
496+ toUrlPiece = toUrlPiece . (floor :: NominalDiffTime -> Integer)
556 toEncodedUrlPiece = unsafeToEncodedUrlPiece
497 toEncodedUrlPiece = unsafeToEncodedUrlPiece
558instance ToHttpApiData String where toUrlPiece = T.pack
499instance ToHttpApiData String where toUrlPiece = T.pack
559instance ToHttpApiData Text where toUrlPiece = id
500instance ToHttpApiData Text where toUrlPiece = id
560instance ToHttpApiData L.Text where toUrlPiece = L.toStrict
501instance ToHttpApiData L.Text where toUrlPiece = L.toStrict
562−instance ToHttpApiData All where
503+instance ToHttpApiData All where toUrlPiece = toUrlPiece . getAll; toEncodedUrlPiece = toEncodedUrlPiece . getAll
563− toUrlPiece = coerce (toUrlPiece :: Bool -> Text)
564− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: Bool -> BS.Builder)
566−instance ToHttpApiData Any where
504+instance ToHttpApiData Any where toUrlPiece = toUrlPiece . getAny; toEncodedUrlPiece = toEncodedUrlPiece . getAny
567− toUrlPiece = coerce (toUrlPiece :: Bool -> Text)
568− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: Bool -> BS.Builder)
570instance ToHttpApiData a => ToHttpApiData (Dual a) where
506instance ToHttpApiData a => ToHttpApiData (Dual a) where
571− toUrlPiece = coerce (toUrlPiece :: a -> Text)
507+ toUrlPiece = toUrlPiece . getDual
572− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: a -> BS.Builder)
508+ toEncodedUrlPiece = toEncodedUrlPiece . getDual
574instance ToHttpApiData a => ToHttpApiData (Sum a) where
510instance ToHttpApiData a => ToHttpApiData (Sum a) where
575− toUrlPiece = coerce (toUrlPiece :: a -> Text)
511+ toUrlPiece = toUrlPiece . getSum
576− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: a -> BS.Builder)
512+ toEncodedUrlPiece = toEncodedUrlPiece . getSum
578instance ToHttpApiData a => ToHttpApiData (Product a) where
514instance ToHttpApiData a => ToHttpApiData (Product a) where
579− toUrlPiece = coerce (toUrlPiece :: a -> Text)
515+ toUrlPiece = toUrlPiece . getProduct
580− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: a -> BS.Builder)
516+ toEncodedUrlPiece = toEncodedUrlPiece . getProduct
582instance ToHttpApiData a => ToHttpApiData (First a) where
518instance ToHttpApiData a => ToHttpApiData (First a) where
583− toUrlPiece = coerce (toUrlPiece :: Maybe a -> Text)
519+ toUrlPiece = toUrlPiece . getFirst
584− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: Maybe a -> BS.Builder)
520+ toEncodedUrlPiece = toEncodedUrlPiece . getFirst
586instance ToHttpApiData a => ToHttpApiData (Last a) where
522instance ToHttpApiData a => ToHttpApiData (Last a) where
587− toUrlPiece = coerce (toUrlPiece :: Maybe a -> Text)
523+ toUrlPiece = toUrlPiece . getLast
588− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: Maybe a -> BS.Builder)
590−instance ToHttpApiData a => ToHttpApiData (Semi.Min a) where
591− toUrlPiece = coerce (toUrlPiece :: a -> Text)
592− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: a -> BS.Builder)
594−instance ToHttpApiData a => ToHttpApiData (Semi.Max a) where
595− toUrlPiece = coerce (toUrlPiece :: a -> Text)
596− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: a -> BS.Builder)
524+ toEncodedUrlPiece = toEncodedUrlPiece . getLast
598−instance ToHttpApiData a => ToHttpApiData (Semi.First a) where
599− toUrlPiece = coerce (toUrlPiece :: a -> Text)
600− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: a -> BS.Builder)
602−instance ToHttpApiData a => ToHttpApiData (Semi.Last a) where
603− toUrlPiece = coerce (toUrlPiece :: a -> Text)
604− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: a -> BS.Builder)
607-- >>> toUrlPiece (Just "Hello")
527-- >>> toUrlPiece (Just "Hello")
@@ -619,40 +539,13 @@ instance (ToHttpApiData a, ToHttpApiData b) => ToHttpApiData (Either a b) where
619 toUrlPiece (Left x) = "left " <> toUrlPiece x
539 toUrlPiece (Left x) = "left " <> toUrlPiece x
620 toUrlPiece (Right x) = "right " <> toUrlPiece x
540 toUrlPiece (Right x) = "right " <> toUrlPiece x
622−-- | /Note:/ this instance works correctly for alphanumeric name and value
542+-- |
624-- >>> let Right c = parseUrlPiece "SESSID=r2t5uvjq435r4q7ib3vtdjq120" :: Either Text SetCookie
543-- >>> let Right c = parseUrlPiece "SESSID=r2t5uvjq435r4q7ib3vtdjq120" :: Either Text SetCookie
625-- >>> toUrlPiece c
544-- >>> toUrlPiece c
626−-- "SESSID=r2t5uvjq435r4q7ib3vtdjq120"
545+-- "\"SESSID=r2t5uvjq435r4q7ib3vtdjq120\""
629−-- "SESSID=r2t5uvjq435r4q7ib3vtdjq120"
631instance ToHttpApiData SetCookie where
546instance ToHttpApiData SetCookie where
632− toUrlPiece = decodeUtf8With lenientDecode . toHeader
633− toHeader = LBS.toStrict . BS.toLazyByteString . renderSetCookie
547+ toUrlPiece = showt . BS.toLazyByteString . renderSetCookie
634− -- toEncodedUrlPiece = renderSetCookie -- doesn't do things.
548+ toEncodedUrlPiece = renderSetCookie
636−-- | Note: this instance is not polykinded
637−instance ToHttpApiData a => ToHttpApiData (Tagged (b :: Type) a) where
638− toUrlPiece = coerce (toUrlPiece :: a -> Text)
639− toHeader = coerce (toHeader :: a -> ByteString)
640− toQueryParam = coerce (toQueryParam :: a -> Text)
641− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: a -> BS.Builder)
644−instance ToHttpApiData a => ToHttpApiData (Const a b) where
645− toUrlPiece = coerce (toUrlPiece :: a -> Text)
646− toHeader = coerce (toHeader :: a -> ByteString)
647− toQueryParam = coerce (toQueryParam :: a -> Text)
648− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: a -> BS.Builder)
651−instance ToHttpApiData a => ToHttpApiData (Identity a) where
652− toUrlPiece = coerce (toUrlPiece :: a -> Text)
653− toHeader = coerce (toHeader :: a -> ByteString)
654− toQueryParam = coerce (toQueryParam :: a -> Text)
655− toEncodedUrlPiece = coerce (toEncodedUrlPiece :: a -> BS.Builder)
658-- >>> parseUrlPiece "_" :: Either Text ()
551-- >>> parseUrlPiece "_" :: Either Text ()
@@ -665,7 +558,7 @@ instance FromHttpApiData Char where
665 parseUrlPiece s =
558 parseUrlPiece s =
666 case T.uncons s of
559 case T.uncons s of
667 Just (c, s') | T.null s' -> pure c
560 Just (c, s') | T.null s' -> pure c
668− _ -> defaultParseError s
561+ _ -> defaultParseError s
671-- >>> showVersion <$> parseUrlPiece "1.2.3"
564-- >>> showVersion <$> parseUrlPiece "1.2.3"
@@ -676,6 +569,7 @@ instance FromHttpApiData Version where
676 ((x, ""):_) -> pure x
569 ((x, ""):_) -> pure x
677 _ -> defaultParseError s
570 _ -> defaultParseError s
572+#if MIN_VERSION_base(4,8,0)
679-- | Parsing a @'Void'@ value is always an error, considering @'Void'@ as a data type with no constructors.
573-- | Parsing a @'Void'@ value is always an error, considering @'Void'@ as a data type with no constructors.
680instance FromHttpApiData Void where
574instance FromHttpApiData Void where
681 parseUrlPiece _ = Left "Void cannot be parsed!"
575 parseUrlPiece _ = Left "Void cannot be parsed!"
@@ -686,6 +580,7 @@ instance FromHttpApiData Natural where
687 then Left ("underflow: " <> s <> " (should be a non-negative integer)")
581 then Left ("underflow: " <> s <> " (should be a non-negative integer)")
688 else Right (fromInteger n)
582 else Right (fromInteger n)
690instance FromHttpApiData Bool where parseUrlPiece = parseBoundedUrlPiece
585instance FromHttpApiData Bool where parseUrlPiece = parseBoundedUrlPiece
691instance FromHttpApiData Ordering where parseUrlPiece = parseBoundedUrlPiece
586instance FromHttpApiData Ordering where parseUrlPiece = parseBoundedUrlPiece
@@ -706,10 +601,6 @@ instance FromHttpApiData String where parseUrlPiece = Right . T.unpack
706instance FromHttpApiData Text where parseUrlPiece = Right
601instance FromHttpApiData Text where parseUrlPiece = Right
707instance FromHttpApiData L.Text where parseUrlPiece = Right . L.fromStrict
602instance FromHttpApiData L.Text where parseUrlPiece = Right . L.fromStrict
709−-- | Note: this instance is not polykinded
710−instance F.HasResolution a => FromHttpApiData (F.Fixed (a :: Type)) where
711− parseUrlPiece = runReader rational
714-- >>> toGregorian <$> parseUrlPiece "2016-12-01"
605-- >>> toGregorian <$> parseUrlPiece "2016-12-01"
715-- Right (2016,12,1)
606-- Right (2016,12,1)
@@ -738,57 +629,16 @@ instance FromHttpApiData ZonedTime where parseUrlPiece = runAtto Atto.zonedTime
738-- Right 2015-10-03 00:14:24 UTC
629-- Right 2015-10-03 00:14:24 UTC
739instance FromHttpApiData UTCTime where parseUrlPiece = runAtto Atto.utcTime
630instance FromHttpApiData UTCTime where parseUrlPiece = runAtto Atto.utcTime
742−-- >>> parseUrlPiece "Monday" :: Either Text DayOfWeek
744−instance FromHttpApiData DayOfWeek where
745− parseUrlPiece t = case Map.lookup (T.toLower t) m of
746− Just dow -> Right dow
747− Nothing -> Left $ "Incorrect DayOfWeek: " <> T.take 10 t
749− m :: Map.Map Text DayOfWeek
750− m = Map.fromList [ (toUrlPiece dow, dow) | dow <- [Monday .. Sunday] ]
753−instance FromHttpApiData NominalDiffTime where parseUrlPiece = fmap secondsToNominalDiffTime . parseUrlPiece
632+instance FromHttpApiData NominalDiffTime where parseUrlPiece = fmap fromInteger . parseUrlPiece
756−-- >>> parseUrlPiece "2021-01" :: Either Text Month
758−instance FromHttpApiData Month where parseUrlPiece = runAtto Atto.month
760−-- |
634+instance FromHttpApiData All where parseUrlPiece = fmap All . parseUrlPiece
761−-- >>> parseUrlPiece "2021-q1" :: Either Text Quarter
763−instance FromHttpApiData Quarter where parseUrlPiece = runAtto Atto.quarter
635+instance FromHttpApiData Any where parseUrlPiece = fmap Any . parseUrlPiece
766−-- >>> parseUrlPiece "q2" :: Either Text QuarterOfYear
769−-- >>> parseUrlPiece "Q3" :: Either Text QuarterOfYear
771−instance FromHttpApiData QuarterOfYear where
772− parseUrlPiece t = case T.toLower t of
777− _ -> Left "Invalid quarter of year"
779−instance FromHttpApiData All where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text Bool)
780−instance FromHttpApiData Any where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text Bool)
782−instance FromHttpApiData a => FromHttpApiData (Dual a) where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text a)
637+instance FromHttpApiData a => FromHttpApiData (Dual a) where parseUrlPiece = fmap Dual . parseUrlPiece
783−instance FromHttpApiData a => FromHttpApiData (Sum a) where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text a)
638+instance FromHttpApiData a => FromHttpApiData (Sum a) where parseUrlPiece = fmap Sum . parseUrlPiece
784−instance FromHttpApiData a => FromHttpApiData (Product a) where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text a)
639+instance FromHttpApiData a => FromHttpApiData (Product a) where parseUrlPiece = fmap Product . parseUrlPiece
785−instance FromHttpApiData a => FromHttpApiData (First a) where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text (Maybe a))
640+instance FromHttpApiData a => FromHttpApiData (First a) where parseUrlPiece = fmap First . parseUrlPiece
786−instance FromHttpApiData a => FromHttpApiData (Last a) where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text (Maybe a))
788−instance FromHttpApiData a => FromHttpApiData (Semi.Min a) where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text a)
789−instance FromHttpApiData a => FromHttpApiData (Semi.Max a) where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text a)
641+instance FromHttpApiData a => FromHttpApiData (Last a) where parseUrlPiece = fmap Last . parseUrlPiece
790−instance FromHttpApiData a => FromHttpApiData (Semi.First a) where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text a)
791−instance FromHttpApiData a => FromHttpApiData (Semi.Last a) where parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text a)
794-- >>> parseUrlPiece "Just 123" :: Either Text (Maybe Int)
644-- >>> parseUrlPiece "Just 123" :: Either Text (Maybe Int)
@@ -831,32 +681,12 @@ instance FromHttpApiData a => FromHttpApiData (LenientData a) where
831 parseHeader = Right . LenientData . parseHeader
681 parseHeader = Right . LenientData . parseHeader
832 parseQueryParam = Right . LenientData . parseQueryParam
682 parseQueryParam = Right . LenientData . parseQueryParam
834−-- | /Note:/ this instance works correctly for alphanumeric name and value
684+-- |
836-- >>> parseUrlPiece "SESSID=r2t5uvjq435r4q7ib3vtdjq120" :: Either Text SetCookie
685-- >>> parseUrlPiece "SESSID=r2t5uvjq435r4q7ib3vtdjq120" :: Either Text SetCookie
837-- Right (SetCookie {setCookieName = "SESSID", setCookieValue = "r2t5uvjq435r4q7ib3vtdjq120", setCookiePath = Nothing, setCookieExpires = Nothing, setCookieMaxAge = Nothing, setCookieDomain = Nothing, setCookieHttpOnly = False, setCookieSecure = False, setCookieSameSite = Nothing})
686-- Right (SetCookie {setCookieName = "SESSID", setCookieValue = "r2t5uvjq435r4q7ib3vtdjq120", setCookiePath = Nothing, setCookieExpires = Nothing, setCookieMaxAge = Nothing, setCookieDomain = Nothing, setCookieHttpOnly = False, setCookieSecure = False, setCookieSameSite = Nothing})
838instance FromHttpApiData SetCookie where
687instance FromHttpApiData SetCookie where
839 parseUrlPiece = parseHeader . encodeUtf8
688 parseUrlPiece = parseHeader . encodeUtf8
840 parseHeader = Right . parseSetCookie
689 parseHeader = Right . parseSetCookie
842−-- | Note: this instance is not polykinded
843−instance FromHttpApiData a => FromHttpApiData (Tagged (b :: Type) a) where
844− parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text a)
845− parseHeader = coerce (parseHeader :: ByteString -> Either Text a)
846− parseQueryParam = coerce (parseQueryParam :: Text -> Either Text a)
849−instance FromHttpApiData a => FromHttpApiData (Const a b) where
850− parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text a)
851− parseHeader = coerce (parseHeader :: ByteString -> Either Text a)
852− parseQueryParam = coerce (parseQueryParam :: Text -> Either Text a)
855−instance FromHttpApiData a => FromHttpApiData (Identity a) where
856− parseUrlPiece = coerce (parseUrlPiece :: Text -> Either Text a)
857− parseHeader = coerce (parseHeader :: ByteString -> Either Text a)
858− parseQueryParam = coerce (parseQueryParam :: Text -> Either Text a)
860-------------------------------------------------------------------------------
690-------------------------------------------------------------------------------
861-- Attoparsec helpers
691-- Attoparsec helpers
862-------------------------------------------------------------------------------
692-------------------------------------------------------------------------------