servant-client
Automatic derivation of querying functions for servant
http://haskell-servant.readthedocs.org/
| Version on this page: | 0.15@rev:1 |
| LTS Haskell 24.17: | 0.20.3.0@rev:2 |
| Stackage Nightly 2025-10-30: | 0.20.3.0@rev:2 |
| Latest on Hackage: | 0.20.3.0@rev:2 |
Maintained by [email protected]
This version can be pinned in stack with:
servant-client-0.15@sha256:ce1c9fe642e1cf53001fcf99b7bc7160c0633f79c8ddab480cecae6c6f4572c0,4367Module documentation for 0.15
- Servant
Depends on 21 packages(full list with versions):
Used by 11 packages in lts-13.28(full list with versions):
servant-client
This library lets you automatically derive Haskell functions that let you query each endpoint of a servant webservice.
Example
{-# LANGUAGE DataKinds #-}
{-# LANGUAGE TypeOperators #-}
import Data.Proxy
import Data.Text
import Network.HTTP.Client (newManager, defaultManagerSettings)
import Servant.API
import Servant.Client
type Book = Text
type MyApi = "books" :> Get '[JSON] [Book] -- GET /books
:<|> "books" :> ReqBody '[JSON] Book :> Post '[JSON] Book -- POST /books
myApi :: Proxy MyApi
myApi = Proxy
-- 'client' allows you to produce operations to query an API from a client.
postNewBook :: Book -> ClientM Book
getAllBooks :: ClientM [Book]
(getAllBooks :<|> postNewBook) = client myApi
main :: IO ()
main = do
manager' <- newManager defaultManagerSettings
res <- runClientM getAllBooks (mkClientEnv manager' (BaseUrl Http "localhost" 8081 ""))
case res of
Left err -> putStrLn $ "Error: " ++ show err
Right books -> print books