-
Server-sent events (SSE) for client-side #1811
Implement Server-sent events (SSE) for the Servant client using a new
combinator “ServerSentEvents”. The raw event messages, accumulated events and
JSON-processed events can be exposed.
-
Integrate MultiVerb #1766 #1804
Expose MultiVerb, a more ergonomic way of defining endpoints that return
many kinds of responses. Read the cookbook https://docs.servant.dev/en/master/cookbook/multiverb/MultiVerb.html
-
Add public re-export of renderCurlBasePath lens #1706
-
Remove GHC <= 8.10.7 from the support window #1778
-
Add Servant.API.Range type #1805
-
Add missing HasLink instance for DeepQuery #1784
-
Add Host API combinator #1800
Adding a Host combinator allows servant users to select APIs according
to the Host header provided by clients.
-
Rename ServantError to ClientError, ServantErr to ServerError
#1131
-
servant-client-core Rearrange modules. No more Internal modules, whole
API is versioned.
#1130
-
servant-client-core RequestBody is now
= RequestBodyLBS LBS.ByteString
| RequestBodyBS BS.ByteString
| RequestBodySource (SourceIO LBS.ByteString)
i.e. no more replicates http-clients API.
#1117
-
servant-client-core Keep structured exceptions in ConnectionError
constructor of ClientError
#1115
-| ConnectionError Text
+| ConnectionError SomeException
-
servant-client-core Preserve failing request in FailureResponse
constructor of ClientError
#1114
-FailureResponse Response
+-- | The server returned an error response including the
+-- failing request. 'requestPath' includes the 'BaseUrl' and the
+-- path of the request.
+FailureResponse (RequestF () (BaseUrl, BS.ByteString)) Response
-
servant-client Fix (implement) StreamBody instance
#1110
-
servant-client Update CookieJar with intermediate request/responses (redirects)
#1104
-
Streaming refactoring.
#991
#1076
#1077
The streaming functionality (Servant.API.Stream) is refactored to use
servant’s own SourceIO type (see Servant.Types.SourceT documentation),
which replaces both StreamGenerator and ResultStream types.
New conversion type-classes are ToSourceIO and FromSourceIO
(replacing ToStreamGenerator and BuildFromStream).
There are instances for conduit, pipes and machines in new packages:
servant-conduit
servant-pipes and
servant-machines
respectively.
Writing new framing strategies is simpler. Check existing strategies for examples.
This change shouldn’t affect you, if you don’t use streaming endpoints.
-
servant-client Separate streaming client.
#1066
We now have two http-client based clients,
in Servant.Client and Servant.Client.Streaming.
Their API is the same, except for
Servant.Client cannot request Stream endpoints.Servant.Client is run by direct
runClientM :: ClientM a -> ClientEnv -> IO (Either ServantError a)Servant.Client.Streaming can request Stream endpoints.Servant.Client.Streaming is used by CPSised
withClientM :: ClientM a -> ClientEnv -> (Either ServantError a -> IO b) -> IO b
To access Stream endpoints use Servant.Client.Streaming with
withClientM; otherwise you can continue using Servant.Client with runClientM.
You can use both too, ClientEnv and BaseUrl types are same for both.
Note: Servant.Client.Streaming doesn’t stream non-Stream endpoints.
Requesting ordinary Verb endpoints (e.g. Get) will block until
the whole response is received.
There is Servant.Client.Streaming.runClientM function, but it has
restricted type. NFData a constraint prevents using it with
SourceT, Conduit etc. response types.
runClientM :: NFData a => ClientM a -> ClientEnv -> IO (Either ServantError a)
This change shouldn’t affect you, if you don’t use streaming endpoints.
-
servant-client-core Related to the previous:
streamingResponse is removed from RunClient.
We have a new type-class:
class RunClient m => RunStreamingClient m where
withStreamingRequest :: Request -> (StreamingResponse -> IO a) -> m a
-
Drop support for GHC older than 8.0
#1008
#1009
-
servant-client-core Add NFData (GenResponse a) and NFData ServantError instances.
#1076
-
servant-client-core Add aeson and Lift BaseUrl instances
#1037
-
Stream takes a status code argument
-Stream method framing ctype a
+Stream method status framing ctype a
(#966
#972)
-
ToStreamGenerator definition changed, so it’s possible to write an instance
for conduits.
-class ToStreamGenerator f a where
- toStreamGenerator :: f a -> StreamGenerator a
+class ToStreamGenerator a b | a -> b where
+ toStreamGenerator :: a -> StreamGenerator b
(#959)
-
Added NoFraming streaming strategy
(#959)
-
servant-client-core Free Client implementation.
Useful for testing HasClient instances.
(#920)
-
servant-client-core Add hoistClient to HasClient.
Just like hoistServer allows us to change the monad in which request handlers
of a web application live, we also have hoistClient for changing the monad
in which client functions live.
Read tutorial section for more information.
(#936)
iF you have own combinators, you’ll need to define a new method of
HasClient class, for example:
type Client m (MyCombinator :> api) = MyValue :> Client m api
hoistClientMonad pm _ nt cl = hoistClientMonad pm (Proxy :: Proxy api) nt . cl
